99 lines
2.7 KiB
Markdown
99 lines
2.7 KiB
Markdown
# mail +signature
|
||
|
||
> **前置条件：** 先阅读 [`../../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
|
||
|
||
查看邮箱签名列表或详情。返回签名的类型、默认使用情况、内容预览等信息。TENANT（企业）签名的模板变量会被自动替换为实际值。
|
||
|
||
本 skill 对应 shortcut：`lark-cli mail +signature`。
|
||
|
||
## 命令
|
||
|
||
```bash
|
||
# 列出所有签名
|
||
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，查看详情。省略则列出所有签名 |
|
||
|
||
## 返回值
|
||
|
||
**列表模式：**
|
||
|
||
```json
|
||
{
|
||
"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`）：**
|
||
|
||
```json
|
||
{
|
||
"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 后，可在发送/回复/转发时附加签名：
|
||
|
||
```bash
|
||
# 查看签名列表获取 ID
|
||
lark-cli mail +signature
|
||
|
||
# 在发送邮件时附加签名
|
||
lark-cli mail +send --to alice@example.com --subject '你好' --body '<p>内容</p>' --signature-id <签名ID>
|
||
```
|