Scientific Agent 使用指南

适用版本：Desktop 1.3.3、Runtime 1.1.1。英文版见 English guide。

Scientific Agent 是一个面向计算科学研究的本地工作空间。你给出研究目标、允许使用的能力、验收指标和预算，系统负责组织实验、记录证据、调用求解器或生成代码，并在满足明确条件时结束任务。它不是一个让模型随意执行 Shell 的聊天框：研究动作、插件权限、预算、产物、评价和运行状态都由 Runtime 单独校验和记录。

如果只想尽快体验，请选择桌面端快速开始；如果准备在服务器、脚本或 CI 中使用，请从命令行快速开始开始。

系统由什么组成

Scientific Agent Desktop
  Tauri 桌面外壳
       │ 启动并守护
       ▼
Scientific Agent Runtime ── Control API ── React 控制界面
       │
       ├── Scientific Reasoner：决定下一项研究动作
       ├── Policy / Budget / Criteria：授权、限额与验收
       ├── Model Plane：科学推理、代码生成、代码修复
       ├── Plugin Runtime：领域求解、分析、评价、报告、执行
       └── Event Log + Artifact Store：可恢复状态与不可变产物

Scientific Agent Benchmark Suite
       └── 从外部用冻结协议评价 Runtime，不参与普通研究任务
  • Desktop 是无需 Python 或 Node.js 的安装版。它在随机本地端口启动打包好的 Runtime，并使用每次启动生成的会话凭据连接界面。
  • Runtime 是研究控制核心。桌面端、CLI 和 Control API 最终都使用同一套状态、策略、预算、验收和产物规则。
  • 插件 提供具体科学能力。Xsuite 粒子跟踪、三体求解、可信评价、科学分析、知识对象和报告都在插件里，而不是写死在研究循环中。
  • Benchmark Suite 是独立的外部测量工具。Runtime 不知道自己是否正在被测试，避免基准逻辑反过来影响普通研究。

参考的思想与实现组件

这里的“参考”主要是架构思想和成熟组件，并不表示系统复制了某个单一框架：

  • 借鉴 event sourcing：重要改变先追加为事件，再重放得到当前状态，因此进程中断后仍能恢复，历史也不会被一个可变 JSON 覆盖。
  • 借鉴 控制平面 / 执行平面分离：Reasoner 提议“做什么”，Runtime 决定是否允许，代码模型只实现已经批准的任务，执行插件负责实际进程。
  • 借鉴 可复现计算与数据谱系：大数据、模型、图和报告作为带 SHA-256、父子关系和创建者信息的不可变产物保存，并组成 provenance DAG。
  • 借鉴 能力式插件系统：研究契约授权的是稳定 capability，而不是某个 Python 类；实现可以替换，权限边界仍可审计。
  • 借鉴 冻结评测协议：Benchmark Suite 在运行前固定配置、私有数据身份和哈希，并在研究成功后再做 holdout 检查。
  • 桌面与界面使用 Tauri 2、React、FastAPI、React Flow 和 Dagre；加速器示例使用 Xsuite。这些组件服务于本地桌面、类型化 API 和谱系可视化，并不改变 Runtime 的科学裁决权。

主要特色

  1. 研究契约先于执行：目标、问题、能力、输入、验收条件、预算、模型和可选科学工作流都能在启动前预览。
  2. 成功由证据决定：CriteriaEngine 根据已记录指标判断；需要时可以要求指标必须来自可信评价插件，还可要求报告、假设或验证结果等产物齐全。
  3. 全程可检查：时间线、模型调用、作业、预算、资源、证据、声明、假设、验证、报告和产物谱系均有专门读视图。
  4. 人可以介入，但不能偷偷改历史：暂停、继续、调整预算和添加研究备注都是有限指令，并作为事件审计；Ask 只读取，不改变 ResearchState。
  5. 本地优先：研究数据默认进入 Documents/ScientificAgent；桌面端密钥进入操作系统凭据库。普通开发服务器只应监听 127.0.0.1。
  6. 可扩展而不改 Core：一个自包含目录或 ZIP 加上一份 manifest 和一个实现类，就能增加新的领域能力。
  7. 研究与评价分离：隐藏 holdout、复现实验和统计报告属于 Benchmark Suite，不会泄漏给普通研究循环。

推荐阅读路线

  • 桌面用户：快速开始 → 创建研究任务 → 控制室 → 谱系 → 设置。
  • 服务器与自动化用户：CLI 快速开始 → CLI 命令 → 配置文件 → 无界面 API。
  • 插件作者：CLI 快速开始 → 使用插件 → 从零开发插件 → SDK 参考。
  • 需要评测模型策略：科学工作流 → 基准测试套件 → 数据与安全。

当前边界

Desktop 1.3.3 是面向单用户可信本机的应用。它没有远程账户系统、云同步、HPC/Slurm 调度、多租户隔离或恶意代码沙箱；本地执行器运行的代码拥有当前用户权限。桌面内置更新按钮当前也未配置。不要把开发模式的 Control API 直接暴露到公网。

下一步：桌面端快速开始或命令行快速开始。

results matching ""

    No results matching ""