简体中文 · English
把占星与中国术数，收进一个原生 Windows 工作站
Western astrology and Chinese metaphysics, in one native Windows workstation
下载安装包 · 完整中文说明 · English Guide · 所有版本
星阙 Horosa 是一套桌面端的玄学工作站。西方占星的本命、推运、关系盘，连同八字、紫微、奇门、六壬、太乙这些中国传统术数，被放进同一个原生 Windows 应用里——不必在十几个网页排盘器之间来回切换，也不必自己拼装 Python、Java 与历表运行时。它以 NSIS 离线安装包的形式交付，运行时随包自带，全新 Windows 10/11 x64 机器下载即用。
Horosa is a desktop workstation for traditional cosmology. Western natal, timing, and relationship astrology sit beside Chinese systems—Bazi, Ziwei, Qimen, Liuren, Taiyi—inside one native Windows app, so you stop juggling a dozen web tools and never hand-assemble a Python/Java/ephemeris runtime yourself. It ships as an offline NSIS installer with the runtime bundled in, ready to run on a clean Windows 10/11 x64 machine.
普通用户直接下载离线安装包，像任何 Windows 软件一样安装打开即可。无需自备 Python 或 Java，运行时已随包交付；更新只替换程序与共享组件，不会清空你的命例数据。首次启动会因解包与校验稍慢，之后复用本地缓存。
Regular users grab the offline installer and open it like any finished Windows app. No Python or Java to install yourself—the runtime ships inside the package—and updates replace the program and shared runtime without wiping your saved charts. The first launch is a little slower while the runtime is extracted and verified; later launches reuse the local cache.
适合：Windows 10/11 · x64 · 弱网 / 离线环境 · 首次安装 · 转发给他人。
安装包当前未做 Authenticode 签名，首次运行 SmartScreen 可能提示「更多信息 → 仍要运行」。 The installer is not yet Authenticode-signed, so SmartScreen may ask you to choose "More info → Run anyway" on first launch.
占星工作区 — 左侧起盘参数，中间图盘画布，右侧信息 / 相位 / 行星 / 古典 / 格局页签。
Astrology workspace — chart controls on the left, the wheel in the center, detail tabs on the right.
三式工作区 — 起盘参数、九宫盘面、概览 / 太乙 / 神煞 / 六壬 / 八宫页签同屏。
Sanshi workspace — setup, the nine-palace plate, and overview tabs in one view.
导航弹层 — 命盘推运、易与三式、工具工作台分组，支持搜索与最近使用。
Command overlay — charts, Yi & Sanshi, and tools, with search and recents.
导航把所有模块归为三组：命（命盘与推运）、卜（易与三式）、工具。下面是各组里实际可用的内容。
Everything lives under three groups: 命 charts & timing, 卜 divination, and 工具 tools. Here is what each one actually ships.
这一层的强项是连贯：读本命、沿时间把它推开、再带进第二个人，全程不离开同一个工作面。
| 模块 | 说明 |
|---|---|
| 占星 Astrology | 本命盘与三维盘（Babylon.js 实时 3D），多种宫位制与古典 / 现代行星集 |
| 星运 Timing | 主限法（Primary Directions）、黄道星释（Zodiacal Releasing）、法达（Firdaria）、小限（Profection）、太阳弧（Solar Arc）、太阳 / 太阴返照、十年法、推运、星历 |
| 合盘 Relationship | 比较盘、组合盘、影响盘、时空中点盘、马克斯盘 |
| 辅盘 Specialty | 希腊星术（界限 / 阿拉伯点）、量化盘 / 中点树（汉堡学派）、星体地图（占星地理定位）、调波盘 |
| 印占 Vedic | 北 / 南 / 东印度盘，恒星黄道 |
| 七政 Qizheng | 七政四余、七政 Moira |
| 八字 Bazi · 紫微 Ziwei | 四柱排盘；紫微斗数含四化盘 |
| 数算 · 其他 | 邵子神数、铁板神数、演禽等数术方法 |
易与三式不止是几个独立页签，三式合一已做成一个真正能工作的整合面。
| 模块 | 说明 |
|---|---|
| 三式 Sanshi United | 奇门、太乙、六壬整合面：概览、太乙、神煞、六壬、大格、小局、参考、八宫 |
| 遁甲 Qimen · 六壬 Liuren · 太乙 Taiyi | 三式各自的独立排盘入口 |
| 六爻 Liuyao · 分至 Jieqi · 风水 Feng Shui | 纳甲六爻、节气盘、风水工具 |
| 其他 More | 宿盘、金口诀、统摄法、皇极经世、五兆、太玄、荆诀、神易数 |
| 模块 | 说明 |
|---|---|
| AI 分析 AI Analysis | 接入 OpenAI / Anthropic / Gemini / Ollama / OpenRouter / 自定义端点；流式对话、历史记录、资料库（向量检索）、把任一技法的盘面挂载进上下文、按技法 / 页签结构化导出，并可生成八字 / 紫微分节命理报告 |
| 天文馆 Planetarium | Babylon.js 实时三维天象 |
| 黄历 Almanac | 农历 / 节气 / 择日 |
| 辅助 References | 八卦类象、十二宫、规则速查 |
命盘与事盘都能本地保存：带标签、快照、后端原始数据，可 JSON 导入导出，重开后恢复现场。
Charts and cases save locally—tags, snapshots, raw backend payloads, JSON import/export, and full restore on reopen.
- 前端 Frontend — React 17 + Umi 3 + TypeScript，Ant Design；D3 绘盘，Babylon.js / Three.js 三维，Plotly 星体地图，Monaco 编辑 AI 导出模板。
- 后端 Backend — Java 17 / Spring Boot 承载占星与中国术数核心服务；Python 3.11 服务层封装 Swiss Ephemeris（
pyswisseph）与 vendored 的 kentang 传统术数引擎。 - 桌面壳 Desktop — Electron 原生外壳，启动时在后台拉起本地 Python / Java 服务并做健康检查；窗口、缩放与设置状态持久化。
- 运行时 Runtime — 内置 Python 采用固定版本的 python-build-standalone（可复现、自包含），随包附带 VC++ 运行时、离线 wheels 与后端 jar；构建期有原生依赖与发布前自检闸门。
- 发布 Distribution — 面向 Windows 10/11（
x64）的离线 NSIS 安装包，支持选择安装目录与升级；附latest.yml/.blockmap/SHA256SUMS.txt更新与校验资产。
普通用户从上方 Releases 下载安装包即可——运行时随包自带，无需任何手动配置。
想自行构建或自托管网页端的开发者：完整产品源码随仓库发布于 local/workspace/Horosa-Web-…/（前端 astrostudyui · Java 后端 astrostudysrv · Python 排盘 astropy · 术数引擎 vendor · 星历 flatlib-ctrad2）；运行时准备脚本见 prepareruntime/，Windows 适配层见 windows-adaptations/。桌面打包工程（Electron + NSIS）私有维护、不在本仓库。Windows 下用 Git Bash 或 WSL 跑 *.sh：
- 工具链：Java 17 / Maven / Node 18+ / Python 3.11
- 用 Maven 构建
astrostudysrv/产出astrostudyboot/target/astrostudyboot.jar（仓库发布源码，不含预编译 jar） bash start_horosa_local.sh（构建前端 + 拉起 Python8899/ Java9999+ 打开页面）·verify_horosa_local.sh·stop_horosa_local.sh
The full product source ships under
local/workspace/Horosa-Web-…/(frontendastrostudyui/ Javaastrostudysrv/ Pythonastropy/ enginesvendor/ ephemerisflatlib-ctrad2); runtime-prep inprepareruntime/, Windows patches inwindows-adaptations/. The desktop packaging project (Electron + NSIS) is maintained privately. On Windows use Git Bash or WSL; toolchain Java 17 / Maven / Node 18+ / Python 3.11; build the backend jar with Maven, thenbash start_horosa_local.sh.
- README_ZH.md — 中文完整说明 / full Chinese guide
- README_EN.md — full English guide
- CONTRIBUTING.md · SECURITY.md · SUPPORT.md · CITATION.cff · LICENSE
- 历史版本与完整发布说明 / release history & notes: GitHub Releases
星阙的源流不能忘。最早的星阙 Horosa 由郑大哥一手创建，**荀爽（Herakleios，爽哥）**参与辅助设计，并把相关 App 与 Web 公开出来，后来者才有得研究、学习与延展。本项目正是在他们搭好的星阙体系、术数工作流与公开分享精神之上，继续做 Windows 交付、运行时打包、功能整合与体验改良。也感谢每一位持续测试、反馈、修复，推动 Horosa 变得更完整的人。
特别感谢 kentang2017 长期公开的传统术数 Python 项目。Horosa 接入或适配了其中多项计算引擎——已声明 MIT 的上游在对应 vendored 目录与 THIRD_PARTY_NOTICES.md 保留许可证；未找到明确开源声明的项目则单独标注，避免混同。
The lineage matters. Horosa was originally created by 郑大哥, with auxiliary design by 荀爽 (Herakleios), who released the App and Web that made later study and extension possible. This Windows edition builds on that groundwork—adding Windows delivery, runtime packaging, integration, and polish—with gratitude to them and to everyone who keeps testing and fixing along the way. Special thanks to kentang2017, whose openly shared Python projects power several of Horosa's calculation engines.