通用 Coding Agent 与工作台

Coding Agent：从工作区到交付

2026-09-08 补充。这里用 Coding Agent 解释开放任务执行系统，保留上文 Pi／OpenCode 的历史快照。通用指任务范围较广，不意味着能接管任意业务或天然获得公司权限。

工作区任务为什么需要不同的组织方式

“给网站增加一个可探索的图谱专题”同时涉及资料、内容、数据关系、页面、测试与发布。下一步取决于发现的文件、接口和错误，事先无法列完所有步骤。Coding Agent 可以把代码当作工作对象，也可以用程序处理资料、检查链接和生成产物；是否能完成，仍取决于可用工具、环境、权限及验证标准。

层次	谁负责什么	本例中的对象
用户工作台	接收目标、显示进度、查看改动、接受人工纠正	对话、文件与页面预览
Harness	组织上下文、模型与工具循环，维护会话和停止状态	找文件、编辑、检查、根据反馈修正
模型	根据当前输入理解问题、提出下一步动作或回答	判断哪些章节和组件需要改
工作环境	实际保存文件、运行程序、提供外部服务	知识笔记、网站代码、浏览器、部署目标

工作台不是模型；模型提出工具调用，也不是模型进程亲自执行命令。Harness 与执行环境可以同机或分离，产品界面相似不代表运行拓扑相同。与 业务 Agent Framework 与业务 Harness 的区别在任务组织方式，两者可以组合。

架构一：从目标到建议

用户工作台将目标交给模型，模型生成解释或代码片段。这一步可以帮助理解需求，但代码是否进入正确文件、页面是否能打开，都还没有得到执行证据。图中这一阶段是教学拆解，不是三家产品的真实发行历史。

架构二：形成工作区执行闭环

Harness 接收目标，调用模型；模型提出读取、编辑或执行请求，由工具在允许的环境中执行，再把结果交回模型。工具可运行测试、检查变更和查看页面。失败产生新的观察，循环据此修正或停止。

验证器可以是测试程序、浏览器检查或人工复核。通过已运行的测试，只说明覆盖范围内通过，不能证明所有业务行为正确。固定规则计算仍应复用程序。

架构三：让长任务保持连续

上下文是这一次模型调用实际看到的输入；会话记录是保存的历史事件；工作区保存真实文件和结果。三者不能混为一谈。会话保存下来，不表示每次都全部送入模型；压缩历史可以延长工作，但可能遗漏细节。

机制	解决什么	代价与边界
项目规则与按需检索	找到约定和相关文件	文件可访问不等于内容已进入上下文
会话日志与进度记录	保留动作、观察和下一步	已记录不等于已执行成功
上下文压缩	控制窗口与成本	摘要可能丢失条件，应回源核对
恢复、分叉或交接	延续任务或探索另一方案	恢复对话不会自动恢复所有进程和远端状态
工作区隔离与变更检查	减少并行修改冲突	独立对话不是文件系统隔离

关键依据、验收条件与外部动作结果要能回查。不能把上下文压缩称为模型重新训练，也不能把文件记忆等同于永久正确的知识。

架构四：扩展能力与控制执行

已有循环可以通过方法、工具和程序扩展，成为更完整的工作台。不同产品对 Plugin、Skill、Hook 的命名和装配方式不完全相同，不能只看名字就判断兼容。

名称	通俗理解	不能因此推断什么
项目规则	本项目的工作约定和验收要求	写进提示词不等于程序强制执行
Skill	按需读取的方法说明、资源或脚本	加了 Skill 不等于改了模型权重
MCP	连接外部工具与资源的协议	接通协议不等于已有业务授权
Hook	在指定事件触发处理	是否能阻断操作取决于接口契约
Plugin／Extension	向系统加入或替换能力的程序包	各产品插件不保证互通
子 Agent	将一部分任务交给另一个执行上下文	拆分有沟通成本，仍需检查汇总和文件冲突
权限与沙箱	决定允许什么，并限制实际执行范围	同意操作与技术隔离是两种机制

子 Agent 适合可独立核验的工作，如检查另一组页面；高度依赖同一文件的任务不一定适合并行。任务取消也不保证已经产生的外部副作用自动撤销。

