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