前言¶
在 DeepSeek Harness（DSH）裏改代碼時，常見做法是在對話裏粘貼片段，或口頭說「第幾行有問題」。片段容易缺上下文，行號又容易和當前工作區文件對不上。若希望按真實路徑與行號逐條給模型下任務，同時又不想離開會話界面，dsh-review-comments 把「瀏覽工作區、看 Git 變更、在行上寫評論、一次性提交」收進 Web UI 右側欄，評論會以 path#line 有序列表隨消息發給模型。
這是什麼¶
dsh-review-comments（倉庫 HusuSama/dsh-review-comments）是面向 DeepSeek Harness Web UI 的客戶端插件，維護者爲 HusuSama。插件不另開窗口，入口是右側欄指南卡片 File Review（中文：文件評審）。它負責讀全文件、把評論錨定到單行或行區間，再把收集到的評論交給模型；Git 變更以標記形式展示，瀏覽與寫評論互不干擾。
在 SkillHub 插件目錄 中歸類爲客戶端插件；倉庫當前 Star 數爲 0。包版本爲 0.1.0，許可證 MIT（見倉庫 package.json）。
核心功能¶
下面按 README 已寫明的能力歸納，不含未在資料中出現的行爲。
右側欄集成¶
指南卡片出現在 Harness 右側欄，複用 Harness 的標籤框架、主題 token（--dsw-alias-*）與 locale，無自定義頂欄。依賴右側欄能力包 @deepseek-ai/dsh-client-ui-sidebar-right（默認 Web 捆綁的一部分）。
工作區瀏覽與模糊搜索¶
遞歸模糊搜索：輸入文件名任意片段即可匹配（分隔符與缺字不影響排序），結果按匹配質量排序並按文件夾分組。自動跳過 .git、.svn、.hg、node_modules。文件樹支持懶加載展開。
語法高亮與長文件¶
基於內嵌 Prism.js 1.30.0 做語法高亮，覆蓋 JavaScript/TypeScript/JSX/TSX、JSON、CSS 系、HTML/XML/SVG/Vue、Markdown、Python、Shell、YAML/TOML/INI、SQL、diff、Go、Rust、Java 等；未識別後綴回退純文本。超過 5000 行的文件爲保持響應速度以純文本渲染。
Git 狀態（可選）¶
若 git 在 PATH 中，樹與行視圖會顯示變更：新增/未跟蹤爲綠，修改/重命名爲藍，刪除爲紅，衝突爲琥珀色；樹節點帶 A/M/D/R/U 字母，行側有豎條標記。Changed only 開關僅列出當前項目未提交的變更文件。無 git 時插件仍可運行，只是不顯示 Git 狀態。
行評論與導航¶
雙擊某行，或拖選行區間，在選區下方打開評論輸入框：Enter 生成行內卡片，Shift+Enter 換行，Esc 取消。文件頭顯示當前評論位置（如 2/7），可用上一/下一或 Ctrl/Cmd+Up/Down、Ctrl/Cmd+P/N、Ctrl/Cmd+滾輪 跳轉。樹與頁腳展示每文件、每文件夾（聚合）及工作區評論總數；支持刪除單條、當前文件全部、或全部評論。
發給模型¶
在評論框 Ctrl/Cmd+Enter 或面板發送按鈕，可把待發送評論格式化爲列表提交。若評論仍掛起，在普通聊天框發送消息時，會在你的正文後空一行追加同一列表（評論卡片在發送被接受前仍留在面板）。評論按側欄標籤頁緩存，切換標籤再回來會保留，發送或刪除後清理。
模型收到的是一條用戶消息：簡介行 + 有序列表，每項爲絕對路徑與 #行號 或 #起始:結束，附評論正文，不包含源碼摘錄（模型可按路徑自行讀文件）。語言隨當前 UI（中/英）。示例結構如下：
我在文件中留了 3 條評審評論，請按文件與行號逐條處理。
1. `/Users/me/proj/README.md#5` 標題需要說明用途
2. `/Users/me/proj/src/client/index.ts#12` 這裏沒有處理 null 情況
3. `/Users/me/proj/src/client/index.ts#20:24` 這段邏輯可以提取爲函數
環境與依賴¶
- 需要包含右側欄的 DSH Web UI profile；README 寫明在 macOS 上與 DeepSeek Harness
0.2.1-rc.5測試通過，其他桌面/Web 平臺理論上可用。 - 僅從源碼構建時需要 Node.js ≥ 20。
- 插件僅通過該 GitHub 倉庫分發，無 npm 發佈包。
安裝與啓用¶
推薦在 Settings → Plugins 中安裝：粘貼 https://github.com/HusuSama/dsh-review-comments（插件管理器支持 GitHub 源），或選擇本地 checkout 目錄；捆綁會自動選中，瀏覽器側熱加載到當前頁面。
命令行安裝（資料原文）：
# install from this repository (pnpm fetches the package from GitHub)
dsh plugin --profile web add github:HusuSama/dsh-review-comments
# local checkout instead, e.g. for development:
dsh plugin --profile web add link:/absolute/path/to/dsh-review-comments
CLI 只添加依賴；還須在 Settings → Plugins 中啓用 File Comments 捆綁（管理器 UI 可一步完成安裝與選中）。無需重啓應用：瀏覽器側熱替換，宿主側隨捆綁啓動。
典型用法¶
- 在會話頭展開右側欄，在指南頁點擊 File Review（文件評審）卡片；若側欄已展開，可先關其他標籤再從指南進入。無全局快捷鍵，指南卡片是唯一入口。
- 在文件列表中瀏覽或搜索，需要時打開 Changed only 只看未提交變更。
- 打開目標文件，雙擊行或拖選區間寫評論，用文件頭或快捷鍵在評論間跳轉。
- 用面板發送或在與模型對話時一併發送，讓模型按路徑與行號處理。
常用操作與上述步驟對應關係見倉庫 README 中的用法表（點擊文件夾展開、搜索框模糊搜、切換 Changed only、雙擊/拖選評論、Ctrl/Cmd+Enter 發送等）。
適用場景與注意¶
適合在 DSH Web 會話裏做代碼評審式協作：自己先在工作區標行評論，再讓智能體按行號改文件或解釋邏輯，而不是在聊天裏重複貼大段代碼。
安裝前請自行查閱倉庫源碼與 MIT 許可證。插件在當前 DSH 進程權限下運行，可訪問工作區文件；與所有 DSH 插件一樣，只應從可信來源安裝。SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係，本文介紹不代表官方背書。
結尾¶
dsh-review-comments 把「看文件、看變更、行錨評論、結構化交給模型」放在右側欄一條鏈路裏，評論格式固定爲 path#line，便於模型回讀工作區。詳情與演示見倉庫 README 與 docs/media/demo.gif。
- 目錄頁：https://www.skillhub.cn/plugins/HusuSama/dsh-review-comments
- GitHub：https://github.com/HusuSama/dsh-review-comments
