cardbuddy 0.22.0 → 0.24.0

package/README.md

@@ -49,7 +49,7 @@ npm run preview                 # 本地服务(8787) + 内置编辑器前端 +
 | `src/cards/helloCard/` | 示例卡（`schema.json` + `data.json`，构建期已过校验）——起服务即有卡可看可改 |
 | `skills/` | 随包发布的全量技能库：校验 / 同步 / 保存 / 切图上传 / 建卡管线脚本与工作流文档 |
 | `tools/link-skills.mjs` | `npm run link:skills`：把 `skills/` 链到 Codex / Claude / WorkBuddy 等 AI 工具的项目级技能目录 |
-| `.env.cb` | 共享配置模板（端口、FinMall 远端基址、AI 网关占位；密钥请写 `.env.cb.local`） |
+| `.env.cb` | 共享配置模板（端口、远端基址、AI 网关占位；密钥请写 `.env.cb.local`） |
 | `package.json` | 声明 `cardbuddy` 依赖 + `dev` / `start` / `preview` / `link:skills` 脚本 |
 | `.gitignore` | 只追加缺失条目：`node_modules/`、`.env.cb.local`、`.cache/`、`skills/*/.local/` 等 |
 | `README.md` | 上手说明 |
@@ -173,7 +173,7 @@ agent 侧配置（`cwd` 必须是卡片工程根，读写才落在 `src/cards/`
 | 优先服务，连不上自动降级为直接读写盘（`validate` 跑 Python 校验器） | `card_list` `card_read` `card_write` `card_validate` `card_history` `card_rollback` |
 | 优先服务，降级到包内独立离线渲染器 | `card_screenshot` |
 | **必须**另起一个 `cardbuddy` | `card_render_status` `card_node_models` `card_import_meta` |
-| **必须**另起服务 **且**已登录 FinMall | `card_sync` `card_save` `card_slice_upload` |
+| **必须**另起服务 **且**已登录远端 | `card_sync` `card_save` `card_slice_upload` |
 
 > **别直接跑包内 `dist/vendored/mcp/server.mjs`。** `mcp/client.mjs` 在**模块顶层**就 resolve
 > `CARD_ROOT` / `CARD_API_BASE`（不是每次调用时读），绕过 CLI 包装层时前者会落到包内快照目录
@@ -241,9 +241,9 @@ DSL_DEV_HTTPS=1 cardbuddy
 | --- | --- | --- |
 | `GET /__cards` | 自包含 | 卡片列表 |
 | `GET /__card/:id` | 自包含 | 单卡 schema/data 读取 |
-| `POST /__sync` | 本地服务代理 | 同步远端 FinMall（依赖 `finmall-card-sync` skill） |
-| `POST /__save` | 本地服务代理 | 保存到远端 FinMall（依赖 `finmall-card-sync` skill）；成功后自动截图并上传远端预览图（IDC10014） |
-| `GET /__preview` | 本地服务代理 | 远端取卡（IDC10015，依赖 `finmall-card-sync` skill） |
+| `POST /__sync` | 本地服务代理 | 同步远端（依赖 `platform-card-sync` skill） |
+| `POST /__save` | 本地服务代理 | 保存到远端（依赖 `platform-card-sync` skill）；成功后自动截图并上传远端预览图（IDC10014） |
+| `GET /__preview` | 本地服务代理 | 远端取卡（IDC10015，依赖 `platform-card-sync` skill） |
 | `POST /__validate` | 本地服务代理 | 契约校验（依赖 `dsl-card-generator` skill） |
 | `GET /__render-status/:id` | 自包含 + 内嵌 Vite SSR | 渲染自检 |
 | `GET /__node-models/:id` | 自包含 + 内嵌 Vite SSR | 节点 Property 树模型 |
@@ -256,7 +256,7 @@ DSL_DEV_HTTPS=1 cardbuddy
 | `POST /__code-bridge/:id/heartbeat` | 自包含 | 代码桥：会话心跳（前端 5s 一次） |
 | `DELETE /__code-bridge/:id` | 自包含 | 代码桥：结束会话并删除临时文件 |
 
