dsh-stickerbook
Manifest validLocal Sticker Pack plugin for DeepSeek Harness: 157 blue fat fish, image selection in input box, [sticker: description] rendering, optional native QQ sending
dsh-stickerbook · 表情册
中文 · English
给 DeepSeek Harness 用的本地表情包插件:157 张中文表情,按情绪/关键词搜索,用户和助手都能发图,可选原生走 QQ。
作者与来源(请分清)
- 插件作者:Asgoresmilelong —— 本仓库的代码(
lib/、client/、tools/)作者。- 表情作者:B站 @赤风RED(space.bilibili.com/356746604)——
packs/blue-whale/images/里的 157 张表情全部来自赤风RED,不是插件作者的原创作品。- 素材许可:CC BY-NC 4.0(署名 + 非商业性使用)。转载/分发必须保留「赤风RED」署名与来源链接;商用需另行获得赤风RED许可。
- 插件代码本身:MIT(见 LICENSE)。
它综合了两个同类插件的取舍:
- 像
dsh-meme一样开箱即用(自带图库、小图、无需构建),并且有测试; - 像
dsh-nekowhale-stickers一样结构清晰(索引/搜索/路由/发送分层,元数据可读可改,许可边界写清楚)。
特性
- 搜索:按情绪 tag(
happy/angry/sad/food…)或关键词(中文子串、多词 AND)找图 - 用户也能发:输入框左侧的「🙂 表情」按钮打开可搜索的图库面板,点一张就发出去
- 发图:消息里只存
[贴纸: 描述]这样的纯文本 token,客户端把它渲染成图片;工具返回候选 + 可直接复制的 token - QQ/IM:宿主有
companionQq服务时,action="send"直接原生发原图 - 加图零配置:把图片丢进
packs/<pack>/images/,文件名先当描述;sticker_learn/sticker_update再补描述 - 零运行时依赖:宿主侧只用 Node 内置模块(
node:fs/node:http),没有数据库、没有原生扩展 - 兼容 DSH 0.2.x:装饰只作用于对话流,不碰 0.2.2 的 Lexical 输入框(v0.1.1 修复卡死)
- 测试:
node --test,覆盖搜索、pack 解析、HTTP 围栏、元数据写入、token 格式、客户端作用域与列表 API
安装
# 从 GitHub 安装(推荐)
dsh plugin --profile desktop add github:Asgoresmilelong/dsh-stickerbook
# 本地开发(link 安装,改代码刷新页面即生效)
dsh plugin --profile desktop add link:F:\DSH-\oss\dsh-stickerbook
官方桌面端请完全退出 DSH 后再执行 CLI;装完重启 DSH。
使用
装好后 agent 会拿到四个工具:
| 工具 | 干什么 |
|---|---|
send_sticker | 找图(tag / query)并返回候选;action=send + path 走 QQ 原生发图 |
sticker_list | 只读浏览,带 pack/file 方便维护 |
sticker_learn | 把一张图收进用户图库(默认 mine) |
sticker_update | 改描述 / 情绪 / 关键词 |
用户发图:点输入框左侧的「🙂 表情」,搜索或直接点一张,插件会把 [贴纸: 描述] 放进输入框并发送。
助手发图(Web):
send_sticker({ query: "摸鱼" })→ 工具返回候选,每张带一行[贴纸: 描述]- 模型把选中那张的 token 原样写进回复
- 客户端把 token 替换成
/dsh-stickers/...的<img>
为什么不用 markdown 图片:宿主的 Markdown 渲染器会把相对地址当作工作区文件(
/api/file), 一条/dsh-stickers/...或 http URL 都会显示「图片无法预览」。token + DOM 装饰是唯一稳定的路。
QQ/IM 会话:
send_sticker({ tag: "happy" })拿候选(含绝对路径)send_sticker({ action: "send", path: "<绝对路径>" })由插件调用companionQq.sendImage
加图(以后自己加)
方式一:直接丢文件(最快)
packs/blue-whale/images/新表情.gif
重启 DSH 或等下一次工具调用重新扫描后就能搜到;描述先用文件名,之后用 sticker_update 改。
方式二:让 agent 收录
sticker_learn({ path: "D:\\pics\\生气猫.gif", caption: "生气猫:再问就咬你", emotion: "angry", tags: "猫 生气 咬人" })
文件会被复制到 ~/.dsh/sticker-packs/mine/images/,原图留在原地。
方式三:手工编辑 stickers.json
{
"version": 1,
"items": [
{
"file": "images/生气猫.gif",
"caption": "生气猫:再问就咬你",
"emotion": "angry",
"tags": ["猫", "生气", "咬人"],
"use": "被问烦了的时候"
}
]
}
stickers.json 是可选文件:没有它也能用,文件名就是描述。
图库格式
packs/
blue-whale/
pack.json # { id, name, description, author, source, license, version }
stickers.json # { version: 1, items: [{ file, caption, emotion, tags, use }] }
images/ # 图片(gif/png/jpg/webp),可以有子目录
用户图库放在 ~/.dsh/sticker-packs/<pack>/,与插件包分开,升级插件不会丢。
配置
在 profile 的 cordis.patch.yml 里给这一行加 config::
- id: stickerbook
name: dsh-stickerbook
config:
route: /dsh-stickers # 图片路由前缀
packs: # 覆盖默认扫描根(相对包目录或绝对路径)
- packs
- D:\my-stickers
allowLan: false # 默认只允许回环地址取图
allowedHosts: [] # 反代域名白名单
maxBytes: 20971520 # 单图上限 20MB
环境变量:DSH_STICKERBOOK_ALLOW_LAN=1 等价于 allowLan: true。
开发
node --test test/*.test.mjs # 38 个测试
node tools/prepare-pack.mjs <源目录> packs/<pack>/images # 压缩 GIF 到 240px/12fps`r`nnode tools/license-check.mjs # 校验每个 pack 的作者/来源/非商用许可
仓库里的 157 张「蓝色大肥鱼」是 460MB 原始 GIF 压缩到 45MB(240px、12fps、128 色)后的版本;压缩脚本在 tools/prepare-pack.mjs。
设计取舍
- 元数据在磁盘上:
packs/**是唯一真相,内存索引是派生的;改一条描述不需要迁移或重建数据库。 - 发图用 token + 客户端装饰:消息里只存
[贴纸: 描述]纯文本,客户端把它换成<img>;宿主的 Markdown 渲染器不认本地/HTTP 图片地址,这是桌面端唯一稳定的路。 - HTTP 围栏:只认
Host头(不是Origin),默认仅回环地址;反代/LAN 必须显式放行。 - 工具少而清晰:发送、浏览、添加、编辑四件事,避免一个巨型设置面板。
许可
- 代码:MIT,见 LICENSE。代码的作者是插件作者 Asgoresmilelong。
- 表情素材:CC BY-NC 4.0(署名 + 非商业性使用),版权归表情作者 赤风RED(B站),与插件作者无关。
- 署名:
表情素材 © 赤风RED(https://space.bilibili.com/356746604),CC BY-NC 4.0 - 允许:非商业性使用、转载、修改,但必须保留署名并注明许可。
- 禁止:商业用途(含付费产品、广告变现、商用客户交付);商用请联系赤风RED获得授权。
- 本仓库代码的 MIT 授权不覆盖
packs/blue-whale/images/下的素材。
- 署名:
致谢
- 表情素材:B站 @赤风RED —— 蓝色大肥鱼系列,CC BY-NC 4.0。
- dsh-meme:
[表情: 描述]交互与输入框选择器的设计参考。 - dsh-nekowhale-stickers:分层、许可拆分与同步完整性的参考。
Comments
Loading…
Similar plugins
by liceses
DSH 插件:蓝色大肥鱼表情包回复 —— 模型按语境在回复里贴一张会动的大肥鱼,支持设置页预览墙与下一轮指定
★ 13
NOASSERTION
JavaScript
Oct 7, 2026
dsh plugin --profile web add dsh-memes-replyby FeWOO
DSH 表情包插件:默认表情 + 社区梗图双包,输入区一键发送,模型也能理解并回发。
★ 1
MIT
JavaScript
Oct 26, 2026
dsh plugin --profile web add dsh-deepseek-memeby yyh-001
DeepSeek Harness 的表情包插件——找得到、发得出、学得会,纯文本斗图、情绪主动发图、像 QQ/微信 一样发图、AI 自动学图、自定义表情包 、多种风格随意切换。
★ 582
↓ 19.5k/wk
MIT
JavaScript
Nov 17, 2026
dsh plugin --profile web add dsh-memeby DViridescent
DeepSeek Harness 蓝色大肥鱼主题插件:海洋配色、鱼群、气泡、吉祥物与品牌替换
★ 14
↓ 896/wk
MIT
JavaScript
Aug 14, 2026
dsh plugin --profile web add dafy-whale-themeby meto-ventus
🐳 蓝色大肥鱼 · DeepSeek 虎鲸 3D 桌宠插件 — 由 DeepSeek 虎鲸 logo 轮廓重建,悬浮于 Web GUI 角落:拖拽旋转、360° 转圈、爱心互动、悬停工具栏、大小/灵敏度/文字设置,配置本地持久化 / A 3D whale desktop pet rebuilt from the DeepSeek whale logo for DeepSeek Harness —
★ 8
MIT
JavaScript
Aug 24, 2026
dsh plugin --profile web add dsh-ventus-whaleby HDHKVT
把 DeepSeek Harness(DSH)接到 QQ 的插件:通过官方 QQbot 将私聊消息传进指定的 DSH 会话,答完自动发回;图片、文件、动图、表情包、视频、B 站链接都能处理。
★ 0
MIT
JavaScript
Oct 24, 2026
dsh plugin --profile web add dsh-qq-relay