qiaoya-cli

面向 agent 的敲鸭社区 bootstrap 仓库。

这个仓库现在分成两层：

• agent-harness/ Python runtime，负责真实 API 调用
• 根目录 npm bootstrap 负责 npx qiaoya 安装 Codex skill bundle 和 runtime

Agent-First 用法

推荐入口：

npx qiaoya

它会做这些事：

• 安装 Codex skill bundle 到 ~/.codex/skills/qiaoya
• 把 runtime 放进 ~/.codex/skills/qiaoya/scripts/qiaoya
• auto 模式下优先尝试 GitHub Release 二进制，失败再回退到 Python runtime
• Python 回退时，用 skill bundle 内部的 .runtime/ 承载 pipx runtime
• 做一次基础自检

也可以显式执行：

npx qiaoya install
npx qiaoya doctor

显式指定时可以把单文件二进制放进 skill bundle：

npx qiaoya install --runtime-kind binary --binary-source /path/to/qiaoya-binary

Runtime 说明

当前 bootstrap 安装的是现有 Python runtime，所以目前仍然需要：

• python3
• pipx

后续如果 GitHub Releases 提供了平台二进制，binary 模式会把对应文件安装到：

~/.codex/skills/qiaoya/scripts/qiaoya

现在 auto 模式已经会优先尝试下载最新 release 资产：

• qiaoya-darwin-arm64
• qiaoya-darwin-x64
• qiaoya-linux-x64
• qiaoya-windows-x64.exe

runtime 安装后可直接调用：

~/.codex/skills/qiaoya/scripts/qiaoya public course-list --json
~/.codex/skills/qiaoya/scripts/qiaoya ai-news today --json

欢迎页课程与 AI 日报

这是当前 skill 的两个高价值入口：

• 欢迎页课程：让 agent 总结有哪些课程、哪些适合 AI 深度使用者
• AI 日报：让 agent 总结今日/往期 AI 资讯

开发

Node bootstrap：

npm test
node bin/qiaoya.js --help
node bin/qiaoya.js install --runtime-kind binary --binary-source /tmp/qiaoya-binary
node bin/qiaoya.js install --runtime-source ./agent-harness

Release

仓库已经提供二进制发布工作流 release-binaries.yml：

• 推送 v* tag 时自动构建多平台 binary
• 产物命名与 bootstrap 下载规则一致
• 上传到 GitHub Release 供 auto/binary 模式消费

Python runtime：

cd agent-harness
pytest cli_anything/qiaoya/tests/test_core.py cli_anything/qiaoya/tests/test_full_e2e.py -q

CI

CI 会同时校验：

• Node bootstrap 测试
• node bin/qiaoya.js --help
• Python runtime pytest
• bash -n agent-harness/install.sh
• skill bundle 内 runtime 安装校验