fix: respect document-bound knowledge sources

2026-10-20 14:40:07 +08:00
parent 1430d35196
commit 4654f2e486
6 changed files with 62 additions and 3 deletions
@@ -69,6 +69,7 @@ Vite 通常使用 http://localhost:5173。
 - 创建知识沿用 `title/category/content/source_url`，新增可选 `source_id/document_id/collected_at`；状态固定为 `pending`。关联文档时自动解析其来源，填写的来源或网址若冲突会报错。直接来源链接的旧调用仍受支持。
 - 来源创建字段：`name`、可选 `source_url`、`notes`。文档创建字段：`source_id/title/content/collected_at`，可选 `category/notes`。文档来源归属固定，换来源需新建文档。
 - 知识修改时省略 `collected_at` 表示保留原值，明确传 `null` 表示清空；清空后回到待审核，补全真实采集时间前不能核验通过。文档的采集时间仍是必填字段，不接受 `null`。
+- 知识管理页可为未关联文档的条目选择或解除登记来源；关联文档的条目沿用文档所属来源，来源选择和网址只读，保存其他字段时保留关联。来源选择与边界验收见 [SOURCE_SELECTION_ACCEPTANCE.md](docs/SOURCE_SELECTION_ACCEPTANCE.md)。
 - PATCH 请求必须携带读取时获得的 `expected_version`，并至少提交一个修改字段；DELETE 使用查询参数 `expected_version`。版本过期返回 409，防止覆盖他人修改。
 - 审核请求字段见下方示例。`verification_status` 只允许 `pending/verified/rejected`；核验人和说明必填。通过审核前必须有来源网址及真实采集时间。这里只记录人工结论，不会自动核实网页。
 - 修改条目、关联来源或关联文档都会将相关知识转为 `pending`，清除当前审核字段并记录失效原因。历史快照保留当时的条目、来源和文档。