聊天平台消息风格指南

通过聊天平台（Discord、飞书等）与用户交互时，遵循以下规则让消息正确显示且易读。

核心原则

聊天平台不是文档。简短、直接、对话式。

格式规则

可以用

• 粗体 强调重点
• 代码 标记技术术语
• 代码块 贴代码（带语言标记）
• 无序列表 - 和有序列表 1.
• > 引用 引用内容
• ||剧透|| 隐藏长输出（Discord 特有）

不要用

• 嵌套列表 — 大部分聊天平台不支持缩进列表
• 图片 ![]() — 不渲染，用文件附件替代
• 脚注 [^1] — 不支持

表格

• 飞书：可以直接用 markdown 表格语法 | col |，bot 会自动转换为 column_set 原生表格（灰白交替行）
• Discord：不支持表格，改用代码块对齐或列表格式

飞书表格注意事项：

• 表格单元格内的反引号 ` 会被自动去除（column_set 内不支持行内代码）
• 第一个 # 标题会变成卡片彩色 header（indigo），不要在表格前重复写标题
• --- 分隔线会变成卡片原生 hr 元素

Discord 表格替代方案 — 代码块对齐（用英文/ASCII 避免双宽字符错位）：

Model   VRAM         FP16         FP8
A100    80GB HBM2e   312 TFLOPS   N/A
H100    80GB HBM3    989 TFLOPS   1979 TFLOPS
B200    192GB HBM3e  2250 TFLOPS  4500 TFLOPS

Discord 列表格式（适合少量字段或中文标签）：

A100 SXM

• VRAM: 80GB HBM2e
• FP16: 312 TFLOPS

H100 SXM

• VRAM: 80GB HBM3
• FP16: 989 TFLOPS

消息长度

• 聊天消息保持简短，长回复拆分成多条
• 在自然断点（换行、段落）处切分
• 优先发核心结论，细节按需展开

写作风格

• 短句为主，1-3 句话说清一件事
• 不要 "我很高兴为您..." 之类的废话
• 中文为主，技术术语保留英文
• 匹配对话的语气和节奏
• 结论先行，不要铺垫

代码输出

• 短代码（<10行）直接贴代码块
• 长代码建议用户看文件
• 错误信息只贴关键行，不要整段 stack trace

富内容页面

复杂内容（大表格、图表、报告）不适合聊天消息时，生成 HTML 页面到 CC Pages：

1. 写 HTML 到 $CC_PAGES_WEB_ROOT/pages/{topic}-{YYYYMMDD-HHmmss}.html（公开发给客户走 assets/ 子目录）
2. 用 ~/CloseCrab/scripts/publish-cc-page.sh <html-path> [--to pages|assets|both] 上传 + 自动验证 URL
3. 发送链接 $CC_PAGES_URL_PREFIX/pages/{filename} 或 $CC_PAGES_URL_PREFIX/assets/{filename}

链接格式（强制）

发链接时一律裸发 URL，前后不加任何包裹符号——不加单引号 '、双引号 "、反引号 `、markdown 代码标记、尖括号 <>、方括号 []()。

• ✅ 正确：https://cc.higcp.com/wiki-v2/
• ❌ 错误：'https://cc.higcp.com/wiki-v2/'、`https://...`、[wiki](https://...)

原因：飞书会把引号/反引号当成 URL 的一部分一起渲染进可点击区域，用户点击得到带引号的 URL → 404 打不开。裸 URL 飞书会自动识别成可点击链接，无需任何修饰。

进度更新

长任务中主动汇报，但不要刷屏：

• 开始时：一句话说清在做什么
• 关键节点：完成了什么 / 遇到问题
• 结束时：结果 + 变更摘要