前言¶
在 DeepSeek Harness（DSH）裏，智能體經常把說明、方案、長文寫成工作區裏的 .md 文件；右側欄默認是 Markdown 預覽，能看不能改時，改一個字往往要切編輯器或讓智能體再跑一輪。若你還想對某段寫「這裏要補例子」「這句不對」，批註和正文分散在不同工具裏，來回對照成本更高。
dsh-quirekit-md-editor 把右側預覽換成可編輯界面：打開的就是當前文件，改完寫回同一路徑；批註可以掛在段落旁，再一次性交給智能體處理。下面按定位、能力、安裝與用法說明這個工作流類插件。
這是什麼¶
- 名稱：
dsh-quirekit-md-editor（npm 包名與安裝標識一致） - 維護者：quirekit
- 分類：工作流（社區目錄 SkillHub 插件頁）
- 一句話：Edit Markdown where the agent writes it, and hand your comments back to the agent.——在智能體寫入 Markdown 的位置編輯，並把你的評論交還給智能體。
- 編輯器本體：QuireKit MD Editor，與插件一併構建；底層是優化過的 CodeMirror 與 Lezer。
- 許可證：MIT（
package.json當前版本 0.1.2）
與「只換預覽皮膚」類插件不同，README 強調它面向「智能體已經寫完文檔之後」：你閱讀、修改，並用評論說明還要智能體改什麼。
核心功能¶
編輯與文件保真¶
- 三種模式（每個標籤頁會記住上次選擇）：Visual 隱藏標記、Markup 在當前段落顯示標記、Source 顯示全部源碼；仍是同一份純文本，不是從文檔樹反推再生成文件。
- 就地渲染：數學公式、Mermaid、PlantUML、表格、腳註、frontmatter；可插入白板、流程圖、思維導圖，數據寫在 Markdown 裏。
- 保存：輸入時自動保存，或
Cmd/Ctrl+S。 - 粘貼圖片：保存到文檔旁的
assets/，用相對路徑引用。 - 主題：跟隨 DSH 的語言與明暗主題。
- 批註文件分離：評論存在獨立文件中，正文除你改動的部分外保持字節級一致（README 稱可用
npm run benchmark:fidelity在三種模式下校驗）。
與智能體協作¶
- 選中發送：把選中文本連同文件路徑與行號送到 Composer，再由你決定是否發送。
- 評論驅動：對段落加評論，可單條或一次性發送所有未關閉評論；智能體處理後會通過
resolve_document_comment將對應評論標爲已解決，未處理的保持打開。 - 外部變更：智能體改文件後，若你本地無未保存內容，編輯器會同步；若有未保存內容，會詢問保留哪一版，不會靜默覆蓋。
- Skill：自帶
quirekit-markdown，便於智能體寫 callout、摺疊塊、Mermaid、PlantUML 與數學公式。 - 截圖：本地截圖可按相對或絕對路徑顯示（僅讀取圖片文件）。
工具欄菜單可隨時切回官方 Markdown 預覽；評論側欄可隱藏或顯示。
性能（README 公佈數據）¶
在約 100 萬字符長文檔中，中位單次按鍵到編輯器接受新文檔約 2.4 ms（Visual），p95 約 3.0 ms；編輯器運行在獨立 iframe 中，與 DSH 頁面樣式隔離。實測環境爲 Apple M3 Max、Chromium 149，文檔中稱長文按鍵延遲隨篇幅增長較平緩。
安裝與啓用¶
環境要求（與 package.json 的 engines.dsh 一致）：DeepSeek Harness >=0.2.2-rc.1 且 <0.3.0，Web 或桌面端均可。
Web 端安裝命令（須使用資料原文，勿自行拼接 GitHub 路徑）：
dsh plugin --profile web add dsh-quirekit-md-editor
安裝後重啓 dsh web，在 Files 標籤中打開任意 Markdown 文件即可進入可編輯預覽。
桌面端：打開 Plugins 頁面 → Add plugin → 輸入 dsh-quirekit-md-editor → 啓用。
從源碼安裝（需自行構建，路徑改爲本機絕對路徑）：
npm install
npm run build
dsh plugin --profile web add file:/absolute/path/to/dsh-md-editor
注意：插件以當前 DSH 進程的權限運行；安裝前建議查看 GitHub 倉庫 源碼與 MIT 許可證，確認符合你的安全策略。社區目錄 SkillHub 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
插件設置¶
在 DSH 的 Plugins 頁面可配置：
- 默認編輯模式
- 是否顯示模式切換
- 格式工具欄：固定、浮動或隱藏
設置保存在當前瀏覽器中。
典型用法¶
- 讓智能體在工作區生成或更新某一
.md文件。 - 在 Files 中打開該文件，右側使用 QuireKit 編輯器閱讀；需要時切換 Visual / Markup / Source。
- 直接改正文，或在對照段落旁添加評論。
- 將選中內容發送到 Composer，或將一條/全部開放評論發給智能體。
- 智能體修改文件並 resolve 已處理的評論後，確認編輯器同步結果；若你仍有未保存編輯，按提示選擇保留版本。
README 中的演示視頻展示了選區發送、評論交接與 resolve、以及在同一 Markdown 下三種模式與評論的表現（部分片段有加速標註）。
適用場景與侷限¶
更適合：智能體產出長 README、設計說明、技術方案後，由人在 DSH 內微調措辭、補圖表，並用評論列出仍須智能體執行的修改；重視「改一個字就是一個字符 diff」、不希望預覽編輯破壞原有 Markdown 寫法（setext 標題、各類列表符號、原始 HTML 等）的場景。
需留意：
- DSH 版本須落在
0.2.x的 rc.1 及以上、0.3.0 以下，升級主版本前需確認插件是否仍兼容。 - 評論與正文分文件存儲，協作時要清楚哪一側是「給智能體的工單」。
- 性能數據來自作者 benchmark，與你本機硬件、文檔結構（是否結構密集）會有差異。
結尾¶
dsh-quirekit-md-editor 把 DSH 右側從只讀預覽變成與智能體共用的 Markdown 工作面：正文仍是你倉庫裏的純文本，評論則成爲可往返於編輯器和智能體之間的協作通道。若要查看簡介與分類，可打開 SkillHub 目錄頁；安裝命令、設置項與性能說明以 GitHub README 爲準。
