这个工具提供了哪些能力
点开任一能力,看清怎么用
每个能力展开后是三件事:它会给你什么、你需要准备什么、哪些必须由你把关。
常见场景:研究周期长、需要多轮实验和写作且希望中间状态不丢失;想在同一个项目中切换不同Agent(Claude/Codex/Kimi)执行不同阶段;需要从持久状态重建研究全景图以决定下一步方向;希望把命令执行、记忆、实验证据和图谱分别持久化治理
让助手在你的项目范围内运行命令并全程留痕:跑了什么命令、在哪个目录、进程状态和输出日志都存档保存,实验跑得再久、中途断了也能接着查、接着调。
它会给你什么
- 这次运行的基本信息,比如命令、目录和运行状态。
- 完整的运行输出和报错日志。
- 一份精简的运行结果摘要。
你需要准备
- 要执行的命令。
- 项目根目录或当前工作区根目录。
- 命令在哪个子目录下运行。
由你把关
- 装依赖、下数据、长时间训练这类操作是否允许,由你决定。
- 是否允许它动用显卡或访问网络,由你决定。
- 命令失败后要不要让它继续自动修复,由你决定。
它维护一份基准测试清单:自动发现可用的测试项目,整理好各自的论文出处、下载地址、硬件要求和风险提示,并记录你本机装了哪些,让你和助手一眼看出哪些能装、哪些适合你的设备。
它会给你什么
- 整理好的基准测试条目列表。
- 格式有问题的条目,会单独标出来。
- 可用的筛选条件,方便按需求挑测试。
你需要准备
- 仓库里的基准测试清单文件。
- 可选:中文版的清单文件。
- 你设备的硬件信息,用来判断装不装得动。
由你把关
- 要不要下载安装这些基准测试,由你决定。
- 你的设备跑不跑得动,由你核对。
- 带风险标记的项目要不要推荐使用,由你决定。
让你在不同地方(网页、终端、聊天软件)都能与同一个研究项目对话:消息发进来会统一处理,助手有回复或进展时会自动转达给你绑定的聊天软件。
它会给你什么
- 绑定成功的对话记录。
- 转发到外部聊天软件的消息内容。
- 一段提示信息,告诉助手当前消息来自哪个渠道。
你需要准备
- 对话的编号。
- 要接入的聊天渠道配置。
- 已经绑定到这个项目的对话列表。
由你把关
- 要不要绑定外部聊天渠道,由你决定。
- 哪些消息允许发到外面去,由你决定。
- 聊天渠道连不上时,是停下项目还是继续本地执行,由你决定。
给助手配了一套工具箱,它不用看懂整个系统的内部实现,就能记笔记、存证据、查项目全局状态、开新分支、提交研究想法和执行命令,像员工使用公司系统一样按规程操作。
它会给你什么
- 写好的记忆卡片,帮助手跨轮次记住要点。
- 研究产物的登记记录。
- 记入证据图谱的一条证据。
你需要准备
- 项目根目录。
- 要用哪一类工具,比如记忆、档案或命令。
- 助手调用工具时带的参数。
由你把关
- 当前阶段允许助手用哪些工具,由你决定。
- 哪些产物可以给你或外部渠道看到,由你决定。
- 要不要允许它执行高风险命令,由你决定。
助手每动手一步之前,它先把该给的信息都凑齐:项目状态、当前阶段该用的方法、之前的记忆和最近的对话,打包成一份完整的指令交给助手执行,保证每一步都建立在对项目的完整了解上。
它会给你什么
- 这一轮交给助手的完整指令。
- 同一份指令在项目内的存档副本。
- 指令的历史版本备份。
你需要准备
- 项目当前的状态快照。
- 当前的工作锚点和这一步要用的技能。
- 运行配置和外部渠道配置。
由你把关
- 当前阶段用的方法对不对,由你核对。
- 要发到外部渠道的内容是否合适,由你核对。
- 要不要切换工作模式或工作锚点,由你决定。
把项目里所有研究线索画成一张地图:每个分支试到哪一步、最新的想法是什么、实验结果如何、离能写论文还差什么,一打开就能看全貌,方便决定下一步走哪条路。
它会给你什么
- 每个分支的进展摘要。
- 当前运行状态的引用信息。
- 整张研究地图的数据,界面上直接展示。
你需要准备
- 研究进展状态记录。
- 各研究分支的数据。
- 各个研究想法的档案。
由你把关
- 接下来是继续当前工作区还是转到主线研究,由你决定。
- 分析是不是做完了,由你核对。
- 主要结果够不够支撑开始写论文,由你核对。
第一次这样开始
把仓库地址直接交给 AI
先让 AI 说明环境和风险,再完成最小安装验证。开始前想清楚要用哪个能力、把对应材料备在手边——每张能力卡展开后有具体清单。
第一次直接复制
帮我安装这个库:https://github.com/ResearAI/DeepScientist 安装前先告诉我需要什么环境,安装后帮我跑通一个最小示例。
别这样用
这些判断,仍然由你负责
- 把启动契约创建成功视同研究已经完成
- 在Runner连续失败时仍自动重试而不检查失败指纹
- 把UI画布显示的状态当作真相而不是从持久数据重建的视图
技术依据
查看能力拆解、验证范围与来源
技术依据
查看能力拆解、验证范围与来源
处理机制
- 01
Quest持久状态对象链
DeepScientist 的多张能力卡共享一条状态对象链:用户启动契约先进入 Quest 仓库,之后 prompt、runner、MCP、bash、memory、artifact、research map 和 connector 都围绕这个 Quest 读写状态。本机制卡说明对象如何传递,以及哪些状态不能被混为一谈。
- 02
三层控制面与工具边界
DeepScientist 把科研运行拆成三层控制面:启动和阶段控制面决定任务边界,runner 和 prompt 控制面决定单轮 agent 行为,MCP 工具控制面决定能写哪些状态和执行哪些命令。本机制卡说明三层边界如何相互约束。
- 03
失败治理栈与doctor诊断
deepscientist 如何在 turn 之间与 runner 之外,治理失败分类、崩溃循环、僵尸状态、环境健康与运行可观测。这张卡补充 deepscientist-能力-多Runner执行调度与失败恢复 只覆盖单 turn 内 retry 的缺口。
已核对范围
- 读取 BashExecService 和 MCP bashexec 工具入口
- 静态确认 quest-local session storage、cwd 限制、meta、monitor process 和 startsession
- 读取 BenchStore YAML reference 和 BenchStoreService
- 静态确认 catalog 扫描、locale replacement、entry normalizer、compatibility、installstate 和 install root
- 读取 connector runtime、channel registry、builtins、daemon connector relay 和 prompt surface context
- 静态确认 conversationid 规范化、channel 注册、bound target 选择和 outbound payload 字段
- 读取 MCP server、memory service、artifact 工具和 docs memory guide
- 静态确认 memory、artifact、bashexec 三个内置命名空间及若干 Quest 状态工具
仍待核对
- 未启动真实 shell session
- 未验证长命令、交互命令和进程清理
- 未验证不同平台 shell 行为
- 未下载任何 benchmark
- 未运行 BenchStore UI 或安装流程
- 未验证硬件推荐排序效果
- 未连接任何真实 QQ、Weixin、Telegram、Discord、Slack、Feishu、WhatsApp 或 Lingzhu
- 未验证外部平台鉴权、回调和消息格式
读取版本
3aaab17244f981fc72522180717f2867fdc95b61许可
Apache-2.0
最近核对
内容 2026-06-16
Stars 2026-07-11
相关文章
具备相关能力的其他库
相关课程
把单项工具放进完整研究设计流程
课程一从研究问题、文献判断、理论假设和方法骨架继续推进,帮助你建立可以复用的研究设计档案。