@zmainer/dsh-wx-bridge 1.0.8

package/lib/kernel/acp-overlay-chat.yml

@@ -0,0 +1,26 @@
+# wxbridge ACP 叠加层 · **对话模式**（手机默认档）
+# 与 acp-overlay.yml 的差别：收窄注入面，避免「随口一句话」被当成第二大脑任务落盘。
+#   1) 仍停用 dsh-computer-use（否则 profile 整树加载失败，原因见 acp-overlay.yml）；
+#   2) 停用技能目录（skill-filesystem 提供 ~/.ohdsh/skills，tool-skill 提供加载工具）——
+#      手机提示里不再出现 second-brain-distill 这类"沉淀知识"的技能；
+#   3) 覆盖 system-prompt 人格为「对话助手」：从本会话上下文回答，不主动读写文件/知识库。
+# 需要真正的第二大脑行为时，手机发 `/brain on` 切到第二大脑模式（另一份叠加层）。
+- id: dsh-computer-use
+  disabled: true
+
+# 手机通道**不需要审批**：手机端没有可应答审批的界面（ACP 只应答带 callId 的工具审批，
+# 沙箱升级类审批会转给桌面端弹窗 → 手机无从应答 → fail-closed 执行失败）。
+# 所以这里把权限预设放到最宽。改窄：改成 read-only / workspace-write 即可。
+- id: permission
+  config:
+    defaultPreset: danger-full-access
+- id: skill-filesystem
+  disabled: true
+- id: tool-skill
+  disabled: true
+- id: system-prompt
+  config:
+    persona: >-
+      你是「手机微信通道」里的对话助手，用中文简洁回答。直接用当前会话已有的上下文回答，
+      不要为了"记住"去读写工作区文件或知识库；只有当用户明确要求（例如"记到库里""归档""落盘"）
+      时才动文件。

package/lib/kernel/acp-overlay.yml

@@ -0,0 +1,22 @@
+# wxbridge ACP 叠加层（保持最小：只做已实证必要的一件事）
+# 让 `dsh --profile acp` 在**宿主 home**（~/.ohdsh）里能起得来：
+#   ~/.ohdsh/cordis.patch.yml（根用户补丁层）引用 dsh-computer-use，该包只装在
+#   profiles/desktop/node_modules 里 → 新建的 profiles/acp 解析不到 → 整树加载失败
+#   （症状：initialize 正常、session/new 报 "the ACP bridge has been disposed"）。
+#   ACP 是手机用的自动化通道，不需要桌面专属的 computer-use 插件。
+#   注：停用一个不存在的 id 是无害空操作，因此本文件可无条件带上。
+- id: dsh-computer-use
+  disabled: true
+
+# 手机通道**不需要审批**：手机端没有可应答审批的界面（ACP 只应答带 callId 的工具审批，
+# 沙箱升级类审批会转给桌面端弹窗 → 手机无从应答 → fail-closed 执行失败）。
+# 所以这里把权限预设放到最宽。改窄：改成 read-only / workspace-write 即可。
+- id: permission
+  config:
+    defaultPreset: danger-full-access
+#
+# 备注（2026-09-21 实测，别重复踩）：**模型目录不随行配置走**。
+#   本文件曾试在两处放 llm-deepseek 目录（改行 config；停用 base 行 + 换行 id 插副本），
+#   配置树（--dump-config）里都生效了，但 `session/new` 返回的目录**始终不变** ——
+#   运行时的模型目录来自 settings（`llm-deepseek` / `llm-pi-ai` 段）而非行 config。
+#   所以「让手机清单 = 桌面端清单」这件事，只能改 settings，改不成（见 L1 §9.6）。

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

