soia-cwork-feishu-doc-git-synclisted

# soia-cwork-feishu-doc-git-sync 把飞书知识库的内容镜像到一个本地 Markdown 知识库。默认方向是 Feishu → local/Git/Obsidian/VitePress；本技能不默认向飞书写入，双向同步必须先建立文档归属、冲突策略和写权限。 ## 客户可读说明 ### 这个技能可以做什么 | 客户想要 | 技能会做 | 客户能看到 | |---|---|---| | 同步飞书知识库到本地 | 遍历知识空间节点，读取可读文档并生成 Markdown | 本地镜像目录、目录层级、来源链接、同步清单 | | 备份到 Git | 将生成内容放入客户指定的 Git 仓库并检查差异 | commit/push 回执、文件变更���失败清单 | | 用 Obsidian 查看 | 在独立 vault 中保存规则、镜像和本地补录 | 可直接用 Obsidian 打开的 vault | | 用 VitePress 展示 | 生成站点侧边栏并构建静态站点 | 本地开发服务或构建产物 | | 检查表格/多维表格导出能力 | 解析真实资源类型、权限和可用导出格式 | 只读探查结果；不会默认生成 Excel 文件 | | 规划双向同步 | 区分只读镜像、托管文档和本地补录 | 冲突/权限风险说明，不自动覆盖飞书 | ### 客户如何使用 1. 确认 `soia-cwork-feishu-cli` 已完成飞书应用凭证登录，并且机器人可以读取目标知识空间。 2. 在本机私有配置中填写知识空间 ID、输出目录和来源 URL 模板；不要把 App Secret、token 或企业私有路径提交到公开技能仓库。 3. 首次使用先执行 dry-run，核对空间、节点数量和目标目录。 4. 执行镜像同步。默认只写本地文件和同步元数据，不修改飞书内容，也不删除本地历史文件。 5. 同步写入后会自动校验 manifest、文件存在性、frontmatter、失败占位、侧边栏覆盖范围和资源引用；发现 `failed`/`stale` 时返回非零结果，不能把旧正文当作最新成功。 6. 如需检查表格导出，先做 `drive +inspect`/帮助/schema 探查；能力探查不等于授权导出。 7. 只有客户明确确认导出范围、格式、文件数和本地目录后，才调用 `drive +export` 或 `drive +export-download`。 8. 同步完成后再运行 Git diff、站点构建和必要的人工抽查。 推荐命令： ```bash python3 scripts/sync_feishu_wiki.py --config <private-config.yml> --dry-run python3 scripts/sync_feishu_wiki.py --config <private-config.yml> --incremental # 没有事件订阅时，按 wiki +node-get 的远端更新时间判断正文是否变化 python3 scripts/sync_feishu_wiki.py --config <private-config.yml> --incremental --probe-remote-metadata # 如果上次清单已有失败项，复用成功正文，只退避重试失败项 python3 scripts/sync_feishu_wiki.py --config <private-config.yml> --retry