117BS/dsh-perlica-ding

dsh-perlica-ding · 佩丽卡终端 (Perlica Terminal)

「我们不是理想的陈述者，而是理想的践行者。」
—— 佩丽卡，终末地工业监督

Awesome DSH Plugin

佩丽卡 - 终末地工业监督

🔔 佩丽卡主题 DeepSeek Harness 分级任务提示音插件。

由终末地工业监督佩丽卡为您播报任务状态：计划出方案、任务执行完成、需要您回应、执行出错时，以终端播报的口吻播放不同提示音；普通问答保持安静。声音文件可自定义（含佩丽卡风格 TTS 语音文案），窗口在后台也能听到。

📖 关于佩丽卡

佩丽卡（Perlica），《明日方舟：终末地》登场角色，终末地工业的监督和官方发言人，杰出的协议技术专家。负责管理和推进协议源石技术的开发与应用，承担帝江号的管理工作，同时也是一名危机处理小组成员。

她果断而冷静地应对各种危机，来回奔波于文明环带各处。本插件的提示音风格即取材于她——简洁、干练、带技术官僚感的终端播报，称呼您为「管理员」。

✨ 功能

| 场景 | 触发条件 | 音效文件 |
|---|---|---|
| 🗂️ 计划出方案 | 回合结束时仍处于计划模式 | plan.wav |
| ✅ 任务完成 | 回合结束且本回合调用过执行类工具（改文件/跑命令/子代理/工作流等） | done.wav |
| 💬 普通问答 | 纯对话，或只用了查询类工具（读文件/搜索网页等） | 静音 |
| 🙋 需要你回应 | agent 提问 / 审批请求 | ask.wav |
| ⚠️ 出错 | 回合报错 | fail.wav |

其他特性：

- 只响主对话：子代理/后台任务完成时不单独响，随主回合统一收尾
- 防抖：每档独立 2.5 秒间隔，不会连响
- 可自定义音效：把 wav 文件放到指定目录即可，无需改代码
- 跨平台：Windows (SoundPlayer) / macOS (afplay) / Linux (paplay/aplay)
- 可配置：总开关、防抖间隔、音效目录

📦 安装

方法一：从 GitHub 安装（推荐，无需 npm 账号）

dsh plugin --profile web add https://github.com/117BS/dsh-perlica-ding

安装后重启 dsh web profile 生效：

dsh web restart

方法二：从 npm 安装（npm 发布后可用）

dsh plugin --profile web add dsh-perlica-ding

方法三：本地开发安装

dsh plugin --profile web add D:\deepseek\dsh-perlica-ding

🎵 音效文件

开箱即用：佩丽卡语音已打包进插件（sounds/ 目录随包分发），安装后无需任何配置，四个场景各有专属声音：

plan.wav   — 计划出方案（"作战计划已确认完毕"）
done.wav   — 任务完成（"任务执行完毕，所有指标正常"）
ask.wav    — 需要你回应（"终端上报：存在待决事项，需要操作员裁决"）
fail.wav   — 出错（"警告：执行异常，任务中断"）（可选）

想换自己的声音：用 AI 语音合成生成 wav，放到你的工作区根目录（或配置的 soundDir），同名文件会覆盖内置声音，立即生效无需重启。查找顺序：配置目录 → 工作区 → 包内自带 → 系统回退。

要求：必须是真正的 WAV 格式（PCM）。TTS 工具如果导出 MP3，需要转码（可用 ffmpeg：ffmpeg -i input.mp3 -acodec pcm_s16le plan.wav）。

⚙️ 配置

🔊 音量调节（设置页一键试听）

打开设置就能调：进 DSH 设置 → 佩丽卡提示音，你会看到一个面板：

提示音音量
[==========|=========]  50%
[原声 100%] [适中 60%] [轻声 30%] [静音 0%]

试听音效
[计划出方案] [任务完成] [需要你回应] [出错]

- 拖滑块或点预设档位调节音量（0 = 完全静音，100 = 原声），自动保存、立即生效
- 点试听按钮立刻播放对应音效，用耳朵确认这个音量合不合适，不用靠猜
- 试听走的是和真实通知完全相同的播放链路，听到的就是实际效果

推荐档位

| volume | 效果 | 适用场景 |
|---|---|---|
| 100 | 原始音量 | 环境嘈杂 |
| 60 | 略微降低 | 戴耳机、安静房间 |
| 30 | 轻声提示 | 深夜、图书馆 |
| 0 | 完全静音 | 临时关闭提示音 |

💡 实现原理：插件直接对 WAV 的 PCM 采样做振幅缩放（零依赖、跨平台），不会改动你的系统音量。缩放结果缓存在系统临时目录，同一音量只计算一次。

⚠️ 注意：如果用的是非 PCM 格式的音频（罕见），插件会自动回退到原始音量播放。

⚙️ 高级配置

音量也可以写进配置文件（作为初始值；设置页里调过的值优先）。在 profile 的 cordis.yml 或用户 patch 层中配置：

plugins:
dsh-perlica-ding:
enabled: true        # 总开关
volume: 100          # 初始音量 0-100（设置页可覆盖）
debounceMs: 2500     # 同档音效最小间隔（毫秒）
soundDir: ""         # 自定义音效目录，留空则用当前工作区
execTools: []        # 哪些工具算"执行任务"；空数组 = 所有工具都算（旧行为）

🧪 验证

安装后随便让 agent 执行一个任务（比如让它调用一次工具），任务完成时应该听到提示音。或者先手动测试声音链路：

$p = New-Object Media.SoundPlayer 'D:\deepseek\done.wav'; $p.PlaySync()

📄 许可证

MIT