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