Home

NeurolingsCE Wiki

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

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

一句话了解项目

• 运行桌宠模板，兼容常见 Shimeji-ee 资源包。
• 提供 GUI 管理器、独立 NeurolingsCE-cli、HTTP API 和本地控制接口。
• 支持 .mascot 单文件模板包、拖放导入、窗口模式、多显示器、自定义缩放、可选音效。
• 当前已内置简体中文翻译资源，不再只是“未来计划”。
• 当前版本线已更新到 0.3.2，Windows 发布产物包含便携 zip、MSI 和带 VC 运行库引导的 setup 安装器。

你应该先看哪一页

如果你是普通用户

• 快速开始：下载、首次启动、基础操作。
• 导入桌宠模板：导入 .mascot、兼容 ZIP、失败排查。
• 常见问题：平台权限、端口占用、启动失败等高频问题。

如果你是自动化或 agent 用户

• HTTP API 与 CLI：HTTP 接口、NeurolingsCE-cli、--json、自动拉起运行时。

如果你是开发者

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

当前支持与已知边界

主题	现状
平台	Windows x64、Linux x86_64/arm64、macOS arm64
桌宠格式	推荐 .mascot 单文件包；导入器仍兼容常见 Shimeji-ee ZIP 布局
运行实例	单实例；启动时会检测本地运行时是否已存在
控制方式	GUI、HTTP API、本地控制接口、NeurolingsCE-cli
Linux 前台窗口追踪	KDE Plasma 6 与 GNOME 46 有专用实现；其他桌面环境功能受限
macOS 前台窗口追踪	需要 Accessibility 权限
音效	依赖 SHIJIMA_USE_QTMULTIMEDIA，构建时可关闭

项目入口

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

核心组成

组件	作用
src/app/core/shijima-engine/	集成的桌宠模拟引擎
libshimejifinder/	资源包解压与导入
cpp-httplib/	HTTP 服务端/客户端
ElaWidgetTools/	GUI 组件库，构建时会参与主程序
translations/	当前翻译资源

下一步阅读

• 快速开始
• HTTP API 与 CLI
• 构建指南
• 架构概览