奇门遁甲 · AI 决策引擎

把一套关于结构与变化的古典认知体系，接入现代 AI 推理引擎——也接上现代心理学的自我认知语言。
时空局势建模 × 个体禀赋结构分析 × 心理学视角互证 × 古籍命例校验 × 双轴语义路由 × 可审计推演过程 × DeepSeek 大模型 × Vue 全栈应用

"穷则变，变则通，通则久。" —— 结构终将变化，而变化本身可以被认知、被建模。这是整个项目的方法论起点，也是它与"算命"的分界线。

     

简体中文 | English | 繁體中文

---

🧭 四大对话式推演技能（Agent Skills）

开箱即用：任意支持命令行的 AI Agent，都能直接调用本项目沉淀的四套「对话式排盘解盘」技能——对话端与网页端共用同一套确定性规则底座。

四个技能同构，都走 访谈 → 确定性计算（脚本）→ AI 解读 三段式：先问清所求，再用脚本做固定计算（绝不让大模型心算排盘），最后才把结构化结论转译成可读、可行动的语言。计算内核纯本地、零 API Key，Agent 只需能跑脚本。

技能	看什么	计算内核	技能定义
奇门遁甲 qimen-dunjia	具体事件、时机窗口、方位、趋吉避凶	scripts/qimen_cli.cjs（时家转盘，Node）	SKILL.md
四柱八字 bazi	命局结构、性格禀赋、大运流年、问事应期	scripts/bazi_cli.cjs（复用生产引擎，Node）	SKILL.md
紫微斗数 ziwei	十二宫结构、星情四化、大限流年的阶段变化	scripts/ziwei_skill_cli.cjs（iztro 排盘 + 已审核知识库证据，Node）	SKILL.md
西洋星盘 astro	本命盘：行星落座落宫、上升天顶、宫位、主相位	scripts/astro_cli.cjs（astronomy-engine 星历，Node）	SKILL.md

• 为什么不让大模型自己排盘：排盘、格局、旺衰、喜忌、问事推演本就是确定性的，一律交给脚本；大模型只负责访谈与解读，规避「心算」日柱大运带来的不可复现错误。
• 统一契约：各 CLI 共用同一套出生信息输入（lib/birthInput.cjs，时辰必填；八字、紫微另需性别，传出生地可换算真太阳时；西洋星盘不需要性别、不做真太阳时，按出生地时区换算 UTC）与同一种输出外层（lib/cliEnvelope.cjs，含 chart / judgments / evidence / confidence / limitations / warnings / conventions）；另有历法 CLI scripts/calendar_cli.cjs（公农历转换、真太阳时、节气）。
• 解读守则单一来源：四套技能的访谈与解读守则统一放在 packages/xuanxue-mcp/prompts/，SKILL.md 与 MCP prompt 共用同一份正文。
• 八字技能自带分层校验：scripts/bazi_cli.test.cjs（封装无损 parity 测试，已并入 npm test）＋ eval/bazi-skill/（触发准确度、路由预判、解读忠实度评测）。

详见下方「核心能力」中的 奇门遁甲 Agent Skill、四柱八字 Agent Skill 与 紫微斗数盘。

🔌 MCP Server（xuanxue-mcp）

八字、紫微斗数、奇门遁甲、西洋星盘（外加历法工具）也以 stdio MCP server 的形式提供，可接入 Claude Code、Claude Desktop、Codex、Cursor 等客户端：5 个工具（bazi / ziwei / qimen / astro / calendar）＋ 4 份解读守则 prompt。纯本地计算，不联网、无需 API Key，需要 Node ≥ 22.12。

尚未发布到 npm。发布前请从本仓库直接运行，例如 Claude Code：claude mcp add xuanxue -- node <仓库绝对路径>/packages/xuanxue-mcp/src/server.mjs；发布后可改用 npx -y xuanxue-mcp。

配置方法、工具参数与输出说明见 packages/xuanxue-mcp/README.md。

DeepSeek Harness（dsh）插件：packages/xuanxue-dsh 是包装 xuanxue-mcp 的薄壳组合包，用 dsh 自带的 MCP 客户端接入 5 个工具，并把 4 份解读守则注册为 dsh skill（dsh 不支持 MCP prompts）。发布后用 dsh plugin --profile web add xuanxue-dsh 安装；同样尚未发布到 npm。

---

项目简介

多数命理工具要么只会排盘，要么只会用玄妙辞藻反复套模板。这个项目想做的是另一件事：把中国古典决策哲学里"情境—时间—行动"这套结构化认知框架，用确定性规则引擎实现出来，再让 AI 负责表达，而不是让大模型凭空生成玄学话术。

拆开来看，奇门遁甲的九宫飞布，本质上是一套关于"局势结构如何随时间演化"的时空模型；八字的干支系统，本质上是一套关于"个体禀赋与所处阶段如何相互作用"的结构模型。二者共享同一套底层世界观——阴阳消长、五行生克——这是一套朴素的关系本体论：万物不是孤立的实体，而是彼此制约、此消彼长的关系网络。

这条脉络和现代心理学之间，其实有一段有据可查的交集，不是本项目自我美化出来的联想：荣格（Carl Jung）1949 年为卫礼贤（Richard Wilhelm）的《易经》英译本作序，明确说他从这本书里看到了自己"共时性"（synchronicity）理论的哲学基础——两件事之间没有因果关系，却存在有意义的巧合关联，荣格认为《易经》是历史上最早系统化运用这条原则的方法，而卫礼贤早在 1920 年代就把《易经》引介给他，此后他用了数十年时间在自己的临床实践里持续验证。往下看，八字里的十神（比劫 / 食伤 / 财 / 官杀 / 印）描述的是"自我与外部资源、权威、表达欲之间的关系模式"，这和 McClelland 成就动机理论关心的"人和世界打交道的几种基本方式"是同一个问题的不同符号系统；十二长生把人生刻画成长生、帝旺、衰、死、墓、绝、胎、养的阶段性叙事，和 Erikson 的心理社会发展八阶段、Levinson 的《人生四季》结构同源；岁运"引动"原局潜质的机制，和人格心理学里的特质激活理论（Trait Activation Theory，Tett & Guterman, 2000）几乎是同一个命题的两种表述：稳定倾向平时潜伏，遇到匹配的情境线索才会显现为行为。这些不是同一套理论，是同一批问题在东西方分别独立求解出的结构相似解——需要说清楚边界：这是方法论层面的结构互证，不是说阴阳五行"被心理学证明"了，它没有经过心理测量学意义上的信效度检验，不能和 Big Five 或 MBTI 这类量表画等号。这套系统真正站得住的价值主张是：它提供一套经过千年打磨、结构完整的自我与情境认知语言，这套语言有没有用，不取决于它的因果机制是否成立，就像叙事疗法不需要来访者的"人生故事"在形而上学意义上为真，也能产生真实的心理效用。

