cardbuddy 0.19.3 → 0.21.0

package/README.md

@@ -76,23 +76,23 @@ npm run preview                 # 本地服务(8787) + 内置编辑器前端 +
 
 ```bash
 npm i cardbuddy@latest
-npx cardbuddy skills upgrade            # 新增的 skill 复制进来；本地改过的 shipped skill 默认跳过并黄色警告
-npx cardbuddy skills upgrade --force    # 确认要抛弃本地改动、用包内版本覆盖时
+npx cardbuddy skills upgrade            # 把包内新版技能带进来；覆盖本地改过的 shipped skill 前会先列清单请确认 [y/N]
+npx cardbuddy skills upgrade --force    # 非交互 / 确定要抛弃本地改动，跳过确认直接覆盖
 npx cardbuddy skills upgrade --dry-run  # 先看会动哪些文件（四类统计，不落盘）
 npx cardbuddy skills upgrade --prune    # 额外删除包内已不存在的技能文件（默认保留，防误删你的私有 skill）
 ```
 
 按**内容比对**（非 mtime）分四类处理：
 
-| 分类 | 判定 | 默认行为 | 风险 |
+| 分类 | 判定 | 默认行为 | 说明 |
 | --- | --- | --- | --- |
 | `ADDED` | 包内有、本地无 | 复制 | 无（新 skill） |
 | `SAME` | 两边内容一致 | 跳过 | 无 |
-| `MODIFIED` | 两边都有、内容不同 | **跳过 + 黄色警告列清单** | ⚠️ 你可能改过该 shipped skill；`--force` 才覆盖 |
-| `ORPHAN` | 本地有、包内无 | **保留不删** | ⚠️ 可能是你私有的 skill，或上游已下架该 skill；`--prune` 才删 |
+| `MODIFIED` | 两边都有、内容不同 | **覆盖** | 这正是升级的目的；覆盖前会列出清单请 [y/N] 确认，确认即覆盖、否认即保留本地副本并继续其余 |
+| `ORPHAN` | 本地有、包内无 | **保留不删** | 可能是你私有的 skill，或上游已下架该 skill；`--prune` 才删 |
 
-> `init` 生成的工程已带 `npm run upgrade:skills` 脚本（等价 `cardbuddy skills upgrade`），
-> 要覆盖时用 `npm run upgrade:skills -- --force`。
+> `init` 生成的工程已带 `npm run upgrade:skills` 脚本（等价 `cardbuddy skills upgrade`）。
+> 非交互环境（无 TTY）无法确认覆盖，必须加 `--force` 才升级，否则命令会明确拒绝并提示，不会静默跳过。
 
 同步后写 `skills/.synced-from = 当前装包版本`，供下次 drift 检测（Phase 2：服务启动时可据此提示
 "skills 停留在 X，包已 Y"）。
@@ -242,7 +242,7 @@ 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） |
+| `POST /__save` | 本地服务代理 | 保存到远端 FinMall（依赖 `finmall-card-sync` skill）；成功后自动截图并上传远端预览图（IDC10014） |
 | `GET /__preview` | 本地服务代理 | 远端取卡（IDC10015，依赖 `finmall-card-sync` skill） |
 | `POST /__validate` | 本地服务代理 | 契约校验（依赖 `dsl-card-generator` skill） |
 | `GET /__render-status/:id` | 自包含 + 内嵌 Vite SSR | 渲染自检 |

package/dist/cli.js

@@ -36,6 +36,20 @@ const srcTag =
     ? ''
     : chalk.magenta('▌ ') + chalk.magenta.bold('cardbuddy') + ' '
 
+// 进程级兜底：cardbuddy-dev（8787）是开发者常驻服务，单个请求里的异步异常（如模型网关卡死 /
+// 掉线触发未捕获 rejection）绝不该拖垮整个进程。connect 中间件框架不会 await / catch 异步中间件
+// 抛出的错误，逃逸的 rejection 在 Node ≥15 默认会终止进程。这里统一兜底为「记日志、保活」，确保一个
+// 坏请求 / 一个卡死的模型不会让 8787 端口整体不再响应。
+function guardProcessAlive() {
+  process.on('unhandledRejection', (reason) => {
+    console.error('[cardbuddy] 未处理的 Promise rejection（已兜底，服务继续运行）：', reason && reason.stack ? reason.stack : reason)
+  })
+  process.on('uncaughtException', (err) => {
+    console.error('[cardbuddy] 未捕获异常（已兜底，服务继续运行）：', err && err.stack ? err.stack : err)
+  })
+}
+guardProcessAlive()
+
 // 加载环境（与 skills 同套约定：.env.cb 为共享配置，.env.cb.local 为个人覆盖层）。
 // dotenv 默认不覆盖已存在变量，故主仓库由启动器注入的 DSL_DEV_PORT / FINMALL_BASE_URL 仍优先。
 // 同时登记「dotenv 注入值」：server/core/ai-chat.js 据此区分「启动时灌进 process.env 的文件值」
