多类型星盘计算
基于 Kerykeion 引擎生成出生盘、行运盘、合盘、组合盘以及日返盘和月返盘，覆盖个人本命与关系、周期预测等常见占星场景。
资源介绍
Astrologer Studio 是一个自由开源的专业占星工作台，面向需要长期管理大量客户资料的职业占星师，也适合希望深入查看自己出生盘的爱好者。它把星盘计算、客户数据与解读输出整合在同一个现代化界面中：底层使用开源占星引擎 Kerykeion 完成高精度计算，前端基于 Next.js 与 Tailwind CSS 构建，数据通过 Prisma 存入 PostgreSQL。
功能上，它支持出生盘、行运盘、合盘、组合盘以及日返、月返盘，并提供年度星历表与可视化星历图、可自定义筛选的行运时间线。客户管理模块可保存出生数据、地点与备注，支持标签分类和 Rodden Rating 数据可靠性标注。用户还能切换回归/恒星黄道、选择 Placidus、Whole Sign、Koch 等多种宫位制，并配置显示哪些行星、虚点与相位。AI 解读为可选功能，需自行配置模型 API。
项目采用 AGPLv3 授权，可自托管，官方也提供托管版本。需要注意的是，仓库 README 明确标注这是旧版（legacy）代码，线上版本已用新栈重写，Astrologer Studio 2 即将发布。
核心能力
客户资料管理
集中存储客户的出生数据、地点与备注，支持标签分类、搜索过滤以及 Rodden Rating 数据可靠性标注，便于职业占星师维护大量档案。
星历表与行运时间线
提供年度星历表格与可视化星历图，并配有可自定义筛选条件的行运时间线，用于追踪行星随时间的移动。
可选 AI 解读
结合 Kerykeion 计算出的星盘数据与 AI 语言模型生成上下文相关的解读内容，并支持用户自定义解读偏好；该功能为可选，需配置模型 API。
占星参数可配置
支持切换回归/恒星黄道、选择 Placidus、Whole Sign、Koch 等多种宫位制，并可配置显示哪些行星、虚点与相位，同时提供明暗主题。
自托管与订阅双模式
代码以 AGPLv3 发布，可通过 Docker 或手动方式自托管；官方同时提供 astrologerstudio.com 托管版本，订阅收入用于支持项目与 Kerykeion 引擎开发。
使用方法
使用官方托管版本：直接访问 astrologerstudio.com，无需自行部署。
Docker 自托管：克隆仓库后执行 cp .env.example .env 并按需填写 API 密钥，然后运行 docker-compose up -d 启动。
手动部署：克隆仓库后执行 bun install 安装依赖，复制并编辑 .env 配置数据库与 API 密钥。
初始化数据库：依次运行 bun run db:generate 与 bun run db:migrate 生成 Prisma 客户端并执行迁移。
创建首个用户：运行 bun run user:create -- admin yourpassword 创建管理员账号。
启动应用：运行 bun run dev，然后访问 http://localhost:3000。
使用案例
职业占星师管理客户档案
使用场景需要长期跟踪大量客户的出生数据与咨询记录
利用客户管理模块保存出生数据、地点与备注，通过标签分类和搜索快速定位客户，并用 Rodden Rating 标注数据可靠性。
关系合盘分析
使用场景分析两人关系的兼容性与互动模式
分别录入双方出生数据后生成合盘与组合盘，结合相位网格和兼容性评分卡片查看关系中的关键相位与互动结构。
年度与月度周期预测
使用场景为客户准备年度运势或月度重点提示
使用日返盘与月返盘查看年度和月度主题，再结合行运时间线与星历图定位关键行星过境时间点。
自托管搭建私有占星服务
使用场景希望数据完全掌握在自己服务器上的团队或个人
通过 Docker 或手动方式部署实例，配置 PostgreSQL 与 Prisma 迁移，创建管理员账号后即可在自有环境中使用全部星盘功能。
包含内容
astrologerstudio-source.zip
README-中文安装说明.md
LICENSE-AGPL-3.0.txt
SHA256.txt
常见问题
Astrologer Studio 的星盘计算依赖什么引擎？
星盘计算基于开源占星引擎 Kerykeion，README 中将其列为项目的核心依赖，并说明订阅收入的一部分用于支持 Kerykeion 的持续开发。
自托管需要哪些技术组件？
项目基于 Next.js 与 React 构建，使用 PostgreSQL 作为数据库、Prisma 作为数据库工具，依赖管理使用 bun。部署时需先执行 bun run db:generate 和 bun run db:migrate 完成数据库初始化。
AI 解读功能是必须的吗？
不是。README 将 AI 解读标注为可选功能，需要自行配置 AI 语言模型相关密钥；不启用时仍可使用星盘生成、客户管理、星历表与时间线等核心功能。
这个仓库是当前线上版本吗？
不是。README 明确标注该仓库为 Astrologer Studio 的旧版（legacy）代码，astrologerstudio.com 上的线上版本已用新栈完全重写，Astrologer Studio 2 计划随后发布。
项目采用什么许可证，可以商用吗？
项目采用 GNU Affero General Public License v3（AGPLv3）。README 强调“free”指自由而非免费，用户可在 AGPLv3 条款下自由使用、研究、修改和分发，包括自托管运行自己的实例。
