PicoBot/.agents/skills/lark-mail/references/lark-mail-signature.md
ooodc a7883dbed9 refactor(todo): 重构待办事项管理逻辑及更新状态规则
- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段
- 强制每个任务都必须有唯一 id,且由用户负责生成
- 修改合并模式逻辑,merge=true 下保留未提及的旧任务
- 支持已完成和已取消任务重新激活(状态改回 pending 或 in_progress)
- 禁止 in_progress 状态退回到 pending,必须标记为 completed 或 cancelled
- 优化状态转换校验,允许特定状态间合法切换
- 简化任务变更消息,移除详细的新增/更新/移除统计
- 更新文档和示例,明确 id 必须由用户生成和使用
- 修复和补充测试,增强状态转换和合并模式验证
- 调整任务时间戳生成逻辑,统一使用当前时间及索引
- 该变更提供更合理的任务状态机械及管理模式,提升稳定性和易用性
2026-06-13 09:22:33 +08:00

2.7 KiB
Raw Blame History

mail +signature

前置条件: 先阅读 ../../lark-shared/SKILL.md 了解认证、全局参数和安全规则。

查看邮箱签名列表或详情。返回签名的类型、默认使用情况、内容预览等信息。TENANT企业签名的模板变量会被自动替换为实际值。

本 skill 对应 shortcutlark-cli mail +signature

命令

# 列出所有签名
lark-cli mail +signature

# 查看某个签名的详情(渲染后的内容预览、模板变量值、图片信息)
lark-cli mail +signature --detail <signature_id>

# 指定邮箱
lark-cli mail +signature --from shared@example.com

参数

参数 必填 说明
--from <email> 邮箱地址(默认 me
--detail <id> 签名 ID查看详情。省略则列出所有签名

返回值

列表模式:

{
  "ok": true,
  "data": {
    "signatures": [
      {
        "id": "<签名ID>",
        "name": "个人签名",
        "type": "USER",
        "content_preview": "这是我的签名内容 [image] 超链接哈哈"
      },
      {
        "id": "<签名ID>",
        "name": "企业签名",
        "type": "TENANT",
        "is_send_default": true,
        "is_reply_default": true,
        "content_preview": "企业签名 姓名:陈煌 部门:研发团队"
      }
    ]
  }
}

详情模式(--detail

{
  "ok": true,
  "data": {
    "id": "<签名ID>",
    "name": "企业签名",
    "type": "TENANT",
    "is_send_default": true,
    "is_reply_default": true,
    "images": [
      {"cid": "76CEB29E-...", "file_key": "121011...", "image_name": "image.png"}
    ],
    "template_vars": {"B-NAME": "陈煌", "B-DEPARTMENT": "研发团队"},
    "content_preview": "企业签名 姓名:陈煌 部门:研发团队"
  }
}

字段说明

字段 说明
type USER(用户签名,可编辑)或 TENANT(企业签名,管理员模板控制)
is_send_default 是否为新邮件的默认签名
is_reply_default 是否为回复/转发的默认签名
images 签名内联图片元数据(仅详情模式)
template_vars TENANT 签名的模板变量已替换值(仅详情模式)
content_preview 签名内容的纯文本预览(<img> 显示为 [image],最长 200 字符)

与 compose shortcut 配合

获取签名 ID 后,可在发送/回复/转发时附加签名:

# 查看签名列表获取 ID
lark-cli mail +signature

# 在发送邮件时附加签名
lark-cli mail +send --to alice@example.com --subject '你好' --body '<p>内容</p>' --signature-id <签名ID>