Start Here / 先看这里

English End users should download the offline installer and open Horosa like a finished macOS app. Download the offline .pkg	中文 普通用户请直接下载离线安装包，像标准 macOS 桌面软件一样安装和打开 Horosa。 下载离线 .pkg
Maintainers should start from the bilingual guides and the current GitHub Release page instead of guessing from asset names.	维护者请从双语说明和当前 GitHub Release 页面进入，不要只靠 release 资产名反推结构。

Preview / 截图预览

At A Glance / 一眼看懂

English Horosa combines Western astrology, timing systems, relationship charts, Chinese traditional methods, Yi and Sanshi workflows, Feng Shui, and AI-oriented export controls inside one desktop surface.	中文 Horosa 把西方占星、推运体系、关系盘、中国传统术数、易与三式、风水与 AI 导出控制整合进同一个桌面工作面。
The macOS delivery is already shaped as a real desktop release: Developer ID signing, Apple notarization, offline install, update delivery, and a clear public download path.	macOS 交付已经具备正式桌面产品的基本形态：Developer ID 签名、Apple 公证、离线安装、更新交付，以及明确的公开下载入口。

Signature Workflows / 代表性工作流

Natal To Timing / 从本命到时运

English: Start from natal and 3D chart reading, then move into primary directions, zodiacal releasing, firdaria, profection, solar arc, returns, and annual methods without leaving the same desktop product.

中文：从本命盘和三维盘进入，再继续切到主/界限法、黄道星释、法达、小限、太阳弧、返照与流年法，不需要离开同一个桌面产品。

Relationship Analysis / 关系分析

English: The relationship layer already includes compare, composite, synastry, time-space midpoint, and Marks charts as parallel ways to inspect the same relationship.

中文：关系分析层已经覆盖比较盘、组合盘、影响盘、时空中点盘与马克斯盘，用不同结构切同一段关系。

Chinese Traditional Stack / 中国传统术数栈

English: Bazi, Ziwei, calendar, Feng Shui, and supporting references already live in the same workspace, so the product feels like a broader traditional stack rather than a single-method tool.

中文：八字、紫微斗数、万年历、风水和配套参考入口已经进入同一工作面，所以它更像一整套中国传统术数栈，而不是某一术的单点工具。

Yi And Sanshi Depth / 易与三式纵深

English: Yi and Sanshi go beyond standalone tabs through Su Zhan, Yi Gua, Liu Ren, Jin Kou, Dun Jia, Tai Yi, Tong She Fa, and a deeper Sanshi United surface.

中文：易与三式不只是单术入口，还包含宿盘、易卦、六壬、金口诀、遁甲、太乙、统摄法，以及更深的三式合一综合工作区。

Capability Matrix / 功能矩阵

Western Astrology / 西方占星

English: A continuous chain from natal reading to timing and relationship work.

中文：从本命阅读到推运、关系分析的连续链路。

• Natal chart and 3D chart / 星盘、本命盘、三维盘
• Timing stack including primary directions, returns, solar arc, and annual methods / 覆盖主限、返照、太阳弧与流年法的推运栈
• Compare, composite, synastry, time-space midpoint, and Marks charts / 比较盘、组合盘、影响盘、时空中点盘、马克斯盘

Global And Specialty Modules / 全球与专门模块

English: A broader surface than the default desktop astrology stack.

中文：比常见桌面占星软件更宽的专门模块面。

• Jieqi charts / 节气盘
• Astrocartography and planetary maps / 星体地图与地理占星
• Qizheng Siyu, Hellenistic, Indian, and quantitative views / 七政四余、希腊星术、印度律盘、量化盘

Chinese Traditional And Divination / 中国传统与术数

English: A structured traditional system rather than a decorative side module.

中文：系统化组织的传统术数层，而不是点缀式附属模块。

• Bazi, Ziwei, gua-symbol references, twelve-palace tools, and rule references / 八字、紫微斗数、八卦类象、十二串宫、规则参考
• Calendar and Feng Shui as first-class modules / 万年历与风水作为正式模块
• Yi and Sanshi modules across standalone and integrated surfaces / 易与三式兼具单术入口与整合面

Desktop Workflow / 桌面工作流

English: Controls for shaping, filtering, inspecting, and exporting analysis sessions.

中文：围绕分析、筛选、检查与导出的桌面控制层。

• Chart configuration, aspect selection, planet selection / 星盘配置、相位选择、行星选择
• Chart components and utility tools / 星盘组件与小工具
• AI export and AI export settings / AI 导出与 AI 导出设置

