plolpl789/dsh-maid-emoji

dsh-maid-emoji · 智能体表情包系统

让任意 dsh 智能体在回复中发送表情图片的插件。安装即内置默认表情包
（女仆表情包，47 张），零配置即可用；也可以随时添加任意自定义表情包文件夹。
智能体在回复中用 ::文件名:: 标记引用表情，让对话更生动可爱。

效果预览

功能

- 内置默认表情包：随插件分发（assets/emoji，47 张），安装后无需任何配置即可使用；
可在设置中关闭，或让自定义文件夹的同名表情覆盖内置版本。
- 自定义表情包文件夹：添加 / 移除任意数量的文件夹（PNG / JPG / WebP / GIF）；
支持点击「浏览…」打开系统文件夹选择器，也可以手动输入路径。
- 表情自动发送：插件把表情清单注入系统提示词；智能体在回复正文中以
::文件名:: 标记（如 ::开心::）引用表情，Host 端经 llm/stream
瀑布把标记转写为表情图片，模型无需记忆完整 URL，输出更稳定；
也兼容直接写 表情名 图片。
- 显示尺寸控制：设置表情显示宽度（px，32–512），高度按比例缩放，对话中即时生效。
- 配置界面：插件配置页的「表情包设置」折叠卡片，含启用开关、内置包开关、
清单注入开关、每轮表情数量上限、显示宽度、表情预览网格、保存 / 放弃 / 重新扫描。
- HTTP 表情服务：/emoji/ 前缀路由，按文件名从内置或自定义文件夹流式返回图片字节。
- 动态生效：修改配置自动重新扫描；修改系统提示词随下轮组装生效（新会话效果最佳）。

安装

以下任选一种方式把插件装进 web profile（~/.dsh/profiles/web），
然后重启 dsh web、刷新浏览器即可。插件依赖 @deepseek-ai/schemastery，
会在安装时自动从 npm registry 拉取，无需额外手工处理（开发用的 link: 方式除外，见下）。

方式一：本地安装包（推荐分发）

在插件目录内生成安装包
cd dsh-maid-emoji
npm pack          # 生成 dsh-maid-emoji-0.1.0.tgz

安装方在 profile 目录内执行
cd ~/.dsh/profiles/web
pnpm add ./dsh-maid-emoji-0.1.0.tgz

方式二：Git 仓库

把本仓库推到 GitHub 后，安装方执行：

cd ~/.dsh/profiles/web
pnpm add "github:/dsh-maid-emoji"

方式三：npm 发布

把 package.json 中的 "private": true 移除后 npm publish，安装方执行 pnpm add dsh-maid-emoji。

方式四：本地目录直连（开发用）

{
"dependencies": {
"dsh-maid-emoji": "link:G:/深鲸湾/biaoqingbao/dsh-maid-emoji"
}
}

注意：link: 是直接链接源目录。Node 解析符号链接后会从源目录向上查找依赖，
因此源目录需要能解析到 @deepseek-ai/schemastery——若插件报
Cannot find package '@deepseek-ai/schemastery'，在插件目录内执行
pnpm add @deepseek-ai/schemastery@^3.18.1 补齐即可。
tarball / git / npm 方式没有此问题（依赖由包管理器装进虚拟 store）。

无论哪种方式，都需在 profile 中登记

确认 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 含 "dsh-maid-emoji"（tarball / git / npm 方式由 pnpm 自动写入 dependencies，bundles 需手工补一行）：

{
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"…其余插件…",
"dsh-maid-emoji"
]
}
}
}

然后：

cd ~/.dsh/profiles/web
pnpm install

最后 重启 dsh web 并刷新浏览器页面。

使用

0. 开箱即用：安装重启后，内置的女仆表情包（47 张）已自动可用，直接对话即可。
1. 打开 设置 → 插件 → 插件配置 → 表情包设置（折叠卡片，点三角展开）。
2. 添加自定义表情包文件夹：点「浏览…」在系统弹窗中选中文件夹，或手动输入路径后点「添加」。
3. 点击「保存」——卡片会显示表情数量（内置 + 自定义）与预览缩略图。
4. 回到对话：智能体在合适的时候就会用 ::文件名:: 标记发出表情啦～

提示：表情文件名即表情语义（如「开心.png」「委屈.png」），
智能体会按语境选用最贴切的一张。文件夹里直接放图片即可，无需额外配置。

工作原理

| 部分 | 说明 |
|---|---|
| Host 半侧 lib/index.js | 注册 maid-emoji settings 命名空间；扫描文件夹建立清单；注册 /emoji/ HTTP 路由；贡献 emoji:usage 系统提示词段（order 200，动态求值）；注册 /dsh-maid-emoji loopback RPC；监听 llm/stream 瀑布把 ::文件名:: 标记转写为表情图片（代码块保护、每轮上限、未命中保留）。 |
| 浏览器半侧 lib/client.js | 手工维护的 __ModuleLoader__.load bundle，向 settings.plugin.item slot 注册「表情包设置」折叠卡片；经 loopback RPC 读写配置；注入 CSS 控制对话中表情显示宽度（无需 api-proxy 白名单）。 |
| 系统提示词段 | 说明 ::文件名:: 标记语法、示例与规则，并列出当前可用表情（文件名即含义，去扩展名）。配置不变时文本稳定，利于 KV 前缀缓存。 |
| HTTP 表情服务 | http://:/emoji/，文件名经 URL 解码后精确匹配清单，返回对应 MIME 的图片字节。 |

常见问题

- 卡片没出现：确认插件已加入 dsh.profile.bundles 并重启 dsh；确认浏览器刷新。
- 表情图片不显示：检查 /emoji/ 在浏览器中能否直接打开；文件名含特殊字符时以卡片预览中的 URL 为准。
- 修改系统提示词未生效：提示词随每轮组装动态求值，无需重启；若想立即验证，新建一个会话。
- 文件夹改了但表情没更新：在卡片点「重新扫描」，或重新保存一次配置。

许可

MIT