🐤 dsh-ikun-pet · ikun 桌宠

DeepSeek Harness（DSH）插件 —— 只在 DSH 每次回答问题的 Deep diving 期间， 用坤宠动图填满「Deep diving...」状态行下方的整行区块： 进度条 0% → 100%，每 20% 切换一档动图动作与文案，完成时跳跃庆祝「完成啦！你干嘛~哎哟」🏀

✨ 特性

• 只占深潜区块：注册在 conversation.input.dock —— 正是 DSH「Deep diving...」状态行正下方、 对话区与输入框之间的整行区块；仅在会话 running（深潜回答）时出现，其余时间完全隐形
• 动图沿进度条行走：坤宠从 3% 走到 97%，压着进度条逐帧播放（8 列 × 9 行精灵图契约）
• 每 20% 一档：0/20/40/60/80/100 六档分别切换动图动作与文案（见 docs/PROGRESS-STAGES.md）
• 通用自适应进度：分层估算模型——真实锚点（开始 0% / 完成 100%）＋ goal 回合真实进度＋本会话历史回合时长自校准＋工具/流式/等待审批动态调速＋收缩保留量； 短任务快跑、长任务慢跑，等待你审批时诚实减速，永不假 100%（详见 docs/PROGRESS-STAGES.md）
• 完成全机可闻：100% 完成时由宿主进程用系统命令播放「你干嘛~哎哟」（assets/voice.mp3）， 任何窗口、任何会话完成都听得到，与浏览器静音无关（已在 macOS 实测）
• 永久插件形态：写入 DSH 组成（cordis.patch.yml），随 DSH 启动自动加载，一次安装全局生效； 同时保留动态插件源码（src/）作为会话级安装的替代方式

🚀 安装

方式 A：克隆安装（适合想魔改的人）

git clone https://github.com/eric-song-dev/dsh-ikun-pet && cd dsh-ikun-pet
dsh plugin add "$PWD" --profile web

方式 B：远程一条命令（适合纯使用者）

dsh plugin add github:eric-song-dev/dsh-ikun-pet --profile web
# 或：dsh plugin add https://github.com/eric-song-dev/dsh-ikun-pet.git --profile web

方式 C：npm 一条命令（预构建安装，免 allowBuilds 构建授权）

dsh plugin add dsh-ikun-pet --profile web

💡 如果你的 profile 名不是 web，把上面命令里的 --profile web 换成你的 profile 名。

装完重启 dsh web，浏览器刷新即可。验证：

curl -sI http://127.0.0.1:3080/ikun-pet/spritesheet.webp   # 素材路由（应为 image/webp）
curl -s  http://127.0.0.1:3080/plugins/dsh-ikun-pet/client.js   # client bundle（应返回 JS）

🎬 档位 → 动作 → 文案

进度	动图动作	文案
0% – 20%	waiting（期待）	深潜启动！准备出发…
20% – 40%	runRight（向右跑）	正在收集线索…
40% – 60%	working（专注干活）	埋头苦干中…
60% – 80%	review（思考审阅）	认真思考中…
80% – 100%	wave（挥手）	快好啦！马上见结果~
100%（完成）	jump（跳跃庆祝）	完成啦！你干嘛~哎哟 🔉（宿主进程播放提示音）

⚙️ 配置（可选）

全部配置在包内 cordis.patch.yml 插件行的 config 里：spritePath / voicePath / playVoiceAtDone / playCommand（素材默认取包内 assets/）。

• 停用插件：把 # disabled: true 行首的 # 去掉，重启 dsh web（再加回 # 即重新启用）
• 关闭音效：config.playVoiceAtDone: false（不影响动图进度条）
• Windows/Linux 提示音：把 playCommand 换成 PowerShell / ffplay 方案（注释里有示例；macOS 默认 afplay 已实测）

🗑 卸载 / 🔄 更新

dsh plugin remove dsh-ikun-pet --profile web     # 卸载（bundles 层自动对账），然后重启 dsh web
# 更新：cd <仓库目录> && git pull && dsh plugin add "$PWD" --profile web

🧪 临时安装（动态插件，会话级）

node scripts/build-package.mjs     # 生成 ikun.package.json 一键安装载荷

把载荷交给 Agent 用 cordis_define + cordis_run 安装，仅当前会话生效。 ⚠️ 与永久插件不要同时启用（同一条素材路由会冲突）。

🖥 平台支持

部分	macOS	Windows / Linux
界面动图 + 进度条（纯 Web）	✅ 已实测	⚠️ 理论可用，未测试
完成提示音（系统命令播放）	✅ 已实测（afplay）	⚠️ 命令已预留，未测试

🛟 故障排查

现象	排查
重启后插件行激活失败	profile 目录下 node -e "require('dsh-ikun-pet')" 应成功，失败则重装
区块不显示但路由正常	浏览器强刷（Cmd+Shift+R）；确认没有同时启用动态插件
提示音不响	检查 config.playVoiceAtDone；macOS 用 afplay，其它系统换 playCommand
想让插件不加载	插件行加 disabled: true 后重启

📄 License

MIT