dsh-plugin-attune-wechat-agent

Attune · 微信 AI Agent / WeChat AI Agent

Attune 是接入 DeepSeek Harness（DSH）桌面端的微信 AI Agent（WeChat AI agent / WeChat agent）会话工作台：它让 AI 在微信群里记住关系、积累情感与成员画像，并通过语音、主动互动和跨平台内容参与群聊。技术包名为 dsh-plugin-attune；原名 Weave / dsh-plugin-wechat-agent。

> 搜索关键词：微信agent、微信ai、微信AI、wechatagent、wechatai、wechat agent、wechat ai、微信机器人、微信群助手、DSH 微信插件。搜这些词都应该能找到 Attune。

host 半在 DSH 的 HTTP 服务上挂载同源 /wechat/api/ 代理、/wechat/health 状态探针和 /wechat/setup/ 一键部署接口；client 半提供一个完整的蓝白控制台页面（会话顶部「Attune」标签页，同时是设置里的「Attune」分节），成员画像和群像都在页面内的「回声」子页查看。

> 开源 MIT。通过 Attune 把 Agent 部署到一台 Ubuntu / Xubuntu 24.04 LTS 虚拟机，再从 DSH 里连接、配置和控制。请只使用专用测试微信号，不要用主号。

插件有四种模式：

• 一键部署模式（推荐给非技术用户）：在页面「部署」子页点「一键连接」打开 DSH 风格操作页 → 在操作页点「复制命令」到虚拟机终端粘贴运行（自动装 SSH 并打印连接码）→ 把连接码粘回操作页、输入开机密码点「一键连接」。插件用内置的 ssh2 连接虚拟机、上传内置源码包、自动安装依赖、创建 Python 环境、写入初始 .env、启动控制台，并维持自己的 SSH 隧道。不需要用户自己拿命令行部署、查 IP 或预先配 SSH 密钥；
• SSH 隧道模式：在 DSH 插件设置里填 remote_ssh，例如 wx@192.168.1.50。插件自己维持 ssh -N -L 127.0.0.1:8765:127.0.0.1:8765，主机 DSH 直接读取虚拟机状态；虚拟机控制台继续只监听 loopback，不用对外暴露端口；
• 远程直连模式：填 remote_url，例如 http://192.168.1.50:8765（前提是控制台已监听该地址）。主机 DSH 直接读那台机器，插件不启动任何本地进程；
• 本地模式：两个都留空，插件按 desktop_host / desktop_port 启动并管理 python -m wechat_agent desktop 子进程。

优先级是「部署页保存的虚拟机连接」> remote_ssh > remote_url > 本地。已经用 remote_ssh 手工配好的环境升级后行为不变；一旦在部署页连接过虚拟机，就由部署页接管连接（想退回，点「断开」即可）。

控制台页面名为 Attune，采用蓝白 DS 风格并沿用 DSH 主题变量，六个子页为「概览、回声、平台、设置、部署、日志」：概览包含运行状态、启动 / 停止、已回复 / 读取 / 队列 / 异常四项关键计数、回复能力和真实最近动态，监听范围与连接入口集中展示，完整统计与白名单收在「更多数据与白名单」；回声是成员画像与群像；平台是抖音/小红书账号状态、三号互联关联、浏览与评论，动作台账、共享记忆与主动浏览收在页面末尾的折叠区；设置读写虚拟机 .env（221 项，常用项，高级折叠），并提供按供应商能力显示的「声音 DIY」和「试听当前音色」；部署是一键连接 / 检测 / 安装 / 启动微信 / 配置的五步向导；日志是事件流、回复账本与发送审计。

环境要求

• DeepSeek Harness 桌面端（带 webServer 的 desktop profile）；
• Node.js ^22.19.0 或 >=24；
• 一台 Ubuntu / Xubuntu 24.04 LTS 的 X11 虚拟机（VMware Workstation 17 或其它）；
• 一个专用测试微信号，不要用主号。

安装

本仓库就是插件源码。本地路径安装会以 link: 链接进 profile，因此先安装插件自身声明的依赖（DSH 包由宿主提供，--omit=peer 避免把 React 和 cordis 装第二份）：

git clone https://github.com/lingmao233/dsh-plugin-attune-wechat-agent.git
cd dsh-plugin-attune-wechat-agent
npm ci --omit=peer
dsh plugin --profile desktop add "C:\path\to\dsh-plugin-attune-wechat-agent"

dsh plugin ... add 里的路径换成你克隆下来的绝对路径（在 PowerShell 里可用 (Get-Location).Path 查看当前目录）。也可以在 DSH 插件页面按本地目录安装，然后重启 DSH。修改插件代码后同样需要重启；没有 HMR 时按 DSH 提示操作。

如果使用 DSH 官方「添加插件」，也可以直接粘贴 GitHub 地址：

https://github.com/lingmao233/dsh-plugin-attune-wechat-agent

首次安装会拉取依赖；装完按 DSH 提示重启。只输入裸包名 dsh-plugin-attune 时，需要该包已发布到 npm；目前以 GitHub 地址或本地目录为准。

