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

快速上手

dsh-emoji

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-emoji

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

— 源: plugins.install

关键要点

• AI 想加入情绪或装饰性表情时，直接从 42 个允许的 Unicode 表情中选择，例如输出 😊；它们对应 40 个稳定语义，插件会在 Host 端将其转换为当前表情包的行内图片，无需额外模型调用。
• 内置和用户上传的表情包共用 40 个稳定语义 key，可随时切换，并支持小、正常、偏大、大四档尺寸。
• 转写只作用于 40 个规范 Unicode 表情、常见别名 😄／🙂 和本插件图片；其他 Unicode 表情、代码、链接、双冒号文本和普通 Markdown 图片保持原样。程序不会根据正文猜测情绪或自动补图。多张插件表情必须由有效正文分隔，相同表情可以在不同位置重复使用。
• 关闭：不使用表情。
• 智能：仅在表情确实有助于表达时自然使用，每回合最多 3 张，默认选项。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

AI 会在什么时候使用表情？会自动补图吗？

AI 会从 42 个受控 Unicode 表情（如 😊、🤔）里手动挑选，不会根据回复正文自动猜测情绪；当 Unicode 表情位于代码、链接或普通 Markdown 图片里时也不会被转写。关闭模式下 AI 完全不使用插件表情。

三档频率之间有什么区别？

关闭 = 不用表情；智能（auto）默认档，每回合最多 3 张，仅在能改善语气时使用；高频（frequent）每回合最多 4 张，要求 AI 在对话回复里安插一个匹配当前情绪的表情并放在对应句子之后。

可以上传自己的表情包吗？有什么限制？

支持上传自定义 ZIP，AI 仍只发送受控 Unicode 表情，Host 自动换成你上传的 PNG。ZIP 上限 20 MiB、解压后 80 MiB、单文件 2 MiB、图片宽高 ≤ 512px；每个语义 key 必须且只能有一个同名 PNG，且 pack.json 必须声明 schemaVersion=1 与 keySet='dsh-emoji-core@1'。

用户包保存在哪里？会被一起清理掉吗？

用户表情包保存在 $DSH_HOME/emoji-packs/（默认 ~/.dsh/emoji-packs/）；设置里点「移除」只是从选择列表隐藏，物理素材会被保留，以保证历史消息里那版的 URL 仍能继续回放，重新传相同 ZIP 可恢复。

切换表情包或调整频率后需要重启吗？

不需要。下一次模型调用就会使用新设置；如果只是修改显示尺寸，浏览器端会立即通过样式热更新体现。

如何彻底卸载插件？

通过 dsh CLI 卸载插件即可。表情素材按 id@version 存放在 $DSH_HOME/emoji-packs/ 下，不会随插件卸载自动删除；如想完全清理需手动删除该目录。

与同类表情插件相比，dsh-emoji 的差异在哪？

内置目录和上传包共用同一组 40 个稳定语义 key，AI 只学习受控 Unicode 表情，Host 在流式响应时按映射替换为图片，不增加额外模型调用；并且内置 webSettings 卡片，可一键上传 ZIP 与切换包。

— 源: plugin_wiki.faq_json

兼容性

• DSH: ^0.1.0-rc.7
• Node: ^22.19.0 || >=24.0.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则