用户提问后，系统会先判断这道题该用哪套框架回答：局势模型（奇门）、禀赋结构模型（八字），或两者联合推演。分流模块先识别问题类型，再把对应的结构规则、命盘上下文与现实语境交给推演引擎处理。

局势模型负责具体事件、短期决策、时机窗口；禀赋结构模型负责个体结构、阶段趋势、长期适配；节奏评分模块负责日、周、月、年的状态量化与可执行建议。客观计算由本地规则引擎完成，大模型只负责把结构化结论转译成可读、可行动的语言——它不做判断，只做翻译。

这不是给算命应用换一层皮，是一套先做结构化认知，再用语言表达，而不是用语言制造神秘感的推演系统。

---

推演背后的认识论

在动手做技术设计之前，先要回答一个更根本的问题：这套系统到底在断言什么？ 这个立场不是本项目自己发明的包装话术，而是陆致极在《命运的求索》《八字命理动态分析教程》里给出的、体系内部最接近现代科学方法论的自我定位：

"命是根据，运是环境；命是内因，运是条件。命理学就是探讨'命'和'运'的相互作用，来揭示和展现一个人丰富多彩的人生起伏轨迹。"

"作为这个黑箱的输入，是一个人的出生时辰。作为黑箱的输出，是关于这个人的生命潜质和人生历程的描写和预测。"——他将命理学的根本局限首先归结为**"概率性描写"**：这是一种基于经验观察的近似预测，而非神学式的绝对因果决定。

他借用控制论的"黑箱"概念自我定位：不宣称打开黑箱、理解命运的终极机制，只观察输入（出生时空结构）与输出（人生潜质与趋势）之间"不是杂乱无章"的对应关系。

flowchart LR
    A["输入<br/>出生时空结构（四柱）"] --> BB{{"黑箱<br/>阴阳五行 · 干支符号模型<br/>不打开机制，只建立对应关系"}}
    BB --> C["输出<br/>概率性描写<br/>人生潜质与趋势的近似预测"]
    D["命 = 内因 · 根据<br/>原局潜质（静态）"] -.-> BB
    E["运 = 外因 · 条件<br/>大运流年（动态）"] -.-> BB

再往下一层，是他给出的可操作方法论——"动态分析"四个递进环节，讲清楚"潜质如何在时间中被激活为具体事件"：

flowchart TD
    S1["① 原局基底 · 内因与潜质<br/>强弱 · 调候 · 格局 · 形象四视角定位用神与病点<br/>四柱运限：年1-16 / 月17-32 / 日33-48 / 时49-64+"]
    S2["② 大运建场 · 外因与环境<br/>大运干支对位当前运限柱<br/>十年场域，为潜质提供生长或压制的外部条件"]
    S3["③ 岁运交互 · 三大触发机制<br/>应局：伏吟激活原局焦点<br/>引动：禄 / 原身隔空调取资源<br/>干支扭曲：天克地冲，结构对抗"]
    S4["④ 流年应期 · 状态突变<br/>静遇冲则动 → 事件爆发<br/>动遇合则静 → 问题落定"]
    S1 --> S2 --> S3 --> S4

原局是潜质（种子），大运是环境（场域），流年是触发（导火索）——三者共同决定"某个具体年份会不会爆发某件事"，而不是原局本身就写死了结局。这套四环节框架，正是本项目工程实现里「运限并轨」「应局」「禄 / 原身引动」几个概念的理论来源，也直接决定了下面所有工程决策：为什么算分要用规则引擎而不是提示词，为什么同一句话不同模型要给出一致结论，为什么低置信问题必须显式标注"不能强断"。

---

核心能力

从这里开始是工程实现——把上面的认识论立场，落到具体的分流、规则与评分逻辑上。

更新历史

2026-11-10 · 西洋星盘（astro）接入 CLI 与 MCP

• 新增 scripts/astro_cli.cjs 与 MCP astro 工具、astro_reading 解读守则、astro 技能：西洋占星本命盘，含行星落座落宫与逆行、上升天顶、宫位、五种主相位、元素模式分布、日夜盘与命主星。
• 口径：回归黄道、默认 Placidus 宫制（高纬度无解时自动改用整宫制）、平均交点；缺出生时间返回 TIME_REQUIRED；目前只做本命盘，judgments 为空（不含断语库）。
• 星历用 astronomy-engine（MIT，纯 JS）；与 Swiss Ephemeris 对照 6 张金标盘，行星与交点误差小于 1′，上升、天顶与宫头小于 2′。出生时间按 IANA 时区（含历史夏令时）换算为 UTC，不做真太阳时。
• 地名解析支持“地级市 + 区县”写法（“厦门市集美区”“厦门集美”“恩施利川”），八字、紫微、星盘共用。

2026-11-05 · 奇门技能修复、CLI 统一契约与 xuanxue-mcp

• 奇门技能改为调用 scripts/qimen_cli.cjs（封装生产入口 buildQimenEvidence），并注册到 .claude/skills/；此前文档引用的 Python 脚本从未存在。
• 八字、紫微、奇门三个 CLI 统一出生信息输入与输出外层；时辰、性别改为必填（以前缺时辰默认 12 点）；传出生地可换算真太阳时（v1 只支持中国，含港澳台）。新增历法 CLI。
• 新增 MCP server packages/xuanxue-mcp：4 个工具、3 份解读守则；默认精简输出，detail: "full" 取完整数据；打包时剥离紫微古籍摘录原文。尚未发布到 npm。

2026-10-31 · 紫微斗数盘上线

• 八字档案页新增「紫微盘」标签：用同一份档案（优先真太阳时、性别）直接排紫微命盘，访客也能用，无需额外录入。
• 排盘引擎为 iztro，前端按需懒加载，不影响首屏体积；口径为晚子时算次日、年界正月初一、闰月按 fixLeap 分前后半月、四化按《飞星紫微斗数》四化诀。
• 盘面参考专业紫微 App 布局：十二宫竖排星曜与亮度、生年四化、自化（↓）与对宫化入（↗）、三合 / 四化两种看盘方式、宫干四化飞线，以及大限 / 流年 / 流月三级滑动切换。
• 移动端盘面与运限滑动条压在一屏内，宫位细节（岁数、杂曜、十二神）点宫查看。

