nb-translator

本地书籍目录驱动的 LLM 小说翻译软件。CLI 优先：翻译运行时、术语、SQLite 与恢复状态由 Bun CLI 持有。Web 工作台已有代码，产品交付与完整验收暂缓，见工作台状态。

开发入口

使用 Bun 1.3.14、Node 24。执行 bun install --ignore-scripts、bun run build:contracts，然后 bun run cli --help。

• 快速开始
• 项目、恢复与成本
• 术语与人工裁决
• 内部文档
• 开发 Agent 治理
• 当前验收状态

开发记录

两个 OMP 会话分别记录了项目搭建与 CLI 演进、Web 工作台设计与暂缓交付。规划和设计阶段使用了 Astra（gpt-6-astra）；它是开发时使用的模型，不是产品运行依赖。

• 上下文由整章原文、已确认术语、滚动摘要、近期 L2 与人工裁决组成；输入使用 Markdown，输出遵循受校验的 XML 契约。见单章流水线与模型 I/O 决策。
• 术语按语义身份管理，模型使用短键而不是 UUID；内联与旁路是两种模型写法，入库后使用同一结构。见统一存储决策。
• 默认单版直出，多版本、合并和校对保留为可选能力；草案采纳是显式操作。见草案即产物。

本机开发记录位于 .local/kakuyomu-glm53/development-record.html，可直接用浏览器打开，无需服务或网络。它包含关键用户提示词、CLI 命令目录生成器，以及第一卷快照的双语阅读：左侧章节栏贴视口左缘（含原文/译文切换、本章查找、阅读设置，宽度可拖拽调整、双击复位并记忆在本机），正文居中，术语详情在右侧栏；窄屏下列表退回抽屉、查找与设置回到顶部工具条。快照时间和缺译状态在页面内标注，不代表实时进度或逐句质量验收。

该 HTML 含用户书籍正文，仅作此次授权的本地交付，被 Git 忽略，不随仓库分发；新克隆仓库不包含此文件。公开开发证据见本次 Work，不包含小说数据。

许可证：AGPL-3.0-only。治理参考 NeuroBook/cosmos；没有本地 sibling 运行时依赖。