metame-cli 1.5.3 → 1.5.5

package/scripts/daemon.yaml

@@ -347,3 +347,10 @@ daemon:
     - mcp__notionApi__*
   models:
     claude: sonnet
+
+# Intent Engine — UserPromptSubmit hook modules
+# Set any key to false to disable that intent module.
+hooks:
+  team_dispatch: true   # team member dispatch hints
+  ops_assist: true      # /undo /restart /logs /gc hints
+  task_create: true     # task scheduling hints

package/scripts/docs/agent-guide.md

@@ -25,7 +25,7 @@
 
 > 用 codex 建一个代码审查 agent，目录 ~/projects/pr-review
 
-在桌面 Claude Code 终端，需要手动操作：
+在桌面 Claude Code 终端，操作步骤：
 1. 创建项目目录和 CLAUDE.md（角色定义）
 2. 编辑 `~/.metame/daemon.yaml`，在 `projects` 下新增：
    ```yaml
@@ -35,7 +35,12 @@
        cwd: "~/projects/my-bot"
        icon: "🤖"
    ```
-3. 运行 `touch ~/.metame/daemon.js` 触发热重载
+3. 保存文件即可 —— daemon 检测到变更后自动：
+   - 创建 `~/.metame/agents/my_bot/`（soul.md、memory-snapshot.md、agent.yaml）
+   - 在 cwd 里建 SOUL.md、MEMORY.md 软链
+   - 将 `agent_id` 写回 daemon.yaml
+
+**无需**手动执行 `/agent soul repair` 或 `touch` 任何文件。
 
 ### Step 3: 绑定群聊
 告知用户：
@@ -43,20 +48,48 @@
 
 `/activate` 会自动将群与最近创建的 Agent 绑定（30分钟内有效）。
 
+## 创建团队成员（Team Wizard）
+
+用于在一个项目下创建多个并行工作的 Agent 分身（team members）。
+
+### 触发方式
+
+手机端发送自然语言（如"创建团队"、"建个工作组"）或直接发送：
+
+```
+/agent new team
+```
+
+## 创建分身（Clone Wizard）
+
+为当前 Agent 创建一个克隆分身——共享同一个 `CLAUDE.md` 角色定义（symlink），运行在独立的工作目录。
+
+### 触发方式
+
+手机端发送自然语言（如"分身"、"克隆"、"副本"、"另一个自己"）或直接发送：
+
+```
+/agent new clone
+```
+
+分身的 `CLAUDE.md` 指向父 Agent 角色定义（改父角色分身同步生效），需手动绑定群：新建群 → 加 bot → `/activate`
+
 ## 常用命令速查
 
 | 操作 | 手机端命令 |
 |------|-----------|
 | 新建 Agent | `/agent new` 或自然语言"创建agent" |
+| 创建团队成员 | `/agent new team` 或自然语言"创建团队" |
+| 创建分身（克隆） | `/agent new clone` 或自然语言"分身/克隆/副本" |
 | 绑定群 | `/activate` 或 `/agent bind <名称> [目录]` |
 | 查看列表 | `/agent list` |
 | 编辑角色 | `/agent edit` |
 | 解绑群 | `/agent unbind` |
 | 切换 Agent | 直接@昵称（仅非专属群） |
+| 向团队成员发消息 | `/msg <昵称> <内容>` |
 
 ## 注意事项
 - 专属群（chat_agent_map 中的群）永远绑定同一个 Agent，不能通过昵称切换
 - 新群必须发 `/activate` 才能使用，未授权群会提示"此群未授权"
 - Codex 当前限制（MVP）：`/sessions` 列表暂只展示 Claude 本地会话，Codex 会话暂不可见
 - Codex 当前限制（MVP）：`/compact` 暂不支持，请继续在同一会话中对话
-- 需要定位脚本入口、升级步骤或文件落点时，先看 `~/.metame/docs/pointer-map.md`

package/scripts/docs/hook-config.md

