首次使用

微信

启用微信插件后，Host 会托管一个桥接子进程。首次运行时，二维码会直接输出到 DSH Web 所在终端；扫码后从微信发送一条消息，插件会创建或复用标题为“微信”的 DSH 会话，并把 agent 的最终回复发回微信。侧栏快捷入口会在该会话存在后出现。

在“自定义插件 → 微信”中可以设置：

是否启用桥接。
本地主动发送端口，默认为 8790。
固定的微信 owner ID；留空时由第一个成功收到的微信用户自动绑定。
固定的 DSH 会话 ID；留空时自动创建或复用“微信”会话。
是否自动调用识图插件分析微信入站图片。

配置保存后，桥接监督器会重新加载子进程。子进程异常退出时会自动重试；如果端口已被占用，监督器会等待端口释放，避免启动重复实例。

桥接器还提供只监听 127.0.0.1 的主动发送接口。请求必须携带本地 Bearer token：

curl -s -X POST http://127.0.0.1:8790/send \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $(cat "$HOME/.dsh-wechat/bridge-token")" \
  -d '{"text":"通知内容"}'

发送文件时，在 JSON 中增加 "file":"绝对路径"。插件只接受现有的绝对路径普通文件，拒绝相对路径、目录和符号链接。

查看微信插件详细说明

壁纸

在“自定义插件 → 壁纸”中可以：

选择 midnight、aurora、forest、sunset 四个内置预设。
从文件选择器上传 PNG、JPEG、WebP 或 GIF。
填写本地图片绝对路径。
设置 0 到 1 的透明度，或直接停用壁纸。

上传内容会先检查媒体类型与文件签名，再以私有权限复制到插件数据目录。Host 在每次返回 DSH Web 首页时通过 webServer.tapIndex 注入一段受管 CSS，不修改客户端 bundle；保存后刷新页面即可看到变化。

midnight

aurora

forest

sunset

查看壁纸插件详细说明

识图

在“自定义插件 → 识图”中填写 API Key，或在启动 DSH Web 前提供同名环境变量：

export SILICONFLOW_API_KEY="your-api-key"
npm exec --yes --package=@deepseek-ai/dsh@0.1.0-rc.6 -- dsh web

设置页还可以调整 Credential 名称、模型、每次图片数、单图大小、最大输出 Token、 Temperature 和失败重试次数。默认模型为 deepseek-ai/DeepSeek-OCR，默认每次最多 3 张图片，单图上限 5 MiB。

使用时，在对话框中粘贴或拖入图片，输入问题，然后点击“识图发送”。客户端会把草稿图片交给 Host 的 /plugins/dsh-vision/analyze 路由；Host 返回视觉结果后，客户端移除原始图片草稿，将“问题 + 视觉分析结果”作为纯文本提交给 DSH。

这样可以适配当前 stable Host 对文本模型 image block 的准入限制，也不会修改 DSH runtime 或绕过模型能力检查。支持 PNG、JPEG、WebP 和 GIF。

查看识图插件详细说明

配置与数据

项目	默认位置或来源	说明
安装 tarball	`~/.dsh/plugin-packages/`	可由 `DSH_HOME` 或 `DSH_PLUGIN_ARCHIVE_DIR` 覆盖
微信运行数据	`~/.dsh-wechat/`	登录凭据、owner、会话、同步游标、Bearer token、媒体和转发水位
壁纸上传文件	`~/.dsh-plugins/wallpaper/uploads/`	设置页上传的当前图片；目录和文件使用私有权限
壁纸 CLI 兼容状态	`~/.dsh-plugins/wallpaper/config.json`	Host 在没有显式 `source` 配置时兼容读取
插件配置	DSH settings 服务	使用 `dsh-plugins-wechat`、`dsh-plugins-wallpaper`、`dsh-plugins-vision` 命名空间
识图密钥	DSH credential 或环境变量	默认 Credential 名称为 `SILICONFLOW_API_KEY`，保存后不回显

设置页的写接口要求同源请求和正确的 JSON/媒体类型。微信配置变化会重启其受管子进程；识图配置即时用于后续请求；壁纸配置在刷新页面时生效。

@dsh-plugins/4u

安装

说明文档

首次使用

微信

壁纸

识图

配置与数据