飞书文档评论技能

管理飞书云文档的评论，包括列出评论和添加新评论。

使用方法

/feishu-comment list <file_token> --type docx                    # 列出云文档评论
/feishu-comment add <file_token> --type docx --text "评论"       # 添加评论
/feishu-comment delete <file_token> <comment_id> --type docx     # 删除评论

注意：--type 参数为必需，指定文件类型（docx/sheet/bitable）。

CLI 命令详解

1. 列出文档评论

# 列出云文档的评论
feishu-cli comment list <file_token> --type docx

# 列出电子表格的评论
feishu-cli comment list <file_token> --type sheet

# 指定用户类型（获取评论者信息）
feishu-cli comment list <file_token> --type docx --user-id-type open_id

参数说明：

参数	说明	必需	默认值
file_token	文件 Token	是	-
--type	文件类型（docx/sheet/bitable）	是	-
--user-id-type	用户 ID 类型	否	open_id

输出示例：

文档评论列表（file_token: doccnXxx）:

评论 #1
  ID: 7123456789012345678
  内容: 这个方案很好，建议增加性能测试数据
  作者: ou_xxx (张三)
  时间: 2024-01-21 14:30:25
  状态: 未解决
  回复数: 2

评论 #2
  ID: 7123456789012345679
  内容: 文档结构清晰，LGTM
  作者: ou_yyy (李四)
  时间: 2024-01-21 10:15:00
  状态: 已解决
  回复数: 0

共 2 条评论

2. 添加评论

# 添加全文评论（不关联特定内容）
feishu-cli comment add <file_token> --type docx --text "这是一条评论"

# 添加包含 @ 的评论
feishu-cli comment add <file_token> --type docx --text "请 @张三 review 一下"

参数说明：

参数	说明	必需
file_token	文件 Token	是
--type	文件类型	是
--text	评论内容	是

输出示例：

评论添加成功！
  评论 ID: 7123456789012345680
  文件: doccnXxx
  内容: 这是一条评论

支持的文件类型

--type 参数	说明
docx	新版云文档
doc	旧版云文档
sheet	电子表格
bitable	多维表格

3. 删除评论

# 删除指定评论
feishu-cli comment delete <file_token> <comment_id> --type docx

参数说明：

参数	说明	必需
file_token	文件 Token	是
comment_id	评论 ID	是
--type	文件类型（docx/sheet/bitable）	是

输出示例：

评论删除成功！
  评论 ID: 7123456789012345678
  文件: doccnXxx

典型工作流

代码审查流程

# 1. 读取文档内容
feishu-cli doc export doccnXxx -o /tmp/doc.md

# 2. 查看现有评论
feishu-cli comment list doccnXxx --type docx

# 3. 添加审查意见
feishu-cli comment add doccnXxx --type docx --text "第三章的流程图需要更新"

批量查看评论

# 列出多个文档的评论
for token in doccnXxx doccnYyy doccnZzz; do
  echo "=== 文档: $token ==="
  feishu-cli comment list $token --type docx
done

权限要求

• drive:drive.comment:readonly - 读取评论
• drive:drive.comment:write - 添加评论

注意事项

1. 评论位置：当前 CLI 仅支持全文评论，不支持关联特定文字/段落的评论
2. @ 功能：在评论中使用 @用户名 需要用户有文档访问权限
3. 评论状态：评论状态（已解决/未解决）需通过飞书客户端修改
4. 删除评论：删除操作不可逆，删除前请确认评论 ID