dsh-chat-figure
DSH 聊天内原生图解与练习 / native in-chat diagrams and quizzes for DeepSeek Harness：把 ```figure / ```tree / ```quiz 代码块渲染成随主题自适应的 HTML，不用图片也不用 Mermaid
The plugin will be installed here. Keep web if you are unsure.
npx -y @deepseek-ai/dsh plugin --profile web add github:Wh1stle05/dsh-chat-figure#ff5cc8eae6b15e264f98b613268a8669fb039515
Chat Figure is published as dsh-chat-figure and currently resolves to version 0.2.0. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.
简体中文 | English
在 DSH 对话里画示意图、层级树和选择题。三种代码块会被渲染成真实 HTML：文字是真文字，可选中、可缩放、跟随明暗主题，选择题可以直接点着作答。零依赖，不联网，不调用模型。
| 块 | 用途 | 产出 |
|---|---|---|
%%figure | 流程、结构、对比 | 盒子、箭头、注释、标签、图注 |
%%tree | 进程树、目录树、调用层级 | 缩进即层级，父节点加粗、叶子变淡 |
%%quiz | 随堂测验 | 单选、提交判分、解析、进度、成绩页 |
| 流程结构图 | 层级树 |
|---|---|
| 结构图 | 进程树 |
| 选择题（一次一题） | 答完立即判分 |
|---|---|
| 选择题 | 判分 |
块的第一行是哨兵，决定渲染成什么；围栏语言写什么都行。
%%figure```figure
%%figure
title: fork() 之后：一分为二
sub: 父子各有独立 PID，内存先共享同一批物理页
arrow: fork()
row
box gray: 父进程 Bash | PID 1000 · fork() 返回 1001
box blue: 子进程 Bash（副本） | PID 1001 · fork() 返回 0
note: 返回值不同，同一份代码因此走向不同分支
pills: Copy-on-Write, PID, 地址空间
foot: 复制的是“进程状态”，不是磁盘上的程序。
```
| 行 | 含义 |
|---|---|
title: / sub: | 居中标题 / 灰色副标题 |
arrow: 标签 或 arrow | 竖向箭头，标签可省略 |
row | 开始一行并列盒子，后续 box 归入该行 |
box [gray|blue|green|amber|plain] [wide]: 标题 | 副标题 | 盒子；wide 强制整行 |
note: / pills: / foot: / gap | 居中注释 / 胶囊标签 / 底部图注 / 空隙 |
%%tree```tree
%%tree
systemd (PID 1)
uvicorn.service | PID 1000
Worker 1 | PID 1001
Worker 2 | PID 1002
```
缩进两格一层；标题 | 备注 的备注以灰色小字跟在后面。
%%quiz```quiz
%%quiz
tag: Linux 小测验
q: Linux 中，kill -9 发送的是什么信号？
A. SIGTERM (15)
B. SIGKILL (9)
C. SIGSTOP (19)
D. SIGINT (2)
answer: B
why: -9 就是 SIGKILL，内核直接终止，既不能捕获也不能忽略。
```
第 n / N 题 + 进度条；mode: list 改为一次显示整卷。| 关键字 | 含义 |
|---|---|
q: / 问题: | 开始一道新题 |
A. ~ H. | 选项 |
answer: / 答案: | 正确项 |
why: / 解析: | 判分后展示的解释 |
tag: / title: | 卡片顶部标签 / 标题 |
%%figure / %%tree / %%quiz 决定用哪个渲染器；# 注释忽略，流式输出中未闭合的块按已有内容先渲染；currentColor 派生，深浅主题共用一套规则；内容变化时原地替换旧节点；localStorage，键是块内容的哈希，刷新和重渲染都能恢复；MutationObserver 监听会话 DOM，出现新代码块就处理一次。# 1. 链进 profile
ln -s /path/to/dsh-chat-figure ~/.dsh/profiles/web/node_modules/dsh-chat-figure
# 2. 在 profile 的 patch 层追加一行
cat >> ~/.dsh/profiles/web/cordis.patch.yml <<'YAML'
- insert:
- id: chat-figure
name: 'dsh-chat-figure'
YAML
刷新页面即生效，无需重启 dsh web。
color-mix()（Chrome 111+ / Safari 16.2+ / Firefox 113+）；