lark-mail-signature.md 2.7 KB

mail +signature

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

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

本 skill 对应 shortcut:lark-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>