支持基于内部摘要的章节级文章编辑 #30

2026-10-30T11:59:53Z

codex-bot commented

2026-10-30 11:59:53 +00:00

现有文章编辑需要读取并提交全文。新增 GET/POST /api/documents/sections/，让编辑 Agent 先读取章节标题与数据库内部摘要，再按需读取正文，原子提交单章或多章新增、更新、删除及移动。摘要不进入网页、普通文档响应或搜索索引。

按行首 H2 划分章节，保留导言及 H3 以下内容，使用稳定章节 ID；章节、摘要、组合全文和历史快照在同一事务保存，与全文接口共用 revision 冲突保护并支持幂等重试。旧全文接口继续可用，正文改变会清除受影响章节的旧摘要。Python 客户端增加 outline、sections、edit-sections，README 与 AGENTS.md 记录编辑流程。

验证（2026-10-30，提交 9ee2bd219a029a2c9f201f6174efb39901ec7de9）：

ces-control 手动隔离验证：在最新主线检查镜像上叠加本 PR 文件，依赖缓存只读挂载后复制，保留供应链校验；588 项依赖策略校验通过。
pnpm run lint：通过。
pnpm run typecheck：通过。
pnpm run test:docs：21/21 通过，覆盖章节读取与摘要隔离、多章增删改移动、版本冲突、原子回滚、幂等、权限和全文兼容。
pnpm run test:auth：3/3 通过。
pnpm run test:research：17/17 通过。
Python 文档客户端测试：9/9 通过。
pnpm run build：通过，生产路由列表包含 /api/documents/sections/[...slug]，CLI bundle 生成成功；完整验证进程退出码 0。
git diff --check：通过。

限制：已有文章初始摘要缺失，由编辑 Agent 读取正文后补充，服务端不调用外部模型生成摘要。以上为手动远程验证，没有改变工作分支/PR 不运行自动 CI 的约定，未合并、未部署，也未改动生产数据库。等待用户手动合并 main，随后由既有 ces-control 流程检查与部署。

现有文章编辑需要读取并提交全文。新增 GET/POST /api/documents/sections/<slug>，让编辑 Agent 先读取章节标题与数据库内部摘要，再按需读取正文，原子提交单章或多章新增、更新、删除及移动。摘要不进入网页、普通文档响应或搜索索引。按行首 H2 划分章节，保留导言及 H3 以下内容，使用稳定章节 ID；章节、摘要、组合全文和历史快照在同一事务保存，与全文接口共用 revision 冲突保护并支持幂等重试。旧全文接口继续可用，正文改变会清除受影响章节的旧摘要。Python 客户端增加 outline、sections、edit-sections，README 与 AGENTS.md 记录编辑流程。验证（2026-10-30，提交 9ee2bd219a029a2c9f201f6174efb39901ec7de9）： - ces-control 手动隔离验证：在最新主线检查镜像上叠加本 PR 文件，依赖缓存只读挂载后复制，保留供应链校验；588 项依赖策略校验通过。 - pnpm run lint：通过。 - pnpm run typecheck：通过。 - pnpm run test:docs：21/21 通过，覆盖章节读取与摘要隔离、多章增删改移动、版本冲突、原子回滚、幂等、权限和全文兼容。 - pnpm run test:auth：3/3 通过。 - pnpm run test:research：17/17 通过。 - Python 文档客户端测试：9/9 通过。 - pnpm run build：通过，生产路由列表包含 /api/documents/sections/[...slug]，CLI bundle 生成成功；完整验证进程退出码 0。 - git diff --check：通过。限制：已有文章初始摘要缺失，由编辑 Agent 读取正文后补充，服务端不调用外部模型生成摘要。以上为手动远程验证，没有改变工作分支/PR 不运行自动 CI 的约定，未合并、未部署，也未改动生产数据库。等待用户手动合并 main，随后由既有 ces-control 流程检查与部署。

codex-bot added 1 commit 2026-10-30 11:59:54 +00:00

Add chapter editing API with internal summaries and revision control 9ee2bd219a

codex-bot marked the pull request as ready for review 2026-10-30 13:43:27 +00:00

Zayden-Jung merged commit 87987f6cc6 into main

2026-10-30 14:05:54 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: Zayden-Jung/endorphin-tabularium-docs#30