@@ -0,0 +1,134 @@
+# MetaMe Hook / Intent Engine 配置手册
+
+> 自动部署到 `~/.metame/docs/hook-config.md`。源文件：`scripts/docs/hook-config.md`。
+
+---
+
+## 架构概览
+
+```
+UserPromptSubmit (每轮用户输入)
+  ├── signal-capture.js      → 捕获用户偏好信号（写文件，不注入）
+  └── intent-engine.js       → 意图检测 + 按需注入 additionalSystemPrompt
+
+Stop (每轮结束)
+  └── stop-session-capture.js → session 事件日志 + 工具失败捕获
+```
+
+`scripts/intent-registry.js` 是单一维护源，负责调用各意图模块并返回提示块。
+`intent-engine.js` 是 Claude hook adapter；daemon 里的 Codex 路径也复用同一 registry。
+零匹配 → 零输出（不浪费 token）。
+
+---
+
+## 当前意图模块
+
+| 模块 key | 文件 | 触发条件 | 注入内容 |
+|---------|------|---------|---------|
+| `team_dispatch` | `intent-team-dispatch.js` | 检测到"告诉/让/发给 + 成员名"等联络意图 | `dispatch_to` 命令提示（仅匹配成员） |
+| `ops_assist` | `intent-ops-assist.js` | 回退/日志/重启/gc/状态 相关语境 | `/undo` `/restart` `/logs` `/gc` `/status` 命令提示 |
+| `task_create` | `intent-task-create.js` | 定时/提醒/每天X点 等调度语境 | `/task-add` 命令用法提示 |
+| `file_transfer` | `intent-file-transfer.js` | "发给我/发过来/导出" 等文件传输语境 | `[[FILE:...]]` 协议 + 收发规则 |
+| `memory_recall` | `intent-memory-recall.js` | "上次/之前/还记得" 等跨会话回忆语境 | `memory-search.js` 命令用法 |
+| `doc_router` | `intent-doc-router.js` | "创建/绑定 Agent"、"代码结构/脚本入口"、"hook/intent 配置" 等文档导向语境 | 统一 doc-router 文档指引 |
+---
+
+## 开关控制
+
+在 `~/.metame/daemon.yaml` 的 `hooks:` 段控制（不需要改代码）：
+
+```yaml
+hooks:
+  team_dispatch: true   # 改为 false 可禁用
+  ops_assist: true
+  task_create: false    # 禁用任务调度提示
+```
+
+改完立即生效（intent-engine 每次运行时读取）。
+**不需要重启 daemon。**
+
+---
+
+## 新增意图模块（标准步骤）
+
+1. **创建模块文件** `scripts/hooks/intent-<name>.js`：
+
+```js
+'use strict';
+/**
+ * @param {string} prompt     - 已清洗的用户输入
+ * @param {object} config     - daemon.yaml 完整配置
+ * @param {string} projectKey - 当前 METAME_PROJECT
+ * @returns {string|null}     - 提示文本，或 null（不注入）
+ */
+module.exports = function detect<Name>(prompt, config, projectKey) {
+  // 检测意图，返回 hint 字符串或 null
+  if (!/你的关键词/.test(prompt)) return null;
+  return '[提示标题]\n- 具体提示内容';
+};
+```
+
+2. **注册到 intent-engine.js**：
+
+```js
+// scripts/hooks/intent-engine.js
+const INTENT_MODULES = {
+  team_dispatch: './intent-team-dispatch',
+  ops_assist:    './intent-ops-assist',
+  task_create:   './intent-task-create',
+  your_name:     './intent-<name>',   // ← 加这行
+};
+
+const DEFAULTS = {
+  // ...
+  your_name: true,  // ← 加这行（默认开启）
+};
+```
+
+文档路由类场景优先复用 `scripts/hooks/doc-router.js`，只传 `patterns + title + docPath + summary`，不要再为每个文档问题单独建样板模块。
+
+3. **在 daemon.yaml 加开关**（可选，默认开）：
+
+```yaml
+hooks:
+  your_name: true
+```
+
+4. **部署**：`node index.js`（同步文件到 `~/.metame/hooks/`）
+
+5. **验证**：
+```bash
+echo '{"prompt":"触发词"}' | node ~/.metame/hooks/intent-engine.js
+```
+
+---
+
+## 调试
+
+```bash
+# 测试某个 prompt 是否触发意图
+echo '{"prompt":"告诉工匠去做这个"}' | METAME_PROJECT=business node ~/.metame/hooks/intent-engine.js | python3 -m json.tool
+
+# 查看当前已注册的 hooks
+python3 -c "
+import json
+s = json.load(open('/Users/$(whoami)/.claude/settings.json'))
+for k, v in s.get('hooks', {}).items():
+    print(k, [h['command'][-50:] for e in v for h in e.get('hooks',[])])
+"
+
+# 禁用某个意图（临时测试）：daemon.yaml 改 false，立即生效
+```
+
+---
+
+## 文件路径参考
+
+| 文件 | 说明 |
+|------|------|
+| `scripts/intent-registry.js` | 共享意图注册表（Claude hook / Codex runtime 共用） |
+| `scripts/hooks/intent-engine.js` | Claude hook adapter（源文件） |
+| `~/.metame/hooks/intent-engine.js` | 部署副本（symlink） |
+| `scripts/hooks/intent-*.js` | 各意图模块（源文件） |
+| `~/.metame/daemon.yaml` | 用户配置（包含 `hooks:` 开关） |
+| `~/.claude/settings.json` | Claude Code hook 注册表 |

