Repository navigation
FAQ
本页只保留使用和开发中最容易遇到、且值得单独回答的问题。
NeurolingsCE 是基于 Shijima-Qt 深度修改而来的项目。当前仓库中还集成了桌宠模拟引擎源码，所以很多引擎级修复可以直接在本仓库内完成。
当前版本线为 0.5.1（2026-08-06，Alpha）。版本更新记录见 0.5.1 更新说明。
推荐格式是 .mascot 单文件包。它本质上是 zip 兼容压缩包，根目录必须包含 info.json，并包含 actions.xml、behaviors.xml、img/ 等模板资源。
导入器仍兼容常见 Shimeji-ee 风格 ZIP 资源包，并会在导入时转换成 .mascot 包；但不是所有历史资源包都能无改动导入。从 0.5.1 起，把模板文件夹直接拖入管理器窗口也可以导入。
可以。你可以同时召唤多个实例，甚至来自不同模板。
可以。“组合”页可以保存当前屏幕上的桌宠组，之后一键恢复；程序关闭前也会记录最后一次组合状态。
不可以。程序是单实例设计，但单实例里可以管理多个桌宠实例。
可以。在“设置 → 启动”中开启开机自启和静默启动。静默启动会把程序留在托盘中，并按设置恢复上次关闭前组合或指定已保存组合。
当前设计是每秒 25 个完整 tick（40 ms 一个完整周期），每个完整 tick 内部再拆成 4 个 subtick 用于物理与插值细分。
这通常说明运行时 DLL 没有部署到程序目录。
优先处理方式：
- 确认 CMake 构建时找到了
windeployqt - 或把 Qt
bin路径加入PATH - 或手动部署 Qt 运行时
先确认你所处的桌面环境：
- KDE Plasma 6：通常开箱即用
- GNOME 46：首次运行后一般需要重新登录一次
- 其他桌面环境：这项能力可能不可用
项目的桌宠定位能力与传统桌面窗口模型强相关。在 Linux 上通常会退回到更可行的兼容路径，而不是按原生 Wayland 桌宠模型工作。
通常是 Accessibility 权限没有授予。
处理方式：
- 打开“系统设置 → 隐私与安全 → 辅助功能”
- 给
NeurolingsCE.app或启动它的终端授予权限 - 重新启动应用
优先怀疑：
- XML 语法有问题
-
.mascot包结构不规范，或info.json.name为空 - 导入后的目录结构仍不符合运行时加载要求
请先看 导入桌宠模板。
从 0.3.2 开始，推荐的 .mascot 是一个单文件包，不再是普通目录。它可以理解成改了扩展名的 zip 包。
旧版本留下的 xxx.mascot/ 目录会在启动时尽量迁移为 xxx.mascot 文件。运行时加载时会把包解压到缓存目录读取 XML、图片和气泡文本；删除模板时删除的是安装目录中的 .mascot 文件。
使用主界面“制作”页：选择 zip 后先检查内容，可以勾选要转换的条目并编辑 info.json，转换结果写入你选择的输出目录，不会自动导入模板库。
不是。CLI 默认通过本地控制接口与运行时通信，HTTP API 仍然独立存在，但不是 CLI 的主通道。
HTTP API 默认关闭。需要先把 Qt 设置 http/enabled 设为 true，程序启动时才会监听 127.0.0.1:32456。
按这个顺序排查：
- 确认
http/enabled已开启 - 确认运行时确实在运行
- 访问
http://127.0.0.1:32456/shijima/api/v1/ping - 检查端口
32456是否被其他程序占用
-
id是运行时实例 ID -
label是 CLI 面向用户的标签
label 会在运行时重启后失效。
启动前设置环境变量：
$env:NEUROLINGSCE_LOG_LEVEL="debug"
$env:NEUROLINGSCE_LOG_STDERR="1"
.\NeurolingsCE.exeWindows 默认日志目录为 %LOCALAPPDATA%\NeurolingsCE\log\YYYY-MM-DD\；Linux/macOS 会优先写入 Qt 的 AppLocalDataLocation/log。详细说明见 日志与调试。
客户端现在读取 GitHub Pages 上的静态 latest.json 清单，避免共享出口 IP 触发 GitHub REST API 未认证限流；下载到本地的安装包会通过清单中的 SHA-256 校验后才允许安装。
更新下载会做 SHA-256 校验。校验值优先来自静态 manifest 中的 sha256，否则回退到 Release 里的 SHA256SUMS.txt。校验失败时不会自动安装。
先在“设置”中确认 Codex 托管 notify 配置已开启（codex/enabled）。通知是 best-effort 投递：只有运行时已经运行时才会显示；应用关闭后到达的通知会被忽略，不会为了显示通知重新启动运行时。
显式传入 Qt6_DIR、CMAKE_PREFIX_PATH 或 QTDIR。
请切换到 x64 工具链。项目当前不支持 32 位 MSVC。
推荐 CMake + Homebrew：
brew install qt qttools libarchive cmake pkg-config
cmake -B build -G "Unix Makefiles" -DCMAKE_BUILD_TYPE=Release -DQt6_DIR="$(brew --prefix qtbase)/lib/cmake/Qt6"
cmake --build build- 缺少
Qt6::Multimedia：通常退化为无音效构建 - 缺少 LinguistTools：翻译不会被编译进产物
请重新执行：
git submodule update --init --recursive