dsh-plugin-attune

配置

DSH 设置页按 Cordis Schema 渲染以下键。除 remote_ssh 和 remote_url 外，其余键名与 src/wechat_agent/config.py 完全一致。

键	默认	说明
remote_ssh	空	虚拟机 SSH 目标，例如 wx@192.168.1.50。填写后插件自己维持 ssh -L 隧道，控制台端口无需在虚拟机上对外监听
remote_url	空	直连控制台地址，例如 http://192.168.1.50:8765；与 remote_ssh 同时填写时只取它的端口作为隧道两端端口
python	空	解释器；留空优先使用项目 .venv，否则使用系统 Python。仅本地模式
project_dir	空	仓库根目录；本地安装时默认取插件包上一级。仅本地模式
config_file	空	传给 CLI 的 .env 路径。仅本地模式
desktop_host	127.0.0.1	本地控制台监听地址。仅本地模式
desktop_port	8765	本地控制台监听端口。仅本地模式
desktop_token	空	访问令牌；本地模式留空沿用控制台 .env，远程/隧道模式留空表示远端未设令牌
wechat_group_names	[]	回复群列表；留空沿用控制台 .env。仅本地模式

SSH 隧道与远程模式下，令牌只从 desktop_token 读取：虚拟机 .env 与本机 .env 不是同一份文件，插件不会把本机的 DESKTOP_TOKEN 发给远端。远端 DESKTOP_TOKEN 为空时保持留空即可，目前虚拟机的控制台就是这样配置的。

在「部署」子页连接过虚拟机后，连接参数以 ~/.dsh/wechat-agent-setup.json 为准，remote_ssh / remote_url 被忽略（避免两份配置打架）。部署页生成的虚拟机 .env 把 DESKTOP_TOKEN 留空，并让控制台只监听 127.0.0.1；通过 SSH 隧道访问不需要令牌。如果要给控制台设令牌，目前需要在虚拟机 .env 里改，再在部署页重新连接时把令牌填进连接记录（该字段暂未在页面暴露）。

SSH 使用系统 ssh 命令和默认密钥（-o BatchMode=yes，不会弹密码提示），插件运行期间自动重连；如果本机端口已经有别的隧道（例如手动跑了 scripts/vm-tunnel.ps1），插件会直接复用，不重复开一份。只开浏览器看控制台、不想启动 DSH 时，用那个脚本维持隧道即可。