← 返回 README · English | 简体中文
共 23 个示例,每个项目由 workflow.json 和 research_proposal.txt 启动。研究课题文件已经包含具体问题、研究假设、数据范围和评估方案,可以作为编写自己研究计划的参考。这些课题是示例研究设计,不代表已完成实验或复现原论文结果。
环境变量、服务依赖与运行参数见 运行准备;网关与模型配置见 main CLI。
在仓库根目录安装和构建,按运行准备配置所选示例:
npm ci
npm run install:cli
scievolve workflow validate example/kosmos/workflow.json
scievolve start example/kosmos/workflow.json example/kosmos/research_proposal.txt \
--data-dir /absolute/run-data --workspace /absolute/task \
--gateway-bindings /absolute/bindings.jsonworkspace 使用已有任务目录,dataDir 保存运行状态,两者分开且互不包含。Git-off 示例共享 workspace;Git-on 示例使用隔离 worktree 和 PR 集成。后续继续任务使用 run resume。数据、评测环境和服务是否就绪,应在启动前按 RUNTIME.md 核对。
Node API 仍使用 sdk.start({ requirement: ... }) 字段,将 research_proposal.txt 的文本读入该字段即可;此次统一的是示例文件名及内容,不改变 SDK 接口。Python 依赖文件 requirements.txt 保持其原有用途。
research_proposal.txt:具体研究课题、假设、数据和评估方案。workflow.json:角色、模型、编排和工具配置。- RUNTIME.md:环境变量、资源前提及各示例的运行准备。
skills/:执行协议、脚本、上游实现、许可证及逐文件校验清单;复制示例时需整体携带。SOURCES.json:项目或共用方法的固定来源。requirements.txt、tests/:需要额外 Python 依赖和本地验收的项目提供。
共用来源见 SOURCES.json,原子工具合同见 BACKEND-CONTRACT.md,方法核对记录见 历史报告。历史报告保留当时的配置与执行记录,当前研究输入以本目录为准。