边缘路由与绑定
路径归属
apps/web/worker.ts 是客户站点的统一入口。/api/* 转给接口服务；下列路径及其子路径转给工作台；其余请求交给公开站静态资源。
text
/_app
/login
/signup
/forgot-password
/reset-password
/dashboard
/history
/credits
/members
/settings匹配采用完整路径或以斜杠分隔的子路径，避免 /members-only 之类公开页面被 /members 误拦截。新增工作台顶层路由后必须同步入口列表和本地网关，并检查直接刷新地址的结果。
服务与资源绑定
| 绑定 | 所属服务 | 用途 |
|---|---|---|
ASSETS | 公开站、工作台 | 提供各自构建产物 |
APP_SERVICE | 公开站 | 转发登录与工作台请求 |
API_SERVICE | 公开站 | 转发接口请求 |
HYPERDRIVE_UNCACHED | 接口 | 认证、权限、账单与实时数据查询 |
HYPERDRIVE_CACHED | 接口 | 可接受短期旧结果的查询 |
资源名称和环境值在各应用的 wrangler.jsonc。接口启用 Node 兼容能力以使用数据库及服务依赖，公开站和工作台无需照搬这些设置。
缓存边界
公开静态资源可以缓存。会话、成员权限、积分余额、订阅状态及写入后的查询不使用 Hyperdrive 查询缓存，也不能被公开响应缓存。服务端是否允许操作由数据库里的当前身份和角色决定。
排查
页面跳错应用时，先查路径分流；接口 404 时，检查公开入口服务绑定和接口路由；只有线上数据库失败时，检查两个 Hyperdrive 资源与连接权限。完整本地预览使用直连数据库，不能替代线上绑定验收。
基础设施与应用发布的责任边界见 部署决策。