73 lines
4.2 KiB
Markdown
73 lines
4.2 KiB
Markdown
|
# 项目协作主控文件 (new_notemd/CLAUDE.md)
|
|||
|
|
|
|||
|
|
<!--
|
|||
|
|
知识库笔记工坊子项目主控文件。
|
|||
|
|
通用协作原则、主项目技术栈、角色定位、Git 红线等
|
|||
|
|
已在上一级 tps-dashboard/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）
|
|||
|
|
|
|||
|
|
1. **不做独立软件**：笔记生成做在网页端知识库页面内，编导零安装成本。
|
|||
|
|
2. **五种输入类型**：粘贴文本 / PDF 上传 / Word 上传 / 网页链接 / md 文件。
|
|||
|
|
3. **审核制**：编导提交 → 制片人/责编审核通过 → 才进入正式搜索池。未审核笔记对搜索不可见。设计哲学红线延伸。
|
|||
|
|
4. **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()` 紧密相关，第三刀改动时需注意。
|