2026-09-09 · BaziEngine 1.8.29 / Qimen ruleset dunjia-yanyi-siku-v1 · 古籍规则审计修复

• 八字修正金水伤官适用范围、目标干十二长生与通根、四生月透干变化；规则升级后不再复用旧 LLM 断语。
• 奇门统一按《遁甲演义》（四库全书本）处理九星相旺废休囚、六仪击刑、五不遇时、三奇得使、玉女守门、三奇墓与天禽寄坤。
• 数值明确标为项目参考指数；LLM 只提供文字复核，不能修改后端确定性指标。审计与修复证据见 docs/audits/2026-09-07-mechanism/REPORT.md。

2026-07-24 · 八字分析沉淀为 Agent Skill

把八字原局决策与问事推演沉淀成可复用的 Agent Skill（见「四柱八字 Agent Skill」），与奇门技能同构：访谈 → scripts/bazi_cli.cjs 固定计算 → AI 解读，对话端与网页端共用同一套确定性引擎。

• 计算内核薄封装：scripts/bazi_cli.cjs 复用生产同源 buildCompleteBaziDetail + buildBaziQuestionPrompt，纯本地零 Key；v1 仅公历、只用主线引擎，不依赖仍在分支的专题派生能力。
• 封装无损保障：scripts/bazi_cli.test.cjs parity 冒烟测试证明 CLI 输出与直接调引擎逐字段一致，已并入 npm test。
• skill 级评测起步：新增 eval/bazi-skill/，Phase 0 触发 / 路由（量化出脚本路由启发式仅约五成、印证需 LLM 预判），Phase 1 解读忠实度检测器（解读断语 vs 确定性盘的硬矛盾门禁 = 0，确定性自证通过）。

2026-07-09 · BaziEngine 1.8.28 · 原局准确度调优整合版

把近期格局、旺衰、象法与喜忌调优收束为同一版原局决策说明。完整判断条件、执行顺序与 Mermaid 流程图见 docs/bazi-engine-architecture.md。仍在 preview 阶段的专题派生能力不纳入本次版本。

• 原局决策链统一：四柱进入引擎后并行识别格局、旺衰与象法，再汇入成格和喜忌链；L0 仅保留给会提前返回或覆盖普通链的特殊气势，其余节点按真实执行顺序描述。
• 格局与成格校准：补入七杀有制、官杀去留、墓库杂气透干等主格候选；成格用神、相神和 protected / promoted / demoted / invalidated Effects 正式参与喜忌评分。
• 旺衰与象法校准：旺衰统一为得令、得地、得助和结构修正的 10 分制；象法增加从格、专旺、化气、两气成象评分，并以有效根、反制力量和破象条件控制特殊覆盖。
• 喜忌执行顺序明确：普通链按调候 → 病药 → 通关 → 扶抑 → 格局顺逆 → 成格取用 → 结构 Effects → 特殊救应 → 冲突消解执行；成格属于强先验，印星救主、羊刃驾杀属于窄条件最终纠偏。
• 经典命例回归：24 个高置信命例严格加权准确率 91.1%，核心准确率 95.7%，用神 Top 1 91.8%，喜忌方向 100%，格局 92.3%，象法 100%，严重错误 0。该集合暂无旺衰真值，不将结果外推为旺衰准确率。

2026-06-25 · 奇门 Skill 沉淀 + 盘面深度字段调优

把奇门问事完整流程沉淀为可复用的 Agent Skill（见上「奇门遁甲 Agent Skill」），并补齐评分引擎此前缺失的盘面深度字段，让深度解读有数据可引、不靠模型臆造。引擎细节见 docs/qimen-scoring-engine-improvement.md。

• 天地盘干生克（stem_relation）：新增 getStemRelation，每宫天盘干与地盘干的生克方向（天生地 / 天克地 / 地生天 / 地克天 / 比和）写入 timingPalaces 与盘面 prompt，解读不再停留在「符号落在哪个宫」的表层。
• 格局落宫（palace_index）：detectNamedFormation 由返回布尔改为返回落宫索引，有名格命中时记录落宫，解读带出「落某宫」并标注受影响角色，告别悬空的「格名 + 通用象义」。
• 旺衰接入（prosperity）：当时首次把九星月令状态接入 evaluatePalace；该版使用的普通五行旺相休囚死口径已在 2026-09-09 审计中更正为《遁甲演义》的相、旺、废、休、囚专法。
• Skill 报告纪律：起局时间改为「问事当下」口径（事件时间只作背景）；报告强制落盘并在开头渲染洛书九宫格；必须语义新增 palace_depth_reading，要求核心用神宫读到干生克、旺衰与门星神合力的第二层；写作加反填充约束（建议须绑定具体盘面信号、不靠重复结论充字数）。

2026-06-13 · 问事追问（多轮深挖）

奇门与八字问事都支持在原解读之上「追问深挖」，新增 /api/qimen-followup 与 /api/bazi-followup 两个流式接口。

• 一局一解，正本不动：追问结果以增补子块挂在相关段落下，不覆盖原文、不重排盘、不重新打分——一个局的态势与分数在起局那一刻就固定，追问只换面向、做分层深挖。
• 深挖 / 新事小判断器：先用轻量模型判断追问是「同一局深挖」还是「另起一事」；判为新事直接提示重新起局，不浪费大模型。
• 确定性补算：追问若需要原盘没算的流年、大运、应期，由判断器按白名单点菜、后端确定性补算，大模型永远只读结果，不做 function calling。
• 反臆造延续：补丁模型只能引用前端回传的盘面证据，不得引入新盘面元素，也不得泄漏内部量化指标；修正信息时以「原结论 →（因新情况）调整为…」对照呈现，绝不静默覆盖。

2026-06-10 · 问事流式输出与自愈重试

把问事从「一次性出整块 JSON」推进到「边算边出、出错能自愈、模型可按环境切换、文案不臆造也不漏指标」。

