XScientist

这个 Agent 能做什么，适合哪些场景？

XScientist 是一个本地优先的自主科研系统与开放科学协议，以 CLI（xscientist 命令）和 Python SDK 提供。它把问题框架、假设、决策、实验尝试、证据、异议与门槛外化为带内容哈希的typed对象，并通过类似 Git 的 Research VCS 进行 commit、diff、branch、revert 等操作。它支持无模型、无 API key 的纯本地起步（explore 命令），也支持 Ollama 本地模型及 OpenAI、Anthropic、智谱、Bedrock、Vertex 等 OpenAI 兼容服务。生成的实验代码必须通过配置好的 Docker 隔离执行器运行，自主运行可设置 --max-cost-usd 成本上限。完成的运行只有在 trace、replay、verify 三级审计门槛真正通过后才被视为已验证的科学主张，否则一律标注为探索性或草稿状态。当前发布版本为 0.1.4（PyPI），main 分支还包含未发布的协议工作，需源码安装并固定 commit 以保证可复现性。

用户通过 xscientist explore 用自然语言录入想法、预期观察、反证条件与首个测试，系统生成可证伪假设并将其版本化为 idea saved / falsifiable / planned 状态。xscientist start 启动自主研究：提出竞争假设与零假设、按预期信息价值排序实验、在 Docker 隔离执行器中运行有界实验并保留失败与否定结果、扫描异常与矛盾、运行独立评审角色并在硬门槛处停止。xscientist record、research decide、research experiment 把结果写成带内容哈希的不可变证据对象并提交检查点；history list/diff/rollback 与 audit --level trace/replay/verify 提供审查与复现。provider list/test/explain 管理模型与凭证来源；research bundle/export/fsck、benchmark autoresearch、research opportunity（FAR 启发的机会漏斗）、research belief（信念上下文投影）等命令提供深度协议接口。

1. 没有模型或 API key 的研究者想先把一个想法记录为可证伪、有版本历史的研究起点（explore，零成本）
2. 想用本地 Ollama 模型（如 gemma3）零托管成本跑端到端自主研究用户
3. 有 hosted API key、想以 --autopilot publication --max-cost-usd 10 走面向论文工作流的研究者
4. 需要展示完整但存在争议的证据历史的教师或评审者（$0.00 的 demo 命令）
5. 希望把文献方向筛选到候选池、尝试、独立评审与资源分配全程留痕的科研团队（机会漏斗命令）
6. 需要在 CI/脚本中显式指定问题、provider、模型与预算的非交互式自动化场景

如何安装或部署这个 Agent？

发布版 0.1.4 需要 Python 3.10+ 与 Git，安装 PyPI 包：

python -m pip install "xscientist==0.1.4"

如需 main 分支未发布的协议功能，需源码安装，并为可复现研究固定具体 commit：

python -m pip install "xscientist @ git+https://github.com/smileformylove/XScientist.git@main"

使用模型功能时安装对应 extra，例如本地 Ollama：

python -m pip install \
  "xscientist[research,openai-compatible] @ git+https://github.com/smileformylove/XScientist.git@main"

或 hosted 服务（可选 extra：openai、anthropic、zhipu、bedrock、vertex、openai-compatible）：

python -m pip install \
  "xscientist[research,openai] @ git+https://github.com/smileformylove/XScientist.git@main"
export OPENAI_API_KEY="..."

模型驱动的实验还需要 Docker。

如何使用这个 Agent？

零成本起步（无模型、无 key、无网络调用）：

xscientist explore ./my-study
xscientist status ./my-study

或脚本化录入想法：

xscientist explore ./my-study \
  --idea "Does daily walking improve sleep quality?" \
  --expect "Daily walking improves a preregistered sleep score." \
  --disprove "The score is unchanged or worse." \
  --test "Compare walking and usual-activity periods." \
  --non-interactive

查看 $0.00 的完整争议证据历史演示：

xscientist demo ./first-study --autopilot --open
xscientist status ./first-study

使用本地 Ollama 模型：

ollama pull gemma3
ollama ls
xscientist provider list
xscientist start ./my-study --prepare-only
xscientist start ./my-study

使用 hosted 模型并设置成本上限：

xscientist start ./hosted-study --prepare-only
xscientist start ./hosted-study --max-cost-usd 10

模型实验需准备隔离执行器并检查就绪状态：

xscientist executor prepare --workspace ./ood-study
xscientist provider check --workspace ./ood-study --max-cost-usd 10
xscientist doctor --workspace ./ood-study --deep

审查与复现：

xscientist history list ./first-study
xscientist history diff ./first-study
xscientist audit ./first-study --level trace
xscientist audit ./first-study --level replay
xscientist audit ./first-study --level verify

后台长任务：

xscientist runs list --workspace ./ood-study
xscientist runs watch RUN_ID --workspace ./ood-study

若 GLM-5.3 作为执行模型，必须另配 --judgment-model（如 openai/gpt-4.1）承担科学判断角色，否则 start 会失败并给出恢复命令。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. v0.1.2 2026-08-17
   发布说明摘录

   [0.1.2] - 2026-08-17 Added - A one-command, provider-free xscientist demo that creates a deterministic Research VCS history with a failed attempt, supporting and refuting evidence, an independent rejection, a contested claim, and an offline DAG for $0. - A compact, read-only xscientist status view for scientific progress, automated run state, budget use, results, the evidence DAG, and the next valid action. - xscientist provider check now reports credential presence, client availability, live-verification scope, and optional cost-enforcement …

   在 GitHub 查看 ↗
2. v0.1.1 2026-08-08
   发布说明摘录

   [0.1.1] - 2026-08-08 Added - Unified xscientist setup, doctor, and capability commands with task-aware readiness checks and exact opt-in installation guidance. - Deterministic xscientist research decide policy for checkpoint, fork, merge, hold, and release transitions, including stable decision identifiers and explicit trace requirements. - Payload-free long-term research technology trees spanning every local research line, with topology, frontier, cycle, and missing-reference views. - Stable scientific merge-conflict identifiers, actionable resolution …

   在 GitHub 查看 ↗
3. v0.1.0 2026-08-06
   发布说明摘录

   0.1.0 - 2026-08-06 Added - Installable xscientist Python package, public CLI, SDK, and optional HTTP service. - Long-running research workflows, structured review/repair artifacts, and ARA protocol tooling. - Cross-version CI coverage for Python 3.10, 3.11, and 3.12. - Branch-aware whole-repository coverage regression checks. - Automated engineering, distribution inventory, isolated wheel, and release metadata checks. - GitHub issue/PR templates, dependency update policy, citation metadata, and an engineering maintenance guide. Changed …

   在 GitHub 查看 ↗

常见问题