NeuroBook

简体中文

English

简体中文

English

外观

0.8.x 更新日志 ​

0.8 这条线的主题是「把安装和部署做扎实」。0.8.0 重写了 AI 长对话的加载方式，之后的十几个小版本几乎全在修安装、更新、容器停机这些没人愿意碰但一出事就致命的地方。

Manager 0.1.0-canary.30 - 2026-07-25 ​

这次只更新安装管理器，应用本体没变。

  • start 命令新增 --no-health-check：跳过启动检测和自动打开浏览器，用于「服务其实起来了但检测卡住」时手动救场。仍然会做迁移和数据检查，只是不等探测结果。
  • 只对 Windows 便携版有效，其他安装方式会直接拒绝。
  • 已经解压 0.8.19 便携版的用户可以在便携版根目录跑下面这条，然后自己打开 http://127.0.0.1:3000：
cmd
.runtime\bin\bun.cmd x --bun @notnotype/neuro-book-manager@0.1.0-canary.30 --root "%CD%" start --no-health-check

这条命令是临时借用新版管理器，不会替换压缩包里自带的那个。下次双击 Start Neuro Book.cmd 还是老样子。

0.8.19-canary - 2026-07-20 ​

从 0.8.13 开始的容器修复连发，到这一版终于全部通过并完整发布。

  • 修复 Docker 和 Podman 对「这是不是同一个镜像」判断不一致，导致明明装对了却被报成版本不符。
  • 五种安装方式、两种 CPU 架构、从旧版本升级、停止和重启、中断恢复全部验证通过。

0.8.18-canary - 2026-07-20 ​

  • 统一两种容器引擎查容器编号的方式，Podman 上不再因为命令不兼容而失败。
  • NeuroBook 生成的容器配置文件现在只允许一个应用服务。要跑额外服务请另建一个独立配置，别改 NeuroBook 生成的那份，否则诊断会拒绝这个实例。

0.8.17-canary - 2026-07-20 ​

  • 修复 Podman 上的健康检查用了旧版 podman-compose 不支持的命令而失败。现在直接从 NeuroBook 自己生成的配置文件里读镜像，不再依赖各家容器工具的扩展命令。

0.8.16-canary - 2026-07-20 ​

  • 修复 Podman 上的健康检查去读 Docker 独有的字段而失败。
  • 容器镜像改成 x64 和 ARM64 各自在原生机器上并行构建。ARM64 从 30 分钟降到 7 分钟，整条发布流程从接近一小时压到 27 分钟。

0.8.15-canary - 2026-07-20 ​

  • 修复用 Podman 停止应用时容器被连带删掉。旧版 podman-compose 的「停止」实际会把容器一起删了，导致停完之后诊断、重启、恢复全都找不到东西。现在停止后容器还在。

0.8.14-canary - 2026-07-20 ​

  • 修复容器停不下来：以前发出关闭信号后要干等 10 秒再被强杀，因为信号没传给真正干活的进程。现在会正确传递，停止是干净的。

0.8.13-canary - 2026-07-20 ​

  • 停止容器后做诊断，不再把「正常停止」误报成「异常崩溃」。
  • Podman 固定使用 podman-compose，不会因为机器上同时装了 Docker 插件就偷偷连到 Docker 上去。

0.8.12-canary - 2026-07-20 ​

  • 修的是发布流程里的自检脚本，用户这边没有可感知的变化。

0.8.11-canary - 2026-07-20 ​

  • 修复安装管理器在 macOS 上读取命令输出可能读不全，导致偶发把正常命令判成失败。

0.8.10-canary - 2026-07-19 ​

  • 修复 Windows 便携版打包内置运行时时失败（压缩包里的目录条目被当成非法路径）。
  • 发布流程加了统一预检：在花一小时构建五个平台之前，先把所有合同测试跑一遍。
  • 新的测试版发布会自动取消还在跑的旧测试版构建，不再堆积。

0.8.9-canary - 2026-07-19 ​

