peon-ping Multi-IDE 配置报告¶
生成时间：2026-03-09
仓库：/home/chesszyh/Downloads/peon-ping
任务目标¶
根据仓库 README.md 的 Multi-IDE Support 章节，为以下工具配置 peon-ping 支持：
- Amp
- Gemini CLI
- GitHub Copilot
- OpenAI Codex
- OpenCode
- Kiro
- Google Antigravity
- OpenClaw
后续用户调整了范围：
- 跳过 antigravity
- 跳过 amp
- 最终保留并完成：gemini-cli、github copilot、codex、opencode、kiro、openclaw
总结¶
本次已完成本机侧配置的项目： - Gemini CLI - GitHub Copilot（本地仓库 hooks 文件已创建，且已本地提交） - OpenAI Codex - OpenCode（确认已安装，无需重复安装） - Kiro - OpenClaw
本次明确未配置： - Amp（按用户最后要求跳过） - Google Antigravity（按用户要求跳过）
详细操作记录¶
1. Gemini CLI¶
对文件进行了增量合并，而不是覆盖原配置：
- ~/.gemini/settings.json
新增的 hooks：
- SessionStart -> bash ~/.claude/hooks/peon-ping/adapters/gemini.sh SessionStart
- AfterAgent -> bash ~/.claude/hooks/peon-ping/adapters/gemini.sh AfterAgent
- AfterTool -> bash ~/.claude/hooks/peon-ping/adapters/gemini.sh AfterTool
- Notification -> bash ~/.claude/hooks/peon-ping/adapters/gemini.sh Notification
结果：Gemini CLI 已具备 peon-ping 事件映射能力。
2. GitHub Copilot¶
在仓库内创建了 hooks 配置文件：
- /home/chesszyh/Downloads/peon-ping/.github/hooks/hooks.json
写入的事件：
- sessionStart
- userPromptSubmitted
- postToolUse
- errorOccurred
全部指向：
- bash ~/.claude/hooks/peon-ping/adapters/copilot.sh ...
另外发现你的全局 peon-ping 安装目录原先缺少 copilot.sh，因此补充了：
- ~/.claude/hooks/peon-ping/adapters/copilot.sh
随后完成了本地 git 提交：
- 提交号：1104e65
- 提交信息：Add GitHub Copilot peon-ping hooks
当前状态说明：
- 本地仓库已提交完成
- 远端 origin/main 尚未确认推送成功
- 之前执行 git push origin main 时，该过程被用户中断，因此无法确认远端默认分支是否已经收到该提交
这意味着：
- Copilot 的仓库 hooks 在本地仓库是完整的
- 但是否已经对 GitHub 默认分支生效，当前不能确认，仍需一次成功的 git push
3. OpenAI Codex¶
检测到原始 ~/.codex/config.toml 已存在 notify，并且指向已有的 confirmo 钩子：
- /home/chesszyh/.confirmo/hooks/confirmo-codex-hook.js
为了避免覆盖已有通知链，本次采用“串联包装”方案：
新增脚本：
- ~/.codex/notify-peon-confirmo.sh
该脚本会： 1. 缓存 Codex 传入的 stdin 事件数据 2. 先调用 Confirmo 的 Codex hook 3. 再调用 peon-ping 的 Codex adapter
然后更新：
- ~/.codex/config.toml
使其 notify 指向：
- bash /home/chesszyh/.codex/notify-peon-confirmo.sh
结果： - Confirmo 继续工作 - peon-ping 也能收到 Codex 通知 - 不会互相覆盖
4. OpenCode¶
检查结果显示 OpenCode 的 peon-ping 插件已存在，无需重复安装。
已确认文件存在：
- ~/.config/opencode/plugins/peon-ping.ts
- ~/.config/opencode/peon-ping/config.json
结果：OpenCode 已处于可用状态。
5. Kiro¶
创建了：
- ~/.kiro/agents/peon-ping.json
内容包含以下 hooks：
- agentSpawn
- userPromptSubmit
- stop
全部指向：
- bash ~/.claude/hooks/peon-ping/adapters/kiro.sh
结果：Kiro 已配置完成。
6. OpenClaw¶
使用仓库自带安装器执行了 OpenClaw 模式安装。
生成/安装内容：
- ~/.openclaw/hooks/peon-ping/ 运行目录
- ~/.openclaw/skills/peon-ping/SKILL.md
- ~/.openclaw/hooks/peon-ping/config.json
- ~/.openclaw/hooks/peon-ping/adapters/openclaw.sh
安装器还下载了默认 pack。下载过程中有少量资源失败：
- sc_kerrigan 部分音频未完整下载
- sc_battlecruiser manifest/音频异常
- glados 个别音频下载失败
但主安装流程完成，OpenClaw skill 已可用。
结果： - OpenClaw 已配置完成 - 个别默认语音包不完整，但不影响主流程
7. Amp¶
最初曾尝试按 README 启动 watcher，并验证了：
- 系统存在 inotifywait
- adapters/amp.sh 可以启动并打印监听信息
但随后用户明确要求： - “amp 也不用配置了”
因此最终结论： - 不再为 Amp 保留配置动作 - 不再将其计入最终完成项
8. Google Antigravity¶
用户明确要求不配置。
最终结论： - 未做配置变更
变更文件清单¶
已修改/新增的用户配置文件¶
~/.gemini/settings.json~/.kiro/agents/peon-ping.json~/.codex/config.toml~/.codex/notify-peon-confirmo.sh~/.openclaw/hooks/peon-ping/config.json~/.openclaw/skills/peon-ping/SKILL.md~/.claude/hooks/peon-ping/adapters/copilot.sh（补齐缺失适配器）
已修改/新增的仓库文件¶
/home/chesszyh/Downloads/peon-ping/.github/hooks/hooks.json
Git 状态说明¶
在仓库 /home/chesszyh/Downloads/peon-ping 中，本次已完成本地提交：
- 1104e65 Add GitHub Copilot peon-ping hooks
但是否已经推送到 GitHub 远端默认分支：
- 当前无法确认
- 原因是 git push origin main 执行过程中被用户中断
当前完成度结论¶
已完成¶
- Gemini CLI
- Codex
- OpenCode
- Kiro
- OpenClaw
- GitHub Copilot 本地配置
- GitHub Copilot 本地提交
未完成但只差最后一步¶
- GitHub Copilot 远端生效
所需动作：
- 成功执行一次 git push origin main
备注¶
本次对 Codex 的处理采用了兼容方案，没有覆盖你已有的 Confirmo 通知，而是将 peon-ping 串联接入。