guanwei 1.2.4 → 1.2.6

package/README.en.md

@@ -78,25 +78,28 @@ AI:       multi-LLM adapter (OpenAI-compatible & Google formats; DeepSeek / Gemi
 
 ```bash
 npm i -g guanwei
-guanwei setup --key YOUR_API_KEY
+guanwei setup
 guanwei start
 ```
 
 Open http://localhost:5173 . Upgrade: `guanwei update`. Stop: `guanwei stop`.
 
+> 💡 **Configure your key (`guanwei setup`)**: interactive wizard — pick a provider, paste your key (not echoed), stored in `~/.guanwei/.env` (readable only by you). Or one-shot: `guanwei setup --key YOUR_API_KEY` (5 providers, see below).
+> 💡 **No key? Still works**: `guanwei start` runs fine — charting, demos and classics all work; only AI reading needs a key (the page shows a config hint).
+
 ### ⚡ Docker one-liner (no Node needed, easiest)
 
 ```bash
-docker run -d --name guanwei -p 5173:80 -e LLM_DEEPSEEK_KEY=YOUR_API_KEY ghcr.io/rubyccll/guanwei:latest
+docker run -d --name guanwei -p 5173:80 -e LLM_DEEPSEEK_KEY=sk-YOUR_REAL_KEY ghcr.io/rubyccll/guanwei:latest
 ```
 
-Open http://localhost:5173 . Stop: `docker stop guanwei`. Other providers: `-e LLM_PROVIDER=gemini -e LLM_GEMINI_KEY=...` (deepseek / gemini / groq / qwen / custom).
+Open http://localhost:5173 . Stop: `docker stop guanwei`. Other providers: `-e LLM_PROVIDER=gemini -e LLM_GEMINI_KEY=sk-YOUR_REAL_KEY` (deepseek / gemini / groq / qwen / custom).
 
 ### ⚡ Source installer (fallback)
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/RubyCcll/guanwei/main/scripts/install.sh | bash
-guanwei setup --key YOUR_API_KEY
+guanwei setup
 guanwei start
 ```
 
@@ -140,7 +143,8 @@ The script installs dependencies, writes `server/.env` (key stays local), and st
 ```bash
 npm link        # install globally (or use ./scripts/guanwei directly)
 
-guanwei setup --key sk-xxx   # configure API key (interactive: guanwei setup)
+guanwei setup                # configure API key (interactive wizard)
+guanwei setup --key sk-xxx   # one-shot (replace sk-xxx with your real key)
 guanwei start                # start (--docker for containers)
 guanwei doctor               # environment self-check (Node/config/ports/deps/version)
 guanwei update               # update to latest (git incremental merge; local config preserved)

package/README.md

@@ -93,25 +93,28 @@ AI 层：多 LLM 适配（OpenAI 兼容 / Google 格式，DeepSeek / Gemini / Gr
 
 ```bash
 npm i -g guanwei
-guanwei setup --key 你的APIKey
+guanwei setup
 guanwei start
 ```
 
 打开 http://localhost:5173 即用。国内用户自动走 npmmirror 加速；升级：`guanwei update`。停止：`guanwei stop`。
 
+> 💡 **配置 Key（`guanwei setup`）**：交互式引导——选服务商 → 粘贴 Key（不回显），写进 `~/.guanwei/.env` 仅本机可读。也可一步到位：`guanwei setup --key sk-你的真实Key`（DeepSeek 等 5 家任选，Key 申请见下文）。
+> 💡 **不配 Key 也能启动**：`guanwei start` 直接跑，排盘/演示/古籍全部可用，仅 AI 解读不可用（页面会提示配置入口）。
+
 ### ⚡ 方式二：Docker 一行启动（免装 Node，最省心）
 
 ```bash
-docker run -d --name guanwei -p 5173:80 -e LLM_DEEPSEEK_KEY=你的APIKey ghcr.io/rubyccll/guanwei:latest
+docker run -d --name guanwei -p 5173:80 -e LLM_DEEPSEEK_KEY=sk-你的真实Key ghcr.io/rubyccll/guanwei:latest
 ```
 
-打开 http://localhost:5173 即用。停止：`docker stop guanwei`。其他服务商：`-e LLM_PROVIDER=gemini -e LLM_GEMINI_KEY=你的Key`（deepseek / gemini / groq / qwen / custom 均可）。
+打开 http://localhost:5173 即用。停止：`docker stop guanwei`。其他服务商：`-e LLM_PROVIDER=gemini -e LLM_GEMINI_KEY=sk-你的真实Key`（deepseek / gemini / groq / qwen / custom 均可）。
 
 ### ⚡ 方式三：curl 一键安装（源码方式，备用）
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/RubyCcll/guanwei/main/scripts/install.sh | bash
-guanwei setup --key 你的APIKey
+guanwei setup
 guanwei start
 ```
 
@@ -126,7 +129,7 @@ guanwei start
 点击按钮 → 云端环境自动装好依赖 → 终端执行：
 
 ```bash
-./scripts/setup.sh --key 你的APIKey
+./scripts/setup.sh --key sk-你的真实Key
 ```
 
 #### 方式五：Docker Compose（多容器）
@@ -134,7 +137,7 @@ guanwei start
 预构建镜像已发布到 GitHub Container Registry（amd64 + arm64 双平台）：
 
 ```bash
-./scripts/setup.sh --docker --key 你的APIKey   # 自动配置 + 拉取镜像 + 启动
+./scripts/setup.sh --docker --key sk-你的真实Key   # 自动配置 + 拉取镜像 + 启动
 # 或手动：
 #   cp server/.env.example server/.env   （填入 Key）
 #   docker compose up -d                  （自动拉取 GHCR 镜像）
@@ -147,7 +150,8 @@ guanwei start
 #### 方式六：本地 Node.js（≥ 22.5，需 node:sqlite 内置支持）
 
 ```bash
-./scripts/setup.sh --key 你的APIKey   # 交互式可直接运行 ./scripts/setup.sh
+./scripts/setup.sh                    # 交互式：选服务商 + 输入 Key
+# 或一步到位：./scripts/setup.sh --key sk-你的真实Key
 ```
 
 脚本自动：安装依赖 → 写入 `server/.env`（Key 仅存本地）→ 启动前后端。打开 http://localhost:5173 → 缘起页注册 → 九术页起占 → 召 AI 成报告。
@@ -159,7 +163,8 @@ guanwei start
 npm link
 # ② 不想全局安装？直接使用：./scripts/guanwei <命令>
 
-guanwei setup --key sk-xxx   # 配置 API Key（交互式：guanwei setup）
+guanwei setup                # 配置 API Key（交互式：选服务商 + 粘贴 Key）
+guanwei setup --key sk-xxx   # 一步到位（sk-xxx 换成你的真实 Key）
 guanwei start                # 启动（--docker 用容器）
 guanwei doctor               # 环境自检（Node/配置/占位密钥/端口/依赖/版本）
 guanwei update               # 更新到最新版（git 增量合并，.env 等本地配置不覆盖）

package/package.json

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

package/server/src/data/db.json

@@ -6432,6 +6432,318 @@
       "samples": [],
       "records": [],
       "token": "a4c67d7d395086f836811508e9199d007487ad24f3f92db0492163bcef07ed44"
+    },
+    {
+      "username": "联调4720",
+      "passHash": "scrypt$3f5d6299295a3a9918e0416c626bcdef$67f7d06f536c2dcf312ea7ae15b50565916f97e200b904476ab96b3c4ef5d9fe3bd093734fbcf27a271682972fff3b9dff32bf02c671c496c338cf0df82c95a3",
+      "createdAt": 1787978014815,
+      "profile": {
+        "birthDate": "1996-09-09",
+        "birthHourIndex": 5,
+        "gender": "男",
+        "location": null
+      },
+      "samples": [],
+      "records": [
+        {
+          "artId": "bazi",
+          "createdAt": 1,
+          "result": {
+            "dayGZ": "壬申"
+          }
+        }
+      ],
+      "token": "5acff6d1a3d077e1043b57bfd0e7b197b554e6895c3c5ad7aab91eb6c5e055dd"
+    },
+    {
+      "username": "鉴权5000",
+      "passHash": "scrypt$4abab2b41008b858f4f0d57083e0b00d$1af134638bb86539577633e60e77bae1c31125bc041f7ff372877984ab00c9b917c2b52fb9b2a283a2e0a57576471e879f625ea44bbdd0ab525b95ea15ffaaa9",
+      "createdAt": 1787978015042,
+      "profile": {
+        "birthDate": "1999-01-01"
+      },
+      "samples": [],
+      "records": [],
+      "token": "c483184079880cc968ca31607701d9dcdafbe6a97302345a5193ab6ac4c97a18"
+    },
+    {
+      "username": "他人5082",
+      "passHash": "scrypt$51321757c7a676de91f379a812ad7bce$e1750ec9daf3b5f19c8213c9fb51420746986cbabd9ecd507d805fc957942996011489220975566de6782616b614212a7755f507ae31d21946864c6e3458650b",
+      "createdAt": 1787978015129,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "07a612c8e5de4e8982efedd10cb9084b446bb3c5ece03bfcd3392a075997b7b0"
+    },
+    {
+      "username": "登鉴5138",
+      "passHash": "scrypt$10094d85734baa9671128fc10c5e8d83$ec7d061fac3f81efb0ef5b1e8297372ef9165f2221492185a6d19a8158bf0677ea664d935fb4ccd7742f0e3c1b5caaab715c860b5c4c8fd0c1368ea53eb21521",
+      "createdAt": 1787978015183,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "a6c1d3612e8f34e83d735e8dddaa5fadba775fa79b85f2cfc1e0720063b92ad9"
+    },
+    {
+      "username": "占位5233",
+      "passHash": "scrypt$86ce84ec1222fe4888a75d2b19324c83$0316d5c423c34fa2bcf1088670bbbe35617ee2f501451af7ec8e3bad915eda8ed49cadf9836f2127b0b72f043a0d24ba9bad598b79d3ff19f451e89a7e8b33d2",
+      "createdAt": 1787978015236,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "267fd8173c3e0536a66bf6432ca5b07ed8e87e044be6c33edf41b3d55abb0748"
+    },
+    {
+      "username": "甲5347",
+      "passHash": "scrypt$bb2c32b24b75e33435eb8c6910f5ab2f$20a91be38796f811012fb1879a4ffb9da462049340994af0df150206388879c1d34e76ca7b9b9024870b42311062b2c3915c7102e55e74a31a819892f268f0f0",
+      "createdAt": 1787978015397,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "ba249a40c22dbc4c5a6b9068d3ebc3e1d1afe5212821dbffd0d2b192abf543be"
+    },
+    {
+      "username": "乙5347",
+      "passHash": "scrypt$cfe4fd0384b866b77abed2746d6c882d$c275b3373db1986865e430a392f771e29ed776006d4a7e1a9cef7afe583d81158b0dcb2b86361e863b2fae7273da61d86bbad0c8cadf06eba268b22c14f667b1",
+      "createdAt": 1787978015472,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "e12f06635335a7d365dca3dc5f4d3c87f0c0c0989199100e3cd40fb1f51b563b"
+    },
+    {
+      "username": "联调1046",
+      "passHash": "scrypt$9212a84cc0e275b12e32aba82966195f$943a2029711318c91a68ca0e9f3393a128d753b6ad00936ad9f08d14ae0abf033b6b0b808f2defecc2f284bccdbe7da6e4624ce15e75c7eb670d6d8486380dd1",
+      "createdAt": 1787978041147,
+      "profile": {
+        "birthDate": "1996-09-09",
+        "birthHourIndex": 5,
+        "gender": "男",
+        "location": null
+      },
+      "samples": [],
+      "records": [
+        {
+          "artId": "bazi",
+          "createdAt": 1,
+          "result": {
+            "dayGZ": "壬申"
+          }
+        }
+      ],
+      "token": "2b8f9cdcbeae6f368028bbdac2171f56975d41542f440b98faea51ea24348eb0"
+    },
+    {
+      "username": "鉴权1356",
+      "passHash": "scrypt$d1c69b653d8c59bac97a60cc564a2812$85b38421cc4a8449957a390bea3fafedbec2f1426a3c59a17fd60045a67ea25840da9c03e49159012a18bae42ea997ad98b585a504cfaf1dba41d159c91a6a88",
+      "createdAt": 1787978041401,
+      "profile": {
+        "birthDate": "1999-01-01"
+      },
+      "samples": [],
+      "records": [],
+      "token": "03ae064372554daa1be328b5f435b7a9aa9f5eb5f57d3fdf0e1775de05a42c8f"
+    },
+    {
+      "username": "他人1429",
+      "passHash": "scrypt$d0ff8f7529212c5927843355c53719da$1fa2d57a5ee18124b8752222f5587a02372060f2b2b9faba6ed4ff0b77a90b0c7178f9d182dedd9c8ae300dd20ce1e5f7ec79f368ed21610f5f8756ff2d7da35",
+      "createdAt": 1787978041467,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "611138970fc695680cbaf59a4e85dc1a121c58aad81a540111b6f548eb607784"
+    },
+    {
+      "username": "登鉴1475",
+      "passHash": "scrypt$faf0d6d072301c2442a54f390f47e6f3$6f5727c69f5164d10607626e7197c4a0532945f9f881a7f9d8526188b106836c274d1e9d0552d4d8b4ae3c2627014fdc7423ee99a81bb61049845ab6e96d8738",
+      "createdAt": 1787978041510,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "c315d05d8d733976a00e43a89b62fc324251051badbb2ab7921b14f168bc2fe8"
+    },
+    {
+      "username": "占位1550",
+      "passHash": "scrypt$95a6313661da39b23785cc467c9e6acc$d40d094d3f0c92b9d3382640fcc073163aa45aaaaa13dc3adc8379e25239e4aae0ff4a8f85c4115e8ad50e72fff0a317aaeb648c8e5b5fff76b93a08e5f8b38d",
+      "createdAt": 1787978041553,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "0ad1e0459861b10d3c123ff5e8738ab688b31c258b418f19a11ed55ccc83b365"
+    },
+    {
+      "username": "甲1644",
+      "passHash": "scrypt$b2815193a5c0e718566dabbb6beb7387$3663b9efe26b1e02eac7b5130920f6709847853d06b80857ff09205b9757d1ce9534d8da5bd440763f45c16cbdd1078099c8f76e9e6672fd039b35936cb813d3",
+      "createdAt": 1787978041683,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "586d4a39d7b0cd5d4a4196ccacf8225459e94c9b07947988640e41ebfb0fe390"
+    },
+    {
+      "username": "乙1644",
+      "passHash": "scrypt$f22718cad108fe66f6c2e822a15d80b2$833ac84622054781111427dff13b732a5fb2f68f01fa95d7176ac3d6c168bd4a314e566e232b6481fa77e431e6feae1f0878ebfe909a0c062429247fb6e9ee49",
+      "createdAt": 1787978041733,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "957487f61daf7c8a30abe1a6d8c7f18615a60ad1f482b41603a847bf4aa02af8"
+    },
+    {
+      "username": "联调6337",
+      "passHash": "scrypt$fcef8e2d049d828cab00f5b1b9cf053c$b20f9074d8ed06dd77e5deb3e9d1c28e4c26723b05ca6187a77291b9d9038517ee6e631793e58a0ccf8e0aef376c2c8ef02b04129cb8894e254fc0f096336e53",
+      "createdAt": 1787978356427,
+      "profile": {
+        "birthDate": "1996-09-09",
+        "birthHourIndex": 5,
+        "gender": "男",
+        "location": null
+      },
+      "samples": [],
+      "records": [
+        {
+          "artId": "bazi",
+          "createdAt": 1,
+          "result": {
+            "dayGZ": "壬申"
+          }
+        }
+      ],
+      "token": "15fe37911eb72bdd3413a2b7d53d76b2bfca8a291bc86e30e585039afbc3e41f"
+    },
+    {
+      "username": "鉴权6593",
+      "passHash": "scrypt$d4b72586266f6cdfdcc3d3df931237cb$266366a33eb554b0a7de60ec40e789ab79c1fc56c1ac527433fe5fc011636835c195b28455c20dcd093f4b3303acb27b0725b2d6d72c29b269b219123e4d657e",
+      "createdAt": 1787978356640,
+      "profile": {
+        "birthDate": "1999-01-01"
+      },
+      "samples": [],
+      "records": [],
+      "token": "c231ef749f16bbbc7a0151c9f8e8dbc86186b5753da5f8995eee3a7e380c2481"
+    },
+    {
+      "username": "他人6686",
+      "passHash": "scrypt$e5470b328196d5d1415ee56400bac2f0$a576a32b0b6b291d86cc0bc3a83a19f37e97486b115377b73151b8fffc729876a07c007926d03c639ebcea658b884f90a3158954f3b2b30605ec634bff559851",
+      "createdAt": 1787978356737,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "e7dd53f31c29fa2c30bb841869d763af228e52292953bd5abd4287d78d2d1724"
+    },
+    {
+      "username": "登鉴6745",
+      "passHash": "scrypt$4da27f576a9599933671d16b866091dc$03e88d3b0f93798d28f05cc8e0b85d8c4fe8169fdcb46568dd256cf31b0a9818774a301168003debeb510bb59c0b8fec98e6b9765e211ce5b8829545bd040fda",
+      "createdAt": 1787978356786,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "694f7a690a4d32223db3fd97c256f1470fe049df9db80173c76c3ed623ce94cd"
+    },
+    {
+      "username": "占位6827",
+      "passHash": "scrypt$80c0cefc6c6bc40375c8ff1ad3369c40$30bb233c5b96843e6e709c2646cd7d65aff34303b32d63900ad7ea8e09f89f5f2a1015341020ff8d42df7d70f384b4d8e55a4e205210d1f7cce0bfa16663b25d",
+      "createdAt": 1787978356830,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "2d0c81cada1b36571ae965d4180a662cbef68dbb57fa883013510c2eb919cd44"
+    },
+    {
+      "username": "甲6931",
+      "passHash": "scrypt$2ad4bbc5c40b6f30c63cd4d4b8ec58df$c274784703f2a487efc4e58906de2e75951f711fe31eda2debf94663ee79813c71f1204e712e057cf6c23d625af4576927ea7b9f2cfbb8624be6ac346dc88229",
+      "createdAt": 1787978356982,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "4ef92e4f752f2798fde75c28f4a0672b2d3c848daccd282dd76e0e1f63678f45"
+    },
+    {
+      "username": "乙6931",
+      "passHash": "scrypt$37e3af2e80433cf81d8a6a4d321be293$33c3f391de987f6eb956a49985becc2f64d7c0a73f6af99920261c5ffab90ef624ad61f0bd14a74ba33da3ad6f55f748580ef7730e839602a3c44f502106e88c",
+      "createdAt": 1787978357032,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "99a53431fb95f7cd5049ac926cd974145dd47d358b8d9f4aae2837940a42a9ea"
+    },
+    {
+      "username": "联调0387",
+      "passHash": "scrypt$573da827e7a7ddf9089438980d3da419$05ebb4314470f3f5951ce1e5db8b83bff360c3c40f187220c3d9786e35cc2dbd57143aedc0de6bbdfe8b98c226ab1f154f85e41dfbb7a5e08eaa02ae57f0e52a",
+      "createdAt": 1787978370461,
+      "profile": {
+        "birthDate": "1996-09-09",
+        "birthHourIndex": 5,
+        "gender": "男",
+        "location": null
+      },
+      "samples": [],
+      "records": [
+        {
+          "artId": "bazi",
+          "createdAt": 1,
+          "result": {
+            "dayGZ": "壬申"
+          }
+        }
+      ],
+      "token": "c352a6e5cb4c3f7096d374631c687ec50257a1e82d436b684a4ce624a7650b90"
+    },
+    {
+      "username": "鉴权0656",
+      "passHash": "scrypt$bda3151120b7af6d018dc096b0c7b827$c0dc6f0db7d8d1cab6ea8ee76c22d50d8544d6f6feac721df98624da1975331673b30c5de55aa45b3f28e611ea0d202503a6ee64be40e4394abd5b2bd771e6e7",
+      "createdAt": 1787978370697,
+      "profile": {
+        "birthDate": "1999-01-01"
+      },
+      "samples": [],
+      "records": [],
+      "token": "d4cae222e7c35c80801d47aec4f30bb1098b31d00ae90c7eba00f5c65d50cc70"
+    },
+    {
+      "username": "他人0721",
+      "passHash": "scrypt$add02bd12f43f37226769736b3fe7590$0dc18e701e6158144a37d5b8fb5d1d81bcd9f51a29150190945615abae8595dd0425dc5b59a22da539dc4c33a2e8f2ff2096eacf760bc08ad921494fdf31aa61",
+      "createdAt": 1787978370765,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "fce1afbf5f36c6e6257740106e815ae5910a3ef64b89c6cdaef8e88ee1996dc6"
+    },
+    {
+      "username": "登鉴0774",
+      "passHash": "scrypt$b5a877f90ba174fad21a37f08318e07f$df91de7cc0891704ae083c502fda059977cb3c789dfff9e6d75e3089b8c04980355d2d33d44d795131b0476c0bb958fcfdfb318ea65fe2d81ab56679d4c02661",
+      "createdAt": 1787978370819,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "e5aaa3313c7f72231bf591f2cf4980829ed806d839b4a8d2118580325028a16f"
+    },
+    {
+      "username": "占位0872",
+      "passHash": "scrypt$fadf5b83732b0e4e895e1c9fdd7f66ef$b66960d25301e97b782e7754301a74233503a41eda8585688386b369fea920703cefc983873ac423a17b49cd0264ad113a0b65ef69246d4b93900060c950c3f8",
+      "createdAt": 1787978370874,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "b7098ef1f563769ca96d56ec751bcc51a98328e580cb5cf54922ef847ea68718"
+    },
+    {
+      "username": "甲0985",
+      "passHash": "scrypt$3b2d3f361dcc7eeafad57e353078ed70$8ea67dfb7fc406de4b91f2d96fe7236db06b5242b4d69098933f82edaa9e3f17b77f7948fca14a2782a8e4359a0804e55282a9836127dd145dca21d717c584db",
+      "createdAt": 1787978371046,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "10e168af504dbf81deb5516f2f1c8a08f31ad870c62985621f46055a575fc909"
+    },
+    {
+      "username": "乙0985",
+      "passHash": "scrypt$365a2bae3be185a4320f92bf6a5b4fc8$64e199092f297a2d8bc213a278b0483d7587cfe3e022ae7d4cac9985de1a25ad557390a08fed590f9feb87b599135b0e41b15cf520f3cb8ccba5d1180cb68a49",
+      "createdAt": 1787978371091,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "da86949d87c96659755e15ddc3a511b805cc89524904a3cbeaf7211f8acdc0a0"
     }
   ]
 }