package/scripts/docs/maintenance-manual.md

@@ -59,7 +59,7 @@ feishu:
 - `/stop`：引擎中性，按 `activeProcesses.killSignal` 停止
 - `/compact`：
   - Claude 会话：正常压缩
-  - Codex 会话：返回“暂不支持，请继续同会话”
+  - Codex 会话：返回"暂不支持，请继续同会话"
 - `/engine`：
   - 查询当前默认引擎：`/engine`
   - 切换默认引擎：`/engine claude` 或 `/engine codex`
@@ -69,7 +69,7 @@ feishu:
   - 也支持严格自然语言：`把蒸馏模型改成 5.1mini`
 - `/doctor`：
   - 同时检查 Claude/Codex CLI 可用性
-  - 仅在“当前默认引擎对应 CLI 不可用”时判为故障
+  - 仅在"当前默认引擎对应 CLI 不可用"时判为故障
   - 自定义 provider 下允许任意合法模型名（不再强制 sonnet/opus/haiku）
 
 ## 5. Agent Soul 身份层
@@ -88,6 +88,9 @@ feishu:
 - 活跃子进程：`~/.metame/active_agent_pids.json`
 - 热重载备份：`~/.metame/.last-good/`（daemon 稳定运行 60s 后自动备份）
 - 崩溃计数：`~/.metame/.crash-count`（连续 2 次快速崩溃触发自动恢复）
+- Dispatch 队列：`~/.metame/dispatch/pending.jsonl`（本地 socket 降级）
+- 远端 Dispatch 队列：`~/.metame/dispatch/remote-pending.jsonl`（跨设备中继）
+- Dispatch 签名密钥：`~/.metame/.dispatch_secret`（自动创建）
 
 ## 7. 热重载安全机制（三层防护）
 
@@ -126,12 +129,25 @@ feishu:
 2. 若仍失败，手动 `/new` 新开会话
 3. 检查 `~/.metame/active_agent_pids.json` 是否残留异常进程
 
+### 远端 Dispatch 失败
+
+症状：`/dispatch to peer:project` 返回 `feishu bot not connected`
+
+处理：
+
+1. 确认 `daemon.yaml` 中 `feishu.remote_dispatch.enabled: true` 且 `self`/`chat_id`/`secret` 非空
+2. 确认飞书 bot 已连接：`/doctor` 查看飞书状态
+3. 确认 relay 群已加入 `allowed_chat_ids`（relay 群消息需被 daemon 接收）
+4. 两端的 `secret` 必须完全一致
+
 ## 9. 双平台/双引擎维护矩阵
 
 ### 统一维护（改一处即可）
 - agent-layer.js / daemon-agent-tools.js / daemon-agent-commands.js / daemon-user-acl.js
 - ENGINE_MODEL_CONFIG（daemon-engine-runtime.js 集中管理）
 - daemon-runtime-lifecycle.js 的语法检查和备份机制
