Getting Started

快速开始

本页帮助你尽快把 NeurolingsCE 跑起来，并完成第一次导入、召唤和关闭桌宠。

1. 下载与你会拿到什么

请先前往 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

2. 首次运行

Windows

1. 解压发布包到任意目录。
2. 运行 NeurolingsCE.exe。
3. 如果你是从构建目录直接运行，确保 Qt 运行时 DLL 已正确部署。

Linux

AppImage 方式：

chmod +x NeurolingsCE.AppImage
./NeurolingsCE.AppImage

如果你使用发布目录中的可执行文件，通常需要把 GUI 程序、CLI 和 libunarr.so.1 保持在同一个发布目录里。

桌面环境说明：

• KDE Plasma 6：前台窗口追踪基本可直接工作。
• GNOME 46：首次运行后通常需要重新登录一次，让 Shell 扩展生效。
• 其他桌面环境：程序仍可运行，但前台窗口联动能力可能不可用。

macOS

1. 将 NeurolingsCE.app 放入 /Applications 或任意常用目录。
2. 首次运行后，如果需要前台窗口追踪，请到“系统设置 → 隐私与安全 → 辅助功能”授予权限。
3. 如果你从 Terminal 启动，也可能需要给 Terminal 授权。

3. 第一次启动后会发生什么

程序启动时会先检查本地运行时是否已存在。

• 如果本机已经有一个 NeurolingsCE 实例在运行，新实例不会再起第二份运行时。
• 如果当前没有运行时，程序会启动管理器窗口，并加载默认桌宠模板。

这是单实例程序。你可以同时运行多个桌宠实例，但不能同时运行多个独立运行时。

4. 最常用的基础操作

你想做什么	推荐方式
导入模板	把 .mascot 或兼容的 .zip 资源包拖到管理器窗口，或使用导入按钮
召唤桌宠	在模板列表中双击，或选中后点击召唤
拖动桌宠	鼠标左键拖动桌宠
打开菜单	右键点击桌宠
关闭单个桌宠	在右键菜单中关闭，或用 CLI 关闭
关闭全部桌宠	管理器操作或 NeurolingsCE-cli --close-all

5. 模板、资源包和运行时的区别

• 模板：已经安装到本机的桌宠包，可反复召唤；新格式通常是一个 .mascot 单文件包。
• 资源包：通常是待导入的 .zip 或原始目录。
• 运行时：当前正在运行的 NeurolingsCE 主程序实例。

这几个概念分开理解，会更容易读懂后面的导入文档和 CLI 文档。

6. 如果你想用命令行或自动化

项目现在提供独立的 NeurolingsCE-cli。

• 模板管理命令可以独立运行。
• 运行时控制命令会在需要时自动拉起 NeurolingsCE 运行时。
• CLI 默认通过本地控制接口与运行时通信，不再把 HTTP 当作主通道。

请直接阅读 HTTP API 与 CLI。

7. 下一步建议

• 想导入更多模板：看 导入桌宠模板
• 想用脚本或 agent 控制：看 HTTP API 与 CLI
• 想自己编译：看 构建指南
• 遇到平台问题：看 常见问题