-
Notifications
You must be signed in to change notification settings - Fork 3
Getting Started
qingchenyouforcc edited this page Apr 24, 2026
·
4 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 |
- 解压发布包到任意目录。
- 运行
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 授权。
程序启动时会先检查本地运行时是否已存在。
- 如果本机已经有一个 NeurolingsCE 实例在运行,新实例不会再起第二份运行时。
- 如果当前没有运行时,程序会启动管理器窗口,并加载默认桌宠模板。
这是单实例程序。你可以同时运行多个桌宠实例,但不能同时运行多个独立运行时。
| 你想做什么 | 推荐方式 |
|---|---|
| 导入模板 | 把 .mascot 或兼容的 .zip 资源包拖到管理器窗口,或使用导入按钮 |
| 召唤桌宠 | 在模板列表中双击,或选中后点击召唤 |
| 拖动桌宠 | 鼠标左键拖动桌宠 |
| 打开菜单 | 右键点击桌宠 |
| 关闭单个桌宠 | 在右键菜单中关闭,或用 CLI 关闭 |
| 关闭全部桌宠 | 管理器操作或 NeurolingsCE-cli --close-all
|
- 模板:已经安装到本机的桌宠包,可反复召唤;新格式通常是一个
.mascot单文件包。 - 资源包:通常是待导入的
.zip或原始目录。 - 运行时:当前正在运行的 NeurolingsCE 主程序实例。
这几个概念分开理解,会更容易读懂后面的导入文档和 CLI 文档。
项目现在提供独立的 NeurolingsCE-cli。
- 模板管理命令可以独立运行。
- 运行时控制命令会在需要时自动拉起 NeurolingsCE 运行时。
- CLI 默认通过本地控制接口与运行时通信,不再把 HTTP 当作主通道。
请直接阅读 HTTP API 与 CLI。
- 想导入更多模板:看 导入桌宠模板
- 想用脚本或 agent 控制:看 HTTP API 与 CLI
- 想自己编译:看 构建指南
- 遇到平台问题:看 常见问题