DeepSeek Harness 与 AgentScope Java 深度对比：两条不同的 Agent 工程化路线
内容提要
DeepSeek Harness与AgentScope Java是两条不同的Agent工程化路线。前者是TypeScript编写的可组合运行时内核，强调插件树、事件溯源和精确回放，适合构建Coding Agent产品；后者是Java企业框架，侧重多租户、分布式恢复和治理，适合融入现有企业系统。选型取决于需求：造Runtime选前者，企业运营选后者。
延伸解读
选型前先看团队技术栈
文章指出，DeepSeek Harness 基于 TypeScript/Node.js，而 AgentScope Java 基于 Java 17/Spring Boot。如果团队主要使用 Java 生态，AgentScope Java 更容易融入现有系统；如果团队更熟悉 TypeScript 或需要构建前端相关的 Coding Agent，DeepSeek Harness 可能更合适。技术栈的匹配度直接影响开发效率和维护成本。
状态管理哲学差异
DeepSeek Harness 采用事件溯源，以 append-only 事件日志为唯一事实来源，强调可重放、可审计和可 fork；AgentScope Java 则通过 AgentStateStore 和 RuntimeContext 管理状态，强调跨请求恢复和多租户隔离。选择时需考虑你的应用更看重过程保真还是服务架构的灵活性。
警惕成熟度与运维成本
DeepSeek Harness 仍处于 Developer Preview（0.1.0-rc.8），Session 格式无兼容承诺，存在破坏性变更风险；AgentScope Java 2.0 已 GA，但 Service 层带来更重的部署和运维负担。如果只是验证小型功能，两者都可能过重，简单 SDK 可能更合适。
Q&A
DeepSeek Harness 和 AgentScope Java 的核心定位分别是什么？
DeepSeek Harness 是一个可组合的 Agent 运行时内核，用 TypeScript 编写，强调插件树、事件溯源和精确回放，适合构建 Coding Agent 产品；AgentScope Java 是一个 Java 企业框架，侧重多租户、分布式恢复和治理，适合融入现有企业系统。
DeepSeek Harness 的“一切皆插件”设计带来了哪些核心能力？
它带来了三个核心能力：1) 运行时能力可以真正替换，如模型、文件系统、Shell 等都可以作为 provider 替换；2) 插件卸载和热更新是架构能力，可以动态卸载、替换、重新挂载插件，避免失效引用和脏状态；3) 扩展行为主要通过事件进入，而不是修改主循环，工具执行有完整的流水线（pre-execute、execute、post-execute 等）。
DeepSeek Harness 如何通过事件日志保证会话的可恢复性和一致性？
DeepSeek Harness 将会话建模为只追加的事件日志，所有关键事件（如 turn/start、step/start、用户消息、模型输出、工具调用等）都会记录。模型上下文通过 deriveMessages() 从日志投影，UI 展示和持久化也基于同一事件流，从而避免状态漂移。崩溃恢复时，如果发现未完成的 turn，会补上 interrupted 事件，保留中断前的事实。
DeepSeek Harness 的 Code Mode 是什么？它有什么优缺点？
Code Mode 是 DeepSeek Harness 的一项能力，它只向模型暴露一个 run_code 入口和自动生成的 SDK，让模型在临时程序中调用工具，中间结果留在局部，只有 return 或 console.log 的内容回到模型上下文。优点是减少 Token 占用、支持显式并发和结构化返回值；缺点是每次运行都是全新状态，不是持久 REPL，中间值不能重建，且没有统一字节上限。
AgentScope Java 的三层架构（Core、Harness、Service）分别负责什么？
agentscope-core 提供模型、消息、工具、事件和 ReActAgent；agentscope-harness 在 Core 之上叠加工作区、记忆、压缩、技能、子 Agent、沙箱等能力；agentscope-service 提供 Agent 注册、Session 管理、团队编排、Dashboard 和分布式控制面。
在工具并发执行方面，DeepSeek Harness 和 AgentScope Java 有什么不同？
DeepSeek Harness 在调用级动态分类，每个调用根据 executionMode 分为 parallel 或 exclusive，可以针对同一工具的不同参数判断是否安全并发；AgentScope Java 默认并行，工具通过 concurrencySafe 标记是否安全，是工具定义级标记，表达力不如 DeepSeek Harness 精细。
DeepSeek Harness 和 AgentScope Java 在沙箱隔离方面有何不同？
DeepSeek Harness 的本地沙箱更贴近开发者桌面，使用 bubblewrap/Landlock、Seatbelt、ACL 等，强调同一宿主内的文件写入边界，并 fail closed；远端执行通过替换文件系统和进程 provider 实现。AgentScope Java 的沙箱更偏服务部署，支持 Docker、Kubernetes、Daytona、E2B 等，考虑按用户/会话/Agent 隔离、快照恢复、分布式锁等。
根据文章，什么情况下应该选择 DeepSeek Harness，什么情况下选择 AgentScope Java？
如果目标是做 Coding Agent、IDE Agent 或桌面 Agent，需要替换模型、文件系统、Shell 等，强调回放、fork、恢复和过程保真，或需要插件市场、动态装卸，应选 DeepSeek Harness。如果企业系统基于 Java/Spring Boot，需要多租户、分布式恢复、长期记忆、治理和统一控制面，应选 AgentScope Java。
