用途:在 showcase/ 目录下构建、调试和回归测试 CopilotKit 演示,包括新建 showcase 演示、item、cell、pill 及实现新功能。
主要能力与规则:改动前先阅读 showcase/README.md、RUNBOOK.md、DEBUGGING.md,新增或修改演示时读 INTEGRATION-CHECKLIST.md。演示代码保持 CopilotKit v2 API;以 showcase/integrations/langgraph-python 为 D5 行为黄金标准,其他演示需在行为、提示词、pill、工具流、UI 断言和 D5 覆盖上与其 1:1 对齐,除非用户明确批准差异。依赖版本先与 langgraph-python 对比,保持相同或更新。
使用方式:用 showcase/bin/showcase 执行操作,避免直接使用 docker compose、docker build 或 harness 命令。隔离运行示例:showcase/bin/showcase test <slug> --d5 --verbose --cycle --isolate。涉及真实 LLM 的本地步骤必须通过 aimock record 模式录制夹具,录制命令为 docker compose -f showcase/docker-compose.local.yml -f showcase/docker-compose.record.yml --profile infra up -d aimock <slug>,录制结果位于 showcase/aimock/d5-recorded/,再转为 showcase/harness/fixtures/d5/ 下的源夹具。夹具编辑后运行 showcase/bin/showcase fixtures validate、recreate aimock 和 D5 测试。
适用场景:新建或迁移演示、调试 bug、录制与回放夹具、添加回归测试。限制:每个 pill 必须经 aimock 回放覆盖,且单击、连续五次、交错点击均需稳定;不得为通过测试而削弱演示行为;aimock 能力不足时应确认缺口并讨论上游改动,而非在演示中伪造行为。环境变量缺失时检查 showcase/.env,不要将密钥粘贴到聊天中。缺失事实:具体演示列表、支持平台与收费信息暂未提供。