把九种玄学术数写成 TypeScript：观微「九术排盘 + AI 深度解读」全栈项目拆解

文章目录

• • 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 备份恢复：为什么不能直接 cp
    • 5.3 开放分发：MCP Server + REST API
    • 5.4 安全默认设计（全链路清单）
  • 6. 部署与运维：一行命令
  • 7. 工程质量：335 项测试与发布守卫
  • 8. 这篇文章给你的 3 个可迁移范式

0. 为什么要读这篇文章？

如果你是后端/全栈工程师，大概率对\”玄学 App\”有两个印象：要么是调接口的套壳玩具，要么是玄学内容无法验证。这个项目恰恰把这两个印象都翻过来了——排盘是 100% 确定性计算，AI 解读是带事实校验的生产级管线。它值得读的原因有三：

免责声明：本文为技术拆解，项目定位为自托管工具，排盘与 AI 解读均跑在用户自己机器上；占问所得仅供修身养性、怡情遣兴之用，不构成任何决策依据。

1. 项目全景：九术排盘到底做了什么

「观微」的完整链路是：排盘 → 解读 → 归档 → 回看。一次起占，从输入出生信息（或起课时刻），到九术引擎本地计算盘面，再到 AI 按术数角色生成深度报告，自动归档