Skip to content

Pinvou/pinvou-agent / pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-drive

lark-drive

Verified

【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书云空间:管理 Drive 文件/文件夹,上传下载、复制移动删除、评论、权限、密级标签、版本、改标题,导入 Word/Markdown/Excel/CSV/PPTX/.base 为在线文档;doubao.com 云空间 URL 同走本 skill,不回退 WebFetch。不负责:文档内容编辑(lark-doc)、表格/Base 表内数据(lark-sheets/lark-base)、知识库节点(lark-wiki)。

FileKindSize
SKILL.mdskill md24.3 KB
references/lark-drive-add-comment.mdmarkdown11.9 KB
references/lark-drive-add-reply.mdmarkdown2.5 KB
references/lark-drive-apply-permission.mdmarkdown3.6 KB
references/lark-drive-batch-query-comments.mdmarkdown2.4 KB
references/lark-drive-comment-content.mdmarkdown2.6 KB
references/lark-drive-comment-location.mdmarkdown10.8 KB
references/lark-drive-copy.mdmarkdown3.9 KB
references/lark-drive-cover.mdmarkdown2.4 KB
references/lark-drive-create-folder.mdmarkdown3.7 KB
references/lark-drive-create-shortcut.mdmarkdown4.3 KB
references/lark-drive-delete-reply.mdmarkdown2.4 KB
references/lark-drive-delete.mdmarkdown4.5 KB
references/lark-drive-download.mdmarkdown2.8 KB
references/lark-drive-export-download.mdmarkdown1.5 KB
references/lark-drive-export.mdmarkdown8.2 KB
references/lark-drive-files-list.mdmarkdown10.2 KB
references/lark-drive-import.mdmarkdown11.0 KB
references/lark-drive-inspect.mdmarkdown2.1 KB
references/lark-drive-list-comments.mdmarkdown5.9 KB
references/lark-drive-list-replies.mdmarkdown2.6 KB
references/lark-drive-member-add.mdmarkdown5.1 KB
references/lark-drive-member-list.mdmarkdown3.0 KB
references/lark-drive-member-remove.mdmarkdown2.9 KB
references/lark-drive-move.mdmarkdown5.0 KB
references/lark-drive-permission-get-setting.mdmarkdown1.8 KB
references/lark-drive-permission-guide.mdmarkdown3.7 KB
references/lark-drive-preview.mdmarkdown4.6 KB
references/lark-drive-pull.mdmarkdown9.8 KB
references/lark-drive-push.mdmarkdown18.0 KB
references/lark-drive-react-reply.mdmarkdown2.9 KB
references/lark-drive-reactions.mdmarkdown7.1 KB
references/lark-drive-resolve-comment.mdmarkdown1.7 KB
references/lark-drive-restore-comment.mdmarkdown2.1 KB
references/lark-drive-search.mdmarkdown22.5 KB
references/lark-drive-secure-label.mdmarkdown2.0 KB
references/lark-drive-status.mdmarkdown7.3 KB
references/lark-drive-task-result.mdmarkdown13.4 KB
references/lark-drive-update-reply.mdmarkdown2.4 KB
references/lark-drive-update-title.mdmarkdown3.4 KB
references/lark-drive-upload.mdmarkdown5.4 KB
references/lark-drive-version-delete.mdmarkdown1.0 KB
references/lark-drive-version-get.mdmarkdown2.0 KB
references/lark-drive-version-history.mdmarkdown1.9 KB
references/lark-drive-version-revert.mdmarkdown1.3 KB
references/lark-drive-workflow-knowledge-organize-analysis.mdmarkdown12.6 KB
references/lark-drive-workflow-knowledge-organize-discovery.mdmarkdown18.9 KB
references/lark-drive-workflow-knowledge-organize-execution.mdmarkdown9.4 KB
references/lark-drive-workflow-knowledge-organize-planning.mdmarkdown14.2 KB
references/lark-drive-workflow-knowledge-organize-rollback.mdmarkdown10.8 KB
references/lark-drive-workflow-knowledge-organize.mdmarkdown19.8 KB
references/lark-drive-workflow-permission-governance-commands.mdmarkdown6.4 KB
references/lark-drive-workflow-permission-governance-outputs.mdmarkdown27.7 KB
references/lark-drive-workflow-permission-governance.mdmarkdown25.7 KB
references/lark-drive-workflow-topic-move-collector-execute.mdmarkdown13.5 KB
references/lark-drive-workflow-topic-move-collector-recall.mdmarkdown9.3 KB
references/lark-drive-workflow-topic-move-collector-resolve-verify.mdmarkdown13.6 KB
references/lark-drive-workflow-topic-move-collector-review-plan.mdmarkdown12.5 KB
references/lark-drive-workflow-topic-move-collector-setup.mdmarkdown8.3 KB
references/lark-drive-workflow-topic-move-collector.mdmarkdown15.8 KB
references/lark-drive-workflow.mdmarkdown8.3 KB