package/server/src/routes/ai.ts

@@ -196,10 +196,12 @@ interface RawReading { summary: string; keyPoints: string[] }
 // ─── Step1 盘面解析缓存 ───
 // 同一 divineId + 同一问题复用同一份盘面解析：多次解读的输入一致 → 输出不再互相矛盾
 // （Step1 每次调用结果都不同是「一会严格一会宽松」的主因之一）
+// 键含日期：prompt 注入了【当前时间 · 事实】，跨日/跨年复用会给出过期的"现在"——按天隔离
 const step1Cache = new Map<string, string>();
 const STEP1_CACHE_MAX = 300;
 async function getStep1(divineId: string, artId: string, question: string, resultRaw: unknown, profile: unknown): Promise<string> {
-  const key = divineId + '|' + (question || '');
+  const day = new Date().toISOString().slice(0, 10);
+  const key = divineId + '|' + day + '|' + (question || '');
   const hit = step1Cache.get(key);
   if (hit) return hit;
   try {

package/server/src/services/promptBuilder.ts

@@ -79,6 +79,14 @@ function hourUnknownNote(profile?: unknown): string {
 }
 
 // 命主已知人生经历 → 解读校准注入（报告须呼应该年份事件、不得与其矛盾）
+// 当前公历时间事实：注入给 AI，防止其自行推算年份（占问类无出生档案，AI 不知道"现在是哪年"）
+function nowFact(): string {
+  const d = new Date();
+  const p = (n: number) => String(n).padStart(2, '0');
+  const week = '日一二三四五六'[d.getDay()];
+  return '【当前时间 · 事实】现在是公历 ' + d.getFullYear() + ' 年 ' + (d.getMonth() + 1) + ' 月 ' + d.getDate() + ' 日 ' + p(d.getHours()) + ':' + p(d.getMinutes()) + '（星期' + week + '）。\n凡涉及年份/日期/时令的表述（如"今年""去年""明年""当下节令"），必须以此为准，不得自行推算或编造年份。';
+}
+
 function lifeEventsNote(profile?: unknown): string {
   const evs: { year: number; text: string }[] = (profile as any)?.lifeEvents;
   if (!Array.isArray(evs) || evs.length === 0) return '';
@@ -166,6 +174,8 @@ export function buildReportMessages(
     '【盘面事实（以下为不可更改的排盘结果，解读必须逐字引用、不得编造）】',
     chartBrief(artId, resultRaw),
     '',
+    nowFact(),
+    '',
     lifeEventsNote(profile),
     '',
     semantic ? '【问题语义分析】' + JSON.stringify(semantic, null, 1) : '',
@@ -213,6 +223,8 @@ export function buildStep1Messages(
     '【盘面事实】',
     chartBrief(artId, resultRaw),
     '',
+    nowFact(),
+    '',
     '请输出盘面解析 json。',
   ].filter(Boolean).join('\n');
   return [
@@ -283,6 +295,8 @@ export function buildStep2Messages(
     '【盘面事实（原始排盘，引用须一致）】',
     chartBrief(artId, resultRaw),
     '',
+    nowFact(),
+    '',
     lifeEventsNote(profile),
     '',
     semantic ? '【问题语义分析】' + JSON.stringify(semantic, null, 1) : '',
@@ -305,6 +319,7 @@ function systemPrompt(artId: string): string {
     '',
     '【语言规范】现代白话，温润克制，不作绝对化断言；引经据典附出处；结尾附免责声明。',
     '输出结构：严格输出合法 json 对象（字段名不可更改）。',
+    nowFact(),
     '【可引古籍】' + (p?.classics || ''),
   ].join('\n');
 }
@@ -321,6 +336,8 @@ export function buildMessages(
     '【排盘结果】',
     JSON.stringify(resultRaw, null, 1),
     '',
+    nowFact(),
+    '',
     semantic ? '【问题语义分析】' + JSON.stringify(semantic, null, 1) : '',
     '',
     '请按语言规范生成解读。',