这套奇门起局 App 核心设计思路就是把时间基准模块、坐标位置模块、排盘核心引擎三者彻底解耦,不再绑定系统本地时间、GPS 定位,用户可以自由切换北京时间、UTC、自定义本地时间,也可以单独修改经纬度,时间和坐标互不锁死;传统奇门 App 大多是时间跟着定位走、定位一变自动改真太阳时,很难做复盘、跨地点推演、历史局复现,解耦之后,输入、校正、排盘、渲染分层,同一个时间可以快速切换不同地点看盘,同一个地点也可以自由改任意历史时刻,同时支持拆补、置闰、茅山法多种起局流派,方便开发调试、案例存档、多端同步。
一、四层解耦架构(核心模块拆分)
1、时间基准层(独立可配置,不绑定坐标)
- 原始输入源:系统当前时间、手动录入公历 / 农历、导入历史案例时间戳、UTC 时间
- 时间口径切换开关:北京时间(民用时)、平太阳时、真太阳时,晚子时规则可选(23 点换日 / 0 点换日)
- 自定义参数:时区偏移、手动加减时差,支持关闭自动真太阳时校正
- 输出:标准化 UTC 时间戳,作为传给排盘引擎的唯一标准输入,避免本地时区混乱
重点:这一层只负责时间换算,不读取、不依赖经纬度
2、空间坐标层(独立模块,不绑定时间)
- 输入源:GPS 自动定位、城市选择、直接手动输入经纬度、历史点位存档
- 内置能力:经度用来计算真太阳时差校正项,纬度预留给后续风水、太阳高度扩展
- 坐标缓存:点位命名保存,比如 “北京办公室、广州工地”,可以一键复用
重点:坐标只在
【真太阳时转换步骤】才参与运算,时间基准本身不受坐标改动影响
3、奇门排盘引擎层(纯计算、无 IO、无读取系统时间)
- 输入:标准化 UTC 时间戳 + 起局规则配置(拆补 / 置闰、转盘 / 飞盘、寄宫规则)
- 内置算法:节气时刻计算、阴阳遁判定、三元局数、旬首、值符值使、九星八门八神排布
- 特点:无状态纯函数,相同入参永远输出完全一样的盘,方便单元测试、案例复现、云端校验
- 不主动读 GPS、不自动抓系统时钟,所有参数由上层传入,这是解耦的关键
4、UI 展示与持久化层
- 九宫视图、罗盘视图、原始局信息面板
- 存档存储:一条记录同时保存【基准时间、时区、坐标、起局流派、盘结果】,打开存档时所有参数原样恢复
- 导出:JSON / 图片,方便分享复盘案例
二、时空解耦的数据流流程(标准执行步骤)
- 用户输入基准时间(可以随便改,和地点无关),系统转为 UTC 基准时间戳
- 用户选择 / 修改坐标(可以随便换地点,不改动上面的 UTC 时间)
- 用户选择是否启用真太阳时:
- 关闭:直接拿 UTC 时间进排盘引擎
- 开启:用坐标经度计算时差,对 UTC 时间做真太阳时校正,生成校正后的时辰基准
- 校正后的时辰基准 + 流派配置,送入无状态排盘引擎算出全盘
- 渲染九宫盘,同时界面上展示:原始输入时间、时区、坐标、是否开启真太阳时、校正后的时辰
- 存档:把全部输入参数打包保存,不是只存最终盘面,方便以后重新演算、换规则重算
三、解耦方案对比传统紧耦合方案
| 对比项 | 时空解耦设计(本方案) | 传统 App 紧耦合设计 |
|---|---|---|
| 时间与坐标关系 | 互相独立,任意组合,改坐标不改时间 | GPS 定位自动绑定时间,换地点自动改时辰,不能单独组合 |
| 历史复盘 | 可以固定一个时间,遍历多个地点看盘 | 要复盘异地案例,必须手动改时间 + 地点,容易错乱 |
| 调试单元测试 | 引擎纯函数,直接传入固定时间戳、坐标,结果稳定 | 依赖设备系统时间、GPS,自动化测试很难写 |
| 自定义基准时间 | 支持任意历史、未来时间,UTC 自由偏移 | 大多只能选本地时间,自定义时差功能弱 |
| 扩展能力 | 方便增加择时、多地点对比、批量起局 | 联动逻辑缠死,新增功能容易出时辰 bug |
四、开发中高频踩坑清单
- 真太阳时校正时机搞错:不要在原始输入时间直接改,要把 UTC 作为中间基准,防止叠加多次时差
- 晚子时口径冲突:23 点换日和 0 点换日两套规则分开,不要混在同一个计算分支
- 存档只存盘面,不存原始参数:后期想换置闰 / 拆补重算就做不到
- 排盘引擎偷偷读取系统时间:失去确定性,同一参数不同时刻算出来盘不一样
- 时区和经度校正混淆:北京时间是 UTC+8,经度校正是 4 分钟每度,两套算法分开写,不要合并
五、最小接口示例(前后端 / 内核分离)
输入参数
{
baseUtcTime: "2026-11-22T04:00:00Z",
location: {lng:116.4, lat:39.9},
useTrueSolar: true,
method: "chaibu"
}
输出:结构化奇门局(地盘、天盘、九星、八门、八神、局数、阴阳遁、时辰)
【相关 FAQ】
问题 1:奇门遁甲起局 App 自定义基准时间 + 时空坐标解耦设计是什么意思?
回答 1:就是把时间模块、经纬度坐标模块、奇门排盘引擎拆成独立单元,时间和坐标互不绑定,用户可以固定一个时间,单独切换地点;也可以固定地点,随便修改基准时间,排盘内核只接收标准化时间参数,不会自动读取系统时钟和 GPS。
问题 2:奇门遁甲起局 App 做时空解耦,对比普通奇门排盘软件有什么好处?
回答 2:方便历史案例复盘、同一个时刻多地点对比推演、自动化单元测试,存档时完整保留所有输入条件,后续可以切换拆补 / 置闰规则重新演算,不会出现换 GPS 定位就乱改基准时间的问题。
问题 3:奇门遁甲起局 App 时空解耦架构里,真太阳时什么时候参与计算?
回答 3:真太阳时是可选校正环节,在基准 UTC 时间确定之后、送入排盘引擎之前,用经度单独做时差校正;关闭校正时,坐标完全不参与时间运算,做到时间基准不受坐标影响。
问题 4:奇门遁甲起局 App 时空解耦开发,排盘引擎为什么设计成纯函数?
回答 4:纯函数引擎没有外部依赖,不读 GPS、不读系统时间,相同入参每次都输出一模一样的奇门局,保证复盘一致性,方便多端同步、云端校验、批量生成局。
【参考资料】
[2026-11-18](qimen-mcp 奇门无状态排盘内核设计)LobeHub
[2026-10-20](true-solar-time-mcp 真太阳时独立换算模块)LobeHub
[2026-09-12](奇门排盘 App 时间口径、晚子时、真太阳时开发规范)电子工程世界
[2026-08-05](天文历法与节气计算本地离线引擎方案)阿里云开发者社区
【免责声明】
本文为奇门遁甲起局 App 软件工程层面的架构设计方案,仅讨论程序解耦、时间坐标换算、排盘引擎开发逻辑;奇门起局拆补、置闰等流派属于传统术数内容,不同流派起局规则存在差异,本方案只是提供可配置的技术载体,不评判流派吉凶、预测结果。