@@ -0,0 +1,162 @@
+/**
+ * acp-preset-shim.mjs — 「让 ACP 会话加入预设」的**上游兼容层**（compat shim）
+ *
+ * 背景：`@deepseek-ai/dsh-acp` 的 `session/new` / `session/resume` 的 setup 里只装模型选择与 MCP，
+ * **没有** `agentPresets.mount()`，所以 ACP 会话永远拿不到用户预设（详见知识库笔记
+ * 「DSH ACP 原生会话通道」的「预设」一节）。上游落地前，由插件在启动时给**已装**的 dsh-acp
+ * 打一个**幂等**的小补丁（6 处），让 `Config.preset` 生效。
+ *
+ * 设计原则（产品化要求）：
+ *   1. **幂等**：已支持 / 已打过 → 直接返回 'supported' / 'already'，绝不重复写；
+ *   2. **只在该功能被用到时才动手**：调用方只在「用户选了预设」且未禁用（config.acp.patchAcp === false）时调用；
+ *   3. **形状不符就拒绝**：任何一处锚点对不上（上游改过 / 已原生支持）→ 'shape-mismatch'，一个字节都不写；
+ *   4. **写前先字节级备份**，写后先过 `node --check` 才落盘（补丁坏了等于把用户的运行时搞坏）；
+ *   5. **如实记录**：每个结果都返回 status + detail，由调用方写日志，不静默。
+ */
+import { existsSync, readFileSync, writeFileSync, copyFileSync } from 'node:fs'
+import { spawnSync } from 'node:child_process'
+import { dirname, join, resolve } from 'node:path'
+import { tmpdir } from 'node:os'
+
+/** 已打过补丁的标记（写进文件注释，便于肉眼/程序双重识别）。 */
+export const SHIM_MARK = 'wxbridge:acp-preset-shim'
+
+/** 6 处补丁：每处都必须**恰好命中一次**，否则整体拒绝。 */
+const EDITS = [
+  ['config', `const Config = Schema.object({
+	provider: Schema.string(),
+	model: Schema.string(),
+	sessionListPageSize: Schema.natural().min(1).default(DEFAULT_SESSION_LIST_PAGE_SIZE)
+});`, `const Config = Schema.object({
+	provider: Schema.string(),
+	model: Schema.string(),
+	preset: Schema.string(),
+	sessionListPageSize: Schema.natural().min(1).default(DEFAULT_SESSION_LIST_PAGE_SIZE)
+});`],
+
+  ['new-session', `				record = await AcpSession.create(ctx, {
+					sessionId,
+					cwd: params.cwd,
+					mcpServers: params.mcpServers,
+					agentOptions: agentOptions(config),
+					fallbackSelection: initialSelection(config),
+					signal,
+					notify
+				});`, `				record = await AcpSession.create(ctx, {
+					sessionId,
+					cwd: params.cwd,
+					mcpServers: params.mcpServers,
+					agentOptions: agentOptions(config),
+					preset: config.preset,
+					fallbackSelection: initialSelection(config),
+					signal,
+					notify
+				});`],
+
+  ['resume-session', `					record = await AcpSession.resume(ctx, {
+						sessionId,
+						cwd: params.cwd,
+						mcpServers: params.mcpServers ?? [],
+						agentOptions: agentOptions(config),
+						fallbackSelection: initialSelection(config),
+						signal,
+						notify
+					});`, `					record = await AcpSession.resume(ctx, {
+						sessionId,
+						cwd: params.cwd,
+						mcpServers: params.mcpServers ?? [],
+						agentOptions: agentOptions(config),
+						preset: config.preset,
+						fallbackSelection: initialSelection(config),
+						signal,
+						notify
+					});`],
+
+  ['create-setup', `			sessionId: options.sessionId,
+			meta: { cwd: options.cwd },
+			agentOptions: options.agentOptions,
+			signal: options.signal,
+			setup: async (agentCtx) => {
+				modelControl.install(agentCtx);
+				await mountAcpMcpServers(agentCtx, options.mcpServers, options.cwd);
+			}`, `			sessionId: options.sessionId,
+			meta: { cwd: options.cwd, agentPreset: options.preset },
+			agentOptions: options.agentOptions,
+			signal: options.signal,
+			setup: async (agentCtx) => {
+				modelControl.install(agentCtx);
+				const presets = agentCtx.get("agentPresets");
+				if (presets !== void 0 && options.preset !== void 0) await presets.mount(agentCtx, options.preset);
+				await mountAcpMcpServers(agentCtx, options.mcpServers, options.cwd);
+			}`],
+
+  ['resume-setup', `				modelControl = new AcpModelControl(ctx.llm, selectionFor(agent.session.requestHeader(), options.fallbackSelection));
+				modelControl.install(agentCtx);
+				await mountAcpMcpServers(agentCtx, options.mcpServers, options.cwd);`, `				modelControl = new AcpModelControl(ctx.llm, selectionFor(agent.session.requestHeader(), options.fallbackSelection));
+				modelControl.install(agentCtx);
+				const presets = agentCtx.get("agentPresets");
+				if (presets !== void 0 && options.preset !== void 0) await presets.mount(agentCtx, options.preset);
+				await mountAcpMcpServers(agentCtx, options.mcpServers, options.cwd);`],
+]
+
+/** 由 dsh 入口（<runtime>/lib/bin.js）推出已装 dsh-acp 的文件路径。 */
+export function acpPackageFile(runtimeBin) {
+  if (!runtimeBin) return ''
+  return resolve(join(dirname(runtimeBin), '..', 'node_modules', '@deepseek-ai', 'dsh-acp', 'lib', 'index.js'))
+}
+
+/** 该文件是否已经支持预设（原生支持或已打过补丁）。 */
+export function acpPresetSupported(file) {
+  try {
+    const s = readFileSync(file, 'utf8')
+    return /preset:\s*Schema\.string\(\)/.test(s) && /agentPresets/.test(s)
+  } catch { return false }
+}
+
+/**
+ * 确保已装的 dsh-acp 支持 `Config.preset`。幂等、失败即弃、写前备份、写后语法检查。
+ * @param {{runtimeBin:string, log?:(m:string,e?:object)=>void, dryRun?:boolean}} o
+ * @returns {{status:'supported'|'already'|'patched'|'shape-mismatch'|'missing'|'syntax-failed'|'error', file:string, detail?:string, backup?:string}}
+ */
+export function ensureAcpPresetSupport(o) {
+  const log = o.log || (() => {})
+  const file = acpPackageFile(o.runtimeBin)
+  if (!file || !existsSync(file)) return { status: 'missing', file, detail: '未找到已装的 dsh-acp（可能不是桌面运行时）' }
+
+  let src
+  try { src = readFileSync(file, 'utf8') } catch (e) { return { status: 'error', file, detail: String(e?.message ?? e) } }
+
+  if (src.includes(SHIM_MARK)) return { status: 'already', file, detail: '已打过 wxbridge 预设补丁' }
+  if (/preset:\s*Schema\.string\(\)/.test(src)) return { status: 'supported', file, detail: '上游已支持 Config.preset，无需补丁' }
+
+  // 形状检查：所有锚点都必须恰好命中一次，否则整体拒绝
+  let out = src
+  for (const [name, old, next] of EDITS) {
+    const n = out.split(old).length - 1
+    if (n !== 1) return { status: 'shape-mismatch', file, detail: `锚点 ${name} 命中 ${n} 次（期望 1）——上游可能已改动，拒绝打补丁` }
+    out = out.replace(old, next)
+  }
+  out = `/* ${SHIM_MARK} · 由 wxbridge 插件在启动时写入；上游支持 Config.preset 后本补丁可移除 */\n` + out
+
+  if (o.dryRun) return { status: 'patched', file, detail: 'dryRun：未写盘' }
+
+  // 写后先过语法检查，再落盘（补丁坏了等于把用户的运行时搞坏）
+  try {
+    const tmp = join(tmpdir(), 'dsh-acp-check-' + process.pid + '.mjs')
+    writeFileSync(tmp, out)
+    const r = spawnSync(process.execPath, ['--check', tmp], { timeout: 30000, windowsHide: true })
+    if (r.status !== 0) return { status: 'syntax-failed', file, detail: String(r.stderr || '').slice(0, 300) || 'node --check 未通过' }
+  } catch (e) {
+    return { status: 'syntax-failed', file, detail: String(e?.message ?? e) }
+  }
+
+  const backup = file + '.wxbridge-bak-' + new Date().toISOString().replace(/[-:T]/g, '').slice(0, 14)
+  try {
+    copyFileSync(file, backup)
+    writeFileSync(file, out)
+  } catch (e) {
+    return { status: 'error', file, detail: '写入失败：' + String(e?.message ?? e) }
+  }
+  log('acp-shim-patched', { file, backup })
+  return { status: 'patched', file, backup, detail: '已打 6 处预设补丁（含备份）' }
+}

package/lib/kernel/acp.mjs

@@ -0,0 +1,232 @@
+/**
+ * acp.mjs — DSH ACP 客户端（内核组件）
+ *
+ * 为什么需要它：旧路径把「契约 + 历史 + 本轮」拼成一个提示词交给一次性 headless 子进程，
+ * 上下文由**桥**维护（拼接），因此每轮都是新会话、也没有会话可续。
+ * 新路径：由桥起一个常驻的 `dsh --profile acp` 进程，用 ACP（Agent Client Protocol v1）
+ * 驱动 **DSH 自己的会话**——会话由 DSH 持久化，上下文归 DSH，桥只负责传话。
+ *
+ * 协议要点（源自 @deepseek-ai/dsh-acp 的 README 与实现）：
+ *   initialize / session/new / session/list / session/resume / session/close /
+ *   session/set_config_option / session/prompt / session/cancel（通知）
+ *   服务端→客户端：session/update（通知）、session/request_permission（请求，必须应答）
+ *   v1 不再有 session/load（已声明不支持）。
+ *
+ * 传输：stdio 上的 NDJSON（一行一个 JSON-RPC）。stdout 只有协议流量，日志在 stderr。
+ */
+import { spawn } from 'node:child_process'
+
+const PROTOCOL_VERSION = 1
+const NL = '\n'
+
+export class AcpHost {
+  /**
+   * @param {object} o
+   * @param {string} o.bin        dsh 入口（bin.js 绝对路径）
+   * @param {string} [o.home]     子进程 DSH_HOME（决定会话写进哪个仓库）
+   * @param {string} [o.cwd]      子进程工作目录（默认进程 cwd）
+   * @param {string} [o.patch]    --patch 叠加层文件（如停用宿主专属插件）
+   * @param {string} [o.permPolicy] 权限策略：'allow'（默认）| 'reject'
+   * @param {number} [o.promptTimeoutMs]
+   * @param {(m:string, e?:object)=>void} [o.log]
+   */
+  constructor(o) {
+    this.bin = o.bin
+    this.home = o.home || ''
+    this.cwd = o.cwd || process.cwd()
+    this.patch = o.patch || ''
+    this.permPolicy = o.permPolicy === 'reject' ? 'reject' : 'allow'
+    this.promptTimeoutMs = Number(o.promptTimeoutMs || 300000)
+    this.log = o.log || (() => {})
+    this.child = null
+    this.ready = null
+    this.nextId = 1
+    this.pending = new Map()
+    this.inflight = new Map()
+    /** 本进程内已挂载（激活）的会话：这些不能 resume（resume 只接非激活的持久会话）。 */
+    this.sessions = new Set()
+    this.buf = ''
+    this.errTail = ''
+    this.notes = []
+  }
+
+  get pid() { return this.child?.pid ?? 0 }
+  /** 该会话是否已由本进程挂载（激活）。 */
+  has(sessionId) { return this.sessions.has(sessionId) }
+  get alive() { return !!this.child && this.child.exitCode === null }
+
+  /** 惰性启动 + 握手（并发调用共享同一个 promise）。 */
+  ensure() {
+    if (this.ready) return this.ready
+    this.ready = this._start().catch((e) => { this.ready = null; throw e })
+    return this.ready
+  }
+
+  async _start() {
+    const args = [this.bin, '--profile', 'acp']
+    if (this.patch) args.push('--patch', this.patch)
+    const env = { ...process.env }
+    if (this.home) env.DSH_HOME = this.home
+    const child = spawn(process.execPath, args, { cwd: this.cwd, windowsHide: true, stdio: ['pipe', 'pipe', 'pipe'], env })
+    this.child = child
+    this.log('acp-spawn', { pid: child.pid, home: this.home || '(inherit)', patch: this.patch || null })
+    child.stdout.on('data', (b) => this._onData(b))
+    child.stderr.on('data', (b) => {
+      const s = String(b)
+      this.errTail = (this.errTail + s).slice(-2000)
+      this.log('acp-stderr', { s: s.slice(0, 300) })
+    })
+    child.on('exit', (code, signal) => {
+      this.log('acp-exit', { code, signal, stderr: this.errTail.slice(-400) })
+      this.ready = null
+      this.sessions.clear()
+      for (const [, p] of this.pending) p.reject(new Error('ACP 进程已退出(code=' + code + ')'))
+      this.pending.clear()
+    })
+    if (child.stdin.on) child.stdin.on('error', () => {})
+    const init = await this._request('initialize', {
+      protocolVersion: PROTOCOL_VERSION,
+      clientCapabilities: { fs: { readTextFile: false, writeTextFile: false } },
+    })
+    this.notes.push(init?.agentInfo?.name || 'acp')
+    return init
+  }
+
+  _onData(b) {
+    this.buf += String(b)
+    let i
+    while ((i = this.buf.indexOf(NL)) >= 0) {
+      const line = this.buf.slice(0, i).trim()
+      this.buf = this.buf.slice(i + 1)
+      if (!line) continue
+      let f
+      try { f = JSON.parse(line) } catch { continue }
+      this._onFrame(f)
+    }
+  }
+
+  _onFrame(f) {
+    if (f.id !== undefined && f.method === undefined) {
+      const p = this.pending.get(f.id)
+      if (!p) return
+      this.pending.delete(f.id)
+      if (f.error) p.reject(Object.assign(new Error(String(f.error.message || 'rpc error')), { rpc: f.error }))
+      else p.resolve(f.result)
+      return
+    }
+    if (f.method === 'session/update') {
+      const sid = f.params?.sessionId
+      const u = f.params?.update ?? {}
+      const sink = this.inflight.get(sid)
+      if (sink) sink(u)
+      return
+    }
+    if (f.method === 'session/request_permission') {
+      const opts = f.params?.options ?? []
+      const pick = this.permPolicy === 'allow'
+        ? opts.find((o) => /allow/.test(String(o.kind))) || opts.find((o) => /allow/.test(String(o.optionId)))
+        : opts.find((o) => /reject/.test(String(o.kind))) || opts.find((o) => /reject/.test(String(o.optionId)))
+      this.log('acp-permission', { tool: f.params?.toolCall?.title, policy: this.permPolicy, picked: pick?.optionId ?? null })
+      this._raw({ jsonrpc: '2.0', id: f.id, result: pick ? { outcome: { outcome: 'selected', optionId: pick.optionId } } : { outcome: { outcome: 'cancelled' } } })
+      return
+    }
+    if (f.id !== undefined && f.method) {
+      this._raw({ jsonrpc: '2.0', id: f.id, error: { code: -32601, message: 'unsupported by wxbridge client: ' + f.method } })
+    }
+  }
+
+  _raw(frame) {
+    try { this.child.stdin.write(JSON.stringify(frame) + NL) } catch (e) { this.log('acp-write-failed', { error: String(e?.message ?? e) }) }
+  }
+
+  _request(method, params, timeoutMs) {
+    return new Promise((resolve, reject) => {
+      const id = this.nextId++
+      const t = setTimeout(() => { this.pending.delete(id); reject(new Error('ACP 超时：' + method)) }, Number(timeoutMs || this.promptTimeoutMs))
+      this.pending.set(id, { resolve: (v) => { clearTimeout(t); resolve(v) }, reject: (e) => { clearTimeout(t); reject(e) } })
+      this._raw({ jsonrpc: '2.0', id, method, params })
+    })
+  }
+
+  async newSession(cwd) {
+    await this.ensure()
+    const r = await this._request('session/new', { cwd: String(cwd || this.cwd), mcpServers: [] })
+    if (r?.sessionId) this.sessions.add(r.sessionId)
+    this.log('acp-session-new', { sessionId: r?.sessionId, cwd })
+    return r
+  }
+
+  async resumeSession(sessionId, cwd) {
+    await this.ensure()
+    if (this.sessions.has(sessionId)) {
+      this.log('acp-session-already-mounted', { sessionId })
+      return { sessionId }
+    }
+    const r = await this._request('session/resume', { sessionId, cwd: String(cwd || this.cwd) })
+    this.sessions.add(sessionId)
+    this.log('acp-session-resume', { sessionId })
+    return r
+  }
+
+  /** 列出可续接的持久会话（可选按 cwd 过滤）。 */
+  async listSessions(cwd) {
+    await this.ensure()
+    const r = await this._request('session/list', cwd ? { cwd: String(cwd) } : {})
+    return r?.sessions ?? []
+  }
+
+  /** 建立/接续一条会话：先试 resume，失败则新建。 */
+  async attach(sessionId, cwd) {
+    if (sessionId) {
+      try { await this.resumeSession(sessionId, cwd); return { sessionId, resumed: true } } catch (e) {
+        this.log('acp-resume-failed', { sessionId, error: String(e?.message ?? e) })
+      }
+    }
+    const r = await this.newSession(cwd)
+    return { sessionId: r?.sessionId, resumed: false, configOptions: r?.configOptions ?? null }
+  }
+
+  /**
+   * 发一轮提示词，收集助手正文（思考块与工具生命周期走 onUpdate，便于回传进度）。
+   * @returns {Promise<{text:string, stopReason:string, toolCalls:number}>}
+   */
+  async ask(sessionId, text, onUpdate) {
+    await this.ensure()
+    let out = ''
+    let tools = 0
+    const sink = (u) => {
+      if (u.sessionUpdate === 'agent_message_chunk' && u.content?.type === 'text') out += u.content.text
+      else if (u.sessionUpdate === 'tool_call') tools++
+      if (onUpdate) { try { onUpdate(u) } catch {} }
+    }
+    this.inflight.set(sessionId, sink)
+    try {
+      const r = await this._request('session/prompt', { sessionId, prompt: [{ type: 'text', text: String(text) }] })
+      return { text: out.trim(), stopReason: r?.stopReason ?? null, toolCalls: tools }
+    } finally {
+      this.inflight.delete(sessionId)
+    }
+  }
+
+  /** 改会话配置（model / reasoning_effort）。value 形如 '["provider","model"]' 或 'high'。 */
+  async setConfigOption(sessionId, configId, value) {
+    await this.ensure()
+    const r = await this._request('session/set_config_option', { sessionId, configId, value })
+    this.log('acp-set-config', { sessionId, configId, value })
+    return r
+  }
+
+  async cancel(sessionId) {
+    this._raw({ jsonrpc: '2.0', method: 'session/cancel', params: { sessionId } })
+  }
+
+  async closeSession(sessionId) {
+    try { await this._request('session/close', { sessionId }); this.sessions.delete(sessionId) } catch (e) { this.log('acp-close-failed', { error: String(e?.message ?? e) }) }
+  }
+
+  stop() {
+    try { if (this.child && this.child.exitCode === null) this.child.kill() } catch {}
+    this.child = null
+    this.ready = null
+  }
+}