2.5.11 jcode

复杂资料研究任务需要在本地环境中运行智能体，调用受控工具、保存会话、压缩上下文、复用记忆、并行拆分任务，并把每一步都留痕。

业务需求代理式研究运行时

架构位置作为资料研究任务服务和智能体工作台的运行时参照，位于检索服务、工具服务和应用工作台之上，不替代 SVN、文档治理、标签库或检索引擎

落地阶段二期后段到三期验

DeepWiki 中文译文子页

jcode 的 DeepWiki 中文译文入口

复杂资料研究任务需要受控工具、会话保存、上下文压缩、记忆复用、并行拆分和过程留痕。

54/54 页中文译文译文覆盖完整界面与交互、接口与服务契约、测试、发布与运维

复杂资料研究任务需要在本地环境中运行智能体，调用受控工具、保存会话、压缩上下文、复用记忆、并行拆分任务，并把每一步都留痕。

本页从 jcode 中拆出问题解决方式、对象边界、关键机制和可迁移设计，避免“看过一个开源项目”停留在名词层面。

作为资料研究任务服务和智能体工作台的运行时参照，位于检索服务、工具服务和应用工作台之上，不替代 SVN、文档治理、标签库或检索引擎。

落地判断

如果该项目能力进入本项目，必须先回答三件事：是否保留现有事实源，是否能继承权限，是否能把每个结论回到来源证据。

对象	作用	本项目映射
智能体`Agent`	单个研究会话的状态机，负责编排模型调用、工具执行、记忆注入和会话持久化。	`research_agents`
会话`Session`	保存消息、模型、提供商、环境快照、压缩状态和记忆注入记录。	`research_sessions`
工具注册表`Tool Registry`	统一管理内置工具、项目工具和动态 MCP 工具。	`tool_registry`
模型提供商`Provider`	抽象不同模型、账号、上下文窗口、压缩能力和使用量。	`model_providers`
记忆`Memory Graph`	通过语义向量、标签、聚类和关系召回历史经验。	`project_memory_graph`
多智能体协作`Swarm`	协调多个代理并行处理不同范围，并通过消息和状态汇总结果。	`research_swarms`
安全审批`Safety System`	把后台动作分为可自动执行和需要人工确认，形成审批与通知链路。	`approval_queue`

图 2.5.11 · jcode 主流程与数据流。

机制	拆解说明
单服务器多客户端	一个后台服务管理多个研究会话，客户端可连接、断开、重连，长任务不依赖单个窗口存活。
工具化研究	代理不能绕过运行时直接读写生产数据，只能调用白名单工具并留下输入输出。
会话持久化	研究过程、工具事件、模型选择、环境快照和中间结论都能恢复和审计。
上下文压缩	长任务用阶段摘要、证据摘要和待确认问题控制上下文窗口。
记忆分层	用户偏好、项目摘要、已确认事实、待核验假设分开存放，避免模型猜测污染事实库。
多智能体协作	把复杂问题拆成检索、抽取、校验、报告代理并行执行，由协调器合并可核验证据。
安全审批	读取和分析可自动执行；写库、批量改标签、外发报告、变更权限必须人工确认。

本项目设计点	落地说明
研究任务服务	统一管理长任务、会话恢复、工具调用、模型选择、费用和状态。
资料工具注册表	注册检索、原文获取、字段抽取、版本比对、缺件检查、权限解释等工具。
证据日志	保存查询、过滤条件、工具输入输出、引用片段、模型版本和最终答案。
研究记忆	只保存用户偏好、项目摘要、已确认事实和审核过的工作经验。
多代理研究台	复杂问题按资料域或任务类型拆分代理，最终合并带证据结论。
审批队列	任何写库、外发、批量修改、权限变更都进入人工确认。

术语显示规则