前言¶
DeepSeek Harness（DSH）采用“一切皆插件”的架构。在开发智能体或进行实验时，开发者通常需要让 Agent 连续地修改代码、测量结果，并根据反馈进行迭代。手动管理这种循环会话效率低下，且难以在长时间运行中保持上下文的一致性。
dsh-autoresearch 旨在解决这一问题。它为 DSH 提供了一个持久化的自动研究实验循环，允许在官方 Web GUI 中直接创建、运行和监控实验过程。
是什么¶
这是一个工作流插件，由 aa2246740 维护，采用 MIT 许可证。它为 DSH 添加了“创建目标 → Agent 连续修改/测量/保留或回滚 → 顶部面板显示结果”的闭环能力。通过该插件，开发者可以在会话中定义研究目标，让 Agent 自动执行多轮实验。
核心功能¶
- 持久化循环：支持创建、运行和监控实验循环，状态会话持久化。
- Web GUI 支持：支持在官方 Web GUI 中进行操作和管理。
- 灵活的实验控制：支持修改、测量、保留或回滚实验中间状态。
- 结果可视化：在会话顶部面板实时显示实验结果。
安装与启用¶
安装前请确保环境满足要求：DeepSeek Harness 版本需在 >=0.2.0-rc.1 <0.2.1 之间，Host peer 的 Node.js 版本需 >=22.19.0。
桌面版 / DSH Studio¶
- 打开 DSH Studio。
- 进入 设置 → 插件。
- 点击 添加插件，输入以下内容：
github:aa2246740/dsh-autoresearch#v1.0.10
- 按照插件管理器的提示完成安装。
Web 版¶
在终端中运行以下命令（需确保 dsh、Node.js 和 pnpm 在 PATH 中）：
dsh plugin --profile web add github:aa2246740/dsh-autoresearch#v1.0.10
安装完成后，重启 Web Host 并打开页面即可使用。
典型用法¶
安装完成后，在任意项目会话中即可开始使用。
1. 创建并运行研究¶
- 打开一个项目会话。
- 在输入框中输入
/autoresearch。 - 选择 新建研究。
- 填写研究目标和轮次，并确认。
2. 执行过程¶
运行后，插件会修改项目文件并执行本机命令。整个过程由该会话的模型驱动，持续执行会消耗模型额度。插件不会上传或 push 项目代码到远程仓库。
3. 常用命令¶
插件提供以下命令用于控制实验循环：
/autoresearch：新建研究、继续、查看状态、停止或清除。/autoresearch resume：继续一轮已暂停的研究。/autoresearch status：查看当前持久状态。/autoresearch off：停止自动续跑，但保留已有结果。/autoresearch clear：清除当前项目的 Autoresearch 账本。
4. 数据存储¶
实验的账本数据存储在项目目录的 .auto/ 下，包含 prompt.md、measure.sh、可选的 checks.sh、log.jsonl、ideas.md 和 config.json。在遇到 discard、crash 或 checks_failed 等情况时，系统会尝试从 Git 基线或插件私有快照中恢复受保护的文件。
适用场景与注意¶
- 适用场景：适合需要长时间运行、多轮迭代的实验性开发工作流。
- 权限注意：插件以当前进程的权限运行，安装前应检查源码与许可证。
- 前置依赖：需要 Git 来保存基线，或者使用插件私有快照。
- 网络与额度：不涉及代码上传，但会消耗模型额度。
总结¶
dsh-autoresearch 通过将实验循环持久化并集成到 Web GUI，降低了智能体开发中迭代测试的门槛。它让开发者能够专注于实验设计，而非繁琐的会话管理。
更多信息请访问 DeepSeek Harness 插件目录 或 GitHub 仓库。
