Lark Doc Personal

通用能力 Skill：用 --as user 在飞书个人版直接创建文档，归属当前登录用户的个人云空间。 不做权限转移、不做消息投递、不依赖企业 bot —— 与企业版的 lark-doc-deliver 互不重叠。

为什么独立成一个 Skill

lark-doc-deliver 走的是 企业版 bot 流程：bot 创建 → transfer_owner 给员工 → bot 群发消息。 个人版没有"组织内员工"概念，bot 创建的文档会落在 app 云空间（用户 UI 不可见）， 且 stay_put=true 后跨空间 move API（drive +move）会报 1061002 params error。 最干净的方案就是 --as user 一步到位，所以这里独立一个最小 Skill。

Prerequisites

如未登录，跑：

lark-cli auth login --domain docs,drive --no-wait --json
# 把返回的 verification_url 给用户，用户在浏览器输入 code 完成授权后：
lark-cli auth login --device-code <从上一步拿到的 device_code>

Input

Execution Flow

Step 1: 检查登录状态

lark-cli auth status

确认输出含 userOpenId。如无，按 Prerequisites 引导用户走 OAuth。

Step 2: 复制到工作目录（@file 仅支持相对路径）

cp <markdown_file> /tmp/lark_personal_temp.md
cd /tmp

Step 3: 创建文档

lark-cli docs +create \
  --title "<title>" \
  --content @lark_personal_temp.md \
  --doc-format markdown \
  --as user

如果调用方提供了 folder_token，在创建命令中同时加入 --parent-token "<folder_token>"，直接创建到目标文件夹。

从输出 JSON 提取：

• doc_url（优先路径：.data.document.url；兼容路径：.data.doc_url / .data.url）
• document_id（优先路径：.data.document.document_id；兼容路径：.data.doc_id / .data.document_id）

Step 4: 清理

rm -f /tmp/lark_personal_temp.md

Step 5: 输出结果

doc_url: <doc_url>
document_id: <document_id>
owner: <userOpenId from auth status>

URL 形式可能是 www.feishu.cn/docx/...，实际也可用 my.feishu.cn/docx/... 打开（个人版默认 UI 域名）。 两个域名打开的是同一份文档。

Key Rules

1. 始终用 --as user —— 个人版用 bot 创建会进 app 云空间（用户不可见），且 transfer + 跨空间 move 都不可行
2. @file 仅支持相对路径 —— 一定要 cp 到 /tmp 后 cd /tmp 再调用
3. 不要套用 lark-doc-deliver 的 transfer_owner 流程 —— 个人版 user 创建的文档默认就在用户云空间，无需转移
4. 不发消息 —— 个人版 user_access_token 没有 bot 的 im:message 群发能力；如需通知用户，直接把 URL 给他

Troubleshooting

与 lark-doc-deliver 的差异