上传与笔记更新预留层

把资料更新口子先留稳

当前版本不接 FastGPT/RAG，只保留网站自己的资料进入通道。上传内容先进入 Postgres 草稿库，笔记优化先生成草稿； 需要真正覆盖笔记时，API 会先创建备份。

访问控制

当前已启用 GONGKAO_ADMIN_TOKEN，调用写入接口需要 Authorization: Bearer 或 x-gongkao-admin-token。

上传资料草稿

上传内容会先进入 inbox，后续再审核归档。

笔记优化草稿

还没有检索结果。

先搜索笔记，再读取原文，最后提交优化草稿。

已预留 REST 接口

POST/api/v1/materials

上传资料草稿到 Postgres；本地无数据库时落到 data/inbox/materials

GET/api/v1/materials

分页查看已上传草稿

GET/api/v1/notes

列出可更新的 study/reference/policies 笔记

GET/api/v1/notes/read?path=

读取指定 Markdown 笔记

POST/api/v1/notes/updates

提交笔记优化草稿

POST/api/v1/notes/updates/apply

备份并应用笔记更新

POST/api/v1/policies

保存重爬后的官网原文、发布时间和原文链接

POST/api/v1/policies/crawl

按 URL 重爬官网文章并保存原文