乾为天，坤为地，阴阳交泰，万物生焉。
在现代计算机的世界里，二进制（0和1）是所有运算的基石。它高效、简洁，却略显冰冷。我们是否可以在不改变底层计算的前提下，为这串数字赋予文化的温度？
阴阳进制（YinYang Binary System） 正是这样一次尝试：用中国传统文化中的八卦符号（乾、兑、离、震、巽、坎、艮、坤）来呈现二进制数据，让机器语言以一种更直观、更有文化韵味的方式出现在人类眼前。
今天，我们正式将阴阳进制技术规范 v1.2 开源，并同步发布转换工具、羲和语言字面量扩展、乾坤OS接口定义及羲和CPU架构草案。所有内容均已在 Gitee 上公开，欢迎下载、使用、参与共建。
一、什么是阴阳进制？
阴阳进制不是一种新的数制，而是二进制的文化显示层。它将每3位二进制（000111）映射为一个八卦符号（乾坤），让数据在终端、调试器、编程语言中以八卦的形式呈现。
机器语言层： 10110010 ← 二进制（CPU内部，永远不变）
↓
显示层： 初爻坎离 ← 八卦符号（人类可读）
它完全等价于八进制，但用八卦替代了0-7的数字，使数值与易经卦象产生联系，既保留了底层二进制的高效，又赋予了技术以文化内涵。
二、为什么要做这件事？
文化传承
八卦是中华文化的核心符号之一，每一卦都有其哲学含义（乾为天、坤为地、坎为水……）。当我们在调试器里看到“坎”而不是“5”时，冰冷的数字突然有了温度。
教学友好
在计算机组成原理课程中，二进制分组（3位一组）是基础。用八卦符号来教学，学生能更快记住每组对应的数值，并理解八进制的本质。
三位一体
阴阳进制不仅仅是符号替换，它已经融入整个“羲和”技术生态：
- 羲和语言：支持直接写
爻 状态 = 坎这样的八卦字面量。 - 乾坤OS：提供系统调用，让终端、调试器、内存查看器以八卦模式显示。
- 羲和CPU：寄存器以八卦命名（乾、兑、离、震、巽、坎、艮、坤），指令集包含中文助记符。
三、核心设计一览
八卦符号映射表
| 八卦 | 符号 | 二进制 | 十进制 |
|---|---|---|---|
| 乾 | ☰ | 000 | 0 |
| 兑 | ☱ | 001 | 1 |
| 离 | ☲ | 010 | 2 |
| 震 | ☳ | 011 | 3 |
| 巽 | ☴ | 100 | 4 |
| 坎 | ☵ | 101 | 5 |
| 艮 | ☶ | 110 | 6 |
| 坤 | ☷ | 111 | 7 |
转换示例
- 十进制 165 → 二进制
10100101→ 分组10 100 101→ 前缀“初爻” + 巽(100) + 坎(101) = 初爻巽坎 - 十进制 178 → 二进制
10110010→ 分组10 110 010→ 前缀“初爻” + 坎(101) + 离(010) = 初爻坎离
前缀规则
由于二进制位数不一定能被3整除，我们定义了：
- 终爻：最高位剩余1位（补1个0）
- 初爻：最高位剩余2位（补2个0）
例如：1 → 终爻乾，2 → 初爻离。
四、你可以立即体验
我们提供了一个Python命令行工具 阴阳进制转换工具.py，无需安装任何依赖，即可体验八卦与数字的互转。
python 阴阳进制转换工具.py 178
# 输出：初爻坎离
python 阴阳进制转换工具.py -r 初爻坎离
# 输出：178
python 阴阳进制转换工具.py -v 165
# 显示详细的转换过程
工具支持十进制、十六进制（0x）、二进制（0b）输入，反向转换也完全支持。
五、开源仓库与文档
所有技术规范、接口定义、示例代码均已上传至 Gitee，采用 CC BY 4.0 许可证（文档）和 玄同工作室公开许可证（整体项目），允许任何个人和机构自由使用、修改、传播，只需保留署名。
包含以下核心文档：
- 《阴阳进制技术规范 v1.2》
- 《乾坤OS阴阳进制编程接口规范》
- 《阴阳进制系统运行论证》
- 《羲和语言八卦字面量扩展》
- 《羲和CPU阴阳进制架构 v1.0》
六、未来计划
- 短期：完善转换工具，增加Web在线版；与高校合作，将阴阳进制纳入计算机课程。
- 中期：开发羲和语言编译器原型，支持八卦字面量；推出乾坤OS的阴阳进制显示模式。
- 长期：探索羲和CPU硬件实现（调试接口输出八卦符号）；建设开源社区，吸引更多贡献者。
七、加入我们
如果你对中文编程、传统文化与现代技术融合感兴趣，欢迎：
- 给仓库点个 Star，让更多人看到
- 提交 Issue 或 Pull Request，参与规范完善
- 使用工具，并分享你的使用体验
- 将阴阳进制引入你的课堂、项目或产品
让冰冷的二进制数据，拥有文化的温度。
乾为天，坤为地，阴阳交泰，万物生焉。
期待与你一起，书写东方计算的新篇章。
玄同工作室
2026年3月