这一版集中修了一批安装和权限问题，是 0.8 线里改动最大的一次。

  • Windows 便携版登录失败：以前数据库路径会跟着「你从哪个目录启动」变，结果从错误的位置找数据库，一登录就报错。现在路径固定按数据目录解析。
  • 更新过程改成记账式：每一步动手之前先记下「准备做什么」，做完再记「做成了什么」。中途断电或失败可以照账本原样回滚，不会留下半新半旧的实例。
  • 下载的运行时先验货再上架：Bun、ripgrep、Git 下载后会在暂存区校验完整性、可执行性和真实版本，验不过就不会替换掉正在用的那份。
  • AI 模型配置身份更严：改了服务地址或代理就算换了一套连接，不会偷偷沿用旧密钥；删除某个模型服务前必须先处理掉引用它的地方。
  • 文件权限统一：AI 的读取、写入、改写、打补丁和记忆功能现在共用同一套权限检查，符号链接和跨项目路径统一拦截。

如果你在用 0.8.6 的 Windows 便携版，升级方式是：备份整个 data/ 目录 → 解压新版到新目录 → 把 data/ 复制过去。不要复制旧的 .deploy、.runtime、.output 和根目录的启动脚本。

旧对话的模型引用怎么处理 ​

从这一版开始，AI 对话只记「哪个服务、哪个模型」，不再存整份模型配置。更早的对话如果没法证明它当初用的是哪个服务，系统不会替你猜——它只会让那一条对话用不了，不会悄悄换成默认模型。

要修的话，先写一个对照表，把每条对话指到正确的服务和模型：

json
{
    "mappings": [
        {
            "sessionId": 241,
            "entryId": "model-change-entry-id",
            "providerConfigId": "my-provider",
            "modelId": "my-model"
        }
    ]
}

然后先空跑看看会改什么，确认无误再真正执行：

text
bun scripts/maintenance/migrate-session-model-refs.ts --workspace-root <你的工作区目录> --mapping <mapping.json> --dry-run
bun scripts/maintenance/migrate-session-model-refs.ts --workspace-root <你的工作区目录> --mapping <mapping.json>

命令会核对配置里确实存在这些服务和模型，对照表写错或有多余项都会直接报错。执行前建议先备份整个数据目录。

0.8.6-canary - 2026-07-17 ​

  • 修复用容器方式安装时，一次性的维护命令被当成「启动服务」，导致安装过程一直卡着不动。
  • 已知问题（0.8.9 已修）：开启登录后，Windows 便携版可能在登录时报 500。

0.8.5-canary - 2026-07-17 ​

  • 修复全新安装时因为「还没有任何 AI 对话记录」而中止并回滚。空数据现在是合法状态，不再当成错误。

0.8.4-canary - 2026-07-17 ​

  • 修复打包好的应用误报「内置 AI 配置已过期」，导致 Linux 版和 Windows 便携版都启动不了。

0.8.3-canary - 2026-07-17 ​

  • 修复容器在普通用户权限下启动失败——容器试图往只读的镜像内部写文件。
  • 各种临时文件不再写到程序目录，改到对应的数据目录下，程序目录保持只读。

0.8.2-canary - 2026-07-17 ​

  • AI 对话里的图片不再塞在会话里。以前图片以 base64 长期留在对话记录中，会话文件越滚越大；现在存进附件库，对话里只留一个引用，只在真正要发给模型时才加载。
  • 修复 Windows 便携版和自定义数据目录下，AI 读写文件会找错位置的问题。

0.8.0-canary - 2026-07-15 ​

这个中版本重写了 AI 长对话的加载和推送方式，目标是让几百轮的对话也不卡。

  • 长对话不再一次性全量加载：打开时只给最近一页，往上滚动才继续加载旧内容。加载旧页时视口不会乱跳，AI 的回复和它对应的工具结果也不会被从中间切开。
  • 实时消息改成只发增量：以前每次都重发整段累计内容，包括工具参数、差异和图片。现在只发新增部分。
  • 工具卡片只显示摘要：路径、短预览、原始大小，不再把整个文件内容推到前端。
  • AI 图片改成附件引用，同 0.8.2 的做法。
  • 模型配置有了严格校验：坏配置不会进运行时；设置页支持实时校验和一键修正，改的是草稿，不会自动保存。

0.8.19 以前的说明 ​

0.8.1、0.8.7、0.8.8 在构建阶段就失败了，没有可安装的文件，不要去下载它们的残留资产。