用途：以应用身份（--as bot）将飞书知识库只读镜像为本地 Markdown（Feishu → local/Git/Obsidian/VitePress），默认不向飞书写入。三种模式：mirror（默认，本地生成目录不应手工编辑）、local（只维护本地补录目录）、managed（双向托管为未来方向，当前只提供只读镜像基础）。
主要能力：按 node token 遍历知识空间、按文档 token 读取正文；写入来源 URL、space ID、node token、父节点与内容 hash，用 sync-state.json、manifest.json 记录 obj_edit_time、remote_updated_at、revision_id。支持增量同步、失败重试、目录树重建、资源本地化、内链改本地导航、变更台账；可选镜像 Sheet、多维表格与 Wiki 文件，并支持 .xlsx/.base 保真导出。
用法要点：先完成 soia-cwork-feishu-cli 应用凭证登录并确认机器人可读目标知识空间；在私有配置填写空间 ID、输出目录、来源 URL 模板。首次执行先 dry-run，再单节点试点，随后执行镜像同步。推荐命令： python3 scripts/sync_feishu_wiki.py --config <private-config.yml> --dry-run python3 scripts/sync_feishu_wiki.py --config <private-config.yml> --incremental python3 scripts/sync_feishu_wiki.py --config <private-config.yml> --validate-only 安装： claude plugin marketplace add soia-team/soia-open-skills claude plugin install soia-cwork-office@soia 或 npx skills add soia-team/soia-open-cwork-office-skills -g -a '*' -s soia-cwork-feishu-doc-git-sync -y 依赖 Python 3.10+、PyYAML、lark-cli；Git、Obsidian、VitePress 为可选增强。
限制：默认只写本地文件与同步元数据，不修改飞书内容、不删除本地历史文件；prune 默认 false。导出、附件下载、完整初始化与双向写入均需用户明确确认范围、格式、文件数、输出目录和 Git 策略，能力探查不等于授权导出。不得在日志或提交中暴露 App Secret、token、私有路径与下载 URL。
适用场景与费用、价格、支持的平台范围等详细信息暂未提供。