dsh-code-review
Verified@michengai/dsh-code-review · v0.1.2 · Apache-2.0
基于 Codex 原版审查流程的 DSH 原生子 Agent 插件
Install
dsh plugin add @michengai/dsh-code-review Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Readme
DSH Code Review 是 DeepSeek Harness 的社区代码审查插件,包名 @michengai/dsh-code-review。在当前会话输入 /review,选择范围或写下要求,原生独立子 Agent 会自行检查 Git、源码、调用方和测试,再把报告返回主会话。无需安装 Codex。
宿主兼容性
当前版本针对 DSH 0.1.6-alpha.1 开发与验证,通过 dsh.bundle.patch 加载。需要原生 spawn provider、userQuestions 服务、当前平台的问题回答器,以及支持工具调用的模型。
可从 npm 安装,也可从源码构建。已验证离线宿主与安装包链路;真实模型的审查质量、语言遵循和不同平台的交互仍需实际验收。
你可以做什么
- 选择审查范围:对比基准分支、检查未提交更改、选择一次提交,或输入自定义要求。
- 让审查 Agent 自行取证:独立上下文读取 Git、相关代码和测试,不提前注入全仓代码快照。
- 在主会话查看结果:接收带优先级、文件路径和行号的发现;模型返回普通文本时保留原文。
- 使用中英文报告:通过独立语言上下文跟随宿主语言偏好,保留 Codex 英文规范原文。
- 查看状态或取消:恢复最近一份报告,或取消范围选择和进行中的审查。
环境要求
- 已安装 DeepSeek Harness,PowerShell 中可运行
dsh。 - Node.js ≥
22.19.0、npm 和 Git;Node.js 同时应满足所安装 DSH 的要求。 - 示例使用
webprofile,请替换为实际运行 DSH 的 profile。
DSH 产品生态
想使用桌面工作台,可下载 DSH Codex Desktop;已有 DeepSeek Harness 环境,可按各项目 README 按需安装。以下列出 11 个自研插件;桌面端实际随附范围以对应版本的发行说明和内置清单为准。
| 插件 | 你可以用它做什么 |
|---|---|
| Codex UI | 整理项目与会话、搜索任务、跳转对话轮次 |
| Agency Agents | 按任务选择并召唤专业角色 |
| Skills Manager | 统一查找、启停、创建和导入本机技能 |
| Archive Manager | 搜索、恢复或清理已归档会话 |
| IM Connect | 从消息平台下任务、收回复 |
| Automation | 按计划执行任务,查看每次运行的结果 |
| BTW | 在当前上下文中临时旁问,不打断主任务 |
| Simplify | 用 /simplify 整理 Git 改动范围内的代码 |
| PUA | 引导 Agent 在失败时换方法、查原因,并在完成前验证结果 |
| Code Review | 用 /review 发起独立 Agent 代码审查,在当前会话接收报告 |
| Codex Pet | 通过桌面宠物查看会话提醒、处理工具审批和问题回答 |
安装
让 Agent 安装(推荐)
将以下要求发送给能访问本地终端的 Agent:
请安装 DSH 插件 @michengai/dsh-code-review 到本机 web profile:执行 dsh plugin --profile web add @michengai/dsh-code-review@latest --registry=https://registry.npmjs.org/,再运行 dsh --profile web --dump-config,确认插件已加载,并说明如何重启 DSH 和使用 /review。任一步失败请停止并报告原因。
手动安装
执行以下命令:
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
dsh plugin --profile web add @michengai/dsh-code-review@latest --registry=https://registry.npmjs.org/
dsh --profile web --dump-config
各步成功后再执行下一步。重启实际运行的 DSH 后端,再输入 /review。这是原生插件,无需手工复制 lib,也不是 SKILL.md 技能包。
使用
| 目标 | 输入 |
|---|---|
| 打开范围选择 | /review |
| 自定义审查重点 | /review 检查上一提交的权限回归 |
| 查看进度或最近报告 | /review-status |
| 取消选择或正在运行的审查 | /review-cancel |
空输入提供四项:对比基准分支、审查未提交更改、审查某次提交、自定义要求。未提交范围包括暂存、未暂存和未跟踪文件。基准菜单列出本地分支;提交菜单列出最近 100 条提交,也可自由输入其他引用。
命令后面的整段文本都是自定义要求,不解析 CLI 参数。--base main、.、status 均按普通文字传递。审查范围和所需上下文由子 Agent 自行判断和获取;“审查全项目”会原样传递,但不代表程序已验证逐文件完整覆盖。
配置与报告
| 可选配置 | 行为 |
|---|---|
reviewModel |
同一模型提供方下的审查模型名称;省略时继承当前模型配置 |
reportDirectory |
报告存放的绝对路径;默认 $DSH_HOME/code-review,未设置 DSH_HOME 时为 ~/.dsh/code-review |
语言复用宿主 locale.preference:en / en-* 使用英文,其余按当前中英文支持范围默认中文。每轮开始固定语言,下轮读取新设置;命令目录描述和输入提示在插件加载时确定,更新它们需重新加载插件。未保存偏好或没有 settings 服务时默认中文,后端无法获取仅由浏览器自动检测的语言。
每个会话原子保存最近一份报告。历史报告正文不自动翻译;JSON 字段、枚举、代码和路径保持原样。宿主退出后不会自动续跑未完成审查。状态、取消和报告存储是 DSH 插件提供的能力。
常见问题
与 Codex 完全一样吗?
审查规范和短任务模板对照固定源码提交 a592c38c16cdd7623dacc9168926ebccedfb67d3。问题界面、工具、权限和事件展示使用 DSH 原生能力,不是 Codex Desktop 的像素复刻;不同模型不保证相同发现。
审查会修改代码吗?
审查要求不生成修复,但工具层并非强制全部只读。执行能力取决于 DSH 权限与沙箱;never 审批表示需要审批的操作会被拒绝。已限制对应的网页、图片和继续委派工具,第三方别名不属于已核对范围。
安装后没有输出怎么办?
确认安装和运行使用同一 profile,重启 DSH 后端,再检查 dsh --profile web --dump-config 是否包含插件。空 /review 需要宿主问题回答器,主模型也必须支持 code_review 工具调用。可用 /review-status 查看记录;不要把“已提交请求”当成审查完成。
中文界面为什么仍可能看到英文?
请在宿主明确选择中文或英文。模型输出由语言指令约束,无法保证始终遵守;外部工具的原始错误、代码和历史报告不会自动翻译。
开发与贡献
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
npm ci --ignore-scripts
npm run check
npm run verify:package
dsh plugin --profile web add .\michengai-dsh-code-review-0.1.2.tgz --ignore-scripts
check 包含 TypeScript、提示词哈希、短任务与真实 AgentLoop 配合离线模型的回归,以及文档链接检查。verify:package 在隔离 profile 验证 bundle、peer 和安装包宿主链路。这些检查不替代在线模型验收。
| 入口 | 职责 |
|---|---|
| src/index.ts | 命令、主会话工具与报告返回 |
| src/selection.ts | 原生范围选择 |
| src/runtime.ts | 独立审查 Agent 与工具约束 |
| src/request.ts | Codex 短任务和基准引用解析 |
| src/i18n.ts | 宿主语言与输出语言上下文 |
| src/report.ts | JSON、截取 JSON、纯文本顺序回退 |
完整交接记录见阅读导航。回退可重新安装先前保留的本地包并重启 DSH,不删除会话或报告。
来源与许可证
基于 Apache License 2.0 发布。Codex 原文与来源信息见 rubric、source.json 和 NOTICE。