CompassEx 罗盘算法类库 · 核心能力说明（合规技术版）

CompassEx 是一套面向 .NET 平台的传统罗经方位数字化算法类库，专注于古天文方位体系、传统地理罗经圈层的标准化数值建模与高精度角度换算。项目以纯数学计算、坐标映射、圈层规则复现为核心，仅用于传统文化数字化、古建筑方位研究、罗盘可视化渲染、地理方位测算开发，不包含任何吉凶预测、命理判断逻辑，合规可用于开源学习与商业技术集成。

类库完整复现传统罗盘主流圈层与派系算法，覆盖八卦体系、二十四山、双六十四卦圈层、三元/三合双流派、周天度数高精度映射全链路计算能力，是目前国内少有的完整开源、可商用的标准化罗盘底层算法库。

一、八卦体系核心算法

精准实现两套传统标准八卦方位模型，支持角度匹配、卦位判定、阴阳属性、方位区间计算：

• 先天八卦（伏羲八卦）：复现先天卦标准方位排布、对称方位关系、先天数理映射算法，适配传统天文本位方位逻辑。

• 后天八卦（文王八卦）：实现民用地理方位标准排布、四时方位对应、区间角度划分，适配传统地理应用场景的方位规则。

二、二十四山高精度方位算法

基于周天360°标准化等分模型，完整实现二十四山全域角度拆解，每山精准对应15°标准区间，支持正向、兼向、区间边界判定、山向匹配计算，兼容传统罗盘正针基础规则。可快速根据任意输入角度，反向解析对应山位、干支、四维属性，是罗盘定位的底层核心能力。

三、双层六十四卦圈层算法（天地双盘）

独家完整实现传统罗盘双六十四卦分层体系，区分天盘、地盘独立逻辑，圈层规则严格对标传统罗经标准：

• 先天六十四卦（天盘）：遵循先天卦序排布规则，实现天盘周天卦位分布、角度映射、卦序匹配、圈层对位算法。

• 后天六十四卦（地盘）：基于后天八卦推演六十四卦地盘排布，支持地理方位卦位定位、区间匹配、双层卦位联动计算。

双六十四卦算法可支撑高精度多层罗盘渲染、传统卦理方位数字化还原、古文献方位数据校验等场景。

四、三元、三合双流派罗盘算法

整合传统两大主流罗盘体系的标准化计算规则，做到一库兼容双流派，适配不同传统方位体系的开发需求：

• 三合罗盘算法：复现三合体系核心圈层逻辑、天盘缝针偏移规则、二十四山纳水对位、传统三合方位匹配体系。

• 三元罗盘算法：实现三元九运基础方位建模、玄空本位圈层规则、卦山对应、三元方位分区计算逻辑。

开发者可根据业务场景自由切换流派算法，满足不同传统文化数字化、工具类软件的开发适配需求。

五、周天度数全域换算算法

提供0°–360° 全量高精度罗盘映射能力，支持任意角度输入的全自动解析：周天度数与二十四山、八卦、六十四卦的双向互算、边界判定、角度纠偏、区间归一化处理。可对接设备地磁数据、GPS方位数据、自定义角度数据源，实现真实设备罗盘与传统罗经体系的精准对齐，完美支撑移动端、桌面端、SaaS服务的罗盘可视化与方位计算功能。

六、合规声明（固定文案，可直接用于项目）

本类库仅为传统天文地理方位、古罗盘数理规则的数字化工程实现，所有算法均为客观数学计算与方位建模，无封建迷信、无运势吉凶判断、无命理推演逻辑。仅限传统文化研究、数字文博、古建筑测绘、罗盘工具软件开发、学术演示等合规场景使用，禁止用于违规测算与商业迷信场景。

七、适用开发场景

• 跨端罗盘可视化工具（MAUI / Win / 移动端 App）

• 传统方位文化数字化、文博古籍数字化项目

• 古建筑方位测绘、地理方位辅助工具

• 合规国学文化演示、教学演示系统

• 企业定制化闭源方位计算商业系统（需购买商业授权）

---

精简版短文案（适配仓库简介/发帖推广/项目公告）

CompassEx 是一款高性能、面向 .NET 平台的传统罗经方位数字化开源算法库。项目纯数学建模实现，无命理玄学逻辑，合规可开源商用、二次开发。类库深度整合传统罗盘核心数理体系，完整实现先天/后天八卦、二十四山、先天六十四卦天盘、后天六十四卦地盘、三元罗盘、三合罗盘、周天360°度数全域换算等全套核心算法。支持角度双向互算、圈层匹配、方位纠偏、设备地磁/GPS数据对接，可快速搭建合规的罗盘可视化工具、传统文化数字化系统、古建筑方位测绘工具及企业商用方位计算服务，项目采用 AGPL-3.0 + 商业闭源双重授权模式，满足开源学习与商业落地双重需求。

（注：部分内容可能由 AI 生成）