前言¶
在 DeepSeek Harness (DSH) 中，助手输出的 Markdown 引用块通常只以普通文本显示。当需要区分提示、警告或重要信息时，这种视觉区分度不足。dsh-callout 插件在 DSH Web UI 渲染时，将特定的 Markdown 警告标记（如 > [!NOTE]）转换为语义化的提示卡片，无需修改存储的会话内容。
核心功能¶
该插件处理 DSH 助手生成的 Markdown 内容，将标准化的警告标记转换为视觉上符合 GitHub 风格的卡片。
-
支持的类型
- NOTE（蓝色）：用于前提、环境事实和边界。
- TIP（绿色）：用于更优或较不明显的方法。
- IMPORTANT（紫色）：用于决策或关键结论。
- WARNING（琥珀色）：用于潜在损失或破坏性操作。
- CAUTION（红色）：用于高影响或难以恢复的操作。 -
主题感知
卡片样式会跟随 DSH 的 light/dark 模式切换。 -
源格式保留
仅在浏览器端进行样式转换，不修改存储的会话内容或 DSH 核心渲染器。 -
元素兼容
支持在卡片内嵌套代码、链接、列表、嵌套引用等多种 Markdown 元素。 -
编辑回退
支持真实编辑移除卡片样式并恢复源标记，dsh.plugin观察者回声路径确保幂等性。
安装与启用¶
在终端中执行以下命令进行安装：
dsh plugin --profile web add github:Aafff623/dsh-callout
安装完成后，需要硬刷新 Web UI 以加载新插件：
- Windows / Linux:
Ctrl + Shift + R - macOS:
Cmd + Shift + R
用法示例¶
插件支持两种标记形式：单行或多行。标记必须是块引用的第一行内容。
> [!WARNING]
> This operation may overwrite existing configuration.
> [!NOTE] Body text on the same line.
> [!NOTE]
> Body text on the next line.
注意事项¶
-
作用范围
仅处理 assistant Markdown，不处理 human messages。 -
格式要求
- 格式错误的标记会以普通文本显示。
- 不保证源级别对反斜杠转义标记的区分。 -
依赖版本
依赖 DSH 版本 >= 0.1.2-rc.1。使用当前 DSH Web DOM 合约，未来渲染器变更需重新测试。 -
非解析器替代品
插件不是 Markdown 解析器替代品，不添加新的 Markdown AST 节点。