references/lark-drive-reactions.md

View on GitHub
# drive reactions

> **前置条件:** 先阅读 [`../SKILL.md`](../SKILL.md) 了解 Drive 评论入口,再阅读 [`lark-drive-list-comments.md`](lark-drive-list-comments.md) 了解评论卡片模型、评论数/回复数统计口径、`file_token` / `file_type` 规则;同时阅读 [`../../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。

处理文档评论 / 回复上的 reaction(点赞、表情、各表情数量、谁点了什么、添加/删除表情)。这个场景不常见,但规则比较集中:查询时只有在用户明确需要 reaction 信息时才在 `drive +list-comments` / `+batch-query-comments` / `+list-replies` 上带 `--need-reaction`;写入优先使用 `drive +react-reply`(命令参数细节见 [`lark-drive-react-reply.md`](lark-drive-react-reply.md)),操作对象始终是 `reply_id`。本文是跨切面专题,集中放 reaction 的查询规则、语义联想和完整枚举。

> [!IMPORTANT]
> **`reaction_type` 只能使用本文下方“完整 `reaction_type` 列表”中定义的枚举值。**
> 不要自由填写、不要根据自然语言临时编造、也不要把列表里的 mixed-case 值改写成别的大小写形式。需要写入时,只能从下方枚举中原样选择并传参。

## 何时使用

- 用户明确要求查看评论 / 回复上的 reaction(表情)。
- 用户要统计某条评论卡片有哪些表情、各表情数量,或要看谁点了什么。
- 用户要给评论或回复添加 / 删除 reaction。

## 查询规则

- `drive +list-comments`、`drive +batch-query-comments`、`drive +list-replies` 都支持 `--need-reaction`。
- `--need-reaction` 只在用户明确需要 reaction 信息时再带;如果用户只关心评论正文、回复正文、评论数 / 回复数,默认不要加。
- 遍历评论卡片并顺带拿 reaction:使用 `drive +list-comments --need-reaction`。
- 已知评论 ID,批量查看 reaction:使用 `drive +batch-query-comments --need-reaction`。
- 某张评论卡片下继续翻页拉 reply reaction:使用 `drive +list-replies --need-reaction`,每一页都要持续带。
- 返回形状:`items[].reactions[]` 为 `{reaction_key, count, ahead_users[]}`;**`count=0` 的条目是已删除 reaction 的残留,统计与判断是否存在都要按 `count>0` 过滤**。

## 查询示例

```bash
# 遍历评论卡片,并把 reaction 一起拿回来
lark-cli drive +list-comments --url '<DOC_URL>' --need-reaction

# 已知 comment_id,批量查询评论卡片 reaction
lark-cli drive +batch-query-comments --url '<DOC_URL>' --comment-ids '<COMMENT_ID>' --need-reaction

# 继续翻某张评论卡片下的 replies,并把 reaction 一起拿回来
lark-cli drive +list-replies --url '<DOC_URL>' --comment-id '<COMMENT_ID>' --need-reaction
```

## 写入规则

- 添加 / 删除 reaction 优先使用 `drive +react-reply`;命令参数、目标定位和 dry-run 见 [`lark-drive-react-reply.md`](lark-drive-react-reply.md)。
- 操作对象是 `reply_id`(来自 `drive +list-replies` 的 `items[].reply_id`),不是 `comment_id`。
- 如果用户说要给"这条评论"加 / 删 reaction,取该评论卡片根回复(第一页 `items[0]`)的 `reply_id` 再操作。
- add / delete 幂等:重复添加已有 reaction、删除不存在的 reaction 都会成功返回且无副作用;delete 只取消当前身份自己加的 reaction。
- **服务端不校验 `reaction_type`:任意字符串都会被接受并持久化成一条损坏的 reaction**;`+react-reply --emoji` 会按平台枚举做本地校验兜底,直接调原生命令时必须自行保证取值合法。
- 原生 `drive file.comment.reply.reactions update_reaction` 只在需要 shortcut 未暴露的字段时兜底使用,`--params` 带 `file_token`/`file_type`,`--data` 传 `action=add|delete`、`reply_id`、`reaction_type`。

## 写入示例

```bash
# 给某条 reply 添加一个点赞 reaction
lark-cli drive +react-reply --url '<DOC_URL>' \
  --reply-id '<REPLY_ID>' --emoji THUMBSUP --action add

# 删除某条 reply 上已有的 DONE reaction(wiki URL 自动解包)
lark-cli drive +react-reply --url '<WIKI_URL>' \
  --reply-id '<REPLY_ID>' --emoji DONE --action delete

# 原生命令兜底(注意:原生路径没有本地枚举校验)
lark-cli drive file.comment.reply.reactions update_reaction \
  --params '{"file_token":"<DOC_TOKEN>","file_type":"docx"}' \
  --data '{"action":"add","reply_id":"<REPLY_ID>","reaction_type":"THUMBSUP"}'
```

> [!CAUTION]
> `update_reaction` 是写入操作。执行前必须确认用户意图,不要默认替用户点表情。

## `reaction_type` 使用规则

- `reaction_type` 必须传平台定义的枚举字符串,大小写敏感;`drive +react-reply` 的 `--emoji` 会本地校验(原生命令不校验、服务端也不校验)。
- 不要擅自把 mixed-case 值改成全大写,例如 `Yes`、`No`、`Get`、`EatingFood`、`CheckMark`、`CrossMark` 都要按原值传。
- **不要编造列表外的 `reaction_type`,也不要把自然语言描述臆造成平台未定义的新枚举**。
- 如果用户给的是自然语言语义(如“点赞”“在处理中”“确认一下”),可以在下方枚举列表内选择语义最接近的现有值;如果是近似映射,应在执行时明确告知用户。

## 常见语义联想

- `Yes`:确认 / 同意 / 批准。
- `No`:拒绝 / 不同意 / 否定。
- `DONE`:已完成 / 已处理。
- `Typing`:正在输入 / 正在处理中 / 正在跟进(近似语义)。
- `OK`:好的 / 收到 / 确认一下。
- `THUMBSUP`:点赞 / 认可。
- `LGTM`:看起来没问题 / 可以继续。

## 完整 `reaction_type` 列表

以下枚举按当前 Drive 评论 reaction 指引维护,使用时请保持原样:

```text
ANGRY, APPLAUSE, ATTENTION, AWESOME, BEAR, BEER, BETRAYED, BIGKISS
BLACKFACE, BLUBBER, BLUSH, BOMB, CAKE, CHUCKLE, CLAP, CLEAVER
COMFORT, CRAZY, CRY, CUCUMBER, DETERGENT, DIZZY, DONE, DONNOTGO
DROOL, DROWSY, DULL, DULLSTARE, EATING, EMBARRASSED, ENOUGH, ERROR
EYESCLOSED, FACEPALM, FINGERHEART, FISTBUMP, FOLLOWME, FROWN, GIFT, GLANCE
GOODJOB, HAMMER, HAUGHTY, HEADSET, HEART, HEARTBROKEN, HIGHFIVE, HUG
HUSKY, INNOCENTSMILE, JIAYI, JOYFUL, KISS, LAUGH, LIPS, LOL
LOOKDOWN, LOVE, MONEY, MUSCLE, NOSEPICK, OBSESSED, OK, PARTY
PETRIFIED, POOP, PRAISE, PROUD, PUKE, RAINBOWPUKE, ROSE, SALUTE
SCOWL, SHAKE, SHHH, SHOCKED, SHOWOFF, SHY, SICK, SILENT
SKULL, SLAP, SLEEP, SLIGHT, SMART, SMILE, SMIRK, SMOOCH
SMUG, SOB, SPEECHLESS, SPITBLOOD, STRIVE, SWEAT, TEARS, TEASE
TERROR, THANKS, THINKING, THUMBSUP, TOASTED, TONGUE, TRICK, UPPERLEFT
WAIL, WAVE, WELLDONE, WHAT, WHIMPER, WINK, WITTY, WOW
WRONGED, XBLUSH, YAWN, YEAH, FIREWORKS, BULL, CALF, AWESOMEN
2021, CANDIEDHAWS, REDPACKET, FORTUNE, LUCK, FIRECRACKER, Yes, No
Get, LGTM, Lemon, EatingFood, Hundred, MinusOne, ThumbsDown, Fire
OKR, Drumstick, BubbleTea, Loudspeaker, Pin, Coffee, Alarm, Trophy
Music, Typing, Pepper, CheckMark, CrossMark
```

## 参考

- [lark-drive](../SKILL.md) -- 云空间(云盘/云存储)全部命令
- [lark-drive-react-reply](lark-drive-react-reply.md) -- `+react-reply` 命令参数
- [lark-shared](../../lark-shared/SKILL.md) -- 认证和全局参数
deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall