@zmainer/dsh-wx-bridge 1.0.14 → 1.0.16

package/README.md

@@ -78,6 +78,7 @@ dsh plugin --profile <profile> add @zmainer/dsh-wx-bridge
 | `dataDir` | 桥的状态/日志/工作目录 | `$DSH_HOME/wxbridge` |
 | `cwd` | 微信任务的默认工作目录 | 宿主启动目录 |
 | `vault` | Obsidian 知识库绝对路径（可选，供提示词模板占位符使用） | 空 |
+| `allowlist` | 准入模式：`strict`（默认）/ `auto` / `open` —— 面板「准入模式」亦可切换 | `strict` |
 | `dshBin` | DSH 运行时入口（`<安装目录>/resources/dsh-runtime/lib/bin.js`）。**留空＝五级自动探测**：显式参数/环境变量 → 宿主自证快照 → PATH/npm 全局 → 桌面安装目录扫描 → 运行中进程嗅探 | 自动 |
 | `intervalMs` / `staleMs` | 自检间隔 / 心跳判新阈值 | 300000 |
 | `prompt` | 手机任务的**固定前置提示词**（兜底路径用；留空 = 不加任何前缀） | 空 |
@@ -96,7 +97,7 @@ dsh plugin --profile <profile> add @zmainer/dsh-wx-bridge
 
 1. 宿主启动后，桥会在 `dataDir/auth-token.txt` 生成一次性登记 token（ACL 限本人）。
 2. 在手机微信里把该 token 发给机器人（例如 `<token> /help`）完成登记；之后该设备免 token。
-3. 未登记的发送者会被静默丢弃并写审计日志。
+3. 未登记的发送者**不会被执行**：桥回一次提示（告诉对方怎么登记、或提示你去面板切 `auto`）并写审计日志。
 4. 面板「扫码配对」可直接出二维码（需本机 `qrcode` 可用；扫码会**重新绑定** ClawBot）。
 
 ## HTTP 接口（宿主半）
@@ -108,6 +109,7 @@ dsh plugin --profile <profile> add @zmainer/dsh-wx-bridge
 | GET | `/wxbridge/log` | 宿主半操作日志（最近 60 条） |
 | GET | `/wxbridge/presets` | **预设名册**（id/name/description）+ 当前选中值 |
 | POST | `/wxbridge/preset` | 写入预设选择（`{ "preset": "<id|空>" }`） |
+| POST | `/wxbridge/allowlist` | 写入准入模式（`{ "mode": "strict|auto|open", "restart": true }`） |
 | POST | `/wxbridge/start` · `/stop` · `/restart` · `/tick` | 桥生命周期（`tick` = 立即体检并按需自愈） |
 | POST | `/wxbridge/config` | 写配置文件（`dataDir`/`cwd`/`vault`/`intervalMs`/`staleMs`/`prompt`） |
 | POST | `/wxbridge/task` · `/scan` · `/attach` | 宿主内执行 / 会话归组 |
@@ -116,10 +118,12 @@ dsh plugin --profile <profile> add @zmainer/dsh-wx-bridge
 
 - **权限预设（1.0.7 起为 `danger-full-access`）**：手机端**没有可应答审批的界面**，
   而 DSH 的审批在无应答者时 fail-closed → 任何需要审批的操作都会直接失败。
-  因此本插件把**手机通道**的权限预设放到最宽；**这等于把本机交给能驱动该机器人的人**，
-  请配合白名单/凭据保管使用。收紧办法：叠层里 `permission.defaultPreset` 改
+  因此本插件把**手机通道**的权限预设放到最宽；**这等于把本机交给能驱动该机器人的人**——
+  所以准入默认是 `strict`（只有登记过的设备能驱动）。收紧办法：叠层里 `permission.defaultPreset` 改
   `workspace-write` 或 `read-only`（后者只读）。
-- 发送者白名单（TOFU）+ 一次性登记 token；未登记静默丢弃。
+- **准入默认 `strict`**（TOFU 白名单 + 一次性登记 token）：未登记的发送者**不执行**，但只回一次可操作提示
+  （10 分钟/人节流；提示里给出登记方式），并写审计日志。面板「准入模式」可切 `auto`（首次发言即登记）或
+  `open`（不检查，不建议）——`auto` 的边界是「谁拿到了这个机器人」，机器人被拉进群/被加好友会连带放权。
 - 子进程使用**专用 `DSH_HOME`**（`dataDir/dsh-home`），权限 `workspace-write`，**只拿模型密钥、不含微信 token**。
 - 状态文件原子写 + SHA256 校验，校验失败即隔离为 `.tampered-*`。
 - 输出审计：密钥形态脱敏、外发命令阻断、超大输出截断。
