simonkoson
8be51ebbde
- 知识库笔记工坊子项目立项：PRD v1.0 + 寄存条 + CLAUDE.md 登记 - 后端：知识库上传记录 contributor、新增 /contributors 接口 - 前端：知识库列表支持按贡献人筛选 - 新增 Fable5 视角模式库/案例集/建议文档 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
4.2 KiB
4.2 KiB
项目协作主控文件 (new_notemd/CLAUDE.md)
状态栏（每次结束 session 前必须更新这三行）
- 最后更新：Claude Opus（顾问）｜ 2026-07-09
- 当前状态一句话：已立项，PRD v1.0 完成（含制片人四项拍板），未开发。 等制片人排期后按 PRD §8 四刀实施。
- 下一个动手的人从这里开始：读本文件 +
PRD_知识库笔记工坊_v1.md全文。开发时严格按 PRD §8 分四刀。
1. 子项目概览
- 项目名：知识库笔记工坊（new_notemd）— 知识库从"制片人单人维护"升级为"全组共建"
- 目标：三件事——① 笔记可点开查看/编辑；② 编导可自助提交多格式素材，AI 加工成规范笔记；③ 审核制防污染。
- 落点页面：知识库页面（
frontend/src/pages/KnowledgePage/KnowledgePage.jsx） - 完整方案：见同目录
PRD_知识库笔记工坊_v1.md
与主干的关系
本子项目实施时全部落在主干（知识库前端页面 + backend API/服务 + 006 迁移），不是独立部署的应用。外迁的是方案讨论和 PRD 迭代；动代码时走主干纪律：Cline Plan + Opus 审 + 制片人批准 Act，006 迁移前必须 pg_dump 备份。
2. 关键决策（制片人已拍板，2026-07-09）
- 不做独立软件：笔记生成做在网页端知识库页面内，编导零安装成本。
- 五种输入类型：粘贴文本 / PDF 上传 / Word 上传 / 网页链接 / md 文件。
- 审核制：编导提交 → 制片人/责编审核通过 → 才进入正式搜索池。未审核笔记对搜索不可见。设计哲学红线延伸。
- AI 加工复用现有规则：MiMo + MST_knowledge_base prompt，不另起炉灶。
设计要点（PRD 核心结论，防跨 session 丢失）
- 查看用抽屉：点标题 → Drawer 打开，上方 md 渲染预览，下方元信息卡片，可切编辑模式（左编辑右预览）。
- 新建笔记分三步：选输入方式提交素材 → AI 加工（loading 10-30s）→ 编导预览修改后提交审核。
- 四状态流转：draft → pending → approved / rejected。搜索只检索 approved。
- 006 迁移：knowledge_items +status / submitted_by / reviewed_by / reviewed_at / review_note 五列。存量标 approved。
- 编辑后自动重算向量：PATCH 保存时后端调 MiniMax embo-01 重算 embedding。
- 权限三档：编导（看/编辑自己的/新建）、责编（+审核）、制片人（+删除）。
3. 待办（按 PRD §8 四刀）
- 第一刀（查看+编辑）：标题可点击 → 查看抽屉 + 编辑模式 + PATCH 保存重算向量。不涉及 schema。
- 第二刀（新建笔记）：006 迁移（先 pg_dump）+ 文本提取接口（PDF/Word/链接）+ AI 加工接口 + 前端新建流程。
- 第三刀（审核流程）：提交审核 / 审核操作接口 + 待审核列表 + 搜索过滤 status=approved + 权限校验。
- 第四刀（打磨）："我的笔记"视图 + 驳回退回流程 + 网页抓取健壮性 + 编辑权限细化。
- 每刀独立验收（PRD §7 七条验收标准，制片人真实点页面逐条验）
4. 已完成（只追加，最新在上）
- [2026-07-09 ｜ Claude Opus] 立项：PRD v1.0 完成（含制片人四项拍板写入 §9）、子项目文件夹建立、主项目寄存条与 CLAUDE.md 登记。
5. 交接备注
- 开发未启动，等制片人排期。启动时从 PRD §8 第一刀开始。
- 第一刀不涉及 schema 变更，纯前端 + 1 个 PATCH 接口，可以先做起来。
- 依赖提醒：第二刀需 PDF 解析库（推荐 PyMuPDF 或 pdfplumber）、网页抓取（requests + BeautifulSoup）；python-docx 已有。LLM 调用复用 MiMo 接口（需确认 backend/.env 有 MIMO 相关 key）。
- 关联：搜索过滤与主干
knowledge_service.py的search_similar()和get_all_items()紧密相关，第三刀改动时需注意。