dsh-wechat-ai-bridge

DeepSeek Harness（DSH）的微信桥接插件：通过 wechat-ai 的 MCP 服务，把微信私聊/群聊 @ 消息交给持久化的 DSH Agent 会话，并把 Agent 的最终回复发回微信。同时提供 Web 设置页和微信上下文读取工具。

功能

• 私聊自动回复；群聊只在被 @ 时回复，并 @ 回发送者。
• 每个微信会话对应一个 DSH Session，可在 Web UI 侧边栏查看。
• 默认按联系人和群隔离工作区，首次需要 Agent 时才创建；也可切换为共享工作区。
• 接收文本、图片、引用消息和文件；引用图片会作为附件转发。
• Agent 的文件/命令工具限定在专用工作区（bubblewrap，不挂载宿主机目录）。
• 可选 Codex CLI 子代理，运行在同一个工作区 jail 内。
• Web UI「设置 → 微信桥接」配置页，支持分组表单和保存。

环境要求

• DSH Web profile（插件基于 DSH 0.2.x 开发）。
• 运行中的 wechat-ai，提供 Streamable HTTP MCP（默认 http://127.0.0.1:8100/mcp）。
• 可用的 DSH 模型；图片转发需要模型支持 image 输入。
• 发送消息需要 wechat-ai 侧 WECHAT_AI_MCP_WRITE_ENABLED=true。
• 可选：Codex CLI（codex 与 codex-code-mode-host）。

安装

git clone https://github.com/Windfarer/dsh-wechat-ai-bridge.git

使用 DSH plugin_manager 的 install_bundle 安装本目录。插件会插入 preset-wechat、preset-wechat-work 和 wechat-ai-bridge 行，不覆盖 DSH 的 permission 行，权限使用内置 workspace-write。

安装后需要配置 MCP token：

• tokenFile：包含 WECHAT_AI_MCP_TOKEN=... 的 dotenv 文件；
• 或环境变量 WECHAT_AI_MCP_TOKEN；
• 不建议在仓库中写死 token。

- id: wechat-ai-bridge
  name: 'dsh-wechat-ai-bridge'
  config:
    mcpUrl: http://127.0.0.1:8100/mcp
    tokenFile: /path/to/wechat-ai/.env
    workspaceMode: per-chat
    workspaceTitle: 微信桥接
    agentPreset: wechat-work
    permissionPreset: workspace-write

workspacePath 可选，默认 ~/.dsh/wechat-ai-bridge-workspace。

配置项	默认值	说明
workspaceMode	per-chat	per-chat 为每个私聊联系人、每个群建立独立工作区；shared 保留单一工作区行为。
workspacePath	~/.dsh/wechat-ai-bridge-workspace	逐聊天模式的根目录，或共享模式的工作区本身；在部署配置中修改。
workspaceTitle	微信桥接	标题前缀；逐聊天模式附加“微信 / 微信群”和显示名，共享模式直接使用此标题。

工作区与会话迁移

逐聊天模式使用 <workspacePath>/<安全用户名>-<8位摘要>/，目录键来自稳定的联系人或群 username，显示名变化不会改变目录。用户名经过字符过滤、去除前导点和连续点、长度限制，再附加原始 username 的 SHA-256 前 8 位摘要。群内成员共用该群的工作区，不会按群成员分别建立目录。

首次需要 Agent 时才建立目录并创建或复用 DSH 工作区，收到的文件保存在该聊天的 incoming/，启用 Codex 后认证与配置保存在该聊天的 .codex/。启动时不会为所有已知聊天预建目录。

升级到 0.2.0 后，未指定模式的配置默认使用 per-chat。启动时检查已保存会话的工作目录；切换模式或根目录后，只清除不匹配的会话关联，下次触发创建新会话。旧会话历史和旧工作区文件不会自动移动或删除。原来的通用默认路径保留为逐聊天模式的根目录；建议在部署配置中指定一个新的根目录，使旧共享数据与新目录更清晰地分开。需要原有行为时显式配置 workspaceMode: shared，并保留原 workspacePath。

设置页

安装后打开 设置 → 微信桥接，在基础设置中选择工作区模式。也可编辑 MCP 地址、token 文件、token 环境变量，以及模型、自动回复、图片/文件、工具与 Codex 配置；工作区根目录/状态/日志路径只读展示，token 本身不会返回浏览器。保存会通过 configEditor 写回 profile patch 并重载插件。

注意

• 群成员 @ 机器人即可驱动工作区内的 Agent；可用 reply.allowContacts / denyContacts 限制触发者。
• 逐聊天模式下，文件工具、命令沙箱和图片发送均限定在当前聊天的工作区。wechat_send_image 依据当前 Agent 的会话关联确定根目录；没有活跃桥接聊天上下文的调用会被拒绝，不会回退到包含所有聊天的根目录。共享模式保留从共享工作区发送图片的行为。
• 工作区隔离针对文件和命令访问；微信上下文读取工具仍按原有工具策略开放。自定义 Agent 预设应继续避免启用宿主机全局文件、终端等工具。
• 启用 Codex 会在聊天首次使用工作区时复制认证，每次运行前刷新各自的认证副本；工作区内代码可读取该凭据，建议使用单独账号。文件隔离不等于 Codex 账号隔离。
• 插件不硬编码任何账号、wxid 或 token；自己的 wxid 从 wechat-ai 的 database.data_dir 动态解析。

开发

纯 ESM，无构建、无 npm 依赖。语法检查：

for file in index.js client.js lib/*.js test/*.js; do node --check "$file" || exit; done
node --test

代码结构：index.js（Host 入口）、client.js（设置页）、lib/（MCP 客户端、桥接、工作区工具、设置路由）、cordis.patch.yml（bundle patch）。

License

MIT