CY-02 · Cindy
01 / 18
Cindy 的 Agent 使用与开发过程
分别追踪产品任务运行与开发修复，保留两条线的证据。
- 理解任务接受、工具调用与事件返回。
- 解释 Ghost 渐进发现的真实边界。
- 用 Pi 生命周期案例复述假设、对照和修复。
CY-02 · Cindy
02 / 18
Agent 任务逻辑架构
CY-02 · Cindy
03 / 18
产品运行与项目开发两条线
| 分析线 | 输入 | 成功依据 |
|---|---|---|
| 产品 Agent 运行 | 目标、目录、能力与历史 | 工具结果与任务条件 |
| 使用 Agent 开发 | 症状、范围、规则与复现 | 有效修复、评审和验收 |
支持多执行器不证明一次修复使用多个 Agent；不推算人机贡献。
CY-02 · Cindy
04 / 18
任务创建与上下文
输入保留目标、目录、附件和约束。
入队与发送事务核对执行器和会话状态。
必要时建立或恢复 Session，再派发。
accepted 表示受理边界，不是目标已完成。
CY-02 · Cindy
05 / 18
模型接入边界
- BaseAgent 声明能力，Maker 调用 startSession。
- 模型、推理、权限、目录与 MCP 是不同参数。
- 共享事件契约由供应商适配器建立。
- 本次没有模型缓存率或吞吐测量。
CY-02 · Cindy
06 / 18
工具与可复用能力
| 入口 | 作用 | 区别 |
|---|---|---|
| 花名册 | 身份与召回场景 | 不是完整手册 |
| ghost_info / ghost_list | 精确查询或全量回查 | 信息完整度相同，非固定顺序 |
| ghost_manual | 按需工作方法 | 不代表具备工具执行能力 |
| ghost_call | 查询或调用声明工具 | 需要当前可用状态 |
CY-02 · Cindy
07 / 18
工具调用时序
根据已知 ID 或召回线索取得实时信息。
需要时读手册或调用声明的 list_tools。
信息足够后，传入符合真实 schema 的参数。
宿主复查当前可见性，执行后核对结果。
CY-02 · Cindy
08 / 18
进度、错误与中断状态
| 观察 | 能证明 | 仍需确认 |
|---|---|---|
| 输入受理 | 跨过入口合同 | 执行与结果 |
| 工具开始 | 动作进入执行 | 返回或确认失败 |
| 供应商轮次结束 | 原生事件到达 | 产品续段是否收口 |
| UI 收到事件 | 展示链有数据 | 持久化与目标验收 |
CY-02 · Cindy
09 / 18
开发需求与任务说明
- 原症状：Windows Pi 长 exe 打包停在已工作。
- 报告缺同轮 PID、退出码和 RPC 时间线。
- 把调查写成可检验假设，不直接确认根因。
- 当前案例验证退出通知链，不是完整真实打包。
CY-02 · Cindy
10 / 18
文档和代码定位
PiAgent
→ PiRpcProcess
→ event translator
→ AsyncQueue
→ Session
传输：agents/pi/transport.ts- fixture 替换可执行程序，其余使用生产事件链。
- 查看 Node exit 与 close 的不同条件。
- 后代继承管道会影响 EOF，不等于父进程仍活。
CY-02 · Cindy
11 / 18
验证与评审
受控前提与对照
- Pi PID 已消失，后代仍活着。
- 退出码 23，工具开始事件已发出。
- 正常长静默、普通退出和 Stop 分别检查。
边界评审
- close 失败不能冒充确认退出。
- 缺失结果保留未知，不补成功。
- 通知一次，保持竞态和取消语义。
CY-02 · Cindy
12 / 18
任务交接
- 说明最终行为、实际检查与历史结果。
- 保留基线 TS2322、跳过和未覆盖环境。
- Windows fixture 与 EBUSY 清理问题分别定界。
- 不将旧测试数量写成本次实测，下一步取证具体化。
CY-02 · Cindy
13 / 18
运行案例：能力发现与调用
发现信息
- 安装、发现、登录与授权分别核对。
- 手册说明方法，真实 schema 定义参数。
- 旧发现结果可能已经过期。
当前执行状态
- 检查安装、账号、下线和目录状态。
- 异步准备后再次复查可用性。
- 说明文本不是授权，结果才是观察。
CY-02 · Cindy
14 / 18
开发修复：退出与管道关闭
250
确认退出后的最大尾帧排空 / ms
23
受控 fixture 的退出码
- 正常 close 更早到达时沿原路径通知。
- 250 ms 不限制正常工具，也不是整项任务期限。
- 历史修复后约 0.3 s 收到失败终态；原 Windows 根因未证明。
CY-02 · Cindy
15 / 18
TA 项目可复用模板
| 运行调用 | 开发修复 |
|---|---|
| 目标、目录与真实接口 | 症状、假设与规则 |
| 请求、返回与当前状态 | 受控前提、对照与差异 |
| 成果和未知结果 | 检查、历史与未覆盖环境 |
| 接受条件与任务 ID | 交接和下一步取证 |
CY-02 · Cindy
16 / 18
练习与验收
- 画 input.enqueue 到 Session 回界面的时序。
- 标出入队与兼容直发分支。
- 填写 Pi 的症状、前提、对照、改动与限制。
- 解释 250 ms 起点，明确原 Windows 根因未证明。
CY-02 · Cindy
17 / 18
调用与开发过程思维导图
CY-02 · Cindy
18 / 18
代码、规则与开发记录
- 发送事务
受理、会话与派发边界
- Ghost 渐进发现
花名册、实时信息、手册和工具
- Pi 生命周期研究
历史受控证据与未覆盖范围
- 当前 Pi transport
exit、close 与有界尾帧排空
- 本章完整学习稿
含解释、案例、练习与逐项来源
- 版本来源索引
来源、版本、核验日期与使用位置
核验日期：2026-10-10。134 定向、511 根级通过及 1 跳过属于历史记录，未重跑。