Changelog
更新记录
Recent review API contract changes, with the latest upstream integration migration highlighted first.
- Entries
- 7
- Latest shared entry
- 2026-07-14
2026-04-21
Task 5 contract update
Structured body candidates, manual decision overrides, and split asset routes are now part of the required upstream contract.
Review task creation now expects structured candidates.bodyOptions items with id, outline, focuses, and content.
The live API keeps outline as a single string and uses | as the separator when multiple outline segments need to be represented.
Review decisions now support manualOverrides, and bodyDraft.sourceBodyCandidateId is required whenever a body draft is submitted.
Local image uploads moved to POST /api/assets/upload. Shared material library browsing remains on /api/assets.
There is no backward compatibility for the old upstream schema.
2026-07-14
审核任务支持文稿与图片打包下载
管理员可以把当前或历史任务的最终稿打包为离线 ZIP。
ZIP 包含 manuscript.md 与 images/，正文中的共享素材地址会改写为相对路径。
文章和图片消息均只导出最终选择；任一图片异常时整包失败。
2026-04-22
审核决策新增封面与摘要限制
approve_* 决策现在要求有效封面图，并限制摘要长度不超过 100 个字符。
提交审核通过时，selections.coverImage 不能为空，且必须是有效的图片 URL、素材路径或可复用素材 ID。
提交审核通过时，selections.summary 超过 100 个字符会直接返回 400，而不是等到发布阶段再失败。
2026-04-21
任务删除路由已对齐
参考页新增 DELETE /api/review/tasks/:taskId，并明确本地 review-upload 清理边界。
删除响应现在返回 deletedTaskId、deletedFileCount、skippedAssetCount 和 redirectTo。
清理只会触及 /uploads/review 下的本地文件；material library 和外部 URL 都会计入 skippedAssetCount。
2026-04-20
引入结构化文档模型
用强类型导航、页面元数据、接口记录与规范集合替代原有卡片式文档占位页。
数据模型现在支持多页面文档站点，而不再只是单页卡片摘要。
顶层集合已经重新组织，页面组件可以从一个模块里同时渲染导航、正文、参考和规范内容。
2026-04-20
发布文档已对齐线上 publish-jobs 路由
文档改为记录 publish-jobs 与 retry 接口，不再沿用过时的 publish 命名。
参考页现在与真实的 /api/review/tasks/:taskId/publish-jobs 及 retry 处理器保持一致。
文档已同步为直接发布模型，只保留 failed 与 succeeded 两类发布记录结果。
2026-04-20
认证语义已统一
文档已明确区分 x-review-agent-token 接口与 review_admin_session 接口。
代理接口按令牌认证说明，管理员接口按会话认证说明。
登录与登出接口也一并记录了其对应的 Cookie 行为。