Scientific Agent 使用指南

适用版本：Desktop 1.4.5、Runtime 1.2.3。英文版见 English guide。

Scientific Agent 是一个面向计算科学研究的本地工作空间。默认只需用一句话说明研究目标并按需附上数据、lattice 或求解器；Runtime 会选择本项目的插件能力，并把推导出的验收指标、预算和交付物冻结成可审计的 Research Contract。高级入口仍允许逐项指定这些字段。系统负责组织实验、记录证据、调用求解器或生成代码，并在满足明确条件时结束任务。它不是一个让模型随意执行 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. 一句话输入，研究契约先于执行：已连接的 Scientific Reasoner 先根据目标和静态附件画像产生不带授权的结构化草案，再由 Runtime 的确定性控制层编译能力、provider pin、验收、预算和交付物；高级模式可逐项配置，规划谱系与最终契约都可检查。
  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.4.5 是面向单用户可信本机的应用。它没有远程账户系统、云同步、HPC/Slurm 调度或多租户隔离。生成式本地执行和受管理项目插件都保留当前用户的文件系统与网络权限；工作区/进程隔离不是操作系统沙箱。桌面内置更新按钮当前未配置。不要把开发模式的 Control API 直接暴露到公网。

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

找到 条结果：“”

    没有找到匹配结果：“”