前言¶
在 DeepSeek Harness（DSH）里，助手回复常用 Markdown 引用块写 > [!NOTE]、> [!WARNING] 这类 GitHub Callouts，强调步骤、风险或补充说明。宿主默认往往把它们渲染成带竖线的普通 blockquote，类型和层级在界面上不够直观。若你已经在 AGENTS.md 或 copilot-instructions.md 里约定「优先用 Callouts 而不是单纯加粗」，界面仍像普通引用，阅读和扫读都会打折扣。
下面介绍社区插件 dsh-gfm-alerts（维护者 NEVSTOP-LAB，SkillHub 分类为「趣味换装」）：在 Web 对话界面里，把符合 GitHub 规则的五种提示块显示成圆角底、左侧色条、图标与本地化标题，浅色/深色主题跟随宿主。会话记录、复制出来的 Markdown 原文不变，只改显示层。
这是什么¶
dsh-gfm-alerts 是 DSH 的客户端 Web 插件（package.json 版本 0.1.0，MIT 许可证）。它不对 Markdown 源做改写，而是在宿主把正文渲染成 DOM 之后，识别 blockquote 首段开头的 [!TYPE]，挂上样式与属性，用注入样式表画出 GitHub 风格的提示框。
需要已安装 dsh CLI，宿主版本不低于 0.2.0-rc.1。插件以当前 dsh 进程权限运行；安装前建议在 GitHub 仓库自行查看源码与许可证。
核心功能¶
资料中已说明的能力如下。
-
五种提示块：
[!NOTE]、[!TIP]、[!IMPORTANT]、[!WARNING]、[!CAUTION]，类型大小写不敏感；写法必须是 blockquote 形式> [!NOTE]，单独一行[!NOTE]按普通文本处理（与 GitHub 规则一致）。 -
标题本地化：界面语言为中文时显示「注意」「提示」等；中英词典随插件注册。
-
主题自适应：颜色使用
--dsw-alias-*主题 token，切换浅色/深色无需重启插件。 -
流式与重渲染：流式输出过程中同样生效；宿主重新渲染并把字面标记写回 DOM 时，会再次处理。
-
只改显示：导出的会话、事件流、复制全文仍是原始 Markdown；样式仅存在于界面。
| 写法 | 显示（资料描述） |
|---|---|
> [!NOTE] |
蓝色「注意」框 |
> [!TIP] |
绿色「提示」框 |
> [!IMPORTANT] |
紫色「重要」框 |
> [!WARNING] |
琥珀色「警告」框 |
> [!CAUTION] |
红色「危险」框 |
README 还建议在 AI 参考规范文档中写明：Markdown 里倾向于用 GitHub Callouts 强调信息，配合本插件，界面更清晰。
安装与启用¶
先做环境确认：本机有 dsh CLI，且 profile 与使用场景一致（Web 默认 --profile web；DSH Desktop 用 --profile desktop）。
从 GitHub 仓库安装：
dsh plugin --profile web add github:NEVSTOP-LAB/dsh-gfm-alerts
若希望锁定某次提交，避免后续默认分支更新改变行为：
dsh plugin --profile web add github:NEVSTOP-LAB/dsh-gfm-alerts#<commit-sha>
也可从 Releases 下载 tarball 后本地安装，例如：
dsh plugin --profile web add ./dsh-gfm-alerts-0.1.0.tgz
安装后检查组合层是否包含该插件：
dsh --profile web --dump-config
重启 DSH 并刷新页面后生效：带提示块的回复应显示为圆角提示框，而不是普通引用块。
卸载：
dsh plugin --profile web remove dsh-gfm-alerts
典型用法¶
在助手回复（或你粘贴进对话的 Markdown）里使用 GitHub 标准 blockquote Callout，例如：
> [!IMPORTANT]
> 生产环境变更前先在 staging 验证回滚路径。
> [!WARNING]
> 该命令会删除未跟踪文件，执行前确认工作区状态。
经过上面的步骤安装并刷新后，Web 界面里上述块会分别呈现为紫色「重要」与琥珀色「警告」样式框；复制同一段 Markdown 到别处，仍是 > [!IMPORTANT] 原文。
适用场景与注意¶
适合谁：经常在 DSH Web（及由 Web 渲染的对话界面，含 Desktop 内嵌页）里阅读带 Callouts 的助手回复；已在规范里鼓励模型输出 > [!NOTE] 等写法，希望视觉与 GitHub 文档一致。
已知限制（以 README 为准）：
- 只认
> [!TYPE]的 blockquote 形式。 - 识别依赖渲染后的
blockquote > p结构；宿主若改 Markdown DOM 结构，最坏情况是退化成普通引用块，不会报错。 - 纯终端（headless / ACP）没有这条 Web 渲染路径，插件不在该路径生效。
DSH 生态强调「一切皆插件」；SkillHub 目录页 是社区索引，与 DeepSeek / 幻方无官方从属关系。仓库当前 GitHub 星标为 1（以目录页/仓库公开信息为准）。
结尾¶
dsh-gfm-alerts 用增量 DOM 装饰把五种 GitHub Callouts 画成可读性更好的提示框，且不污染 Markdown 源。需要安装命令、Release 包与设计细节时，以仓库 README 为准。
- 目录页：https://www.skillhub.cn/plugins/NEVSTOP-LAB/dsh-gfm-alerts
- GitHub：https://github.com/NEVSTOP-LAB/dsh-gfm-alerts
