Commit 69b78c03a5121416586887969bff28b03cc2f7ff

Authored by 鲲鹏
1 parent 12a6089d

update

@@ -97,6 +97,30 @@ bash scripts/rebuild_all_kb.sh @@ -97,6 +97,30 @@ bash scripts/rebuild_all_kb.sh
97 97
98 - `dist/quality/atom_quality_summary.md` 98 - `dist/quality/atom_quality_summary.md`
99 99
  100 +## 4.1 更新后的同步动作
  101 +
  102 +每次版本更新完成后,除了本地产物和 Dify,还要同步团队阅读入口。
  103 +
  104 +### 飞书文档同步
  105 +
  106 +建议至少同步下面三份主文档:
  107 +- `docs/产品研发RAG_总体方案与实施手册.md`
  108 +- `docs/产品研发RAG_增量更新与Dify维护手册.md`
  109 +- `docs/产品研发RAG_接手说明.md`
  110 +
  111 +如果这次版本有明显规则变化,还要同步:
  112 +- `dist/dify_import/02_版本变更总览.md`
  113 +
  114 +如果这次新增了专项高优先参考,还要同步:
  115 +- 对应 `inputs/priority_refs/*.md`
  116 +
  117 +### 最小提醒清单
  118 +
  119 +每次增量更新后至少检查:
  120 +- 本地产物已重建
  121 +- Dify 知识库已替换受影响文件
  122 +- 飞书主文档已同步到最新
  123 +
100 ## 5. Dify 中怎么更新 124 ## 5. Dify 中怎么更新
101 125
102 当前推荐是 3 个知识库: 126 当前推荐是 3 个知识库:
@@ -189,6 +213,7 @@ bash scripts/rebuild_all_kb.sh @@ -189,6 +213,7 @@ bash scripts/rebuild_all_kb.sh
189 -`rebuild_version_kb.sh <version>` 213 -`rebuild_version_kb.sh <version>`
190 - 替换产品主知识库对应模块文件 214 - 替换产品主知识库对应模块文件
191 - 替换版本与预评审知识库中的 `02_版本变更总览.md` 215 - 替换版本与预评审知识库中的 `02_版本变更总览.md`
  216 +- 同步更新飞书中的主文档和版本变更总览
192 217
193 ### 新增专项高优先参考 218 ### 新增专项高优先参考
194 219
@@ -196,11 +221,13 @@ bash scripts/rebuild_all_kb.sh @@ -196,11 +221,13 @@ bash scripts/rebuild_all_kb.sh
196 - 整理出 Markdown 放同目录 221 - 整理出 Markdown 放同目录
197 -`python3 scripts/build_dify_import_pack.py` 222 -`python3 scripts/build_dify_import_pack.py`
198 - 上传对应高优先参考文件到产品主知识库 223 - 上传对应高优先参考文件到产品主知识库
  224 +- 如需团队可读,也同步到飞书专项文档目录
199 225
200 ### 后台代码更新 226 ### 后台代码更新
201 227
202 - 跑带 `backend_repo` 的版本重建或全量重建 228 - 跑带 `backend_repo` 的版本重建或全量重建
203 - 替换后台实现补充知识库 4 个文件 229 - 替换后台实现补充知识库 4 个文件
  230 +- 如实现约束变化明显,同步更新飞书主文档中的实现说明
204 231
205 ## 9. 原则 232 ## 9. 原则
206 233
@@ -84,6 +84,21 @@ python3 scripts/build_dify_import_pack.py @@ -84,6 +84,21 @@ python3 scripts/build_dify_import_pack.py
84 bash scripts/rebuild_all_kb.sh /Users/xwk/Downloads/studio-server2 84 bash scripts/rebuild_all_kb.sh /Users/xwk/Downloads/studio-server2
85 ``` 85 ```
86 86
  87 +## 5.1 别漏掉飞书同步
  88 +
  89 +每次版本更新后,除了重建本地产物和更新 Dify,还要同步飞书文档。
  90 +
  91 +至少同步:
  92 +- `docs/产品研发RAG_总体方案与实施手册.md`
  93 +- `docs/产品研发RAG_增量更新与Dify维护手册.md`
  94 +- `docs/产品研发RAG_接手说明.md`
  95 +
  96 +如果这次有版本变化,还同步:
  97 +- `dist/dify_import/02_版本变更总览.md`
  98 +
  99 +如果这次有新增专项规则,还同步:
  100 +- 对应 `inputs/priority_refs/*.md`
  101 +
87 ## 6. 不要做的事 102 ## 6. 不要做的事
88 103
89 - 不要把所有内容硬塞回 Dify 的一个知识库 104 - 不要把所有内容硬塞回 Dify 的一个知识库
@@ -99,3 +114,4 @@ bash scripts/rebuild_all_kb.sh /Users/xwk/Downloads/studio-server2 @@ -99,3 +114,4 @@ bash scripts/rebuild_all_kb.sh /Users/xwk/Downloads/studio-server2
99 2. 确认新资料应该放到 `pdf/`、`testCase/`、`inputs/figma/` 还是 `inputs/priority_refs/` 114 2. 确认新资料应该放到 `pdf/`、`testCase/`、`inputs/figma/` 还是 `inputs/priority_refs/`
100 3.`scripts/rebuild_version_kb.sh` 115 3.`scripts/rebuild_version_kb.sh`
101 4. 在 Dify 里只替换受影响的知识库文件 116 4. 在 Dify 里只替换受影响的知识库文件
  117 +5. 同步更新飞书入口文档
@@ -62,6 +62,7 @@ After any update: @@ -62,6 +62,7 @@ After any update:
62 1. Check `dist/dify_import/`, `dist/backend_code/`, `dist/final_kb/`. 62 1. Check `dist/dify_import/`, `dist/backend_code/`, `dist/final_kb/`.
63 2. Check `dist/quality/atom_quality_summary.md`. 63 2. Check `dist/quality/atom_quality_summary.md`.
64 3. Run Dify retrieval tests using the examples in `references/validation-queries.md`. 64 3. Run Dify retrieval tests using the examples in `references/validation-queries.md`.
  65 +4. After version updates, remind the user to sync the Feishu docs entry pages and version overview.
65 66
66 ## Notes 67 ## Notes
67 68