Agent-Body

为 DeepSeek Harness 按意图加载工具,并加入记忆、反射与故障恢复闭环。

Star 数
★ 15
最近更新
5 天前
License
MIT
主语言
TypeScript

30 秒速览

运行形态
命令行工具Agent 插件 / 技能开发框架
可在哪里用
平台专用
费用
免费,无需付费服务
上手难度
中 · 需要几步配置
开始前需要
DeepSeek HarnessNode.js 22.19 或 24PowerShell 7(文档所述 Windows 路径)Shell / 命令行网络访问本地文件系统
典型场景
已运行 DeepSeek Harness、但工具数量持续增长,希望只向模型暴露当前任务所需模式的团队。
不适合
  • 未使用 DeepSeek Harness 的团队
  • 需要稳定第三方 API 或 SLA 的生产团队
  • 要求 Linux/macOS 与 Windows 同等成熟的用户

这个 Agent 能做什么,适合哪些场景?

Agent-Body 是 DeepSeek Harness 的插件层,不是可独立部署的通用智能体框架。它由 organism 内核、Cortex 记忆器官、Zero-residence 上下文引擎及一组可选器官插件组成,通过 nerve bus、heartbeat 和确定性规则把命令路由到相应能力。其冷启动基准在 48 条代表性命令上,将平均工具模式估算量从 55,154 个 token 降至 8,433 个,即门控掉 84.71%;该数字仅涵盖工具模式,不代表整个提示词或费用。系统还记录执行结果、强化或衰减路由权重、归因失败、选择补救方式,并在空闲时以确定性规则整理长期记忆。核心演示和检查可在没有宿主、网络、模型或 API 密钥的情况下运行,但实际挂载器官和使用 body_* 接口需要 DeepSeek Harness;项目处于早期阶段并以 Windows 为主要开发环境。

命令进入后,agent/pre-step 将文本转换为 nerve impulse,body_nerve 根据确定性意图规则选出器官及其具体能力,并通过 organism/impulse 分发。器官执行后,系统从 tools/result 学习路由:成功会增强“命令类别→器官”的 synapse,失败会减弱权重。body_heal 将错误归因为 tool_missing、arg_error、permission、timeout、network、not_found、conflict 或 unknown,再按规则给出处理方案;arg_error 不会自动重试,伤口只有在同一器官后续成功时才关闭。Heartbeat 把指令、状态和稳态告警写入 bloodstream.json 并广播 organism/heartbeat;Cortex 在深度睡眠期间从执行记录生成 pitfall、playbook、hotspot、unresolved 或 fact 记忆卡。Zero-residence 提供 zr_compact、zr_recall、zr_ledger 和 zr_fast,以指针替换常驻内容、从会话日志逐字恢复内容并统计上下文成本。body_status、body_map、body_cell、body_pulse 和 body_tokens 分别输出运行状态、器官映射、能力单元、事件流与工具模式 token 数据。

  1. 已运行 DeepSeek Harness、但工具数量持续增长,希望只向模型暴露当前任务所需模式的团队。
  2. 需要在离线、无模型调用条件下复现命令路由、故障归因和反射链的框架维护者。
  3. 希望跨会话保存结果,并在空闲时以确定性规则整理长期记忆的本地智能体用户。
  4. 需要区分参数错误、权限、超时、网络等原因,避免无效自动重试的自动化团队。
  5. 准备为 DeepSeek Harness 编写自定义器官,并用 defineOrgan 声明能力、权限、信号和回退关系的插件作者。

如何安装或部署这个 Agent?

若只想验证核心流程,需要 Git 和 Node.js 22.19 或 24;不需要 npm install、模型或 API 密钥。

git clone https://github.com/1420079678-ctrl/agent-body && cd agent-body
npm run demo
npm run check

实际使用需要先有可运行的 DeepSeek Harness。下面的受支持命令从最新 GitHub Release 安装 organism、Cortex 和 Zero-residence 包,然后需要重启 Harness:

rel=https://github.com/1420079678-ctrl/agent-body/releases/latest/download
dsh plugin --profile web add \
  "$rel/dsh-external-dsh-organism-0.1.1.tgz" \
  "$rel/dsh-external-dsh-cortex-0.1.1.tgz" \
  "$rel/dsh-external-dsh-zero-residence-0.1.0.tgz"

若 GitHub 的下载跳转被网络阻断,可使用文档提供的 jsDelivr 路径:

rel=https://cdn.jsdelivr.net/gh/1420079678-ctrl/[email protected]/dist
dsh plugin --profile web add \
  "$rel/dsh-external-dsh-organism-0.1.1.tgz" \
  "$rel/dsh-external-dsh-cortex-0.1.1.tgz" \
  "$rel/dsh-external-dsh-zero-residence-0.1.0.tgz"

这些包尚未发布到 npm registry。部分器官依赖编译器、浏览器或外部二进制,需要从源码使用各自的 replay 脚本安装。文档未给出 DeepSeek Harness 本身所需的模型凭据,因此不能从本资料确定宿主凭据要求。

