deepseek-harness-weixin
把 deepseek-harness（DSH）的 coding agent 接到微信：扫码登录一次，
手机里的私聊消息就会按好友进入 DSH agent 会话执行——工具、文件、
子代理、goal 全部可用，回复带打字指示并自动分块。
WeChat channel for deepseek-harness. Scan a QR with your phone WeChat, then every
private message runs as a full DSH agent session (bash/pwsh, filesystem, web search,
subagents) over the ilink bot protocol. Ported from Tencent/openclaw-weixin; no OpenClaw needed.
MIT License · Node ≥ 22 · Windows PowerShell · 纯 ESM 无构建 · 独立 dsh profile
快速开始
前置：能运行 dsh（dsh --version）。没有就先全局装：
powershell -ExecutionPolicy Bypass -File scripts\install-dsh.ps1
然后三条 dsh 命令搞定：
dsh plugin --profile weixin add https://github.com/qqmqq/deepseek-harness-weixin
powershell -ExecutionPolicy Bypass -File scripts\weixin-login.ps1 # 终端二维码扫码登录
启动通道：
dsh --profile weixin # 微信通道（保持窗口运行 = 长轮询中）
dsh web # 需要图形界面时打开 Web GUI
看到 dsh-channel-weixin running: accounts=... 即在线，用手机发 你好 或 /help 测试。
同微信号同一时间只允许一个长轮询客户端：若曾用 OpenClaw + openclaw-weixin，先 openclaw config set plugins.entries.openclaw-weixin.enabled false 并 openclaw gateway restart。
单条 add 即完整可用：本仓库 bundle 自包含（code-runtime 直接插入），不再依赖 @deepseek-ai/dsh-headless。
旧版安装过 headless 的 profile，升级时先 dsh plugin --profile weixin remove dsh-headless dsh-channel-weixin 再 add 本仓库一次即可。
微信内指令
/help 帮助
/new 开启新会话（清空当前好友的上下文）
/stop 取消正在执行的任务
/status 会话状态 / 模型 / 工作目录
特性
- 扫码登录（终端二维码），多账号各一条独立长轮询
- 每好友一个持久 DSH agent 会话：cwd 隔离在 wx-work/，重启自动续聊
- 打字指示 + 回复分块（1600 字符）发送
- 零外部依赖；二维码渲染器已 vendor
- 无人值守安全：越界/危险操作 fail-closed 拒绝，不卡轮次
安全模型
- 消息可在沙箱（workspace-write）内自动执行工具：只对可信账号开放，微信号被盗 ≈ 本机工作区可控
- 登录凭证明文存 ~/.dsh/weixin，请保护该目录
- ilink 为官方生态外通道：登录态可能失效（自动暂停告警），存在平台风控风险，请合规使用
配置（可选）
编辑 ~/.dsh/profiles/weixin/cordis.patch.yml，按行 id dsh-channel-weixin 整体覆盖：
| 键 | 默认 | 说明 |
|---|
| workspaceRoot | <启动目录>/wx-work | 各好友工作目录父目录（可换 WEIXIN_WORKSPACE_ROOT） |
| stateDir | ~/.dsh/weixin | 凭证/游标/会话映射（可换 WEIXIN_STATE_DIR） |
| turnTimeoutMs | 1800000 | 单轮看门狗，超时自动取消 |
| chunkMax | 1600 | 单条回复最大字符 |
| typing / queueAck | true | 打字指示 / 忙时排队提示 |
已知限制与缺点（坦白说）
- 媒体不可见不可发：只处理文本与语音转写文本，图片/文件/视频不进模型也不能回发
- 单账号消息串行；长任务期间新消息等服务端挂起
- 回复非流式（整轮后聚合发送，30 分钟看门狗兜底）
- 一好友一常驻 agent，好友多时内存随之上升
- 无 Web 管理界面；加账号/改配置/升级都要改文件并重启
- Windows 优先；基于 DSH 0.1.1-rc API，升级可能需适配
Roadmap
- 媒体收发（上游 CDN 加密代码已就绪）
- 工具进度卡片 · 群聊 · 流式回复 · 每账号并行与排队
仓库结构
lib/ 插件代码（纯 ESM；仓库根即 `dsh plugin add` 可装的 bundle）
scripts/ install-weixin / install-dsh / dsh / weixin-login / setup / start / rollback
weixin-profile-example/
.github/workflows/ci.yml CI：语法 + CLI + 单测冒烟
SECURITY.md · THIRD_PARTY_NOTICES.md
开发自检
node --check lib/*.js
node scripts/unit-smoke.mjs
许可证与致谢
MIT。微信传输代码衍生自 Tencent/openclaw-weixin (MIT)；
二维码渲染器来自 qrcode-terminal (MIT)。详见 LICENSE 与 THIRD_PARTY_NOTICES.md。
本项目为个人/学习用途的集成示例，非 DeepSeek 官方产品。