从 Weave / 旧包名升级

如果你曾在 ~/.dsh/cordis.patch.yml 里手工给旧插件配置 remote_ssh，升级后要把那一行的 id / name 一起改成 Attune，否则 DSH 不会把 remote_ssh 传给新插件，界面会显示连接断开并退回本地模式：

- id: attune
  name: "dsh-plugin-attune"
  config:
    remote_ssh: jdy@192.168.126.128

改完后 DSH 会热加载配置并重新拉起 SSH 隧道；如果页面还显示断开，按 Ctrl+R 刷新。

安装后不必单独启动控制台。SSH 隧道和远程模式下控制台本来就在虚拟机上跑；本地模式下若配置端口已有手动启动的控制台，代理会复用它，但该进程不由插件管理。

安装后怎么用（最短路径）

1. 打开任意会话，点顶部「对话 / 轨迹 / 微信 / 设计」中的「Attune」，再切到「部署」；

2. 点「一键连接」，按弹窗提示在虚拟机终端运行一行命令，把打印的 WECHAT-VM-CODE:... 和开机密码填回弹窗，点「一键连接」；

3. 点「一键部署到虚拟机」，等日志执行完；点「启动微信」并「查看虚拟机截图」扫码登录；

4. 回到「概览」点「启动」；之后在「设置」里确认群、模型和发送开关。

> 插件安装包里已经带好 Linux Agent 的预构建源码包，安装后一键部署不需要再联网拉取另一个仓库。完整可浏览的 Agent 源码在 [wechat-agent-linux](https://github.com/lingmao233/wechat-agent-linux)。

Agent 源码

完整的 Linux Agent/Python 控制台源码单独公开：

插件使用 assets/wechat-agent-linux-src.tar.gz 作为离线部署包；这个 tarball 就是由上面的源码仓库构建出来的。只想安装使用，不需要手动下载源码仓库。

打开控制台

装进 desktop profile 后有两个入口，任选其一：

• 会话顶部标签页：打开任意一个已有会话，标题下方就是 对话 / 轨迹 / 微信 / 设计 这一排，点「Attune」。它和对话、轨迹同级，切走不会丢会话；
• 设置分节：点左下角账号头像 → 「设置」（或 Ctrl + Alt + ,），左侧导航新增「Attune」。新会话、没有会话时也能从这里进。

两个入口渲染同一个页面，页面内再分「概览 / 回声 / 平台 / 设置 / 部署 / 日志」六个子页。插件已经装进 desktop profile 时不需要再做什么；只改了 lib/client.js 的话，刷新一次页面（Ctrl+R）就会加载新前端。改了 index.mjs / lib/*.mjs 的 host 半后，重载插件即可生效（DSH 会监听 ~/.dsh/cordis.patch.yml：改动该文件保存一次，插件会重新加载；也可以重启 DSH）。

输入框上方不再挂「回声」摘要；回声只在页面「回声」子页显示，避免占用聊天输入区。

一键部署（「部署」子页）

给别人的虚拟机用，只需要页面上的五步，不用命令行：

小白一键连接（推荐，3 步，不用查 IP）：部署页第 1 步只放一个「一键连接」按钮；点它会打开 DSH 风格的操作弹窗，复制命令、粘贴连接码、输密码都在弹窗里完成。弹窗使用 DSH 的 --dsw-* 设计变量（背景/边框/圆角/阴影/主题色），自动跟随亮色和暗色主题；手动填写和详细排查也收在弹窗的两个链接里，不会默认铺开解释。

1. 在操作弹窗里点「复制命令」（或手动复制下面这行），到虚拟机桌面打开终端，右键粘贴后回车。SSH 已经在运行就直接打印连接码；没装 SSH 才需要按提示输入一次虚拟机登录密码：

   if systemctl is-active --quiet ssh; then echo "WECHAT-VM-CODE:$(whoami)@$(hostname -I | awk '{print $1}'):22"; else sudo apt-get update -qq || true; sudo apt-get install -y -qq openssh-server && sudo systemctl enable --now ssh; sudo sed -i 's/^#\?PasswordAuthentication.*/PasswordAuthentication yes/' /etc/ssh/sshd_config; sudo systemctl restart ssh; command -v ufw >/dev/null && sudo ufw allow 22/tcp >/dev/null 2>&1 || true; echo "WECHAT-VM-CODE:$(whoami)@$(hostname -I | awk '{print $1}'):22"; fi

2. 命令结束会打印一行 WECHAT-VM-CODE:用户名@IP:22，把这一整行复制。

3. 粘回操作弹窗的「连接码」输入框，再输入虚拟机登录密码，点「一键连接」——IP、用户名、端口都会自动填好，插件会自己检测环境。按 Esc、点右上角 ×、点遮罩或「取消」都能关闭弹窗；连接进行中会暂时锁住关闭，避免中途丢失进度。

命令跑完还是连不上？ 再按这 4 项排查（操作弹窗的「连不上？展开排查说明」里也有）：

| 检查项 | 在虚拟机里怎么看 |