Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
IM 一轮任务:入口账本与状态模型
状态:权威开发规则(authoritative),随「IM 一轮任务合并」分批迁移持续更新 读取时机:修改个人 IM 渠道(
apps/desktop/src/main/im/**)或官方 hook (apps/desktop/src/main/hook-control/**)的找/建任务、命令、排队与插话、输入拼装、 事件观察、表情、交互、收尾或停止逻辑之前
个人 IM 渠道(Telegram / 飞书 / 微信 / 钉钉 / Discord / 企业微信)与官方 hook(官方
Telegram / Slack / X)是同一件事的两套实现:把渠道里的一条消息变成 Cindy 任务里的一轮,
再把结果送回渠道。本文登记两套实现今天各自在哪一步做了什么、持有哪些状态、
合并后归谁,以及迁移中必须守住的不变量。用户可见的两侧差异另见
../product-rules/telegram-bot-parity.md;
台账里标「有意不同」的项以策略参数表达,合并时不抹平。
连接恢复由渠道 transport 持有,不重放任务或发送内容。Telegram、Discord 的启动网络失败与 钉钉的连接失败使用可取消的指数退避(约 1 秒起、30 秒封顶,带抖动);Telegram 429 尊重 服务端完整等待时间。飞书保留 SDK 重连,仅在 SDK 耗尽重试或启动抛错后补重试;就绪日志须 与 SDK 真实连接状态一致。微信、企业微信保留已有重试循环。恢复成功立即更新状态, 不等待下一条消息;凭据失效保留明确错误,冲突沿用各渠道原策略。主动下线、解绑、换账号或退出 必须取消重试,旧连接结果不得复活。设置页的手动重连复用保存的凭据,不要求重新输入或解绑。
退避计算、默认间隔、抖动和可取消定时器统一放在 @cindy/im/connection-retry:飞书、
Telegram、Discord、钉钉和官方 hook 共用调度器,Telegram 长轮询复用同一退避策略。
官方 hook 的冲突等待间隔和抖动范围通过参数保留;鉴权、冲突及 SDK 回调仍由渠道适配层处理。
设置页共用 ImConnectionRecovery.tsx 的错误提示、重连按钮和已保存凭据恢复行,避免各渠道
重复维护文案、加载状态和错误详情展示。
机器人未单独选择模型时,空的模型配置表示自动选择意图。个人渠道、官方 hook 与设置页均经
shared/imAutomaticModel.ts 复用普通新任务的默认组合与目录回退规则,不读取输入框的最近选择。
解析结果包含来源、引擎、模型和思考强度,只用于执行和展示,不写回 override。自动模式的
跟随记录同时记下解析结果,下一条消息重新解析目录;结果未变不改任务,任务手动选择仍优先。
无可用来源时明确失败,不把空字符串或历史写死型号交给执行器。已有显式配置保留原值;恢复
自动选择只清模型路由覆盖,保留权限档。
自动候选同时遵守执行端的模型显示偏好;显式固定模型仍按原路由准入规则校验。官方目录指向
远程电脑时,只从那台电脑授权远程调用且可见的目录解析,失败不改成本机。继承本机默认时,
先解析默认模型,再按既有规则判断目录的残留来源;断开或停用的显式来源仍拒绝替换。
设置页在自动模式下随目录更新重读实际模型,加载、刷新与保存共用请求代次,迟到刷新不得
覆盖用户刚固定的模型或切换后的渠道。
1. 入口账本
每一行是一轮任务的一个步骤。「现状」列写真正干活的函数;「目标」列写合并后的归属: 公共入口(App 的既有入口,IM 不再另写)、共用流程(新的 IM 一轮任务模块,两侧 同一份)、渠道适配(只保留入站来源、出站载体、台账登记的有意差异)。
| 步骤 | 个人 IM 现状 | 官方 hook 现状 | 目标归属 |
|---|---|---|---|
| 入站 | 各渠道 adapter → im/shared/messageHandler.ts(微信经 WechatTaskStore 持久队列) |
hook-control/manager.ts 收 task.dispatch → dispatcher.handleDispatch |
渠道适配(入站来源各自保留) |
| 幂等与重投 | 无(个人连接无重投) | ackHistory / inflightRequests / terminalLedger |
渠道适配(服务端重投是 hook 的传输语义) |
| 找任务 | turnRunner.resolveRouteTarget:通知回复 → /ctr 绑定 → 确定性 id 通道行(sessionRepo.findActiveSession 复活归档行) |
dispatcher.resolveTarget:接管 sessionId → 绑定复用(每条消息按工作目录映射现场重算)→ 失效则换任务并交接 |
共用流程的「定位」骨架 + 渠道策略(台账第三节「绑定的任务失效后怎么接续」有意不同) |
| 建任务 | sessionRepo.createSession 确定性 id upsert;createFreshSession(/new 轮换事务);随后 maker.createSession —— 2026-10 起两处建行都经 openChannelSession → openSession(模型准入) |
session-runner 新任务的 maker.createSession、/new 的 desktopSessionStorage.create —— 同样经 openChannelSession → openSession |
公共入口 openSession(已完成,批次 2);渠道专属建行在 commit 回调里。live session 仍各自 maker.createSession,未改用 register 内部的 bootstrapSession(会新增项目上下文 / Orca 指令注入等行为,见 §6) |
| 默认配置 | resolveImSessionDefaults(channel) + 跟随渠道默认(channelDefaultRouteSync) |
resolveNewSessionConfig(目录偏好 > 全局 IM 默认 > 清单首项;权限档规则见 defaults.ts)+ 共用 createDefaultRouteFollower 跟随默认 |
渠道策略(台账第三节「新会话的默认…从哪读」有意不同) |
| 命令 | messageHandler.processOne → slashCommands(注册表 botCommands.ts) |
服务端分发命令,桌面只收 query.* |
渠道适配(官方命令分发在服务端) |
| 排队与插话 | SessionState.sendQueue(内存、无上限、重启丢失);无插话 |
dispatcher.queues(内存、上限 20)+ drainPolls;无插话 |
公共入口 AgentInputCoordinator(见 §5 批次 3 与 §6 待决项) |
| 输入拼装 | prepareAgentTurnText(群上下文 / ambient 提示)+ buildImChannelNote + buildImUserMessage;派发时前置交接 / 计划对账 / Goal 提示 |
buildContextPrefix + composeXPrompt + buildHookPromptNote;同样前置交接 / 计划对账(仅 IM 来源)/ Goal 提示 |
共用流程(前置层同一份;渠道说明文案有意不同,见台账「入站上下文」) |
| 用户消息落库 | 部分渠道提前落库(persistInboundUserMessageEarly),onAccepted 补 imSource |
只在 onAccepted 落库,agentMeta.hookSource |
共用流程(onAccepted 落库;提前落库保留为渠道能力) |
| 发送 | 发送前应用任务待切换选择,再 makerSession.send,MAIN_OWNED_SEND_CONTEXT.origin.kind='im' |
复用任务先经 acquirePendingAgentSwitchForImSend 跟随默认并应用任务选择,再读 meta、建会话、挂观察器和 session.send;发送后释放锁,origin hook(Telegram/X)或 im(Slack) |
待切换选择共用既有直发流程;Pi 管理命令授权来源按渠道各自声明(hook 不得伪装成本机命令) |
| 观察事件 | turnPresenter(buffer-replace)+ 流式 handle |
turnObserver(finalized-segments)+ 进度发射器 |
共用流程(presenter 已同源;两个正文累积引擎有意不同) |
| 后台轮次回传(非 IM 入站) | orchestrator 的 onChannelTurn → turnRunner 转播(Agent 自己唤醒的轮次只同步标记已接线的会话) |
backgroundResults → turn.end(background: true) |
已同源判据:maker-ipc/channelTurnSignal.ts 的开始信号与 isRelayedChannelTurnSource(其它任务来信;后台唤醒继承当前 Session 最近实际派发的来源,Cindy 输入及内部协调不回传;scheduler 按 turnOrigin);仍属原 IM 轮次的不另发 |
| 表情 | TurnState 的 ack 句柄 |
ackReactions(msg.op react) |
渠道适配(出站载体不同,档位语义同源) |
| 交互 | beginInteractionRoute + pendingInteractions + 渠道卡片 |
beginInteractionRoute + interactions.ts(30 分钟超时)+ 卡片发布器 |
共用流程(路由与语义层已同源;超时差异见台账缺口 2g) |
| 收尾 | handleTurnDoneAsync / handleTurnErrorAsync → 流式 handle finalize |
execute 收口 → turnCarrier.publishFinal → turn.end(持久出箱) |
共用流程的收口骨架 + 渠道出站载体 |
| 停止 | turnRunner.stopActiveTurn:清 sendQueue + 撤自动续跑 + abort();不暂停 Goal、不停 coordinator |
dispatcher.cancel → abortSession:只 abort();不撤自动续跑、不暂停 Goal |
公共入口:统一明确停止(stopSessionTurnExplicitly,与桌面 Stop 同一套清理) |
| 重启恢复 | 无(微信例外:WechatTaskStore) |
终稿持久出箱(requestLedger,24h) |
渠道适配(终稿必达是 hook 的保障;台账缺口 3) |
2. 状态清单
只列跨轮持有、会影响正确性的状态。「去向」:保留(留在渠道适配)、并入(进共用流程, 两侧一份)、替换(由公共入口持有,删除本地副本)。
| 状态 | 位置 | 键 | 去向 |
|---|---|---|---|
userLocks |
im/shared/messageHandler.ts |
ctx:sender:scope |
保留(入站串行化是渠道语义) |
sessionStates / SessionState.queue |
im/shared/turnRunner.ts |
sessionId | 并入(「每会话当前一轮」的观察状态) |
SessionState.sendQueue / dispatchRetryTimer |
同上 | sessionId | 替换为 coordinator 队列 |
queues / running / drainPolls |
hook-control/dispatcher.ts |
sessionId | 替换为 coordinator 队列(running 只剩观察态) |
keyChains / sessionAdmissionChains / worktreeChain |
dispatcher | externalKey / sessionId | 保留(hook 的接活串行化) |
ackHistory / inflightRequests / pendingTurnEnds / pendingDeliveryTurnEnds / requestLedger |
dispatcher | requestId | 保留(hook 传输与终稿必达) |
runningByRequest / cancelRequested / pendingGroupAdmissions |
dispatcher | requestId | 保留(服务端 requestId → 任务的映射) |
pendingReopens / activeContinuations / pendingClaims |
dispatcher | sessionId | 保留(turn-reopen-v1 是官方能力) |
awaitingPersist / staleTakeoverReplacements / latestPromptBySession |
dispatcher | sessionId / key | 保留(hook 的定位策略) |
controlState.inProgress / 绑定库 |
im/shared/controlState.ts / im/binding.ts |
bot:user | 保留(/ctr 是个人渠道能力) |
pendingInteractions.pending / interactions.ts pending |
两侧 | requestId / interactionId | 并入(批次 5:交互挂起表合一,超时策略按渠道参数) |
groupHistoryAccess.activeBySession |
im/shared |
sessionId | 已同源,不动 |
群消息本地窗口(hook_group_messages)与上下文游标(hook_group_context_cursors) |
im/shared/groupWindowCore.ts;个人渠道经 im/shared/channelGroupWindow.ts(Telegram / 企业微信 / 钉钉各一份 provider 前缀,<渠道>-personal:<botContextId>),官方经 hook-control/groupWindow.ts |
provider + chat / cursorKey | 已同源,不另建存储:新渠道接群上下文时复用 createChannelGroupWindow,在 prepareAgentTurnText 入窗并拼前缀、受理后 commit,终稿发出后把机器人回复入窗 |
channelToolScope.activeBySession(cindy_telegram_bot / cindy_feishu_bot 轮次内工具的逐轮作用域) |
im/shared |
sessionId | 个人渠道能力;与群历史租约同一生命周期(beforeProviderStart 登记、releaseTurnInteractionRoute 释放)。Telegram、飞书 / Lark 各一种作用域,带着触发本轮那条连接自己的 transport;企业微信 / 钉钉 / Discord 没有渠道直通工具,伙伴专线轮次由 messageHandler 登记不带 transport 的 LaneTurnScope(只给触发者身份与当前对话);cindy_feishu_bot 的 send_*_to_user 优先按它选出站 bot,无租约时按下述主人通知规则解析 |
Telegram 传输层(chatQueues / typingLoops / 回挂目标) |
packages/lizi-im/src/telegram/index.ts |
chat | 保留(个人出站载体) |
飞书主人通知的无租约路径:send_message_to_user / send_file_to_user 在伙伴 canonical
主任务的后台回报、心跳或桌面轮次中可主动通知主人。无飞书逐轮作用域时,宿主异步查询当前账号的
bot_session_links(role='canonical',关联 sessions.source='bot'),确认伙伴 Profile 为 active,
选择该伙伴已连接且已绑定主人的飞书连接;发送时校验连接的 owner 与已解析收件人一致。
已识别伙伴但没有匹配的可用连接、伙伴 Profile 非 active 或缺失、数据库查询失败、账号边界处于 pending
或 owner 代次变化,均拒绝发送,不回落个人 bot;查询前后
及实际调用发送前都复核账号边界、owner 代次与所用 DB 快照。没有 canonical 伙伴归属的普通
任务仍保留设置页个人 bot 的主人通知能力。使用个人 bot 发送时,已解析收件人必须匹配它当前的主人
或宿主任务记录的显式 feishuChatId;两阶段之间 canonical 关联消失时,不将伙伴的收件人交给个人
凭证发送。此路径不向主任务持久写入 feishuChatId,也不生成租约
或授予轮次内原生 API 权限;cindyBotImChannels 只控制工具挂载,不作为归属或授权依据。
实现见 feishuTransportRouting.ts
与 botImConnectionRuntime.ts,
真实 worker DB 路径回归见 feishuTransportRouting.test.ts。
不为合并新增全局状态机或持久化表:队列与停止交给已有公共入口持有的状态;合并只移动和 删除现有状态。
3. 不变量(迁移每一批都必须守住)
同一 externalKey / 同一渠道行 → 同一任务;建任务与复用的判据不因迁移改变(台账第三节)。
已提前落库的用户消息不重复插入:
onAccepted只补元数据(existingClientId)。来源标签与模型说明同源(
message-source.md): IM 写agentMeta.imSource,hook 写agentMeta.hookSource;新数据不得塞进origin(coordinator 把任何origin.kind当非人工输入)。Pi 管理命令授权来源:个人 IM 用
authenticated-im-command;官方 hook 的 origin 是hook,不得伪装成local-desktop-command;MAIN_OWNED_SEND_CONTEXT是 Symbol, 跨队列快照时必须由宿主在派发时重新盖章,不能指望它随队列项持久化。session-new-v1:
/new成功时新任务已落库并出现在列表;turn-reopen-v1:续跑轮 断连即终局、turn.end直发不缓存。群历史租约与渠道工具租约:
beginGroupHistoryAccess/beginChannelToolScope都在 provider 真正 开始这一轮前登记、终态释放;sessionInstanceId挡住旧实例借用新权限。轮次内原生 API 的目标 chat 与 触发者身份只来自租约,不来自模型参数,无租约时 fail closed;飞书send_*_to_user的主人通知 例外见上节,不扩大原生 API 的作用域。每个可绑定渠道的channelNoteSourceFor都要在[渠道说明]末尾给toolsHint点名本轮可用的渠道工具(Telegram:TELEGRAM_TOOLS_HINT;飞书:feishuToolsHint), Agent 不该靠摸瞎试工具才知道自己在哪个渠道;新增可绑定渠道时四件事一起补——渠道说明提示、channelToolScopeFor作用域、轮次内直通工具、以及该渠道工具在三个 Harness 的挂载门禁 (shared/botImConnection.ts的hasImChannelVendorOptions:专线带<channel>ChatId,伙伴主任务带cindyBotImChannels标记;Codex / Pi 的共享 bridge 用空 ctx 建清单,providerisEnabled必须在空 workdir 快照放行,再由codexEnvironment.buildSessionMcpConfig/piEnvironment逐会话收可见性)。 渠道工具租约还被botSkillService复用来判定专线上「是不是主人触发的轮次」;没有channelToolScopeFor的可绑定渠道靠LaneTurnScope兜住这一判定,否则主人在专线上也只能只读技能。onAccepted成功落库后把本轮输入的clientId绑定到同一租约;事件持久化在租约释放前 将它写为replyToClientId,用于保留回复与本轮输入的确切关联;这不是后台学习的触发约定, 回复后不再启动辅助模型复盘。显式技能工具的写权限仍按当前轮租约 /LaneTurnScope的 主人身份判定,不把持久回复关联当作新授权,也不借用后续轮次的租约或最近一条消息。 受保护内容未落库时不绑定,复用作用域前清除旧输入。 6b. 发送前上下文体检同源:个人 IM 的dispatchQueuedSend在伙伴守卫(companion.prepareSend) 之后、拿发送锁(acquirePendingAgentSwitch)之前调用deps.prepareUnhealthySession(orchestrator 接register.prepareUnhealthySessionForSend),与桌面直发、官方 hook 走同一个contextOverflowRollover.prepareUnhealthySession:伙伴对话(主任务 + channel / group 专线)沿用 普通 Session 的真实满窗、明确压缩失败和坏历史恢复;健康上下文交给原生压缩,不按空闲时长 或 70%/90% 伙伴阈值提前换窗,正常压缩也不重启伙伴实例。IM 不另设换窗 / 换任务规则 (cindy-bots-runtime.md§3.2)。体检关闭 live handle 的原因是runtime-refresh,close 监听在有acquirePendingAgentSwitch时保住任务,新 handle 由refreshSessionAfterPendingAgentSwitch按最新 DB 行重建;体检抛错按直发口径让这条消息失败。 6c. 全响应(ambient)前置判定不留痕迹:messageHandler.processOne只对event.ambient === true的消息、 且 adapter 实现了ambientTurnGate时,在 ack / 提前落库 / 群上下文拼装之前问一次该不该插话;'skip'直接 return(不落库、不起轮次、不推进群窗口游标),钩子抛错或判不出来按'proceed'走原路径。 被召唤的消息永远不经过判定。判定走共享辅助模型链(im/shared/ambientReplyJudge.ts),不得在这里起主模型。计划对账只在真实用户轮次注入(官方仅
source.im存在时)。终稿必达(官方):
turn.end先进持久出箱;客户端发布终稿时以clientFinal交回。 带附件的轮次不由客户端发布。Telegram / Slack 的持久出箱只存文本;X 的出箱保留cindy-media地址、引用 ID、名称、MIME 与大小,Base64 只存在传输帧和内存中。 X 仅收 JPEG / PNG / WebP / GIF / MP4 / MOV;单图片 5 MiB、GIF 15 MiB、视频 10 MiB, 一轮最多 8 项、总计 30 MiB(服务端再核验 X 的附件组合;持久出箱仍按 32 MB 总预算计入媒体的传输大小)。托管媒体通过ingestMedia作为非缓存入库;待发 pin 使用message引用、出生任务与hook-outbox来源,沿用 任务删除清理。恢复时核对当前账号、任务与引用,失效不重放附件;仍待发的结果保留 24 小时。 收到turn.delivery(未协商回执时为 transport 接受)后清除出箱媒体地址并释放 pin; 定时及读路径清理过期出箱,媒体仓同时回收崩溃遗留 pin, 物理字节仅由既有媒体回收器处置,不删除仍被聊天/画廊引用的媒体。 媒体入仓或出箱失败时保留原有完整内存发送兜底,并记录持久化失败;不得将丢附件记作持久化成功。 兜底帧写不进出箱时也不由客户端发布;本进程 仍在发布、正式turn.end还没进入发送 / 缓冲路径时,重连扫描与服务端重投task.dispatch都不重放出箱里的兜底帧(重投只回放 ack);终稿段 回执未知先同 opId 有界重发对账,仍未知才交回。明确停止 = 与桌面 Stop 同一语义:撤自动续跑与退避簿记、取消上下文溢出恢复、暂停 Goal、停 coordinator(中止当前一轮、清 coordinator 队列、清理待决交互)。用户喊停后不得有 任何自动续跑原地复活;hook 自有队列(
queues)不在此列,并入 coordinator 前的语义见 §6; Goal 落盘失败只能在中止之后报错,不能挡住停止。hook 的续跑观察不把自己的轮次当成桌面轮次:hook 轮次一旦经 coordinator 派发,
subscribeUiTurnDispatching必须能按 clientId 认出它(否则会误撤续跑)。一轮绑定入口时的账号:新建任务从读取旧任务 / 默认配置之前捕获账号 (
captureChannelAccount,先 prepare 再建的沿用 prepare 时捕获的),经openChannelSession带进openSession,准入前后与写库前都复核,建行之后的补写(来源、发送时间、worktree)也不例外;账号变了就终止这次派发(官方 hook 在session.send前复核),不只是跳过补写;一轮的出站 msg.op (进度、终稿、卡片、旧卡片帧)只经所属账号代次的连接发出,换账号后视同离线。 边界:Maker.createSession内部「先异步启动 Agent、再取当前库写行」的窗口不在本条范围—— 它是桌面、IM、目标恢复等所有建任务入口共有的既有问题,要堵需让账号守卫穿过 maker-core 启动 / 持久化边界或新增回滚机制,另行处理。飞书回复跟随提问位置:群主聊天的消息用群 lane,带
thread_id的消息用原话题 lane; 普通引用的parent_id/root_id不等于话题,不自动开新话题。个人和伙伴复用同一渠道实现。 工作中编辑进度卡;完成后在同一位置新发终稿,确认发送成功再撤回进度卡,避免失败时丢掉已有内容。 终稿和附件不领取下一轮排队消息的锚点。空结果撤回进度卡且不发占位,图片/文件仍正常投递; 新消息发送失败时保留进度卡并尝试就地展示终稿,撤回失败不得重复发送已成功的终稿。
4. 状态模型(一轮)
inbound ──► admitted ──► queued? ──► dispatching ──► running ──► finalizing ──► terminal
(渠道) (定位/建任务) (coordinator) (前置层+send) (观察事件) (渠道出站收口) ok|error|cancelled
│ │ │ │
└── rejected ────┴── discarded ──┴── stopped ───┘
- admitted → queued:会话忙(
isTurnRunning或 coordinator 有积压)时入 coordinator, 带onAccepted/onAcceptedRollback/onDiscarded;空闲时直接进入 dispatching。 - dispatching:前置层(交接 / 计划对账 / Goal 提示 / 渠道说明)只在这一步加,不进
持久化文本与队列文本;
onAccepted是用户消息落库与「已受理」副作用(群上下文游标提交、 ack 表情转处理中)的唯一边界。 - running:一轮只有一个观察者;终态只由
done(非 silent-stop / 非续跑中间边界)、 终态 error、会话 closed/error 三个出口给出(turnObserver的收口规则)。 - stopped:任何来源的明确停止都走
stopSessionTurnExplicitly;队列中的项经 coordinatoronDiscarded收口(hook 回turn.end(cancelled),IM 撤排队表情)。 - terminal:渠道出站收口(个人:流式 handle finalize;官方:
turn.end与客户端终稿)。 每个 settle 路径(resolve / reject / 超时 / 取消 / 乱序 / 迟到 / 重复)只有一个判据。
5. 迁移批次
每批独立可验证:跑 pnpm test:unit:related 与相关 package typecheck,本地 commit。
- 统一明确停止(已完成):
register.ts里重复的内联停止序列抽成导出的stopSessionTurnExplicitly(伙伴群聊 lane 与伙伴委派原来各抄一份,改调它);IM/stop(含微信)与 hooktask.cancel改调它,账号边界中止仍是普通 abort。 - 新建任务走
openSession(已完成):im/shared/openChannelSession.ts是两侧共用的 薄包装 —— 准入前的路由送进openSession,建行回调拿准入后的路由;IMcreateSession/createFreshSession、hook 新任务与/new的只建行都经它。复用 / 接管 / 复活既有任务 不经过准入。准入拒绝时抛出,调用方走各自既有的渠道失败提示。 - 排队走
AgentInputCoordinator(2026-10-06 Dash 决定另开 PR,先出设计说明):删 IMsendQueue与 hookqueues;coordinator 队列项补imSource/hookSource字段(不进origin),派发时由宿主补渠道说明并重盖MAIN_OWNED_SEND_CONTEXT;hook dispatcher 按 clientId 认出自己的轮次。已查明的前提:coordinator 派发一项时接管的是整轮生命周期 (发送事务里落库用户消息、绑定 vendor turn、出错时套用中断自动续跑 / 错误横幅 / 上下文 恢复),所以「只当候车室、轮到时转回渠道自己发」做不干净 —— 迁移后渠道轮次就是 coordinator 轮次,§6 前四行的可见变化要逐条定下来再动手。 - 共用一轮流程骨架(随批次 3 另开 PR):把「定位 → 拼装 → 发送 → 观察 → 收口」抽成共用模块,两侧只注入 渠道适配(入站来源、出站载体、§1 标注的策略参数)。
- 交互挂起表合一、台账缺口收敛(随批次 3 另开 PR):缺口的最终取向逐项写回台账,用户可见变化按 §6 处理。
6. 待 Dash 决定(默认保持各自现状)
| 项 | 个人 IM 现状 | 官方 hook 现状 | 合并后若不决定 |
|---|---|---|---|
| 重启后排队消息 | 丢失 | 已 ack 为 queued 的任务丢失,服务端靠 lease 超时收口 | coordinator 快照会恢复为暂停队列,等用户再发消息才继续 |
| 渠道轮次的中断自动续跑 / 错误横幅 / 上下文恢复 | 无 | 无 | 迁到 coordinator 后自然覆盖(与桌面同语义);与 maker-core-and-agent-behavior.md 「IM 绑定任务不进图片历史自动恢复」那条要一并核对 |
| 排队消息在桌面端可见 / 可删 | 不可见 | 不可见 | 迁到 coordinator 后自然可见、可删(删除即视同撤回:IM 撤排队表情,hook 回 turn.end(cancelled)) |
| 排队上限 | 无上限 | 每会话 20 | 各自保留:IM 不限,hook 仍按 20 拒收 |
| 停止时同任务已排队的消息 | /stop 一并清掉 sendQueue |
服务端 /stop 只对正在跑的那一个 requestId 发 task.cancel;desktop hook 队列里同任务已排队的请求照常接着跑(本 PR 前即如此) |
未改:一并清掉等于替用户丢弃没被取消的请求、并以 cancelled 收口,属产品语义;随批次 3(hook 队列并入 coordinator)一起定 |
| 插话(steer) | 无 | 无 | 不新增 |
模型准入(openSession) |
只做凭证检查 | 新任务做路由检查 | 已按 Dash 指定改走 openSession 准入:新任务的模型 / 来源 / 推理强度 / Fast 不被支持时直接拒绝(文案「不会自动更换模型或供应商」),准入还会规范化来源与推理强度;渠道默认配置若指向已停用的模型,新任务会建不出来(以前会照建) |
live session 改走 bootstrapSession |
不注入项目上下文 / Orca 指令 | 同左 | 未改:改了等于给 IM / hook 任务新增项目上下文与 Orca 指令注入、目录授权准备等行为,属产品决定 |
| 缺口 2b / 2e / 2f / 默认配置取值链 | 见台账 | 见台账 | 各自保留,合并只共享实现骨架 |
官方 X 的伙伴路由
hook-control/xCompanion.ts 通过既有 ensureBotChannelLaneSession 创建 X 公开专线。
绑定正本为账号隔离的 hook store x.companionBotId,不修改跨端 wire 或数据库 schema。
Dispatcher 只接受宿主解析的专线 ID 和精确工作目录,忽略入站指定的任务 ID;执行与排队恢复时
重新核对绑定。Runner 在获取切模锁前执行伙伴模型/能力刷新,provider 启动前登记 X 的
LaneTurnScope,终态释放;source 仍保留 bot,渠道说明逐轮追加。普通未绑定 X 路由保持原样。