# 由壹点通知消息规范

统一机器人已经说明“由壹点发出的”，每条消息不再重复品牌名。项目名称解决“消息来自哪里”，业务标题、时间和首屏内容解决“发生了什么、用户现在要做什么”。所有接入项目必须遵守本规范。

## 1. 标题规则

最终标题由通知中心统一拼接：

```text
【项目名称】业务标题
```

例如：

- `【固定资产】资产报废待审批`
- `【素材库】新的考核调研待填写`
- `【产品开发】任务即将到期`

业务项目只提交业务标题，例如：

- `新的考核调研待填写`
- `资产报废待审批`
- `产品任务即将到期`

通知中心根据 `projectCode` 生成 `【项目名称】`，业务项目不能自行拼接。禁止：

- 自己添加 `【项目名称】`、机器人名称或其它来源前缀。
- 使用“通知”“消息提醒”“统一消息测试”等无法表达任务的空泛标题。
- 在标题中堆积人员、日期、编号等详细字段。
- 使用多个 emoji 或连续感叹号制造紧迫感。

## 2. 内容结构

通知中心会把卡片正文首行统一生成为：

```markdown
### 【项目名称】业务标题
```

业务项目不要再提交自己的 Markdown 首行标题。为兼容旧项目，通知中心只会移除正文开头已有的三级 Markdown 标题（`###`），再生成统一首行；其它级别标题按正文原样保留。

消息第一屏按以下顺序组织：

1. 项目名称和业务主题，由通知中心统一生成。
2. 申请时间、处理时间或截止时间。
3. 最重要的业务对象和相关人员。
4. 原因、结果或异常说明。
5. 一句必要的行动提示。

业务项目推荐提交：

```markdown
**截止时间：** 2026年7月31日 18:00

**调研：** 2026年7月 · 跨部门协同

**评价对象：** 无邪

> 请在截止时间前完成评分。
```

通知中心最终渲染为：

```markdown
### 【素材库】新的考核调研待填写

**截止时间：** 2026年7月31日 18:00

**调研：** 2026年7月 · 跨部门协同

**评价对象：** 无邪

> 请在截止时间前完成评分。
```

每个字段之间必须保留一个空行。不要只使用单换行；钉钉会把连续字段合并成一段，明显降低阅读性。

不要写成一整段：

```text
你有一份新的考核调研需要填写。调研：2026年7月……对象……截止……
```

## 3. 状态用语

优先使用用户可以立即理解的动作词：

| 场景 | 推荐状态 |
| --- | --- |
| 需要填写 | `待你填写` |
| 需要审批 | `待你审批` |
| 任务完成 | `处理完成` |
| 操作失败 | `处理失败` |
| 即将到期 | `即将到期` |
| 仅告知 | `结果已更新` |

不要使用仅开发人员能理解的内部状态码，例如 `pending`、`processed`、`job failed`。

## 4. 按钮规则

按钮必须描述点击后的动作：

- `立即填写`
- `立即审批`
- `查看结果`
- `查看任务`
- `处理异常`

避免使用没有方向的“点击这里”“打开系统”“查看详情”，除非确实无法给出更具体的动作。

每条通知只保留一个主要按钮。通知不是业务页面，不在消息中堆叠多个操作入口。

## 5. 信息取舍

消息中只放帮助用户判断和行动的信息：

- 保留：业务对象、发起人、截止时间、核心结果、失败原因。
- 省略：数据库 ID、内部状态码、部署版本、调试说明、完整操作日志。
- 禁止：项目密钥、访问令牌、身份证号、完整手机号、敏感人事信息和无需展示的内部备注。

如果内容较长，消息只展示摘要，完整信息通过白名单内的业务页面查看。

## 6. 时间和名称

- 面向中国员工统一使用北京时间。
- 用户可见时间推荐 `2026年7月31日 18:00`，不要显示秒和时区偏移。
- 人员名称使用公司花名或业务系统已确认的展示名；投递对象使用钉钉 `userId`，或当前项目已由通知中心登记的准确花名。
- 不在消息里用邮箱、手机号或内部 ID 代替人员名称。

## 7. 示例

### 考核调研

```text
标题：新的考核调研待填写
内容：
**截止时间：** 2026年7月31日 18:00

**调研：** 2026年7月 · 工作配合度

**评价对象：** 无邪

> 请在截止时间前完成评分。

按钮：立即填写
```

最终显示标题：`【素材库】新的考核调研待填写`

最终卡片首行：`### 【素材库】新的考核调研待填写`

### 固定资产

```text
标题：资产报废待审批
内容：
**申请时间：** 2026年7月16日 14:30

**资产：** 摄影灯 A-102

**申请人：** 无邪

**报废原因：** 设备损坏，无法继续维修

> 请核对资产及配件明细后处理。

按钮：立即审批
```

最终显示标题：`【固定资产】资产报废待审批`

最终卡片首行：`### 【固定资产】资产报废待审批`