-
Notifications
You must be signed in to change notification settings - Fork 5
Getting Started
qingchenyouforcc edited this page Aug 6, 2026
·
6 revisions
本页帮助你尽快把 NeurolingsCE 跑起来，并完成第一次导入、召唤和关闭桌宠。
请先前往 Releases 下载对应平台的发布包。
| 平台 | 常见产物 | 说明 |
|---|---|---|
| Windows | 便携 zip、.msi、-setup.exe、NeurolingsCE.exe、NeurolingsCE-cli.exe
|
仅支持 x64；-setup.exe 会包含 VC 运行库引导 |
| Linux |
NeurolingsCE.AppImage 或发布目录 |
发布目录通常同时包含 GUI 程序、CLI 和 libunarr.so.1
|
| macOS |
NeurolingsCE.app 与 CLI |
最低系统版本 macOS 13；支持 Apple Silicon 与 Intel |
Windows 产物命名形如 NeurolingsCE_windows_x86_64_v0.5.1.zip / .msi / -setup.exe。普通用户优先使用 -setup.exe。
- 解压发布包到任意目录，或直接安装 MSI /
-setup.exe。 - 运行
NeurolingsCE.exe。 - 如果你是从构建目录直接运行，确保 Qt 运行时 DLL 已正确部署。
AppImage 方式：
chmod +x NeurolingsCE.AppImage
./NeurolingsCE.AppImage如果你使用发布目录中的可执行文件，通常需要把 GUI 程序、CLI 和 libunarr.so.1 保持在同一个发布目录里。
桌面环境说明：
- KDE Plasma 6：前台窗口追踪基本可直接工作。
- GNOME 46：首次运行后通常需要重新登录一次，让 Shell 扩展生效。
- 其他桌面环境：程序仍可运行，但前台窗口联动能力可能不可用。
- 将
NeurolingsCE.app放入/Applications或任意常用目录。 - 首次运行后，如果需要前台窗口追踪，请到“系统设置 → 隐私与安全 → 辅助功能”授予权限。
- 如果你从 Terminal 启动，也可能需要给 Terminal 授权。
如果之前没有配置过语言，程序会优先使用系统区域设置（0.5.1 起）。你也可以在“设置”中随时切换语言。
程序启动时会先检查本地运行时是否已存在。
- 如果本机已经有一个 NeurolingsCE 实例在运行，新实例不会再起第二份运行时。
- 如果当前没有运行时，程序会启动管理器窗口，并加载默认桌宠模板。
- 启动时会进行一次更新检查：客户端读取 GitHub Pages 上的静态清单，不再直连 GitHub API。
- 默认启用会话日志；遇到问题可以先看日志与调试。
这是单实例程序。你可以同时运行多个桌宠实例，但不能同时运行多个独立运行时。
| 你想做什么 | 推荐方式 |
|---|---|
| 导入模板 | 把 .mascot、兼容的 .zip 或模板文件夹拖到管理器窗口，或使用导入按钮 |
| 转换旧包 | 用“制作”页检查旧 Shimeji zip 并转换为 .mascot 包 |
| 召唤桌宠 | 在模板列表中双击，或选中后点击召唤 |
| 拖动桌宠 | 鼠标左键拖动桌宠 |
| 打开菜单 | 右键点击桌宠 |
| 摸头 | 单击摸一次；按住左键可连续摸头 |
| 关闭单个桌宠 | 在右键菜单中关闭，或用 CLI 关闭 |
| 关闭全部桌宠 | 管理器操作或 NeurolingsCE-cli --close-all
|
| 保存桌宠组合 | 在“组合”页保存当前桌宠组，之后可一键恢复 |
- 模板：已经安装到本机的桌宠包，可反复召唤；新格式通常是一个
.mascot单文件包。 - 资源包：通常是待导入的
.zip或原始目录；“制作”页可以把旧版 zip 转换为.mascot。 - 组合：当前屏幕上的一组桌宠实例，可以保存并在之后恢复。
- 运行时：当前正在运行的 NeurolingsCE 主程序实例。
这几个概念分开理解，会更容易读懂后面的导入文档和 CLI 文档。
项目现在提供独立的 NeurolingsCE-cli。
- 模板管理命令可以独立运行。
- 运行时控制命令会在需要时自动拉起 NeurolingsCE 运行时。
- CLI 默认通过本地控制接口与运行时通信，不再把 HTTP 当作主通道。
请直接阅读 HTTP API 与 CLI 和 自动化与 Skill。
在“设置 → 启动”中可以开启开机自启。开启静默启动后，系统登录时程序会留在托盘中，并按设置恢复“上次关闭前组合”或某个已保存组合。
- 想导入更多模板：看 导入桌宠模板
- 想了解版本变化：看 0.5.1 更新说明，历史版本见 0.4.0 更新说明 与 0.3.2 更新说明
- 想用脚本或 agent 控制：看 HTTP API 与 CLI
- 想自己编译：看 构建指南
- 遇到平台问题：看 常见问题