+- daemon-remote-dispatch.js（纯逻辑，无平台差异）
+- team-dispatch.js（共享解析/hint/enrichment）
 
 ### 需分别维护（有平台/引擎特殊分支）
 
@@ -151,6 +167,25 @@ feishu:
 
 一个项目可以有多个 team 成员（数字分身），共享同一个 `cwd`，通过虚拟 chatId 并行工作。
 
+### 创建团队成员（向导）
+
+在手机端（飞书/Telegram）发送以下任一方式触发创建向导：
+
+- 自然语言：`创建团队`、`新建工作组`、`建个团队` 等（`_detectTeamIntent` 识别，位于 `daemon-command-router.js`）
+- 命令：`/agent new team`
+
+向导分三步，全部在 `daemon-agent-commands.js` 中实现：
+1. **name**：输入团队名称
+2. **members**：输入成员列表，格式 `名称:icon:颜色`，一行或逗号分隔多个
+3. **cwd**：通过文件浏览器（`daemon-file-browser.js` `team-new` 模式）选择父目录
+
+目录确认（`/agent-team-dir` 回调）后：
+- 在 `<父目录>/team/<成员key>/` 下创建工作目录及 CLAUDE.md
+- 自动执行 `git init`（支持 checkpoint）
+- 若父目录对应已有项目，自动写入 `daemon.yaml` 的 `team` 数组；否则提示手动注册
+
+中间状态保存在 `pendingTeamFlows` Map（`daemon.js` 中定义）。
+
 ### 配置
 
 在 `~/.metame/daemon.yaml` 的项目下添加 `team` 数组和 `broadcast: true`：
@@ -169,6 +204,12 @@ feishu:
         nicknames:
           - 甲
         auto_dispatch: true