• 哨兵分段（<<<SEC:...>>>）协议把每个面向用户的散文段独立流式推送，规则引擎产物先上屏，AI 解读逐段补丁到对应卡片槽位。
• 结构校验硬失败（空流 / 核心段缺失 / data_json 不可解析）发 llm_retry 事件，前端清空半截内容回骨架，后端非流式重试一次；个别可选字段缺失走静默兜底。
• title 拆成独立流式段，点明问题类型与核心结论，不再混在结构化 JSON 里重复输出。
• 新增 QUESTION_MODEL 环境变量逐环境配置问事模型（代码默认回退 gemini-3.1-pro-preview，当前各环境切 gemini-3-flash-preview 验证）。
• 反臆造与化气格约束：只能引用后端实际盘面 / 四柱字段，严禁脑补不存在的门星神、宫位、生克刑冲合害；禁止「强度74.4」「能量值80」「置信度0.8」等内部数值进入用户文案，改用命理语言定性表达。

2026-06-06 · 规则可评测、页面同源、历史可回放

把八字问事从「模型会不会说得像」推进到「规则是否能被评测、页面是否同源展示、历史记录是否能安全回放」。

• 用神 / 目标十神评测纠偏：新增 docs/eval/yongshen-eval-2026-06.md 与 scripts/eval-yongshen.mjs，用陆致极命例对照本地规则引擎，逐案标注吻合 / 部分 / 偏差，并记录从儿格、调候为急、印星救主、弃官就印等修复原因。
• 双轴语义路由：八字问事从 status/timing/pattern/character 单轴拆成 framework（推演框架）× target_source（目标来源）。
• 八字动态 panel 拾取逻辑：从 state_report、dynamic_report、timing_candidates 拾取目标十神、宫位与岁运引动，与规则引擎同源；低置信链路明确降级。
• 历史记录兼容：旧 analysis_mode 迁移到新双轴语义，存量问事记录继续回放。

更早的功能演进

• 运势页从单一日运扩展为日、周、月、年四层视图，可同时看今天、本周、本月和今年的节奏。
• 周运七日曲线、顺势日 / 谨慎日、周度标签与事业、财运、感情提醒。
• 月运分数曲线、高低分日、低谷期提示和综合 / 事业 / 财运 / 感情四类白话详批。
• 年运前后十年流年变化、大运背景、流年十神与岁运关系。
• 八字档案「断事笔记」记录事业、财务、感情、健康 / 生活状态，让月运解读更贴近现实处境。
• 奇门结果页保留应验反馈入口，方便回头标记推演准不准、实际走向如何。

自动术数分流引擎

这是系统的大脑。每次用户提问后，它会先判断问题属于具体事件、长期结构，还是需要奇门与八字联合推演——这一步本身就是认识论立场的落地：先分清"我在问什么类型的问题"，再决定用什么方法回答，而不是拿一套万能话术套所有问题。

• 通过本地规则和大模型意图判断，自动选择合适的推演框架
• 覆盖事业职场、求财投资、婚恋感情、健康疾病、交易失物、考试学习、官司法务、风水家宅、孕产子嗣等常见问题域
• 根据问题类型注入对应的取用神规则、命盘上下文和现实背景
• 信息不足时会先追问关键条件，不急着给出含混判断

奇门遁甲推演

• 实现时家奇门拆补转盘法，包含甲子隐遁、符头定位、九星、八门、八神飞布
• 自动处理天芮、天禽中宫寄坤、日空、时空、驿马星等盘面信息
• 按问题域动态切换取用神规则，避免同一套话术套所有问题
• 输出态势评分、风险信号、破局节点、有利方位、有利时间与行动建议
• 支持同一局追问深挖：不重排盘、不改分，把追问解读分层挂到相关段落下
• 支持历史记录回放和应验反馈，用于后续校准

奇门遁甲 Agent Skill（对话式推演技能）

把上面这套奇门事件链路沉淀成一个可被 AI Agent 直接调用的技能（.claude/skills/qimen-dunjia/SKILL.md），让"对话式排盘解盘"和网页端走同一套确定性规则底座，而不是让大模型凭空编玄学。

• 先访谈、后起局：正式起局前先做结构化访谈，确认所问事项、起局时间、时区与判断目标，信息不全先追问，不急着断
• 固定流程不跳步：结构化访谈 → scripts/qimen_cli.cjs 起局（与网页端同一个 buildQimenEvidence）→ 读取 chart 盘面与 judgments（用神、评分、格局落宫、应期、极性修正）→ 自由结构报告，全程不绕过引擎自由解盘；v1 不做多时辰择时
• 四条底线：盘面事实必须来自脚本；低置信目标可由模型推导，但所指符号必须能在 chart.palaces 中定位；模型推导的目标只能有界参与判断，不得覆盖脚本给出的用神与评分；报告结构自由但关键语义（直接答案、取用逻辑、证据、风险、应期、建议、限制）不得遗漏
• 问事起局口径：时家奇门以「问事当下」起局（北京时间、脚本解析时辰），用户提到的事件时间只作事项背景，不当起局时间
• 报告规范：开头渲染洛书九宫格，命中有名格按落宫展开，逐宫读到旺衰与天地盘干生克，结尾附推演边界说明

四柱八字 Agent Skill（对话式命理分析技能）

把网页端那套八字原局决策与问事推演，沉淀成一个可被 AI Agent 直接调用的技能（.claude/skills/bazi/SKILL.md），与奇门同构——「访谈 → 脚本固定计算 → AI 解读」，不让大模型心算排盘。

• 薄封装、同源计算：scripts/bazi_cli.cjs 复用生产引擎的 buildCompleteBaziDetail 与问事 pipeline（buildBaziQuestionPrompt），一次调用即输出四柱排盘、原局决策（格局 / 旺衰 / 喜忌五神）与动态问事（用神落点 / 原局状态 / 岁运引动 / 应期候选年）的结构化 JSON
• 纯本地零 Key：计算内核只在本地运行（Node ≥ 22.12），不联网、不需 API Key——接入的 Agent 自己充当负责解读的大模型
• 访谈先行、路由预判：先确认公历生辰、性别、所问事项与时间范围，信息不全先追问；由 Agent 预判分析类型（timing / status / pattern / character）再交脚本，缺省则脚本启发式兜底
• 口径对齐生产：v1 仅收公历、夜子时算当日，与网页端引擎同一套判据；时辰、性别必填，传出生地时复用网页端函数换算真太阳时（含 1986–1991 年大陆夏令时）；只用主线引擎，不含仍在分支的专题派生能力
• 分层可验证：scripts/bazi_cli.test.cjs 用 parity 测试锁定「封装 == 引擎、无损」并挂进 npm test；eval/bazi-skill/ 提供 skill 级评测方案（触发准确度、路由预判、解读忠实度——解读断语与确定性盘的硬矛盾门禁为 0）