@@ -160,8 +164,50 @@ dsh plugin --profile <profile> add @zmainer/dsh-wx-bridge
 
 其余任意文本 → 交给 DSH 执行。
 
+## 常见问题 / Troubleshooting
+
+### 插件管理里点「更新」报 `Cannot switch a non-link plugin directory`
+
+```text
+更新失败: dsh-wx-bridge — 更新失败，且更新前的构建未能验证恢复
+（Cannot switch a non-link plugin directory: <...>\profiles\web
+ode_modules\@zmainer\dsh-wx-bridge）
+```
+
+**含义**：桌面端的插件更新是**事务式**的——它把 `<profile>/node_modules/<包名>` 当作一个**链接**，
+更新时把这个链接从旧版本"切"到新版本；而该位置现在是**普通目录**（文件是被复制进去的，不是链接），
+无法切换 ⇒ 更新失败并回滚，回滚时又验证不了"更新前的构建已恢复"，于是提示检查该 profile 再重启。
+
+**原因**：该 profile 里的本插件**不是通过市场/CLI 的链接式安装装上去的**（手工复制、旧版本管理器、
+或中途失败留下的目录都会这样）。"更新"走链接式管理，两边形态不一致就会撞上这个错。
+
+**修复（不影响任何配置与数据）**：
+
+1. **关闭 DSH 桌面端**（避免文件占用）；
+2. 删除或改名这个目录（注意真实路径里有 `\@zmainer\`，报错信息里可能少个反斜杠）：
+   `<harness home>\profiles\<profile>
+ode_modules\@zmainer\dsh-wx-bridge` → 改名成 `...dsh-wx-bridge.bak` 更稳妥；
+3. **重启桌面端**，在插件管理里**重新安装**（不是"更新"）；装好后可删掉 `.bak`；
+4. 想用命令行装：`dsh plugin --profile <profile> add @zmainer/dsh-wx-bridge@latest`（pnpm 会建立链接式安装），
+   然后重启宿主；
+5. 配置与数据**不在 profile 里**，所以重装/换安装方式都不会丢：
+   配置在 `<DSH_HOME>/wxbridge/config.json`、数据在配置里的 `dataDir`；插件的 id、路由前缀、
+   配置目录名都没变过。
+
+**避免复发**：在一个 profile 上**只用一个安装通道**（要么一直用市场，要么一直用 CLI），
+不要手工复制文件进 `node_modules`，也不要在两个通道之间来回切。
+
 ## 最近变更
 
+- **1.0.15**：**准入默认改回 `strict`（与 README 一致）**，并把选择权交给用户——
+  起因是 awesome-dsh-plugin 的收录评审指出的一个真实矛盾：代码默认 `ALLOWLIST=auto`（**任何能给机器人发消息的人
+  首次发言即自动登记**）叠加手机通道的 `danger-full-access`（**不经审批**），等价于"任何能给它发消息的人
+  都能免审批完全控制这台机器"；而 README「安全基线」写的是"未登记静默丢弃"（那是 `strict` 的行为）。
+  现在：① 默认 `strict`（`--allowlist` / `WXBRIDGE_ALLOWLIST` / `config.json` 的 `allowlist` 均可覆盖）；
+  ② 未登记**不执行但不再静默**——回一次可操作提示（每人 10 分钟一次），告诉对方怎么登记；
+  ③ 面板新增「**准入模式**」开关（`strict`/`auto`/`open`，一键写入配置并重启桥），换号/多设备的用户
+  自己决定放开；④ README 的「安全基线」「配对」与配置表同步对齐。
+  权限预设（`danger-full-access`）与准入是两件事：前者是本通道"无法应答审批"的取舍，后者决定**谁能**驱动它。
 - **1.0.14**：**文件/图片消息：先收下 → 反向提问 → 第二句话触发**（用户设计拍板）——
   微信的文件消息带不了附言，所以插件把文件**取件**（CDN 下载 + AES-128-ECB 解密 + **按原名**落盘）后
   先反问"你想让我做什么"，等你下一句话再连同附件清单交给会话。

package/lib/client.js

@@ -121,6 +121,7 @@ window.__ModuleLoader__.load({
       const skin = controlSkin()
       const [presets, setPresets] = R.useState([])
       const [presetSel, setPresetSel] = R.useState('')
+      const [allowlist, setAllowlist] = R.useState('strict')
       const [presetState, setPresetState] = R.useState(null)
       useWxStyle()
     
@@ -133,6 +134,7 @@ window.__ModuleLoader__.load({
               fetch('/wxbridge/log', { cache: 'no-store' }),
             ])
             const d = await sr.json()
+            if (d && typeof d.allowlist === 'string') setAllowlist(d.allowlist)
             const lg = await lr.json()
             if (!alive) return
             setJ(d); setErr(''); setLog(lg.actions || [])
@@ -159,6 +161,21 @@ window.__ModuleLoader__.load({
     
       R.useEffect(() => { let alive = true; loadPresets().then(() => {}); return () => { alive = false } }, [])
     
+      const saveAllowlist = async (mode) => {
+        setBusy('allowlist')
+        try {
+          const r = await fetch('/wxbridge/allowlist', {
+            method: 'POST', headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ mode, restart: true }),
+          })
+          const d = await r.json()
+          if (typeof d.allowlist === 'string') setAllowlist(d.allowlist)
+          setNote(d.ok
+            ? ('准入模式已切到 ' + mode + '：' + (d.note || ''))
+            : ('切换失败：' + (d.error || '未知错误')))
+        } catch (e) { setNote('切换失败：' + String(e && e.message ? e.message : e)) } finally { setBusy('') }
+      }
+    
       const savePreset = async (want) => {
         setBusy('preset')
         try {
@@ -410,6 +427,30 @@ window.__ModuleLoader__.load({
           )
         ),
     
+        R.createElement('div', { style: { marginTop: '14px', paddingTop: '12px', borderTop: subtle } },
+          R.createElement('div', { style: { display: 'flex', alignItems: 'center', gap: '6px', marginBottom: '6px' } },
+            wxBubbles(16, WX, skin.dark ? '#0d1220' : '#ffffff', 'transparent'),
+            R.createElement('span', { style: { fontSize: '13px', fontWeight: 600 } }, '准入模式'),
+            R.createElement('span', { style: { fontSize: '11px', color: dim.color } }, '（决定谁能驱动这台机器）')),
+          R.createElement('select', {
+            value: allowlist, onChange: (e) => setAllowlist(e.target.value),
+            style: { ...skin.control, width: '100%', boxSizing: 'border-box', padding: '7px 10px', borderRadius: '8px', fontSize: '12px' },
+          }, [
+            R.createElement('option', { key: 'strict', value: 'strict', style: skin.option }, 'strict（默认）· 只服务已登记的设备；未登记不执行，只回一次提示'),
+            R.createElement('option', { key: 'auto', value: 'auto', style: skin.option }, 'auto · 任何能给机器人发消息的人首次发言即登记（机器人别被拉进群/加好友）'),
+            R.createElement('option', { key: 'open', value: 'open', style: skin.option }, 'open · 不做任何检查（强烈不建议）'),
+          ]),
+          R.createElement('div', { style: { marginTop: '8px', display: 'flex', alignItems: 'center' } },
+            R.createElement('button', {
+              className: 'wxbridge-btn', onClick: () => saveAllowlist(allowlist), disabled: !!busy,
+              style: {
+                marginRight: '10px', padding: '6px 14px', borderRadius: '999px', fontSize: '12px', fontWeight: 500,
+                cursor: busy ? 'default' : 'pointer', border: '1px solid ' + WX, background: WX, color: '#fff',
+              },
+            }, busy === 'allowlist' ? '处理中…' : '保存并重启桥'),
+            R.createElement('span', { style: dim }, '当前：' + allowlist + '（改完会写入 config.json 并重启桥，立即生效）')),
+        ),
+    
         note ? R.createElement('pre', { style: { margin: '10px 0 0 0', padding: '9px 11px', borderRadius: '10px', background: mutedBg, border: subtle, fontSize: '11px', overflow: 'auto', maxHeight: '160px' } }, note) : null,
     
         // ── 操作日志 ───────────────────────────────────────────────────

package/lib/index.js

@@ -313,6 +313,7 @@ export function apply(ctx, config) {
         peers, tasks, allowedUsers: allowed, stateOk, manualStop,
         dataDir: st.dataDir, cwd: st.cwd, intervalMs: st.intervalMs, staleMs: st.staleMs,
         runtimeBin: rtBin, runtimeBinOk: !!rtBin && existsSync(rtBin), runtimeSource: runtimeInfo.source,
+        allowlist: String((() => { try { return readConfigFile().allowlist || 'strict' } catch { return 'strict' } })()),
       }
     }
 
@@ -693,12 +694,32 @@ export function apply(ctx, config) {
             const body = await readBody(req)
             const f = configPath()
             const keep = readJsonFile(f)
-            for (const k of ['dataDir', 'cwd', 'vault', 'dshBin', 'intervalMs', 'staleMs']) if (body && body[k]) keep[k] = body[k]
+            for (const k of ['dataDir', 'cwd', 'vault', 'dshBin', 'intervalMs', 'staleMs', 'allowlist']) if (body && body[k]) keep[k] = body[k]
             if (body && typeof body.prompt === 'string') keep.prompt = body.prompt
             mkdirSync(dirname(f), { recursive: true })
             writeFileSync(f, JSON.stringify(keep, null, 2))
             return send(res, { ok: true, written: f, applied: keep, note: '提示词下次任务即生效；其余项重启宿主后生效' })
           }
+          if (p === '/allowlist' && req.method === 'POST') {
+            // 准入模式：strict（默认，只认已登记）/ auto（首次发言即登记）/ open（不检查）
+            const body = await readBody(req)
+            const mode = String((body && body.mode) || '').toLowerCase()
+            if (!['strict', 'auto', 'open'].includes(mode)) {
+              return send(res, { ok: false, error: 'mode must be strict | auto | open' }, 400)
+            }
+            try {
+              const f = configPath()
+              const keep = readJsonFile(f)
+              keep.allowlist = mode
+              mkdirSync(dirname(f), { recursive: true })
+              writeFileSync(f, JSON.stringify(keep, null, 2))
+              pushAction({ action: 'allowlist', ok: true, detail: mode })
+              let restarted = 0
+              if (body && body.restart && keeper) { try { restarted = keeper.startBridge('allowlist-change') || 0 } catch (e) { ctx.logger?.warn?.('wxbridge: 重启失败 ' + String(e?.message ?? e)) } }
+              return send(res, { ok: true, allowlist: mode, configFile: f, restarted,
+                note: restarted ? '已写入配置并重启桥，立即生效' : '已写入配置；重启桥后生效（面板「重启」或等下次宿主启动）' })
+            } catch (e) { return send(res, { ok: false, error: String(e?.message ?? e) }, 500) }
+          }
           if (p === '/prompt') {
             if (req.method === 'POST') {
               const body = await readBody(req)

package/lib/kernel/acp-preset-shim.mjs

@@ -100,9 +100,35 @@ const EDITS = [
 ]
 
 /** 由 dsh 入口（<runtime>/lib/bin.js）推出已装 dsh-acp 的文件路径。 */
+/**
+ * dsh-acp 的候选路径（2026-09-24：只认旧布局导致预设静默失效）。
+ * 三种真实布局：
+ *   A. 旧桌面/CLI：`<root>/lib/bin.js` + `<root>/node_modules/@deepseek-ai/dsh-acp`
+ *   B. **新版桌面（hoisted）**：`<app>/node_modules/@deepseek-ai/dsh/lib/bin.js`
+ *      + `<app>/node_modules/@deepseek-ai/dsh-acp` ← 与 dsh 在同一个 scope 目录下（兄弟）
+ *   C. 单包自带：`<pkg>/node_modules/@deepseek-ai/dsh-acp`
+ * @param {string} runtimeBin dsh 入口（bin.js 绝对路径）
+ * @returns {string[]} 候选（按可能性排序；第一个存在的即命中）
+ */
+export function acpPackageCandidates(runtimeBin) {
+  if (!runtimeBin) return []
+  const lib = dirname(runtimeBin)              // .../lib
+  const pkg = resolve(lib, '..')               // .../dsh（包根）或运行时根
+  const parent = resolve(pkg, '..')            // .../@deepseek-ai（hoisted scope）或 node_modules
+  const nm = resolve(parent, '..')             // .../node_modules
+  return [
+    resolve(pkg, 'node_modules', '@deepseek-ai', 'dsh-acp', 'lib', 'index.js'),      // C
+    resolve(parent, 'dsh-acp', 'lib', 'index.js'),                                   // B（新版桌面）
+    resolve(parent, '@deepseek-ai', 'dsh-acp', 'lib', 'index.js'),
+    resolve(nm, '@deepseek-ai', 'dsh-acp', 'lib', 'index.js'),                       // A
+  ]
+}
+
+/** 命中第一个存在的候选；都不存在时返回首选路径（调用方用 acpPackageCandidates 出诊断）。 */
 export function acpPackageFile(runtimeBin) {
-  if (!runtimeBin) return ''
-  return resolve(join(dirname(runtimeBin), '..', 'node_modules', '@deepseek-ai', 'dsh-acp', 'lib', 'index.js'))
+  const cands = acpPackageCandidates(runtimeBin)
+  for (const c of cands) { try { if (existsSync(c)) return c } catch {} }
+  return cands[0] || ''
 }
 
 /** 该文件是否已经支持预设（原生支持或已打过补丁）。 */
@@ -121,7 +147,11 @@ export function acpPresetSupported(file) {
 export function ensureAcpPresetSupport(o) {
   const log = o.log || (() => {})
   const file = acpPackageFile(o.runtimeBin)
-  if (!file || !existsSync(file)) return { status: 'missing', file, detail: '未找到已装的 dsh-acp（可能不是桌面运行时）' }
+  if (!file || !existsSync(file)) {
+    // 把候选清单一起带出去：区分「真的没装 dsh-acp」与「路径没找对」（2026-09-24 的坑）
+    return { status: 'missing', file, candidates: acpPackageCandidates(o.runtimeBin),
+      detail: '未找到已装的 dsh-acp；已试路径见 candidates（新版桌面常见于 <app>/node_modules/@deepseek-ai/dsh-acp）' }
+  }
 
   let src
   try { src = readFileSync(file, 'utf8') } catch (e) { return { status: 'error', file, detail: String(e?.message ?? e) } }

package/lib/kernel/bridge.mjs

@@ -11,10 +11,10 @@
  *   运行时入口 dshBin（5 级解析，见 resolveDshBin）：--dsh-bin/BRIDGE_DSH_BIN/DSH_BIN →
  *     <dataDir>/host-runtime.json（宿主自证）→ PATH/npm 全局 → 桌面安装目录 → 运行中进程嗅探
  */
-import { readFileSync, writeFileSync, appendFileSync, existsSync, mkdirSync, renameSync, statSync, readdirSync } from 'node:fs'
+import { readFileSync, writeFileSync, appendFileSync, existsSync, mkdirSync, renameSync, statSync, readdirSync, copyFileSync } from 'node:fs'
 import { spawn, execFileSync } from 'node:child_process'
 import { AcpHost } from './acp.mjs'
-import { ensureAcpPresetSupport, acpPresetSupported, acpPackageFile } from './acp-preset-shim.mjs'
+import { ensureAcpPresetSupport, acpPresetSupported, acpPackageFile, acpPackageCandidates } from './acp-preset-shim.mjs'
 import { randomUUID, randomBytes, createHash, createDecipheriv } from 'node:crypto'
 import { zstdDecompressSync } from 'node:zlib'
 import { homedir } from 'node:os'
@@ -190,15 +190,6 @@ const HEARTBEAT_MS = 30000
 const TASK_TIMEOUT_MS = Number(process.env.BRIDGE_TASK_TIMEOUT_MS || 300000)
 const MAX_CONCURRENT_TASKS = Number(process.env.BRIDGE_MAX_TASKS || 2)
 const DEDUP_WINDOW_MS = 24 * 3600 * 1000
-/**
- * 授权策略：
- *   auto   （默认）—— 任何给本 bot 发消息的联系人自动登记 + 记审计日志。
- *                        准入边界前移到「扫码拿到 bot 控制权」那一步：能扫码 = 本来就有权。
- *                        换号/多台手机都无需干预（2026-09-21 用户反馈后定为默认）。
- *   strict —— 只认白名单；未登记的一律丢弃（旧行为）。
- *   open   —— 不做任何检查（不建议：任何能找到该 bot 的号都能驱动本机）。
- */
-const ALLOWLIST = (argOf('--allowlist') || process.env.WXBRIDGE_ALLOWLIST || 'auto').toLowerCase()
 /**
  * 执行模式：
  *   host     （默认，若宿主可达）—— 任务交给宿主进程执行：原生会话 + 原生上下文，
@@ -218,6 +209,18 @@ function loadBridgeConfig() {
 }
 const BRIDGE_CONFIG = loadBridgeConfig()
 const ACP_CFG = (BRIDGE_CONFIG && typeof BRIDGE_CONFIG.acp === 'object') ? BRIDGE_CONFIG.acp : {}
+/**
+ * 授权策略（2026-09-23 起默认 `strict`，与 README 的「安全基线」一致）：
+ *   strict （默认）—— 只认已登记的发送者；**未登记不执行**，但只回一次可操作提示
+ *                     （10 分钟/人节流），不静默——否则"换号/换手机"的用户只会看到"发了没反应"。
+ *   auto   —— 任何能给本 bot 发消息的联系人首次发言即自动登记。
+ *             准入边界前移到「谁拿到了这个机器人」：**机器人被拉进群/被加好友时会连带放权**，
+ *             所以它不再是默认，只在你确认机器人只有自己用、或想省掉换号登记时，在面板里显式切过去。
+ *   open   —— 不做任何检查（不建议：任何能找到该 bot 的号都能驱动本机）。
+ * 可用参数/环境变量/配置覆盖：--allowlist / WXBRIDGE_ALLOWLIST / config.json 的 allowlist。
+ */
+const ALLOWLIST = (argOf('--allowlist') || process.env.WXBRIDGE_ALLOWLIST || BRIDGE_CONFIG.allowlist || 'strict').toLowerCase()
+
 /**
  * ACP 路径（首选执行方式）：桥起一个常驻 `dsh --profile acp`，用 Agent Client Protocol
  * 驱动 **DSH 原生会话** —— 上下文由 DSH 持久化持有（可 resume），桥不再把历史拼进提示词。
@@ -299,11 +302,25 @@ function loadPromptText() {
     const cfg = JSON.parse(readFileSync(cfgFile, 'utf8'))
     if (typeof cfg.prompt === 'string') return cfg.prompt.trim()
   } catch {}
+  // 契约文件不存在时：从包内模板复制一份到数据目录（面板/手改都行）并**出声**。
+  // 静默缺席的后果是「通道没有任何固定身份」，而现象看起来跟"预设没生效"一模一样（2026-09-24 实况）。
+  if (!existsSync(CONTRACT_FILE)) {
+    try {
+      const tpl = join(HERE, 'second-brain-contract.txt')
+      mkdirSync(STATE_DIR, { recursive: true })
+      if (existsSync(tpl)) {
+        copyFileSync(tpl, CONTRACT_FILE)
+        log('contract-template-copied', { to: CONTRACT_FILE })
+      }
+    } catch (e) { log('contract-template-copy-failed', { error: String(e?.message ?? e) }) }
+    log('contract-missing', { file: CONTRACT_FILE,
+      note: '通道没有固定身份契约；如需「先检索 vault / 落盘铁律」这类前缀，请编辑该文件或在配置里给 vault' })
+  }
   try {
     return readFileSync(CONTRACT_FILE, 'utf8').trim()
       .replace(/\{\{vault\}\}/g, VAULT_PATH)
       .replace(/\{\{cwd\}\}/g, CWD)
-      .replace(/\{\{model\}\}/g, process.env.BRIDGE_MODEL_LABEL || 'DeepSeek')
+      .replace(/\{\{model\}\}/g, process.env.BRIDGE_MODEL_VAL || process.env.BRIDGE_MODEL_LABEL || 'DeepSeek')
   } catch { return '' }
 }
 let CONTRACT = loadPromptText()
@@ -659,6 +676,8 @@ function attachmentBlock(atts) {
 }
 
 const NOTEXT_NOTICE_AT = new Map()
+/** 未登记提示的节流（每人 10 分钟一次）。 */
+const UNREG_NOTICE_AT = new Map()
 const NOTEXT_NOTICE = '这条消息里没有我能处理的内容（表情、链接卡片、位置这类条目暂时不支持）。'
   + NL + '发文字、或者直接发图片 / 文件（Excel、Word、PDF 都行）都可以。'
 /** 该不该给他回「只认文字」：同一个人 60 秒内只回一次。返回要发的文本，'' = 这次不回。 */
@@ -1022,8 +1041,12 @@ async function reportSessionToHost(sessionId, cwd, isRetry) {
     })
     const j = await r.json().catch(() => null)
     log('attach-report', { session: sessionId, ok: !!(j && j.ok), workspace: (j && j.workspacePath) || null, error: (j && j.error) || null })
-    // 会话文件刚落盘时宿主可能还读不到 → 4 秒后补一次（仍幂等；再不行还有宿主侧 10 分钟的兜底扫描）
-    if (!(j && j.ok)) setTimeout(() => { void reportSessionToHost(sessionId, cwd, true) }, 4000)
+    // 会话文件刚落盘时宿主可能还读不到 → **只**补一次（幂等；再不行还有宿主侧 10 分钟的兜底扫描）。
+    // 2026-09-24 修：原来补试路径也会再排一次补试，失败即每 4 秒无限重试、把日志刷爆。
+    if (!(j && j.ok)) {
+      if (!isRetry) setTimeout(() => { void reportSessionToHost(sessionId, cwd, true) }, 4000)
+      else log('attach-report-give-up', { session: sessionId, error: (j && j.error) || null, note: '补试一次仍失败，交给宿主侧周期扫描' })
+    }
   } catch (e) { log('attach-report-failed', { session: sessionId, error: String(e?.message ?? e) }) }
 }
 
@@ -1371,8 +1394,18 @@ async function handleMessage(token, msg) {
       isAllowed = true
       try { await reply(token, from, '✅ 已登记本机授权（多台手机/换号都无需再设置）。发 /help 看指令。', ctx) } catch {}
     } else {
-      // strict：记录完整 from（本地日志，仅本人可读）
+      // strict（默认）：未登记**不执行**，但别静默——回一次可操作的提示（每人 10 分钟一次）。
+      // 静默丢弃对"换手机/换号"的本人来说等于"坏了"，而提示对陌生人也无害。
       log('rejected-unauthenticated', { from, fromShort: from.slice(0, 12) })
+      if (Date.now() - (UNREG_NOTICE_AT.get(from) || 0) > 600000) {
+        UNREG_NOTICE_AT.set(from, Date.now())
+        try {
+          await reply(token, from, '未登记：这条通道默认只服务已登记的设备，所以刚才那条我没有执行。' + NL
+            + '登记方式：把设置页「微信连接」里显示的**登记 token** 发我一次（形如 `abc123… /help`）。' + NL
+            + '（也可以在面板里把「准入模式」切成 auto —— 那样任何能给机器人发消息的人首次发言即登记，'
+            + '请先确认这个机器人没有被拉进群、也没被别人加好友。）', ctx)
+        } catch (e) { log('send-failed', { error: String(e?.message ?? e) }) }
+      }
       return
     }
   }
@@ -1641,6 +1674,19 @@ async function main() {
     }, null, 1))
     process.exit(0)
   }
+  if (args.includes('--selftest-shim')) {
+    const bin = resolveAcpBin()
+    const cands = acpPackageCandidates(bin)
+    const r = ensureAcpPresetSupport({ runtimeBin: bin, log, dryRun: true })
+    console.log('[selftest-shim] ' + JSON.stringify({
+      acpBin: bin,
+      candidates: cands.map((c) => ({ path: c, exists: existsSync(c) })),
+      status: r.status, file: r.file || null, detail: r.detail || null, backup: r.backup || null,
+      supportedNow: r.file ? acpPresetSupported(r.file) : false,
+      contractFile: CONTRACT_FILE, contractExists: existsSync(CONTRACT_FILE), contractHash: CONTRACT_HASH,
+    }, null, 1))
+    process.exit(0)
+  }
   if (args.includes('--selftest-files')) {
     const K = 'u-selftest'
     state.pendingFiles = {}
@@ -1726,6 +1772,8 @@ async function main() {
       voice: { text: voiceTranscript(voiceMsg), types: inboundItemTypes(voiceMsg) },
       cooldown: { at0: !!first, at30s: !!second, at61s: !!third },
       noticeText: NOTEXT_NOTICE,
+      allowlist: ALLOWLIST,
+      allowlistSource: argOf('--allowlist') ? 'arg' : (process.env.WXBRIDGE_ALLOWLIST ? 'env' : (BRIDGE_CONFIG.allowlist ? 'config' : 'default')),
     }, null, 1))
     process.exit(0)
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zmainer/dsh-wx-bridge",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "type": "module",
   "main": "./lib/index.js",
   "dsh": {

package/src/client.js

@@ -115,6 +115,7 @@ function Panel() {
   const skin = controlSkin()
   const [presets, setPresets] = R.useState([])
   const [presetSel, setPresetSel] = R.useState('')
+  const [allowlist, setAllowlist] = R.useState('strict')
   const [presetState, setPresetState] = R.useState(null)
   useWxStyle()
 
@@ -127,6 +128,7 @@ function Panel() {
           fetch('/wxbridge/log', { cache: 'no-store' }),
         ])
         const d = await sr.json()
+        if (d && typeof d.allowlist === 'string') setAllowlist(d.allowlist)
         const lg = await lr.json()
         if (!alive) return
         setJ(d); setErr(''); setLog(lg.actions || [])
@@ -153,6 +155,21 @@ function Panel() {
 
   R.useEffect(() => { let alive = true; loadPresets().then(() => {}); return () => { alive = false } }, [])
 
+  const saveAllowlist = async (mode) => {
+    setBusy('allowlist')
+    try {
+      const r = await fetch('/wxbridge/allowlist', {
+        method: 'POST', headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ mode, restart: true }),
+      })
+      const d = await r.json()
+      if (typeof d.allowlist === 'string') setAllowlist(d.allowlist)
+      setNote(d.ok
+        ? ('准入模式已切到 ' + mode + '：' + (d.note || ''))
+        : ('切换失败：' + (d.error || '未知错误')))
+    } catch (e) { setNote('切换失败：' + String(e && e.message ? e.message : e)) } finally { setBusy('') }
+  }
+
   const savePreset = async (want) => {
     setBusy('preset')
     try {
@@ -404,6 +421,30 @@ function Panel() {
       )
     ),
 
+    R.createElement('div', { style: { marginTop: '14px', paddingTop: '12px', borderTop: subtle } },
+      R.createElement('div', { style: { display: 'flex', alignItems: 'center', gap: '6px', marginBottom: '6px' } },
+        wxBubbles(16, WX, skin.dark ? '#0d1220' : '#ffffff', 'transparent'),
+        R.createElement('span', { style: { fontSize: '13px', fontWeight: 600 } }, '准入模式'),
+        R.createElement('span', { style: { fontSize: '11px', color: dim.color } }, '（决定谁能驱动这台机器）')),
+      R.createElement('select', {
+        value: allowlist, onChange: (e) => setAllowlist(e.target.value),
+        style: { ...skin.control, width: '100%', boxSizing: 'border-box', padding: '7px 10px', borderRadius: '8px', fontSize: '12px' },
+      }, [
+        R.createElement('option', { key: 'strict', value: 'strict', style: skin.option }, 'strict（默认）· 只服务已登记的设备；未登记不执行，只回一次提示'),
+        R.createElement('option', { key: 'auto', value: 'auto', style: skin.option }, 'auto · 任何能给机器人发消息的人首次发言即登记（机器人别被拉进群/加好友）'),
+        R.createElement('option', { key: 'open', value: 'open', style: skin.option }, 'open · 不做任何检查（强烈不建议）'),
+      ]),
+      R.createElement('div', { style: { marginTop: '8px', display: 'flex', alignItems: 'center' } },
+        R.createElement('button', {
+          className: 'wxbridge-btn', onClick: () => saveAllowlist(allowlist), disabled: !!busy,
+          style: {
+            marginRight: '10px', padding: '6px 14px', borderRadius: '999px', fontSize: '12px', fontWeight: 500,
+            cursor: busy ? 'default' : 'pointer', border: '1px solid ' + WX, background: WX, color: '#fff',
+          },
+        }, busy === 'allowlist' ? '处理中…' : '保存并重启桥'),
+        R.createElement('span', { style: dim }, '当前：' + allowlist + '（改完会写入 config.json 并重启桥，立即生效）')),
+    ),
+
     note ? R.createElement('pre', { style: { margin: '10px 0 0 0', padding: '9px 11px', borderRadius: '10px', background: mutedBg, border: subtle, fontSize: '11px', overflow: 'auto', maxHeight: '160px' } }, note) : null,
 
     // ── 操作日志 ───────────────────────────────────────────────────