排版卡片 ninepoin4/dsh-rich-cards

让 DeepSeek Harness 的回答排版变得更好：标题、导语、要点、数据、时间线、配图。

它长这样

card 布局：公式、定义、对比 article 布局：长文、时间线、来源

article + 真实配图：写卡前先查一张图，代码块的抬头和灰框会被隐藏

安装

dsh plugin --profile <你的 profile> add link:/path/to/dsh-rich-cards

装完刷新窗口即可，卡片渲染在回答末尾，不用重启会话。

用法

模型会自己在合适的回答末尾写一个 card 围栏块：

card
{
"title": "一句话答案", "kicker": "分类 · 主题", "lead": "导语", "accent": "indigo",
"blocks": [
{"type": "paragraph", "text": "正文"} ] }

也可以自己手写——渲染器只认 card 这个 info string，正文必须是合法 JSON。

配图也是这个约定的一部分：讲人物、地点、作品时先查一张真图（Windows 上用 curl 走维基图库接口），查到就配上 url + 说明 + 来源；两三次查不到就安静地不配图，不在正文里交代「接口被拦」「没找到配图」——缺图不是新闻。

| 块类型 | 作用 |
| heading paragraph | 小节标题、正文段落 |
| bullets steps chips | 要点、步骤、标签 |
| stats | 2–4 个关键数字 |
| kv | 左右对照的键值行 |
| callout quote | 提示框（info / tip / warn）、引用 |
| timeline | 带年份的事件线 |
| image | 真实 URL + 说明 + 来源 |
| divider | 分隔线 |

顶层还有 layout: "card" | "article"（article 去掉卡片外壳，按文章排版）、sources（底部来源标签）、footer。

原理

- 宿主端：往系统提示里加一段写作约定，教模型用围栏块收尾，不注册任何工具。
- 浏览器端：MutationObserver 扫描回答里的代码块，正文能解析成卡片就隐藏代码、在原位挂一张卡；解析失败就原样留着。

失败即降级（fail open）：卡片写坏最多显示成一段代码，永远不会中断整轮回答——这也是它不用工具调用传参的原因。

更长的版本（为什么这么设计、两条通道的取舍、拆壳的细节）在 docs/intro.md。

已知边界

- 一张回答只渲染一张卡（最后一张生效）；
- 卡片位置固定在回答末尾，不能插到段落中间；
- 解析靠 DOM 匹配，主题改动代码块结构时可能失效。

License

MIT