-> **FinMall 凭据只在本机**：`/__sync` `/__save` `/__preview` 由本地服务代理 FinMall，凭据存于本机 `skills/finmall-card-sync` 与 `.env.cb`，公网前端永不接触。
+> **远端凭据只在本机**：`/__sync` `/__save` `/__preview` 由本地服务代理远端，凭据存于本机 `skills/platform-card-sync` 与 `.env.cb`，公网前端永不接触。
 
 ### VSCode 代码桥（事件面板代码编辑区）
 
@@ -281,9 +281,9 @@ DSL_DEV_HTTPS=1 cardbuddy
 远端读写与校验类端点（`/__sync` `/__save` `/__preview` `/__validate`）以及 AI 助手的
 `skill_read` / `skill_exec`，都通过动态 `import` / 子进程调用技能脚本：
 
-- `finmall-card-sync`（sync / save / preview / 切图上传）
+- `platform-card-sync`（sync / save / preview / 切图上传）
 - `dsl-card-generator`（validate / autofix / 建卡管线）
-- `finmall-session-navigator`（FinMall 登录会话；凭据落 `skills/finmall-session-navigator/.local/credentials.json`）
+- `platform-session-navigator`（远端登录会话；凭据落 `skills/platform-session-navigator/.local/credentials.json`）
 
 **解析顺序**（见 `server/core/skillPaths.js`，全后端统一）：
 
@@ -291,8 +291,8 @@ DSL_DEV_HTTPS=1 cardbuddy
 2. 项目根 `skills/` —— 跑过 `cardbuddy init` 即有，**推荐**：可写（凭据、审计、缓存都落在项目内）、随项目走；
 3. 包内快照 `dist/vendored/skills/` —— 随 npm 包发布的全量技能库，没跑 `init` 也能只读兜底。
 
-> 远端能力（同步 / 保存 / 切图上传）还需要 `.env.cb` 里的 `FINMALL_BASE_URL` 等配置，
-> 以及 `playwright`（本包 optionalDependency，默认会装）与一次 FinMall 登录。
+> 远端能力（同步 / 保存 / 切图上传）还需要 `.env.cb` 里的 `PLATFORM_BASE_URL` 等配置，
+> 以及 `playwright`（本包 optionalDependency，默认会装）与一次远端登录。
 > 写入类文件（凭据等）**永远落项目根**，不会写进 `node_modules`。
 
 ---
@@ -369,7 +369,7 @@ npm run dev:prod
 
 ### 前置条件
 
-- `.env.cb` 已存在（含 `FINMALL_BASE_URL` 远端基址、`CARDBUDDY_DEV_PORT`）。缺它编辑器仍能起，只是远端资源代理会告警。
+- `.env.cb` 已存在（含 `PLATFORM_BASE_URL` 远端基址、`CARDBUDDY_DEV_PORT`）。缺它编辑器仍能起，只是远端资源代理会告警。
 - 首次跑前先 `npm install`（仓库根）。
 
 ### 服务侧单独起（调试 8787 本身）

package/dist/cli.js