+      - key: hunter
+        name: 猎手
+        icon: 🎯
+        peer: windows          # ← 远端成员，运行在 Windows 设备上
+        nicknames:
+          - 猎手
 ```
 
 ### 路由规则（按优先级）
@@ -179,16 +220,33 @@ feishu:
 4. **Sticky**：无昵称时 → 路由到上次显式指定的成员
 5. **Auto-dispatch**：主忙时自动分配给空闲的 `auto_dispatch` 成员
 
+**远端成员**：检测到 `member.peer` 时，bridges 自动走 `sendRemoteDispatch()` → relay 群 → 对端 daemon 接收执行，结果通过 relay 群回传。路由优先级不变，只是传输链路不同。
+
 ### /stop 精准路由
 
 - `/stop 乙`：停止指定成员
 - `/stop`：停止 sticky 成员
 - 引用回复 `/stop`：停止对应成员
 
-### Team Broadcast
+### /msg — 团队直接消息
+
+格式：`/msg <agent昵称> <消息内容>`
+
+- 例如：`/msg 乙 帮我看看这个文件`
+- 按昵称解析目标（先查 team 成员，再查 projects）
+- 以 `type='message', priority='normal'` 调度
+- 实现文件：`daemon-admin-commands.js` resolveProjectKey 函数
+
+### Team Broadcast（团队广播 = 可观察模式）
 
 `broadcast: true` 时，team 成员之间通过 `dispatch_to` 互发消息会在群里用卡片广播。
 
+**这就是"观察模式"**：开启 broadcast 后，你在群里可以实时看到成员之间互相传递任务的全过程（哪个成员发给了哪个成员、发了什么内容），以飞书卡片形式展示。
+
+切换命令：`/broadcast on` / `/broadcast off`（实时生效，写入 daemon.yaml）
+
+实现入口：`daemon.js` `_findTeamBroadcastContext()` + `handleDispatchItem()` 的广播分支。
+
 ### 虚拟 chatId
 
 team 成员使用 `_agent_{key}` 格式的虚拟 chatId，与物理群 chatId 隔离。
@@ -197,7 +255,106 @@ team 成员使用 `_agent_{key}` 格式的虚拟 chatId，与物理群 chatId
 
 由 `icon + name` 拼成，如 `🤖 Jarvis · 乙`。
 
-## 11. 私人配置保护
+## 11. 跨设备 Dispatch（Remote Peer Dispatch）
+
+### 概念
+
+team 成员可以通过 `peer` 字段标记为"远端成员"——运行在另一台机器上的 daemon。用户在飞书群里对远端成员的操作体验与本地成员完全一致（昵称路由、sticky follow 等），底层通过飞书 relay 群实现跨设备通信。
+
+### 配置
+
+两台设备的 `daemon.yaml` 需要配置相同的 relay 群和共享密钥，不同的 `self` 标识；但不能共用同一个飞书 bot。每台机器都必须使用自己独立的飞书应用 / bot 凭据。
+
+```yaml
+# Mac 端
+feishu:
+  remote_dispatch:
+    enabled: true
+    self: mac                    # 本机标识（唯一）
+    chat_id: oc_relay_xxx        # 专用中继群（两端相同）
+    secret: shared-secret-key    # HMAC 签名密钥（两端相同）
+
+# Windows 端
+feishu:
+  remote_dispatch:
+    enabled: true
+    self: windows
+    chat_id: oc_relay_xxx        # 同一个 relay 群
+    secret: shared-secret-key    # 同一个密钥
+```
+
+注意：
+
+- 可以共用同一个 relay 群。
+- 可以共用同一个 `secret`。
+- 不能共用同一个飞书 bot / `app_id` / `app_secret`。
+- 原因是飞书对同一 bot 的事件投递可能随机落到任一在线客户端；而当前代码在收到 `to_peer !== self` 的 relay 包时会直接忽略，错误机器会把包吞掉。
+
+team 成员添加 `peer` 字段指向远端设备：
+
+```yaml
+projects:
+  business:
+    team:
+      - key: writer
+        name: 编剧              # 无 peer → 本地执行
+      - key: hunter
+        name: 猎手
+        peer: windows            # 远端设备
+```
+
+### 数据流
+
+#### 用户消息 → 远端 team member
+
+```
+飞书群消息 "猎手 去调研竞品"
+→ bridges.js findTeamMember → { member: { key:'hunter', peer:'windows' } }
+→ _dispatchToTeamMember 检测 member.peer
+→ sendRemoteDispatch → encodePacket + HMAC 签名 → relay 群
+→ Windows daemon bridges 拦截 → decodePacket + verifyPacket + isDuplicate
+→ handleDispatchItem(local) → Claude 执行
+→ _replyFn → encode result → relay 群
+→ Mac daemon 拦截 → decode → sendMarkdown 到用户飞书群
+```
+
+#### Claude session 内跨设备 dispatch
+
+```
+Claude 看到 hook 注入:
+  - hunter（猎手 [远端:windows]）: `dispatch_to --from writer windows:hunter "消息"`
+→ dispatch_to 解析 peer:project 格式
+→ 写 remote-pending.jsonl → daemon heartbeat drain → bot 发 relay 群
+→ 对端 daemon 接收执行
+```
+
+### Packet 协议
+
+- 前缀：`[METAME_REMOTE_DISPATCH]`
+- 编码：Base64(JSON)
+- 签名：HMAC-SHA256，payload = packet body 去掉 sig 字段
+- 去重：5 分钟 TTL Map，按 packet.id 去重
+
+### 关键模块
+
+| 模块 | 职责 |
+|------|------|
+| `daemon-remote-dispatch.js` | 编解码、签名验签、去重、配置解析、`parseRemoteTargetRef` |
+| `daemon.js:sendRemoteDispatch()` | 构造签名 packet → 通过飞书 bot 发 relay 群 |
+| `daemon.js:handleRemoteDispatchMessage()` | 接收端：decode → verify → dedup → 执行或投递结果 |
+| `daemon-bridges.js` | Feishu bridge 拦截 relay 群消息 + `_dispatchToTeamMember` 远端分流 |
+| `daemon-admin-commands.js` | `/dispatch peers` 查看配置 + `/dispatch to peer:project` 手动派发 |
+| `scripts/bin/dispatch_to` | 支持 `peer:project` 格式 → 写 `remote-pending.jsonl` |
+| `team-dispatch.js` | `buildTeamRosterHint()` 为远端成员生成 `peer:key` 格式命令 |
+| `hooks/team-context.js` | intent hook 注入远端 `peer:key` dispatch 命令 |
+
+### 管理命令
+
+- `/dispatch peers`：查看远端配置（self peer、relay chat、所有远端成员列表）
+- `/dispatch to windows:hunter <任务>`：手动跨设备派发
+- `/dispatch to 猎手 <任务>`：按昵称解析，自动检测 `member.peer` 走远端
+
+## 12. 私人配置保护
 
 - `daemon.yaml` 是用户私人配置，包含 API keys、chat IDs、个人项目配置
 - **绝不上传**到代码仓库，已加入 `.gitignore`
@@ -206,7 +363,7 @@ team 成员使用 `_agent_{key}` 格式的虚拟 chatId，与物理群 chatId
 - 同样不应上传的文件：`MEMORY.md`、`SOUL.md`、`.env*`
 - Agent 在执行任务时，**绝不能** `cp scripts/daemon.yaml ~/.metame/daemon.yaml`，这会覆盖用户私人配置
 
-## 12. 变更后维护动作
+## 13. 变更后维护动作
 
 1. `npm test`
 2. `npm run sync:plugin`

package/scripts/docs/pointer-map.md

@@ -1,6 +1,6 @@
 # MetaMe 脚本/文档指针地图
 
-> 目的：回答“这段能力在哪个文件”“当前升级做到哪一步”“先看哪个脚本”。
+> 目的：回答"这段能力在哪个文件""当前升级做到哪一步""先看哪个脚本"。
 
 ## 快速入口
 
@@ -41,22 +41,71 @@
 - Agent 命令处理（新）：
   - `scripts/daemon-agent-commands.js`
   - 关键点：`createAgentCommandHandler()` 处理 `/agent`、`/activate`、`/resume`；
-    `/agent soul [repair|edit]`；`pendingActivations` 无 TTL（消费即删）；防止创建群自激活
+    `/agent soul [repair|edit]`；`pendingActivations` 无 TTL（消费即删）；防止创建群自激活；
+    `/agent new team` 三步向导（name → members → cwd）；
+    `/agent-team-dir` 回调处理目录选择并最终写入 daemon.yaml `team` 段；
+    `pendingTeamFlows` Map 维护向导中间状态
 
 - 路由与 Agent 创建：
   - `scripts/daemon-command-router.js`
   - `scripts/daemon-agent-tools.js`
   - 关键点：自然语言提取 `codex` 关键词；默认 `claude` 不写 `engine` 字段，仅 `codex` 持久化 `engine: codex`；
-    `bindAgentToChat()` 自动调用 `ensureAgentMetadata()` 建立 soul 层
+    `bindAgentToChat()` 自动调用 `ensureAgentMetadata()` 建立 soul 层；
+    `_detectTeamIntent()` 自然语言意图识别（含负样本过滤），识别"建团队"意图后自动路由到 `/agent new team` 向导
 
 - 会话命令与兼容边界：
   - `scripts/daemon-exec-commands.js`
-  - 关键点：`/stop` 引擎中性；`/compact` 在 codex 会话返回“暂不支持”
+  - 关键点：`/stop` 引擎中性；`/compact` 在 codex 会话返回"暂不支持"
 
 - 运行时引擎切换与诊断：
   - `scripts/daemon-admin-commands.js`
   - 关键点：`/engine` 切换默认引擎；`/doctor` 按默认引擎检查 CLI 可用性（Claude/Codex）并兼容自定义 provider 模型名
 
+## 团队 Dispatch 与跨设备通信定位
+
+- 共享 Dispatch 工具：
+  - `scripts/team-dispatch.js`
+  - 关键点：`resolveProjectKey()` 名称/昵称解析（含 team member `parent/member` 复合键）；
+    `findTeamMember()` 文本前缀匹配团队成员昵称；
+    `buildTeamRosterHint()` 生成团队上下文块（远端成员自动带 `peer:key` 前缀）；
+    `buildEnrichedPrompt()` 注入共享上下文（now.md + _latest.md + inbox）
+
+- 远端 Dispatch 协议：
+  - `scripts/daemon-remote-dispatch.js`
+  - 关键点：`normalizeRemoteDispatchConfig()` 解析 `feishu.remote_dispatch` 配置；
+    `parseRemoteTargetRef()` 解析 `peer:project` 格式；
+    `encodePacket()`/`decodePacket()` Base64 + HMAC-SHA256 编解码；
+    `verifyPacket()` 签名验证；
+    `isDuplicate()` 5 分钟 TTL 去重；
+    `isRemoteMember()` 检测 `member.peer` 字段
+
+- Daemon 远端 Dispatch 入口：
+  - `scripts/daemon.js`
+  - 关键点：`sendRemoteDispatch()` 构造签名 packet → 飞书 bot 发 relay 群；
+    `handleRemoteDispatchMessage()` 接收端逻辑（decode → verify → dedup → 按 type 路由）；
+    `remote-pending.jsonl` drain（heartbeat 中处理 dispatch_to CLI 写入的远端队列）
+
+- Bridge 集成：
+  - `scripts/daemon-bridges.js`
+  - 关键点：Feishu bridge `startReceiving` 回调最前面拦截 relay 群消息 → `handleRemoteDispatchMessage`；
+    `_dispatchToTeamMember` 检测 `isRemoteMember(member)` → 走 `sendRemoteDispatch` 而非本地 handleCommand
+
+- Dispatch CLI：
+  - `scripts/bin/dispatch_to`
+  - 关键点：支持 `peer:project` 格式 → `sendRemoteViaRelay()`；
+    `--team` broadcast 自动分流远端成员写 `remote-pending.jsonl`；
+    本地走 Unix socket / `pending.jsonl` 降级
+
+- 管理命令：
+  - `scripts/daemon-admin-commands.js`
+  - 关键点：`/dispatch peers` 查看远端配置；
+    `/dispatch to peer:project` 手动远端派发；
+    按昵称解析到远端 member 时自动走 `sendRemoteDispatch`
+
+- Intent Hook：
+  - `scripts/hooks/team-context.js`
+  - 关键点：检测通信意图 → 注入 dispatch_to 命令提示；远端成员自动带 `peer:key` 前缀
+
 ## Mentor Mode（Step 1-4）定位
 
 - Step 1 数据基建：
@@ -90,6 +139,11 @@
 - 夜间反思文档：`~/.metame/memory/decisions/`、`~/.metame/memory/lessons/`
 - 知识胶囊：`~/.metame/memory/capsules/`
 - 复盘文档：`~/.metame/memory/postmortems/`
+- Dispatch 队列：`~/.metame/dispatch/pending.jsonl`（本地 socket 降级）
+- 远端 Dispatch 队列：`~/.metame/dispatch/remote-pending.jsonl`（跨设备中继）
+- 共享进度白板：`~/.metame/memory/now/shared.md`
+- Agent 最新产出：`~/.metame/memory/agents/{key}_latest.md`
+- Agent 收件箱：`~/.metame/memory/inbox/{key}/`（未读），`read/`（已归档）
 - **Agent Soul 层**：`~/.metame/agents/<agent_id>/`
   - `agent.yaml` — id / name / engine / aliases
   - `soul.md` — 身份定义（主文件，项目目录的 SOUL.md 是其链接）
@@ -102,7 +156,8 @@
 1. 先看配置：`~/.metame/daemon.yaml` 与 `scripts/daemon-default.yaml`
 2. 再看命令入口：`scripts/daemon-admin-commands.js`、`scripts/daemon-command-router.js`、`scripts/daemon-exec-commands.js`
 3. 再看执行链路：`scripts/daemon-engine-runtime.js` → `scripts/daemon-claude-engine.js` → `scripts/mentor-engine.js`
-4. 最后看离线任务：`scripts/distill.js`、`scripts/memory-extract.js`、`scripts/memory-nightly-reflect.js`
+4. 团队/跨设备：`scripts/team-dispatch.js` → `scripts/daemon-remote-dispatch.js` → `scripts/daemon-bridges.js`
+5. 最后看离线任务：`scripts/distill.js`、`scripts/memory-extract.js`、`scripts/memory-nightly-reflect.js`
 
 ## 同步提示
 

package/scripts/feishu-adapter.js

@@ -298,16 +298,8 @@ function createBot(config) {
         throw new Error(`File not found: ${filePath}`);
       }
       const fileName = path.basename(filePath);
-      const fileSize = fs.statSync(filePath).size;
-
-      // For text files under 4KB, just send as text
       const ext = path.extname(filePath).toLowerCase();
       const isText = ['.md', '.txt', '.json', '.yaml', '.yml', '.csv'].includes(ext);
-      if (isText && fileSize < 4096) {
-        const content = fs.readFileSync(filePath, 'utf8');
-        await this.sendMessage(chatId, `📄 ${fileName}:\n\`\`\`\n${content}\n\`\`\``);
-        return;
-      }
 
       // For larger/binary files, try file upload
       try {
@@ -332,7 +324,7 @@ function createBot(config) {
         }
 
         // 2. Send file message
-        await client.im.message.create({
+        const sendRes = await client.im.message.create({
           params: { receive_id_type: 'chat_id' },
           data: {
             receive_id: chatId,
@@ -340,6 +332,9 @@ function createBot(config) {
             content: JSON.stringify({ file_key: fileKey }),
           },
         });
+        const msgId = sendRes?.data?.message_id;
+        if (caption) await this.sendMessage(chatId, caption);
+        return msgId ? { message_id: msgId } : null;
       } catch (uploadErr) {
         // Log detailed error
         const errDetail = uploadErr.response?.data || uploadErr.message || uploadErr;
@@ -349,18 +344,15 @@ function createBot(config) {
         if (isText) {
           const content = fs.readFileSync(filePath, 'utf8');
           const truncated = content.length > 3000 ? content.slice(0, 3000) + '\n...(truncated)' : content;
-          await this.sendMessage(chatId, `📄 ${fileName}:\n\`\`\`\n${truncated}\n\`\`\``);
+          const textMsg = await this.sendMessage(chatId, `📄 ${fileName}:\n\`\`\`\n${truncated}\n\`\`\``);
+          if (caption) await this.sendMessage(chatId, caption);
+          return textMsg || null;
         } else {
           // For binary files, give more helpful error
           const errMsg = errDetail?.msg || errDetail?.message || '上传失败';
           throw new Error(`${errMsg} (请检查飞书应用权限: im:resource)`);
         }
       }
-
-      // 3. Send caption as separate message if provided
-      if (caption) {
-        await this.sendMessage(chatId, caption);
-      }
     },
 
     /**

package/scripts/hooks/doc-router.js

@@ -0,0 +1,29 @@
+'use strict';
+
+/**
+ * Build a unified doc-routing hint for intent modules.
+ *
+ * @param {object} route
+ * @param {RegExp[]} route.patterns
+ * @param {string} route.title
+ * @param {string} route.docPath
+ * @param {string} route.summary
+ * @returns {(prompt: string) => string|null}
+ */
+function createDocRoute(route) {
+  const patterns = Array.isArray(route.patterns) ? route.patterns : [];
+  const title = String(route.title || '').trim();
+  const docPath = String(route.docPath || '').trim();
+  const summary = String(route.summary || '').trim();
+
+  if (!patterns.length || !title || !docPath || !summary) {
+    throw new Error('doc-router requires patterns, title, docPath, and summary');
+  }
+
+  return function detectDocRoute(prompt) {
+    if (!patterns.some((re) => re.test(prompt))) return null;
+    return `[${title}]\n- ${summary} → 先 \`cat ${docPath}\``;
+  };
+}
+
+module.exports = { createDocRoute };