feishu-sheet-links

从公开的飞书多维表格（Feishu spreadsheet）的每个工作表标签页中提取全部超链接，并可选地将这些链接指向的文章批量下载为 Markdown 文件。

工作流程

调用本功能时，请按以下步骤执行：

步骤 1 — 获取 URL

若用户已提供飞书链接，则直接使用；否则询问：

“请提供飞书多维表格的链接（公开可访问的）”

确认该 URL 符合 https://*.feishu.cn/wiki/... 或 https://*.feishu.cn/sheets/... 格式。

步骤 2 — 提取链接

解析技能目录：

SKILL_DIR="$(find ~/.claude/skills /workspace/.claude/skills -maxdepth 1 -name feishu-sheet-links -type d 2>/dev/null | head -1)"

运行提取脚本：

npx -y bun "${SKILL_DIR}/scripts/main.ts" "" -o feishu-links.json

每个工作表标签页加载需耗时 8–15 秒，请告知用户可能需要稍等片刻。

步骤 3 — 展示摘要信息

提取完成后，向用户提供如下摘要信息：

• 共发现多少个工作表
• 每个工作表中的链接数量（附带工作表名称）
• 链接总数

示例：

Found 4 sheets, 127 links total:
- 1月: 32 links
- 2月: 28 links
- 3月: 35 links
- 4月: 32 links

Saved to: feishu-links.json

步骤 4 — 提供文章下载选项

询问用户是否需要将这些链接指向的文章批量下载为 Markdown 文件：

“是否需要批量下载这些文章为 Markdown 文件？”

若用户选择是，则询问输出目录（默认为 ./feishu-articles），随后执行：

npx -y bun "${SKILL_DIR}/scripts/download.ts" feishu-links.json 
  -o  
  -c 5 
  --max-wait 20000

下载支持断点续传 — 若中途中断，重新运行命令将跳过已成功下载的文件。

错误处理

实现原理

1. 优先复用已存在的 Chrome 实例（监听端口：64023、9222、9229）；若无可用实例，则启动一个独立隔离的 Chrome 进程
2. 打开目标多维表格，通过 spreadApp.collaborativeSpread._spread.sheetIdToIndexMap 获取全部工作表 ID
3. 对每个工作表，单独打开一个标签页（URL 后缀为 ?sheet=），调用 setActiveSheetIndex() 触发懒加载，并等待 sheet._dataModel.contentModel 完成初始化
4. 从飞书两种存储格式中提取链接：
   • url-type — 来自 contentModel.link.idToRef._map（整单元格超链接）
   • mention-type — 来自 contentModel.segmentModel.table（行内富文本链接）

环境变量