guanwei 1.1.1 → 1.1.2

package/dist/index.html

@@ -6,7 +6,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>观微 · 玄学问道 —— 九术参详，观微知著</title>
   <meta name="description" content="以纸墨留白为骨，融四柱八字、紫微斗数、奇门遁甲、梅花易数、六爻、大六壬、小六壬、星盘、塔罗九术于一体。观微知著，以术问道。" />
-    <script type="module" crossorigin src="/assets/index-CsOD5rSo.js"></script>
+    <script type="module" crossorigin src="/assets/index-C7ql6zvs.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-DQx62TUr.css">
   </head>
   <body>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "guanwei",
   "private": false,
-  "version": "1.1.1",
+  "version": "1.1.2",
   "type": "module",
   "scripts": {
     "dev": "vite",

package/scripts/release.sh

@@ -1,21 +1,32 @@
 #!/usr/bin/env bash
 # ============================================================
-# 观微发版脚本：升级版本号 → 同步 lockfile → 打 tag → 推送
-# 用法：./scripts/release.sh 1.1.2        （新版本号，不带 v 前缀）
+# 观微发版脚本：升级版本号 → 同步 lockfile → 打 tag → 推送 git → （可选）发布 npm
+# 用法：./scripts/release.sh 1.1.2            仅 git 发版（tag 触发 CI/Release/镜像）
+#       ./scripts/release.sh 1.1.2 --npm      额外发布 npm 包（需先配置 npm 登录）
 # 要求：工作区无未提交改动；CHANGELOG.md 已写好本次版本条目
+# 详见（本地文档）：docs/RELEASE-SOP.md
 # ============================================================
 set -euo pipefail
 cd "$(dirname "$0")/.."
 
 NEW_VER="${1:-}"
+DO_NPM=0
+if [[ "${2:-}" == "--npm" ]]; then DO_NPM=1; fi
 if [[ -z "$NEW_VER" ]] || ! [[ "$NEW_VER" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
-  echo "用法: ./scripts/release.sh <版本号>   例如: ./scripts/release.sh 1.1.2"; exit 1
+  echo "用法: ./scripts/release.sh <版本号> [--npm]   例如: ./scripts/release.sh 1.1.2 --npm"; exit 1
 fi
 
 if [[ -n "$(git status --porcelain)" ]]; then
   echo "⚠️  工作区有未提交改动，先提交或 stash 再发版"; exit 1
 fi
 
+# 0. 发版前必须全量测试通过（后端集成测试会起服务）
+echo "0️⃣  全量测试（npm test）..."
+if ! npm test >/tmp/guanwei-release-test.log 2>&1; then
+  echo "   ❌ 测试未通过，见 /tmp/guanwei-release-test.log"; exit 1
+fi
+echo "   ✅ 测试通过"
+
 echo "1️⃣  更新 package.json / server/package.json -> ${NEW_VER}"
 node -e "
 const fs = require('fs');
@@ -33,10 +44,23 @@ if ! grep -q "^## \[${NEW_VER}\]" CHANGELOG.md; then
   read -rp "   已补好？回车继续: " _
 fi
 
-echo "3️⃣  提交 + 打 tag + 推送"
+echo "3️⃣  提交 + 打 tag + 推送 git"
 git add package.json package-lock.json server/package.json server/package-lock.json CHANGELOG.md
 git commit -m "chore: 版本升级 ${NEW_VER}"
 git tag "v${NEW_VER}"
 git push origin main
 git push origin "v${NEW_VER}"
-echo "🎉 v${NEW_VER} 已推送——CI / Release / 镜像 / Pages 将自动执行"
+echo "   ✅ 已推送——CI / Release / 镜像 / Pages 将自动执行"
+
+if [[ "$DO_NPM" == "1" ]]; then
+  echo "4️⃣  发布 npm（registry 必须是官方源，本机默认 npmmirror 需显式指定）..."
+  # 用本地缓存避免 ~/.npm 写入受限；发布失败不中断后续提示
+  npm publish --registry https://registry.npmjs.org --cache ./.npm-cache || echo "   ⚠️  npm publish 失败——按 docs/RELEASE-SOP.md 第四节排查（2FA/权限/registry）"
+  rm -rf .npm-cache
+  echo "5️⃣  验证线上版本..."
+  npm view guanwei version --registry https://registry.npmjs.org --cache ./.npm-cache 2>/dev/null || true
+  rm -rf .npm-cache
+else
+  echo "（未加 --npm：跳过 npm 发布。如需发布：./scripts/release.sh ${NEW_VER} --npm，或手动 npm publish）"
+fi
+echo "🎉 v${NEW_VER} 发版完成"

package/server/src/data/db.json

@@ -12054,6 +12054,27 @@
           }
         }
       ]
+    },
+    {
+      "username": "联调3661",
+      "passHash": "h7a11ca53",
+      "createdAt": 1787394463725,
+      "profile": {
+        "birthDate": "1996-09-09",
+        "birthHourIndex": 5,
+        "gender": "男",
+        "location": null
+      },
+      "samples": [],
+      "records": [
+        {
+          "artId": "bazi",
+          "createdAt": 1,
+          "result": {
+            "dayGZ": "壬申"
+          }
+        }
+      ]
     }
   ]
 }

package/server/src/routes/ai.ts