如何使用这个 Agent?

离线验证可分别运行端到端演示、完整检查和 token 基准:

npm run demo
npm run check
npm run bench
npm run bench:check

安装插件并重启 DeepSeek Harness 后,先检查器官状态和能力归属,再发送一条仅做路由的命令:

body_status
body_map
body_nerve action=send text="抓取这个站点并抽取结构化数据"

body_status 显示器官、心跳、疲劳和完整性;body_map 显示能力归属;body_nerve 返回应被激活的器官及能力。需要门控列表外的能力时,可通过 body_call 再取一次。运行 npm run verify 可检查仓库结构、JSON、链接和敏感信息;npm run verify:organs 会运行器官回归测试,在缺少宿主运行时时明确报告 SKIP。

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

优点
  • 工具模式门控有仓库内可复现基准:冷启动下 48 条命令平均从 55,154 降到 8,433 个估算 token,并由 bench:check 检测漂移。
  • 路由、失败归因、反射执行和睡眠期记忆整理采用确定性规则,核心验证无需模型调用或 API 密钥。
  • 恢复逻辑按具体原因处理,参数错误不会盲目重试,伤口必须由同一器官后续成功才能关闭。
  • 器官通过 defineOrgan 声明能力、权限、信号、可处理故障和 fallback,且内核不依赖单个器官。
  • 运行状态、伤口、synapse、记忆卡和 pulse stream 均以可检查数据呈现。
局限
  • 核心运行绑定 DeepSeek Harness;未使用该宿主时只能运行离线核心演示,不能直接当作完整智能体部署。
  • 项目明确标注为早期、Windows-first,Linux/macOS 只对零依赖核心有较充分 CI 覆盖,器官路径测试较少。
  • 工具模式节省比例会随历史和热器官增加而下降:文档中的真实运行测量为 58%,不能把 84.71% 当作长期固定值。
  • 48 条基准命令中有 10 条需要通过 body_call 再取能力,较大的器官还受每器官 10 项能力上限影响。
  • 24 个插件包中只有 5 个拥有离线回归套件,其余主要依靠 replay 脚本,跨环境证据有限。
  • 插件包尚未发布至 npm registry,部分器官还需要宿主工具链、浏览器、编译器或外部二进制。

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

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

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Agent-Body 当前 78 · 表现良好 命令行工具免费 ★ 15 5 天前 TypeScript —
Auto Company 自主 AI 公司 70 · 存在缺口 命令行工具免费 + 模型费 ★ 3.1k 2 天前 Python Codex · Claude Code
Hive 智能体运行框架 46 · 缺口较多 命令行工具免费 + 模型费 ★ 11k 21 天前 Python OpenAI API · Claude API
ANOLISA 智能体运行层 45 · 缺口较多 命令行工具免费 + 模型费 ★ 657 今天 Rust —

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
表现良好
78/ 100 五分制 3.9 / 5
信任安全 19/29
可靠稳定 11/14
适用触发 15/18
规范维护 16/18
有效结果 10/13
证据核验 7/8
查看各维度的扣分理由
信任安全19 / 29 · 3.3/5

信任:源码说明只读补救可自动执行、有副作用的补救等待模型裁决,CI 工作流也只授予 contents:read;安全策略明确本地 GUI 可读文件、执行命令和加载插件,并警告插件继承宿主权限。这足以支持普通场景下的权限与确认控制,但未展示细粒度沙箱、逐项授权或完整撤销机制,因此 least_privilege、user_confirmation、external_effects 和 rollback 未给满分。数据流、心跳文件、会话恢复、凭据位置及遥测/日志泄漏风险说明具体,data_flow_transparency 可给满分;敏感数据主要依靠 .gitignore、校验和操作规范,缺少加密、脱敏或密钥隔离证据,故 sensitive_data_handling 为 2。依赖要求有说明,但深度回归从宿主 main 安装依赖,Actions 使用浮动主版本标签,且材料未展示依赖审计、锁文件或漏洞扫描,dependency_security 仅为 1。MIT 版权主体、仓库地址、问题与私密漏洞通道均明确,但维护者只是未验证的账号且责任主体有限,source_attribution 为 2;未知身份本身不作负面推断。

可靠稳定11 / 14 · 3.9/5

可靠性:README、脚本和工作流大体形成一致的离线演示、测试、基准与失败归因体系,失败分类、禁止错误参数重试、慢性伤口终止条件及安装故障症状都很具体,因此 failure_messages 为 3。材料也主动区分冷启动与带历史数据、256 与 332 能力等口径;但 package.json 为 0.1.0,README 同时出现 v0.1.1 和 v0.1.2,且裸克隆会跳过真实内核 parity,故 self_consistency 扣至 2。Node、DeepSeek Harness、Windows 优先、未发布 npm、GitHub/CDN/离线包路径均有交代,不过插件回归依赖另行安装宿主且仅手动运行,dependency_availability 为 2。静态审查不把未执行测试当成失败,也不采信其运行结果。

