dsh-wechat-emoji
让 DSH 的 agent 看懂聊天里的表情包 / 梗图 / 聊天截图，并判断对方情绪。
- 注册一个模型侧工具
wechat_emoji_analyze，底层调用智谱 GLM-4V-Flash（免费视觉大模型）；
- 自带设置页面板：装完在 DeepSeek 设置页里就能填 API Key，不用碰文件。
能力
| 输入 | 说明 |
|---|
image | 本地图片路径（支持无扩展名的微信缓存文件）或 http(s) URL；jpg/jpeg/png/apng/webp(含动图)/gif(取首帧)/bmp/tiff/ico/avif/heic |
hint | 可选。这条消息的文字/上下文（如「今天又加班」），显著提高情绪判断准确率 |
cdnUrl | 可选。本机缓存缺失时，白名单原消息提供的微信 CDN 下载地址（仅接受腾讯微信域名的 http(s) 地址） |
cdnMd5 | 可选。原消息的 md5 摘要（32 位十六进制）；提供 cdnUrl 时必填，下载后逐字节核验，不匹配即拒绝 |
输出（结构化 JSON）：
| 字段 | 说明 |
|---|
sentiment | 情绪类别：开心/生气/难过/无语/害羞/嘲讽/震惊/亲昵/期待/委屈/敷衍/中性 |
intensity | 情绪强度 0–100 |
meaning | 这张表情包在当前语境下想表达什么 |
replyHint | 建议怎么回应（语气 + 一句话示例） |
description | 画面内容（含图上的文字） |
微信自绘表情 .wxgf（wxgf 魔数 + HEVC 动图）会自动用 ffmpeg 解码为首/中/末三帧拼接图再分析，无需另存为。
快速开始
0) 准备
- 一个 DSH profile
- 智谱 API Key：open.bigmodel.cn 注册后在「API 密钥」创建（GLM-4V-Flash 免费，新用户送额度）
1) 安装
方式 A：npm 安装（推荐，已发布到 npm）
dsh-wechat-emoji
方式 B：仅源码安装（GitHub）
dsh plugin --profile web add github:mikunkol-hub/dsh-wechat-emoji
方式 C：手动 link（开发/离线场景）
# 把插件目录链接进 profile 的 node_modules（junction）
New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\web\node_modules\dsh-wechat-emoji" `
-Target "<插件源码目录>"
然后在 profile 的 package.json 里加两处（pnpm install 一遍以登记依赖）：
{
"dependencies": {
"dsh-wechat-emoji": "link:<插件源码目录>"
},
"dsh": { "profile": { "bundles": [ "dsh-wechat-emoji" ] } }
}
⚠️ 必须声明 peerDependencies：插件里 import { defineTool } from '@deepseek-ai/dsh-tools' 时，
package.json 必须写 "peerDependencies": { "@deepseek-ai/dsh-tools": "*" }。
DSH 加载 link 安装的插件时，只有 manifest 的 dependencies / peerDependencies 里列出的宿主包才会被解析；
不声明的话 import 失败但不报错——插件静默停在 fiberPhase: null，工具永远不会出现。
（本插件已正确声明，这一条是给开发者参照的。）
2) 配置 API Key
方式 A：设置页面板（推荐，最省事）
- DeepSeek 设置页 → 插件（Plugins）→ 点进 dsh-wechat-emoji；
- 详情页里有一个「智谱 API Key」设置区：粘贴 Key → 保存；
- 保存即热重载生效，不用重启、不用改文件。已设置的 Key 只显示末 4 位。
方式 B：环境变量
设 ZHIPU_API_KEY 后重启 DSH（面板里留空时自动读这个）。
方式 C：配置文件（手动）
在 cordis.patch.yml 的 apiKey 填你的 Key，保存即触发 profile 热重载。
3) 验证
- 面板保存后可以直接在会话里让 agent 分析一张表情包；
- 或看工具列表里是否出现
wechat_emoji_analyze。
配置
| 字段 | 默认 | 面板可改 | 说明 |
|---|
apiKey | "" | ✅（掩码输入） | 智谱 API Key；留空则读环境变量 ZHIPU_API_KEY |
model | glm-4v-flash | ✅ | 视觉模型名 |
baseUrl | 智谱 v4 chat/completions | ✅ | 兼容 OpenAI 格式的地址 |
timeoutMs | 120000 | ✅ | 单次请求超时 |
ffmpegPath | 自动找 | ✅ | 转码用；不填依次找 FFMPEG 环境变量、~/.dsh/bili-whale/bin/ffmpeg.exe、PATH |
allowWechatCdnDownload | true | ✅ | 允许本机缓存缺失时从微信 CDN 补图（域名白名单 + md5 核验，见下） |
wechatCdnHosts | 微信域默认列表 | ✅ | CDN 域名后缀白名单；默认覆盖 weixin.qq.com / qpic.cn / gtimg.cn / qq.com 等腾讯域 |
wechatCdnLegacyHosts | {"mmsns.qpic.cn":"shmmsns.qpic.cn"} | ✅ | 旧版腾讯域名 → 兼容域名映射；下载旧地址时先映射，并强制 HTTPS、核验 md5 |
ffmpeg 只在「动图取首帧 / bmp·tiff·ico·avif·heic 等格式转码」时需要；只有 jpg/png 图片的场景没有它也能用。
配置防篡改
插件内置关键配置的安全基线，防止配置被意外/恶意修改导致功能失效或 Key 泄露：
- API Key 只认设置面板与环境变量：即使有人在
cordis.patch.yml 里填了 apiKey，插件也会忽略该值（防止 Key 被写进配置文件/仓库）；
- 启动自检：插件每次启动校验
cordis.patch.yml 的关键项（apiKey 必须为空、model/timeoutMs/ffmpegPath 基线），发现被改会自动备份并恢复基线；
- 运行时兜底：
model/baseUrl/timeoutMs/CDN 白名单等都有代码内置默认值，配置缺失或被改坏不影响功能；
- 注意：DSH 对 bundle patch 有寻址校验，patch 文件被改后插件会暂时无法加载（unaddressable），恢复文件后需重启 DSH 或重装 bundle。
隐私与安全
- 图片会以 base64 直接发给智谱接口（
open.bigmodel.cn），本插件不落盘、不缓存图片内容；
- 微信 CDN 补图（
cdnUrl/cdnMd5）有硬安全边界：只接受域名后缀命中白名单的腾讯微信地址（默认 weixin.qq.com/qpic.cn/gtimg.cn/qq.com 等，可配），且必须提供原消息 md5 摘要、下载后逐字节核验，不匹配立即丢弃；重定向后仍会复查域名；下载的临时文件用完即删；
- 旧版地址兼容：历史消息里的旧腾讯域名（如
mmsns.qpic.cn）会先映射到兼容域名（如 shmmsns.qpic.cn），http 一律强制升级为 HTTPS，映射后照常过白名单与 md5 核验；映射表可在配置里扩展；
- 不在本地保存任何聊天数据；面板保存的 Key 只存在于 DSH 的配置里；
- 建议只在可信会话里给 agent 开放这个工具（模型侧工具可按 preset 隔离）。
已知限制
- 单图 ≤5MB（超出报错，不自动压缩）
- 一次一张图；多图/长截图建议先裁切
- 情绪判断依赖模型理解，仅作聊天辅助，不做心理诊断
- 不支持视频、语音
许可证
MIT（见 LICENSE）。
