ProfoundCap AI Agent Hub

团队专属的 Codex & Pi 编程 Agent 基础设施、统一配置分发中心与模型能力全景选型指南。

📥 一键安装与配置同步

在任意 Linux / macOS 终端执行以下单行命令，即可调出交互式管理菜单。支持全自动安装依赖环境、下发最新模型配置，且绝不会覆盖个人已配置的 API Key：

curl -sSL https://tools.profoundcap.com/setup.sh | bash
⚡ 命令行直接快捷调用（免交互式菜单）：
curl -sSL https://tools.profoundcap.com/setup.sh | bash -s -- 1 安装并初始化 Codex 环境
curl -sSL https://tools.profoundcap.com/setup.sh | bash -s -- 2 安装并初始化 Pi 环境
curl -sSL https://tools.profoundcap.com/setup.sh | bash -s -- 3 更新 Codex 模型列表与配置（保留密钥）
curl -sSL https://tools.profoundcap.com/setup.sh | bash -s -- 4 更新 Pi 模型列表与配置（保留密钥）
curl -sSL https://tools.profoundcap.com/setup.sh | bash -s -- 5 一键安装两者 (Codex + Pi)
curl -sSL https://tools.profoundcap.com/setup.sh | bash -s -- 6 一键更新两者模型与配置
💡 提示：若脚本已下载到本地，亦可直接在本地执行 bash setup.sh [1-6]。
🔑 统一认证说明：用于通用联网检索的 TinyFish API Key 已统一内置共享，个人无需单独申请；只需在首次运行时按提示输入属于个人的 CCH_API_KEY 即可。

🧠 模型能力矩阵与使用建议

当前中转平台统一接入并由 models.json 完成标准化适配的模型列表，按定位分为三类：

👑 第一梯队：高智商 / 复杂规划 / 架构设计

适用于需求拆解、全库架构规划、疑难杂症根因排查。思考推理极度严密，但生成耗时相对较长。

模型 ID 上下文 推理深度 速度表现 核心特质与使用建议
gpt-6-astra 当前旗舰 256K High 🐢 较慢 当前综合智商天花板。逻辑严密，适合重大需求架构规划与技术方案设计。速度较慢，256K 偏小但足够单模块精细推导。
gpt-5.6-sol 基石旗舰 256K High 🐢 较慢 上一代顶级旗舰，综合代码能力与 Astra 相当，非常稳健，推理过程极详实，擅长复杂工程代码重构。
glm-5.3 国产顶配 1M Max ⏳ 偏慢 1M 超大上下文。知识面与纯英文逻辑稍逊于 GPT，但大文本吞吐极强。夜间服务器负载低时响应较快，适合大项目全貌扫描。

⚡ 第二梯队：中等强度 / 敏捷均衡

模型 ID 上下文 推理深度 速度表现 核心特质与使用建议
grok-4.6 高直觉 500K High 🚀 较快 xAI 旗舰。500K 上下文，速度快、代码审美和逻辑直觉极好。⚠️ 注意：当前中转通道稳定性偶有波动，时有时无；通道畅通时推荐主力使用。

🛠️ 第三梯队：主力干活模型 / 编码执行

适用于写具体函数、补单测、修复已知 Bug、文件批量修改。要求响应极快，无需打断思路。

模型 ID 上下文 推理深度 速度表现 核心特质与使用建议
gemini-3.8-flash 🌟 强烈推荐 1M High ⚡ 极速实时 主力干活首选！ 速度飞快，几乎零等待流式输出，智商高度在线。能同步对话完成工具调用和小任务，1M 大上下文，日常开发体验极佳。
glm-5.3-flash 主力编码 1M High ⏳ 适中偏慢 智商表现拔尖，代码扎实，能独立稳定搞定大部分核心编码工作；速度比 Gemini 慢，适合不需要频繁即时交互的深度编码。
deepseek-v4-flash 经济迅速 1M High 🚀 较快 生成速度快、成本极低，写脚本与简单修改顺畅。但在高难度复合推演上智商略逊于 Gemini 3.8 Flash。
gpt-5.6-luna 限流注意 256K Max ⚡ 快速 便宜且能干活的轻量模型，但目前中转通道日常限流严重，容易遇到 429/503，不建议作为主要依赖。

