前言¶
在 DeepSeek Harness（DSH）里改界面或交互时，常见做法是开两次会话、让模型各写一版，再凭 diff 或主观印象拍板。界面类任务往往「测不出好不好」，只能人点一遍；两版若不从同一基线出发，还容易出现依赖、端口和验收标准不一致，比较失真。
AgentCompare 是社区维护的 DSH 工作流插件：同一条需求生成两份实现，各自构建并在对话里并排预览，盲选后再揭晓模型或策略，通过验收的版本才允许「审查并采用」写回当前仓库。下面介绍它的定位、能力与在 Web profile 下的安装用法。
这是什么¶
AgentCompare（npm 包名 dsh-agent-compare，维护者 lijiaqi-AI-Product-Manager）面向 DSH 宿主：在同一前端需求下并行跑两个候选，复用 DSH 当前已配置的模型（双模型模式则从已配置模型里各选一个）。插件简介可概括为：同一需求，两版真跑，盲选再揭晓；英文说明为 Two live builds for one task in DeepSeek Harness。
当前版本为 0.2.0-alpha.18 预览版。README 写明首期支持本地 Git 仓库根目录的 Vite 前端，并复用 DSH 当前模型。许可证为 MIT；在 DSH 0.2.1-rc.5 上做过测试（见仓库徽章与 docs/demo.md）。社区目录页：https://www.skillhub.cn/plugins/lijiaqi-AI-Product-Manager/dsh-agent-compare；源码：https://github.com/lijiaqi-AI-Product-Manager/dsh-agent-compare。
DSH 生态强调「一切皆插件」；SkillHub 等目录为独立社区站点，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
两种比较方式¶
| 方式 | 两边相同 | 两边不同 |
|---|---|---|
| 同一模型 · 两种策略（默认） | 模型、需求、验收 | 「稳妥」沿用现有写法 vs「大胆」重做交互 |
| 两个模型 · 同一要求 | 需求、验收、给 Agent 的说明 | 模型（从 DSH 已配置模型中选两个） |
插件替你收敛的步骤¶
README 归纳了手工双会话时最难对齐的部分，插件将其合成一条工作流：
- 两份代码从同一基线出发（含未提交改动），不改动你当前的 index 与工作区文件；
- 每个候选在独立副本上申请宿主写入约束，并披露宿主实际提供的约束范围；
- 两边分别装依赖、构建、各占端口，同时跑预览；
- 用事先固定并绑定内容的同一套验收比较；候选若改验收脚本或测试则不算通过；
- 选定后写回前核对当前项目与候选改动能一起工作，确认后才写入。
从发需求到采用的流程概要¶
- 基线：用私有临时 index 对工作区快照（含未提交与未跟踪、不含被忽略文件），不改你的 index 和文件。
- 验收绑定：从基线确定
typecheck/lint/test/build与页面验收；记录脚本与相关配置、测试文件、仓库根目录.agent-compare.json等内容哈希。.agent-compare.json可配置逐步交互验收。 - 隔离副本：为每个候选建不带分支的
git worktree，位于~/.dsh/agent-compare/w/<run>/<A|B>。 - 候选会话：每侧为独立 DSH 会话，目录即副本；生成上限可在界面选 5 / 15 / 30 / 60 / 120 分钟（默认 30）。
- 封存与验证：冻结改动为提交与补丁 → 冻结安装（有锁文件时）→ 跑验收 →
vite preview跑构建产物 → 无头浏览器做页面验收（含桌面/手机截图等）。 - 盲选与揭晓：面板 iframe 只标 A/B；选择后揭晓策略、实际模型与 token 用量。
- 审查并采用：仅对通过验收的版本开放；冲突检测、预演、写入前再核验；失败可恢复或撤销（受 README 所述条件约束）。未通过者仅可「另存为分支」供查看。
界面和交互类任务（搜索筛选、表单、落地页、仪表盘布局、组件重设计等）适合用本插件；答案唯一的修 bug 或重构，文档建议单 Agent 加测试更合适。
安装与启用¶
插件以当前 DSH 进程权限运行，安装前应自行查看源码与 MIT 许可证。Node.js 要求：^22.22.2 || ^24.15.0 || >=26.0.0；package.json 中 DSH 引擎范围为 >=0.2.1-rc.3 <0.3.0。
以下命令面向自行运行的 DSH Web profile。桌面版的 desktop profile 由应用管理，请使用应用内插件页面。
安装 npm 预览版到默认 Web profile：
dsh plugin --profile web add dsh-agent-compare@0.2.0-alpha.18
若使用其他自行运行的 profile，将 web 换成实际名称。安装后需重启 DSH。更完整的收录与安装说明见仓库 docs/distribution.md。
典型用法¶
重启 DSH 后，在主对话输入框左下角点 A|B：
- 输入框上方展开设置条，选择「同一模型 · 两种策略」或「两个模型 · 同一要求」；默认复用当前模型。双模型模式提供两个已配置模型的下拉框。
- 选择每版生成上限（5–120 分钟）。设置保存在当前对话。
- 在原输入框写需求并发送。模式切换保留草稿、引用与附件；暂不支持的附件会由宿主拒绝并保留原稿。
- 同一条对话里出现 A|B 卡片，两个小窗口为两版真实运行的应用。可切换统一桌面/手机视口或专注 A/B；「大窗口查看」用于放大检查。
- 选择后揭晓模型和策略，展开代码改动，再点「审查并采用」。先显示目标仓库与核验结果，确认后才写入。采用后点「继续主对话」退出比较模式，记录仍保留。
设置条中的「试跑内置示例」会新建独立示例仓库并在本对话启动，不修改已有草稿；示例结果只采用到示例仓库。
右上角 比较记录 与 使用教程 在新建和已有对话中均可打开。完整操作可参考仓库内 GIF/视频（docs/media/comparison-workflow.mp4，约 28 秒）与 docs/demo.md。
适用场景与注意¶
适合：需要人眼体验才能判断好坏的前端/Vite 根目录项目；希望在同一验收与同一基线下公平比较「稳妥 vs 大胆」或「模型 A vs 模型 B」。
范围与限制（以 README 为准）：
- 预览版能力边界：首期侧重本地 Git 仓库根目录 Vite 前端。
- 隔离与安全：候选写文件依赖 DSH 沙箱；README 说明 Windows 沙箱为 partial、网络与进程可见性不隔离等边界，详见「隔离与安全：保证什么、不保证什么」一节。
- 无锁文件时只能非冻结安装，界面会提示；构建未通过时可能仅提供标为「仅供观察」的开发模式预览。
运行记录、重启与恢复见 docs/runs-and-recovery.md；自定义验收见仓库根目录 .agent-compare.json 说明。
结尾¶
AgentCompare 把「双实现、双预览、统一验收、盲选、审查写回」收进 DSH 对话，减少手工开两路会话时的基线与验收漂移。若要安装或跟踪更新，可访问 SkillHub 插件目录 与 GitHub 仓库。
