文章目录0. 为什么要读这篇文章？1. 项目全景：九术排盘到底做了什么1.1 功能全景图1.2 核心功能运行流程1.3 九术一览1.4 排盘层的硬核特性2. 系统架构：一个引擎，四端复用2.1 架构总览2.2 技术栈速查2.3 模块架构：目录即边界3. 链路一：排盘——"玄学"里最硬核的其实是时间3.1 起占时序3.2 重难点 1：真太阳时 + 中国夏令时回拨3.3 重难点 2：节气精确时刻与"UTC+8 陷阱"3.4 重难点 3：奇门拆补定局与夜子时3.5 重难点 4：时辰反推引擎3.6 排盘精度的底气：与权威实现对拍4. 链路二：AI 解读——让大模型"说人话、还不胡说"4.1 解读时序（SSE 流式）4.2 重难点 5：双轨 Schema + 盘面事实注入4.3 重难点 6：两步管线 + Step1 缓存4.4 重难点 7：六亲事实校验 + 定向修正4.5 重难点 8：紫微三步多 Agent 编排（guanwei-pro 雏形）4.6 解读稳定性与古籍引证5. 链路三：存储与开放分发5.1 重难点 9：SQLite 统一存储与事务5.2 备份恢复：为什么不能直接 cp5.3 开放分发：MCP Server + REST API5.4 安全默认设计（全链路清单）6. 部署与运维：一行命令7. 工程质量：335 项测试与发布守卫8. 这篇文章给你的 3 个可迁移范式0. 为什么要读这篇文章？如果你是后端/全栈工程师，大概率对"玄学 App"有两个印象：要么是调接口的套壳玩具，要么是玄学内容无法验证。这个项目恰恰把这两个印象都翻过来了——排盘是 100% 确定性计算，AI 解读是带事实校验的生产级管线。它值得读的原因有三：历法计算是天文级难题：节气时刻、真太阳时、中国夏令时回拨，每一步都有坑，且全部可用外部权威星历库对拍验证——这套"可复现验证"的工程方法论，做任何日期/历法/时间敏感系统都通用。AI 结构化输出是当前最高频的生产问题：如何让大模型输出合法 JSON、如何注入事实防止编造、如何做质量门槛、如何流式返回、如何做多步编排——这里有一套完整解法。它把"软件工程"用到极致：单一算法副本、统一 SQLite 存储、MCP 开放分发、安全默认设计、发布内容守卫——小项目做出了大项目的工程纪律。免责声明：本文为技术拆解，项目定位为自托管工具，排盘与 AI 解读均跑在用户自己机器上；占问所得仅供修身养性、怡情遣兴之用，不构成任何决策依据。1. 项目全景：九术排盘到底做了什么「观微」的完整链路是：排盘 → 解读 → 归档 → 回看。一次起占，从输入出生信息（或起课时刻），到九术引擎本地计算盘面，再到 AI 按术数角色生成深度报告，自动归档