dsh-wechat-gateway
进程内 DeepSeek Harness 插件：在 WeChat 中直接与您的 DSH agent 聊天
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Carl-5535/dsh-wechat-gateway#302ea474a8df041645a6fc09d50ffb5862db9acbWechat Gateway 以 dsh-wechat-gateway 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
把个人微信变成 DeepSeek Harness (DSH) Agent 的远程入口——手机微信发消息，本机 Agent 干活，回复送回微信。
插件以 Cordis 插件形式运行在 DSH Host 进程内，每个微信聊天对应一个持久会话，可在 Web UI 同时查看和接管。
/new 随时重开[[send-file:路径]] 回发，正文提及的工作区文件自动回发（realpath 防越界，单条最多 5 个）/permission 切换预设（workspace-write ↔ danger-full-access），立即生效wechat_notify 工具让任何 DSH 会话都能主动推送消息到你的微信# 1. 安装
npm i -g @deepseek-ai/dsh
dsh plugin --profile web add "github:Carl-5535/dsh-wechat-gateway#main"
# 2. 启动（默认 http://127.0.0.1:3080）
dsh web
# 3. 侧边栏底部「微信」入口 → 手机微信扫码
# 4. 用你自己的微信给机器人账号发消息即可
pnpm ≥ 10 需要显式允许 git 插件构建脚本。安装报
ERR_PNPM_GIT_DEPARE_NOT_ALLOWED时，在 profile 目录（默认~/.dsh/profiles/web/）的pnpm-workspace.yaml添加onlyBuiltDependencies: [dsh-wechat-gateway]后重试。
Windows 本地开发用反斜杠绝对路径（
D:\path\to\dsh-wechat-gateway），不要写file:D:/...。macOS / Linux 用file:/绝对路径。
也支持不装全局 CLI：把 dsh 换成 npx @deepseek-ai/dsh。
| 命令 | 作用 |
|---|---|
/help /帮助 | 查看说明 |
/status /状态 | 查看会话状态 |
/stop /停止 | 中止当前任务 |
/new /新会话 | 丢弃上下文，开启新会话 |
/model /模型 | 查看/切换模型（序号、模型 id 或 provider/model，仅当前聊天生效） |
/permission /权限 | 查看/切换权限模式（序号、名称或中文别名，立即生效） |
其余消息作为用户输入交给 Agent 处理。凭据约 24 小时过期（腾讯策略），到期后侧边栏入口变灰，重新扫码即可。
Agent 在 workspace-write 模式下越界操作时触发审批：
/permission 使用 DSH 官方 permissionPresets 服务：
切换写入会话事件日志，立即生效，Web UI 同步显示；/new 后回到默认。
扫码登录后 wechat_notify 工具对所有 Agent 会话可用，推送目标为扫码账号：
任何能给登录账号发微信消息的人，都在向你的 Agent 下达指令。 因此默认拒绝一切来源：
workspace-write（越界需审批），出站文件 realpath 校验锁定在工作区内所有配置均可通过环境变量覆盖：
| 变量 | 默认值 | 说明 |
|---|---|---|
WECHAT_BOT_TOKEN | — | 直接注入 token（优先于凭据文件） |
WECHAT_CREDENTIAL_PATH | $DSH_HOME/wechat-gateway/account.json | 凭据文件 |
WECHAT_STATE_PATH | $DSH_HOME/wechat-gateway/state.json | 网关状态文件 |
WECHAT_WORKSPACE | 用户主目录 | Agent 工作区（cwd + 文件边界） |
WECHAT_ALLOWED_USERS | 登录账号本人 | 用户白名单，逗号分隔 |
WECHAT_MEDIA_DIR | $WORKSPACE/.wechat-gateway/inbox | 入站媒体目录 |
WECHAT_BOT_API_BASE | https://ilinkai.weixin.qq.com | iLink API 入口 |
WECHAT_CDN_BASE | https://novac2c.cdn.weixin.qq.com/c2c | 媒体 CDN |
WECHAT_MAX_MESSAGE_CHARS | 3500 | 单条回复最大字符数 |
WECHAT_MAX_MEDIA_BYTES | 104857600 | 单个媒体大小上限 |
WECHAT_AUTO_SEND_FILES | true | 正文提及的工作区文件自动回发（0/false 关闭） |
手机微信 ⇄ iLink Bot API ⇄ ┌─ dsh web (Host 进程) ─────────────┐
│ wechat-gateway 插件 (Cordis) │
│ ├─ ILinkClient 长轮询/发送/媒体 │
│ ├─ WechatGateway 会话映射+投递 │
│ ├─ wechat_notify 主动推送 │
│ └─ 登录路由 + 侧边栏 UI │
│ agents.create/resume → DSH Agent │
└────────────────────────────────────┘
入站 getupdates 长轮询 → 去重 → 白名单 → 命令解析或 agent.followup()。出站 turn/end → 提取文本 → 持久化 outbox → 分块投递。chatId→sessionId 映射、轮询游标、去重表、发件箱断点全部落盘可续跑。
npm install
npm run typecheck # 类型检查
npm test # 65 个单元测试
npm run build # 产出 lib/（含客户端 bundle）
MIT License 开源。独立实现，部分设计衍生自社区 MIT 实现：iLink 协议层与投递队列参考 dsh-weixin，协议细节与 dsh-wechat-bridge 及官方 SDK 交叉验证。完整第三方声明见 LICENSE。