@@ -63,6 +63,12 @@ router.post('/interpret', async (req, res) => {
     if (e.message === 'AI_UNCONFIGURED') {
       return res.status(503).json({ error: 'AI_UNCONFIGURED', message: '未配置 AI 服务，请设置 LLM_PROVIDER 与对应 Key' });
     }
+    // 透传服务商 HTTP 错误码（401 Key 无效 / 404 模型不存在 / 429 额度限流 / 5xx 故障等），前端给专门引导
+    const mapped = mapLlmError(e);
+    if (mapped) {
+      console.error('[ai/interpret]', e.message);
+      return res.status(502).json({ error: mapped.code, message: mapped.message });
+    }
     console.error('[ai/interpret]', e);
     res.status(502).json({ error: 'AI_FAILED', message: 'AI 解读暂未应机' });
   }
@@ -141,6 +147,18 @@ router.post('/interpret/stream', async (req, res) => {
       }
       return;
     }
+    // 透传服务商 HTTP 错误码，前端给专门引导
+    const mapped = mapLlmError(e);
+    if (mapped) {
+      console.error('[ai/stream]', e.message);
+      if (res.headersSent) {
+        res.write(`data: ${JSON.stringify({ type: 'error', code: mapped.code, message: mapped.message })}\n\n`);
+        res.end();
+      } else {
+        res.status(502).json({ error: mapped.code, message: mapped.message });
+      }
+      return;
+    }
     console.error('[ai/stream]', e);
     if (res.headersSent) {
       res.write(`data: ${JSON.stringify({ type: 'error', code: 'AI_FAILED', message: 'AI 解读暂未应机' })}\n\n`);
@@ -373,4 +391,23 @@ export function parseSections(text: string): { title: string; content: string }[
   return [{ title: 'AI 参详', content: cleaned || 'AI 未返回内容' }];
 }
 
+// LLM 服务商 HTTP 错误 → 用户可行动的引导码（AI_HTTP_401 等透传给前端）
+export function mapLlmError(e: any): { code: string; message: string } | null {
+  const m = /^AI_HTTP_(\d{3})$/.exec(String(e?.message || ''));
+  if (!m) return null;
+  const status = Number(m[1]);
+  switch (status) {
+    case 401: return { code: 'AI_HTTP_401', message: 'API Key 无效或已过期——请检查 server/.env 中的 Key 是否正确（guanwei doctor 可自检）' };
+    case 403: return { code: 'AI_HTTP_403', message: 'API Key 无权限访问该模型——请检查账号权限或更换模型' };
+    case 404: return { code: 'AI_HTTP_404', message: '模型不存在或模型名有误——请检查 .env 中 LLM_*_MODEL 配置' };
+    case 402:
+    case 429: return { code: 'AI_HTTP_429', message: '请求过于频繁或额度不足——请稍后重试，或检查服务商账户余额' };
+    case 500:
+    case 502:
+    case 503:
+    case 504: return { code: 'AI_HTTP_' + status, message: 'AI 服务商暂时不可用——请稍后重试' };
+    default: return { code: 'AI_HTTP_' + status, message: 'AI 服务响应异常（HTTP ' + status + '）——请稍后重试' };
+  }
+}
+
 export default router;

package/src/pages/ModulePage.tsx

@@ -54,6 +54,23 @@ const PANEL_META: Record<string, { panelTitle: string; btn: string; btnSmall: st
   tarot:      { panelTitle: '问镜', btn: '洗 牌 抽 牌', btnSmall: '静心默问 · 凭心取牌' },
 };
 
+// AI 错误码 → 用户可行动的引导文案（与后端 mapLlmError 呼应；null = 无专门引导）
+function aiErrorHint(code: string): string | null {
+  switch (code) {
+    case 'AI_HTTP_401': return '💡 多半是 API Key 无效或过期：检查服务端 .env 中 Key 是否正确（可运行 guanwei doctor 自检）。';
+    case 'AI_HTTP_403': return '💡 API Key 无权限访问该模型：请检查服务商账号权限，或换用其他服务商 Key。';
+    case 'AI_HTTP_404': return '💡 模型名有误：请检查服务端 .env 中 LLM_*_MODEL 配置与所选服务商是否匹配。';
+    case 'AI_HTTP_429': return '💡 请求过频或额度不足：稍等片刻再试；若常触发，可检查服务商账户余额。';
+    case 'AI_HTTP_500':
+    case 'AI_HTTP_502':
+    case 'AI_HTTP_503':
+    case 'AI_HTTP_504': return '💡 AI 服务商暂时不可用：过一会儿再试即可，无需改动配置。';
+    case 'STREAM_TIMEOUT': return '💡 生成超时：网络波动或服务繁忙，请重试。';
+    case 'NETWORK': return '💡 网络连接异常：请检查本机网络，或确认服务仍在运行（guanwei status）。';
+    default: return null;
+  }
+}
+
 export default function ModulePage() {
   const { artId } = useParams<{ artId: string }>();
   const art = artId ? artById(artId) : undefined;
@@ -289,6 +306,8 @@ export default function ModulePage() {
                           <li>配置后重启服务即可；也可运行 <code style={{ background: 'rgba(0,0,0,.06)', padding: '0 .3rem' }}>guanwei doctor</code> 检查配置</li>
                         </ol>
                       </div>
+                    ) : aiErrorHint(ai.errorCode) ? (
+                      <p className="tiny muted" style={{ marginTop: '.4rem' }}>{aiErrorHint(ai.errorCode)}</p>
                     ) : (
                       <p className="tiny muted">古法规则解读为备，可先依上列排盘自行观照；若为 AI 服务异常，可于服务端检查 LLM 配置后重试。</p>
                     )}