前言¶

在 DeepSeek Harness（DSH）里做智能体，对话、轨迹和模型调用往往都在桌面端完成；一旦要把 AI 放进微信群，常见做法是单独起脚本、自己管登录和网络，关系和「谁说过什么」也很难和 DSH 会话对齐。Attune（npm 包名 dsh-plugin-attune，曾用名 Weave / dsh-plugin-wechat-agent）是 maintainer lingmao233 发布的 DSH 插件，分类为「记忆」：它在 DSH 里提供微信 AI Agent 工作台，让 Agent 在群里积累成员画像、情感与关系，并支持语音、主动互动和跨平台内容；Linux 侧控制台跑在 Ubuntu / Xubuntu 24.04 虚拟机上，由插件通过 HTTP 代理、SSH 隧道或一键部署接回主机 DSH。

下面介绍插件定位、能力、安装与最短使用路径。事实以 GitHub 仓库 README 为准；社区目录页见 skillhub.cn 插件条目。DSH 生态是「一切皆插件」；skillhub 为社区目录，与 DeepSeek / 幻方无官方从属关系。

这是什么¶

Attune 是接入 DSH 桌面端（需带 webServer 的 desktop profile）的微信 AI Agent 会话工作台。host 半在 DSH 的 HTTP 服务上挂载同源 /wechat/api/* 代理、/wechat/health 与 /wechat/setup/* 一键部署接口；client 半提供蓝白控制台（会话顶栏「Attune」标签与设置里「Attune」分节共用同一页面）。成员画像与群像集中在页面内「回声」子页查看。

开源协议为 MIT。文档明确要求只使用专用测试微信号，不要用主号。

核心功能¶

连接与运行模式¶

插件按优先级选择连接方式：部署页保存的虚拟机连接 > 插件设置里的 remote_ssh > remote_url > 本地。

1. 一键部署模式（README 推荐给非技术用户）：在「部署」子页走「一键连接」→ 虚拟机终端粘贴命令拿到 WECHAT-VM-CODE → 填回 DSH 操作页并输入开机密码；插件用内置 ssh2 上传预置源码包、装依赖、建 Python 环境、写初始 .env、启动控制台并维持 SSH 隧道，无需用户自行查 IP 或预先配 SSH 密钥。
2. SSH 隧道模式：在插件设置填 remote_ssh（例如 wx@192.168.1.50），插件维持 ssh -N -L 转发，虚拟机控制台只监听 loopback。
3. 远程直连模式：填 remote_url（例如 http://192.168.1.50:8765），前提是控制台已监听该地址；插件不启动本地子进程。
4. 本地模式：remote_ssh 与 remote_url 均留空时，按 desktop_host / desktop_port 启动并管理 python -m wechat_agent desktop 子进程。

控制台六个子页¶

页面名为 Attune，沿用 DSH 主题变量，子页为：概览、回声、平台、设置、部署、日志。

• 概览：运行状态、启停、已回复 / 读取 / 队列 / 异常计数、回复能力与最近动态；监听范围与连接入口集中展示。
• 回声：成员画像与群像（输入框上方不再挂回声摘要，避免占聊天区）。
• 平台：抖音 / 小红书账号状态、三号互联、浏览与评论等；动作台账、共享记忆等收在页末折叠区。
• 设置：读写虚拟机 .env（文档称共 216 项，常用项可见，高级折叠）；含「声音 DIY」与「试听当前音色」（按供应商能力显示）。
• 部署：一键连接、环境检测、一键部署、微信登录与配置的五步向导；内置 assets/wechat-agent-linux-src.tar.gz，一键部署无需再联网拉取另一仓库。
• 日志：事件流、回复账本与发送审计。

完整 Linux Agent 源码单独维护于 wechat-agent-linux；插件 tarball 由该仓库构建，仅使用时可不手动克隆源码仓。

记忆与 Agent 能力（简介层）¶

仓库描述与关键词强调：情感记忆、情绪（moods）、关系（relationships）、语音（voice），以及 wechat agent / 微信 AI 等检索词。具体模型字段与 216 项 .env 以控制台「设置」子页与虚拟机 .env 为准；首次部署默认 WECHAT_ALLOW_SEND=false（只读、不自动回复），需在设置里确认群、模型和发送开关后再打开。

环境要求¶

• DeepSeek Harness 桌面端（desktop profile，带 webServer）；
• Node.js ^22.19.0 或 >=24；
• Ubuntu / Xubuntu 24.04 LTS 的 X11 虚拟机（文档示例为 VMware Workstation 17 等）；
• 专用测试微信号。

安装与启用¶

插件以当前 DSH 进程权限运行；安装前应自行查看仓库源码与 MIT 许可证。README 说明本地路径安装会以 link: 链入 profile，需先安装插件声明的依赖（DSH 包由宿主提供）：

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"

将 add 后的路径换成克隆目录的绝对路径。也可在 DSH 插件页按本地目录安装，或在官方「添加插件」处粘贴 GitHub 地址：

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

首次安装会拉取依赖；装完按 DSH 提示重启。只输入裸包名 dsh-plugin-attune 时需该包已发布到 npm；文档写明目前以 GitHub 地址或本地目录为准。当前 package.json 版本为 0.8.0。

从 Weave / 旧包名升级¶

若在 ~/.dsh/cordis.patch.yml 里曾为旧插件配置 remote_ssh，升级后需把 id / name 改为 Attune，例如：

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

保存后 DSH 热加载配置；页面仍断开时可 Ctrl+R 刷新。

典型用法（最短路径）¶

README 给出的安装后最短路径如下：

1. 打开任意会话，点顶栏「对话 / 轨迹 / 微信 / 设计」中的 Attune，再切到 部署；
2. 点 一键连接，按弹窗在虚拟机终端运行命令，将打印的 WECHAT-VM-CODE:... 与开机密码填回，点 一键连接；
3. 点 一键部署到虚拟机，等日志结束；点 启动微信 并 查看虚拟机截图 扫码登录；
4. 回到 概览 点 启动；在 设置 里确认群、模型和发送开关。

另有两个固定入口：会话顶栏 Attune 标签，或左下角头像 → 设置 → Attune（Ctrl + Alt + ,）。只改 lib/client.js 时 Ctrl+R 刷新；改 index.mjs / lib/*.mjs 的 host 半需重载插件或重启 DSH。

虚拟机侧一键连接用的 bash 命令（打印连接码或安装 openssh-server）见 README「部署」章节；连不上时文档列出 IP、SSH 用户密码、服务状态、从 Windows 试 ssh 用户名@IP 等排查项。

适用场景与注意¶

适合谁：已在用 DSH desktop、希望在微信群内跑带关系与情感记忆的 Agent，并愿意用 Ubuntu / Xubuntu 24.04 虚拟机承载微信客户端与控制台的开发者或进阶用户；非技术用户可优先走部署页一键连接与一键部署。

注意：

• 务必使用测试号；插件与部署流程涉及 SSH、sudo 与虚拟机桌面，sudo 密码仅在部署任务内通过 stdin 传给 sudo -S，文档称不写入虚拟机文件。
• 插件不替代你对源码与安全边界的判断；远程 SSH 模式下控制台仍只监听 127.0.0.1，由隧道转发。
• GitHub 仓库当前星标为 2（以目录页/仓库页为准）。

结尾¶

Attune 把 DSH 会话界面与微信侧 Agent 控制台接在一起：记忆与画像在「回声」查看，部署与隧道在「部署」和插件设置完成，Agent 行为在「概览」「设置」「日志」里控制。需要条目信息与链接时，可打开社区目录 https://www.skillhub.cn/plugins/lingmao233/dsh-plugin-attune-wechat-agent 与源码仓库 https://github.com/lingmao233/dsh-plugin-attune-wechat-agent。