全息八字系统

• 支持阳历、农历、四柱反查三种录入方式
• 支持出生地搜索、经度、平太阳时、真太阳时修正
• 展开四柱干支、十神、藏干、十二长生、纳音、旬空亡、神煞与特殊格局
• 本地规则引擎负责日主强弱、喜忌神、格局解读和生克合化关系
• 提供 BaziEngine 原局决策架构，明确格局、旺衰、象法、成格和喜忌五神的执行顺序与覆盖关系
• 提供五行力量条、打分明细、八字问答、解读反馈校准与断事笔记
• 支持基于同一命盘继续追问深挖，新信息走「原结论 → 调整为…」对照，不静默覆盖
• 支持大运、流年、流月三级联动，辅助理解命盘与当下时间的关系

紫微斗数盘

• 基于八字档案直接排盘：src/utils/ziweiChart.mjs（输入口径与后端 lib/ziweiProfileAdapter.cjs 一致，测试校验两边不漂移）+ src/components/ZiweiChartPanel.vue
• 十二宫主星、辅星、杂曜与亮度，命主 / 身主、五行局、身宫、生年四化
• 三合视图（本宫与三方四正高亮）与四化视图（宫干四化飞入连线），自化 / 对宫化入标记
• 大限、流年、流月三级联动，切换后显示对应运限的宫名与四化
• 当前为浏览器实时排盘、不落库；对话端用 ziwei 技能 调 scripts/ziwei_skill_cli.cjs 输出同口径命盘与证据包，紫微与八字交叉验证在规划中

运势评分系统

运势页从单一日运扩展为日、周、月、年四层结构：

维度	功能
日运	计算每日分数，展示洞察卡片、时间线、吉时与应对建议
周运	按自然周生成七日曲线、周度标签、关键日期、节气转折和行动提醒
月运	按节气计算流月，展示月度曲线、高低分日、低谷期和分层命中依据
年运	生成前后十年区间，叠加大运、流年、原局关系、神煞信号与分层命中依据

月运详批支持综合、事业、财运、感情四个维度。用户可以填写长期基调与本月现实背景，系统会把这些上下文注入解读。

推演工程化看板

• 将复杂推演工作流拆解为清晰角色和步骤
• 提供规则、缓存、引擎状态与推演过程的集中观察视图
• 适合高级用户或管理员排查推演链路、观察系统状态

访客、认证与商业化

• 支持邮箱登录、Google 登录和密码重设
• 访客模式可体验一次奇门提问、添加一个本地八字档案、查看今日日运分数
• 访客事件会过滤姓名、生日、问题文本等隐私字段
• 登录与访客状态下展示底部导航，密码重设页自动隐藏主导航

---

推演架构

结构如何在代码里落地——每一步分流，都是"先分清问题类型，再选方法"这条认识论原则的具体实现。

顶层分流

用户提问
  │
  └─► 术数分流引擎（divinationRouter）
        │
        ├─► 奇门遁甲：具体事件、短期决策、成败应期
        ├─► 八字命理：命局结构、长期趋势、行业适配
        ├─► 联合推演：命局背景 × 当前事件
        └─► 信息追问：补全关键条件后再进入推演
              │
              └─► 领域规则注入
                    │
                    └─► 主推演引擎
                          │
                          └─► 结构化决策卡片

问事推演 Pipeline（按问题类型走不同链路）

问事系统不再是单一的"八字问答"。用户输入问题后，系统会先判断这件事更适合用奇门、八字，还是二者联合推演；如果问题过于含糊，会先追问关键条件。不同分支的计算链路不同，最后再由 AI 把规则结论整理成可读、可行动的解读。每条链路出结果后都支持追问深挖：在不重排盘、不改分的前提下，把追问解读分层挂到相关段落下，越出本局则判为新事、提示重新起局——这也是"结构在起局那一刻就固定"这条原则的体现：新证据可以补充理解，但不能悄悄改写已经发生的判断。

八字分支的详细工程规范见 docs/bazi-prompt-assembly-prd.md，奇门评分改进记录见 docs/qimen-scoring-engine-improvement.md。

用户问题
    │
    ▼
┌─────────────────────────────────────┐
│  顶层术数分流                         │
│  · 判断是长期命局还是眼前事件          │
│  · 识别事业、财运、感情、健康等领域    │
│  · 判断问卦者是主动方还是守待方        │
│  · 信息不足时先追问，不硬断            │
└────────────────┬────────────────────┘
                 │
        ┌────────┼────────┬────────┐
        ▼        ▼        ▼        ▼
   需要补充   奇门事件   八字命局   联合推演
   关键信息   判断链路   判断链路   命局背景 × 当下事件

八字问事双轴架构

旧版八字问事主要依靠 analysis_mode 单字段判断问题类型，容易把"问什么"和"用什么目标判断"混在一起。新版将语义路由拆成两条轴：

轴	作用	取值
framework	决定这道题走哪种推演框架	dynamic_current 当前状态、dynamic_scan 应期扫描、static_structure 先天结构、portrait 人物画像、open_strategy 开放战略
target_source	决定目标元素从哪里来	backend_shishen 后端十神/宫位映射、yongshen 命局用神/喜忌、llm_derived 低置信模型推断

用户八字问题
    │
    ▼
语义路由
    │
    ├─► framework：判断是当前状态、应期、结构、画像还是开放战略
    │
    └─► target_source：判断目标来自后端十神、命局用神还是模型推断
            │
            ▼
目标解析
    backend_shishen：走领域映射，定位目标十神、宫位、动态机制
    yongshen：读取命盘喜用神，适合"我整体怎么选择/怎么起势"
    llm_derived：只给低置信提示，不强行生成规则 panel
            │
            ▼
框架执行
    dynamic_current：原局状态 + 当前大运流年
    dynamic_scan：逐年扫描候选窗口
    static_structure：先天结构与容量
    portrait：人物画像倾向，不强断事实
    open_strategy：多路径取舍与阶段建议

这套拆分的好处是：同一句"事业怎么办"可以先判断它是在问当下状态、未来窗口还是职业结构，再决定观察财官印食伤、命局用神或低置信开放目标。路由更保守，panel 更容易同源，历史记录也能通过旧字段迁移继续展示。

奇门事件链路

适合判断具体事情，例如要不要接 offer、面试能否成、项目能不能推进、对方会不会回复、东西能否找回、某个时间是否有利。

