自主实验循环 vlozg/dsh-autoresearch

dsh-autoresearch

DSH 插件，移植自 pi-autoresearch：一个针对那些指标永远无法达到满分的难题的自主实验循环。智能体提出假设、对其进行基准测试、保留或丢弃结果，然后重复——此外还有一个实时的 better-sidebar 仪表盘，用于从浏览器（包括手机）监控和审查运行。

该循环刻意不运行在 DSH 目标上：目标可以被模型标记为完成，而这些循环针对的是永远无法达到满分的难题。自动恢复改为在插件侧实现（空闲后续跟进，pi 风格，带有 pi 的防护措施）。

仓库布局

| 路径 | 说明 |
| dsh-plugin-autoresearch/ | 插件：宿主侧（六边形）+ 客户端侧（FSD） |
| dsh-plugin-autoresearch/docs/ARCHITECTURE.md | 分层标准与审查清单，在每次测试运行时进行机器校验 |
| dsh-plugin-autoresearch/README.md | 插件文档：工具、HTTP 路由、安装到 DSH 配置、实时重载 |
| DESIGN.md | 移植背后的设计与研究笔记（DSH 插件剖析、better-sidebar API、切片、风险） |
| refs/pi-autoresearch/ | 上游参考，固定的 git 子模块——本移植所依据的修订版本 |

快速开始

git clone --recursive git@github.com:vlozg/dsh-autoresearch.git
cd dsh-autoresearch/dsh-plugin-autoresearch
pnpm install

--recursive 很重要：refs/pi-autoresearch 是一个子模块（上游 davebcn87/pi-autoresearch，当前固定在 939ede8）。已有的克隆可通过 git submodule update --init 进行同步。

门禁

pnpm typecheck # tsc --noEmit
pnpm test # vitest — 92 tests across 14 files, architecture conformance included
pnpm build # tsdown -> lib/index.mjs (host) + lib/client.cjs (client)

这三项预期在每次提交时都能干净运行；pnpm build 还会强制检查客户端打包的纯净性（在模块表外部依赖之外不得有 @deepseek-ai/* 导入）。

架构概览

host (hexagonal) domain <- app <- adapters . infra composed in src/host/index.ts
client (FSD) shared <- entities <- features <- src/client/index.ts
contract src/shared/wire.ts — type-only, imported by both faces

宿主的纯内核（domain/）没有 node 内置模块，也没有框架。客户端通往跨侧契约的唯一入口是 src/client/shared/wire.ts。docs/ARCHITECTURE.md 包含完整规则、审查清单、变更配方以及已接受的债务。

状态

已实现并端到端测试：三个智能体工具（init_experiment、run_experiment、log_experiment）、.auto/ 会话契约（measure / checks / hooks / log.jsonl）、pi 风格的自动恢复、SSE 路由、带有 toolview 卡片的 better-sidebar 仪表盘，以及跨对话工作目录的过往会话检测。92 个测试通过，两个打包产物均可构建。

来源 pi-autoresearch（MIT，© Tobi Lutke 和 David Cortés）的移植版本，固定在 refs/pi-autoresearch 中。Tencent/BrowserSkill 是全功能 DSH 工具插件的参考，并未被纳入代码库——参见 DESIGN.md。