安装前先预览 PigeonStack

开始前

检查当前宿主要求

• 当前已验证的宿主是 Windows 和 PowerShell。
• 同步脚本要求 Python 3.11 或更高版本。
• 安装插件需要兼容的 Codex CLI，以及已注册并能解析 pstack@personal 的本地插件市场。
• 多 Agent 工作需要宿主提供原生子 Agent 工具，并且账号可使用所选模型。

第 1 步

克隆源码

在 PowerShell 中进入你保存代码仓库的目录，然后运行：

git clone https://github.com/PigeonAI-Yang/pigeonstack.git
Set-Location pigeonstack

第 2 步

在新的同级目录预览

下面的命令会在 ../pigeonstack-preview-codex 中复制受管理文件并合并选定配置。首次检查通常因目录为空而以代码 1 退出。文件和配置一致时，最后一次检查以代码 0 退出。

python scripts/sync.py check --codex-home ../pigeonstack-preview-codex --skip-plugin-install
python scripts/sync.py deploy --codex-home ../pigeonstack-preview-codex --skip-plugin-install
python scripts/sync.py check --codex-home ../pigeonstack-preview-codex --skip-plugin-install

目标不是默认目录时，保留 --skip-plugin-install。脚本会拒绝与源码目录重叠的目标目录。

在其他机器真实安装前

核对路径与设置

同步脚本的默认目标是 J:/Users/yangda01/.codex。全局规则、Codex 宿主说明和 poteto-agent.toml 角色文件中也有维护者的专属路径。

脚本不会注册插件市场。在其他宿主真实安装前，先适配源码，并确认本地插件市场能解析 pstack@personal。

实测结果

已验证的隔离预览

本节于 2026-10-03 根据发布提交 41f7dce复核。实际空目标检查发现预期差异，返回代码 1。部署向受管理文件和配置写入 217 项，返回代码 0。最终检查确认文件和配置一致，返回代码 0。

在仓库目录运行 python -m unittest discover -s scripts -p test_sync.py，可重跑 scripts/test_sync.py 中的 4 项配置回归测试。测试覆盖根级和表级作用域、未管理值保留、重复调用幂等，以及多行值限制。

Documentation health 工作流会持续运行站点检查。这些检查不证明插件已激活、模型路由有效或节省了成本。

任务示例

给主控一个具体结果

例如，可以这样向 Codex 提出任务：

修复报表没有数据行时的导出错误。保持现有文件格式，同时验证正常导出流程。

这只是工作方式示例，并非已执行的记录。主控检查证据、选择修复，再给 Luna 一份边界明确的实现与验证说明。Luna 未能解决时，由新的 Sol 高级执行者从 medium 开始接手。同一个问题仍未解决时，依次进入 Sol high 和 xhigh，再按需进入 Astra high 和 xhigh。主架构、系统架构、关键接口和数据契约设计，以及重大设计取舍，可以直接交给 Astra。用户针对当前任务明确选择的模型和强度优先。