Repository navigation
对照飞书官方 CLI 补齐云文档能力。本版本只做新增：已有命令不带新参数时，默认值、身份、输出结构和退出码都与 v1.42.0 一致。
升级后请运行
feishu-cli skills install，重新安装与本版本配套的技能（文档技能新增 author、mindnote 两个工作流）。
写入
doc create --content/--content-file支持本地图片和附件，写法包括 Markdown 的，以及 XML 的<img path>、<source path>。建文档后会自动上传并绑定。doc create与doc content-update的 XML 支持以下三种写法：<html5-block path="@./w.html"/>：本地 HTML 块；<whiteboard type="svg|mermaid|plantuml" path="@./x"/>：本地画板源文件；--reference-map。
- 两条命令新增
--dry-run：只打印将发出的请求和上传计划，不联网、不解析身份。 <img href="https://...">和 Markdown 网络图片仍由服务端下载，行为不变。
读取
doc read --doc-format im-markdown：转成可以直接作为 IM 消息正文的 Markdown。doc read --lang：设置人员引用的显示语言。
封面与素材
doc resource download|update|delete --type cover：下载、设置、删除文档封面。设置时可以用本地文件（超过 20MB 自动分片）、HTTPS 图片或剪贴板。--url会拒绝内网和保留地址。doc media-preview：通过预览接口保存文档素材或评论图片。doc media-insert新增--file-view card|preview和--from-clipboard；media upload新增--doc-id。
写作与思维笔记
doc script --command init-draft|parse：初始化写作草稿工作区；解析本地或在线文档的 DocxXML，输出画像、字数统计和块分布；预检本地资源与远程图片。文档技能新增author写作工作流，包含 DocxXML 写作规范和 28 个文体模板。mindnote nodes list|create：读取已有思维笔记的节点，新增或更新节点。需要应用开通mindnote:node:read和mindnote:node:create。
修复
content-update中只写<img width>时图片会被拉伸，现在按原图像素换算为 scale。- JSON 输出中残留本地资源占位标记，现在回填真实 token 和绑定后的版本号。
- HTML 注释里的本地图片会被误上传。
验证：
- 在 main 上跑了 gofmt、
go vet、go test（22 个包）、全量-race、make check-skills、make check-privacy，全部通过。 - 五个平台都已编译、打包，并通过 sha256 校验。
- 用正式发版包在真实飞书环境做了 E2E，85 项全部通过。测试只用新建的测试文档，测完已删除。
- 用 v1.42.0 发版包逐条对比 13 组旧命令，退出码、输出和 JSON 字段一致。
尚未真实验证：
- 思维笔记的成功路径：应用未开通相应 scope。
- 真实剪贴板：只用替身程序和单元测试验证。
- 评论图片的预览。
- 模型触发评测：未运行，只对技能描述做了静态覆盖核对。
部分实现和技能文档改编自 larksuite/cli（MIT），版权与许可声明见 THIRD_PARTY_NOTICES.md。