图中扩展和控制是通用职责，不宣称本案例启用了全部能力。当前网站案例没有用三个产品做横向实测，也不以是否使用多 Agent 评价先进程度。

Codex：沿一次任务观察循环

OpenAI 于2026-01-23公开的机制文章，解释了 Codex Harness 怎样组织用户、模型与工具：模型请求动作，工具执行后返回观察，再进入下一次推理；一轮用户任务可以含多次循环。实际产物也可以是环境中的文件变化。

学习重点是初始上下文、工具结果与下一轮输入的联系，以及任务何时停止。产品名 Codex 在这里指工作系统，不能把它与某个同名或相关模型版本混为一谈。

来源：OpenAI · Unrolling the Codex agent loop；2026-09-08读取。本文只据公开机制解释，不把本次工作记录当成全部内部实现的证据。

Claude Code：理解工作区与上下文扩展

官方文档把核心过程说明为收集上下文、采取行动、验证结果；文件、终端与检索工具提供观察和实际操作。项目指令、会话与上下文管理帮助延续任务，Skills、MCP、Hooks 和子 Agent 提供不同扩展入口。

会话历史与本次上下文有区别；自动压缩也可能丢失早期细节。它是观察“长任务怎样继续、哪些方法按需加载”的样本，不意味着这些机制由一家独占。

来源：Claude Code · How Claude Code works；2026-09-08读取，动态文档。具体功能与接口应以所用版本再次核对。

DeepSeek Harness：把系统能力做成插件

2026-09-08读取的官方页面将 DeepSeek Harness 标为开发者预览版。其插件系统基于 Cordis：内核管理插件加载、卸载与依赖，模型、工具、会话、循环、存储、沙箱、调度与界面等能力由插件提供。这里的“插件”可以涉及执行核心，不仅是附加几个工具。

官方还介绍标准、PTC、极简与创造模式。PTC 通过模型生成的程序组合多步工具操作；它改变调用组织方式，不能直接推断一定更快、更便宜或更可靠。运行轨迹便于检查观察与动作，也不能代替结果验证。

来源：DeepSeek Harness 官方说明及其链接的官方源码。本轮仅核验公开说明，未安装或实测 DeepSeek Harness，不主张生产成熟度或性能优势。

技术定位练习：Codex 的循环与上下文

改变工具结果如何进入下一轮推理，主要影响 Harness、Agent Loop、上下文与工具接口；底层模型可能没有变化。证据可以是公开机制、实现和同任务轨迹。端到端效果还取决于模型、工具、环境、预算与验证标准，不能把所有提升归因给 Harness。

变化速读：codex-loop

相对什么、改变哪里： 教学对照：一次模型回答 → 工具执行、观察回填、下一轮推理。机制位置是循环、Harness 与上下文，工具提供实际动作。

对我们可能有什么影响： 工作区任务可以持续探索与修改，并以文件、运行结果等交付；仍需要检查完成标准。

证据与未知： 这是公开机制解读，不是新版本增量；未将效果归因于某个独占机制，也未做产品排名。

技术定位练习：Claude Code 的上下文扩展

按需加载 Skills、子 Agent 独立上下文或历史压缩，首先改变信息组织和任务执行。它们可能减少主上下文负担，也可能遗漏信息或增加协调成本。要看实际输入、调用记录与交付验证，不能把“支持子 Agent”本身当成效果证明。

变化速读：claude-context

相对什么、改变哪里： 教学对照：所有材料和子任务都挤进主上下文 → 按需加载、独立子任务上下文或历史压缩。直接位置是上下文与 Harness，循环和验证需配合。

对我们可能有什么影响： 可以减少主上下文负担，但也可能遗漏信息或增加协调成本；需看实际交付。

证据与未知： 动态文档保留原核验日期；这里不是版本差异清单，不保证扩展越多效果越好。

技术定位练习：DeepSeek 的插件化运行

将循环、工具、存储、模型接口和界面拆成插件，改变的是 Harness 的装配与扩展机制，涉及多个模块；其中新增模型插件并不必然改变模型权重。PTC 还关联工具调用组织。应核对插件依赖、权限与故障行为，并比较固定条件下的任务结果；开发者预览状态需保留。

