Pi 工作环境
让 Pi 不只完成一轮问答，还能分工执行、找到合适的能力、留下可追查的过程，并让人方便地参与。围绕日常使用中的这些需求，我做了一组扩展和工具，也在 Pi Web 的上游基础上补充会话观察能力。
目标与范围
以 Pi 为核心，逐步形成可持续使用和改进的个人 Agent 工作环境。按具体问题补齐能力，保持各工程能独立使用；代码、安装与配置说明维护在各自仓库，这里集中说明它们解决什么、怎样配合，以及当前推进的工作。
已有工程
| 需求 | 工程 | 已有能力 |
|---|---|---|
| 把独立任务交给其他 Agent | pi-subagent | 创建独立子会话，观察执行、追加消息或停止任务；支持前台返回和后台通知。 |
| 找到所需能力，并在执行中发现偏离 | pi-discovery | 统一发现 Skill、MCP 和延迟工具；支持输入时的能力与动作推荐，以及周期轨迹审查。 |
| 看清 Agent 实际做了什么 | pi-snap | 紧凑展示与筛选会话记录，再按记录编号展开原始证据，供人和 Agent 使用。 |
| 按时间运行任务 | pi-cron | 通过官方 Pi CLI 定时执行任务，处理配置热更新、去重、同任务互斥与超时。 |
| 人和 Agent 接续同一段终端操作 | Tide | 保持交互式终端会话；Agent 发送输入、读取画面，人可打开真实终端接手。它也能用于 Pi 之外的 CLI。 |
| 在手机上口述任务 | VoiceAssist | Android WebView 加载 Pi Web，以端侧语音识别提供录入能力；结果先预览，再选择发送或填入。 |
| 在 Web 界面观察外部会话 | pi-web 分支 | 基于 agegr/pi-web 补充外部会话发现与文件跟踪，观察时不启动 Agent。 |
这些能力按仓库 README 和相关提交整理；安装要求、参数及各自的验证范围以仓库当前文档为准。
怎样配合
执行与协作。 pi-subagent 用于一次任务中的分工，pi-cron 用于按时间启动任务。两者解决不同的调度问题，都沿用 Pi 的会话与执行能力。
发现与观察。 pi-discovery 帮助主 Agent 找到能力，并按配置审查执行轨迹；其中自动准备与轨迹审查通过 pi-snap 读取会话记录。pi-snap 也可独立用于排查，回到原始记录核对提醒或完成判断。pi-web 分支则提供外部会话的可视化观察入口。
人的参与。 VoiceAssist 降低手机输入任务的成本，Tide 让需要持续交互或人工介入的终端操作能够接续。前者连接 Pi Web，后者是独立的终端工具，不要求整套工程一起安装。
成功标准
- 已有工程有统一入口，读者能理解用途、真实依赖与贡献边界，并找到代码和使用说明。
- 在日常任务中持续检验协作、发现与观察能力，以会话证据识别缺口并改进。
- 手机输入、终端交接与定时执行的关键路径有可追溯的实际使用结果。
工作项
| 工作项 | 交付标准 | 当前进度 |
|---|---|---|
| 工程梳理与项目入口 | 关联已有仓库，说明用途、相互关系及原创或上游扩展边界；入口可被博客发布管线读取。 | 查看工作记录 |
后续工作从实际使用中发现的问题选择；各仓库已有能力不等同于整体工作流已验收。
相关项目
- Agent 研究：研究 Agent 的设计、行为与效果，提供方法与判断依据；本项目承接工作环境的工程整合。
- 个人工作流：组织项目、记录与信息输入，是定时执行等能力的使用场景。
- AI 软件工厂：以实际软件交付评价 Agent 能力，是这套工作环境的使用场景之一。
- Agent 设计与改进：通用设计方法与行动原则。