New In v2.0.2 / v2.0.2 新增重点

English v2.0.2 beta is a focused beta update for the 2.0 desktop train: it keeps the Qimen Dunjia parity work intact, then tightens app-wide layout, theme contrast, navigation, and packaged desktop delivery.

中文 v2.0.2 beta 是 2.0 桌面发布线的聚焦修复版：保留 2.0.1 的奇门遁甲一致性修复，并继续收紧全局布局、明暗主题、导航入口与桌面打包交付。

- Qimen Dunjia Ju selection now matches the Horosa mobile API for both Chaibu and Zhirun modes - Zhirun keeps its own section logic while using the current chart day pillar for Sanyuan - Tianpan stems, Dipan stems, doors, stars, Ju text, and Fu/Shi were checked against 300 Chabu + 300 Zhirun real mobile-API cases - local fallback now follows exact solar-term transition times and keeps Zi-hour day switching at the mobile-compatible default - desktop Eight Gods labels intentionally retain the established 虎 / 玄 display preference - app-wide side panels, bottom quick actions, Fen/Zhi pages, Liuren circular layout, BaZi luck rows, and Dice chart masking were polished for dark and light themes - duplicate navigation entries were removed while keeping the larger primary module entry - notarized offline .pkg, app zip, runtime archive, and manifest are aligned as 2.0.2 / 2.0.2-runtime1

- 奇门遁甲拆补与置润的起局结果对齐 Horosa 手机版 API - 置润保留自己的节气段逻辑，但三元改按当前盘日柱判定 - 天盘干、地盘干、八门、九星、局数、值符值使已用 300 个拆补 + 300 个置润真实手机版 API 案例对照 - 本地兜底历法按准确交节时分判断节气，晚子时默认保持手机版兼容口径 - 桌面端八神显示有意保留既有 虎 / 玄 口径 - 全局侧栏、底部快捷功能、分至页、大六壬圆盘、八字运表与占星骰子盘面遮罩已按明暗主题继续打磨 - 清理重复导航入口，只保留更醒目的主入口 - 公证离线 .pkg、app zip、runtime 包与 manifest 统一对齐到 2.0.2 / 2.0.2-runtime1

Get Started / 下载与文档导航

English Public install entry: Horosa-Installer-macos-arm64-offline.pkg Best for Apple Silicon users, weak-network environments, offline forwarding, and first-time installs. Open download

中文 公开安装入口：Horosa-Installer-macos-arm64-offline.pkg 适合 Apple Silicon、弱网环境、离线转发和第一次安装的普通用户。 打开下载

Documentation / 文档导航

English README_EN.md: full English guide README_ZH.md: Chinese full guide v2.0.2 release page All releases Installer internals

中文 README_ZH.md：中文完整说明 README_EN.md：英文完整说明 v2.0.2 版本页面 所有 Release 安装器内部说明

Developer Entry / 开发者入口

English Understand the public-facing repository layout: README.md Inspect installer internals and publishing flow: Horosa_Desktop_Installer/README.md Read the current beta release page: v2.0.2 Beta Enter the application source tree: Horosa-Web/ Inspect runtime and diagnostics: runtime/, diagnostics/

中文 理解首页与用户入口：README.md 查看安装器与发布链路：Horosa_Desktop_Installer/README.md 阅读当前版本页面：v2.0.2 进入主工程源码：Horosa-Web/ 查看运行时与诊断：runtime/、diagnostics/

Acknowledgements / 致谢

本项目为参考星阙 Horosa-荀爽（Herakleios）所发布的星阙 App 和 Web，并在 macOS 交付、运行时打包、功能整合与使用体验上继续改良制作。源流不可忘：星阙 Horosa 最早由郑大哥一手创建，荀爽（Herakleios）曾参与辅助设计，并将相关 App 与 Web 版本公开出来供后来者研究、学习与延展。

请不要忘记爽哥和郑大哥的贡献。这个 macOS 版本的继续整理与发布，建立在前人已经搭起的星阙体系、术数工作流和公开分享精神之上。也感谢所有持续测试、反馈、修复和推动 Horosa 变得更完整的人。

This macOS edition is an improved distribution and integration work based on the Horosa App and Web released by Horosa-荀爽（Herakleios）. The lineage matters: Horosa was originally created by 郑大哥, with auxiliary design work from 荀爽（Herakleios）, and their public release made later study, maintenance, and extension possible.

Please do not forget the contributions of 爽哥 and 郑大哥. This repository continues from their groundwork with respect, gratitude, and the hope that Horosa can remain useful to more people over time.