@@ -51,7 +51,7 @@ function guardProcessAlive() {
 guardProcessAlive()
 
 // 加载环境（与 skills 同套约定：.env.cb 为共享配置，.env.cb.local 为个人覆盖层）。
-// dotenv 默认不覆盖已存在变量，故主仓库由启动器注入的 DSL_DEV_PORT / FINMALL_BASE_URL 仍优先。
+// dotenv 默认不覆盖已存在变量，故主仓库由启动器注入的 DSL_DEV_PORT / PLATFORM_BASE_URL 仍优先。
 // 同时登记「dotenv 注入值」：server/core/ai-chat.js 据此区分「启动时灌进 process.env 的文件值」
 // 与「真实环境变量覆盖」，否则磁盘上改了 .env.cb.local 也会被启动快照遮挡。
 for (const p of ['.env', '.env.cb', '.env.cb.local']) {
@@ -117,7 +117,7 @@ if (args.includes('--help') || args.includes('-h')) {
                  本命令自身不起服务，工具按依赖分档：route_input / scaffold / add_component 纯本地；
                  list / read / write / validate / history / rollback 降级为直接读写盘；screenshot
                  降级到包内离线渲染器；render_status / node_models / import_meta 必须另起一个
-                 cardbuddy；sync / save / slice_upload 还必须已登录 FinMall。
+                 cardbuddy；sync / save / slice_upload 还必须已登录远端。
   --version, -v  打印版本号后退出（只输出版本号，便于脚本取值）
   --help, -h     显示帮助
 

package/dist/config.js

@@ -59,10 +59,10 @@ export function loadConfig(env = process.env) {
   //   退回原生 EADDRINUSE 行为。
   const takeover = String(env.DSL_DEV_PORT_TAKEOVER || 'auto').toLowerCase()
   const portTakeover = ['auto', 'force', 'off'].includes(takeover) ? takeover : 'auto'
-  // FinMall 远端站点基址：资源代理（createAssetProxyMiddleware）回源用。
-  // 由 .env.cb 的 FINMALL_BASE_URL 经启动器（tools/dev.mjs / prod-preview.mjs）
+  // 远端站点基址：资源代理（createAssetProxyMiddleware）回源用。
+  // 由 .env.cb 的 PLATFORM_BASE_URL 经启动器（tools/dev.mjs / prod-preview.mjs）
   // 注入到本进程 env；缺省空串表示不回源（/minio 等只走占位图兜底）。
-  const upstream = env.FINMALL_BASE_URL || ''
+  const upstream = env.PLATFORM_BASE_URL || ''
 
   // 包内「迷你仓库快照」根：build.mjs 把 SSR 运行时、server/core、tools、mcp、全量 skills
   // 按仓库原布局内联到 dist/vendored/ 下，使快照内的相对 import（如 ai-chat.js 的

package/dist/init.js

@@ -6,7 +6,7 @@
  *   src/cards/helloCard/      示例卡（schema.json + data.json，构建期已过校验）—— 起服务即有卡可看
  *   skills/                   随包发布的技能库全量释放：/__validate、/__sync、/__save、切图上传
  *                             与 AI 的 skill_read / skill_exec 都按「项目根 skills/ 优先」解析，
- *                             释放后既跑得快也写得了（FinMall 凭据落在项目内，不进 node_modules）
+ *                             释放后既跑得快也写得了（远端凭据落在项目内，不进 node_modules）
  *   tools/link-skills.mjs     把 skills/ 链到 Codex / Claude / WorkBuddy 等 AI 工具的项目级技能目录
  *   .env.cb                   共享配置模板（端口 / 远端基址 / AI 网关占位；密钥写 .env.cb.local）
  *   package.json              声明 cardbuddy 依赖与 dev / preview / mcp / link:skills 脚本
@@ -30,16 +30,16 @@ const SAMPLE_CARD_ID = 'helloCard'
 
 /** 模板 .env.cb：只放非机密的共享配置，密钥类一律注释占位（个人覆盖写 .env.cb.local） */
 const ENV_TEMPLATE = `# CardBuddy 本地开发服务配置（共享层，可入库）
-# 个人机密（AI_API_KEY / FinMall 凭据等）请写 .env.cb.local，它覆盖本文件且不入库。
+# 个人机密（AI_API_KEY / 远端凭据等）请写 .env.cb.local，它覆盖本文件且不入库。
 
 # cardbuddy 本地服务端口（单一真值；编辑器前端也读它）
 CARDBUDDY_CARD_PORT=8787
 
-# FinMall 远端站点基址（资源代理回源 / 同步 / 保存 / 切图上传用）
-FINMALL_BASE_URL=https://uat-pkg.finmall.com
-FINMALL_APP_ID=100001
-FINMALL_WORKSPACE_ID=dev
-# Chrome 远程调试端口（复用已登录的 FinMall 会话）
+# 远端站点基址（资源代理回源 / 同步 / 保存 / 切图上传用）
+PLATFORM_BASE_URL=https://uat-pkg.finmall.com
+PLATFORM_APP_ID=100001
+PLATFORM_WORKSPACE_ID=dev
+# Chrome 远程调试端口（复用已登录的远端会话）
 CARDBUDDY_CDP_PORT=9222
 
 # ---- AI 开发助手（自带网关，OpenAI 兼容 /chat/completions）----
@@ -70,7 +70,7 @@ const GITIGNORE_ENTRIES = [
   'node_modules/',
   '.env.cb.local',
   '.env.local',
-  '.env.finmall.local',
+  '.env.platform.local',
   '.cache/',
   '.local/',
   'skills/*/.local/',
@@ -210,7 +210,7 @@ npx cardbuddy skills upgrade --dry-run  # 先看会动哪些文件（四类：
 \`\`\`
 
 该命令**只动 \`skills/\`**，绝不碰 \`.env.cb\` / \`package.json\` / \`README.md\`
-（那得用 \`init --force\`，有冲掉端口 / FinMall 配置 / AI 网关占位的风险）。
+（那得用 \`init --force\`，有冲掉端口 / 远端配置 / AI 网关占位的风险）。
 
 ## 把卡片工具挂给外部 AI agent（MCP，可选）
 
@@ -241,7 +241,7 @@ npx cardbuddy skills upgrade --dry-run  # 先看会动哪些文件（四类：
 | 优先服务，连不上自动降级为直接读写盘（\`validate\` 跑 Python 校验器） | \`card_list\` \`card_read\` \`card_write\` \`card_validate\` \`card_history\` \`card_rollback\` |
 | 优先服务，降级到包内独立离线渲染器 | \`card_screenshot\` |
 | **必须**另起一个 \`npm run dev\` | \`card_render_status\` \`card_node_models\` \`card_import_meta\` |
-| **必须**另起服务 **且**已登录 FinMall | \`card_sync\` \`card_save\` \`card_slice_upload\` |
+| **必须**另起服务 **且**已登录远端 | \`card_sync\` \`card_save\` \`card_slice_upload\` |
 
 \`--mcp\` 会自动把 \`CARD_ROOT\` 指到本工程根、\`CARD_API_BASE\` 指到 \`.env.cb\` 的
 \`CARDBUDDY_CARD_PORT\`（默认 8787）。**别直接跑包内 \`vendored/mcp/server.mjs\`**：那样
@@ -249,11 +249,11 @@ npx cardbuddy skills upgrade --dry-run  # 先看会动哪些文件（四类：
 5180（\`card_render_status\` 直接报 \`dev-server-required\`）。排查时可设
 \`CARDBUDDY_MCP_VERBOSE=1\` 让启动信息打到 stderr。
 
-## FinMall 远端能力（可选）
+## 远端能力（可选）
 
-同步 / 保存 / 切图上传需要已登录的 FinMall 会话与 \`playwright\`
+同步 / 保存 / 切图上传需要已登录的远端会话与 \`playwright\`
 （cardbuddy 的 optionalDependency，装包时默认会装）。凭据只落在本机
-\`skills/finmall-session-navigator/.local/credentials.json\`，已被 .gitignore 忽略。
+\`skills/platform-session-navigator/.local/credentials.json\`，已被 .gitignore 忽略。
 `
 }
 

package/dist/mcp.js

@@ -24,7 +24,7 @@
  * 本地服务没起也能用大部分：route_input / scaffold / add_component 纯本地；list / read / write /
  * validate / history / rollback 降级为直接读写盘（validate 跑 Python 校验器）；screenshot 降级到
  * 包内独立离线渲染器。只有上述 6 个必须另起一个 cardbuddy（sync / save / slice_upload 还需已登录
- * FinMall）。完整分档表见 README「MCP：把 card_* 工具挂给外部 AI agent」一节。
+ * 远端）。完整分档表见 README「MCP：把 card_* 工具挂给外部 AI agent」一节。
  */
 import fs from 'node:fs'
 import { pathToFileURL } from 'node:url'