HokiPoki

HokiPoki 技能

通过 HokiPoki P2P 网络将任务路由至不同的 AI CLI（Claude、Codex、Gemini）。API 密钥始终保留在提供方机器上；仅交换加密的请求与结果。

前置条件

必须已安装并完成身份验证的 HokiPoki CLI：

npm install -g @next-halo/hokipoki-cli
hokipoki login

使用 hokipoki whoami 验证登录状态。若尚未安装，请引导用户完成安装配置。

向其他 AI 请求协助

向远程 AI 模型发送任务。务必始终使用 --json 参数以获得可解析的输出：

# 指定文件
hokipoki request --tool claude --task "修复认证漏洞" --files src/auth.ts --json

# 整个目录
hokipoki request --tool codex --task "添加错误处理逻辑" --dir src/services/ --json

# 整个项目（遵循 .gitignore 规则）
hokipoki request --tool gemini --task "进行安全问题审查" --all --json

# 路由至团队工作区
hokipoki request --tool claude --task "优化数据库查询" --files src/db.ts --workspace my-team --json

# 跳过自动应用补丁（仅保存 patch 文件）
hokipoki request --tool codex --task "重构模块" --dir src/ --no-auto-apply --json

工具选择说明：若用户未指定 --tool，请主动询问其希望使用的模型；也可省略该参数，交由 HokiPoki 自动选择。

补丁自动应用（Patch Auto-Apply）

当目标目录为已提交过文件的 Git 仓库时，补丁将自动应用。若自动应用失败，请告知用户，并建议执行以下命令初始化本地仓库：

git init && git add . && git commit -m "initial"

提供方模式（共享你的 AI 能力）

注册并监听来自网络的请求：

# 注册为提供方（仅需执行一次）
hokipoki register --as-provider --tools claude codex gemini

# 启动监听服务
hokipoki listen --tools claude codex

所有任务均在隔离的 Docker 容器中执行（文件系统只读、工作区挂载为 tmpfs、执行完毕后自动清理）。请确保 Docker 守护进程正在运行。

状态与账户信息

hokipoki whoami      # 查看当前用户信息
hokipoki status      # 查看账户详情、工作区列表及历史记录
hokipoki dashboard   # 在浏览器中打开 Web 控制台

何时建议“切换 AI”（Hopping）

• 用户在多次尝试后仍无法解决当前问题
• 用户明确要求换一种思路或获取全新视角
• 当前任务所属领域恰好是另一模型的优势方向（例如：Codex 擅长生成样板代码，Gemini 擅长大上下文分析）
• 用户直接提出“换一个 AI 尝试”的请求

完整命令参考

所有 CLI 参数、认证令牌存储路径及高级用法，请参阅 [references/commands.md](references/commands.md)。