本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-stickers

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add --allow-build=@dsh-external/dsh-stickers github:william-jin-cmu/dsh-stickers

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 用户在 WebUI 点击 🐋 选择器，或输入 /sticker <id> [black]。
• 24 张表情全部提供蓝鲸娘 / 黑鲸娘两套角色：选择器顶部可切换角色（默认蓝鲸娘），切换后发送同一张表情的黑鲸版本。
• Agent 在普通对话中按语境调用 send_sticker({ id, variant? })，不是等用户明确索要表情。
• 14 张 public 表情对双方开放，其中 4 张是工作流反应：tests-passed、root-cause、running-tests、fixed-review。
• 10 张彩蛋只出现在 Agent tool schema 中；用户命令和选择器都无法访问，例如 restart-myself、hot-update、subagents-down。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后 WebUI 里看不到表情按钮怎么办？

表情按钮（🐋）是 DSH 客户端 slot 注入的，需要确认宿主 DSH 版本包含 client-ui-conversation / client-ui-tool 的官方扩展面，并把 dsh.web 进程重启一次；如果只在 TUI 里使用，请参考"已知问题"中关于 TUI 不支持的说明。

怎么让用户也能发送黑鲸娘版本？

WebUI 选择器顶部有"蓝鲸娘 / 黑鲸娘"切换按钮，切换后再点任意表情就会自动拼成 /sticker <id> black 命令；命令行里直接 /sticker <id> black 也可以。Agent 端通过 send_sticker 工具传 variant: 'black' 实现同样效果。

表情消息会进入会话历史吗？

会。无论是用户用选择器 / /sticker 命令发送，还是 Agent 用 send_sticker 工具发送，最终都进入持久会话历史，刷新页面、滚动或重开会话都能看到带"🐋 文案 + 图片"的卡片。

图片 URL 走哪个路由？会被缓存多久？

图片由插件自己的 /api/dsh-stickers/<file>.png 或 /api/dsh-stickers/black/<file>.png 路由提供，资源来自 assets/stickers/ 目录，HTTP 头 cache-control: public, max-age=86400；URL 自带 ?v=2 版本号用于应对大版本升级时的浏览器缓存。

10 张彩蛋表情用户能强制触发吗？

不能。彩蛋仅出现在 Agent 的 send_sticker 工具 schema 中，WebUI 选择器和用户 /sticker 命令都会拒绝并返回"表情不存在或不可由用户发送"；这是 catalog 中 visibility = 'agent' 的硬约束，不是配置项可关。

需要额外配置文件或环境变量吗？

不需要。插件不读取任何 process.env / options / config，全靠内置 catalog（src/shared/catalog.ts）驱动；新增表情只需改 catalog 文件即可同步 WebUI、用户命令、Agent tool 三处。

怎么彻底卸载？会留残留吗？

走 dsh plugin --profile web remove github:william-jin-cmu/dsh-stickers 即可；因为表情数据是会话历史的一部分，聊天记录里的表情卡片不会被自动删除，宿主路由和 slot 注入会在插件卸载后随 dsh.web 重启一起移除。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明
• Node: ^22.19.0 || >=24.0.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则