AI Agent人工智能代码智能体交互助手【免费下载链接】openchamberAgentic Development Environment based on OpenCode AI agent项目地址https://gitcode.com/gh_mirrors/op/openchamber点击查看免费下载Session Assist 是 OpenChamber 服务端内置的会话辅助机制每当一个会话进入空闲服务端会通过 Small Model 在后台生成一段简短的工作回顾recap和一个可选的下一步建议suggestion并把结果写进该会话自己的元数据。本文以 packages/web/server/lib/session-assist/DOCUMENTATION.md 为骨架结合runtime.js、context.js、prompt.js的源码实现与测试用例完整梳理它的数据形态、历史读取规则、输入边界、生成生命周期、设置项与消费端帮你理解并复用这套事件驱动 有界上下文 后台小模型的架构模式。Session Assist 是什么产出形态与存储位置Session Assist 的输出只有两个字段recap对最近实质性工作的简短提醒和suggestion一个可选的、用户可以直接发送给 Agent 的下一条消息。整个生成过程完全由服务端完成不占用用户交互路径也不做任何历史回填扫描。结果存放在会话的metadata.openchamber.assist命名空间下载荷形状固定为四个字段字段含义recap最近工作的简短回顾默认截断到 320 字符suggestion可选的下一步建议空字符串是成功结果不代表失败forMessageID生成所依据的最后一条内容消息通常是最近的助手最终回答的 ID客户端用它做新鲜度判定generatedAt生成时间戳Date.now()服务端通过persistSessionMetadataPatch(sessionID, { openchamber: { assist } }, { directory })落盘见 packages/web/server/index.js。之所以放在 OpenChamber 自己的元数据存储而不是 OpenCode 的会话记录里是因为OpenCode 2.x 只在会话创建时接受 session metadata——这是persistSessionAssist这个注入缝隙存在的根本原因runtime.js。客户端解析侧由 packages/ui/src/lib/sessionAssistMetadata.ts 负责getSessionAssist()从metadata.openchamber.assist读取载荷要求forMessageID非空且recap/suggestion至少一个有值否则返回null。模块职责划分四个文件各管一段Session Assist 的功能被刻意拆成四个边界清晰的模块这在 DOCUMENTATION.md 的 Ownership 一节有明确说明文件职责runtime.jsidle 定时器、取消、Small Model 选择、SDK 读取、新鲜度检查、设置门控、元数据写入context.js读取有界历史、构造人类回合剔除工具载荷与注入提示后再保留消息文本prompt.js生成指令与总输入预算../small-model/DOCUMENTATION.mdprovider/鉴权解析、生成、输出上限与溢出行为这种拆分让读取什么context、怎么问prompt和什么时候问runtime互不纠缠也是仓库内 session-goal 模块明确以 Session Assist 为结构模板的原因。模型看到什么有界历史与三轮人类回合页面读取规则与失败语义读取逻辑在 context.js 的loadAssistContext()中实现context.js#L165-L203通过官方 SDK 向后翻页每页 50 条消息直到覆盖3 个完整人类回合、历史结束或已读满 8 页TURN_LIMIT 3、PAGE_SIZE 50、MAX_PAGES 8。翻页失败或游标重复cursor没有推进会直接中止生成而不是把残缺历史当作完整历史继续游标去重通过cursors集合检测重复时抛出Session message pagination made no progress。达到页数上限但仍不足 3 个回合时退而使用更少的人类回合如果连最新一条助手回答对应的用户请求都没找到就跳过生成绝不虚构其上下文。为什么是 3 轮文档明确说明这是在长期维护者会话上对 1、5、10 轮和全量历史对比后的取舍——3 轮足以保留短提交确认背后的实质内容又不会把整个旧任务拖回 prompt。没有全量历史缓存也不假定任何 provider 的 prefix-cache 行为。idle 标记、压缩与回合判定OpenCode 的 v2 转写结构是扁平的每条助手消息是一个带content[]的记录用户消息是单条text加附件而每个回合结束时 OpenCode 都会追加一条idle记录模型/Agent/位置切换也会各自成为独立记录。newestContentId()context.js#L65-L71会跳过透明记录来定位真正的最新内容消息idle记录仅在outcome succeeded时视为透明agent-switched、model-switched、location-switched一律透明idle的outcome为failed或interrupted时不会被跳过——它反而是该回合未完成的证据会直接取消该回合的资格。回合判定上还有几条关键规则context.js#L137-L162v2 消息上没有parentID回合边界是位置性的两条用户消息之间的内容都属于前一条用户消息打开的回合。OpenCode 在压缩compaction时会插入合成续写用户synthetic continuation user所以最终回答的归属不必直接指向原始人类请求这些续写留在自己的回合内压缩摘要被排除。被打断的请求仍然作为上下文保留其最后可见进度被明确标注为未完成prompt 中渲染为(interrupted before a final response)而不是被丢弃或被当作最终回答。回答必须引用该人类用户或其续写用户之一针对更早请求的迟到回答不能被归属到更新的请求上。子会话、归档会话、revert 后的会话都会被跳过新 prompt 会在下一次 idle 事件前清除 revert 边界。最新内容记录必须是已完成、成功、非摘要的助手回答且有可见文本finish stop、time.completed存在、无error见 context.js#L119-L122。附加上下文投影与语言选择用户回合不仅包含纯文本。持久化的附件契约由 packages/ui/src/lib/messages/contextParts.ts 定义其面向用户的 Markdown 格式化器是 packages/ui/src/lib/messages/messageMarkdown.ts。服务端在不引入 UI 运行时的情况下把以下持久化部分投影进模型上下文context.js#L26-L45代码评论code-comment→code、文件引用file-quote→quote、聊天引用chat-quote→quote、浏览器标注browser-annotation→prompt、PR 评论pr-comment→body、PR 检查pr-check→output、终端选区terminal→output链接类GitHub issue/PR、Linear issuegithub-issue、github-pr、linear-issueOpenCode 的opencodeComment镜像同样被接受。这些附件被渲染成Attached kind (label, lines a-b):\n 引用内容\n\nUser comment:\n用户评论文本的块结构引用正文上限 4000 字符、标签上限 300 字符。引用的素材和用户自己的评论是两个独立块用户亲手撰写的文本会被单独提取用于语言选择。未被识别的合成 prompt 和被忽略的 part 会被排除畸形的附件文本会直接导致生成失败而不是悄悄丢掉用户的评论测试 context.test.js#L103-L108 专门验证了这一点。语言方面引用来源、日志、助手回复、注入的记忆指令都不参与选语言只有用户最近撰写的文本参与。对于语言中性的最终确认如谢谢/搞定可以用最近的撰写文本。现有的 Cyrillic/CJK 不匹配保护runtime.js#L178-L185就是按字段用这个撰写样本做启发式判断的——它不是完整的语言检测器且在没有样本时直接跳过。输入边界与溢出策略用户文本上限8,000 字符每条助手回答上限16,000 字符USER_CHAR_LIMIT/ANSWER_CHAR_LIMIT。附件引用正文有自己的4,000 字符上限避免大引用挤占用户评论空间。截断采用excerpt()context.js#L17-L24保留两端中间用[Content omitted]标记因此长报告的结论部分也能幸存有测试验证START...CONCLUSION两端同时保留context.test.js#L86-L101。完整用户 prompt 上限32,000 字符同时受解析出的 Small Model 输入余量约束并为系统 prompt 预留空间prompt.js#L30-L54。空间不足时先整体丢弃更早的回合如果最新的一对回合本身太大则同时摘录其用户请求与回答用户侧预算max(⌊textBudget/3⌋, textBudget - answer.length)而不是丢掉任意一侧即使最小 prompt 也装不下就跳过生成。生成时使用onOverflow: errorruntime.js#L166阻止 Small Model 服务静默截断指令预期的上下文/输出预算失败context-too-small、output-exhausted见QUIET_FAILURE_CODES会安静返回且不写元数据。一个重要工程细节OpenCode 消息页在传输层仍携带完整工具载荷所以一个超长回合即使保留进模型的上下文很小也可能产生可观的 I/O——页数/条数上限不是网络字节配额。生成与生命周期七步流程generation 与生命周期 一节给出了完整的七步流程配合 runtime.js 的实现逐条对应事件武装服务端已有的全局事件扇出调用processPayload接线在 packages/web/server/index.js#L1031。session.status事件的idle类型会武装60 秒静默窗口IDLE_QUIET_MS。没有历史扫描也没有启动回填——纯事件驱动这是与轮询式方案的本质区别。取消忙碌/重试事件和新创建的用户消息会清除待处理工作并中止进行中的读取/生成但完成之后重新发出的旧用户更新不会取消它runtime.js#L260-L265 通过对比createdAt与armedAt判断新旧。每会话单次生成一个会话同一时间只有一次生成。如果旧请求还在收尾时新的静默窗口到期则保留 pending 运行等旧的结束后再启动后续活动也会取消这个 pending 运行startGenerationreadyMap 实现runtime.js#L211-L231。模型解析用最后一条回答的 provider/model加上显式的 settings/config 覆盖来解析 Small ModelrestrictToPreferredProvider: true禁止隐式跨 provider 回退生产环境不锁定实验性模型。生成接受中止信号并受120 秒上限约束GENERATION_TIMEOUT_MS。生成语义recap 描述实质性工作及其当前结果包括一个收尾提交或致谢背后的工作suggestion 完全独立——只有未完成的、用户要求的 Agent 工作才应产出可发送的用户消息已完成的工作、可选的提议、或属于用户自己的决策/动作都应返回空 suggestion。注意文档的边界声明这是模型判断不是授权执行也不保证每个生成字段在事实上都正确。写前复查落盘前重新读取最新消息与最新会话。尾巴移动、运行被取消、endpoint/目录变化、归档、revert 或新鲜读取失败都会丢弃结果绝不从生成前的旧元数据快照合并否则会覆盖用户手动驳回等无关元数据。落盘再次检查设置、夹紧启用的字段只写已开启的字段合并进新鲜元数据。由于 OpenCode 的更新 endpoint没有 compare-and-set 操作最终读取之后的并发写入者无法被原子地防御。停止运行时stop()会清除所有 pending 定时器/运行并中止进行中操作任何一个会话的失败都不会阻塞其他会话runtime.test.js#L71-L79 验证了 stop 后一切被忽略。设置项与消费端两个设置开关默认开启sessionRecapEnabled、sessionSuggestionEnabled注册于 settings-registry.jsonscope 为profile由 settings-helpers.js 解析布尔值UI 默认值在useUIStore中为true。工作前与写入前都会被检查getSessionAssistTargetsruntime.js#L18-L24。两个都关没有任何读取、模型调用或写入。只开一个共享的近期上下文仍然可用但只请求那个字段。空 suggestion 不会抹掉有效的 recap字段独立写入。客户端渲染有严格的新鲜度门槛packages/ui/src/hooks/useSessionAssist.ts只有当forMessageID仍是会话最后一条消息、且会话处于 idle 时才渲染新消息会使其失效但不会清除已写入的元数据。recap 还要额外等待60 秒静默窗口RECAP_VISIBILITY_DELAY_MS与服务端 quiet window 对应才可见suggestion 到达即显示但调用方仍以输入框为空为前提。新鲜度判定通过一个窄订阅只订阅最后消息的 id/role/time实现避免整条消息流引起重渲染。四个消费端各有分工消费端职责packages/ui/src/lib/sessionAssistMetadata.ts解析metadata.openchamber.assist载荷packages/ui/src/hooks/useSessionAssist.ts新鲜度/设置门控SessionRecapSpacer在回复下方的预留间隙展示 recap 提醒SessionSuggestionChip填充 composer 的建议条永远不会自动发送SessionSuggestionChip的交互值得注意SessionSuggestionChip.tsx#L20-L45点击建议只是把文本填入 composeronApply不自动发送点 X 则通过patchSessionMetadata把 suggestion 从会话元数据中删除从而实现在所有端都被驳回。平台差异Web、Electron、托管移动端和 Capacitor 都使用服务端 watcherVS Code 的纯扩展运行时不生成assist但共享 UI 可以渲染服务端产出的载荷。后台 watcher 在 UI 关闭时无法使用浏览器的消息存储而手动 AI 重命名走的是SessionMessageLoader的那套存储——文档明确这是刻意不同的两种检索生命周期。关键实现常量与解析细节runtime.jsruntime.js 顶部的常量是理解整个运行时行为的速查表常量值作用IDLE_QUIET_MS60,000idle 后的静默窗口到期才武装生成RECAP_CHAR_LIMIT320recap 文本截断上限SUGGESTION_CHAR_LIMIT500suggestion 文本截断上限FETCH_TIMEOUT_MS5,000每次 SDK 读取的单请求超时GENERATION_TIMEOUT_MS120,000生成总超时TAIL_RECHECK_LIMIT8写前重查尾巴的条数足够越过 idle 标记与几次切换QUIET_FAILURE_CODEScontext-too-small、output-exhausted这些失败安静返回、不报警告、不写元数据其他值得留意的实现细节设置文件路径OPENCHAMBER_DATA_DIR环境变量若设置则用其下的settings.json否则是~/.config/openchamber/settings.jsonruntime.js#L11-L16。JSON 提取extractJsonObject()先剥离 json 围栏再扫描第一个{到最后一个}从尾到头尝试JSON.parse——因为模型有时会用散文包裹 JSONruntime.js#L35-L53。目录作用域SDK 客户端通过x-opencode-directory头携带 URI 编码的目录v2 按 header 做作用域且拒绝非 ASCII header 值。写前三重校验尾巴内容校验newestContentId(latestPage?.data) ! last.id则丢弃、会话新鲜度校验revert、目录变化、归档、设置夹紧——全部通过后才persistSessionAssist。模型预算prompt 预算 described.inputCharBudget - system.length - 512为系统 prompt 之外再留 512 字符余量runtime.js#L158-L160。Small Model 层模型解析与溢出行为Session Assist 的生成最终落到 packages/web/server/lib/small-model 模块所有调用都经运行中的 OpenCode 的POST /api/experimental/generate转发OpenChamber 从不直接联系 provider、从不处理 provider 凭证详见 small-model/DOCUMENTATION.md 的安全边界一节。模型解析按顺序进行请求显式model→ OpenChamber 设置覆盖smallModelUseDefaultfalse时smallModelOverride生效→ 会话 provider 的小模型 →restrictToPreferredProvider调用者的会话自身模型 → 任意 provider 的小模型 →GET /api/model/default。家族优先级为SMALL_MODEL_FAMILY_PRIORITYsmall-model/index.js#L114gpt-luna、gemini-flash-lite、gemini-flash、claude-haiku、gpt-nano、gpt-mini。Claude Code 被无条件拒绝422 small-model-provider-unsupported。Session Assist 使用的是restrictToPreferredProvider路径含义是用最后一次回答的 provider/model 所在 provider 的小模型找不到就用会话自己的模型贵一点也行但绝不悄悄落到别的 provider 的订阅上。当 OpenCode 不可达describeSmallModel返回 null时Session Assist 是服务端行为直接什么都不做——这是它与前端功能如提交信息生成最不同的降级策略。测试覆盖与验证方式该模块的两套测试直接印证了上面所有规则context.test.js三轮后停止翻页且排除工具载荷跨页与压缩后仍能找到真实用户被打断的请求保留为进度synthetic 附件折入其用户消息大引用保留评论、长回答保留结论畸形附件显式失败失败/重复页面不算完整历史翻页上限 8 页且不为孤立回答编造用户idle标记与切换之后仍能定位最新内容failed/interrupted的 idle 使回合失格压缩/失败/用户尾巴均被跳过两端摘录同时保留首尾。runtime.test.js无注入存储时零工作零成本parked 状态只提示一次归档会话不读上下文、不调模型v2 以 idle 标记收尾的回合能正常生成并保存且写前重查能越过 idle 标记listLimits.at(-1) 2注入存储后立即恢复武装生成。小结Session Assist 展示了一套可复用的后台小模型模式事件驱动的 60 秒静默窗口 严格有界的 3 回合上下文 位置性回合判定 写前三重复查 每字段独立的设置门控。它把读取什么context.js、怎么问prompt.js与何时做、做不做runtime.js彻底解耦并以persistSessionAssist注入缝隙保持对 OpenCode v2 元数据限制的适配。如果你需要在 OpenChamber 中新增一类后台小模型产出session-goal 正是以它为模板实现的同类模块可以直接对照阅读。赞分享AI Agent人工智能代码智能体交互助手【免费下载链接】openchamberAgentic Development Environment based on OpenCode AI agent项目地址https://gitcode.com/gh_mirrors/op/openchamber点击查看免费下载相关推荐OpenChamber 1.14.1 发布解析Chat 回顾与建议回复Recaps Suggested Replies及 Small Model 统一能力OpenChamber 1.14.1 发布解析Chat 回顾与建议回复Recaps Suggested Replies及 Small Model 统一AI Agent人工智能代码智能体交互助手openchamber 1.22.1 版本解析服务端消息队列与 OpenCode Go 会话头兼容openchamber 1.22.1 版本解析服务端消息队列与 OpenCode Go 会话头兼容 openchamber 1.22.12026 09 04AI Agent人工智能代码智能体交互助手happy-server Session Avatars 深度解析会话头像的端到端加密传输协议与实现happy server Session Avatars 深度解析会话头像的端到端加密传输协议与实现 happy server 为每条会话session引人工智能AI AgentAI 应用移动开发CLI后端上一篇Go 迭代器指针转换实战深入 lo 的 it.ToSeqPtr 与 it.FromSeqPtr下一篇Genkit Dart Agent Sessions 持久化实战SessionStore、Snapshot 快照链与 Firestore 生产级存储创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考