前言¶
在 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 節點。