具体问题 + 当前时间
    │
    ▼
时家奇门起局
    │
    ├─► 定位问题领域和主客关系
    ├─► 按领域选择用神和辅助观察点
    ├─► 计算九宫盘面、空亡、马星、值符值使
    ├─► 后端规则先给出态势评分和风险信号
    ├─► 扫描可用时辰，寻找填实、冲动、破局窗口
    └─► AI 审计分类、用神、评分和应期，再输出结果卡片

八字命局链路

适合判断长期结构，例如事业方向、财富容量、婚恋结构、体质倾向、未来几年哪段时间更容易起事。八字分支内部会先经双轴路由，再按 framework 进入不同子链路：

用户问法	实际链路	主要判断内容
"我今年感情怎么样？"	dynamic_current + backend_shishen	原局底盘、当前大运、当前流年是否引动目标领域
"未来五年哪年适合跳槽？"	dynamic_scan + backend_shishen	逐年扫描大运流年，筛出较强窗口和需要避开的年份
"我适合创业还是打工？"	open_strategy + yongshen	命局喜忌、阶段气候、多路径取舍和风险点
"我适合什么职业方向？"	static_structure + backend_shishen/yongshen	先天结构、能力容量、资源模式和长期适配
"我未来伴侣大概什么类型？"	portrait + backend_shishen/llm_derived	目标十神、宫位和关系结构呈现的人物倾向
"这个问题八字不能强断"	llm_derived 或追问	明确说明不能确定判断，只给低置信观察框架

用户问题 + 八字档案
    │
    ▼
八字语义细分
    │
    ├─► 识别问题领域、时间范围和判断目标
    ├─► 输出 framework：当前状态 / 应期扫描 / 先天结构 / 人物画像 / 开放战略
    ├─► 输出 target_source：后端十神 / 命局用神 / 模型推断
    └─► 修正低置信或冲突信息，避免把问题硬套进错误规则
          │
          ▼
目标元素定位
    │     按 target_source 定位核心十神、宫位、命局用神或低置信观察点
          │
          ▼
原局状态评估
    │     看目标元素在四柱中的位置、强弱、透藏、刑冲合害、入墓等底盘状态
          │
          ▼
动态引动评估
          当前状态：看当前大运和流年是否真正引动
          应期窗口：逐年遍历候选年份并排序
          先天结构：以原局结构为主，必要时补当前阶段
          开放战略：用命局喜忌和阶段气候比较多个方向
          人物画像：只输出倾向，不强断确定事实
          边界型：说明命理边界，降级为可替代观察
          │
          ▼
解读组装
          把目标元素、原局底盘、动态引动和限制条件整理成自然语言，
          AI 只负责表达、组织和建议，不重新排盘、不自由编造干支关系。

联合推演链路

适合同时包含"长期命局背景"和"眼前具体事件"的问题，例如"我今年事业运怎样，这个 offer 要不要接"。系统会把八字档案作为命主背景注入奇门事件链路：八字负责说明命主当下的底色和阶段，奇门负责判断眼前这件事的成败、风险、应期和行动窗口。

八字档案
  └─► 命主底色、当前大运流年、喜忌倾向
          │
          ▼
具体事件 + 当前时间
  └─► 奇门起局、取用神、评分、应期、破局建议
          │
          ▼
综合结果
  长期趋势不替代具体事件判断；
  具体事件也不脱离命主当前阶段。

运势算分引擎（四维用神体系）

运势评分由本地确定性规则完成，大模型不参与判分。页面上的日运、周运、月运、年运分数不是一句提示词生成的，而是先看命主原局，再看当下时间对原局的引动，最后把命中的因素整理成可解释的分数和提示。评分体系的详细工程设计见 docs/bazi-score-engine-prd.md。

命主四柱
    │
    ▼
喜忌关系整理
  先区分哪些五行、十神对命主更有帮助，哪些容易形成消耗或压力
    │
    ▼
调候与季节修正
  看当前气候是否补足命局所需，或进一步加重偏枯
    │
    ▼
时间因素叠加
  日运：看当天干支对命局的即时影响
  周运：汇总一周七天的高低起伏和主导能量
  月运：按节气流月观察本月节奏、低谷期和关键日期
  年运：结合大运背景与流年太岁，看一年整体气候
    │
    ▼
可解释分数
  分数之外，同时给出加分来源、风险来源和行动建议

理论支撑（NotebookLM 命例教材）

本系统的核心判断链路，依据作者在 NotebookLM 中整理的八字命例学习材料提炼而来：

理论来源	在评分中的作用
《滴天髓》：用神为药、喜神辅用、忌神为病、仇神助病	先判断当前时间是在扶助命局，还是在放大命局压力
《穷通宝鉴》：调候为急，生存环境优先	先看寒暖燥湿是否得宜，再谈具体利弊
命例材料：支神只以冲为重，刑与穿兮动不动	对刑冲合害分层处理，不把单一信号绝对化
《三命通会》：太岁为年中天子	年运判断中更重视流年对当前阶段的触发
命例材料：贵人无气，虽有如无；神煞轻重较量，要在通变	神煞只作为辅助信号，必须结合旺衰、喜忌和空亡一起看
陆致极动态分析理论：目标元素的原局状态 → 大运流年引动 → 应期判断	先看原局有没有基础，再看时间是否真正引动

NotebookLM 中的命例教材是作者整理的私人学习资料，不对外公开。README 只展示判断框架，具体规则和权重保留在工程文档与源码中。

---

评测与纠偏逻辑

一个不能被检验的推演系统，无论辞藻多美，都只是修辞。这一节讲的是"如何证伪"。

用神 / 目标十神评测

本轮新增的评测不是让模型点评模型，而是直接评测本地确定性规则引擎。panel 上的用神、喜忌、目标十神来自代码计算，不来自大模型，因此可以用固定四柱复现——可复现性是这套系统区别于传统命理话术的核心标准：同一个命例，今天算和明天算、这台机器算和那台机器算，结论必须一致，否则规则本身就有问题。

评测资料见 docs/eval/yongshen-eval-2026-06.md，复现脚本见 scripts/eval-yongshen.mjs。

古籍/教材命例
    │
    ├─► 提取四柱、性别、日主、月令、教材用神与喜忌
    │
    ▼
本地规则引擎反查
    │
    ├─► buildCompleteBaziDetail()
    ├─► BaziRuleEngine.getFavorableUnfavorable()
    └─► 输出 five_shens / favorable / unfavorable
    │
    ▼
