一条依赖方向,从契约到组件
protocol ← sdk ← chat-ui 由 dependency-cruiser 强制;server 只依赖 protocol, 浏览器 bundle 里不会出现 provider 凭据。
它解决什么
从协议到上架目录的每一层,都有门禁与真实 Cloud 验证记录兜底。
自研协议,事件契约与 SDK 同源
SSE 帧、游标与重连、event_id 去重、乐观消息与 turn 边界由 kit-sdk 承担;事件模型直接复用 @openagentpack/sdk 的 SessionEvent,不私造第二套。
headless hooks + copy-in 组件
useChat / useSessions / useAgentCatalog 管状态;kit-chat-ui 的组件源码可整份复制进你的项目自由修改(ADR-0005),样式只用 Tailwind + 冻结 token。
可部署的 Node server
Hono + node:sqlite:数据面 /api/kit/*、控制面 /api/admin/*;凭据不出服务端,事件不落库,openapi.json 与接口文档双向校验。
管理端与高风险闸门
Project 声明 → plan(展示 diff)→ 一次性确认令牌 → apply / publish / 上下架;服务端拒绝无令牌的破坏性请求,CLI 也没有 --yes。
多端复用一份 Web 产物
浏览器与 H5 复用同一份体验页,按视口适配导航、对话布局与输入区。
为 coding agent 而写的仓库
AGENTS.md 权威顺序 + 执行红线 + 包级不变量;dependency-cruiser 与 check:docs 把约定变成门禁,别人用自己的 agent 也能安全接手。
组件在线预览(真实组件,不是截图)
文档站直接依赖 workspace 里的 kit-chat-ui:预览里长什么样,你的页面就长什么样。 可切桌面 / 手机、展开源码、复制 copy-in 命令。
接口声明即文档
由路由的 zod schema 生成 openapi.json,再生成站内接口页;手写文档里的链接被测试盯着,改路由不留死链。
一份 Web 产物,适配桌面与手机
同一套对话与 Artifact 组件按视口调整布局,桌面浏览器与手机 H5 都能使用。