| name | feishu-doc |
| description | 读写本项目的飞书文档「seamless-interaction」（wiki MBp9wq1PSiklbmkvCR9cQKvTn5g）。同步计划、写实验笔记、插图片/GIF/视频到飞书时使用。依赖本机已安装的 lark-cli。 |
飞书文档「seamless-interaction」
文档信息（2026-08-23 验证可读写）
通用语法以全局 skill lark-doc 为准，本 skill 只记录本项目特有信息。
姊妹项目在同一知识空间：「StarVLA项目」VWXnwHjN4iVlKUkm7HZcN7Ddnjc、
「SONIC项目」A26bwAyaviDV3pkelBhcsBzGnfg，写法一致。
常用命令
lark-cli docs +fetch --as user --doc "https://my.feishu.cn/wiki/MBp9wq1PSiklbmkvCR9cQKvTn5g" --doc-format markdown
lark-cli docs +fetch --as user --doc "https://my.feishu.cn/wiki/MBp9wq1PSiklbmkvCR9cQKvTn5g" --scope outline --max-depth 2 --detail with-ids
lark-cli docs +update --as user --doc "https://my.feishu.cn/wiki/MBp9wq1PSiklbmkvCR9cQKvTn5g" --command append --content '<h1>标题</h1><p>正文</p>'
lark-cli wiki +node-create --as user --parent-node-token MBp9wq1PSiklbmkvCR9cQKvTn5g --title "标题"
lark-cli wiki +node-list --as user --space-id 7497129636623663108 --parent-node-token MBp9wq1PSiklbmkvCR9cQKvTn5g
子页一览
| 页 | node_token | obj_token（docx） |
|---|
| 00 表示与数据 | | |
| 01 条件与模型 | | |
| 02 第二环：文本到底有没有用 | | |
父页顶部维护「目录」列表，每建一个子页就加一条
<ul><li><cite type="doc" doc-id="<obj_token>"/> — 一句话说明</li></ul>，
用 block_insert_after --block-id <上一个 li 的 id> 插入。
媒体
docs +media-insert 只认 docx token（obj_token），不认 wiki URL：
lark-cli docs +media-insert --as user --doc <obj_token> --file ./x.gif --width 800 --caption "..."
lark-cli docs +media-insert --as user --doc <obj_token> --file ./x.mp4 --type file
媒体只能插到文末 → 先写文字再插媒体，或分段 append。GIF 控制在 5 MB 内（抽帧 + 缩放）。
路径必须是相对 cwd 的相对路径，传绝对路径会报 unsafe file path。
规则
- 改已有内容用
block_replace / block_insert_after，不要用 overwrite（会丢图片和评论）。
- 每次写操作后 block ID 会变，重新 fetch 再做下一步。
- 写完用
+fetch --doc-format markdown 回读验证。
- 网络受限时 lark-cli 会连不上，处理方式同
git-push skill。
