Initial import of WebUp Cloud

This commit is contained in:
WebUp Cloud committed 2026-11-07 13:31:14 +08:00
commit db82325ed7
216 files changed
+33718

No files matched your search

+64
View File
@@ -0,0 +1,64 @@
# 模型、钱包与隔离开发
本模块新增可执行代码,不代表全部商业需求已完成。真实供应商调用与 Kubernetes 工作区需要运营者配置凭证和集群,当前只完成本地自动化测试,不能将协议 Mock 或资源配置测试当成真实联调。
## 执行就绪与调度
仅启动前端和 API 不会执行 AI 任务。独立 Worker 每五秒向数据库登记实际网关 / Kubernetes 健康检查结果;四十五秒没有有效心跳视为离线。页面展示当前状态,离线时不创建新预算预留、不恢复任务、不收取新的优先费,已有任务仍可取消并释放未使用预留。
全局并发、人工调序、管理员指定下一位和钱包购买优先权已接入真实队列,详见 [队列规则、退费与接入](QUEUE.md)。单个 Worker 可使用受容量限制的虚拟线程同时开发多个项目,全局领取由数据库单例行锁协调。预览默认不启用 Worker,必须接入真实隔离网关后才能实际执行。
## 模型协议
支持 OpenAI Chat Completions 兼容协议、Anthropic Messages、Gemini generateContent。DeepSeek、智谱、百炼与中转站可按其实际兼容接口配置 OpenAI 类型;不能假设所有兼容服务完整支持 tools 或 usage。
协议依据:[OpenAI Chat Completions](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)、[Anthropic 工具调用](https://platform.claude.com/docs/en/agents-and-tools/tool-use/how-tool-use-works)、[Gemini generateContent](https://ai.google.dev/api/generate-content)。Gemini 的原始 parts(包括 thoughtSignature)、Anthropic 原始内容块会保存在任务消息中,以便继续工具调用。
后台先添加供应商,再添加模型和每百万 Token 的人民币价格。供应商 Base URL 应包含协议版本,例如 `https://api.openai.com/v1`、`https://api.anthropic.com/v1`、`https://generativelanguage.googleapis.com/v1beta`。官方预设包含 MiMo / DeepSeek / Kimi 等国内供应商;自定义 HTTPS 中转默认允许管理员配置,并在连接时拒绝私网 / 元数据 DNS 地址。可以将 `app.allow-custom-providers` 设为 false,只接受官方预设和 `ALLOWED_PROVIDER_HOSTS` 精确允许列表。
API Key 通过 AES-256-GCM 加密,随机 12 字节 nonce 和认证附加数据;完整密钥不回传客户端、不写入审计。`APP_ENCRYPTION_KEY` 是 Base64 编码的 32 字节随机值,必须独立保管和备份。当前密钥格式为 v1;更换主密钥前需实现 / 执行重加密迁移,直接替换会导致旧凭证无法解密。供应商 API Key 则可通过编辑界面直接轮换。
HTTP 客户端禁用重定向和自动重试;实际 DNS 解析连接时拒绝本地、私有、链路本地、组播、CGNAT 等地址,避免只做一次字符串检查。超时 / HTTP 错误只公开脱敏原因,不返回上游响应正文。
连接测试调用真实 `/models`,只验证该接口可连接,不证明某个模型的工具能力。当前工具支持由管理员依据实际模型能力声明;自动能力探测、视觉附件上传和流式 Token 输出尚未实现。遇到不支持工具的模型不能宣称已执行开发。
## 钱包与预算
钱包独立于 users 表,使用 NUMERIC(24,8)。账本记录每次实际余额变化,具有用户内唯一幂等键、业务关联和变动后余额。
管理员增加 / 扣除余额需要 `finance:write`、原因与幂等标识;操作与审计使用同一事务。同一标识重复请求返回原记录,金额或原因不同则拒绝。扣除不能动用已预留资金。余额调整不是在线支付充值;支付渠道尚未实现。
任务创建时在事务中预留预算;每轮使用任务绑定的不可变价格版本计算实际消费。普通输入、缓存读取、缓存写入和输出分别计费,避免缓存输入重复计算。任务正常完成或取消时释放未使用部分,暂停时继续预留。模型当前价格使用明确的版本指针,不依赖并发事务时间排序。
执行前按模型上下文上限和输出上限计算保守的单次费用边界。剩余预算不足时暂停,不先调用再透支。缺少 usage 时不使用隐藏估算策略,转为 REVIEW_REQUIRED。当前未提供预算追加接口;预算不足需取消后重新设置预算发起任务。
## 任务与恢复
数据库任务状态:QUEUED、RUNNING、PAUSED、COMPLETED、CANCELLED、FAILED、REVIEW_REQUIRED。每个项目只允许一个活动任务,避免并发编辑同一工作区。用户每次提交需幂等标识。
Worker 以条件更新原子领取任务,持有 300 秒租约;调用模型前与每个工具操作前续租。租约过期不自动重放不确定请求。网络超时、工具结果未知和缺少 usage 会保留剩余预算并转为人工核对。财务管理员核对上游账单和工作区后可补充结算并释放预留,操作单独记录,不伪装为精确 Token 结算。
默认每次运行最多 30 轮,达到轮次上限后显式继续可再执行最多 30 轮(仍受预算约束);每轮最多 8 个工具,终端命令最长 120 秒。达到轮次或保守上下文限制后暂停。当前没有自动上下文摘要,达到上下文容量限制后应取消并人工整理需求。后续任务复制最近已完成任务的消息;项目文件始终持久保存在对应 PVC。切换新任务模型可转换规范化消息,供应商原始块保留用于同协议继续调用;跨模型复杂推理上下文兼容尚需真实验证。
COMPLETED 表示模型结束本轮工具循环,不是生产发布 / 构建验收结论。用户需核对实际工具日志、退出码、文件与构建测试结果。自动浏览器测试、预览代理和正式部署尚未实现。
## 隔离网关部署
1. 准备测试 K3s / Kubernetes 集群、支持 NetworkPolicy 的 CNI、可用 PVC provisioner。
2. 安装并实际验证 gVisor RuntimeClass `gvisor`(也可配置经验证的 Kata 类运行时)。不得把该名称映射回普通 runc 以绕过隔离要求。
3. 节点 kubelet 设置进程数等主机级限制,例如 `podPidsLimit`;NetworkPolicy 必须通过测试确认阻断私网、其他项目、元数据和管理网。YAML 创建成功不等于策略已生效。
4. 构建 `infra/sandbox/Dockerfile` 与 `node-agent/Dockerfile`,推送到自己的镜像仓库;生产应使用经扫描且固定摘要的镜像。
5. 检查并应用 `infra/k8s/sandbox-rbac.yaml`,配置独立随机 `SANDBOX_TOKEN` 的 Kubernetes Secret `sandbox-gateway`。Secret 通过受保护文件或密钥管理系统导入,不把明文提交到仓库。
6. 替换 `sandbox-gateway.yaml` 内两个镜像地址,部署网关。它只提供 ClusterIP 服务;不要暴露到公网。
7. 控制面与 Worker 配置相同的 SANDBOX_URL、SANDBOX_TOKEN、APP_ENCRYPTION_KEY。跨主机使用受认证的私有 TLS 网络;本地测试可通过只监听回环的 kubectl port-forward。
8. 本地 Compose 使用 `docker compose --profile ai up -d --build` 启动独立 AI Worker。配置不足时 Worker 启动失败,不降级到宿主机执行。控制面默认不运行 Worker。
网关自身是可信基础设施组件,持有指定命名空间的 Pod / PVC / NetworkPolicy 创建权限及 Pod exec 权限。它不需要集群管理员权限,不挂载 Docker Socket。工作区禁用 ServiceAccount token、非 root、只读根文件系统、禁提权、drop ALL capabilities、RuntimeDefault seccomp、独立 PVC、CPU / 内存 / 临时盘限制。工作区容器内没有平台 API Key 或管理凭证。
当前资源额度是网关固定安全默认值,尚未与商业套餐调度连接。网关单副本,每个工作区串行执行工具;锁映射与资源生命周期清理、限流及多副本网关需要后续工程完善。PVC 不自动删除,避免误删项目数据。
## 文件、版本与源码
用户可通过真实隔离网关列目录、读写 UTF-8 文件、保存 Git 版本、列出最近 30 个版本和下载 ZIP。路径必须位于工作区,读取上限 64KB,单次写入上限 256KB。终端输出截断在 64KB,源码 ZIP 限制为 10MB / 5000 文件并排除 `.git`、node_modules、.venv 与 __pycache__。归档属于项目所有者;其中可能包含项目自身的配置文件,下载后应妥善保管。
所有这些功能均先检查项目所有权,不能用修改 URL 访问其他项目。Kubernetes exec 和 PVC 的真实运行、Git 版本操作以及完整 Agent 开发仍需集群联调验证;本地文件工具测试不能替代隔离验收。
+212
View File
@@ -0,0 +1,212 @@
# 当前控制面 API
所有响应为 JSON。错误形如 `{"message":"原因"}`;输入校验错误另有 `fields`。所有时间按带时区时间戳输出。私有接口使用 `Authorization: Bearer <token>`;Cookie、查询参数中的 token 均不被接受。禁止将会话令牌放入 URL 或日志。
## 公共接口
| 方法 | 路径 | 说明 |
| --- | --- | --- |
| GET | `/api/public/settings` | 平台品牌和公告,不含密钥 |
| GET | `/api/auth/captcha` | 返回 id、PNG data URL、expiresIn;30 次 / IP / 分钟 |
| POST | `/api/auth/register` | email、displayName、password、captchaId、captchaCode |
| POST | `/api/auth/login` | email、password、captchaId、captchaCode;返回 token、expiresIn |
| GET | `/actuator/health` | 不公开健康详情 |
验证码有效期 180 秒,每个挑战一次性使用,错误答案也会消费。注册与登录共享 IP 20 次 / 分钟和邮箱 10 次 / 5 分钟限额。验证码之外的格式校验失败可能先被 Bean Validation 拒绝,不进入验证码验证步骤。密码 12–72 字节,包含字母及数字。邮箱按小写存储且唯一。登录会话有效期默认 12 小时。
## 账户接口
| 方法 | 路径 | 参数 / 行为 |
| --- | --- | --- |
| GET | `/api/me` | 当前资料、角色和权限 |
| POST | `/api/auth/logout` | 撤销当前会话 |
| PUT | `/api/account/profile` | displayName |
| POST | `/api/account/password` | currentPassword、newPassword;撤销全部会话 |
| GET | `/api/account/sessions` | 最近 100 条设备会话;不返回令牌摘要 |
| DELETE | `/api/account/sessions/{id}` | 仅撤销自己的会话 |
| GET | `/api/account/logins` | 最近 100 条本人登录记录 |
不采集设备指纹或其他不必要的身份信息。设备展示来自受长度限制的 User-Agent,可能由客户端伪造。
## 项目需求接口
| 方法 | 路径 | 说明 |
| --- | --- | --- |
| GET | `/api/projects` | 本人最近 200 个项目(当前版本上限) |
| POST | `/api/projects` | 创建项目需求 |
| GET | `/api/projects/{id}` | 查询本人项目 |
| PUT | `/api/projects/{id}` | 编辑本人项目需求 |
| POST | `/api/projects/{id}/archive` | 归档,数据保留 |
创建 / 编辑的请求字段:`name`(1–100 字符)、`description`(最多 2000)、`stack`、`requirements`(最多 10000)。stack 为 `Vue 3 / React / Next.js / Nuxt / HTML / Node.js / FastAPI / Laravel` 之一。这里只记录用户选择,不执行 AI 或技术栈构建。跨用户访问统一 404。
## 管理接口
| 方法 | 路径 | 权限 |
| --- | --- | --- |
| GET | `/api/admin/users?search=&page=0` | users:read,每页 20 条 |
| PUT | `/api/admin/users/{id}/status` | users:write;status 为 ACTIVE / DISABLED,reason 必填 |
| DELETE | `/api/admin/users/{id}/sessions` | users:write;撤销全部会话并审计 |
| GET | `/api/admin/settings` | settings:write |
| PUT | `/api/admin/settings` | settings:write;允许列表内的键值映射 |
| GET | `/api/admin/audit` | audit:read,最近 100 条 |
设置允许项:siteName、siteDescription、logoUrl(HTTPS)、mainDomain、filing、footer、registrationEnabled(字符串 true / false)、announcement。域名字段当前仅配置展示,不会调用 DNS。设置及账户状态变更与审计在同一事务提交。
内置角色:USER、SUPER_ADMIN、ADMIN、FINANCE、OPS、SUPPORT。后端实际实现用户、设置、审计的操作权限;finance:write 与 nodes:write 是后续模块预留权限,当前没有资金或节点管理 API。角色授权编辑器尚未实现,不提供任意写入角色的用户接口。
常见错误码:400 输入或验证码错误、401 未认证 / 会话失效、403 无权或注册关闭、404 不存在 / 不属于当前用户、409 唯一约束冲突、429 限流、503 基础服务不可用。
## 模型和供应商
管理接口需要 `models:write`;用户模型列表只返回已开放的模型和已启用供应商。所有接口均需会话认证。
| 方法 | 路径 | 行为 |
| --- | --- | --- |
| GET / POST | `/api/admin/providers` | 列表 / 新建;列表不含完整密钥或密文 |
| PUT | `/api/admin/providers/{id}` | 编辑或轮换密钥,apiKey 留空保持原值 |
| POST | `/api/admin/providers/{id}/test` | 实际调用上游模型列表,记录连接结果 |
| GET / POST | `/api/admin/models` | 管理列表 / 创建模型及初始价格版本 |
| PUT | `/api/admin/models/{id}` | 更新能力与开放状态,新增价格版本 |
| GET | `/api/models` | 当前用户可选模型及价格 |
供应商字段:name、baseUrl(HTTPS 443;连接时校验 DNS、拒绝私网 / 元数据地址)、apiType(OPENAI / ANTHROPIC / GEMINI)、authMode(BEARER / API_KEY / X_API_KEY)、apiKey、enabled、timeoutSeconds(5–180)。供应商预设接口 `/api/admin/providers/presets` 提供 MiMo、DeepSeek、Kimi 等官方模板及自定义兼容中转配置,不预造模型或价格。已有模型引用的供应商不能原地更换地址或协议,需新建供应商。
模型字段:providerId、name、modelId、contextLength、maxOutput、toolsEnabled、visionEnabled、enabled、inputPrice、outputPrice、cacheReadPrice、cacheWritePrice。价格为 CNY / 百万 Token,最多 8 位小数。modelId 与 providerId 创建后不可更改,避免破坏历史任务语义。
## 钱包
| 方法 | 路径 | 行为 |
| --- | --- | --- |
| GET | `/api/wallet` | 本人 balance、reserved、available、currency |
| GET | `/api/wallet/ledger` | 本人最近 200 条真实交易 |
| POST | `/api/admin/wallets/{user}/adjust` | finance:write;amount、idempotencyKey、reason 必填 |
资金调整以用户为范围幂等。金额为有符号 CNY 数值,0 无效;负数不能动用已预留资金。余额不足返回 402 / 409。线上支付尚未实现,调整不能冒充支付到账。
## AI 任务
执行就绪与调度接口:
| 方法 | 路径 | 行为 |
| --- | --- | --- |
| GET | `/api/tasks/execution-status` | 近期真实 Worker 心跳与隔离环境状态;无可用执行端时不允许新预留 |
| GET | `/api/queue` | 并发配置、执行 / 待核对 / 排队数量与本人排队名次 |
| GET | `/api/queue/orders` | 本人的优先权订单与退款状态 |
| POST | `/api/tasks/{id}/priority` | 本人排队任务购买优先,expectedPrice、idempotencyKey |
| PUT | `/api/admin/queue/config` | queue:manage;maxConcurrent、priorityEnabled、priorityPrice、reason |
| POST | `/api/admin/tasks/{id}/priority` | tasks:manage;priority、runNext、reason;下一位请求仍等待真实 Worker 领取 |
| GET | `/api/admin/workers` | nodes:write 或 tasks:manage;实例心跳、容量、正在执行数量和健康状态 |
优先费独立于模型预算,首次执行前结束自动退款,开始执行后不自动退费。人工指定 / 人工权重高于付费优先,同级 FIFO;不抢占已运行任务。无执行端时拒绝新任务、恢复或购买,已存在任务仍可暂停 / 取消。详见 [调度与接入说明](QUEUE.md)。
| 方法 | 路径 | 行为 |
| --- | --- | --- |
| GET / POST | `/api/tasks` | 本人最近 100 条 / 创建并预留预算 |
| GET | `/api/tasks/{id}` | 本人任务、预算与消费,不返回租约令牌 |
| GET | `/api/tasks/{id}/events` | 本人任务事件(最多 1000 条) |
| GET | `/api/tasks/{id}/messages` | 本人持久化消息与工具上下文 |
| POST | `/api/tasks/{id}/pause` | 暂停新的调用,保留剩余预算 |
| POST | `/api/tasks/{id}/resume` | PAUSED 任务重新入队 |
| POST | `/api/tasks/{id}/cancel` | 结算当前调用,停止后续工具并释放未用预留 |
| GET | `/api/admin/tasks` | tasks:manage 或 finance:write,最近 200 条 |
| POST | `/api/admin/tasks/{id}/resolve` | finance:write,人工核对 REVIEW_REQUIRED 任务 |
创建字段:projectId、modelId、prompt、budget、idempotencyKey。仅本人的未归档项目可发起;每个项目只允许一个活动任务。同一幂等键与相同内容重放返回原任务,不重复预留。
人工核对字段:additionalAmount(已产生但尚未入账的追加费用,可为 0)、reason。已结算部分不会重复扣除;追加金额不能超过剩余预留。处理后关闭异常任务并释放剩余预留。人工记录与精确 Token 使用记录区分保存。
队列状态、租约、费用边界、上下文和恢复限制详见 [AI 开发说明](AI-DEVELOPMENT.md)。正常停止 / 输出上限 / 异常中断分别处理,不把输出截断当作正常结束。日志目前采用每 3 秒查询;SSE / WebSocket 实时输出尚未实现。
## 文件、版本和源码
| 方法 | 路径 | 行为 |
| --- | --- | --- |
| GET | `/api/projects/{id}/files?path=.` | 本人工作区目录 |
| GET | `/api/projects/{id}/file?path=src/main.ts` | 本人 UTF-8 文件 |
| PUT | `/api/projects/{id}/file` | path、content,写入本人工程 |
| GET / POST | `/api/projects/{id}/versions` | Git 版本列表 / 保存版本(message) |
| GET | `/api/projects/{id}/source` | application/zip 源码,10MB / 5000 文件上限 |
这些接口需要真实隔离网关;未配置返回 503。文件工具的业务失败(如文件不存在、路径越界)由隔离工具返回 error 字段,前端明确显示。归档排除依赖缓存和 Git 数据,不提供虚假下载地址。
## 托管与运行
| 方法 | 路径 | 行为 |
| --- | --- | --- |
| GET | `/api/public/plans` | 首页开放套餐,无需登录 |
| GET | `/api/plans` | 用户可购买套餐 |
| GET / POST / PUT | `/api/admin/plans[/{id}]` | finance:write,管理套餐及资源配额 |
| GET / POST | `/api/projects/{id}/subscription` | 本人订阅 / 使用钱包购买月度套餐,planId、idempotencyKey |
| GET / POST / PUT | `/api/projects/{id}/services[/{service}]` | 本人 OCI 服务配置;环境变量加密,留空保留 |
| GET / POST | `/api/projects/{id}/deployments` | 本人部署记录 / 创建发布,idempotencyKey、可选 rollbackId |
| GET | `/api/projects/{id}/deployments/{deployment}/events` | 发布阶段与错误记录 |
| GET | `/api/projects/{id}/runtime/services/{service}` | 实际运行状态,需要运行网关 |
| GET / POST | `/api/projects/{id}/runtime/services/{service}/logs`、`.../restart` | 实际日志 / 重启,禁止封禁项目重启 |
配置保存不会冒充已发布。发布由独立运行 Worker 执行,健康检查通过后才切流;失败保持旧版本。未配置真实网关时不能成功启动容器。
## 运营、审核与集成
| 方法 | 路径 | 行为 |
| --- | --- | --- |
| GET | `/api/admin/overview` | 真实统计、14 天增长、任务分布与权限范围内的近期表格 |
| GET | `/api/admin/nodes`、`/api/admin/nodes/control-plane` | 节点快照 / 当前控制面实际指标 |
| POST | `/api/admin/nodes/refresh` | 从 K8s 网关刷新,未配置或失败不会生成虚假节点 |
| GET | `/api/admin/sites` | 用户网站、订阅、部署与审核状态筛选 |
| POST | `/api/admin/sites/{project}/review` | moderation:write,status、reason;封禁 / 拒绝会排队暂停运行 |
| GET | `/api/admin/sites/{project}/operations` | 查看暂停 / 恢复任务的实际结果 |
| GET | `/api/admin/integrations` | integrations:write,配置结构与脱敏状态 |
| PUT | `/api/admin/integrations/{kind}` | 配置 enabled、values;密钥加密,空密钥保持原值 |
| POST | `/api/admin/integrations/{kind}/test` | 实际连接测试,结果持久化 |
| POST | `/api/admin/integrations/{kind}/send-test` | SMTP / SMS 显式测试发送,幂等记录;可能产生供应商费用 |
| GET | `/api/admin/integrations/logs`、`/api/admin/integrations/messages` | 连接测试 / 消息发送记录 |
kind:SMTP、ALIYUN_SMS、ALIYUN_ESA、ALIYUN_CDN、ALIYUN_DNS、S3。配置与适配器不等于域名自动开通流程已实现。网站审核状态与实际运行执行状态分别展示;仅审核通过不会伪造“已恢复运行”。
## 项目域名与 HTTPS
| 方法 | 路径 | 行为 |
| --- | --- | --- |
| GET | `/api/projects/{id}/domains` | 本人绑定、TXT 申请、部署根域名与入口目标 |
| POST | `/api/projects/{id}/domains/platform` | serviceId、slug;分配稳定平台域名 |
| POST | `/api/projects/{id}/domains/claims` | hostname;生成二十四小时有效的 TXT 验证申请 |
| POST | `/api/projects/{id}/domains/claims/{claim}/verify` | serviceId;查询匹配 TXT 后创建自定义绑定 |
| POST | `/api/projects/{id}/domains/{domain}/configure` | 购买有效托管、审核通过且已发布服务后,排队配置入口 |
| POST | `/api/projects/{id}/domains/{domain}/primary` | 设置项目主域名 |
| DELETE | `/api/projects/{id}/domains/{domain}` | 请求解绑,保留历史与名称归属 |
| GET | `/api/projects/{id}/domains/{domain}/events` | 本人域名阶段 / 错误记录 |
| GET | `/api/admin/domains?search=` | domains:write;用户 / 项目 / 域名 / 状态列表 |
| GET | `/api/admin/domains/{domain}/events` | domains:write;执行记录 |
| POST | `/api/admin/domains/{domain}/actions` | domains:write;action(CONFIGURE / REMOVE)、reason,审计真实操作者 |
当前为直接 Ingress + DNS + cert-manager 链路。DNS、证书和路由分别核对,不把配置 API 返回成功直接当成 ACTIVE。ESA 边缘自动化还未完成;详细步骤与幂等、归属、证书和单副本边界见 [域名说明](DOMAINS.md)。
## AI 自动核算报告
独立代码验收接口:`GET/PUT /api/admin/code-reviews/config`、`GET/POST /api/admin/tasks/{id}/code-reviews`。仅管理员可见 / 发起,源码快照与模型 / 价格留档,不扣用户钱包,不覆盖历史版本。权限、请求字段、真实构建覆盖及未验证范围见 [独立验收](CODE-REVIEWS.md)。
- `GET /api/admin/tasks/{id}/reports`:`tasks:manage` / `finance:write` / `audit:read`,仅管理员获取每次执行的核算凭据、AI 报告、报告模型成本和错误。普通任务所有者无权限。
- 异常任务距最后更新三分钟后自动核算:只保留已确认消费,释放剩余预算,未知上游费用由平台承担;不自动重放任务。原有人工结算不被覆盖。
- AI 分析与资金事务分开;报告失败不阻塞已完成的预算释放,用户事件不包含内部核算记录。详见 [自动核算](AUTOMATIC-REPORTS.md)。
## 项目对象存储
| 方法 | 路径 | 行为 |
| --- | --- | --- |
| GET | `/api/projects/{id}/storage?page=0&trash=false` | 本人文件,50 条一页、total;summary 包含真实用量、配额和是否已启用存储 |
| POST | `/api/projects/{id}/storage` | multipart/form-data:file、idempotencyKey;最大 25MiB |
| GET | `/api/projects/{id}/storage/{object}/content` | 认证私有下载,强制附件、nosniff、no-store;校验长度与 SHA256 |
| DELETE | `/api/projects/{id}/storage/{object}` | 软删除,保留三十天,期间仍占用空间 |
| POST | `/api/projects/{id}/storage/{object}/restore` | 期限内恢复;开始物理清理后禁止恢复 |
| POST | `/api/projects/{id}/storage/{object}/reconcile` | 请求结束五分钟后核对 S3 对象长度和元数据 SHA256 |
对象键由服务器生成并按项目隔离。上传失败 / 超时不直接认定远端未写入,继续占用配额;核对完整匹配才设为可用。未匹配可移入回收站,待过期删除确认后释放用量。清理 Worker 需显式设置 `STORAGE_WORKER_ENABLED=true`,使用原子租约处理恢复竞态和删除超时重试。预览中不启用自动清理。
## 支持工单
- 用户接口 `GET/POST /api/tickets`、`GET /api/tickets/{id}`、`POST /api/tickets/{id}/actions`、`POST /api/tickets/{id}/read`。仅工单提交者能访问,关联项目必须归其所有。
- 管理接口 `GET /api/admin/tickets`、`GET /api/admin/tickets/agents`、`GET /api/admin/tickets/{id}`、`POST /api/admin/tickets/{id}/actions`。需要 `tickets:manage`,由超级管理员、普通管理员和客服角色获得。
- 列表接受 `status`、`category`、`search`、从 0 开始的 `page`,返回 `items`、`counts`、`hasMore`,每页 25 条。统计基于当前角色可见的全量工单。详情返回 `ticket`、`messages`、`hasOlder`,用最早一条消息的 UUID 作为 `before` 分页,每页 30 条。
- 提交参数为 `requestId`、`subject`、`category`(`AI/HOSTING/BILLING/ACCOUNT/OTHER`)、可选的 `projectId`、`content`。同一个 UUID 和相同参数重试返回原工单。用户最多同时处理 10 条工单,每 24 小时提交上限 20 条。
- 操作参数为 `requestId` 和 `operation`。双方可 `REPLY`、`CLOSE`、`REOPEN`。客服还可 `NOTE`、`ASSIGN`、`PRIORITY`、`RESOLVE`。回复和备注传 `content`,分派传可空的 `assigneeId`,调整优先级传 `priority`(`NORMAL/HIGH/URGENT`)。同一工单上的相同操作可用同一请求 UUID 重试。
- 工单状态为 `WAITING_SUPPORT`、`WAITING_CUSTOMER`、`RESOLVED`、`CLOSED`。客服公开回复后等待用户回复,用户回复后重新进入客服队列。客服备注、分派和优先级仅在管理接口可见。已读接口传详情返回的 `reply_revision` 作为 `revision`,只确认已读取的版本。
+38
View File
@@ -0,0 +1,38 @@
# 架构与实施计划
## 范围与边界
原始需求描述的是八个阶段的商业平台。当前从空目录开始,先交付可验证的控制面基础,不以占位页面或模拟基础设施宣称全部完成。各阶段的验收情况见 TEST-REPORT.md。
## 技术架构
- 用户端 / 管理端:Vue 3、TypeScript、Vite、Pinia、Vue Router,独立布局与路由守卫。
- 控制面:Java 21、Spring Boot 3.5、Spring Security、Bean Validation、JDBC、Flyway。模块化单体,同一数据库事务处理账户、审计和资金。
- PostgreSQL 为事实来源;Redis 存储限流窗口和一次性验证码,Redis 故障时认证关闭而非绕过验证。
- 不透明 Bearer 会话令牌,数据库只保存 SHA-256 摘要;用户端 sessionStorage 保存令牌,关闭标签页后清除。令牌不使用 Cookie 自动发送,因此不依赖 Cookie 认证的 CSRF 豁免。
- 管理角色由后端授权,前端守卫只改善体验。每次请求检查用户当前状态与会话撤销状态。
- AI Worker 和节点 Agent 在后续阶段独立部署。控制面不执行用户 shell,不挂载 Docker Socket。
## 数据设计
V1:users、roles、permissions、role_permissions、user_roles、user_sessions、login_logs、system_settings、admin_operation_logs。
V2:projects。V3:wallets、wallet_ledger、wallet_reservations、ai_providers、ai_models、ai_model_price_versions、ai_tasks、ai_task_messages、ai_task_steps、ai_usage_records。V4:ai_reconciliations。V5:模型当前价格版本指针。
用户 ID / 业务 ID 使用 UUID;会话有到期时间与撤销时间。账户使用 BCrypt,失败登录保留脱敏审计。系统设置采用允许列表,品牌、域名及页脚均从 API 加载。管理员初始化通过环境变量一次性引导,不使用默认密码。
## 分阶段交付
1. 基础:登录注册、一次性图形验证码、限流、账户 / 会话、管理员 RBAC、动态品牌、审计、Compose、测试。
2. 模型与 Agent:加密凭证、协议适配器、价格版本、不可变账本、预算预留、任务状态机、隔离工具执行、测试。
3. 网站运行:项目 / 服务 / 版本,构建 Worker、OCI、K3s 受控部署、日志及探针。
4. 数据库 / 存储:配额、独立凭证、S3、快照、恢复演练。
5. Pages / ESA:先核实账号能力,DNS 所有权、非标准回源端口、证书、蓝绿发布与回滚。
6. 节点 / 高可用:心跳、双探测、可靠 fencing、一致性迁移、RPO / RTO 验证。
7. 商业化:渠道分别适配、签名和金额校验、回调幂等、套餐、通知。
8. 运营 / 安全:细粒度权限、风控、可观测性、备份和故障演练。
## 风险约束
Docker 不等于虚拟机隔离;生产执行不可信代码前必须部署 gVisor / Kata 或同等级隔离并验证网络策略。迁移不能只复制卷,必须协调数据库写入及入口切换。没有凭证和独立测试环境时,不声明 ESA、支付、短信或生产高可用已联调。邮件与短信验证在适配器完成前不提供可启用开关,避免产生可绕过的认证流程。
版本依据:[Spring Boot 3.5 系统要求](https://docs.spring.io/spring-boot/3.5/system-requirements.html)、[Spring Security 密码存储](https://docs.spring.io/spring-security/reference/6.5/features/authentication/password-storage.html)、[Vite 要求](https://vite.dev/guide/)。
+35
View File
@@ -0,0 +1,35 @@
# AI 自动核算与管理员报告
费用核算和独立代码验收已分别实现。代码验收读取实际源码,在独立隔离副本运行检查 / 构建 / 测试,再由独立 AI 会话生成报告;详见 [独立代码验收](CODE-REVIEWS.md)。本文件描述费用流程。
## 用户体验
用户开发页面自动读取项目文件,项目切换时清除旧文件树和编辑内容;AI 执行中及任务变化时刷新目录,但不覆盖正在编辑的文件内容。目录为空会明确说明尚无源码,读取失败另行显示。任务有 Token 消耗,不代表代码已经生成。
模型结束开发前,Worker 从真实沙箱检查非空源码,忽略 `.git`、依赖、构建产物、环境文件与符号链接。没有源码时自动要求模型实际写入文件;连续两次仍无源码就暂停,不能标记完成。扫描不完整且未找到源码时也暂停,不能武断认定空目录。源码存在只证明文件已生成,不代表全部功能或浏览器验收成功。
## 自动核算
已确认 usage 仍按任务价格快照实时结算。异常任务进入 REVIEW_REQUIRED,界面显示“自动核算中”。距最后状态更新至少三分钟后,系统自动关闭异常任务并释放剩余预留,释放执行位;不会自动重放可能已执行的命令或模型请求。
未知 usage / 未确认的供应商费用由平台承担,AI 不得猜测金额追加扣用户钱包。原有人工核对记录和已结算金额保留,不被新报告改写。失败任务的代码不会被删除,可在同一项目重新发起开发。
核算事务与 AI 报告分开:即使报告模型超时或失败,已经完成的预算释放不会回滚,也不会自动重复付费请求。每个任务的每次执行(attempt)只创建一份报告,领取有事务锁,过期报告标记失败并保留凭据。
## 管理员记录与报告
管理员 `/admin/tasks` 选择“核算记录与报告”,查看:
- 已确认用户费用、是否自动释放预算、原有人工结算凭据。
- 实际 usage 记录与当前工作区检查时间、文件数量和大小;不把检查失败当成源码存在。
- AI 对异常原因、已知事实、未知部分与处理建议的中文分析。
- 报告自身模型 usage / 按价格快照计算的成本;这部分由平台承担,不写入用户消费账本。
- 报告失败 / 截断信息和 JSON 下载。
`GET /api/admin/tasks/{id}/reports` 需要 `tasks:manage`、`finance:write` 或 `audit:read`。普通用户即使拥有任务也不能访问,用户任务事件接口过滤 AUTO_SETTLEMENT / MANUAL_SETTLEMENT 内部核算事件。用户仍可查看本人开发日志、已确认消费和任务最终状态。
报告模型使用该任务的供应商 / 模型配置快照,禁止工具调用,只读取核算凭据和文件元信息,不执行项目代码。每份最多 1536 输出 Token,调用超时最多 45 秒;每日最多为前 100 份记录调用 AI,单份预计成本不得超过平台配置价格计算的 1 元。超额只保留系统核算记录,不阻塞预算释放。AI 的文字不参与钱包金额决策。
DeepSeek 官方接口的 `deepseek-flash` / `deepseek-v4-pro` 在输出上限不超过 8192 Token 时显式发送 `thinking.type=disabled`,开发工具调用和报告请求均适用。真实联调曾出现 1536 个输出 Token 全为 reasoning_tokens、最终报告为空的情况;保留该失败记录,后续调用改为非思考模式,不显示内部思考代替最终报告。其他供应商不附加该字段。依据:[DeepSeek 思考模式文档](https://api-docs.deepseek.com/guides/thinking_mode/)。
生产部署由启用 `app.worker-enabled` 的 Worker 自动运行独立的报告调度线程。预览使用相同真实流程,不依赖手工点击核算。
+13
View File
@@ -0,0 +1,13 @@
# WebUp Cloud 品牌
- 中文:WebUp 云;英文:WebUp Cloud。
- 官网:`webup.run`;用户部署域名目标:`{项目名}.webup.run`。
- 主标语:让创意轻松上线。
- 产品说明:从开发到部署,一站式上线。
- 当前 Logo:`frontend/public/brand/webup-cloud-logo-v1.png`,透明背景 PNG。
- 生成方式:2026-10-31 使用内置 ImageGen,单张原创图形标识生成,无参考图。未安装或调用第三方图片 SDK。
- 管理后台可以更换 Logo / favicon、首页标题、平台页脚与托管网站服务标识。托管标识在下一次发布时注入 HTML 响应,非 HTML 响应不注入。
## 生成提示词
Use case: logo-brand. Asset type: production logomark for a Chinese AI full-stack development and cloud hosting SaaS, WebUp Cloud / WebUp 云, domain webup.run, tagline 让创意轻松上线. Generate ONE distinctive, polished, minimal compact symbol only, no text or wordmark. Concept: a flowing geometric W fused with a soft cloud silhouette and an unmistakable upward movement, using clever negative space. Strong simple silhouette readable as a favicon at 24px. Flat vector-like geometric design, precise curves, refined balanced stroke weight, medium rounded corners. Color palette: rich cobalt blue #3868F5 and one lighter blue #6B9AFF if necessary; mostly one solid cobalt. Centered square composition with modest 8% transparent margin. Entire background genuinely transparent alpha. No background tile, no circle enclosure, no 3D, no shadows, no gradients, no tiny details, no watermark, no extraneous glyphs or letters. Should feel like a contemporary premium developer platform, original rather than copying an existing cloud brand.
+36
View File
@@ -0,0 +1,36 @@
# 独立 AI 代码验收
费用核算与代码验收为两个独立流程。费用报告不代表源码或构建通过;代码验收也不能更改钱包。两类报告均只在管理员 `/admin/tasks` 中展示。
## 实际流程
1. 项目最新一轮开发完成后自动排队。管理员也可说明原因重新验收,重复请求使用幂等键,旧版本保留。
2. 从真实开发工作区导出最多 10MB / 2000 文件的源码快照,计算逐文件 SHA256 和整体指纹;排除环境凭证文件、私钥、符号链接、依赖、Git 和构建产物。
3. 导入全新 UUID 的验收工作区。验收在独立 `platform-reviews` 命名空间的 gVisor Pod 执行,不挂载用户原 PVC、平台凭证或 Kubernetes 服务账户令牌。原工作区不安装依赖,不执行验收构建命令。
4. 运行可信检查器:HTML 解析、本地资源与锚点检查;npm 项目的依赖安装、实际 build / test 脚本;Python 语法检查。记录命令、退出码、超时、输出截断及源码是否被构建修改。
5. 把需求、实际源码样本和真实检查结果交给独立 AI 会话。不给它开发 AI 的对话或工具权限,可以在后台单独选择其他验收模型;默认沿用开发模型但使用全新验收上下文。
6. AI 输出结构化中文报告:需求覆盖、文件 / 行号 / 严重程度 / 问题证据、未验证项。系统规则再约束结论:构建失败、明确缺失需求或 HIGH 问题不能判通过;源码变化为 STALE;浏览器未执行、抽样不全或测试缺失不得判完整通过。
7. 再次检查原项目源码指纹,保留报告和原始检查证据,清理验收 Pod / PVC / NetworkPolicy。清理失败有独立重试,不会删除用户开发命名空间的资源。
## 管理员配置与接口
- `GET /api/admin/code-reviews/config`:查看自动验收开关、可选独立模型和配置版本。
- `PUT /api/admin/code-reviews/config`:`models:write` / `settings:write`;enabled、modelId(null 表示默认模型)、version、reason。乐观版本检查,变更只影响新任务。
- `GET /api/admin/tasks/{task}/code-reviews`:`tasks:manage` / `finance:write` / `audit:read`,查看各版本实际源码指纹、AI 建议、系统结论、检查记录和费用。
- `POST /api/admin/tasks/{task}/code-reviews`:`tasks:manage` / `models:write`;idempotencyKey、reason。管理员明确发起新版本,不覆盖旧报告。自动验收关闭时仍可手动请求。
普通任务所有者无权读取报告或验收配置。接口不返回 Worker 租约、供应商密钥或内部配置快照。全局同时执行一份独立验收,每日最多 100 份,单份模型预计计价上限 1 元;报告费用由平台承担,不写入用户账本。模型配置与价格在排队时快照,后续改配置不影响已排队任务。
## 验收边界
当前独立环境支持静态 HTML 检查、npm 项目和 Python 语法检查。npm 依赖 / 构建 / 测试共用最多 100 秒执行窗口,超时明确标注;非 npm 锁文件、未配置测试和不支持的构建工具显示未验证,不以空命令或模拟结果冒充成功。浏览器、视觉和端到端交互尚未运行时明确标为 NOT_RUN,整体最多 PARTIAL。
源码样本最多 14000 字符,单文件最多 7000 字符;因上下文压缩或抽样而不完整时不能判完整通过。完整快照用于隔离构建,AI 只读取报告标明的样本;构建日志发送 AI 前缩短,完整有界日志保留在管理员凭据中。
## 部署与实际验证
应用 `infra/k8s/review-rbac.yaml`;网关镜像必须包含 `review_tools.py`。本机脚本已集成该资源,按 [本机部署](LOCAL-DEVELOPMENT.md) 重建和部署。独立验收调度在启用 AI Worker 后自动运行。
`scripts/local/smoke-code-review.py` 已通过真实 K3s 检查:快照复制、排除凭证、192KB UTF-8 stdin 传输、独立 gVisor / runsc、HTML 资源检查、未执行浏览器不伪报、原工作区不变、拒绝任意 shell 工具、真实 npm 构建 / 测试成功,以及真实失败构建。报告 `.runtime/local-cluster/code-review-isolation.json`,测试只删除自己生成的随机 UUID 资源。
现有 About 项目已实际生成两版独立 AI 报告:第一版发现缺失区块,修复后第二版无代码问题。系统保留 PARTIAL,明确浏览器和视觉检查未执行;旧问题报告不被覆盖。后台将实际检查 / 退出码单独制表,AI 对构建成功的文字自述不能替代该表。
+42
View File
@@ -0,0 +1,42 @@
# 项目域名与 HTTPS
当前实现直接入口链路:平台域名分配 / 自定义域名 TXT 验证 → 发布版本中的服务 → Kubernetes Ingress → DNS 核对 → cert-manager 证书核对 → ACTIVE。该实现不是 ESA 自动开通链路;ESA 站点、非标准端口回源、缓存规则和边缘证书自动化仍需补齐。真实 DNS / Ingress / 证书签发尚未联调。
## 用户与运营页面
- 用户 `/domains`:平台稳定地址、自定义域名 TXT 记录、验证、配置 / 重试、主域名、解绑与执行日志。
- 管理员 `/admin/domains`:用户 / 项目 / 域名查询、执行日志、按原因重试或解绑,`domains:write` 权限与操作审计。
- 平台前缀为 3–63 位小写字母、数字或中划线,拒绝 admin / api / www 等保留名称。正式地址不会随新版本发布而改变。
- 自定义域名经 IDN 规范化,不接受 URL、端口、IP、路径或通配符。TXT 名称 `_webup-challenge.{域名}`,随机值有效二十四小时。未通过验证不创建绑定,不允许覆盖其他项目。
- 域名解绑后保留绑定历史与名称归属,不把悬空解析直接分配给其他租户;跨租户迁移需人工核对,当前无自动域名转移功能。
## 测试集群准备
1. 部署支持所用网络插件 NetworkPolicy 的 Kubernetes、隔离 RuntimeClass、Ingress 控制器与 cert-manager。
2. 由管理员配置可签发证书的 ClusterIssuer;HTTP-01 / DNS-01 具体挑战方式由该 Issuer 负责。此工程不会猜测 ACME 账户或 DNS 凭证。
3. 部署 `infra/k8s/runtime-rbac.yaml`,重新构建包含 `domain_runtime.py` 的 node-agent 镜像并更新私有网关。
4. 在 `platform-sandboxes` 的 `webup-runtime` ConfigMap 设置 `TLS_ISSUER`(已有 ClusterIssuer 名称)和 `INGRESS_CLASS`(例如 nginx)。网关 Deployment 通过 `RUNTIME_TLS_ISSUER` / `RUNTIME_INGRESS_CLASS` 读取。
5. 配置后端和独立运行 Worker 的 `RUNTIME_URL` / `RUNTIME_TOKEN`;启用 Compose `hosting` profile 或 `RUNTIME_WORKER_ENABLED=true`。令牌使用 Secret,不提交仓库。
6. 在独立管理后台配置部署根域名、项目入口 CNAME 目标,以及阿里云 DNS 凭证、根域名和 TTL。该 CNAME 目标应指向实际 Ingress 入口。
7. 创建项目服务、购买测试套餐、审核网站并成功发布服务,随后配置域名。自定义域名由用户添加 CNAME 或受 DNS 服务商支持的别名解析。
网关镜像固定单进程,示例 Deployment 为单副本;当前域名操作锁不提供多副本分布式一致性保证。不要以该清单宣称多节点高可用已验收。后续多副本支持还需要分布式 fencing 与故障演练。
## 就绪与失败处理
- `VERIFIED`:名称 / 所有权已确认,尚未开通。
- `QUEUED` / `PROVISIONING`:等待或执行配置。
- `WAITING_DNS`:入口已配置,但 DNS 还未指向预期目标。
- `WAITING_TLS`:DNS 已匹配,证书尚未就绪。
- `WAITING_ROUTE`:DNS 和证书已匹配,入口地址或服务 Pod 尚未就绪。
- `ACTIVE`:上述条件全部通过,并每五分钟重新核对。
- `ERROR`:保留具体阶段错误,最多五次自动尝试,之后需手动重试。
- `REMOVING` / `REMOVED`:入口解绑执行中 / 已确认。
证书核对包含目标域名、Secret 名称、当前 observedGeneration 的 Ready 条件和有效期。Ingress 入口需要控制器报告外部地址;自建控制器需正确配置发布地址。工作负载必须有实际 Ready Pod,不能仅凭创建 API 返回成功就视为上线。
平台域名调用阿里云 DNS 时先查询精确主机记录;已有冲突不覆盖。借用已有正确 CNAME 时不取得删除权。新增记录返回 ID 后才登记由本平台创建;创建超时后无法证明归属的记录按外部记录保留,不冒险清理。解绑只删除明确登记且内容仍匹配的记录;AK 身份改变后保留原记录并要求人工核对。删除重试会先检查记录是否已经不存在。
网关为域名操作记录单调 generation,拒绝旧操作重新创建已解绑入口,并通过资源归属标签和 Kubernetes resourceVersion 检查避免覆盖其他资源。外部写入与数据库之间不是分布式事务,执行日志和幂等核对用于恢复部分成功状态。
API 依据:[阿里云 DNS 记录接口](https://help.aliyun.com/en/dns/api-alidns-2015-01-09-overview)、[精确子域名记录查询](https://help.aliyun.com/en/dns/api-alidns-2015-01-09-describesubdomainrecords)。ESA 后续适配依据:[CreateRecord](https://help.aliyun.com/en/edge-security-acceleration/esa/api-esa-2024-09-10-createrecord)、[GetRecord](https://help.aliyun.com/en/edge-security-acceleration/esa/api-esa-2024-09-10-getrecord)。
+66
View File
@@ -0,0 +1,66 @@
# 本机隔离执行部署
2026-10-31 已实际部署并通过隔离验收。预览使用 Windows 上的 Vue / Spring Boot / 独立 H2 文件库,以及专用 WSL2 发行版 `WebUp-Local` 中的 Docker、K3s、gVisor 和私有工具网关。不需要远程服务器或 Docker Desktop,也不修改原有 Ubuntu 发行版。
## 当前入口与状态
- 首页 `http://127.0.0.1:5173/`,用户 AI 开发 `/develop`,管理员 `/admin`。
- 后端 `http://127.0.0.1:8080`,网关 `http://127.0.0.1:8090`(仅回环、需要令牌)。
- 集群节点 `webup-local`;K3s / gVisor 版本与官方制品哈希固定在 `infra/local/versions.json`。
- 平台默认同时开发 2 个项目,预览 Worker 本实例容量 4。管理员 `/admin/tasks` 可改总并发和队列顺序。
- 预览 AI Worker 已启用,实际调用管理员配置的模型。预览余额是测试余额,外部模型供应商仍可能收取真实 API 费用。
- 运行发布 / 域名 Worker 保持关闭;本阶段验证了开发工作区,没有声称公网托管、镜像构建发布或 HTTPS 域名已验收。
## 重启和复验
WSL 空闲时可能停止。保持一个终端运行以下前台命令,直到本地测试结束:
```powershell
wsl -d WebUp-Local -u root --exec sleep infinity
```
K3s 和端口转发由该发行版的 systemd 管理。检查状态:
```powershell
wsl -d WebUp-Local -u root --exec systemctl is-active k3s webup-gateway-forward
wsl -d WebUp-Local -u root --exec k3s kubectl get nodes
```
修改网关源码后,在项目根目录依次执行(第二步导入本地镜像并滚动重启网关):
```powershell
wsl -d WebUp-Local -u root --exec bash '/mnt/k/web dev/webup.run/scripts/local/build-images.sh' '/mnt/k/web dev/webup.run'
wsl -d WebUp-Local -u root --exec bash '/mnt/k/web dev/webup.run/scripts/local/deploy-gateway.sh' '/mnt/k/web dev/webup.run'
wsl -d WebUp-Local -u root --exec python3 '/mnt/k/web dev/webup.run/scripts/local/smoke-cluster.py'
.\scripts\local\enable-preview.ps1
```
`enable-preview.ps1` 要求最近 24 小时真实隔离验收通过,并重新探测网关。它只更新被忽略的本地基础设施配置和预览 reload trigger,不创建后台 Windows 进程,不改用户 / 模型 / 钱包数据。已运行的预览后端重新加载后,可在管理员服务器页面查看 READY 状态。
## 实际验收
真实调用网关并检查 10 项:拒绝无令牌访问、实际查询 Kubernetes、创建 PVC / 写文件、读回、拒绝父路径越界、非 root / 无平台凭证 / 根只读 / 内网阻断 / 公网 HTTPS 可达、请求 gVisor、containerd 实际使用 runsc、每 Pod 512 进程限制、删除工作区 Pod 后文件仍可读。
报告保存于 Linux `/etc/webup-local/smoke-report.json` 和宿主机 `.runtime/local-cluster/smoke-report.json`。验收只操作随机 UUID 的测试项目,不删除用户工作区。开发文件保存在 K3s PVC,前端编辑器与 AI Worker 共用同一网关;没有把用户 shell 命令放在 Windows 宿主机执行。
## PostgreSQL / Redis 真实自动化测试
独立验收已部署 `platform-reviews` 命名空间和受限 RBAC。可运行 `wsl -d WebUp-Local -u root --exec python3 '/mnt/k/web dev/webup.run/scripts/local/smoke-code-review.py'` 复验真实隔离复制和 npm 构建 / 测试;详情见 [代码验收](CODE-REVIEWS.md)。
专用测试容器 `webup-test-postgres` / `webup-test-redis` 已在同一 WSL 发行版部署,分别只映射回环端口 15432 / 16379,Redis 启用密码。测试数据库为 `webup_integration`,与预览 H2 文件库分开。测试会清理该测试数据库中的业务表,不触碰预览中的用户、模型和钱包。
```powershell
wsl -d WebUp-Local -u root --exec python3 '/mnt/k/web dev/webup.run/scripts/local/start-test-services.py'
.\scripts\local\run-real-tests.ps1
wsl -d WebUp-Local -u root --exec python3 '/mnt/k/web dev/webup.run/scripts/local/check-database-persistence.py'
```
该脚本只接受固定的本机测试库 / Redis 地址,从被忽略的 `services.env` 导入环境,并在运行结束后恢复原环境变量。首次部署需要拉取 ECR Public 官方镜像 `public.ecr.aws/docker/library/postgres:17` 与 `public.ecr.aws/docker/library/redis:7.4`。
最新真实 PostgreSQL / Redis 全量测试 100 项通过、无跳过。持久化检查实际重启专用测试 PostgreSQL,非空用户、钱包、账本、任务数据与迁移记录保持一致;预览控制面的 H2 数据库不参与该重启。
## 本地私有文件
`.runtime/` 和 `.tools/` 已被 Git 忽略。网关令牌在 Linux `/etc/webup-local/gateway.env`(0600)与宿主机 `.runtime/local-cluster/gateway.env`;宿主机目录仅当前账户和 SYSTEM 可访问。不要分享这些文件、预览账号文件、数据库文件或 kubeconfig。预览日志只记录任务 ID 和状态,不记录模型密钥。
本地 H2 / 内存短期存储仍属于预览配置。正式域名 DNS / 证书、对象存储与支付另行验收,不能用本次隔离工作区和数据库测试通过代替。
+33
View File
@@ -0,0 +1,33 @@
# 运维与安全说明
## 初始化和使用
先配置 `.env` 再运行 `scripts/start.ps1`。没有默认管理员密码。引导流程锁定已有配置行,检查管理员是否已经存在,在事务中创建用户、角色关联与初始审计。多副本同时启动不会创建多个初始超级管理员。引导邮件与已有普通用户冲突时拒绝启动,防止自动提权。
用户注册后登录。项目页面保存需求、选择技术栈,可编辑和归档。账户页管理显示名称、密码、会话和登录记录。管理员通过单独管理导航管理用户、配置和审计。停用用户会撤销全部会话,不能停用自己或通过普通状态接口停用超级管理员。
## 生产部署前必须完成的工作
当前只交付开发 Compose;后续生产部署需另建配置并在测试环境验证:
- TLS 入口、可信代理清单与真实客户端 IP 的安全传递。当前后端不信任 X-Forwarded-For,Docker 网关下多个用户可能共享一个限流 IP。不要直接打开无限制 forwarded-header 信任。
- PostgreSQL 专用应用账户、最小权限迁移账户、数据库审计权限分离。当前账表审计是应用追加写入,尚未配置数据库级不可修改角色。
- 密钥托管、轮换、访问控制、日志与数据保留策略、可恢复的离线备份。
- Redis 高可用和容量;noeviction 防止验证码和限流键因内存淘汰悄然失效。Redis 不可用时认证不得降级为无验证。
- 会话令牌只能经 HTTPS 发送,禁止缓存 API 响应。sessionStorage 仍需依赖严格防 XSS;此处未使用 HTML 字符串渲染用户内容。
- 用户注册目前只支持图形验证码;邮箱真实性未确认。邮件 / 短信验证与密码找回必须在适配器完成后再开放。
- 图形验证码不是完整反机器人系统;公网运营还需要边界限流、异常检测和账户风控。
- 密码强度与请求限额当前为代码默认值;后台可配置策略是后续事项。
- 尚未实现法律文案管理、细粒度角色授权编辑、会话定时清理、登录日志检索与长期保留任务。
后台审计写入 actor、action、target、ip、变化详情和时间。当前成功变更被审计;权限拒绝、失败操作的独立审计、安全事件中心尚未完成。不要将当前状态作为生产安全验收通过。
## 备份和恢复
`scripts/backup.ps1` 使用 pg_dump 自定义格式,Docker cp 避免 Windows PowerShell 管道破坏二进制备份。覆盖平台 PostgreSQL,不覆盖 S3 对象、容器卷或后续用户项目数据库。备份包含邮箱与密码摘要等敏感数据,需限制访问并进行离线加密。
恢复前先创建**独立测试数据库**,复制 dump 到数据库容器,再使用 `pg_restore --no-owner --no-privileges -U <账户> -d <测试数据库> <文件>`。不能对真实用户生产库盲目执行 `--clean`。验证用户、项目、角色和审计关联完整后,才制定正式维护窗口和生产恢复方案。本次未进行真实 PostgreSQL 备份恢复演练。
## 后续基础设施边界
控制面不挂载 Docker Socket,不执行用户 shell。AI Worker 和 Kubernetes 隔离执行网关已提供,真实隔离集群仍待验收;正式构建发布、节点监控和调度服务尚未实现。不能将后端容器的 Docker 管理权限作为快捷实现。模型供应商已有加密配置和协议适配器;ESA、DNS、支付、SMTP、SMS 尚无适配器或凭证配置;未进行真实外部服务联调。需要对应阶段补充完整适配器、凭证加密、连接测试、错误状态、幂等与测试报告。
+39
View File
@@ -0,0 +1,39 @@
# AI 开发队列与付费优先
## 页面
- 用户 `/develop`:执行环境状态、当前执行 / 排队数量、本人任务名次、付费优先购买、暂停和取消。
- 管理员 `/admin/tasks`:并发上限、优先费价格 / 开关、按原因调整人工优先级、指定下一位执行、费用异常核对。
- 管理员 `/admin/nodes`:执行实例心跳、本实例容量、执行中任务数,以及真实网关健康检查结果。
API 和网站可正常运行,但没有健康 Worker 时不会执行 AI。创建新任务、恢复任务和购买优先权均检查近期 READY 心跳;暂停和取消不依赖 Worker。已存在任务的幂等重放不重复预留预算。
## 调度规则
全局并发设置为 1–64 个项目,默认 2。每个项目同时最多一个活动开发任务。领取任务时对 `ai_queue_config` 单例行加事务锁,统计执行位后按统一顺序领取,多个 Worker 共用该额度。
排序依次为:管理员指定下一位、人工优先级(-100–100,高值先执行)、已购买优先权、提交时间、任务 ID。人工优先级为 0 时使用默认队列;同级按先到先执行。管理员“下一位执行”不抢占正在运行的任务;有空闲执行位时等待真实 Worker 领取,否则保留为下一空闲位的首选任务。该接口不直接把状态伪改为 RUNNING。
降低并发不会杀死运行中的任务,只限制后续领取。租约失效的任务进入 REVIEW_REQUIRED;系统等待至少三分钟,再自动核算已确认费用、关闭异常任务、释放剩余预算和执行位。未知供应商费用由平台承担,不根据 AI 猜测追加用户扣款,也不自动重放不确定的外部操作。核算记录和 AI 报告仅管理员可见,见 [自动核算](AUTOMATIC-REPORTS.md)。
每个 Worker 使用 Java 21 虚拟线程并行处理已领取任务,本实例容量由 `AI_WORKER_CAPACITY` 设置(1–64,默认 4)。实际并行能力同时受平台总并发、健康 Worker 总容量以及供应商 / 隔离集群能力约束。独立心跳调度线程不会被长时间模型调用占用。
## 优先权费用
默认关闭付费优先,管理员启用并设置正数价格后才开放购买。价格以 CNY 计,独立于 AI usage 预算;使用钱包可用余额,不能动用已预留的模型预算。
购买只适用于本人 QUEUED 任务;检查执行环境、价格报价和任务状态后,在一个事务中完成扣费、订单与优先级变更。每个任务只购买一次,记录配置版本和价格快照;重复请求不重复收费,同一幂等键不能用于其他任务。价格变化时要求用户刷新后重新确认。
首次实际开始执行前,取消任务或未开始便结束,会自动把优先费退回钱包,生成独立 PRIORITY_REFUND 账本。开始执行后订单标为 CONSUMED,后续取消不自动退优先费。模型 usage 仍只按实际调用单独结算。管理员调度高于付费优先;优先权不抢占运行中的任务,不承诺固定开始时间或模型产出成功。
购买、领取、开始执行、取消、消费与退费之间的状态更新以事务和任务锁协调。退款必须匹配原始消费金额与业务 ID,并拒绝重复退款。没有可用执行端时不收取新的优先费。
## 网关与 Worker 接入
1. 将已有隔离网关地址写入本地配置的 `SANDBOX_URL`,令牌写 `SANDBOX_TOKEN`;不要在聊天或仓库提交令牌。
2. 网关必须提供受相同令牌保护的 `GET /health/ready` 和工作区工具接口。健康接口会实际查询 Kubernetes API,不只判断进程存活。
3. API 进程与独立 AI Worker 配置同一个数据库、Redis、`APP_ENCRYPTION_KEY` 和隔离网关。API 需要网关来读写文件和导出源码;Worker 需要网关执行工具。
4. 启用 `AI_WORKER_ENABLED=true` 的独立 Worker,或 Compose `ai` profile;按资源设置 `AI_WORKER_CAPACITY`。
5. 在后台服务器页面确认 READY 心跳与容量,再到开发任务运营页面设置平台并发并选择任务。预览默认配置关闭 Worker;本机已经部署真实 WSL2 / K3s / gVisor,并通过被忽略的本地配置启用 Worker,操作见 [本机部署](LOCAL-DEVELOPMENT.md)。
心跳每五秒更新;超过四十五秒未更新视为离线。健康检查异常记为 DEGRADED。启动、停止、探测失败、过期心跳和排队状态会在界面分开显示,不以测试 Mock 替代真实执行端。
+2718
View File
File diff suppressed because it is too large. Load diff
+40
View File
@@ -0,0 +1,40 @@
# WebUp Cloud 私有化商业版方案
## 产品与收费
WebUp Cloud 官网 `webup.run` 提供官方云服务、产品介绍和软件购买入口。私有化商业版面向想经营自己 AI 建站平台的工作室、站长和企业。购买者在自己的服务器部署控制面、隔离开发环境和托管节点,可以使用自己的域名、Logo、页脚、模型供应商、托管套餐及支付商户。方案参考兰空图床公开的一次性授权、买家中心下载安装包和凭授权获取升级的交付路径。[兰空图床官网](https://www.lsky.pro/) · [兰空图床下载流程](https://docs.lsky.pro/guide/getting-started)
| 商品 | 收费方式 | 包含内容 |
| --- | --- | --- |
| 官方云 | 按托管套餐和 AI 用量付费 | WebUp Cloud 运营基础设施,用户直接创建并发布项目 |
| 私有化商业版 | 一次性购买单个生产实例的永久使用权 | 可自定义品牌,首年更新与标准售后,附同一买家的测试实例 |
| 年度维护 | 按需续费 | 新版本下载、迁移指导和售后服务。已获得的版本可继续使用 |
| 企业与代部署 | 单独报价 | 多生产实例、高可用、隔离网络部署、代迁移及约定的响应时间 |
首发价格待定。先用安装、升级与售后演练测出单个客户的平均工时,以首年支持成本、软件交付成本和目标毛利定价。模型调用、计算、存储、域名及短信等供应商费用由各实例运营方按其合同承担。官方云套餐、私有化软件授权、客户站点向终端用户销售的套餐分别建账。
## 买家与站点管理员的流程
1. 官网展示产品能力、支持环境、许可范围、更新期限与可用演示。买家用邮箱注册后下单。确认支付时核对商户、订单号、金额、币种和签名,支付事件重放返回原订单状态。
2. 官方买家中心显示订单、授权实例、升级期限、可用版本和官方售后。先支持通过后台登记线下收款并审计发证,再接入在线支付和自动发证。首单只生成一个授权,重复回调复用同一记录。
3. 买家下载签名发行包,运行安装前检查,配置私有域名、存储和管理员。安装生成稳定的实例 UUID,首次激活绑定生产实例和已验证的管理域名。可通过买家中心申请换绑或迁移,保留变更审计。
4. 运营者在自己的管理后台管理模型、节点、网站审核、套餐及本实例的客服工单。可通过「插件与主题」上传自制工作台工具和品牌配色,保留旧版本供回退。终端用户访问当前站点的账户、项目、工单和已启用工具。买家需要 WebUp Cloud 技术支持时,从官方买家中心使用官方售后工单,携带授权号和版本。
5. 更新前检查依赖和迁移条件,备份数据库、对象存储及加密密钥,先在测试实例验证。更新渠道按授权的升级截止日期及版本发布时间核验。恢复时使用原版本与迁移前备份,演练回滚和数据恢复后再发布。
## 授权与数据边界
- 官方授权服务单独存储买家、软件订单、支付事件、许可、实例绑定、授权历史和版本清单。客户站点继续使用自己的数据库、钱包、模型密钥、项目和工单。官方售后仅获得买家主动提交的脱敏诊断信息。
- 签发采用非对称签名。发行包内只内置验签公钥。授权文件可包含产品、授权号、实例 UUID、许可环境、管理域名、功能权益、签发时间、升级截止时间和密钥版本。生产和测试使用不同实例标记。测试实例恢复真实数据时默认关闭支付与外发通知。
- 永久版允许运行已获版本,授权服务失联时仍可离线验签。新增激活、换绑、后续下载和售后权益由官方服务校验。迁移撤销旧绑定对后续在线操作生效,已签发的离线文件有复制风险;在授权台留档并由商用协议约定实例范围。
- 可选离线客户通过申请文件和签名授权文件激活。授权签发密钥存放于受限签名服务,支持带密钥版本轮换。下载地址短时有效,买家按版本核验发行清单的签名和哈希。运行服务、下载服务及签发服务使用不同凭证。
## 发行包与上线验收
| 阶段 | 交付 | 验收 |
| --- | --- | --- |
| 单机发行 | 版本固定的 Linux Compose 包、环境变量模板、配置向导、安装与备份说明 | 在干净服务器全新安装,完成品牌配置、账户隔离、用户工单、备份恢复和跨版本升级。现有 Compose 作为开发起点 |
| AI 隔离和云托管 | 独立 Kubernetes 配置、隔离网关、受控构建与运行、入口和证书配置 | 真实完成生成、构建、预览、发布、绑定域名、回滚和封禁,复测租户隔离与计量 |
| 官方销售闭环 | 官方商品页、授权后台、买家中心、签名下载及官方售后 | 登记收款或测试支付后发证,验证重复回调、金额错误、掉线、换绑、更新截止及退单后的下载权益 |
| 交付运营 | 发布清单、组件许可清单、脱敏诊断、版本说明和售后分工 | 可重现构建,发布物内无开发预览账号、供应商密钥、客户数据或内部环境文件 |
首发对外承诺以实测交付为准。现有工单已接入 WebUp Cloud 用户端和管理端,可用于客户站点的本地客服。官方销售中心、签名发证及安装包发布属于上表的待实现交付。
+107
View File
@@ -0,0 +1,107 @@
# 实施与测试报告
## 2026-11-06 · 插件与主题
PostgreSQL / Redis 全量 129 项通过,Flyway V24 已应用到本地预览。新增覆盖上传权限、压缩包和清单限制、停用隔离、版本冲突和回退、单主题选择及默认配色恢复。Chromium 通过管理页面实际上传两个示例 ZIP 并启用,验证了文字统计脚本运行、插件无法访问宿主文档或会话存储、插件不能请求平台 API、直接打开框架 URL 被拒绝。首页和用户工作台的浅色与深色配色均验证通过,停用后恢复默认主题。前端生产构建包含可下载文档,Nginx 1.28 配置语法检查通过。
## 2026-11-06 · 支持工单
PostgreSQL 17 / Redis 全量自动化测试共 126 项通过。新增 5 项覆盖工单及项目所有权、客服权限、内部备注与分派隔离、请求重试、状态流转、未读版本、并发创建配额及消息分页,同一组测试在 H2 也通过。Flyway V23 已应用到测试 PostgreSQL 和本地预览 H2。前端 TypeScript 和 Vite 构建通过,已通过原预览账号登录并读取用户及管理员的工单列表。日志见 `.runtime/local-cluster/maven-support-tickets.log` 和 `.runtime/local-cluster/maven-support-tickets-h2.log`。
日期:2026-10-31。此报告描述当前实际状态,不代表完整需求已验收。
## 最新:独立代码验收与费用核算分别运行
最新真实 PostgreSQL / Redis 全量测试 **121 项通过,无失败 / 错误 / 跳过**(Flyway V1–V22),Python 网关 **31 项通过**,前端 TypeScript / Vite 构建通过。日志 `.runtime/local-cluster/maven-code-reviews.log`。测试新增独立模型与价格快照、验收队列幂等 / 全局并发、只读权限、原始开发对话不发送验收模型、模型成本不扣用户钱包、构建失败 / 缺失需求 / HIGH 问题不能通过、源码变化判 STALE、无浏览器最多 PARTIAL、非法报告保留凭据并清理隔离副本。
真实 K3s 验收复制与运行 **13 项通过**:大 UTF-8 stdin 输入、排除凭证文件、快照指纹一致、独立 namespace / gVisor / runsc、HTML 和本地资源检查、明确未运行浏览器、原目录不变、拒绝任意 shell 请求、真实 npm 依赖 / 构建 / Node 测试成功,以及真实失败构建被标为失败。退出后确认 `platform-reviews` 的 Pod / PVC 已清理;没有删除用户开发工作区。原始报告 `.runtime/local-cluster/code-review-isolation.json`。后续新增锚点缺失的单元回归,并已部署到真实网关。
本地示例网站实际运行了两版独立 AI 验收。第一版发现页面结构缺失,修复后再次验收。第二版报告的 AI 建议为 PASS,系统因缺少浏览器和视觉检查给出 PARTIAL。静态页面的构建检查记录为 NOT_APPLICABLE。两版报告和源码指纹均保留,验收模型费用由平台承担。
管理员现在分别查看费用核算记录和代码验收记录,实际检查表明确显示结果与退出码。普通任务所有者无权读取两类内部报告。详细配置、API 和覆盖边界见 [代码验收](CODE-REVIEWS.md)。
## 前轮:源码生成、自动核算与管理员报告
最新全量真实 PostgreSQL / Redis 测试 111 项通过、无跳过,Python 24 项通过,前端 TypeScript / Vite 构建通过。新增测试覆盖空工作区不能完成、模型继续实际写入源码、扫描不完整暂停、检查期间取消、自动核算幂等与释放预算、AI 估算不能改钱包、报告失败不回滚核算、不执行工具、报告调用不扣用户费用、额度耗尽不调用模型、保留既有人工结算,以及普通任务所有者不能读取报告、普通管理员可读、内部事件与租约不泄露。
本地验证保留了历史人工结算和失败报告。在调整官方 DeepSeek 有限输出请求的思考模式后,重新生成示例页面。隔离环境确认 HTML 可解析、样式和外链引用有效,并检查了响应式 CSS。
AI 管理员报告生成成功。核对钱包流水确认报告费用由平台承担,任务结算后释放了预算预留。该轮验证覆盖静态页面文件及结构检查。自动核算规则与权限见 [自动核算说明](AUTOMATIC-REPORTS.md)。
## 已执行
- Java 21(本轮使用 Microsoft OpenJDK 21.0.13)、Maven 3.9.11 下执行 `mvn verify`,编译并打包 Spring Boot 可运行 JAR。
- 身份 / 权限 / 项目集成测试:覆盖注册持久化与重复邮箱、密码摘要、弱密码、注册关闭、服务器图片验证码、成功 / 失败后验证码不可重放、会话撤销、密码变更撤销所有会话、未认证访问、用户 / 管理权限边界、项目及设备所有者隔离、停用账户即时失效、限流错误传播、管理设置审计及非法批量设置的事务回滚。
- H2 PostgreSQL 兼容模式及本机真实 PostgreSQL 17.11 均实际运行 Flyway V1–V21,使用真实 Spring MVC、Security、数据库和事务。业务测试中的短期存储使用 Mock;另有 4 项测试直接连接本机真实 Redis 7.4。
- `npm run build`:Vue TypeScript 检查及 Vite 生产构建通过。
- Vite 本地启动并返回 HTTP 200;在应用浏览器检查窄屏登录页,后端不可用时登录按钮保持禁用并显示错误。未声称浏览器端完成登录或全链路业务测试。
当前扩展测试包括身份 / 权限、模型 API 密钥保护、三协议解析、钱包并发预留、预算结算、任务价格快照、自动核算与报告、Agent 工具循环、超时不重放与取消竞态。最新一次全量 `mvn verify` 在真实 PostgreSQL / Redis 上完成:**111 项通过,0 失败,0 错误,0 跳过**。原始结果见 `backend/target/surefire-reports` 的 JUnit XML,构建日志 `.runtime/local-cluster/maven-task-reports.log`。测试中的模型和其他外部服务仍使用 Mock,真实模型与基础设施测试另见下文。
## 本机基础设施与未执行项
Docker Desktop 的 Linux Engine 最初不可用。随后已建立专用 WSL2 `WebUp-Local`,安装原生 Linux Docker、K3s 和 gVisor,真实构建并部署网关与工作区镜像,完成下文的隔离验收;现已不依赖 Docker Desktop。
因此,本机未完成:
- Compose 全栈启动(当前使用 Windows 预览控制面 + WSL2 隔离集群)。
- 真实 MinIO 读写、备份恢复演练。
- 完整浏览器登录、项目编辑、管理操作及移动端全流程。
已提供可选 Redis 集成测试(默认跳过),以及使用 PostgreSQL 17 / Redis 7.4 临时服务的 GitHub Actions。工作流尚未在远程运行,不能把“已提供 CI”当成“CI 已通过”。手动运行真实服务测试需在一次性测试数据库上设置 `TEST_DATABASE_URL`、`TEST_DATABASE_USER`、`TEST_DATABASE_PASSWORD`,并设置 `RUN_REDIS_TESTS=true`。禁止指向生产数据库:测试会删除本平台身份和项目表的数据。
## 阶段状态
| 阶段 | 当前状态 |
| --- | --- |
| 1 基础 | 身份、图形验证码、RBAC 基础、配置、审计已实现;真实基础设施验收待完成;邮箱 / 短信验证、密码找回与角色授权编辑尚未实现 |
| 2 模型与 Agent | 供应商 / 模型 / 加密 / 三协议适配、钱包 / 预留 / 账本、任务状态机与 Worker、工具网关已实现;本机真实模型调用和隔离工具已联通;完整生成交付、自动探测、SSE、浏览器测试、视觉附件待完成 |
| 3 项目运行 | 开发工作区已通过真实 K3s / gVisor / PVC 验收;Git / 源码、OCI 配置、发布队列 / 回滚、K8s 健康切流等已编码;用户镜像构建流水线、托管发布和域名预览联调未完成 |
| 4 数据与存储 | S3 配置与上传 / 下载 / 用量 / 回收站 / 恢复 / 清理租约 / 异常核对已编码和 Mock 测试;真实 MinIO、用户数据库 / 卷 / 备份恢复待完成 |
| 5 Pages / ESA | 平台 / 自定义域名、TXT 验证、直接 Ingress / DNS / 证书队列与运营接口已编码和 Mock 测试;ESA / CDN 配置及连接适配器已编码,边缘回源 / 缓存 / 流量业务仍待实现与联调 |
| 6 多节点 / 高可用 | 控制面真实指标、K8s 节点信息、指标缺失状态、RBAC 清单已编码;自动迁移、故障隔离、恢复演练待完成 |
| 7 商业化 | 钱包与托管月度套餐、凭证加密、SMTP / 阿里云 SMS 适配器及管理测试接口已编码;支付回调 / 优惠 / 身份验证流程未完成,真实收付款和消息发送未验收 |
| 8 运营与安全 | 独立后台、运营统计图表和表格、用户 / 网站审核与封禁任务、配置和审计已编码;完整风控、监控告警和安全验收未完成 |
## 发现并修复
初次后端测试发现:跨类直接读取事务代理对象字段导致 JdbcTemplate 为空。改为通过代理方法访问服务依赖后,重新运行测试通过。不存在跳过失败用例或将 Mock 联调标为真实成功的处理。
## 本轮新增测试与验证边界
2026-10-31 本轮结果:快速 H2 测试 96 项通过、当时 2 项 Redis 测试跳过;补充真实 Redis 并发 / 到期、源码检查、自动核算与报告测试后,在真实 PostgreSQL / Redis 上全量运行 **111 项 Java 测试全部通过,无跳过**。**24 项 Python 网关与运行清单测试通过。** Java 21 下 `mvnw verify` 完成打包,前端 `npm run build` 通过。此前基础 / ai / hosting profile 的 Compose 静态校验通过。
新增调度测试 13 项:多线程同时领取不超过总并发、同一 Worker 的两次模型调用确实重叠执行、人工 / 付费 / FIFO 排序、管理员指定下一位不抢占运行任务、降低并发保留现有任务、购买并发幂等、取消与开始之间的退费边界、购买 / 领取竞态、过时报价与离线 / 越权拒绝、预算与优先费分账、未确认外部调用保留执行位、管理员权限与本人名次隔离。模型与隔离网关使用 Mock,不能作为真实集群验收。
新增执行环境测试覆盖无 Worker 不预留预算、状态接口认证、失效 / 停止 / 异常心跳、远程 Worker 可接受任务、离线仍可取消释放资金、网关真实探测结果决定心跳,以及实例列表权限。域名测试覆盖平台稳定绑定、自定义 TXT 验证、过期 / 越权、主域名唯一、DNS / 证书 / 路由独立门槛、旧租约拒绝、封禁禁止开通、借用记录不删除、AK 身份变化不删除原记录与管理员审计。
新增存储测试覆盖真实 MVC 多段上传与私有下载、跨项目 / 跨用户拒绝、内容类型幂等冲突、上传超时仍占配额、元数据匹配才恢复可用、缺失对象不虚假成功、清理与恢复竞态、清理失败保留用量及重试、下载完整性。S3 网关使用 Mock,没有访问真实 Bucket。集成与审核测试覆盖密钥加密、留空保留密钥、真实适配器结果记录、封禁阻止发布并排队暂停、解封不伪造运行已恢复。
- Java 单元与集成测试通过;使用真实 Spring Security / JDBC / 事务与 H2,供应商和隔离执行服务使用 Mock。Worker 工具循环测试会走任务领取、消息持久化、usage 入账、工具返回与预算释放,但不会访问外部模型或真实 Kubernetes。
- Python 网关测试 **24 项通过**:受控文件工具的 UTF-8 写读、父路径越界拒绝、读取大小限制、源码 ZIP;模拟 Kubernetes API 的隔离 / 发布 / 品牌注入配置;网关就绪认证与真实查询分支、域名 generation 拒绝、归属保护、证书代际 / 域名 / 有效期与删除幂等;健康检查 RBAC、exec 原始 JSON 保留 / stderr 分离、UTF-8 输出限额和非零 / 未知退出状态;新增非空源码检查、依赖与环境文件排除。没有在宿主机运行用户生成命令。
- 前端 TypeScript / Vite 生产构建再次通过,新增模型、钱包、AI 开发与任务运营页面均使用真实 API。
- Compose 配置静态校验通过;Gateway / 工作区镜像已在 WSL2 原生 Docker 构建并导入 K3s。真实 Pod 执行、网络隔离与 PVC 跨 Pod 重建持久化已通过下述验收;Compose 全栈与用户服务发布仍未验收。
- 测试发现并修复 usage 入库列数错误;随后补充当前价格版本指针,避免按事务时间排序选择错价,并防止引用中的供应商地址 / 协议变更影响历史任务的凭证发送。
- 新增取消竞态保护:模型调用期间取消后,已产生费用会结算,但不开始新的工具操作。输出达到 Token 上限进入 PAUSED,不能当成正常完成。
- Kubernetes / gVisor 依据:[NetworkPolicy](https://kubernetes.io/docs/concepts/services-networking/network-policies/)、[Restricted Pod Security](https://kubernetes.io/docs/concepts/security/pod-security-standards/)、[gVisor containerd](https://gvisor.dev/docs/user_guide/containerd/quick_start/)。集群安全配置必须通过实际测试,不能仅以清单存在验收。
## 本轮真实本机隔离验收
运行 `scripts/local/smoke-cluster.py`,10 项检查全部通过:未认证拒绝、真实 Kubernetes 健康查询、PVC 创建与写文件、读回、路径越界拒绝、非 root / 无平台凭证 / 根只读 / 内网阻断 / 公网 HTTPS、gVisor RuntimeClass、containerd 实际 runsc、512 进程上限、工作区 Pod 删除重建后文件仍可读。原始报告在 `.runtime/local-cluster/smoke-report.json`;部署与复验见 [本机部署](LOCAL-DEVELOPMENT.md)。
真实调用 `/runtime/nodes` 也已通过:节点 webup-local 为 READY,返回实际 CPU / 内存容量、Kubelet / containerd 版本和 metrics-server 用量,`metricsAvailable=true`。管理员服务器页面所需节点信息已接入实际网关。
首次真实联调发现 Python Kubernetes SDK 默认 exec 预加载会把 JSON 转为 Python 字典表示,文件实际写入成功但响应解析失败。已改用独立 ApiClient 和非预加载 WebSocket,分别收集 stdout / stderr,验证退出码并限制输出;真实隔离验收随后通过。
预览已接入真实网关并启用 AI Worker,认证 API 实际返回 READY / 1 个 Worker / 容量 4。原排队任务被领取,实际调用用户配置的模型,并通过真实工具完成目录读取和 shell 命令(退出码 0)。随后另一次模型调用的工具 JSON 无效,旧版本将任务置为 REVIEW_REQUIRED,已确认账本消费 ¥0.0058,另一次调用费用尚需核对;没有伪报生成成功、重放请求或擅自填入未知费用。
本次增加 3 项 Java 回归测试:无效工具参数仍保留有效 usage、兼容对象参数规范化、错误反馈不调用沙箱;以及工具输出截断时结算本次 usage、逐个记录未执行结果并暂停,禁止执行残缺工具或自动继续消费。首次新增用例把完成状态误写为 SUCCEEDED,实际业务状态为 COMPLETED;修正断言后通过。该修复覆盖未来调用,不能恢复旧版本未保留的上游 usage。
## 真实 PostgreSQL / Redis 验收
专用 WSL2 中的 PostgreSQL 17.11 / Redis 7.4 映射回环端口 15432 / 16379,数据库 `webup_integration` 与预览 H2 数据分开。使用 `scripts/local/run-real-tests.ps1` 执行全部 100 项 Java 测试并打包通过;实际应用 Flyway 20 个迁移,验证事务、并发预留 / 领取、唯一约束、权限、钱包与业务持久化。供应商、S3 等外部依赖仍为 Mock。
Redis 4 项真实测试通过:GETDEL 顺序单次消费、Lua 限流与 TTL、16 个并发消费者只有一个拿到验证码、实际到期后验证码无效且限流窗口恢复。Redis 启用密码,测试支持本地私有 `TEST_REDIS_PASSWORD`,未使用 Mock。
`check-database-persistence.py` 实际重启专用 PostgreSQL 容器,重启前后逐表比较行数与 JSON 数据摘要,并验证 20 条迁移历史。非空用户 / 钱包 / 账本 / 任务数据完全一致;该次快照 usage 表为空,未把空表一致当成非空 usage 重启验证。报告 `.runtime/local-cluster/postgres-persistence.json`。未重启或改动预览后端的 H2 数据。