feat: 知识库笔记工坊立项 + contributor 功能 + Fable5 视角文档

- 知识库笔记工坊子项目立项:PRD v1.0 + 寄存条 + CLAUDE.md 登记
- 后端:知识库上传记录 contributor、新增 /contributors 接口
- 前端:知识库列表支持按贡献人筛选
- 新增 Fable5 视角模式库/案例集/建议文档

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
simonkoson
2026-07-10 18:06:42 +08:00
parent db9d10a795
commit 8be51ebbde
12 changed files with 836 additions and 57 deletions
+8 -4
View File
@@ -13,8 +13,8 @@
## 🔖 状态栏(每次结束 session 前必须更新这三行)
- **最后更新**Claude Opus(顾问)| 2026-07-08
- **当前状态一句话****知识库语义搜索基本可用**——Obsidian 知识库 164 篇批量导入完成(总计 186 条含 doco 22 篇),搜索体验三项改进已落地(智能摘要/相关度阈值/展开全文),中文分词 snippet bug 已修。下一步:搜索体验微调 + 进入 Phase 4a 对话式 TPS。
- **最后更新**Claude Opus(顾问)| 2026-07-09
- **当前状态一句话****知识库笔记工坊子项目立项完成**——PRD v1.0 就绪(查看/编辑 + AI 加工新建 + 审核制,四刀分期),知识库升级为全组共建模式。下一步:排期开发 or 进入 Phase 4a 对话式 TPS。
- **下一个动手的人从这里开始**:见下方「⏩ 交接备注」
---
@@ -39,6 +39,7 @@
- **Doco 文稿整理**`寄存条_doco子项目已外迁.md`):关键词——doco / 文稿整理 / 三方融合 / 视频双路拆分 / A·B 稿 / ASR / 讯飞 / DeepSeek Vision / 终版文稿 / 差异报告 / 段落对齐。**⚡ 2026-06-26 已交付:22 期融合A稿成品在 `doco/deliverables/`(按播出顺序命名),缺第01期(无A稿)。下一步:批量导入知识库(走 Phase 3 上传/embedding 链路)。**
- **CCA 唱词助手**`寄存条CCA唱词助手子项目已外迁.md`):关键词——cca / 唱词助手 / changci / SRT 字幕 / 拍词规则 / 编导审稿台 / 唱词校对 / ASR 转字幕 / 大洋字幕格式 / 折行规则。**⚡ 2026-07-04 立项:编导 A 稿+人声音频 → ASR+AI 校对+编导审稿 → 大洋格式 SRT。先部署 lanhao 配音 2.0 测试,成熟后并入 TPS。**
- **期次一条龙录入**`寄存条期次一条龙录入子项目已外迁.md`,目录 `episode-intake/`):关键词——一条龙 / 期次录入流水线 / 流水线状态点 / 文稿回联期次 / transcript_item_id / 005 迁移 / AI 处理按钮 / 标签审核台 / draft-reviewed 流转 / 责编录入抽屉。**⚡ 2026-07-07 立项:责编录入页升级为每期任务清单(收视→文稿入库→AI打标+摘要卡→制片人审核→进看板),让收视分析持续生长。PRD v1.0 就绪,暂不开发;实施时落主干、走主干纪律。已拍板:文稿口径=doco 融合A稿(doco 转常态运行)、22 期导入时回联期次、责编可触发 AI 处理。**
- **知识库笔记工坊**`寄存条知识库笔记工坊子项目已外迁.md`,目录 `new_notemd/`):关键词——笔记工坊 / 新建笔记 / AI 加工笔记 / 编导上传知识库 / 知识库审核流程 / pending/approved/rejected 状态 / 006 迁移 / 笔记编辑抽屉 / 文本提取 / PDF OCR / 网页抓取入库 / 编导共建知识库。**⚡ 2026-07-09 立项:知识库升级为全组共建——编导可查看/编辑笔记、自助提交多格式素材(文本/PDF/Word/链接/md)经 AI 加工成规范笔记、制片人/责编审核后入搜索池。PRD v1.0 就绪,暂不开发;实施时落主干、走主干纪律。已拍板:不做独立软件(网页端解决)、五种输入类型、审核制防污染、AI 加工复用 MST 规则。**
**主干仍管**:Phase 03 主干代码、全部 backend schema/API/迁移、全部前端 React 实施、主干 bug/性能/新需求、Cline 的全部 Plan+Act。
@@ -77,14 +78,15 @@
## 3. 当前进度(动态,核心交接区 — 以最新快照为准)
- **已完成至**:收视分析看板 L1-L4 + 知识库语义搜索(Obsidian 164 篇 + doco 22 篇批量导入,搜索体验三项改进)。
- **正在做**语义搜索体验微调(中文 snippet 已修,待制片人复测),准备进入 Phase 4a 对话式 TPS。
- **正在做**知识库笔记工坊子项目已立项(PRD v1.0 就绪),待排期开发。准备进入 Phase 4a 对话式 TPS。
- **卡点/待解**:无硬卡点。
- **Schema 状态**episodes 表已通过 003+7 AI 标签列)和 004+content_digest JSONB)迁移。知识库两表不再改
- **Schema 状态**episodes 表已通过 003+7 AI 标签列)和 004+content_digest JSONB)迁移。知识库两表暂不改(006 迁移属笔记工坊子项目第二刀)
---
## 4. 已完成(只追加,最新在上)
- [2026-07-09] **知识库笔记工坊子项目立项(只立项不开发)**:① PRD v1.0 写入 `new_notemd/PRD_知识库笔记工坊_v1.md`(查看/编辑抽屉 + AI 加工新建笔记 + 审核制、五种输入类型、四刀分期+七条验收);② 制片人四项拍板:不做独立软件(网页端解决)、五种输入类型(文本/PDF/Word/链接/md)、审核制防污染、AI 加工复用 MST 规则;③ 子项目 CLAUDE.md + 寄存条建立。
- [2026-07-08] **Obsidian 知识库批量导入 + 语义搜索体验升级**:① `parse_md_file` 补强 6 项("来源"→source_detail fallback、"相关装备/应用领域"实体提取、Obsidian 双链 `[[]]` 去括号、原始类别存 metadata、源文件路径预埋、SOURCE_TYPE_MAP 扩充含"军报文章/装备/技术/动态/术语/厂商/索引");② 脚本 `backend/scripts/import_obsidian_kb.py`(递归遍历、跳过 .obsidian+原始素材+空文件+无 frontmatter、按相对路径查重、支持 --limit/--dry-run/--dir),成功导入 164 篇(7+157),知识库从 22 → 186 条;③ 搜索体验三项改进:`search_similar` 返回完整 content_md + 智能摘要 `_extract_smart_snippet`(中文 2-gram 拆词+加权段落匹配+关键词加粗)+ min_similarity=0.3 过滤 + top_k 5→10;④ 前端搜索卡片升级(展开全文 Set 状态管理、`renderSnippet` 加粗渲染、相关度分档样式:≥70%蓝左边框/<50%半透明灰底)。
- [2026-07-07] **知识库冷启动:doco 22 期融合A稿批量导入**:脚本 `backend/scripts/import_doco_transcripts.py`,docx → 提取纯文本 → 包 YAML frontmatter → 调 `store_md_file()` 入库(自动算 MiniMax embo-01 embedding)。22 篇全部成功(第02期~第23期,缺第01期无A稿),source_type=manuscript,知识库从 0 → 22 条节目文稿。
- [2026-07-07] **期次一条龙录入子项目立项(只立项不开发)**:① PRD v1.0 写入 `episode-intake/PRD_期次一条龙录入_v1.md`(每期任务清单模式、4 状态点、抽屉四区块、6 个新 API、005 迁移只加 transcript_item_id 一列、看板只用 reviewed 期次、四刀分期+七条验收);② 制片人三项拍板:文稿口径=doco 融合A稿(CCA 是播出前工具不算终稿,doco 转常态运行)、22 期批量导入时回联期次、责编可触发 AI 处理;③ 子项目 CLAUDE.md + 寄存条建立,CCA 寄存条清单表同步更新。
@@ -108,6 +110,7 @@
- [x] ~~200+ Obsidian md 批量录入~~ → 已完成(2026-07-08),164 篇导入成功,知识库 186 条
- [ ] **下一刀**Phase 4a 对话式 TPS 选题策划助手(左对话右报告、脚注式引用、知识库检索底座已就绪)。
- [ ] **期次一条龙录入开发**(子项目已立项 2026-07-07PRD 就绪在 `episode-intake/`,等制片人排期;四刀分期,第二刀含 doco 22 期导入回联)。
- [ ] **知识库笔记工坊开发**(子项目已立项 2026-07-09PRD 就绪在 `new_notemd/`,等制片人排期;四刀分期——查看编辑/AI加工新建/审核流程/打磨,006 迁移在第二刀)。
- [ ] PDF 大文件存储:**大文件不入库,单独文件仓库,DB 只存地址指针**(md 正文+向量留库参与检索;pdf 仅按需调阅)。地基一次定对,避免上云返工。Obsidian 导入时已把源文件路径存入 `metadata["source_files"]` 预埋。
- [ ] 「按编导看稿」独立筛选视图(路线 A 重构时一并处理,从来源树里迁出来)。
- [ ] 操作留痕 schemaepisodes 等加 created_by/updated_by/updated_at;涉 schema 须 Opus 审)。
@@ -144,6 +147,7 @@
## 7. ⏩ 交接备注(换人/换账号 0 摩擦续上)
- **知识库笔记工坊已立项**(2026-07-09):子项目目录 `new_notemd/`PRD v1.0 含查看/编辑抽屉 + AI 加工新建笔记(五种输入:文本/PDF/Word/链接/md)+ 审核制(编导提交→制片人/责编审批→入搜索池)。四刀分期,006 迁移在第二刀(knowledge_items +status/submitted_by/reviewed_by 等)。寄存条 `note/寄存条知识库笔记工坊子项目已外迁.md`
- **知识库语义搜索已可用**2026-07-08):186 条知识库条目(doco 22 篇 + Obsidian 164 篇),搜索链路完整(MiniMax embo-01 query embedding → pgvector 余弦检索 → 智能摘要 + 关键词加粗 + 展开全文)。新增文件:`backend/scripts/import_obsidian_kb.py`(批量导入脚本)。`knowledge_service.py``parse_md_file` 已补强支持全部 Obsidian frontmatter 字段。搜索结果返回 `content_md` 完整正文供展开查看。Obsidian 源文件路径已存入 `metadata["source_files"]` 预埋 PDF 关联。
- **收视分析看板 L1-L4 全部完成**。页面布局:指标卡 → 走势图 → AI 诊断报告(摘要块) → 双引擎象限图 → 双列对比(左:季度+编导, 右:题材)。
- **L4 AI 诊断报告新增文件**:后端 `backend/app/api/analytics.py`POST 端点);前端 `DiagnosisSummary.jsx`(摘要块)+ `DiagnosisReport.jsx/.css`(详情页);Prompt 文件 `ai-labeling/prompts/prompt4_content_digest.md` + `prompt5_diagnosis_report.md`;批量脚本 `ai-labeling/scripts/gen_content_digest.py` + `scripts/import_content_digests.py`