guanwei 1.2.7 → 1.3.0

package/README.md

@@ -87,6 +87,33 @@ AI 层：多 LLM 适配（OpenAI 兼容 / Google 格式，DeepSeek / Gemini / Gr
 ③ 历史：GET /api/divine?username= → 档案管理页列表/详情/删除
 ```
 
+## 🤖 开放分发（v1.3.0 · 程序化调用排盘）
+
+排盘能力已封装为可被程序调用的服务（与 Web 端共用 `shared/core` 单一算法副本）：
+
+**MCP Server**（Claude Code / Cursor 等 agent 直接调用）：
+
+```jsonc
+// claude_desktop_config.json
+{ "mcpServers": { "guanwei": { "command": "npx", "args": ["tsx", "packages/guanwei-api/src/mcp.ts"], "cwd": "/你的/guanwei路径" } } }
+```
+
+```text
+agent：用观微排一个 1993-01-23 寅时的八字
+→ 工具 guanwei_chart(art: "bazi", inputs: {...}) → 完整盘面
+```
+
+**REST API**（`packages/guanwei-api`，免费无 Key）：
+
+```bash
+cd packages/guanwei-api && npm start          # http://127.0.0.1:3020/v1
+curl -X POST http://127.0.0.1:3020/v1/chart -H "Content-Type: application/json" \
+  -d '{"art":"liuren","inputs":{"datetime":"2026-08-29T12:00:00"}}'
+curl http://127.0.0.1:3020/v1/arts             # 九术能力清单 + 参数 schema
+```
+
+> 排盘免费（纯计算零 token）；协议风格与未来托管 API 一致（/v1、统一错误码），本地自部署与第三方集成同源。
+
 ## 🚀 快速开始（一行命令）
 
 ### ⚡ 方式一：npm 一行安装（推荐，国内几秒装完）

package/package.json

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

package/server/src/data/db.json

@@ -6486,6 +6486,321 @@
       "records": [],
       "token": "b949c6fcac9b821cc74e1afb5a50acfacebafa21c79d13c61ae892998f33bbe9",
       "tokenExpires": 1791206668608
+    },
+    {
+      "username": "联调5050",
+      "passHash": "scrypt$bf40f5daa6a9a53952861bbd3273ba26$4aa265c117b3a102c07214fa27a66b6b66503c372c9ce1b96cf3eaaa54f0c78f48007a5499132ef03a04cd85033d3bbef0e919cf9aab2526fd87511aa41e22fe",
+      "createdAt": 1788656535121,
+      "profile": {
+        "birthDate": "1996-09-09",
+        "birthHourIndex": 5,
+        "gender": "男",
+        "location": null
+      },
+      "samples": [],
+      "records": [
+        {
+          "artId": "bazi",
+          "createdAt": 1,
+          "result": {
+            "dayGZ": "壬申"
+          }
+        }
+      ],
+      "token": "c3844cd28357240447326062dc92a29b4cbf7bf05cc4f63c4f16d320fb951d32",
+      "tokenExpires": 1791248535194
+    },
+    {
+      "username": "鉴权5280",
+      "passHash": "scrypt$dbe5830db7570713fc95920032f943b5$9ca907f2ba3dc583a46e7d3c56c5e1f71705cee897d87eacd4c391e365d301ea4f083644acdaa2b003919635d5402a3972a7718e94266428d4a7b0bc4cbeb1d2",
+      "createdAt": 1788656535313,
+      "profile": {
+        "birthDate": "1999-01-01"
+      },
+      "samples": [],
+      "records": [],
+      "token": "6db524357e54767784b4d4ad932ea0f45f71ebf96af44467baa6b1e49cf15754",
+      "tokenExpires": 1791248535313
+    },
+    {
+      "username": "他人5332",
+      "passHash": "scrypt$1e363a1711a69d5920a5ed049279b602$82b72356633397200f974327c4aef9b03b561fd6824d90190d1ef83331235bb6b6883ce718d79cd830c128f2fa08814f62f25f0a9cc67e991db9f5ae4816ec5e",
+      "createdAt": 1788656535361,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "c5355a2b7376d9e1b99411f6232631244c53bacdba76ea43b746380947a8cfaf",
+      "tokenExpires": 1791248535361
+    },
+    {
+      "username": "轮换5368",
+      "passHash": "scrypt$4400cc24ab2b9eedaa69f40ae1449826$0a2f9b327a17522775cda6d4e53e5d18545825bc8602a468d5a977a53ac0e49eb9875c4675b1462413244637431d7658976a05f576e62db0b1ef4f276999c9d3",
+      "createdAt": 1788656535400,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "dfee2d9a2d5366361e5fe7b8eacb2cd42c784d286e344bd8150ba4fa6eeaa55d",
+      "tokenExpires": 1791248535437
+    },
+    {
+      "username": "占位5446",
+      "passHash": "scrypt$2d3199a92acffc2830b4cc672f3eb7b2$f3423d89fefe892488a9ab5e04b77724251d7d787446b9242c88566ce70e647e2c0615d44faf300e117df1f774ed7dee6eab78ece955446ac8b7ab8c67f883fa",
+      "createdAt": 1788656535450,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "e8709cd87cde3047be5507d5b2889fa26f40ab140519436ca8d362fd50335e44",
+      "tokenExpires": 1791248535544
+    },
+    {
+      "username": "甲5546",
+      "passHash": "scrypt$2f4f33fd5e453036459ce9cf6e995e49$8c6c0969034ec6a1003643de622f62aa335a0a3974e6e7362cda82a4b5795c0192eb714ba4e7e5917d6aa8a1c1f0d43e9286372270301ac7bed702b4ba0458a3",
+      "createdAt": 1788656535582,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "5aca19f53c1be5d88a38df04bc0e6244c58ac980691c859c123ef3cd91ec7fbb",
+      "tokenExpires": 1791248535582
+    },
+    {
+      "username": "乙5546",
+      "passHash": "scrypt$38ca20b58b781db8c17e77ac14df4a57$35d9423d48bbad4ab75f4677ae12786f574dfa678b9f32bc1cc4c0c20db11f0e67e2608f6b0b71c5a09cf1c97f9851c48466a668431e6b373aad4c180598325d",
+      "createdAt": 1788656535621,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "17e392a444b48f658ca24356da281b2fd31dd1e7eb16fc7978becd58aa238adc",
+      "tokenExpires": 1791248535621
+    },
+    {
+      "username": "列删5668",
+      "passHash": "scrypt$bc34567711d77c2a736756b8cb6a0c3b$1fd68b5244cde889d4351794c24de4352c7f0125ace41680bc6dfe97c743221c8651838ee6437957542b0e85413a1483e73cd0794ab34c20bc5029710c273eac",
+      "createdAt": 1788656535700,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "1d59b0ddc8e830d6521c2985050a2b1d8543983453429f8b00e4f8cdfd945631",
+      "tokenExpires": 1791248535700
+    },
+    {
+      "username": "删乙5668",
+      "passHash": "scrypt$f887a7e8f5a9533ccd07cfd7c63bbc7e$4bb2f63af55c704fbd801b39b3d3c79b9c889076057673b18c85a343bd8350dc5e7160d566a49e031f31ba1c028b8729687325970ceef66cefe0f9e1c51464b9",
+      "createdAt": 1788656535745,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "2b1e8e6fee6b55fa6ec7b34698d5417e0ffdbc558a5dbfbbfaf6a817e089ed77",
+      "tokenExpires": 1791248535745
+    },
+    {
+      "username": "联调7905",
+      "passHash": "scrypt$49cdc5afb9eb173d5455c48d8f31983a$b7b02ad7add1aaf4904a5f797d4a3554d48aed88228b5030d6ce712821c23e0501cfbc5edda8a8b1368294c16e41e7bd9571f74cfa5c670d97703b2e23ad4ae4",
+      "createdAt": 1788656727972,
+      "profile": {
+        "birthDate": "1996-09-09",
+        "birthHourIndex": 5,
+        "gender": "男",
+        "location": null
+      },
+      "samples": [],
+      "records": [
+        {
+          "artId": "bazi",
+          "createdAt": 1,
+          "result": {
+            "dayGZ": "壬申"
+          }
+        }
+      ],
+      "token": "119ed7b0aa8a1e6e123578a26f36f7b931b5ada3a892ddf22eb51f89f2b35604",
+      "tokenExpires": 1791248728039
+    },
+    {
+      "username": "鉴权8122",
+      "passHash": "scrypt$e265380493f0dedfafd8d7f4f90a8cef$9f8397ec3b242ae775fc1004cd5b1f6e98b37a61aa9cd4baf18597e41e5912e38c9b78a09b0d99b07ab671850f433c46c7132d734cc85d41e219e810f2bd050d",
+      "createdAt": 1788656728159,
+      "profile": {
+        "birthDate": "1999-01-01"
+      },
+      "samples": [],
+      "records": [],
+      "token": "8ab64b73eac240b2a0b186f7b2fddc03d8a7061ccf33d6dbbee39cb5dfae1054",
+      "tokenExpires": 1791248728159
+    },
+    {
+      "username": "他人8184",
+      "passHash": "scrypt$176de87bd3ade7866cb88e2f3ff18b4f$241cd9c463ee1c785b916972936c8b8fed9b0355cea0e319712cb05afb19b95a57a7b2d8738a1d19640e9085196a95e868bc5d66fde3675e1f33994e296bf360",
+      "createdAt": 1788656728227,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "b9d5e19626a4b1287c3b99b5b205237c9ef59c76ad5d992e77fe3e4489fe4f27",
+      "tokenExpires": 1791248728227
+    },
+    {
+      "username": "轮换8236",
+      "passHash": "scrypt$c559ee39ef9941f21daca916c9522831$3e1a47d4bfd1e7a9f0a515dda6aa65610fa1f328894a11b6f3fa7da2c41ec037e56c1fff48f04d854351e012dadf91be8493263fceee464bddf1d2e7f791c102",
+      "createdAt": 1788656728270,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "c621eb2629313b1e6aab90a1db26970a620821639c8b2ea03ccfc13c6b047395",
+      "tokenExpires": 1791248728314
+    },
+    {
+      "username": "占位8326",
+      "passHash": "scrypt$6890b74d8a4a8c337986d93fe785417c$eea609b0149683ffdd3734a8949fbbc6b0398cd27813f3dba938d70bd42504007f66ddda73cf591a6620544c7e1f6e9e23e5c2fd2e4f69b60d55c13ffb4276cf",
+      "createdAt": 1788656728335,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "8052720e19f2e6d8e0c1c3a58547faa976302f826dfbf36592859b904ce46595",
+      "tokenExpires": 1791248728428
+    },
+    {
+      "username": "甲8431",
+      "passHash": "scrypt$24331e9122f4668629e7e3f47a66d4cc$96ad98c72e92f3aa20da504657005b2b53a5ce0e4097b15682d922df9d142e5970429e32af4e759220445b803f14237540bf4653c954be3cb1a80d1721a33fdc",
+      "createdAt": 1788656728467,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "f1cb56f7c7a4a5ecc5f22b0c6cf5e4cc211be4bd2757f702e698eaaacf8a4e43",
+      "tokenExpires": 1791248728467
+    },
+    {
+      "username": "乙8431",
+      "passHash": "scrypt$77935be141f0a4f4db438e922a762304$eaed3aaf76450dc406b3edf82327a7b6de108c1162ecf91b4ae0ad136918ee7e9a517ea2c3c00262859319b6b0568bf27f217ca91178c43bfcabaea0d4b4254b",
+      "createdAt": 1788656728511,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "a42c05c0c350a70b63fa9b8ad7d06e44b48b396b1494c4be9838bcc1305907be",
+      "tokenExpires": 1791248728511
+    },
+    {
+      "username": "列删8549",
+      "passHash": "scrypt$b59bb912b8ec3b772d6780f54e633b3c$467f6c4c7dc95d4509cab0e2c5956649b2df650f2fe2a6517bb7e6b9be3233fc649ec339785ad77054aeaec528f1c17a8f2d905c5aab337ca62ffcbbb9e3611b",
+      "createdAt": 1788656728586,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "39d7929d8ae538dc1ab2453f49a0239aa83922f9ca947023648ce25d10bef248",
+      "tokenExpires": 1791248728586
+    },
+    {
+      "username": "删乙8549",
+      "passHash": "scrypt$9370c356aae368426704ad5f63d534c8$1596e1eab509523f1e62899c47bd135a7bc770c7583231d23128e452661a11437bfa10e8c867f174ca621a66213344fc962d4962d8acafef2f4292ee5a6f9768",
+      "createdAt": 1788656728629,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "a195fcc6854001dd3b94aad7aa386ce0a0aeda65189e48029b5e0c7e537e80ef",
+      "tokenExpires": 1791248728629
+    },
+    {
+      "username": "联调0077",
+      "passHash": "scrypt$50edd92f69ee72f3e0a68201f1bc5d20$ffcf31876a36ea9f4b068ff1c65946446015e044d257ed94a19b7b696c0a3b8bfd71344509175632d11309869c7945e2ca2c231890aeec0af55edd5963cb4bcb",
+      "createdAt": 1788656750131,
+      "profile": {
+        "birthDate": "1996-09-09",
+        "birthHourIndex": 5,
+        "gender": "男",
+        "location": null
+      },
+      "samples": [],
+      "records": [
+        {
+          "artId": "bazi",
+          "createdAt": 1,
+          "result": {
+            "dayGZ": "壬申"
+          }
+        }
+      ],
+      "token": "dc26a50c9d65a0f58d1a9b2fb2fd3de2b761370363db2eaa3041544b3dca5397",
+      "tokenExpires": 1791248750189
+    },
+    {
+      "username": "鉴权0281",
+      "passHash": "scrypt$65d1e113491e9f536756c140f8379375$08ac8f2710e866b22b6061062085ef23a0ee8b8898f69f20b59503339481f4374ced21eed1271a187b5c6f084993431ce12c5ff958ad8434aa5d1ccf8655071d",
+      "createdAt": 1788656750313,
+      "profile": {
+        "birthDate": "1999-01-01"
+      },
+      "samples": [],
+      "records": [],
+      "token": "1e068fb703b577ab8bfb6ce010112d39490958c1f0de002ce917e938bb266ba4",
+      "tokenExpires": 1791248750313
+    },
+    {
+      "username": "他人0335",
+      "passHash": "scrypt$2e4bd91e7c5e7eb5ed1624f4ad37f14c$7348e352613dab4da05a5a20ddcf8aa315588c1c3f1a883f9854fc15fe3d59a755b6b9beb48f0d3a464396460bbd7ddc07e8f5d90f8d5fbf2a1c88934e06fc65",
+      "createdAt": 1788656750378,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "cf0c100819459c4f6bcb2b2213cdf55ca478ff7de2610dc3fe297fcde0115d94",
+      "tokenExpires": 1791248750378
+    },
+    {
+      "username": "轮换0384",
+      "passHash": "scrypt$3e6b39a19490d89c279575a1487f7ef6$f9116d02e9c83b349138ca308eb621f7c8206a68adef459c325537ec1ff76497cbc20d83e530313ae69f4ddd0de2aa4c7f97a30341b013173776c5e83b2cad57",
+      "createdAt": 1788656750427,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "d2e0fa44d0787c3dadae450bcfdcc2da8c21828e6cc20431b6781c61fb98a114",
+      "tokenExpires": 1791248750470
+    },
+    {
+      "username": "占位0481",
+      "passHash": "scrypt$70e48545fcf9b358db4ea5d62c5c5e02$23678b8e4e3dc36e6da8600478c681e2f9b10c90abfbbd9fdd45326e223edf038cf0b475947ddafe9d2740498f3db104c08b78d6cc188e5e5c60ffb46c971872",
+      "createdAt": 1788656750485,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "32a48906aba1a838f03d1d53e5e1423212b39f275d8566d1b80c9f05ed6ad561",
+      "tokenExpires": 1791248750571
+    },
+    {
+      "username": "甲0573",
+      "passHash": "scrypt$e7d97388393be7ff74627db02c86ab85$c00f3fbbc7ba849664db2887ee250dd69e34d234588f4c6ae0ff4bdceb256f24fa9b5f0789f81744b7fdde2c346365c5ad4d8bb5ea4c4f655afe2faff99231db",
+      "createdAt": 1788656750606,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "244f43af5d6ac85187ceb43fab5ee96b4e9e4fc6be1dd757e05728f5396b103c",
+      "tokenExpires": 1791248750606
+    },
+    {
+      "username": "乙0573",
+      "passHash": "scrypt$ba780cc69712a61fc6298cc5f66cf4cd$621a99751fee71c830135212bd0a5dadb57dccc0bcc24de321324ae5856bc1f51035ec7efeb4679367e5a5438c0d9b93c982f6173bd62081cd55b6c74ff81a61",
+      "createdAt": 1788656750646,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "6ba780a775f3d206f96edf69bd146d5c3531c52ef3e08d87b56c5230b60accf9",
+      "tokenExpires": 1791248750646
+    },
+    {
+      "username": "列删0677",
+      "passHash": "scrypt$60eebf3efab799e0966cf94d92017e14$340cb6dbe30f22d46e45b82b981849a957f17e35c6fbb0cf6a1cc00261456f6cf4968b49efe43ebbb1c18b043199f56c63591b39990c4afe6135f4748a8606df",
+      "createdAt": 1788656750717,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "403ad44e3d82f0cffb45efb7b32033e548f4cd4ab3d3f6296f48233d5ca4b9be",
+      "tokenExpires": 1791248750717
+    },
+    {
+      "username": "删乙0677",
+      "passHash": "scrypt$a387cfd0aed6e0639c1a77371231856e$ae510248082fdc35243c8d64b71c424f9f98c410574a6eba1ff8de4d55765014740ca3895f0d06bea7b3c0b2ef39cc403622a62379a7be6ec5921f3e735446d7",
+      "createdAt": 1788656750766,
+      "profile": {},
+      "samples": [],
+      "records": [],
+      "token": "c9f8abdca63dd948b07289e84586b6d73f47ed0bab242426a380dbc0a699ba28",
+      "tokenExpires": 1791248750766
     }
   ]
 }

package/server/src/routes/ai.ts

@@ -8,6 +8,8 @@ import { buildMessages, buildReportMessages, buildStep1Messages, buildStep2Messa
 import { chatOnce, chatStream, activeProvider, providerStatus, lastFinishReason } from '../services/llmProvider.js';
 import { getDivination, attachReport, markAiFailed } from '../services/divineStore.js';
 import { verifyRelatives, fixFamilyRelatives } from '../services/relativesCheck.js';
+import { orchestrateZiweiDeep } from '../services/orchestrator.js';
+import { MINGPAN_TEMPLATE } from '../services/promptBuilder.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
@@ -46,7 +48,7 @@ router.get('/providers', (_req, res) => {
 
 // 非流式解读（保底通道）
 router.post('/interpret', async (req, res) => {
-  const { artId, question, divineId, semantic, profile, report, fit, username } = req.body;
+  const { artId, question, divineId, semantic, profile, report, fit, username, orchestrate } = req.body;
   if (!artId) return res.status(400).json({ error: '缺少必要参数' });
   try {
     // 从 SQLite 读排盘数据（v6：不再信任前端直传 resultRaw）
@@ -61,6 +63,23 @@ router.post('/interpret', async (req, res) => {
     } else {
       return res.status(400).json({ error: 'DIVINE_REQUIRED', message: '请先起占（divineId 缺失）' });
     }
+    // 真·多 Agent 编排模式（v1：紫微深度三步链式）
+    if (orchestrate === 'ziwei-deep' && artId === 'ziwei') {
+      const { full } = await orchestrateZiweiDeep(resultRaw, question, MINGPAN_TEMPLATE, (recProfile as any)?.gender || (profile as any)?.gender);
+      const parsed2 = parseReport(full, 'mingpan');
+      const relErrs2 = verifyRelatives('ziwei', resultRaw, parsed2);
+      if (relErrs2.length && relErrs2.length <= 6) {
+        console.warn('[ai] 六亲表述矛盾，定向修正:', relErrs2.join('；'));
+        const fixed2 = await fixFamilyRelatives('ziwei', resultRaw, parsed2, relErrs2);
+        if (fixed2) parsed2.family = fixed2 as any;
+      }
+      if (parsed2.quality === 'ok') {
+        attachReport(divineId, parsed2, 'ok');
+        return res.json({ provider: activeProvider()?.id, report: parsed2, sections: parseSections(full), orchestrated: true });
+      }
+      markAiFailed(divineId, 'ziwei', 'mingpan', '编排质量未达标', full.slice(0, 4000));
+      return res.status(502).json({ error: 'AI_REPORT_INVALID', message: 'AI 输出不符合报告结构，请重试' });
+    }
     // 统一报告模式：两步管线（Step1 盘面解析 → Step2 深度报告），Step1 失败降级单步
     const kind = ['bazi', 'ziwei', 'astrology'].includes(artId) ? 'mingpan' : 'zhanwen';
     let step1Text = '';

package/server/src/routes/divine.ts

@@ -1,15 +1,6 @@
 // 排盘路由：登录用户起占 → 后端引擎计算 → SQLite 入库 → 返回 resultRaw + display
 import { Router } from 'express';
-import { baziCalc } from '../../../shared/core/engine/bazi.js';
-import { ziweiCalc } from '../../../shared/core/engine/ziwei.js';
-import { astrologyCalc } from '../../../shared/core/engine/astrology.js';
-import { qimenCalc } from '../../../shared/core/engine/qimen.js';
-import { meihuaCalc } from '../../../shared/core/engine/meihua.js';
-import { liuyaoCalc } from '../../../shared/core/engine/liuyao.js';
-import { liurenCalc } from '../../../shared/core/engine/liuren.js';
-import { xiaoliurenCalc } from '../../../shared/core/engine/xiaoliuren.js';
-import { tarotDraw } from '../../../shared/core/engine/tarot.js';
-import { allTarotSpreads } from '../../../shared/core/data/tarotSpreads.js';
+import { chartCalc } from '../../../shared/core/engine/chart.js';
 import { createDivination, listDivinations, getDivination, deleteDivination } from '../services/divineStore.js';
 import fs from 'fs';
 import path from 'path';
@@ -91,56 +82,9 @@ router.post('/', (req, res) => {
 
   let resultRaw: unknown;
   try {
-    switch (artId) {
-      case 'bazi': {
-        const i = inputs as any;
-        resultRaw = baziCalc({ y: i.y, m: i.m, d: i.d, hourIndex: i.hourIndex, time: i.time, gender: i.gender, location: i.location });
-        break;
-      }
-      case 'ziwei': {
-        const i = inputs as any;
-        resultRaw = ziweiCalc({ ganzhi: i.ganzhi, month: i.month, day: i.day, hour: i.hour, time: i.time, location: i.location, gender: i.gender, birthYear: i.birthYear });
-        break;
-      }
-      case 'astrology': {
-        const i = inputs as any;
-        resultRaw = astrologyCalc(i.y, i.m, i.d, i.hour || 0, i.min || 0, i.lng, i.lat);
-        break;
-      }
-      case 'qimen': {
-        resultRaw = qimenCalc({ datetime: (inputs as any).datetime || new Date() });
-        break;
-      }
-      case 'meihua': {
-        const i = inputs as any;
-        resultRaw = meihuaCalc({ mode: i.mode || 'time', n1: i.n1, n2: i.n2, n3: i.n3, now: i.now ? new Date(i.now) : undefined });
-        break;
-      }
-      case 'liuyao': {
-        const now = new Date();
-        resultRaw = liuyaoCalc(undefined, { y: now.getFullYear(), m: now.getMonth() + 1, d: now.getDate() });
-        break;
-      }
-      case 'liuren': {
-        resultRaw = liurenCalc((inputs as any).datetime || new Date());
-        break;
-      }
-      case 'xiaoliuren': {
-        const i = inputs as any;
-        resultRaw = xiaoliurenCalc(i.mode || 'time', i.m, i.d, i.h, i.n1, i.n2, i.n3);
-        break;
-      }
-      case 'tarot': {
-        const i = inputs as any;
-        const cards = tarotDraw(Math.max(1, i.n || 3));
-        const spread = allTarotSpreads().find((s: any) => s.id === i.spread) || allTarotSpreads()[0];
-        resultRaw = { spread: spread || { id: 'three', name: '圣三角', description: '', positions: [] }, cards };
-        break;
-      }
-      default:
-        return res.status(400).json({ error: '术无此名' });
-    }
+    resultRaw = chartCalc(artId, inputs);
   } catch (e: any) {
+    if (e?.message?.includes('术无此名')) return res.status(400).json({ error: '术无此名' });
     console.error('[divine] 推演异常:', e);
     return res.status(500).json({ error: 'DIVINE_FAILED', message: '推演未应机' });
   }

package/server/src/services/orchestrator.ts

@@ -0,0 +1,106 @@
+// 真·多 Agent 编排 v1（guanwei-pro 雏形）：
+// 命盘类分步链式推理——Step A 结构解构 → Step B 宫位/星曜专题 → Step C 汇总成报告
+// 与单轮/两步管线区别：每一步独立 LLM 调用、上一步输出作为下一步唯一事实源，步间事实约束
+// 设计：每步 prompt 短而聚焦（降低单次输出幻觉面），关键事实链（chartBrief 十二宫清单）全程逐字引用
+import { chartBrief } from './chartBrief.js';
+import { duanyuPromptBlock } from './duanyu.js';
+import { chatOnce } from './llmProvider.js';
+import { nowFact } from './promptBuilder.js';
+
+export type OrchestrateMode = 'off' | 'ziwei-deep';
+
+// 每步输出 ≤ 400 字的事实性专题，不做人生论断（论断集中在最后汇总步）
+function stepMessages(agentName: string, step: string, brief: string, prior: string[], question?: string): { role: string; content: string }[] {
+  const priorBlock = prior.length
+    ? prior.map((p, i) => `【上一步结论 ${i + 1}】${p}`).join('\n')
+    : '（本步为首步）';
+  const system = [
+    '你是一位' + agentName + '，负责紫微斗数分步推理中的一个环节。',
+    '【最高约束】所有盘面事实（宫位/主星/辅星/四化/亮度）必须逐字引用下方【盘面事实】，不得推算、不得编造。',
+    '【本步任务】' + step,
+    '【输出】只输出一个 JSON 对象 {"points": ["要点1", "要点2", ...]}（3-6 条，每条 ≤80 字，只陈述盘面结构与通义，不做人生论断）。',
+  ].join('\n');
+  const user = [
+    question ? '【所问】' + question + '（仅作背景，本步不回答）' : '',
+    '【盘面事实（不可更改）】',
+    brief,
+    '',
+    nowFact(),
+    '',
+    priorBlock,
+    '',
+    '请输出本步 JSON。',
+  ].filter(Boolean).join('\n');
+  return [
+    { role: 'system', content: system },
+    { role: 'user', content: user },
+  ];
+}
+
+function parsePoints(text: string): string[] {
+  try {
+    const obj = JSON.parse(text);
+    if (Array.isArray(obj.points)) return obj.points.map(String);
+  } catch { /* 非 JSON 时按行切 */ }
+  return text.split('\n').map(l => l.trim()).filter(l => l && !l.startsWith('{') && !l.startsWith('}')).slice(0, 8);
+}
+
+// 汇总步：把前面各步要点 + 盘面事实汇总成完整解读
+function finalMessages(agentName: string, artName: string, schemaTemplate: string, brief: string, steps: string[], question?: string, gender?: string): { role: string; content: string }[] {
+  const stepBlock = steps.map((s, i) => `【分步推演 ${i + 1}】${s}`).join('\n\n');
+  const system = [
+    '你是一位' + agentName + '。',
+    '【任务】基于下面给出的【盘面事实】与【分步推演结论】，生成完整解读报告（JSON）。',
+    '【盘面事实一致性 · 最高约束】所有盘面事实必须与【盘面事实】逐字一致，不得编造或自行推算；六亲/宫位论断须注明盘面依据。',
+    '【质量】内容充实、具体到场景与行为；不作绝对化断言；结尾附免责声明。',
+    '【输出 Schema（字段名不可更改）】' + schemaTemplate,
+  ].join('\n');
+  const user = [
+    '【性别语境】' + (gender || '未录'),
+    question ? '【所问之事】' + question : '',
+    '【盘面事实（不可更改）】',
+    brief,
+    '',
+    stepBlock,
+    '',
+    '请输出完整解读报告 JSON。',
+  ].filter(Boolean).join('\n');
+  return [
+    { role: 'system', content: system },
+    { role: 'user', content: user },
+  ];
+}
+
+/**
+ * 紫微深度编排：三步独立推理后汇总。
+ * 返回 { full, steps }（full 为最终报告文本；steps 为各步要点便于调试/审计）
+ */
+export async function orchestrateZiweiDeep(
+  resultRaw: unknown,
+  question: string | undefined,
+  schemaTemplate: string,
+  gender?: string,
+): Promise<{ full: string; steps: string[] }> {
+  const brief = chartBrief('ziwei', resultRaw);
+  const duanyu = duanyuPromptBlock('ziwei', resultRaw);
+  const steps: string[] = [];
+
+  const STEPS = [
+    '解构命盘骨架：命宫地支/五行局/紫微落宫/身宫/生年四化/主星布局格局，提炼盘的总体气质。',
+    '专题拆解：依十二宫主题（命/兄弟/夫妻/子女/财帛/疾厄/迁移/交友/官禄/田宅/福德/父母）逐宫提炼其星曜组合的侧重，命宫重点。',
+    '行运推演：结合当前大限（年龄段/宫位/主星）与流年宫位，提炼行运主题与关键节点。',
+  ];
+  const prior: string[] = [];
+  for (const [i, step] of STEPS.entries()) {
+    const msgs = stepMessages('紫微斗数专家', step, brief, prior, question);
+    const text = await chatOnce(msgs as any);
+    const pts = parsePoints(text);
+    prior.push(pts.join('；'));
+    steps.push(pts.join('；'));
+    console.log(`[orchestrator] Step ${i + 1} 完成（${pts.length} 要点）`);
+  }
+  // 汇总步：含断语引证
+  const finalSys = finalMessages('紫微斗数专家', '紫微斗数', schemaTemplate, brief + (duanyu ? '\n' + duanyu : ''), prior, question, gender);
+  const full = await chatOnce(finalSys as any);
+  return { full, steps };
+}

package/server/src/services/promptBuilder.ts

@@ -53,7 +53,7 @@ const ZHANWEN_SAMPLE = {
   disclaimer: '免责声明',
   suitability: { suitable: true, note: '适问性说明 2-3 句', suggestion: '换问建议或无' },
 };
-const MINGPAN_TEMPLATE = JSON.stringify(MINGPAN_SAMPLE, null, 2);
+export const MINGPAN_TEMPLATE = JSON.stringify(MINGPAN_SAMPLE, null, 2);
 const ZHANWEN_TEMPLATE = JSON.stringify(ZHANWEN_SAMPLE, null, 2);
 const MINGPAN_ARTS = ['bazi', 'ziwei', 'astrology'];
 
@@ -80,7 +80,7 @@ function hourUnknownNote(profile?: unknown): string {
 
 // 命主已知人生经历 → 解读校准注入（报告须呼应该年份事件、不得与其矛盾）
 // 当前公历时间事实：注入给 AI，防止其自行推算年份（占问类无出生档案，AI 不知道"现在是哪年"）
-function nowFact(): string {
+export function nowFact(): string {
   const d = new Date();
   const p = (n: number) => String(n).padStart(2, '0');
   const week = '日一二三四五六'[d.getDay()];

package/shared/core/engine/chart.ts

@@ -0,0 +1,76 @@
+// 九术排盘统一调度：artId + inputs → resultRaw
+// 唯一算法副本（divine 路由 / packages/guanwei-api / MCP / 未来托管共用，禁止各层另写 switch）
+import { baziCalc } from './bazi.js';
+import { ziweiCalc } from './ziwei.js';
+import { astrologyCalc } from './astrology.js';
+import { qimenCalc } from './qimen.js';
+import { meihuaCalc } from './meihua.js';
+import { liuyaoCalc } from './liuyao.js';
+import { liurenCalc } from './liuren.js';
+import { xiaoliurenCalc } from './xiaoliuren.js';
+import { tarotDraw } from './tarot.js';
+import { allTarotSpreads } from '../data/tarotSpreads.js';
+
+export const CHART_ARTS = ['bazi', 'ziwei', 'astrology', 'qimen', 'meihua', 'liuyao', 'liuren', 'xiaoliuren', 'tarot'] as const;
+export type ChartArtId = typeof CHART_ARTS[number];
+
+/**
+ * 九术排盘（纯函数）：artId + inputs → resultRaw
+ * 抛错：未知术名 / 输入不合法 → Error（调用方转 400）
+ */
+export function chartCalc(artId: string, inputs: any): unknown {
+  switch (artId) {
+    case 'bazi': {
+      const i = inputs || {};
+      if (i.y == null || i.m == null || i.d == null) throw new Error('BaziInput 需 y/m/d');
+      return baziCalc({ y: i.y, m: i.m, d: i.d, hourIndex: i.hourIndex, time: i.time, gender: i.gender, location: i.location });
+    }
+    case 'ziwei': {
+      const i = inputs || {};
+      return ziweiCalc({ ganzhi: i.ganzhi, month: i.month, day: i.day, hour: i.hour, time: i.time, location: i.location, gender: i.gender, birthYear: i.birthYear });
+    }
+    case 'astrology': {
+      const i = inputs || {};
+      return astrologyCalc(i.y, i.m, i.d, i.hour || 0, i.min || 0, i.lng, i.lat);
+    }
+    case 'qimen': {
+      return qimenCalc({ datetime: inputs?.datetime ? new Date(inputs.datetime) : new Date() });
+    }
+    case 'meihua': {
+      const i = inputs || {};
+      return meihuaCalc({ mode: i.mode || 'time', n1: i.n1, n2: i.n2, n3: i.n3, now: i.now ? new Date(i.now) : undefined });
+    }
+    case 'liuyao': {
+      const now = new Date();
+      return liuyaoCalc(undefined, { y: now.getFullYear(), m: now.getMonth() + 1, d: now.getDate() });
+    }
+    case 'liuren': {
+      return liurenCalc(inputs?.datetime ? new Date(inputs.datetime) : new Date());
+    }
+    case 'xiaoliuren': {
+      const i = inputs || {};
+      return xiaoliurenCalc(i.mode || 'time', i.m, i.d, i.h, i.n1, i.n2, i.n3);
+    }
+    case 'tarot': {
+      const i = inputs || {};
+      const cards = tarotDraw(Math.max(1, i.n || 3));
+      const spread = allTarotSpreads().find((s: any) => s.id === i.spread) || allTarotSpreads()[0];
+      return { spread: spread || { id: 'three', name: '圣三角', description: '', positions: [] }, cards };
+    }
+    default:
+      throw new Error('术无此名: ' + artId);
+  }
+}
+
+/** 每术输入参数说明（/v1/arts 能力清单用） */
+export const CHART_INPUT_SCHEMA: Record<string, Record<string, string>> = {
+  bazi: { y: '公历年', m: '公历月', d: '公历日', hourIndex: '时辰 0-11（0=子）', gender: '男/女', location: '{lng,lat,province,city,district}' },
+  ziwei: { ganzhi: '年干支', month: '农历月', day: '农历日', hour: '时辰 0-11', gender: '男/女', location: '{lng,lat}' },
+  astrology: { y: '公历年', m: '月', d: '日', hour: '时 0-23', min: '分', lng: '经度', lat: '纬度' },
+  qimen: { datetime: '起局时刻 ISO 字符串' },
+  meihua: { mode: 'time|number', n1: '报数1', n2: '报数2', n3: '报数3' },
+  liuyao: {},
+  liuren: { datetime: '起课时刻 ISO 字符串' },
+  xiaoliuren: { mode: 'time', m: '农历月', d: '农历日', h: '时辰 0-11' },
+  tarot: { n: '抽牌数（默认3）', spread: '牌阵 id' },
+};