前言¶
在 DeepSeek Harness（DSH）裏和 Agent 協作寫 PRD、調研或方案時，審閱 Markdown 往往要不斷在「預覽」和「對話框」之間切換：選中原文、複製、粘貼、寫意見，再回來繼續讀。意見一多，來回操作會擠佔真正審閱的時間。
dsh-md-review 是 DSH 的 Web 客戶端插件，把批註留在右側欄的文檔預覽裏，最後把多條意見合併成一條結構化消息發給當前會話的 Agent。下面按定位、功能、安裝與用法說明。
這是什麼¶
- 名稱：
dsh-md-review（倉庫 Sara-Chen111/dsh-md-review） - 維護者：Sara-Chen111（Sara Chen）
- 分類：客戶端（
dsh.client.platform: web） - 版本 / 許可證：1.0.0，MIT
- 目錄頁：skillhub.cn 插件條目
插件在右側欄打開 .md 等文檔預覽時提供「批註視圖」（Review view）：選中文字寫修改意見，原文高亮並帶編號，右側列出批註卡片；確認後可一次性發送到對話。內置的 Markdown / Code / Plain text 查看器仍可通過預覽右上角「打開方式」切回，插件不接管全部預覽能力。
核心功能¶
以下能力均來自倉庫 README 與 package.json 說明。
- 就地批註：在預覽正文選中文字，點浮層「添加批註」，無需離開文檔。
- 可視化跟蹤：已批註原文爲琥珀色高亮，行尾有編號；右側批註欄顯示全部意見卡片；點卡片可跳回原文，支持編輯、刪除。
- 統一發送：批註欄底部可寫整份文檔的補充說明；「發送到對話」將未發送批註合併爲一條消息（含文件名、路徑、行號、章節與原文引用）；也可「僅填入對話」，先在輸入框修改再發。發送後標記「已發送」，可「清除已發送」歸檔。
- 本地持久化：批註存在瀏覽器
localStorage，刷新或重新打開同一文件可恢復；Agent 改稿後按「引文 + 前後文」重定位，行號與章節會更新，定位失敗則顯示「原文已修改」。 - 會話維度：批註按「文件 + 會話」保存（預覽 resource address 含會話 id）；同一會話內同一文件會恢復批註，換會話則爲獨立一份。
- 發送依賴：通過會話輸入區的
inputActions（標準 slot props）發消息，僅在右側欄文檔預覽場景內生效。
環境要求（README 寫明）：
- 運行環境：DeepSeek Harness Desktop 或
dsh web；作者在0.2.2-rc.1、2026-11 驗證過。 - 瀏覽器：需支持 CSS Custom Highlight API（Chrome / Edge / Safari 17+）。
安裝與啓用¶
安裝前請自行查看倉庫源碼與 MIT 許可證。插件以後臺與 Web 客戶端形式接入 DSH，與 DSH 當前進程權限一致，只應從可信來源安裝。
從 GitHub 安裝（README 推薦）¶
在 DSH Plugins → Add plugin 中粘貼：
github:Sara-Chen111/dsh-md-review
或在命令行執行：
dsh plugin add github:Sara-Chen111/dsh-md-review
安裝完成後刷新 DSH Web 頁面。右側欄打開任意 .md 文件時，默認進入批註視圖。
卸載¶
在 Plugins 頁面移除該插件，或使用插件管理器：
plugin_manager action=remove_bundle target=dsh-md-review
README 另提供「克隆倉庫後本地 install_bundle」方式，路徑需爲絕對路徑；若你採用該方式，按 README「安裝 → 方式二」操作即可。
典型用法¶
按 README「使用」一節，可復現的流程如下：
- 在右側欄打開任意
.md文件。 - 選中正文一段文字 → 點擊「添加批註」→ 填寫修改意見 → 保存（
⌘Enter）。 - 重複添加多條批註；必要時在批註欄底部輸入框寫整份文檔的補充說明。
- 點擊「發送到對話」，將未發送批註合併爲一條消息發到當前會話。
- 發送後批註變爲「已發送」；需要時用「清除已發送」歸檔。
Agent 收到的是結構化單條消息，便於按文件、行號與引用逐條處理。
適用場景與注意¶
適合誰
- 經常在 DSH 右側欄預覽 Markdown，並需要把多條審閱意見一次性交給 Agent 的開發者或寫作者。
- 希望批註留在文檔上下文中核對，而不是在聊天裏零散粘貼引文的協作流程。
使用前須知
- 批註僅保存在當前瀏覽器
localStorage，不跨設備同步；清理瀏覽器數據會丟失。 - 超大文件依賴預覽分頁加載，需滾動加載全文（與內置預覽一致）。
- 若整段引文被 Agent 刪除，對應批註會顯示「原文已修改」，可手動刪除或重新選段引用。
- 社區目錄 skillhub.cn 與 DeepSeek / 幻方無官方從屬關係；DSH 生態以「一切皆插件」爲思路，本插件爲社區維護的客戶端擴展。
結尾¶
dsh-md-review 把「讀文檔 → 留意見 → 發給 Agent」收攏在右側欄預覽內，減少複製粘貼與會話切換。需要安裝規格與開發說明時，以 GitHub 倉庫爲準：
- 目錄頁：https://www.skillhub.cn/plugins/Sara-Chen111/dsh-md-review
- 源碼與 README：https://github.com/Sara-Chen111/dsh-md-review