⚖️ 架构与选型对比：Codex vs Pi

对比维度 OpenAI Codex (开箱即用) Pi Agent (极客定制神器)
产品定位 开箱即用的工业级 CLI，像 IDE 一样开箱即走。适合不想折腾配置、注重开箱即用体验的同学。 终端定制利器（类似 Vim），极高自由度与扩展能力。插件生态活跃，适合追求极致流程度与深度定制的工程师。
模型切换 通过 /model 指令或配置文件切换，内置了统一发布的 models.json 映射。 支持灵活的模型别名配置，可以在单个 Session 或 Subagent 粒度自由指定模型与思考深度。
🌐 搜索与抓取 依赖内置 search 工具或 OpenAI 生态，国产模型（GLM、DeepSeek 等）容易因无原生联网能力导致信息脱节。 巨大优势 通过 pi-web-access + TinyFish，将极速搜索与网页正文抓取（Fetch）赋能给所有模型，彻底补齐国产模型短板。
📋 计划与文档管理 自带 Plan 模式，主要在当前会话中显示待办或更新任务列表。 巨大优势 搭载 pi-plan 扩展：制定的方案自动按年月归档到项目目标目录（如 docs/AI_docs/plans/202609/），与 Git 代码库天然融合，沉淀项目资产。
🔄 后台与自动化 主要靠后台进程执行，终端状态反馈较基础。 巨大优势 搭载 pi-loop：界面比 Codex 更美观生动，支持长任务后台驻留、Crontab 定时唤醒、事件驱动、多任务队列等无人值守功能。
🤖 Subagents 编排 支持标准 multi_agent 多线程协作机制。 巨大优势 搭载 pi-subagents：可针对 researcher、reviewer、worker、planner 等角色单独指定不同模型，并支持用 JavaScript 编写自定义 Workflow 流水线。

🎯 推荐搭配与高效工作流范式

⚡ 日常高频迭代（无感秒回）

工具：Codex 或 Pi 均可

  • 主力模型：gemini-3.8-flash
  • 场景：修复单点 Bug、给函数写单元测试、日常重构、解释代码逻辑。
  • 优势：几乎瞬时吐字，边看边想，完全不需要切出终端等待，大幅降低注意力碎片化。

🗺️ 复杂需求规划与沉淀

工具：推荐使用 Pi Agent

  • 规划模型：gpt-6-astra 或 gpt-5.6-sol
  • 工作流：唤起 pi-plan 梳理系统架构与拆解步骤，方案自动固化在 docs/AI_docs/plans/ 下。
  • 执行模型：方案敲定后，切到 gemini-3.8-flash 或 glm-5.3-flash 落地编写。

🔍 外部技术调研与长文分析

工具：推荐使用 Pi Agent

  • 模型：glm-5.3 (1M 上下文) 或 gemini-3.8-flash
  • 配合能力：结合 TinyFish 联网检索与 Fetch，把几十页官方英文 Doc 或 GitHub Issue 抓取并吞入 1M 上下文消化。

👥 多角色协同审查 (Review)

工具：推荐使用 Pi Agent (Subagents)

  • 配置：Worker 使用 glm-5.3-flash 编码；Reviewer 使用 glm-5.3 进行严格代码走查；Planner 统筹全局。
  • 收益：各司其职，避免单一上下文污染，输出质量大幅超越单模型。

📂 静态配置资源清单

所有文件均支持直接点击下载，或通过 setup.sh 脚本自动拉取：

Codex 相关资源：

Pi 相关资源：