dsh-channel-wechat
DeepSeek Harness 的 WeChat（iLink / ClawBot）渠道
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:wangx-wx/dsh-channel-wechat#7dac24547cb3c56bc353d45ca2c70da9b0219f7fChannel Wechat 以 dsh-channel-wechat 发布，当前版本为 0.2.4。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
把微信（腾讯 iLink / ClawBot）接入 DeepSeek Harness 的通道插件。它以一个 npm 包同时提供 Harness bundle 和 GUI 浏览器端，运行在 Harness 进程内。
session/event 回到微信。/models、/model、/help）、/stop、审批卡和提问卡。群聊、运行期多账号、主动推送和独立权限系统不在当前范围内。
| 组件 | 要求 |
|---|---|
| Node.js | ^22.19.0 或 >=24.0.0 |
| pnpm | 11（仓库声明 pnpm@11.7.0） |
| DeepSeek Harness | >=0.2.0-rc.1 |
安装门槛来自 package.json 的 engines；已验证版本和未验证范围见 兼容性说明。
确认 profile 已有一个你希望用于微信会话的工作目录。
安装插件并重启 DSH：
dsh plugin --profile <你的 profile> add dsh-channel-wechat
打开 GUI 的 Plugins → dsh-channel-wechat，点击登录微信，使用手机扫码；需要验证码时在页面输入。
从微信向 bot 发一条消息，确认 DSH 回复返回微信。
安装后必须完全退出并重启 DSH，宿主才能发现浏览器端配置页。刚发布版本若被 pnpm 的观察期跳过，可使用：
dsh plugin --profile <你的 profile> add dsh-channel-wechat@latest --config.minimumReleaseAge=0
GUI 页面可编辑全部配置。也可以在 profile 的 cordis.patch.yml 中写：
- id: channel-wechat
config:
cwd: /你的/工作目录
cards: wechat
provider: ''
model: ''
permission: workspace-write
cwd 必须是绝对路径；它在会话创建时写入且不可变，修改只影响之后的新会话。完整字段、默认值和权限边界见 配置参考。
没有 web app 的 profile 可以使用终端登录：
dsh <profile> login
dsh <profile> status
dsh <profile> logout
web/desktop profile 的启动器会先拒绝 login 位置参数，请改用 GUI 登录。
| 内容 | 位置 |
|---|---|
| 会话记录 | ~/.dsh/sessions/<cwd 转义>/channel-wechat-<peerId>[~g<N>]/session.v4.jsonl.zstd |
| 插件状态 | ~/.dsh/channel-wechat/ |
| 诊断日志 | ~/.dsh/channel-wechat/log/channel-wechat-YYYY-MM-DD.log，保留 7 天 |
| 登录凭证 | ~/.dsh/.credentials.yaml |
聊天记录由 DSH 持久化，/new 只创建新的会话代次，不删除旧记录。排障时不要分享 token、Cookie 或凭证文件内容。
cwd 是否为绝对路径。请先查看故障排查和插件日志。仍未解决时，请在 GitHub Issues 提供 DSH 版本、插件版本、profile 类型、复现步骤和脱敏日志；不要提交 token、Cookie 或凭证文件。
欢迎通过 GitHub Issues 报告问题或提出建议，也可以提交 Pull Request。提交前请阅读 开发与验证，并运行构建、类型检查和相关测试。项目维护者与仓库信息见 GitHub repository。
pnpm install
pnpm build
pnpm typecheck
pnpm test
pnpm test:integration
集成测试使用隔离的临时 DSH_HOME，默认寻找本地 DeepSeek Harness checkout；需要时设置 DSH_CHECKOUT=/path/to/deepseek-harness。详细说明见 开发与验证。
本项目使用 MIT，第三方代码和完整版权声明见 LICENSE 与 THIRD_PARTY_NOTICES.md。协议实现参考腾讯的 openclaw-weixin。