Menú
将当前项目的 Markdown 文档（及其引用的本地图片）一键同步到飞书云文档。基于 lark-cli，自动上传图片、替换 token、以 overwrite 方式覆盖正文。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
将当前项目的 Markdown 文档（及其引用的本地图片）一键同步到飞书云文档。基于 lark-cli，自动上传图片、替换 token、以 overwrite 方式覆盖正文。
使用 flutter_copilot_cli (fcc) 命令行工具连接并驱动一个运行中的 Flutter debug 应用：自动发现 URI、截图、元素检查、手势交互、日志、热重载、YAML 脚本回放
连接 Flutter Copilot MCP，支持自动读取 VM Service URI、截图、交互、热重载，以及需要重启时自动调用脚本重连
升级 flutter_copilot_claw 和 flutter_copilot_mcp 的共享版本号，更新 changelog，生成 version.g.dart，并通过 tool/publish.sh 完成 dry-run 或正式发布
Basado en la clasificación ocupacional SOC
| name | feishu-sync-doc |
| description | 将当前项目的 Markdown 文档（及其引用的本地图片）一键同步到飞书云文档。基于 lark-cli，自动上传图片、替换 token、以 overwrite 方式覆盖正文。 |
| author | Flutter Copilot Team |
一键把本地 Markdown（含本地图片引用）同步到飞书文档：上传图片 → 替换 token → 覆盖正文。
.Codex/skills/feishu_sync/
├── SKILL.md # 本文件
├── sync.sh # 可复用的同步脚本
├── cache/ # Token 缓存（按文件 mtime 命中，避免重复上传）
│ └── *.tokens.json
└── examples/ # 历史运行产物（参考）
└── *.with_tokens.md
npm i -g @larksuite/cli
lark-cli auth login --scope "docs:write drive:write"
已有目标飞书文档（Docx）且拥有写入权限。
bash .Codex/skills/feishu_sync/sync.sh <SOURCE_MD> <FEISHU_DOC_URL> [NEW_TITLE]
示例：
bash .Codex/skills/feishu_sync/sync.sh \
"分享/FlutterCopilot项目演讲稿_v2.md" \
"https://hcnigilc9nwt.feishu.cn/docx/YzAPdiEhWoAFKUxNMbbc2Ww2nLh" \
"让 AI 真正上手操作 App —— Flutter Copilot 项目实践分享"
，只保留非 http 的本地相对路径。lark-cli docs +media-insert --doc <DOC> --file <path> 上传，解析返回的 file_token；以 path@mtime 为 key 缓存到 cache/<md名>.tokens.json，下次命中则跳过上传。 替换为 <image token="..." width="1200" height="<按SVG宽高比计算>" align="center"/>（脚本会自动解析 SVG viewBox/width/height 计算比例，PNG/JPG 通过 PIL 读取像素），输出到 cache/<md名>.with_tokens.md。lark-cli docs +update --mode overwrite --markdown @<tmp.md>，可选 --new-title 同步更新标题。./images/svg/xx.svg）rm -rf .Codex/skills/feishu_sync/cache/*
lark-cli docs +media-insert --helplark-cli docs +update --help整文 overwrite 会清掉飞书上手动插入的视频/附件/白板等块，使用 --mode 做局部更新：
# 按标题选中某个 section 替换
lark-cli docs +update --doc <URL> \
--mode replace_range \
--selection-by-title "### 某章节标题" \
--markdown @new_section.md
# 在指定文本前插入
lark-cli docs +update --doc <URL> \
--mode insert_before \
--selection-with-ellipsis "目标锚点文本" \
--markdown @addition.md
已知限制： lark-cli 的 Markdown 方言不识别 <view> / <file> 等非标准标签，整文同步时会被丢弃（触发 UNSUPPORTED_HTML_TAG 警告）。若目标文档里有手动上传的视频/附件块，不要用 overwrite 整段替换，改用 replace_range / insert_before / insert_after 绕开这些块。仅 <image token="..."/> 是受支持的 HTML 标签。