逐案对照
    │
    ├─► 吻合：用神五行与喜忌方向一致
    ├─► 部分：方向相近，但主用神或取法有冲突
    └─► 偏差：落到教材忌神或方向相反
    │
    ▼
归因修复
          从儿格、调候为急、印星救主、弃官就印、无根比劫闸门等规则逐项修正

Panel 同源校验

八字问事的页面展示分成三层：

层级	作用	约束
Tier 1	总结与可读解读	模型负责组织语言，但不得重写干支、用神和岁运关系
Tier 2	命局用神、喜忌、格局、调候	来自八字档案与本地规则，进入 prompt 作为稳定上下文
Tier 3	静态 / 动态 panel	来自 state_report、dynamic_report、timing_candidates，用于展示原局状态和岁运引动

高置信链路会要求解读贴合 panel 计算结果；低置信或开放型问题则显示为策略建议或边界说明，不强行伪造目标十神。这样可以减少"文字读起来很有说服力，但和底层计算无关"的问题——语言的说服力和结论的正确性，从来是两件事。

历史记录迁移

旧报告继续保留 analysis_mode、旧字段和旧展示结构。新版读取时先做迁移：

旧 analysis_mode
    ├─ status  → dynamic_current + backend_shishen
    ├─ timing  → dynamic_scan + backend_shishen
    ├─ pattern → static_structure + backend_shishen
    ├─ character / llm_derived → portrait + backend_shishen 或 llm_derived
    └─ profile_driven → open_strategy + yongshen

前端仍保留空态和字段兜底，因此旧记录不会因为新 schema 变空，新记录也不需要继续背负所有旧字段。

---

技术栈

前端框架      Vue 3、组合式接口、Pinia、Vue Router、vue-i18n
后端          Cloudflare Workers
数据库        Supabase Auth、Postgres、行级安全策略
AI 模型       DeepSeek（OpenAI 兼容接口；问事模型经 QUESTION_MODEL 逐环境配置），SSE 流式输出
历法计算      lunar-javascript、iztro（紫微排盘）
MCP           @modelcontextprotocol/sdk、zod（packages/xuanxue-mcp，stdio）
构建工具      Vite
测试          Node.js Test Runner
线上形态      Cloudflare Pages + Cloudflare Workers

工程特性

• 确定性算分：日运、周运、月运、年运评分由本地规则引擎生成，大模型不能擅自改分
• 结构化推演链路：问事先分流到奇门、八字或联合推演；八字内部再按当前状态、应期窗口、格局适配、人物画像等问题类型走不同链路
• 流式问事与自愈重试：问事采用哨兵分段 SSE 流式输出，规则产物先上屏、AI 解读逐段补齐；结构校验未过（空流 / 核心段缺失 / data_json 不可解析）会自动清空半截内容并非流式重试一次
• 问事追问：奇门 / 八字支持同一局追问深挖，判断器先分流「深挖 / 新事」，补算走白名单确定性计算，大模型只读结果、只做增补不覆盖正本
• 问事模型可切换：通过 QUESTION_MODEL 环境变量逐环境配置问事模型（代码默认回退 pro），当前各环境切 flash 验证，便于对比稳定性与质量
• 反臆造护栏：提示词强约束 AI 只能引用后端实际盘面 / 四柱字段，不得脑补不存在的符号与生克关系，也不得把内部量化指标数值带进用户文案
• 缓存分层：日运、周运、月运、年运与月运详批写入数据库，前端也有本地缓存与内存缓存
• 预热机制：登录后可预热未来七天日运，减少首次打开等待
• 接口兜底：八字解读失败时回退本地规则，运势文案失败时仍先展示分数
• 测试覆盖：覆盖跨域配置、八字接口、访客模式、缓存、预热、月运、年运等核心逻辑
• 上下文注入：命主长期笔记和月度现实状态独立存储，生成月运详批时自动进入 Prompt
• 审计留痕：奇门与八字问答保留路由、规则、Prompt、模型输出和后处理快照，方便校准
• 单文件接口入口：所有后端接口收敛在 worker/src/index.js，方便维护与审计

---

本地开发

需要 Node ≥ 22.12（引擎通过 require(esm) 复用 src/utils 下的函数）。npm test 分两段：先跑全部单元与 e2e 测试，再单独串行跑 MCP 打包冒烟测试（需联网安装一次依赖）。

npm install
npm run dev
npm test
npm run build

后端本地调试

cd worker
npx wrangler dev

后端会在 http://localhost:8787 启动，前端代理会自动将 /api/* 请求转发到该地址。

---

运维说明

这是作者维护的个人网站，线上服务由 Cloudflare Workers、Cloudflare Pages、Supabase 与 DeepSeek 接口组成。本文档只保留项目形态与本地开发说明，不提供公开部署教程、密钥配置或自建实例步骤。

数据库迁移脚本保留在 docs/sql/，用于作者维护表结构与功能迭代。

---

项目结构

