docs: 备忘录第28节 v14.0-D积分系统实装说明

Author: zcj220

开发备忘录.md

@@ -3250,3 +3250,43 @@ account_book 蓝本中 app-selector/life/business 三个 page 都设了 `flow: t
 - 指纹缓存（小程序可用 `getCurrentPages()` 直接拿页面路径，比指纹更精确）
 - WXML 树遍历/XPath（CSS 选择器已够用）
 
+## 28. v14.0-D 积分系统实装（2026-03-24）
+
+### 28.1 积分规则
+
+**每10步消耗1积分，向上取整，最少1积分。**
+
+| 功能 | 积分 | 
+|------|------|
+| 蓝本测试（Web） | `ceil(步骤数 / 10)`，最少1分 |
+| AI 蓝本生成 | **0**（用的是用户自己的 AI，不收费） |
+| 探索模式 | **50**（占位符，功能暂未开放） |
+| 分享/查看社区经验 | 0 |
+
+**示例**：44 步蓝本 = `ceil(44/10)` = 5 积分；10 步 = 1 积分；100 步 = 10 积分。
+
+### 28.2 改动文件
+
+| 文件 | 改动 |
+|------|------|
+| `src/auth/service.py` | 新增 `calc_blueprint_credits`, `check_credits`, `deduct_credits`, `get_credits_history` 四个函数 |
+| `src/auth/routes.py` | 新增 `GET /credits/balance` 和 `GET /credits/history` 两个端点 |
+| `src/api/models.py` | `RunBlueprintRequest` 新增可选 `cloud_token` 字段 |
+| `src/api/routes.py` | `run_blueprint_test` 端点：蓝本解析后校验积分（HTTP 402 credits_insufficient），测试完成后自动扣减 |
+| `extension/src/engineClient.ts` | `startBlueprintTest` 支持 `cloud_token` 参数；新增 `cloudGetCreditsBalance`, `cloudGetCreditsHistory` 方法 |
+| `extension/src/sidebarProvider.ts` | 登录状态栏显示剩余积分（低于10分变红）；蓝本测试时自动携带 token；收到积分不足错误时弹出友好提示+充值链接 |
+
+### 28.3 校验逻辑
+
+```
+蓝本测试请求 → 有 cloud_token？
+  → 是：decode token → 算所需积分 → 检查余额
+         → 不够 → HTTP 402，前端显示"积分不足"提示
+         → 够 → 执行测试 → 完成后扣减 → 记流水
+  → 否（游客/本地）→ 直接测试，不扣积分
+```
+
+### 28.4 版本
+
+插件版本 `1.2.9 → 1.3.0`，打包 `testpilot-ai-1.3.0.vsix`（119KB），已推送 `7cb89a5`。
+