@rezti/dsh-rez-task-handoff 0.1.0-beta.1 → 0.1.0-beta.2

package/README.md

@@ -1,10 +1,10 @@
-# Jarvis 跨会话任务交接（模拟版 0.1.0-beta.1）
+# Jarvis 跨会话任务交接（模拟版 0.1.0-beta.2）
 
 适用目标：DeepSeek Harness 桌面版，宿主 0.2.1-rc.5，Aurabot 1.1.24，desktop profile。只接受成功、失败、超时、需要确认四种模拟任务。没有 HA、摄像头、真实设备、系统命令或任意任务执行入口。不依赖或改动 RezSuite。
 
 ## 从 npm 下载并检查
 
-这是通过 npm 分发的 **Aurabot 用户模块**。先在临时目录下载、解包并核对目标机：
+这是通过 npm 分发的 **Aurabot 用户模块**。以下命令下载已发布的 beta.1。测试 beta.2 本地包时，把对应的压缩包解压到临时目录即可。
 
 ```bash
 cd "$(mktemp -d)"
@@ -18,7 +18,7 @@ node package/inspect.mjs
 ## 接口与取舍
 
 - [Aurabot 1.1.24 用户模块 API](https://github.com/aureth-labs/dsh-aurabot-qq/blob/v1.1.24/src/modules/API.md)：使用 API v1 的 `tool`、`defineTool`、`prompt`、`rule`、`settings`、`isOwner`、`dataDir`、`every` 和卸载回调。用户模块目录与插件安装目录分离，升级保留；本扩展检测到其他 Aurabot 版本会停用，待核对再放开。
-- 从 1.1.24 源码验证：Aurabot 在 QQ agent 的 `agent.ctx.tools` 上挂模块工具。“纯聊天”档不挂模块工具；需要已有的支持工具档位。不能仅靠 `turnHasOwner`（在群里出现主人也可能为真）。本模块同时核对配置的主人、原私聊 ID、实际执行会话、可信入站 prompt 的一次性标记。只在用户提到 Jarvis 或交接时建立该轮标记，提交还要求明确提出 Jarvis / 交接测试。群聊、其他私聊、后台轮、DSH 直接输入、回传轮都不能触发。
+- 从 1.1.24 源码验证，Aurabot 在 QQ agent 的 `agent.ctx.tools` 上挂模块工具。“纯聊天”档不挂模块工具，需要已有的支持工具档位。本模块同时核对配置的主人、原私聊 ID、实际执行会话和最新入站消息的可信标记。主人私聊的普通消息可查状态，提交须明确发送「让 Jarvis 做交接测试 success」或指定其他模拟模式。群聊、其他私聊、后台轮、DSH 直接输入、回传轮都不能触发。
 - DSH 0.2.1-rc.5 发行包已验证 `agents.get`、`Agent.followup`、`session/event`、`ToolRuntime.restrict/guard` 与 `exec.concludeTurn()`。用固定的完整会话 ID 定位已打开的 Jarvis。用唯一输入消息 ID 关联 `user/message` 与对应 `turn/end`，且只有模拟工具的结果可成为任务结果。`whenIdle()` 只用于清理；它不是具体任务的完成回执。测试运行时实际装载了同版本 AgentLoop。
 - 回传使用原 QQ Agent 的原生 follow-up。Aurabot 的聊天中枢会监听原会话事件并发送普通回复。以 `hub.sessions()`、`chatOfSession()` 做最后校验，映射变更、Agent 不在、主人静音时先等；通知最多等待十分钟。本机发布代码与真实核心的隔离测试证明这条路径成立。Aurabot 的 hub 映射和自动转发是版本相关的实现，未宣称跨版本稳定。没有采用 `api.think`：它会走后台会话。
 - [dsh-peer-bus](https://github.com/ybh1291747665/dsh-peer-bus) 和 [dsh-cross-session-agent](https://github.com/dd2673/dsh-cross-session-agent) 有成熟的会话间寻址、投递思路，但不能直接提供这里要求的 Aurabot 主人私聊作用域、模拟业务结果与原 QQ 回传闭环。这里复用原生 follow-up，不另造通信协议或引入跨进程桥。
@@ -31,7 +31,7 @@ node package/inspect.mjs
 - 执行：`running`、`completed`、`failed`、`timed_out`、`needs_confirmation`、`interrupted`。只有同一模拟任务的工具结果和匹配的正常轮次结束才算完成。确认须由同一主人在原私聊发出完整的 `确认交接 <任务 ID>`，十分钟内有效。此确认仅用于模拟流程。
 - 回传：待投递、已提交原会话、原会话已生成回复、结果不明、关闭回传或过期。正常回复链路没有供模块使用的 QQ 发送回执；**生成回复不代表 QQ 已发送，更不代表对方已读**。结果不明不自动补发。可在主人私聊询问「查交接 <任务 ID>」；这是最小的取回方式，不冒险另外发一条重复通知。
 - 同一模型输入重试提交复用任务 ID；同一模拟步骤持久化领取后只能执行一次；通知先写入投递记录再提交。进程或模块中断后，未结束的任务记为中断，不自动重跑；已提交/结果不明的通知不重发。已经排入 DSH inbox 的消息属于 DSH，无法撤回。暂不支持跨进程、冷 Jarvis 自动恢复、真实 QQ 回执或 OneBot 入口去重保证。
-- Jarvis 试验轮只暴露一个无害模拟工具；工具守卫拒绝其他工具，隔离检查失败则不投递。回传轮也临时禁用工具调用。部署时请使用**专用的 Jarvis 测试会话，不配置真实设备工具或自动任务**。临时工具限制不修改会话原有预设，进程重启后也不是一个长期权限配置。
+- Jarvis 试验轮只暴露一个无害模拟工具。使用 DSH 的临时限制屏蔽继承的工具，工具守卫拒绝其他工具调用。对于从预设继承的 PTC，试验轮用 `presentAs('native')` 临时以原生方式呈现工具，轮次结束后撤销。如果存在无法切换的 PTC 声明或无法屏蔽的会话本地工具，任务会在投递前失败。回传轮也临时禁用工具调用。部署时请使用**专用的 Jarvis 测试会话，不配置真实设备工具或自动任务**。
 
 ## 安装与回滚
 
@@ -40,6 +40,8 @@ node package/inspect.mjs
 3. 在 Aurabot 扩展面板输入自己指定的主人 QQ 与 Jarvis 完整会话 ID，先只勾选模拟交接。保持目标会话可用。启用后，提交模拟任务将调用配置中的模型，可能产生普通模型用量；自动回传开关仍关闭。真实 QQ 测试经用户确认后才开启回传，继续遵守 Aurabot 的总开关和试运行。
 4. 回滚：先关闭模块内启用与回传开关，等待测试轮结束，再从扩展面板停用模块，并将 `modules/rez-task-handoff/` 移出扫描目录。只影响这个模块，不覆盖大肥鱼、RezSuite 或桌面应用。账本位于 Aurabot 数据目录下的 `modules-data/rez-task-handoff/tasks.json`，可备份留查；卸载不删除它。已提交到 DSH 或网关的消息不能从模块撤回。
 
+从 beta.1 升级时，等当前测试和回传结束，停用扩展并将旧目录移出扫描目录，再按相同的模块目录名放入新版并启用。账本格式兼容。需要回滚时，按同样方法换回旧目录。查询支持完整任务编号或显示的 8 位短编号，发生短编号冲突时需提供完整编号。
+
 ## 测试与实机验收
 
 快速单元测试（纯 Node，零依赖）：
@@ -56,6 +58,6 @@ HANDOFF_AURABOT_FIXTURE=/绝对路径/aurabot-1.1.24 \
 HANDOFF_REAL_DELAY=1 node --test test/native.test.mjs
 ```
 