/
├── worker/          # 后端接口入口与 Cloudflare Workers 配置
├── packages/
│   ├── xuanxue-mcp/  # MCP server（工具、解读守则 prompts、prepack 打包脚本）
│   └── xuanxue-dsh/  # DeepSeek Harness 插件（薄壳：MCP 接入配置 + 解读守则 skill）
├── .claude/skills/  # 奇门 / 八字 / 紫微 Agent Skills（.agents/skills/ 为同内容副本）
├── knowledge/ziwei/ # 紫微规则、释义与出处元数据
├── schemas/         # CLI 统一输出外层的 JSON Schema
├── lib/             # 奇门、八字、运势评分和提示词构建核心逻辑
│   ├── birthInput.cjs               # 统一出生信息解析与真太阳时
│   ├── cliEnvelope.cjs              # CLI 统一输出外层与错误码
│   ├── normalizeShenProfile.js      # 四维用神归一化
│   ├── calculateTiaohouRatio.js     # 调候拦截器
│   ├── calculateShenshaImpact.js    # 神煞旺衰折算
│   ├── baziStateAssessor.js         # 原局目标十神/宫位状态评估
│   ├── baziDynamicAssessor.js       # 大运流年动态引动评估
│   ├── baziTargetElement.js         # 问题域目标十神与宫位解析
│   ├── baziImageAssessor.js         # 从格、专旺、化气等特殊气势评估
│   ├── calculateDailyScore.js       # 日运算分引擎
│   ├── fortuneWeeklyCore.js         # 周运算分与周度标签
│   ├── calculateMonthlyScore.js     # 月运算分引擎
│   ├── calculateAnnualScore.js      # 年运算分引擎
│   ├── fortuneContextNotes.js       # 命主与月度断事笔记
│   ├── fortuneMonthlyInterpretationCore.js # 月运详批 Prompt 与缓存合并
│   ├── baziQuestionCore.js          # 八字命局问事细分链路
│   ├── wenshiFollowup.js            # 问事追问：深挖/新事判断器与补丁 prompt
│   ├── divinationRouter.js          # 术数分流与语义路由
│   ├── constants/                   # 调候表、干支关系常量
│   └── classics/                   # 经典规则数据
├── src/             # Vue 前端应用
│   └── utils/
│       ├── baziLocalMatrix.mjs      # 四柱矩阵计算
│       ├── baziTransit.mjs          # 大运流年流月推算
│       ├── baziShensha.mjs          # 神煞计算
│       └── baziInterpretation.mjs   # 解读字段解析
├── docs/
│   ├── eval/
│   │   └── yongshen-eval-2026-06.md # 用神/目标十神古籍命例评测
│   ├── bazi-prompt-assembly-prd.md  # 八字问事链路工程规范
│   ├── bazi-score-engine-prd.md     # 运势算分引擎重构规范
│   ├── bazi-target-element-resolution-prd.md  # 目标元素解析规范
│   ├── bazi-original-state-assessment-prd.md  # 原局状态评估规范
│   ├── qimen-scoring-engine-improvement.md    # 奇门评分引擎改进记录
│   └── sql/                         # 数据库迁移脚本
├── scripts/
│   ├── bazi_cli.cjs                  # 八字 CLI（技能 / MCP 共用）
│   ├── ziwei_skill_cli.cjs           # 紫微 CLI
│   ├── qimen_cli.cjs                 # 奇门 CLI
│   ├── calendar_cli.cjs              # 历法 CLI
│   ├── astro_cli.cjs                 # 西洋星盘 CLI
│   └── eval-yongshen.mjs             # 用神评测复现脚本
├── mock/            # 前端访客与测试模拟数据
├── public/          # 静态资源与单页应用兜底配置
├── archive/         # 历史接口与旧版原型
└── package.json

---

效果展示

 

奇门结果卡片包含：

• 态势评分、五段式解读、评分依据与风险标签
• 九宫排盘可视化，值符、值使、空亡、马星同步标注
• 破局时辰、有利方位、有利时间与行动锦囊
• 结果页应验反馈入口

 

八字全息面板包含：

• 阳历、农历、四柱录入，支持出生地与真太阳时校正
• 四柱主星、藏干、星运、自座、空亡、纳音、神煞与专业细盘
• 大运、流年、流月联动时间轴
• 生克合化可视化与应对锦囊
• 八字校准反馈与解读再生成

 

运势面板包含：

• 日运：七日切换、分数先行、解读异步补齐、吉时与开运指南
• 周运：自然周切换、七日曲线、顺势日/谨慎日、周度标签与事件提醒
• 月运：节气流月、月度曲线、高低分日、低谷期、多维度月度详批
• 年运：前后十年区间、大运背景、流年十神、原局关系与岁运信号
• 命主切换与前端缓存回放

---

设计理念

每一条工程原则，背后都有一个更早的思想立场——这里把它们摊开写清楚。

诚实先于讨喜

提示词中明确禁止"因为问题积极就给出乐观结论"。不利的可能性必须如实呈现，有利的判断才有分量。这不是玄学忌讳，而是任何决策系统的基本诚信——波普尔说一个理论如果不能被证伪就没有科学价值，同理，一个报喜不报忧的系统不是在帮你判断，只是在讨好你，它已经放弃了对现实的忠实描述。

结构先于修辞

日主强弱、喜忌关系、日月年评分都由本地确定性引擎完成。大模型是表达层，不是判断层——语言可以写得漂亮，但不能替代结构本身去下结论。这也是柏拉图区分"意见"（doxa）与"知识"（episteme）的老问题：说得动听不等于说得对，修辞的说服力和命题的真值是两条不同的轴。

推演先于自由发挥

八字问答经过语义路由 → 目标元素解析 → 原局状态评估 → 动态引动判断四步确定性处理后，AI 才介入表达。同一个问题，不同模型拿到的上下文是相同的，结论不会因为换了个模型就漂移——这是一种朴素的可复现性追求，跟科学方法论关心的东西没有本质区别：一个结论如果依赖于"谁来算""用哪个模型算"，它描述的就不是结构本身，而是算它的人。

语境决定意义

同一个盘面信号，在事业、感情、健康、竞技、交易中含义不同。这不是"怎么解读都行"的相对主义，而是任何符号系统的基本性质：维特根斯坦讲"意义即用法"，一个符号脱离具体语境去谈含义是没有意义的。项目通过问题域、八字档案与现实背景，把象意落到更具体的处境里，而不是让同一个符号在所有场景下都讲同一个故事。

这套系统提供的是概率地图，不是命运判决

奇门与八字给出的是"在当前结构下，哪些路径更顺、哪些时间点更值得留意"的参考，不是"事情一定会怎样"的断言。局是结构，人是变量，能不能走通，最后还是取决于局中人怎么选、怎么做——荀子讲"制天命而用之"，承认规律存在，但不因此放弃能动性；这也是本项目对"命理"这两个字最诚实的理解方式。

---

鸣谢

• 《周易》"穷则变，变则通，通则久"——把变化本身当作可以被结构化认知的对象，这是整个项目方法论上的起点
• 《道德经》"知常曰明"——理解规律不是故弄玄虚，反而是一种朴素的清醒
• 荀子《天论》"制天命而用之"——承认规律的存在，但不因此放弃行动的主动权
• 陆致极《当代八字》— 动态分析理论（目标元素 → 原局状态 → 岁运引动）
• lunar-javascript — 干支历法底层计算
• DeepSeek — AI 推演引擎
• Supabase — 数据库与认证服务
• Vue 3 — 前端框架
• Vite — 构建工具
• Cloudflare Workers — 无服务器接口运行时

---

开源协议

MIT License · 可自由使用、修改与分发，保留原作者声明即可。

结构可以推演，选择终究是自己的。
这套系统能告诉你局势大概是什么形状，却替代不了你在局中怎么走——它给出的是地图，不是脚步。