Configuration

初始化与配置

research-bench 的项目事实集中在 .claude/research-bench.config.md。该文件描述源码布局、执行环境、数据、指标、tracking、方向管理和安全保护模式。

初始化流程

运行 /rf:init 或 /ef:init 后,插件会:

1. 本地只读预扫描项目线索,包括 .gitmodules、Docker、GPU、venv/conda、DVC、依赖文件和 .env。
2. 按研究阶段选择模块组合,例如找方向包、执行包或全模块。
3. 在启用执行能力时选择执行档案。
4. 生成 .claude/research-bench.config.md。
5. 实例化项目骨架,包括方向模板、路线图、检查清单、测试脚本和本地启动脚本。
6. 提示补齐关键项目值。
7. 在启用 exec 时执行保护机制回归测试。

重新运行 init 可用于新增或删除模块、切换执行档案、补齐项目骨架。

config 入口

/rf:config 和 /ef:config 等价,用于查看或定点修改配置。

常见操作:

/rf:config
/rf:config set source-dir src/
/rf:config set env.RW_EXEC_PATTERN "docker[[:space:]]+--context.*(exec|run)"

非交互初始化示例:

/rf:config init modules=core,exec exec-profile=local-venv source-dir=src/

执行档案

exec 模块通过“执行位置 × 运行时”确定档案:

	docker	venv/conda
remote	remote-docker	remote-venv
local	local-docker	local-venv

四种档案共享同一原则:正式训练必须通过受控启动通道执行。

配置提交策略

项目配置可能包含内网路径、端点和执行句柄。公开仓库不应提交包含敏感信息的项目配置。