变化速读：deepseek-plugins

相对什么、改变哪里： 教学对照：能力紧耦合在实现中 → 通过插件装配循环、工具、存储和模型接口等。直接位置是 Harness，工具、平台与上下文需要适配。

对我们可能有什么影响： 便于讨论能力替换和组合；应检查插件依赖、权限、故障行为与维护成本。

证据与未知： 保留2026-09-08开发者预览语境；未安装实测。新增模型接口不必然改变模型权重。

网站案例：范围与证据

案例固定在2026-09-08上一轮“公司知识与系统专题深化”结束时：Codex 协作补充本地知识、公开编排和网站图谱，个人站版本已验证；公司站发布连接超时，仍保留旧版。这里是跨多次操作的教学复盘，不是单次原始轨迹，不含私有路径、凭证或公司原件。后续上线成功也不改写这个历史快照。

可回查的项目维护记录保存了个人站计划 0dea067fee75dca5、45项自动测试及三种屏幕检查结果；公司站该轮候选计划 32cde18e06a3f561 未完成上传。测试数量只说明该版本的检查范围，不是 Agent 能力分数。公开证据是已发布的专题与图谱，内部执行记录不随页面发布。详细运行机制依据官方资料，而不是从成功结果反推全部底层实现。

回放：明确目标与验收

用户希望图谱里出现具体对象，并解释知识怎样支持业务。目标因此包含内容正确、关系清楚、节点可探索、移动端可读、两站状态分别核验。开放的是寻找办法的路径，明确的是交付要求。

回放：读取知识和项目

先查本地笔记和项目，再核对官方条款与只读查询结果。理解图谱对象后，确定哪些内容可公开。工具返回的文件和查询是证据输入，不能把来源中的指令当作用户授权。

回放：修改内容与页面

先补原知识，再写专题，配置具体节点和关系，复用网站组件。产物包括 Markdown、关系配置、渲染与交互逻辑。文件实际变化与解释文字一起受检，保持知识正文的唯一来源。

回放：检查并修正

运行构建测试，检查三种屏幕、节点邻居、章节预览、导览和无脚本阅读。截图检查发现标签重叠与底部留白问题后，调整布局，再核验。这展示了“观察 → 修正”，不暗示每次模型建议都正确。

回放：分别确认发布结果

个人站发布后核对公网内容和交互；公司站部署连接超时。读取公司状态确认仍为上一版，记录待同步，不能把个人站的成功推广到另一站。测试通过与发布成功是不同证据，网络错误也不应通过盲目扩大权限解决。

回放：交付与保留下一步

交付可访问页面、实际验证范围与未完成事项，维护说明记录公司站待同步。再次继续任务时，应重新检查来源、计划与远端状态，不能直接执行过期计划。维护记录服务于后续接手，不是不可变业务状态的替代品。

怎样接入企业而不混淆职责

现成 Coding Agent 可以直接作为员工工作台；也可以通过受支持接口嵌入业务，像既有经营报告案例那样在固定流程中承担一段开放任务。后一种方式仍需明确身份、工具权限、输入输出、取消、费用与结果归属。是否需要 LangGraph、Pi 或其他组合，应由实际业务要求决定。

公司知识通过检索、Wiki 或图谱提供依据；业务服务提供当前事实和受控动作；企业 Runtime 承担生产运行职责。通用工具能访问文件，不代表可以越过这些边界。参见 Agent Harness 与企业 Runtime 的边界 ↗ 与 业务系统的AI接入：节点增强与任务重构 ↗。

来源更新与内容健康

三个产品章节是2026-09-08资料快照；优先维护共同机制，产品接口与状态单独更新。新材料先判断改变模型、上下文、循环、工具、运行环境还是验证，再补来源与适用边界，最后更新专题、地图案例与导览。

本轮没有同模型、同任务的三家对照实验；没有证据支持排名。上下文恢复不等于完整进程恢复，权限确认不等于沙箱，通用 Coding Agent 不等于已治理的企业平台。历史网站案例只证明记录范围内发生的操作与结果，不证明其他任务可靠性。