适用触发15 / 18 · 4.2/5

适应性:文档覆盖无宿主演示、现有 Harness 用户、离线安装、插件作者以及不适用场景,并清楚界定本地单用户、Windows 优先、Node 版本、宿主依赖和工具模式,因此 audience_and_scenarios 与 capability_boundaries 给满分。确定性意图路由、能力上限和 body_call 后备路径说明充分,但基准自述 48 条命令中有 10 条需要第二跳,且存在 capped 与 unrouted 情形,所以 trigger_precision 为 2。项目提供 Windows/Linux 安装命令、双平台仓库检查和离线包,但完整深度回归限定 Windows 且必须结合 DeepSeek Harness,environment_fit 为 2。

规范维护16 / 18 · 4.4/5

规范性:README 的目录、架构、目录布局入口、目录生成检查、快速开始、SDK、演示、FAQ 和限制披露非常完整,故 information_architecture、install_notes、examples_and_faq、known_limitations 均为 3。MIT 元数据与完整许可证一致,license 为 3。生物隐喻均映射到具体组件,但 organ 数、包数、能力数以及项目/包版本存在多套口径,需要读者细辨,naming_stability 为 2。README 提供发布说明和路线图入口,但所给材料没有完整变更日志,且 package 版本与安装资产版本不齐,versioning_changelog 为 2。问题渠道、安全报告时限、支持分支和一人维护事实明确,但没有已验证组织、明确维护团队或长期接替安排,maintenance_responsibility 为 2。

有效结果10 / 13 · 3.8/5

有效性:该框架把路由、模式门控、失败归因、记忆整合和反射机制组合为可操作工具,并提供状态、调用、恢复及检查命令;相对普通工具堆叠具有明确新增价值,因此 marginal_value 为 3。输出和安装流程对目标用户可用,但大量生物术语、宿主集成要求以及二次 body_call 会增加理解与操作成本,output_usability 为 2。文档量化了工具模式 token 节省并诚实披露冷启动 84.71%、带历史 58% 和 10/48 第二跳的代价,不过材料不能证明总体提示、延迟、费用或维护开销的净收益,cost_benefit 为 2。

证据核验7 / 8 · 4.4/5

可验证性:核心声明指向具体命令、基准报告、冻结语料、原始捕获、生成脚本、常量/目录同步检查和 CI 失败条件,并明确限定 84.71% 只针对冷启动工具模式块,claim_traceability 为 3。README、package 脚本、工作流和样例单元测试从多个仓库文件相互支撑,但关键 REPORT、实现源码、锁文件及捕获内容未包含在本次材料中,外部目录列表也不能证明性能结论,因此 cross_source_corroboration 为 2。文档清楚区分可复现基准、开发安装观测、历史快照、估算值和实际使用警告,fact_inference_separation 为 3;本评估未执行任何命令。

风险与缓解建议
  • 本地 Web GUI 无认证且具备读文件、执行命令和加载插件的能力;务必保持仅绑定 127.0.0.1,不要经反向代理或端口转发暴露。
  • 插件以 Harness 权限运行。安装或启用新 organ 前应审查源码,并使用有限额度、按提供商隔离的密钥。
  • 不要把 84.71% 解读为总提示 token、账单或实际长期运行节省;文档给出的带历史观测仅为 58%,且 10/48 命令需要第二跳。
  • 深度 organ 回归是手动工作流并依赖 DeepSeek Harness main;发布前应在固定宿主版本上运行,同时补充锁定依赖和漏洞审计。
  • 核对 0.1.0、v0.1.1 与 v0.1.2 的版本关系及 tarball 组合,避免安装不兼容资产。
证据充分度:低 评估于 2026年10月5日 审查版本 9403444d87d5
查看完整评分方法 →

常见问题

必须安装 DeepSeek Harness 才能试用吗?
不必。npm run demo 和 npm run check 可在新克隆上离线运行,不需要宿主、网络、模型、API 密钥或 npm install;但实际挂载器官和使用 body_* 能力需要 DeepSeek Harness。
84.7% 是否表示整个提示词或账单减少 84.7%?
不是。84.71% 只针对冷启动时工具名称、描述和 JSON Schema 构成的工具模式块。带真实历史的开发安装测得节省为 58%,且部分能力需要第二次 body_call。
工具失败后会自动反复重试吗?
不会统一重试。系统先归因,再按处方处理;arg_error 明确禁止自动重试,具有副作用的补救还要等待上层决策,超过 5 分钟仍未关闭的伤口会标为 chronic。
运行数据存在哪里?
vitals、synapses、memory cards 和 pulse stream 位于 Harness 的数据目录,不写入仓库。Harness GUI 绑定 127.0.0.1,项目明确警告不要将其暴露到公网或置于公开反向代理之后。
所有器官都能一条命令安装吗?
不能。十个自包含器官提供预构建 tarball;其他器官需要宿主侧编译器、浏览器或外部二进制,并使用相应 replay 脚本安装。
在 GitHub 查看 ↗ 安装 ↓

相关 Agents