多角色协作链路：从团队编制到记忆分层与上下文接续

这篇讲一条多角色协作链路团队编制、职责绑定、消息分发、记忆分层与上下文接续。背景很直接一件事拆成几段之后如果每段之间靠口头衔接链路就等于没建。真正要处理的是三件事每段由谁接、接不上怎么办、开销怎么收敛。链路形态四个模块串起来职责各自独立。| 模块 | 职责 || team_scaffold | 按分工描述创建成员完成入群绑定 || role_bind | 把名字、职责、指令、模型四项作为独立字段绑定 || dispatch_rule | 决定消息由谁先应答、何时转派 || memory_tier | 维护成员级与团队级两层记忆 |顺序不能颠倒。跳过 role_bind 直接配分发规则成员之间会因为职责重叠而互相抢答。职责绑定是独立字段四项分开绑的意义在于替换成本改其中一项其余三项不受影响。ROLE_FIELDS (“name”, “duty”, “prompt”, “model”)def bind_role(role, patch):merged dict(role)for k, v in patch.items():if k not in ROLE_FIELDS:raise KeyError(“unknown field: %s” % k)merged[k] vreturn merged四项各管一件事。名字只影响界面上怎么显示、调用时怎么指代职责决定它能接住哪些消息指令规定拿到消息后按什么口径作答模型决定回答的快慢与表达习惯。四项存在同一份记录里修改走补丁合并所以换名字不会牵动指令换模型也不会牵动职责。任务也不是一次性的。同一个成员留着重用下次可以直接接着处理之前那件事不必重建上下文。职责位还分两层团队统筹与群组管理各为一层同一实例可同时挂两个职责。一层管队伍层面的组成另一层只管单个群组实例内部的成员与参数。消息分发决定开销dispatch_rule定的是默认单点应答加按需分派避免广播式触发。def dispatch(msg, members, lead):# 默认路径先由群组管理实例应答if lead.can_handle(msg):return [lead.handle(msg)]# 按需分派只唤醒相关成员不广播return [m.handle(msg) for m in members if m.matches(msg)]默认单点先应答的理由是省下重复判断每条消息先交给群组管理实例能接就接接不了才按条件唤醒相关成员。广播式触发的写法是把每条消息推给全部成员每个成员都得跑一遍判断参与面直接等于成员总数轮次也随对话条数往上走。budget_guard的依据就在这里参与面与轮次线性推高开销收敛入口即收敛成本。计数视图支持按日期间隔、成员、模型筛选。统计结果停在使用量本身不做任何货币换算。这个口径只回答「用了多少」不回答「花了多少」单价由所选模型决定把折算写进统计会让历史数据失去可比性。预算控制的入口因此落在两处压住参与面以及让单次对话的轮次停在该停的地方。记忆分层与上下文接续memory_tier把记忆拆成成员级与团队级两层均以纯文本落盘。文件层面看成员级记忆在成员目录下各存一份团队级记忆在团队目录下存一份都是可以按行编辑的纯文本。成员级记的是这个成员的偏好、它自己做过的决定、以及它需要长期记住的口径团队级记的是全体成员都要遵守的信息比如分工边界与共享约定。写入不是全收每轮对话结束后有一次审查判断新增信息是否需要保存、已有条目是否需要更新或删除。上下文接近窗口上限的时候handoff_note输出三类产物摘要、压缩后的上下文、可跨会话续跑的接续记录。三类各有用途摘要是给人看的压缩后的上下文是给下一个会话当输入用的接续记录则把当前进展、待办与已确认的结论单独列出来。调用方看到的是连续会话。更早的内容落在本地文件可以按需读取。每个成员各选模型每个成员可以各选各的模型这是字段独立带来的便利。但同一支链路里尽量用同一个模型更省心不同模型对同一份指令的理解偏差会累积排查问题时多一层变量。踩坑记录把职责当成描述性文字。职责必须能落成判定条件否则两个成员会同时认领同一条消息同一条消息被处理两次还得分出人力去判断哪一份结果算数。用广播式分发省事。成员一多开销按参与面放大链路反而更慢。把记忆当成全量日志。记忆只该放以后还要用的信息历史细节留给会话记录否则每一轮都要读一堆用不上的内容。忽略接续环节。上下文断掉之后如果只能重新描述一遍前面攒的所有配置都白做跨会话的那部分能力等于没启用。两处常见误解一是把成员数量当成能力上限。链路能不能跑取决于段落划分是否清晰与成员个数没有直接关系。二是把本地存储理解成临时缓存。配置、会话与记忆都落盘在本地目录卸载插件只移除程序本身不会替你删掉这些文件。重装之后旧数据仍在需要清理时得自己动手排障时应当先确认这一点。自建的分发入口可以先挂在your-domain.test下的内网地址跑顺再考虑对外开放。前置依赖两项运行框架本体以及至少一个已配置可调用的模型。这两项缺一链路在头一步就起不来。一条协作链路好不好用看它能不能在会话断掉之后接着跑。