-2026-11-04 结果：8 项单元测试、1 项原生组合测试均通过。真实延时模式由 Aurabot 从临时用户模块目录加载，两条各约 20 秒的任务（成功和失败）约 42 秒完成；等待期间原会话能继续聊天，后续输出使用原会话并各发送一次到模拟 OneBot。单元测试覆盖超时、明确确认、目标丢失、源会话更换、权限隔离、重复提交和模块重启时的账本恢复。未模拟整机断电。生产 Mac mini 的版本、模块真实激活、模型能否稳定调用工具和手机实际收到 QQ 回传都还待联调。Aurabot 面板自身的模拟会话没有真实主人私聊映射，不用它来验收本扩展。
+2026-11-04 beta.2 结果为 11 项单元测试、1 项原生组合测试通过。Aurabot 从临时用户模块目录加载扩展。两条各约 20 秒的任务（成功和失败）约 42 秒完成，等待期间原会话能继续聊天，后续输出各发送一次到模拟 OneBot。Jarvis 从 PTC 预设继承的工具呈现方式在任务结束后恢复。单元测试覆盖超时、确认、目标丢失、源会话更换、权限隔离、重复提交、模块重启恢复、短编号查询，以及含糊的重试不入队。beta.2 尚未在目标 Mac mini 和真实 QQ 上验证，也未模拟整机断电。Aurabot 面板自身的模拟会话没有真实主人私聊映射。
 
 实机顺序：主人私聊发送「让 Jarvis 做交接测试 success」→ 拿到编号 → 立即再聊一句 → 等结果；接着连续发两条（等各自收到编号，避免上游合并为一轮），再分别测 failure、timeout、confirmation。最后用同一任务 ID 查询状态，并验证非主人和群聊不会产生任务。断电/重启测试先把相关工作保存，确认测试实例处于安全状态后单独做。

