Showing
3 changed files
with
44 additions
and
0 deletions
| @@ -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 |
-
Please register or login to post a comment