Home

NeurolingsCE Wiki

本页帮助你快速判断 NeurolingsCE 是什么、能做什么，以及你下一步该看哪一页。

NeurolingsCE 是一个跨平台桌宠（看板娘 / Shimeji）运行与管理程序，基于 Shijima-Qt 深度修改而来，使用 C++17 / Qt6 构建，支持 Windows、Linux 和 macOS。

一句话了解项目

• 运行桌宠模板，兼容常见 Shimeji-ee 资源包。
• 提供 GUI 管理器、独立 NeurolingsCE-cli、HTTP API 和本地控制接口。
• 支持 .mascot 单文件模板包、拖放导入（含模板文件夹）、窗口模式、多显示器、自定义缩放、可选音效。
• 支持桌宠组合保存与恢复、旧版 Shimeji zip 转换、Windows 开机自启与静默恢复。
• 已内置简体中文翻译资源；首次启动未配置语言时优先使用系统区域设置。
• 当前版本线为 0.5.1（2026-08-06，Alpha）；Windows 发布产物包含便携 zip、MSI 和带 VC 运行库引导的 setup 安装器。

你应该先看哪一页

如果你是普通用户

• 快速开始：下载、首次启动、基础操作。
• 导入桌宠模板：导入 .mascot、兼容 ZIP、模板文件夹、失败排查。
• 常见问题：平台权限、端口占用、启动失败等高频问题。
• 日志与调试：需要排查时如何开启详细日志。

如果你是自动化或 agent 用户

• HTTP API 与 CLI：HTTP 接口、NeurolingsCE-cli、--json、自动拉起运行时。
• 自动化与 Skill：仓库内置 skill、Codex 桌面通知与推荐用法。

如果你是开发者

• 构建指南：Windows / Linux / macOS 的真实构建方式。
• 架构概览：启动链路、core/runtime/ui 分层、平台层职责。
• 仓库导览：想改某块功能时该先看哪里。
• 贡献指南：代码约定、可改边界、提交前自检。

当前支持与已知边界

主题	现状
平台	Windows x64、Linux x86_64/arm64、macOS arm64/x86_64
桌宠格式	推荐 .mascot 单文件包；导入器仍兼容常见 Shimeji-ee ZIP 布局
运行实例	单实例；启动时会检测本地运行时是否已存在
控制方式	GUI、本地控制接口（默认）、HTTP API（默认关闭，需显式开启）、NeurolingsCE-cli
更新检查	静态清单 latest.json（GitHub Pages），下载产物 SHA-256 校验
Linux 前台窗口追踪	KDE Plasma 6 与 GNOME 46 有专用实现；其他桌面环境功能受限
macOS 前台窗口追踪	需要 Accessibility 权限
音效	依赖 SHIJIMA_USE_QTMULTIMEDIA，构建时可关闭
日志	默认启用会话日志，可用 NEUROLINGSCE_LOG_LEVEL 调整级别

项目入口

入口	用途
主仓库	github.com/qingchenyouforcc/NeurolingsCE
Release	最新版本
问题反馈	GitHub Issues
许可证	GPLv3

核心组成

组件	作用
src/app/core/shijima-engine/	集成的桌宠模拟引擎
libshimejifinder/	资源包解压与导入（子模块）
cpp-httplib/	HTTP 服务端/客户端（子模块）
ElaWidgetTools/	GUI 组件库，构建时会参与主程序
translations/	当前翻译资源
neurolingsce-skill/、neurolingsce-companion/	仓库内置的 CLI 控制与陪伴 skill

下一步阅读

• 快速开始
• 0.5.1 更新说明，历史版本见 0.4.0 更新说明 与 0.3.2 更新说明
• HTTP API 与 CLI
• 自动化与 Skill
• 构建指南
• 架构概览
• 日志与调试