diff --git a/app/server/db.js b/app/server/db.js index 34e24a8..d41ec92 100644 --- a/app/server/db.js +++ b/app/server/db.js @@ -145,6 +145,8 @@ function initDb(dbPath) { bot_account_id TEXT, -- bot 上线后的微信账号标识(登录回调带回,展示用) wx_to_user TEXT, -- 最近来话人 userId(deliver 回发对象;实际上只会是主人自己) last_msg_id INTEGER NOT NULL DEFAULT 0, -- 投递游标:id ≤ 此值的 assistant 消息已送过微信 + deep_think INTEGER NOT NULL DEFAULT 1, -- 微信端全局深度思考开关(/think;= H5 按钮的微信形态, + -- 随绑定不随会话;投递时替进消息 API 的 deepThink 字段) created_at INTEGER NOT NULL, updated_at INTEGER NOT NULL ); @@ -228,6 +230,10 @@ function initDb(dbPath) { // 迁移:title_locked 用户手动重命名过标题(renameSession 置 1):handoff 的自动标题见锁即跳过, // 不得静默冲掉用户给会话起的名字;清空会话时随标题一并复位(旧名字已文不对题)。 if (!cols.some(c => c.name === 'title_locked')) db.exec("ALTER TABLE sessions ADD COLUMN title_locked INTEGER NOT NULL DEFAULT 0"); + // 迁移:wechat_bindings 补 deep_think 列——微信端全局深度思考开关(routes/channel.js /think 读写, + // 投递时作为既有 deepThink 参数的取值来源);缺行/旧库默认 1=开(微信没按钮,默认按开走)。 + const bindCols = db.prepare('PRAGMA table_info(wechat_bindings)').all(); + if (!bindCols.some(c => c.name === 'deep_think')) db.exec('ALTER TABLE wechat_bindings ADD COLUMN deep_think INTEGER NOT NULL DEFAULT 1'); // 迁移:phase 语义重定义为 advising(顾问:澄清需求/规划)/ executing(执行)。 // 存量会话(旧值 planning/NULL)统一回填 executing——它们都有历史,行为与改造前一致、零打扰; // 只有新建会话进 advising(createSession 显式写入)。幂等,每次启动一条廉价 UPDATE。 diff --git a/app/server/routes/channel.js b/app/server/routes/channel.js index c201cfa..d89a574 100644 --- a/app/server/routes/channel.js +++ b/app/server/routes/channel.js @@ -52,10 +52,10 @@ function setBinding(db, user, channel, sessionId) { } // /new 与「无绑定时发普通消息」共用:新建(engine 立即绑模型,空池 503 冒泡)+ 换绑 + 可选首条消息 -function newSessionFor(db, user, channel, firstText) { +function newSessionFor(db, user, channel, firstText, opts) { const s = engine.createSession('', '', 'secretary', user); setBinding(db, user, channel, s.id); - const sent = firstText ? engine.postUserMessage(s.id, firstText) : null; + const sent = firstText ? engine.postUserMessage(s.id, firstText, opts) : null; return { s, sent }; } @@ -147,10 +147,11 @@ function modelsReply(ms, curModelId) { // 严格匹配:整条消息恰好是命令词(ARG_CMDS 内的可带参数)才算命令。 // 首词形如 /纯ASCII词 但不在清单 → 回「未知命令」提示、不转发模型(防弱模型就着 /hlep 演一段); // 其余一律普通消息:/home/x、/a.b 这类路径代码,以及 /clear abc 这种裸命令带尾巴的(用户约定:强检查不匹配)。 -const CMDS = new Set(['new', 'stop', 'compact', 'clear', 'status', 'help', 'list', 'switch', 'rename', 'delete', 'models']); +const CMDS = new Set(['new', 'stop', 'compact', 'clear', 'status', 'help', 'list', 'switch', 'rename', 'delete', 'models', 'think']); // 可带参数的命令:/new 尾随文本作首条消息;/switch /delete 吃 /list 编号或会话 id; -// /rename 吃新标题;/models 可带模型编号或完整 id。清单外的命令带尾巴仍按普通消息回落。 -const ARG_CMDS = new Set(['new', 'switch', 'rename', 'delete', 'models']); +// /rename 吃新标题;/models 可带模型编号或完整 id;/think 吃 on|off(1|0 同样认,隐式不写 help)。 +// 清单外的命令带尾巴仍按普通消息回落。 +const ARG_CMDS = new Set(['new', 'switch', 'rename', 'delete', 'models', 'think']); function parseCommand(text) { const t = String(text || '').trim(); @@ -178,6 +179,7 @@ const HELP_TEXT = [ '', '**模型**', '- `/models [编号]` 切换指定模型', + '- `/think on|off` 微信深度思考开关', '', '**上下文**', '- `/stop` 终止当前回合', @@ -199,7 +201,7 @@ function fmtTime(ts) { return (d.getMonth() + 1) + '-' + pad(d.getDate()) + ' ' + pad(d.getHours()) + ':' + pad(d.getMinutes()); } -function statusReply(db, s) { +function statusReply(db, s, channel) { const run = engine.getRun(s.id); const looping = !!(run && run.looping); const lines = [ @@ -208,6 +210,11 @@ function statusReply(db, s) { '- 状态:' + (looping ? '回合进行中' : (STATUS_TEXT[s.status] || s.status)), '- 模型:`' + (s.model_id || '未绑定') + '`', ]; + // 思考开关只对微信通道有意义(web 端用按钮,不读这列) + if (String(channel || '').startsWith('wx:')) { + const bt = db.prepare('SELECT deep_think FROM wechat_bindings WHERE id = ?').get(String(channel).slice(3)); + if (bt) lines.push('- 深度思考:' + (bt.deep_think !== 0 ? '开' : '关')); + } const t = db.prepare('SELECT cron_expr, next_run_at, last_run_at, last_status FROM scheduled_tasks WHERE session_id = ?').get(s.id); lines.push(t ? '- 定时任务:cron `' + t.cron_expr + '`,下次 ' + fmtTime(t.next_run_at) + '(上次 ' + fmtTime(t.last_run_at) + ' ' + (t.last_status || '-') + ')' @@ -228,15 +235,19 @@ function handleSend(db, opts) { const parsed = parseCommand(text); - // 普通消息:解析当前会话,无绑定自动新建(IM 用户不会先打 /new 才能聊天) + // 普通消息:解析当前会话,无绑定自动新建(IM 用户不会先打 /new 才能聊天)。 + // 微信通道以 binding 行的全局 deep_think 开关作消息的 deepThink 取值(与 H5 按钮 body 同义, + // 只是没得点、改用 /think 拨);非 wx 通道照旧不传 opts,行为零变化。 if (!parsed || parsed.normal) { + const wx = String(channel).startsWith('wx:'); + const deepThink = wx ? ((db.prepare('SELECT deep_think FROM wechat_bindings WHERE id = ?').get(channel.slice(3)) || {}).deep_think !== 0) : undefined; let s = boundSession(db, user, channel); let sent; if (!s) { - const r = newSessionFor(db, user, channel, text); + const r = newSessionFor(db, user, channel, text, wx ? { deepThink } : undefined); s = r.s; sent = r.sent; } else { - sent = engine.postUserMessage(s.id, text); + sent = engine.postUserMessage(s.id, text, wx ? { deepThink } : undefined); } log.info('msg', tag + ' channel 消息 → ' + s.id); return { kind: 'message', reply: '已发送到会话 ' + s.id, session_id: s.id, message_id: sent.message_id }; @@ -313,6 +324,26 @@ function handleSend(db, opts) { return { kind: 'command', reply: modelsReply(modelChoices(), s ? s.model_id : ''), session_id: s ? s.id : null }; } + // /think:微信全局深度思考开关——存用户 binding 行(不随会话/switch 丢),投递时替进 + // 既有 deepThink 参数(开=沿用现链路合并模型 thinking_params,关=什么都不带, + // 与 H5 按钮勾选/取消完全同构)。裸 /think 报当前态;1|0 隐式同义(不写 help)。 + if (cmd === 'think') { + const v = /^(on|1)$/i.test(parsed.rest) ? 1 : /^(off|0)$/i.test(parsed.rest) ? 0 : null; + if (parsed.rest && v === null) { + return { kind: 'command', reply: '用法:/think on|off', session_id: s ? s.id : null }; + } + const b = db.prepare('SELECT id, deep_think FROM wechat_bindings WHERE user = ?').get(user); + if (!b) { + return { kind: 'command', reply: '未绑定微信,此开关不适用', session_id: s ? s.id : null }; + } + if (v === null) { + return { kind: 'command', reply: '微信深度思考当前:' + (b.deep_think !== 0 ? '开' : '关') + '(/think on|off 切换)', session_id: s ? s.id : null }; + } + if (v !== b.deep_think) db.prepare('UPDATE wechat_bindings SET deep_think = ? WHERE id = ?').run(v, b.id); + log.info('task', tag + ' channel /think → ' + (v ? 'on' : 'off') + '(用户全局,binding ' + b.id + ')'); + return { kind: 'command', reply: '微信深度思考已' + (v ? '开启(后续消息带思考参数)' : '关闭(后续消息不带)'), session_id: s ? s.id : null }; + } + // 其余命令都作用于当前会话;无绑定时不隐式新建(那不是用户点这条命令的意图) if (!s) { return { kind: 'command', reply: '当前没有会话,请直接发送消息', session_id: null }; @@ -363,7 +394,7 @@ function handleSend(db, opts) { } // cmd === 'status' - return { kind: 'command', reply: statusReply(db, s), session_id: s.id }; + return { kind: 'command', reply: statusReply(db, s, channel), session_id: s.id }; } // HTTP 入口:POST /api/channel/send {channel?, text} → handleSend 结果。 diff --git a/app/server/wechat.js b/app/server/wechat.js index 6a62a9f..a956ab3 100644 --- a/app/server/wechat.js +++ b/app/server/wechat.js @@ -433,7 +433,7 @@ function attachBus() { busAttached = true; bus.onInternal((sessionId, event, data) => { if (event === 'assistant_message') { if (!data) return; } - else if (event !== 'done' && event !== 'tool_call' && event !== 'tool_result') return; + else if (event !== 'done' && event !== 'tool_call' && event !== 'tool_result' && event !== 'reasoning_delta') return; try { const cs = db.prepare('SELECT user, channel FROM channel_sessions WHERE session_id = ?').get(sessionId); if (!cs || !String(cs.channel || '').startsWith('wx:')) return; @@ -441,12 +441,13 @@ function attachBus() { if (event === 'assistant_message') enqueueDelivery(bid, () => onAssistantEvent(bid, data, sessionId)); else if (event === 'done') enqueueDelivery(bid, () => flushHeld(bid)); else { - // 工具调用/回执:心跳 + 台账记账;攒满一屏即经串行队列独立发台账(见策略注释第 4 条) + // 工具调用/回执:心跳 + 台账记账;攒满一屏即经串行队列独立发台账(见策略注释第 4 条)。 + // reasoning_delta(思考流)不进台账,只走下面的心跳——微信用户能看到「正在输入」在思考。 if (event === 'tool_call') { toolDigestPush(bid, data); if (getTurn(bid).tools.length >= DIGEST_MAX_LINES) enqueueDelivery(bid, () => flushLedger(bid, DIGEST_MAX_LINES)); } else if (event === 'tool_result') toolDigestMark(bid, data); - maybeTypingPing(bid); // 「正在输入」心跳:微信端在长工具回合里能看到 AI 还在干活 + maybeTypingPing(bid); // 「正在输入」心跳:长工具/思考回合里微信持续看到 AI 还在干活 } } catch (e) { log.warn('wechat', '投递监听异常:' + msg(e)); @@ -463,15 +464,16 @@ function enqueueDelivery(key, fn) { next.then(() => { if (deliveryQ.get(key) === next) deliveryQ.delete(key); }); } -// sendTyping 心跳:tool_call/tool_result 事件驱动(并行工具批会连发,2s 冷却去重); +// sendTyping 心跳:tool_call/tool_result 与 reasoning_delta(逐 token 高频)事件驱动; +// 冷却判定前置在查库之前,思考流的每帧开销只是两次 Map 读写(并行工具批/思考流都靠它去重); // 纯 UI 锦上添花,一切失败静默(wxbot 不可达/实例已销都不值得刷日志),不进入投递队列。 const typingLast = new Map(); // bid -> 上次发出时间戳 function maybeTypingPing(bid) { try { - const b = getBinding(bid); - if (!b || b.status !== 'online' || !b.wx_to_user) return; const t = now(); if (t - (typingLast.get(bid) || 0) < 2000) return; + const b = getBinding(bid); + if (!b || b.status !== 'online' || !b.wx_to_user) return; typingLast.set(bid, t); wxbotApi('POST', '/api/typing', { id: b.id, to: b.wx_to_user }, 5000).catch(() => {}); } catch (_) { /* 心跳尽力而为 */ } diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index b4c27a9..3adda8e 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -52,7 +52,7 @@ agent/ │ │ │ ├── sessions.js /api/sessions CRUD + 列表分页 │ │ │ ├── messages.js /api/sessions/:id/messages + SSE 流 + stop/release │ │ │ ├── files.js /api/sessions/:id/files 上传/列表/下载/删除 -│ │ │ ├── channel.js /api/channel/send 文本命令接入(IM/CLI 等无 UI 端;当前会话绑定 + /new /list /switch /rename /delete /models /stop /compact /clear /status /help) +│ │ │ ├── channel.js /api/channel/send 文本命令接入(IM/CLI 等无 UI 端;当前会话绑定 + /new /list /switch /rename /delete /models /think /stop /compact /clear /status /help) │ │ │ ├── wechat.js /api/wechat 绑定管理(设置页)+ /wxhook 内网回调(微信接入,见 §5.13) │ │ │ ├── config.js /api/config 读写(含 api_key/password 脱敏) │ │ │ ├── platforms.js /api/platforms/balance 余额查询 @@ -430,7 +430,7 @@ AI 通过 `schedule` 工具为所在会话建周期性任务(`scheduled_tasks` 背景:仓库内 `wxbot/`(已入库,作为根 compose 的 `wxbot` 服务)是基于官方 iLink 协议 SDK 的微信「调制解调器」,只挂 `agent-mcp-net` 内网、不暴露公网;身份权威与全部会话逻辑在 core,引擎不感知微信。 - **模型**:一条 `wechat_bindings` = 一个 core 用户 = 一个 bot 实例(一人一绑,换号先解绑)。binding id 三用:实例控制/投递的寻址键、wxbot 凭证目录名、channel 键(`channel='wx:'+id`,因此命令层、会话自动新建、投递游标查询全部白借 §5.4 的 channel 机制,零新逻辑)。iLink 协议保证扫码登录后仅本人可与 bot 单线对话,无陌生人入口,故无联系人授权面。 -- **方向三条线**:① Web(设置页→账户→微信内联卡)→ `/api/wechat` → wxbot `/api/instances*`(实例控制;QR SVG 代理内联渲染,只在 has_qr 就绪后取码,服务 token 不出内网);② wxbot 收信 → `POST core:/wxhook/inbox` → 直调 `channel.handleSend()`(文本;image/video/file 媒体先落会话任务目录:带说明文字的拼「用户上传了文件」告知行+正文并进一回合,单发媒体只补一行 `wx_media` 留痕不触发回合(下次真实对话模型自然看到,「刚才那张图」指代不断),同 web 附件链路;voice 走 iLink 服务端自动转写(msg.text 即识别文字),按文本类转发——命令回执同步回文本;普通消息不回执,等异步投递);③ core 总线监听 assistant_message/done → 按回合回复预算分配投递(见下两条),分段(~1800 字/段,行优先聚合)→ `POST wxbot:/api/deliver` → `bot.send`;wxbot 出口 markdown 默认透传(微信已支持渲染;env `WXBOT_STRIP_MARKDOWN=1` 恢复 stripMarkdown 纯文化降级);tool_call/tool_result 事件另发 `/api/typing` sendTyping 心跳(每绑定 2s 冷却、失败静默),长工具回合里微信持续显示「正在输入」,文本投递后自动取消;同一对事件还记账工具台账(见下段)。 +- **方向三条线**:① Web(设置页→账户→微信内联卡)→ `/api/wechat` → wxbot `/api/instances*`(实例控制;QR SVG 代理内联渲染,只在 has_qr 就绪后取码,服务 token 不出内网);② wxbot 收信 → `POST core:/wxhook/inbox` → 直调 `channel.handleSend()`(文本;image/video/file 媒体先落会话任务目录:带说明文字的拼「用户上传了文件」告知行+正文并进一回合,单发媒体只补一行 `wx_media` 留痕不触发回合(下次真实对话模型自然看到,「刚才那张图」指代不断),同 web 附件链路;voice 走 iLink 服务端自动转写(msg.text 即识别文字),按文本类转发——命令回执同步回文本;普通消息不回执,等异步投递);③ core 总线监听 assistant_message/done → 按回合回复预算分配投递(见下两条),分段(~1800 字/段,行优先聚合)→ `POST wxbot:/api/deliver` → `bot.send`;wxbot 出口 markdown 默认透传(微信已支持渲染;env `WXBOT_STRIP_MARKDOWN=1` 恢复 stripMarkdown 纯文化降级);tool_call/tool_result 与 reasoning_delta(思考流,只进心跳不进台账)事件另发 `/api/typing` sendTyping 心跳(每绑定 2s 冷却、失败静默),长工具/思考回合里微信持续显示「正在输入」,文本投递后自动取消;同一对事件还记账工具台账(见下段)。 - **渠道上下文**(ensureChannelContext,普通/媒体/带尾随文本的 /new 收信时幂等确保,先于首条消息入库):微信会话直接落 executing(跳过顾问 handoff,与定时任务同理由)+ 注入一条 `channel_note` user 行(微信环境说明:单线纯文本、给链接即交付卡片、入站文件已存工作目录等,AI 第一回合即知);/clear 删光历史后下条消息自动重注入。 - **出站文件(链接→卡片)**:sendAttachments 扫正文 `/p/<22位id>` 链 → 同进程 `publicFiles.resolve` + 归属硬校验(只转本会话签发的链接,防外流)→ 本地读字节(单文件≤20MB、每条回复最多 5 个)→ `POST wxbot:/api/deliver_media` → SDK 按扩展名自动路由 image/video/file 卡片;尽力而为:失败只 warn,链接文字留在正文作兜底(AI 无需感知卡片机制,channel_note 已告知「给链接即交付」)。 - **投递游标** `last_msg_id` 落库 + 每绑定串行队列:重启不重发旧回复,wxbot 短暂不可达不丢(下一条连带补齐);errAck/纯工具轮(空文本)不进微信,`__blocks__` 图消息降级为占位文案。markdown 的出口处理在 wxbot:默认透传(微信已支持渲染),`WXBOT_STRIP_MARKDOWN=1` 时 stripMarkdown 纯文化。 @@ -496,7 +496,7 @@ AI 通过 `schedule` 工具为所在会话建周期性任务(`scheduled_tasks` | `/api/platforms` | `routes/platforms.js` | `GET /balance?pi=&ki=` 余额 | | `/api/system` | `routes/system.js` | `GET /status` + `/restart?force=...`(原 `model_profiles` 可用名单字段已删,前端无消费方) | | `/api/profile` | `routes/profile.js` | `GET /` 读画像、`PUT /` 保存(三字段 + enabled);按 `req.user` 隔离,逻辑全在 `user-profile.js`(快照冻结见 engine `createSession`/`clearSessionMessages`;日常更新由 AI 经 `profile` 工具增量维护,见 §5.4) | -| `/api/channel` | `routes/channel.js` | `POST /send {channel, text}` 文本命令接入端(IM/CLI 等无 UI 客户端,走 Basic/cookie 鉴权):命令仅在本入口解析(Web 消息路由不受影响,防误伤路径/代码文本);严格匹配白名单 `/new[文本] /list /switch[编号] /rename[标题] /delete[编号] /models[编号] /stop /compact /clear /status /help`(可带参数命令走 ARG_CMDS:switch/delete 编号=最近 /list 行号或 id 前缀,delete 删会话连同任务目录(同 Web 删除弹窗默认勾选),models 换绑复用 engine.bindToSession),未知斜杠词回提示、不像命令的当普通消息;(user,channel) 经 `channel_sessions` 表绑定当前会话(普通消息无绑定自动建);命令动作不落消息行(与 Web 按钮对称),AI 回复由接入端复用既有 SSE/详情接口获取;`handleSend()` 另供微信桥接直调 | +| `/api/channel` | `routes/channel.js` | `POST /send {channel, text}` 文本命令接入端(IM/CLI 等无 UI 客户端,走 Basic/cookie 鉴权):命令仅在本入口解析(Web 消息路由不受影响,防误伤路径/代码文本);严格匹配白名单 `/new[文本] /list /switch[编号] /rename[标题] /delete[编号] /models[编号] /think[on|off] /stop /compact /clear /status /help`(可带参数命令走 ARG_CMDS:switch/delete 编号=最近 /list 行号或 id 前缀,delete 删会话连同任务目录(同 Web 删除弹窗默认勾选),models 换绑复用 engine.bindToSession,think 读写用户 wechat_bindings.deep_think——微信全局深度思考开关(H5 按钮的指令形态,默认开,投递时替进既有 deepThink 参数)),未知斜杠词回提示、不像命令的当普通消息;(user,channel) 经 `channel_sessions` 表绑定当前会话(普通消息无绑定自动建);命令动作不落消息行(与 Web 按钮对称),AI 回复由接入端复用既有 SSE/详情接口获取;`handleSend()` 另供微信桥接直调 | | `/api/wechat` | `routes/wechat.js` | 微信绑定管理(设置页,cookie 鉴权 + req.user 隔离):`GET /`(enabled/alive/我的绑定)、`POST /`(新建绑定,一人一绑)、`GET /:id/qr`(登录二维码 SVG 代理)、`POST /:id/refresh`(重发登录)、`DELETE /:id`(解绑,销毁实例与凭证);业务全在 `wechat.js`(§5.13) | | `/wxhook` | `routes/wechat.js`(hookRouter) | wxbot → core 内网回调(**挂 auth.middleware 与全局 express.json 之前**,自带 32mb 解析器容纳媒体 base64):`POST /inbox {id, from, text, media?}` 文本/媒体转 channel 层——media={kind:image\|video\|file, b64, filename?},core 按 magic 嗅探定扩展名、落会话任务目录(文件保留消毒原名,图/视频生成 wximg-/wxvid- 时间戳名)+ 记 files 表 + 拼「用户上传了文件:<名>」告知行(同 web 附件模式,vision 模型 read_file 即见);非 2xx 时 wxbot 把 error 文案回给微信用户;`POST /hook {id, event}` 实例状态回报;Bearer 共享服务 token(哈希后定长比较,未配一律 503) | | `/api/models` | `server.js` | 模型池(在用会话数 slots_used / 在用会话列表,非独占展示)+ token 用量 |