前言¶
在 DeepSeek Harness（DSH）裏寫長文、改表格、和模型一起維護一份「活文檔」時，常見做法是：要麼在對話裏堆 Markdown 源碼，要麼切到外部編輯器再粘貼。對話上下文會變長，排版也和 DSH 主界面不一致。下面介紹維護者 zhxnix 的客戶端插件 dsh-madedown：在 DSH 右側欄提供所見即所得（WYSIWYG）的 Markdown 筆記編輯，並與主對話雙向聯動；設計靈感來自 macOS 原生編輯器 Madedown。
這是什麼¶
dsh-madedown 是 DSH 的 web 客戶端插件（分類：客戶端）。打開後右側欄會出現 Madedown 編輯標籤頁：默認直接編輯渲染後的 Markdown（標題即標題、表格可改單元格），支持多標籤、本地圖片、保存到本地文件，以及模型通過 madedown 工具讀寫文檔。文檔與圖片保存在本機 Host 目錄，插件本身不發起外部網絡請求。
- 目錄頁：skillhub.cn/plugins/zhxnix/dsh-madedown
- 源碼與說明：github.com/zhxnix/dsh-madedown
- 當前 package 版本：0.6.3，許可證 MIT
核心功能¶
編輯與排版¶
- 所見即所得 / 源碼模式：工具欄最右側圖標切換，實時渲染 Markdown。
- 與對話渲染一致：使用對話 Markdown 的同一套排版 token（字體、字號、行高、標題、列表、引用、代碼、表格）。
- Markdown 快捷輸入：行首
#、-、1.、>、代碼圍欄等自動變塊；行首/打開格式菜單。 - 列表 / 任務列表：回車續寫、
Tab縮進、任務複選框可直接勾選。 - 目錄：編輯區右上方半透明目錄，懸停展開、移開收起，點擊把手可固定。
多標籤與本地狀態¶
- 多標籤頁：新建、關閉、雙擊改名、拖動換位；標籤過多時右側溢出菜單；順序與激活項持久化。關閉有內容的標籤會提示，可選「保存到本地」或「確定關閉」。
- 本地保存狀態：標籤綠/紅狀態點；狀態欄顯示當前文檔本地保存狀態，點擊可查看並複製保存路徑。
- 保存到本地文件：下載按鈕或
⌘S彈出系統原生保存對話框（macOS），默認文件名<標題>.md、默認位置「文稿」。
表格、代碼塊與圖片¶
- 表格：進入表格時浮出工具條，可插刪行/列或整表；
Tab在末格自動新增一行。 - 代碼塊：語言標識、自動換行、複製橫幅；
⌘/Ctrl+Enter、Esc、末尾↓或點擊塊下方空白可退出。 - 圖片：選擇或粘貼會上傳到 Host 本地資源目錄；從對話選區發送的圖片也會轉存爲本地資源。
與主對話聯動¶
- 模型可通過
madedown工具讀取和修改右側文檔；右側修改會自動進入對話上下文。 - 對話選區可一鍵發送到編輯器；編輯器選區可插入對話（只插入、不發送）。
- 編輯器選區支持「快速提問」，直接在對話中向模型提問；支持 Madedown 引用 chip，點擊可編輯發送給模型的內容。
關於與更新¶
關於彈窗可查看圖標、版本、作者、更新說明與倉庫地址，並檢查更新；有新版本時狀態欄有小字提示。
安裝與啓用¶
插件以當前 DSH 進程權限運行，安裝前建議瀏覽源碼與 MIT 許可證。
從 GitHub（當前可用）¶
dsh plugin --profile web add github:zhxnix/dsh-madedown
從 npm¶
npm 包發佈後可使用（目前尚未發佈）：
dsh plugin --profile web add dsh-madedown@latest
本地開發安裝¶
在 DSH 中執行（需 pnpm，可通過 corepack enable pnpm 提供）：
plugin_manager install_bundle target=/path/to/madedown-dsh
安裝後客戶端模塊通常經 client HMR 自動載入；若未出現，刷新 DSH 頁面。
典型用法¶
- 點擊右側欄 Madedown 入口、對話標題欄 Madedown 圖標，或讓模型執行
madedown的open動作。 - 在渲染後的文檔裏直接編輯，或使用工具欄與快捷鍵。
- 多篇筆記用頂部標籤管理，可拖動排序、雙擊改名。
⌘S保存到本地文件；標籤與文檔會自動持久化到 Host。
常用快捷鍵示例：
| 快捷鍵 | 作用 |
|---|---|
⌘B / ⌘I / ⇧⌘X / ⌘E |
粗體 / 斜體 / 刪除線 / 行內代碼 |
⌘K |
插入鏈接 |
⌘S |
保存到本地文件 |
Tab / ⇧Tab |
列表縮進 / 反縮進；表格內切換單元格 |
數據、隱私與模型工具¶
本地數據路徑¶
- 文檔：
$DSH_HOME/madedown-dsh/documents.json（默認~/.dsh/madedown-dsh/documents.json；可用環境變量MADEDOWN_DSH_HOME覆蓋目錄）。 - 圖片：
$DSH_HOME/madedown-dsh/assets/，經本機 Host 路由提供，不上傳外部服務。 - 引用與編輯狀態保存在瀏覽器
localStorage與本地 Host 數據中。
madedown 工具¶
參數 action，可選 document 指定標籤 id 或標題（默認當前標籤）：
| action | 作用 |
|---|---|
read |
讀取全文、標題、版本、統計與標籤列表 |
write |
整篇重寫（text，可選 title） |
append |
末尾追加 text |
replace |
字面量查找替換（find / replaceWith / all） |
list |
列出所有標籤與當前激活標籤 |
select |
切換激活標籤（document 必填） |
create |
新建標籤（可選 title / 初始 text） |
open |
在右側欄打開/顯示編輯器 |
Host 還會註冊系統提示，列出標籤並內聯當前標籤內容（過長會截斷並提示用工具讀取全文）。
適用場景與注意¶
適合：需要在 DSH 內長期維護 Markdown 筆記、表格與代碼片段，並希望模型能程序化讀寫同一份文檔的開發者或智能體使用者。
注意：
- 保存對話框描述針對 macOS 原生對話框；其他平臺行爲以實際 DSH 環境爲準。
- DSH 生態強調「一切皆插件」；skillhub.cn 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
- 安裝與運行等同於信任插件源碼；Node 引擎要求
>=20（見 package.json）。
結尾¶
dsh-madedown 把 WYSIWYG Markdown 筆記放進 DSH 右側欄，並與對話和 madedown 工具打通，適合「人機共編一份本地文檔」的工作流。安裝命令見上文 GitHub 方式；細節與更新以倉庫 README 爲準。
