yangwhale 聊天平台消息风格指南
通过聊天平台（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：
- 写 HTML 到
$CC_PAGES_WEB_ROOT/pages/{topic}-{YYYYMMDD-HHmmss}.html（公开发给客户走assets/子目录） - 用
~/CloseCrab/scripts/publish-cc-page.sh <html-path> [--to pages|assets|both]上传 + 自动验证 URL - 发送链接
$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 飞书会自动识别成可点击链接，无需任何修饰。
进度更新
长任务中主动汇报，但不要刷屏：
- 开始时：一句话说清在做什么
- 关键节点：完成了什么 / 遇到问题
- 结束时：结果 + 变更摘要