package/module/index.mjs

@@ -17,6 +17,8 @@ const sameId = (a, b) => Boolean(sidKey(a) && sidKey(a) === sidKey(b))
 const exactId = agent => String(agent?.session?.id ?? '')
 const idPattern = /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,127}$/
 const ownerPattern = /^\d{5,15}$/
+const submitPattern = /^(?:请\s*)?(?:让\s*Jarvis\s*(?:做|重做)\s*)?交接\s*测试(?:\s+(success|failure|timeout|confirmation))?$/i
+const submitHint = '请在主人 QQ 私聊发送「让 Jarvis 做交接测试 success」发起一条新的模拟任务。'
 const pluginMessage = (id, text) => ({
   id, role: 'user', source: { kind: ID, form: 'relay' },
   content: [{ type: 'text', text }],
@@ -96,7 +98,8 @@ export function setupHandoff(api, { now = Date.now, delay = sleep, demoMs = 20_0
       const e = session.eventAt(seq)
       if (e?.type === 'turn/start' || e?.type === 'turn/end') break
       if (e?.type !== 'user/message') continue
-      if (e.data?.source?.kind !== 'aurabot') continue
+      if (e.data?.source?.kind === 'runtime-context') continue
+      if (e.data?.source?.kind !== 'aurabot') return
       for (const block of e.data.content ?? []) {
         if (block?.type !== 'text' || typeof block.text !== 'string' || !block.text.startsWith(STAMP)) continue
         const permit = permits.get(block.text)
@@ -107,25 +110,27 @@ export function setupHandoff(api, { now = Date.now, delay = sleep, demoMs = 20_0
         permit.messageId = e.data.id
         return { c, id, messageId: e.data.id, confirm: permit.confirm, requested: permit.requested }
       }
+      return
     }
   }
 
   api.on('prompt', (content, info) => {
     const c = config()
     const sid = String(info?.sessionId ?? '')
-    if (!c || !sid || info.steer || info.chat?.kind !== 'private' ||
+    if (!c || !sid || info.chat?.kind !== 'private' ||
         info.chat.chatId !== c.chatId || String(info.senderId) !== c.owner ||
         !mapped(c.chatId, sid)) return
     const source = findAgent(sid)
     if (!source || sameId(exactId(source), c.target)) return
     sourceAgents.set(c.chatId, source)
     const query = String(info.queryText ?? '').trim()
-    if (!/jarvis|交接/i.test(query)) return
     const stamp = STAMP + randomUUID() + ']'
     const confirm = /^确认交接\s+([a-f0-9-]{36})$/i.exec(query)?.[1]?.toLowerCase()
     for (const [key, p] of permits) if (now() - p.at >= QUEUE_LIMIT) permits.delete(key)
     if (permits.size >= 256) permits.delete(permits.keys().next().value)
-    permits.set(stamp, { chatId: c.chatId, sessionId: sid, at: now(), confirm, requested: /jarvis|交接测试/i.test(query) && !confirm })
+    const request = submitPattern.exec(query)
+    permits.set(stamp, { chatId: c.chatId, sessionId: sid, at: now(), confirm,
+      requested: request ? (request[1]?.toLowerCase() ?? 'success') : undefined })
     return [...content, { type: 'text', text: stamp }]
   })
 
@@ -137,13 +142,13 @@ export function setupHandoff(api, { now = Date.now, delay = sleep, demoMs = 20_0
     return [
       api.defineTool({
         name: 'rez_handoff_submit',
-        description: '提交无害的 Jarvis 模拟交接。立即返回任务编号；真实设备和其他操作不受支持。',
+        description: '提交主人明确指定的 Jarvis 模拟交接。以主人当条消息指定的模式为准，立即返回任务编号。',
         properties: { mode: { type: 'string', enum: MODES } },
         required: ['mode'],
         execute(args, exec) {
           const auth = authorize(where, exec)
           if (!auth) return denied()
-          if (!auth.requested) return { ok: false, message: '请明确提出 Jarvis 模拟交接测试。' }
+          if (!auth.requested) return { ok: false, message: submitHint }
           if (!MODES.includes(args?.mode)) return { ok: false, message: '只支持四种模拟任务。' }
           const existing = ledger.tasks().find(t => t.sourceSessionId === auth.id && t.requestId === auth.messageId)
           if (existing) return result(existing)
@@ -158,7 +163,7 @@ export function setupHandoff(api, { now = Date.now, delay = sleep, demoMs = 20_0
             const t = {
               id: randomUUID(), sourceChatId: auth.c.chatId, sourceSessionId: auth.id,
               requestId: auth.messageId, targetSessionId: auth.c.target,
-              mode: args.mode, state: 'queued', createdAt: now(), updatedAt: now(), notices: [],
+              mode: auth.requested, state: 'queued', createdAt: now(), updatedAt: now(), notices: [],
             }
             tasks.push(t)
             return t
@@ -168,13 +173,17 @@ export function setupHandoff(api, { now = Date.now, delay = sleep, demoMs = 20_0
       }),
       api.defineTool({
         name: 'rez_handoff_status',
-        description: '查看主人私聊提交的任务状态与回传状态。省略编号时查询最新一条。',
+        description: '查看主人私聊提交的任务状态与回传状态。接受完整编号或显示的 8 位短编号，省略则查询最新一条。',
         properties: { taskId: { type: 'string' } },
         execute(args, exec) {
           const auth = authorize(where, exec)
           if (!auth) return denied()
-          const t = ledger.tasks().findLast(t => t.sourceChatId === auth.c.chatId &&
-            (!args?.taskId || t.id === args.taskId))
+          const taskId = String(args?.taskId ?? '').trim().toLowerCase()
+          const short = /^[a-f0-9]{8}$/.test(taskId)
+          const tasks = ledger.tasks().filter(t => t.sourceChatId === auth.c.chatId &&
+            (!taskId || (short ? t.id.startsWith(taskId) : t.id === taskId)))
+          if (short && tasks.length > 1) return { ok: false, message: '短编号对应多条任务，请提供完整任务编号。' }
+          const t = tasks.at(-1)
           if (!t) return { ok: false, message: '未找到该任务。' }
           const notice = t.notices.at(-1)
           return { ...result(t), notification: notice?.state ?? 'not_ready',
@@ -211,7 +220,7 @@ export function setupHandoff(api, { now = Date.now, delay = sleep, demoMs = 20_0
     ]
   })
   api.rule(kind => kind === 'private' && config()
-    ? '主人要求做 Jarvis 交接测试时用 rez_handoff_submit。回复任务编号并继续聊天，不要等待。结果回传轮只简短告知结果，不调用工具。' : '')
+    ? '主人明确说「让 Jarvis 做交接测试 success」或指定 failure、timeout、confirmation 时用 rez_handoff_submit，保留完整任务编号。询问 Jarvis 能做什么时，说明本模块只支持这四种模拟，不提交任务。「再试一下」本身不提交任务，可提示主人发一条明确的模拟测试请求。查交接状态用 rez_handoff_status。只有工具确认入队时才说已入队。结果回传轮只简短告知结果，不调用工具。' : '')
 
   function release(run) {
     if (active === run) active = undefined
@@ -225,13 +234,18 @@ export function setupHandoff(api, { now = Date.now, delay = sleep, demoMs = 20_0
     const run = { id: task.id, target: exactId(agent), messageId: randomUUID(), abort: new AbortController(), offs: [],
       deadline: now() + (task.mode === 'timeout' ? TIMEOUT_DEMO : RUN_LIMIT) }
     active = run
+    let isolationError = 'Jarvis 工具隔离接口不可用，请使用专用的标准会话。'
     try {
       if (typeof tools?.guard !== 'function' || typeof tools?.register !== 'function' ||
           typeof tools?.restrict !== 'function' || typeof agent.whenIdle !== 'function') {
         throw new Error('Jarvis 的工具隔离接口不可用。')
       }
-      const visible = registry.schemas(agent).map(t => t.name)
-      if (visible.length) run.offs.push(tools.restrict({ deny: visible }))
+      if (registry.schemas(agent).some(t => t.name === 'run_code')) {
+        isolationError = 'Jarvis 的 PTC 工具模式无法临时切换，请使用专用的标准会话。'
+        run.offs.push(tools.presentAs('native'))
+      }
+      isolationError = 'Jarvis 工具隔离检查失败，请使用专用的标准会话。'
+      run.offs.push(tools.restrict({ allow: [] }))
       run.offs.push(tools.guard(exec => exec.name === MOCK ? undefined : 'Jarvis 模拟会话禁止使用其他工具。'))
       run.offs.push(tools.register(api.defineTool({
         name: MOCK,
@@ -263,7 +277,10 @@ export function setupHandoff(api, { now = Date.now, delay = sleep, demoMs = 20_0
         },
       })))
       const remaining = registry.schemas(agent).map(t => t.name)
-      if (remaining.length !== 1 || remaining[0] !== MOCK) throw new Error('Jarvis 仍暴露其他工具或使用 PTC 模式。')
+      if (remaining.length !== 1 || remaining[0] !== MOCK) {
+        isolationError = 'Jarvis 仍有额外工具，模拟任务未投递。请使用专用的标准会话。'
+        throw new Error(isolationError)
+      }
       changed(tasks => {
         const t = tasks.find(t => t.id === task.id)
         t.run = { messageId: run.messageId, deadline: run.deadline }
@@ -273,7 +290,7 @@ export function setupHandoff(api, { now = Date.now, delay = sleep, demoMs = 20_0
       try { if (!broken) changed(tasks => {
         const t = tasks.find(t => t.id === task.id)
         if (t && ['queued', 'running'].includes(t.state)) {
-          setState(t, 'failed', 'Jarvis 工具隔离检查失败，请选用专用的普通对话会话。', now())
+          setState(t, 'failed', isolationError, now())
         }
       }) } finally { release(run) }
       return
@@ -424,7 +441,7 @@ export function setupHandoff(api, { now = Date.now, delay = sleep, demoMs = 20_0
 export default {
   id: ID,
   name: 'Jarvis 跨会话交接（模拟）',
-  version: '0.1.0-beta.1',
+  version: '0.1.0-beta.2',
   api: 1,
   description: '把主人私聊的模拟任务交给指定 Jarvis 会话并回传结果。',
   settings: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rezti/dsh-rez-task-handoff",
-  "version": "0.1.0-beta.1",
+  "version": "0.1.0-beta.2",
   "description": "Aurabot user module for simulated cross-session Jarvis task handoffs in DeepSeek Harness.",
   "type": "module",
   "main": "./module/index.mjs",