unipus-feishu-doc-load

unipus-feishu-doc-load

宣告：正在使用 unipus-feishu-doc-load v1.0

职责

从飞书「研发数字化资产文档库」定位并下载指定项目/版本的文档到本地 doc/ 目录，以便当前项目各角色（产品、UI、后端、前端、测试）可在 Claude 会话中直接引用文档内容。

主目录： https://es3eflgtuw.feishu.cn/drive/folder/RX2gfGuXjlTyiMdouqwcAvwpnX8 主目录 Token： RX2gfGuXjlTyiMdouqwcAvwpnX8

部门缩写对照表

部门	缩写
高教事业部	GJ
基教事业部	JJ
技术共享中心	GX
学历事业部	XL
职教事业部	ZJ
语服事业部	YF

目录命名规范

子目录格式：<部门缩写>_<项目名称>
示例：GX_用户中心、GJ_营销平台、JJ_基础设施、YF_翻译平台

文件命名规范

格式：<版本>_<项目名称>_<文档类型>.<扩展名>
示例：V2.0_用户中心_需求文档.md
     V2.0_用户中心_后端api文档.md
     V2.0_用户中心_技术架构设计方案.md

文档库路径结构：

/<部门缩写>_<项目名称>/
    ├── <版本>_<项目名称>_需求文档.md
    ├── <版本>_<项目名称>_系统架构设计.md
    ├── <版本>_<项目名称>_UI设计.md
    ├── <版本>_<项目名称>_后端api文档.md
    ├── <版本>_<项目名称>_前端组件文档.md
    └── <版本>_<项目名称>_测试用例.md

本地环境检测

执行前优先检测lark-cli环境

lark-cli --version

HARD-GATE

□ lark-cli 已安装（lark-cli --version）且已认证（lark-cli doctor）

条件不满足 → 停止，提示安装 lark-cli。

Workflow

Step 1：确认项目信息

逐一询问（每次 1 个问题，已知则跳过）：

问题 1：事业部 展示选项，请用户选择：

□ GJ — 高教事业部
□ JJ — 基教事业部
□ GX — 技术共享中心
□ XL — 学历事业部
□ ZJ — 职教事业部
□ YF — 语服事业部

问题 2：产品/产品线名称 如：外研U学、AIGC平台、统一认证平台 （可调用 lark-cli 搜索文档库辅助选择）

问题 3：版本 如：V202603、V2.0、V_Beta （若不确定，可搜索该产品目录下已有版本列表供选择）

问题 4：需要加载哪些文档？（可多选，默认全部）

□ prd*    — 产品需求
□ arch*   — 系统架构
□ design* — UI/UX 设计
□ be*     — 后端接口
□ fe*     — 前端组件
□ test*   — 测试用例
□ team*   — 项目团队

Step 2：定位飞书目录

构建目标路径：主目录下的 <部门缩写>_<项目名称>/ 子目录

先查询主目录下的子文件夹列表，定位目标子目录：

lark-cli api GET /open-apis/drive/v1/files \
  --params '{"folder_token":"RX2gfGuXjlTyiMdouqwcAvwpnX8","page_size":200}'

从返回结果中查找匹配 <部门缩写>_<项目名称> 的文件夹，记录其 token。

然后列出该子目录下的文件，筛选出匹配版本前缀 <版本>_ 的文件：

lark-cli api GET /open-apis/drive/v1/files \
  --params '{"folder_token":"<子目录 token>","page_size":200}'

若目录不存在：

• 提示「未找到 <部门缩写>_<项目名称> 子目录，是否搜索相似名称？」
• 使用 lark-cli 搜索产品名，列出候选目录供用户选择

Step 3：创建本地 doc/ 目录

mkdir -p ./doc

检查 ./doc/ 是否已有同名文件，若有则提示：

• 「以下文件已存在，是否覆盖？」（列出文件名）
• 用户确认后继续

Step 4：逐一下载所选文档

**使用lark-cli下载

显示进度：

[导航] 正在查找 GX_AIGC平台/ 子目录...
[加载] 正在列出文件夹内容，筛选版本 V2.1 的文件...
[下载] V2.1_AIGC平台_需求文档.md → ./doc/V2.1_AIGC平台_需求文档.md
  ✓ 已保存（3420 字符）
[下载] V2.1_AIGC平台_后端api文档.md → ./doc/V2.1_AIGC平台_后端api文档.md
  ✓ 已保存（8610 字符）

Step 5：生成 doc/README.md

自动在 ./doc/ 目录生成索引文件：

# 项目文档索引

**项目**：{部门缩写}_{项目名称}
**版本**：{版本}
**加载时间**：{datetime}
**飞书路径**：主目录/{部门缩写}_{项目名称}/

## 文件清单

| 文件 | 文档类型 | 飞书链接 |
|------|---------|---------|
| V2.0_用户中心_需求文档.md | 产品需求 | {url} |
| V2.0_用户中心_技术架构设计方案.md | 系统架构 | {url} |
...

Step 6：输出汇报

项目文档加载完成！

项目: {部门缩写}_{项目名称} / {版本}
已下载: {N} 个文件 → ./doc/

文件清单:
- ./doc/V2.0_用户中心_需求文档.md
- ./doc/V2.0_用户中心_技术架构设计方案.md
- ./doc/V2.0_用户中心_前端组件文档.md

提示：文档已就绪，当前会话可直接引用 ./doc/ 中的内容。
如需更新文档到飞书，使用 unipus-feishu-doc-sync

Red Flags

现象	处理
产品名拼写不确定	调用 lark-cli 搜索，列出候选
版本目录不存在	列出该产品下已有版本，让用户选择
部分文件下载失败	标注失败文件，其余继续，最后汇报失败原因
doc/ 目录已有旧版文档	提示版本冲突，询问是否清空后重新加载