@@ -67,7 +81,7 @@ if (args.includes('--help') || args.includes('-h')) {
 用法:
   cardbuddy [--preview] [--mcp] [--version] [--help]
   cardbuddy init [目标目录] [--force] [--dry-run] [--no-skills] [--no-sample]
-  cardbuddy skills upgrade [目标目录] [--force] [--dry-run] [--prune] [--strict]
+  cardbuddy skills upgrade [目标目录] [--force] [--dry-run] [--prune]
 
 命令:
   init            生成「立刻能开发调试」的卡片工程最小实例（增量、幂等，不覆盖已存在文件）：
@@ -85,12 +99,12 @@ if (args.includes('--help') || args.includes('-h')) {
                     skills 副本，需显式拉一次。按内容比对分四类：
                       ADDED    包内有、本地无      → 复制（安全）
                       SAME     两边一致            → 跳过
-                      MODIFIED 两边都有、内容不同  → 默认跳过并黄色警告（防丢你改过的 shipped skill）
+                      MODIFIED 两边都有、内容不同  → 默认覆盖（这正是升级目的，会丢弃本地副本改动）
                       ORPHAN   本地有、包内无      → 默认保留不删（可能是你私有的或上游已下架）
-                  --force      覆盖本地已修改的 shipped skill（丢弃你的改动）
+                    覆盖 MODIFIED 前会先展示清单请确认 [y/N]；非交互环境（无 TTY）必须加 --force 才升级。
+                  --force, -y  跳过确认直接覆盖本地已修改的 shipped skill（非交互必备）
                   --dry-run    只报告四类统计，不落盘
                   --prune      额外删除包内已不存在的技能文件（默认保留，防误删你的私有 skill）
-                  --strict     存在未覆盖的 MODIFIED 时返回非 0（便于 CI 感知）
                   典型用法：npm i cardbuddy@latest && npx cardbuddy skills upgrade
 
 选项:
@@ -171,7 +185,7 @@ if (isSkillsUpgrade) {
   const rest = args.slice(marker + 1)
   const flags2 = new Set(rest.filter((a) => a.startsWith('-')))
   const positional2 = rest.filter((a) => !a.startsWith('-'))
-  const knownFlags = ['--force', '--dry-run', '--prune', '--strict']
+  const knownFlags = ['--force', '-y', '--dry-run', '--prune']
   const unknown = [...flags2].filter((f) => !knownFlags.includes(f))
   if (unknown.length) {
     console.error(srcTag + chalk.red(`skills upgrade 不支持的参数：${unknown.join(' ')}（可用：${knownFlags.join(' ')}）`))
@@ -185,10 +199,9 @@ if (isSkillsUpgrade) {
     process.exit(
       await runSkillsUpgrade({
         targetDir: positional2[0] || '.',
-        force: flags2.has('--force'),
+        force: flags2.has('--force') || flags2.has('-y'),
         dryRun: flags2.has('--dry-run'),
         prune: flags2.has('--prune'),
-        strict: flags2.has('--strict'),
         config: loadConfig(),
       })
     )
@@ -201,7 +214,7 @@ if (isSkillsUpgrade) {
 // 仅 `skills` 而无 upgrade：提示唯一合法子命令
 if (subCommand === 'skills' && !isSkillsUpgrade) {
   console.error(
-    srcTag + chalk.red('skills 子命令仅支持 upgrade（用法：cardbuddy skills upgrade [目标目录] [--force] [--dry-run] [--prune] [--strict]）')
+    srcTag + chalk.red('skills 子命令仅支持 upgrade（用法：cardbuddy skills upgrade [目标目录] [--force] [--dry-run] [--prune]）')
   )
   process.exit(1)
 }

package/dist/init.js

@@ -204,9 +204,9 @@ npm run link:skills   # 交互式选择 Codex / Claude / WorkBuddy 等，建立
 装完新版后拉一次：
 
 \`\`\`bash
-npm run upgrade:skills            # 新增的 skill 复制进来；本地改过的 shipped skill 默认跳过并警告
-npx cardbuddy skills upgrade --force   # 确认要抛弃本地改动、用包内版本覆盖时
-npx cardbuddy skills upgrade --dry-run # 先看会动哪些文件（四类：新增/相同/已修改/本地私有）
+npm run upgrade:skills                  # 把包内新版技能带进来；覆盖本地改过的 shipped skill 前会先列清单请确认
+npx cardbuddy skills upgrade --force    # 非交互/确定要抛弃本地改动，跳过确认直接覆盖
+npx cardbuddy skills upgrade --dry-run  # 先看会动哪些文件（四类：新增/相同/已修改/本地私有）
 \`\`\`
 
 该命令**只动 \`skills/\`**，绝不碰 \`.env.cb\` / \`package.json\` / \`README.md\`

package/dist/preview-editor/assets/codeBridgeHeartbeat.worker-Zb_A5RUd.js

@@ -0,0 +1 @@
+(function(){let e=null;self.onmessage=t=>{let n=t.data||{};if(n.type===`start`){e&&clearInterval(e);let t=n.url,r=n.interval||5e3,i=()=>{fetch(t,{method:`POST`,headers:{"Content-Type":`application/json`}}).then(()=>self.postMessage({type:`beat`,ok:!0})).catch(()=>self.postMessage({type:`beat`,ok:!1}))};i(),e=setInterval(i,r)}else n.type===`stop`&&(e&&clearInterval(e),e=null)}})();