运行、数据与隐私

这一页回答自部署用户最关心的四件事：服务怎么管、数据在哪、怎么备份、哪些东西不能随便发出去。

服务运行与停止

启动后默认监听 3000 端口（NUXT_PORT 或 PORT 可覆盖）。

.runtime/bin/neuro-book start

Manager 目前不提供 stop

Manager CLI 有 install / manage / instances / adopt / update / start / status / doctor / runtime / tools / admin，没有 stop、restart 或 uninstall。停止服务需要按部署形态自己处理，见下表。这也意味着更新原生 Product 前要求的「先退出服务」需要你手动完成。

部署形态	停止方式
Windows Portable	关闭 Start Neuro Book.cmd 弹出的命令行窗口
GHCR / 容器	docker compose --env-file .env -f .deploy/docker-compose.generated.yml stop
Product Bun / Source	终止 neuro-book start 所在的进程（前台 Ctrl+C）

Manager v1 不接管 systemd、pm2 或通用后台进程。要开机自启或让服务在 SSH 断开后存活，需要自己写 unit / service。容器部署可以直接用 compose 的 restart 策略。

反向代理和 HTTPS 同样不在 Manager 职责内：把反代指向监听端口即可，注意放行 SSE（Agent 的流式输出依赖长连接，反代要关掉对应路径的缓冲）。

更新与版本通道

neuro-book update                      # 按当前通道更新
neuro-book update --channel stable     # 切换到 stable
neuro-book update --channel canary     # 切换到 canary

Manager 只安装已经发布了正式 release-manifest.json 的完整 Release，仍在构建或已取消的版本会被安全跳过。这意味着你实际装到的版本可能低于文档描述的最新版本——用 neuro-book status 查当前实际版本。

当前处于 canary 阶段

项目仍在快速迭代，已知问题包括：rootless Podman 环境下 podman-compose stop 会连带删除容器；Apple Silicon 上的 Docker / Podman 部署尚未实机验证。

你的数据在哪

NEURO_BOOK_STATE_ROOT 是状态路径的真相源。默认 State Root 等于安装目录，Windows Portable 是安装目录下的 data/。

内容	路径（相对 State Root）
你的作品（正文、设定、世界引擎配置）	workspace/{项目名}/
项目数据库（剧情结构、承诺、决策）	workspace/{项目名}/.nbook/project.sqlite
文件历史（含全文快照）	workspace/{项目名}/.nbook/history.sqlite
应用数据库（会话索引、账号）	workspace/.nbook/neuro-book.sqlite
全局配置	workspace/.nbook/config.json
启动配置（端口、鉴权）	config.yaml
Agent 会话记录	workspace/.nbook/agent/
请求 trace（含完整 prompt 与正文）	workspace/.nbook/agent/traces/
日志	logs/

备份就是拷贝整个 State Root。里面全是普通文件和 SQLite，没有外部依赖。恢复就是把目录放回去。注意 SQLite 有 WAL 文件，热备份时不要只拷 .sqlite 而漏掉 -wal / -shm，最稳妥是先停服务再拷。

正文和设定本身是 Markdown 文件，任何编辑器都能打开，不依赖 NeuroBook 才能读。

隐私边界

这一节请务必读完，尤其是打算把项目或日志发给别人之前。

发给模型 Provider 的内容：Agent 每次调用会把当前上下文（可能包含设定、正文片段、剧情结构）发送给你自己配置的那个 Provider，不经过 NeuroBook 的服务器。如果你启用了 embedding 检索功能，被索引的内容也会发给你配置的 embedding 服务端点。选服务商时请自行确认其数据使用条款。

三类本地敏感文件，按敏感度排序：

文件	含什么	分享风险
traces/	完整 prompt 与小说正文	最高。默认保留每个会话最近 100 条，可在设置页「可观测」中关闭
history.sqlite	全文快照，包括你已经删掉的内容	高。项目下载包会包含它
project.sqlite	剧情结构、承诺、决策	中。不含正文

可分享日志包是安全的：/api/app/logs/download 导出的诊断日志包走白名单，只包含日志和 manifest，不包含配置、数据库或作品正文。报 bug 时用它，不要直接打包整个 State Root。

项目下载包不是安全的：它会包含 history.sqlite 的独立快照，也就是包含你删除过的内容。前端在下载时会提示这一点。要分享作品给别人看，直接发 manuscript/ 下的 Markdown 文件。

排障

neuro-book status    # 当前实例状态与版本
neuro-book doctor    # 环境检查

日志在 State Root 的 logs/ 下；容器部署看容器日志：

docker compose --env-file .env -f .deploy/docker-compose.generated.yml logs --tail 200 app

要让 AI 协助排障，把 交付与运维桥梁 发给它，那份文档专门写给运维 Agent。

继续阅读

• 部署方式：六种 Profile 的选择与边界。
• 快速开始：最短安装路径。
• 交付与运维桥梁：面向运维 Agent 的完整索引。