🐤 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"

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

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

装完重启 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     # 卸载（bundles 层自动对账），然后重启 dsh web
# 更新：cd <仓库目录> && git pull && dsh plugin add "$PWD"

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

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