参考文档
全局设置
给控制台中的任务设置共用的模型配置和各自的数据目录,省去反复填写。模型配置文件规定每个步骤调用哪家服务、哪个模型。你也可以保存一份建议文件供以后使用,但目前全局建议不会传给运行。
修改一次设置
- 打开 Settings 并连接控制台。先确认页面显示的服务器:这里的目录位于运行控制台的机器上。
- 在 Models 中选择模型配置。Show routes 会列出各步骤使用的服务和模型,页面也会列出所需密钥的名称,不显示密钥值。
- 在 Data folder 中为任务选择允许使用的数据根目录,进入子目录后点 Use <folder>。符号链接会显示出来,但不能选。显示 Set in console.json 的任务已经在配置文件中指定了目录。
- 点击 Save settings。出现 Saved; active after server restart 后,重启 serve 命令。Values in effect 会显示当前运行中的控制台实际使用的值、来源和服务器路径。
预期结果:重启后,没有自行指定模型配置或数据目录的任务会使用这些默认值。重启前,页面会区分已保存的选择和当前生效的值。
文件放在哪里
运行 .venv/bin/python -m tools.candidate_console init --workspace /absolute/project 时,请从 SIDERIUS 代码目录执行命令,并把 /absolute/project 替换为你的项目绝对路径。命令会在该项目下创建 siderius_workspace/。父目录必须明确指定,没有默认位置。再次运行只会补齐缺少的内容,不会覆盖现有文件。
settings/console.json 保存控制台配置,settings/console-token 保存控制台访问令牌,settings/global_settings.json 保存全局选择。模型配置和建议文件分别放在 library/llm/、library/advice/。初始化会保存并选中标准模型配置,文件名为 default-<12 hex characters>.json。
data/<task_id>/ 用来存放任务数据,需要你自己创建并填入数据。operations/、preparations/、candidates/ 和 runs/ 存放控制台状态与运行产物;projects/ 是约定的工作流项目存放位置。
允许选择什么
允许列表规定浏览器可以选择哪些文件和数据目录。由维护控制台的人在 console.json 的 llm_profiles、advice_files、data_roots 中登记,也可以使用工作区资料库中的文件。全局设置通过这些条目的 ID 或资料库引用保存选择,浏览器不用填写服务器路径。
只有 console.json 包含 global_settings 块时才会读取全局设置文件。保存和导入需要 "global_settings": {"browser_writable": true}。初始化会把它写进新配置;旧配置不会被自动改写,需要手动加入并运行 check。设为 false 时仍然读取全局设置,但浏览器只能查看。
哪一层设置优先
优先级从低到高是:全局设置 < console.json < 工作流自身的设置。全局设置只补齐 console.json 没填的值,工作流自己写明的值仍然由该工作流使用。数据目录两处都没填时,才使用工作区约定的 data/<task_id>/;模型配置没有这种目录默认值。
例如,全局选了模型配置 A,某任务在 console.json 中明确指定 B,那么该任务仍使用 B。若工作流又明确设置自己的值,就按工作流设置执行。想查为什么没有用上 A,请看 Values in effect 的来源。建议文件有单独的限制:全局选择目前只保存,不会覆盖或补充工作流中的建议。
导入与导出
在 Models 或 Advice 下点 Import from this computer…,可以导入模型 JSON 配置或命令行格式的建议文件,包括之前导出的建议。控制台先检查文件,再复制到服务器的资料库。相同文件重复导入会复用现有副本;资料库中的文件不会被替换或删除。在 Advice 中可以选文件或 None,但选择目前不影响运行。
在 Export a workflow 中选择项目、任务和导出名称,再点 Export。文件写入服务器的 siderius_workspace/exported_configs/<export name>/:llm.json 是所选任务当前使用的模型配置,workflow.py 是最后保存的工作流,有工作流建议时还会生成 advice.json。每个 Download 按钮把对应文件下载到当前电脑。
命令行可以通过 --llm_config 读取模型文件、通过 --advice 读取建议文件。导出不包含密钥、控制台令牌或凭据文件路径;也不包含已保存但尚未重启生效的设置。