dsh-perlica-ding · 佩丽卡终端 (Perlica Terminal)
「我们不是理想的陈述者，而是理想的践行者。」
—— 佩丽卡，终末地工业监督
English | 简体中文
🔔 佩丽卡主题 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）。
⚙️ 配置
在 profile 的 cordis.yml 或用户 patch 层中配置：
plugins:
dsh-perlica-ding:
enabled: true # 总开关
debounceMs: 2500 # 同档音效最小间隔（毫秒）
soundDir: "" # 自定义音效目录，留空则用当前工作区
execTools: [] # 哪些工具算"执行任务"；空数组 = 所有工具都算（旧行为）🧪 验证
安装后随便让 agent 执行一个任务（比如让它调用一次工具），任务完成时应该听到提示音。或者先手动测试声音链路：
$p = New-Object Media.SoundPlayer 'D:\deepseek\done.wav'; $p.PlaySync()📄 License
MIT
