用途：为任意优化目标建立并运行自主实验循环，收集优化目标后立即开始循环，适合需要长时间自动迭代调优的场景。
主要能力：提供 init_experiment（配置会话名称、指标、单位、方向，目标变化时可重新初始化基线）、run_experiment（执行命令、计时、捕获输出）、log_experiment（记录结果，keep 自动提交，discard/crash/checks_failed 自动回滚代码改动但保留 autoresearch 文件，需包含次要指标字典）。仪表盘快捷键为 ctrl+shift+t。
会话文件统一放在工作目录根下的 .auto/ 子文件夹：prompt.md（实验提示与手册）、measure.sh（基准脚本，输出 METRIC name=value 行）、log.jsonl（追加式结果日志）、ideas.md（想法待办，可选）、checks.sh（正确性检查，可选）、config.json（会话配置，可选）、hooks/{before,after}.sh（生命周期钩子，可选）。旧版扁平 autoresearch.* 文件仍可读取，新会话应使用 .auto/。
使用方式：先询问或推断目标、命令、指标及方向、范围内文件、约束；执行 git checkout -b autoresearch/<goal>-<date>；阅读源文件理解负载；mkdir -p .auto 并编写 .auto/prompt.md 与 .auto/measure.sh 后提交；再 init_experiment → 运行基线 → log_experiment → 立即开始循环。measure.sh 需快速预检并输出结构化 METRIC 行，噪声大的短基准可多次运行取中位数。checks.sh 存在时在每次基准通过后自动运行，失败记为 checks_failed，其耗时不计入主指标，默认超时 300 秒，可通过 checks_timeout_seconds 配置。config.json 支持 maxIterations 与 workingDir。
循环规则：持续循环，不问是否继续；主指标改善则保留，变差或持平则丢弃；每次运行用 asi 注释；关注置信度分数（≥2.0× 可能为真实改善，<1.0× 可能在噪声内，仅供参考）；更简单者优先；避免反复回滚同一想法；崩溃可轻易修复则修复，否则记录后继续；卡住时深入阅读源码与性能数据；若 .auto/prompt.md 存在则读取并继续。
限制：资料未提供具体收费、价格、平台支持范围与效果保证；需自行准备基准脚本与正确性检查；丢弃或崩溃的运行会回滚代码，仅描述与 ASI 记录保留。