Claude Code 星座/占星 Skills 调研

📍 位置：星座Skill调研 / 竞品分析 📌 核心发现：现有星座 Skill 以中国传统命理（八字/紫微斗数）为主，纯西方星座运势方向基本空白 📥 输入：SkillHub.club 搜索结果、竞品 Skill 源码分析 📤 流向：→ _brief.md 结论

调研日期：2026-03-18

调研对象

1. project-astrology-chinese（中国传统命理）

首次出现: 2026-01-23 | 安装量: 117/周 | 安全审计: 全部通过

功能范围

覆盖五大中国传统命理体系：

• 生肖 / 属相配对
• 八字（四柱命理）— Day Master、十神分析
• 紫微斗数 — 宫位图、大限流年
• 风水 — 飞星按方位和时间分析
• 奇门遁甲 — 择时决策

实现方式

纯 LLM 提示词工程，无外部 API 调用。

• 通过详尽的参考文档（markdown）为 LLM 提供领域知识：
  • zodiac-calculations.md — 生肖计算规则
  • bazi-guide.md — 八字排盘指南
  • na-yin-guide.md — 纳音指南
  • shen-sha-guide.md — 神煞指南
  • yong-shen-guide.md — 用神指南
• 关键准确性规则内嵌在 SKILL.md 中（如”八字以节气而非春节为年界”、“时区/夏令时影响柱计算”）
• 输入要求：公历出生日期、当地时间、出生地点、时区/DST
• 输出定位：倾向性分析和规划建议，明确声明非确定性预测
• 出生数据视为敏感信息，不存储不回显

数据来源

全部来自内嵌的 markdown 参考文档，属于传统命理学知识的结构化整理。无实时数据、无外部数据库、无 API。

边界管理

明确将西方占星、吠陀占星、塔罗牌、数字命理等路由到其他 skill。

2. project-astrology-tarot-divination（塔罗牌占卜）

首次出现: 2026-01-23 | 安装量: 97/周 | 安全审计: 全部通过

功能范围

• 大阿尔卡纳和小阿尔卡纳牌义解读（正位/逆位）
• 牌阵设计与选择（凯尔特十字、三牌阵、自定义牌阵）
• 完整牌面解读和每日单牌
• 牌面间互动关系和综合解读
• 融入轻度占星时间元素
• AI 塔罗产品功能咨询

实现方式

纯 LLM 提示词工程，无外部 API 调用。

• 结构化 7 步工作流：
  1. 明确问题
  2. 选择牌阵
  3. 抽牌
  4. 逐牌解读
  5. 综合模式分析
  6. 提供落地行动建议
  7. 收尾 + 强调自由意志
• 参考文档体系：
  • 大/小阿尔卡纳指南
  • 牌阵布局文档
  • 逆位牌规则
  • 元素尊严体系
  • 宫廷牌框架
  • 卡巴拉对应关系
  • 扩展占卜体系（雷诺曼、符文、Ogham）

安全框架

• 塔罗定位为引导而非命运
• 禁止恐惧性语言
• 禁止涉及死亡、疾病、危机干预的预测
• 强制声明 AI 局限性

数据来源

全部来自内嵌 markdown 文档，塔罗牌学知识的结构化整理。无外部 API。

3. astrology-backend-integration（吠陀占星后端集成）

首次出现: 2026-01-27 | 安装量: 15/周 | 安全审计: Snyk 有警告

功能范围

这是一个工程指导类 skill，不是直接提供占星分析，而是指导开发者如何构建吠陀占星后端系统：

• 吠陀占星咨询平台搭建
• 占星 API 集成
• 出生星盘（Kundli）生成与存储
• 大运（Dasha）周期预测
• 缺陷（Dosha）检测（Manglik, Pitra）
• 宝石和 Rudraksha 推荐
• AI 驱动的占星咨询系统
• 家庭星盘管理
• 配对匹配

实现方式

依赖外部占星 API + 数据库 + AI 集成的完整后端架构。

外部 API 依赖

• AstrologyAPI.com — 主要占星计算 API
• Prokerala — 备选占星 API
• GeoVedic — 备选
• AstroSage — 备选
• Google Maps Geocoding API — 地理编码

技术栈选项

Django / FastAPI / Node.js+Express / Spring Boot

数据库设计

• user_metadata — 出生信息
• user_astro_metadata — API 响应缓存
• user_member_metadata — 家庭成员信息
• user_member_astro_metadata — 家庭成员占星数据

数据处理流水线

Key 标准化 → 星盘转换 → 行星增强 → 大运时间线构建 → Dosha 值提取 → 补救方案格式化

AI 集成模式

• 完整 Kundli 上下文组装
• 查询特定宫位映射
• 性别感知解读规则
• 当前大运纳入考量
• 多语言支持（印地语/英语）

实施阶段（7 阶段）

1. API 配置与认证
2. 数据库 schema 设计
3. Kundli 构建器开发
4. AI prompt 集成
5. 功能实现（入职、配对、历法）
6. 性能优化
7. 质量保证

对比总结

关键发现

1. vasilyu1983 的两个 skill 完全不依赖外部 API，纯粹通过结构化的 markdown 参考文档给 LLM 提供领域知识，本质是”精细化的 prompt engineering + 领域知识库”。这意味着准确性完全取决于参考文档的质量和 LLM 的推理能力，无法进行精确的天文计算（如精确排盘）。

2. twofourlabs 的 skill 是工程架构指导，不直接提供占星服务，而是教开发者如何接入专业占星 API（如 AstrologyAPI.com）来构建完整的占星平台。这种方式的计算精度依赖于外部 API，但需要付费订阅和额外的基础设施。

3. 三个 skill 覆盖了三大文化圈的占星体系：中国传统命理、西方塔罗、印度吠陀占星，互相没有重叠。

4. 源码层面的发现：vasilyu1983 的 GitHub 仓库 main 分支中实际上没有找到 astrology 相关的 skill 文件（仓库有 1805 个文件，62 个 skill，全部是编程/开发类）。这些占星 skill 可能通过 skills.sh 平台的其他机制发布，或者曾经存在后被移除但 skills.sh 仍有缓存。

12 星座特质数据

📍 位置：玄学测算体系 / 西方星座特质数据 📌 核心发现：12 星座 × 12 维度的完整结构化数据，可直接用于 Skill prompt 知识库 📥 输入：ZodiacKit（markbattistella/ZodiacKit）、zodiacsign.com、cnblogs 博客园文章交叉验证 📤 流向：→ Skill 的 reference 文档

基础对照表

白羊座 Aries ♈

日期范围： 3月21日 – 4月19日

基础属性

性格特征（6 词）

勇敢（Courageous）、充满活力（Energetic）、自信（Confident）、热情（Enthusiastic）、直接（Direct）、领导力强（Leader）

优点（5 项）

• 勇敢 Brave
• 坚定 Determined
• 自信 Confident
• 热情 Enthusiastic
• 乐观 Optimistic

缺点（5 项）

• 急躁 Impatient
• 喜怒无常 Moody
• 冲动 Impulsive
• 好斗 Aggressive
• 脾气暴躁 Short-tempered

核心特质（3 词）

充满活力（Energetic）、爱冒险（Adventurous）、开拓者（Pioneer）

爱情倾向

热情强烈，坠入爱河时会毫不犹豫地主动表达感受。享受追求过程，需要伴侣给予足够的空间和尊重，学会平衡自己的激情与对方的节奏。

事业倾向

天生具有领导才能，适合竞争性环境和领导岗位。思维敏捷、行动力强，在挑战和压力中表现出色，适合管理、体育、创业等领域。

财运倾向

赚钱能力强，但消费冲动，生活在当下而对未来规划不足。总能找到赚钱方式来弥补支出，财运呈自然流动状态。

兼容性

金牛座 Taurus ♉

日期范围： 4月20日 – 5月20日

基础属性

性格特征（6 词）

可靠（Reliable）、有耐心（Patient）、务实（Practical）、感性（Sensual）、固执（Stubborn）、专注（Devoted）

优点（5 项）

• 可靠 Reliable
• 有耐心 Patient
• 务实 Practical
• 忠诚 Loyal
• 负责任 Responsible

缺点（5 项）

• 固执 Stubborn
• 占有欲强 Possessive
• 物质主义 Materialistic
• 自我放纵 Self-indulgent
• 缺乏弹性 Inflexible

核心特质（3 词）

有耐心（Patient）、可靠（Reliable）、感性（Sensual）

爱情倾向

极具感官敏锐性，需要时间建立安全感和信任环境。忠诚专一，偏好传统价值观，重视用物质行动表达爱意，一旦承诺便会长期坚守。

事业倾向

可靠、勤劳、耐心且细致，一旦锁定目标就会坚持到底。适合农业、银行、艺术及烹饪相关工作，以稳定和实际为职业核心。

财运倾向

财务管理严谨，账单按时支付，重视储蓄和养老规划。无论收入多少都能理性消费，积极积累物质财富。

兼容性

双子座 Gemini ♊

日期范围： 5月21日 – 6月20日

基础属性

性格特征（6 词）

多才多艺（Versatile）、好奇（Curious）、善于沟通（Communicative）、机智（Witty）、适应力强（Adaptable）、智识性（Intellectual）

优点（5 项）

• 适应力强 Adaptable
• 开朗外向 Outgoing
• 聪明 Intelligent
• 口才好 Eloquent
• 好奇心旺盛 Curious

缺点（5 项）

• 善变 Inconsistent
• 焦虑 Nervous
• 优柔寡断 Indecisive
• 流于表面 Superficial
• 坐立不安 Restless

核心特质（3 词）

善于沟通（Communicative）、好奇（Curious）、多才多艺（Versatile）

爱情倾向

通过交流和言语互动建立亲密感，认为智识交流与身体接触同等重要。需要兴奋感、多样性和激情，一旦找到能匹配其智力与能量的伴侣，便会变得专一忠诚。

事业倾向

需要持续的智力刺激，擅长多任务处理和解决问题。适合交易员、发明家、作家、演说家、律师等职业，需要动态环境和充分的社交机会。

财运倾向

对金钱态度随意，认为金钱只是必要之恶，不会花太多时间规划财务。需要外部约束和强有力的财务管理来维持安全感。

兼容性

巨蟹座 Cancer ♋

日期范围： 6月21日 – 7月22日

基础属性

性格特征（6 词）

有养育心（Nurturing）、保护欲强（Protective）、直觉敏锐（Intuitive）、情感丰富（Emotional）、坚韧（Tenacious）、重情（Sentimental）

优点（5 项）

• 忠诚 Loyal
• 情感细腻 Emotional
• 富有同情心 Sympathetic
• 保护欲强 Protective
• 直觉敏锐 Intuitive

缺点（5 项）

• 情绪化 Moody
• 过度情绪化 Overemotional
• 多疑 Suspicious
• 操控性 Manipulative
• 缺乏安全感 Insecure

核心特质（3 词）

有养育心（Nurturing）、保护欲强（Protective）、直觉敏锐（Intuitive）

爱情倾向

极为情感化，感受在关系中最为重要。寻求能通过非语言交流理解自己的伴侣，一旦信任建立便会表现出极大的忠诚与热情，将家庭和伴侣视为生命核心。

事业倾向

工作踏实可靠，一旦接下任务就会尽力完成。适合护理、园艺、政治和家居装饰等职业，独立工作时表现最佳，重视工作中的情感联结。

财运倾向

安全感与金钱对巨蟹座意义重大。容易赚钱且善于节俭，目标是储蓄、投资并观察资产稳步增长，财务上偏保守稳健。

兼容性

狮子座 Leo ♌

日期范围： 7月23日 – 8月22日

基础属性

性格特征（6 词）

慷慨（Generous）、热心（Warm-hearted）、创造力强（Creative）、热情（Enthusiastic）、有尊严（Dignified）、有魅力（Charismatic）

优点（5 项）

• 自信 Confident
• 创造力强 Creative
• 慷慨大方 Generous
• 忠诚 Loyal
• 鼓励他人 Encouraging

缺点（5 项）

• 傲慢 Arrogant
• 固执 Stubborn
• 以自我为中心 Self-centered
• 强势 Domineering
• 戏剧化 Melodramatic

核心特质（3 词）

自豪（Proud）、有魅力（Charismatic）、领袖气质（Leader）

爱情倾向

热情而真挚，表达感受明确流畅，需要伴侣提供充分的关注和赞美。期望被像皇室般对待，同时也会给予伴侣同等的王室级待遇，若感到被忽视会深感受伤。

事业倾向

精力充沛、雄心勃勃、充满创意，最适合领导职位。表演娱乐、管理教育和政治等能充分展现艺术才华和领导力的工作最为理想。

财运倾向

金钱来得容易，但花费不够谨慎。极其慷慨，常在朋友困难时慷慨解囊，虽然不总是明智之举，但能让他们感到满足和自豪。

兼容性

处女座 Virgo ♍

日期范围： 8月23日 – 9月22日

基础属性

性格特征（6 词）

善于分析（Analytical）、务实（Practical）、勤勉（Diligent）、有辨别力（Discriminating）、乐于助人（Helpful）、谦逊（Modest）

优点（5 项）

• 善于分析 Analytical
• 务实 Practical
• 勤勉 Diligent
• 一丝不苟 Meticulous
• 可靠 Reliable

缺点（5 项）

• 爱批评 Critical
• 完美主义 Perfectionist
• 想太多 Overthinking
• 焦虑 Worrisome
• 挑剔 Fussy

核心特质（3 词）

善于分析（Analytical）、精准（Precise）、乐于助人（Helpful）

爱情倾向

在爱情中常感到自己不够值得被爱，需要伴侣的耐心和持久的温情才能逐渐敞开心扉。更倾向于建立稳定的长期关系，而非随意的约会，一旦信任建立便会全力付出。

事业倾向

分析能力强、工作勤奋，擅长找到任何问题的核心所在。在需要细致组织、文件处理和解决问题的工作中表现卓越，也适合从事批评、医疗或心理咨询等需要精确判断的职业。

财运倾向

有很强的储蓄意识，反感非理性消费。倾向于寻找务实且成本低廉的解决方案，财务上保守稳健，有时过于谨慎。

兼容性

天秤座 Libra ♎

日期范围： 9月23日 – 10月22日

基础属性

性格特征（6 词）

外交手腕强（Diplomatic）、公平（Fair-minded）、社交性强（Social）、合作（Cooperative）、优雅（Gracious）、优柔寡断（Indecisive）

优点（5 项）

• 外交手腕强 Diplomatic
• 公平 Fair
• 合作 Cooperative
• 社交性强 Social
• 优雅 Gracious

缺点（5 项）

• 优柔寡断 Indecisive
• 逃避冲突 Avoids confrontation
• 自怜 Self-pitying
• 流于表面 Superficial
• 不可靠 Unreliable

核心特质（3 词）

外交手腕强（Diplomatic）、以伙伴关系为导向（Partnership-oriented）、精致（Refined）

爱情倾向

渴望寻找能成为自我镜像的伴侣，将和谐与平衡视为关系核心。追求深层次、有意义的亲密关系，愿意为伴侣付出几乎一切来维持感情的稳定。

事业倾向

工作中强调平衡，不会过度投入而牺牲个人生活。适合法律、外交、设计等需要判断力与美感的工作，团队合作中表现出色。

财运倾向

金钱管理维持良好控制，虽热爱时尚与精致物品，但决策能力强使其很少过度消费，储蓄与支出之间保持适当平衡。

兼容性

天蝎座 Scorpio ♏

日期范围： 10月23日 – 11月21日

基础属性

性格特征（6 词）

热情（Passionate）、足智多谋（Resourceful）、勇敢（Brave）、强烈（Intense）、神秘（Mysterious）、忠诚（Loyal）

优点（5 项）

• 坚定 Determined
• 勇敢 Brave
• 忠诚 Loyal
• 足智多谋 Resourceful
• 热情 Passionate

缺点（5 项）

• 嫉妒 Jealous
• 隐秘 Secretive
• 记仇 Resentful
• 多疑 Suspicious
• 操控性 Manipulative

核心特质（3 词）

强烈（Intense）、蜕变（Transformative）、热情（Passionate）

爱情倾向

极具热情，持续寻求绝对的亲密和爱。期望伴侣聪慧、务实且诚实，一旦陷入爱情会专注忠诚，但也容易显现出占有欲和控制欲，需要超越身体的深层灵魂连接。

事业倾向

在管理和问题解决方面表现卓越，在压力环境中工作良好。最佳职业包括科学研究、侦探、警察、心理学家和外科医生等需要深入思考和洞察力的领域。

财运倾向

有足够的纪律坚持预算，努力追求经济独立。对他们而言金钱代表控制和权力，很少冒不确定的风险，但偶尔会喜欢边缘生活带来的刺激。

兼容性

射手座 Sagittarius ♐

日期范围： 11月22日 – 12月21日

基础属性

性格特征（6 词）

乐观（Optimistic）、热爱自由（Freedom-loving）、哲学思考（Philosophical）、直率（Straightforward）、求知欲强（Intellectual）、爱冒险（Adventurous）

优点（5 项）

• 乐观 Optimistic
• 热爱自由 Freedom-loving
• 诚实 Honest
• 求知欲强 Intellectual
• 热情 Enthusiastic

缺点（5 项）

• 说话不考虑后果 Tactless
• 坐立不安 Restless
• 不负责任 Irresponsible
• 流于表面 Superficial
• 善变 Inconsistent

核心特质（3 词）

爱冒险（Adventurous）、乐观（Optimistic）、哲学思考（Philosophical）

爱情倾向

寻求同样开明、思想自由的伴侣，希望关系充满趣味和空间。在友谊与爱情之间界限模糊，需要智力刺激和情感真挚的伙伴，重视关系中的自由与成长。

事业倾向

适合旅游、摄影、研究等需要灵活时间安排的职业。具有积极精神和团队合作能力，但容易因分心而缺乏长期专注力，喜欢多变和充满探索性的工作环境。

财运倾向

金钱管理是薄弱环节，倾向过度消费。乐观心态使其相信”宇宙会供应所需”，容易冒不必要的风险，需要有意识地建立财务规划。

兼容性

摩羯座 Capricorn ♑

日期范围： 12月22日 – 1月19日

基础属性

性格特征（6 词）

负责任（Responsible）、有纪律（Disciplined）、自我控制强（Self-controlled）、务实（Practical）、谨慎（Cautious）、有抱负（Ambitious）

优点（5 项）

• 负责任 Responsible
• 有纪律 Disciplined
• 自我控制强 Self-controlled
• 务实 Practical
• 有耐心 Patient

缺点（5 项）

• 悲观 Pessimistic
• 宿命论 Fatalistic
• 僵化 Rigid
• 冷漠 Cold
• 工作狂 Workaholic

核心特质（3 词）

有抱负（Ambitious）、务实（Practical）、有纪律（Disciplined）

爱情倾向

赢得摩羯座的心并不容易，但一旦防线被打破，便会终身保持承诺。情感通过行动而非言语体现，需要多年才能完全敞开心扉，但一旦认定便极为稳定可靠。

事业倾向

为自己设定高标准，诚实、奉献和毅力是职业核心。在管理、金融、编程等领域表现出色，深深扎根于传统和制度，真正的成功往往在长期积累后到来。

财运倾向

金钱在摩羯座生活中受到真正重视，管理和储蓄能力强，很少有财务困难。勤奋工作是财富积累的核心方式，偏好保守稳健的长期投资。

兼容性

水瓶座 Aquarius ♒

日期范围： 1月20日 – 2月18日

基础属性

性格特征（6 词）

独立（Independent）、原创性强（Original）、人道主义（Humanitarian）、智识性（Intellectual）、进步（Progressive）、理想主义（Idealistic）

优点（5 项）

• 有远见 Visionary
• 忠诚 Loyal
• 原创 Original
• 富有创造力 Inventive
• 利他 Altruistic

缺点（5 项）

• 情感疏离 Detached
• 固执 Stubborn
• 不可预测 Unpredictable
• 冷漠 Aloof
• 叛逆 Rebellious

核心特质（3 词）

创新（Innovative）、独特（Eccentric）、人道主义（Humanitarian）

爱情倾向

智力刺激是对水瓶座最大的吸引力，需要坦诚沟通、想象力丰富的伴侣。重视对方的自由和独立性，在日常互动中可能显得冷漠疏离，但内心深处对感情极为忠诚。

事业倾向

将热情和创新带入工作场所，想象力与商业头脑结合。适合飞行员、摄影师、程序员和数学家等需要个性表达和创新思维的工作。

财运倾向

财务管理较为灵活，可能在风险投资和储蓄之间摇摆。需要有值得期待的目标才能建立稳定的财务计划，容易为理想和项目投入大量资金。

兼容性

双鱼座 Pisces ♓

日期范围： 2月19日 – 3月20日

基础属性

性格特征（6 词）

富有同情心（Compassionate）、直觉敏锐（Intuitive）、梦幻（Dreamy）、艺术性强（Artistic）、温柔（Gentle）、灵性（Spiritual）

优点（5 项）

• 共情能力强 Empathetic
• 创造力丰富 Creative
• 直觉敏锐 Intuitive
• 适应力强 Adaptable
• 无私 Selfless

缺点（5 项）

• 逃避现实 Escapist
• 过于理想化 Idealistic
• 过度敏感 Oversensitive
• 优柔寡断 Indecisive
• 受害者心态 Victim mentality

核心特质（3 词）

梦幻（Dreamy）、神秘（Mystical）、共情能力强（Empathetic）

爱情倾向

不可救药的浪漫主义者，追求与伴侣的深层精神连接而非短暂激情。对伴侣极度忠诚、温柔且慷慨，但容易因过度信任和理想化而受到伤害。

事业倾向

适合发挥创意才能的工作，包括医生、兽医、音乐家、画家等需要同情心和奉献精神的职业。在幕后工作中表现出色，擅长用直觉和感知理解他人需求。

财运倾向

不过分关注金钱，更专注于梦想和目标的实现。根据所追求梦想的强度决定花费金额，财务意识薄弱，需要实际的财务管理支持。

兼容性

四元素分组速查

三模式分组速查

数据来源

本文件内容来自以下数据源的交叉整合验证：

主要数据源

1. markbattistella/ZodiacKit（推荐度 5/5）

• URL：https://github.com/markbattistella/ZodiacKit
• 格式：Swift 源码，结构化程度最高
• 贡献维度：元素、模式、极性、阴阳、守护星（现代+传统）、守护宫位、象征、诞生石、最亮星、性格特征（6词）、优点（5项）、缺点（5项）、核心特质（3词）、兼容性（4级分类）、代表颜色
• 说明：本文件中基础属性、性格特征、优缺点、核心特质、兼容性数据均来自此源

2. zodiacsign.com（推荐度 4/5）

• URL：https://www.zodiacsign.com/zodiac-signs/[sign-name]/
• 格式：网页内容
• 贡献维度：爱情倾向、事业倾向、财运倾向、幸运颜色、幸运数字、幸运日
• 说明：补充了 ZodiacKit 缺少的生活/运势维度描述

3. 博客园文章（推荐度 4/5）

• URL：https://www.cnblogs.com/jiodeng/p/18776494
• 格式：中文博客，表格结构清晰
• 贡献维度：中文星座名称、日期范围中文表述、中文语境下的性格关键词参考
• 说明：用于中文描述的交叉验证

数据可信度说明

• 基础属性（元素、模式、守护星等）：跨源 100% 一致，高可信度
• 性格特质数据：ZodiacKit 与 zodiacsign.com、博客园中文源数据高度吻合，共识性强
• 爱情/事业/财运描述：来自 zodiacsign.com，为该站点编辑描述，经 ZodiacKit 性格数据交叉印证，逻辑一致
• 兼容性数据：直接来自 ZodiacKit 源码，具有明确的4级分类结构

西方占星术测算规则

📍 位置：玄学测算体系 / 西方占星术 📌 核心发现：西方占星术是所有玄学体系中可编程化程度最高的，核心计算完全基于天文学，有成熟的开源库（Swiss Ephemeris、Kerykeion）可直接调用 📥 输入：出生日期、出生时间、出生地点（经纬度） 📤 流向：→ findings.md 可编程性评估

一、核心概念

西方占星术的本质是：在某一时刻、某一地点，从地球视角观测天体在黄道带上的投影位置，再通过一套象征体系进行解读。

三大核心要素：

1. 行星位置（Planets）：太阳、月亮、水金火木土天海冥在黄道 12 星座中的位置
2. 宫位（Houses）：将天球分为 12 个区域，代表生活不同领域
3. 相位（Aspects）：行星之间的角度关系

二、行星位置计算

2.1 基础天文计算

行星位置计算的核心流程：

输入：日期 + 时间 + 时区
  ↓
转换为儒略日（Julian Day Number）
  — JDN 是从公元前 4713 年 1 月 1 日起的连续天数计数
  ↓
调用天文历表（Ephemeris）
  — 通过对预计算数据点的插值，获取精确行星位置
  ↓
输出：每颗行星在黄道带上的经度（0°~360°）
  — 对应 12 星座各 30°

2.2 黄道带（Zodiac）星座划分

2.3 涉及的天体

三、上升星座（Ascendant / Rising Sign）计算

上升星座是出生时刻东方地平线与黄道交叉点所在的星座，是星盘中最个人化的要素。

3.1 计算公式

Asc = arctan( -cos(RAMC) / (sin(RAMC) × cos(ε) + tan(φ) × sin(ε)) )

其中：

• RAMC（Right Ascension of MC）= 本地恒星时 × 15°
• ε（epsilon）= 黄赤交角 ≈ 23.44°（地球轴倾斜角）
• φ（phi）= 出生地纬度

3.2 计算步骤

1. 将出生时间转换为格林威治恒星时（GMST）
2. 加上出生地经度修正 → 得到本地恒星时（LMST）
3. RAMC = LMST × 15
4. 代入公式计算上升点黄道经度
5. 经度落在哪个 30° 区间 → 对应的星座就是上升星座

3.3 MC（中天）

MC = arctan(tan(RAMC) / cos(ε))

MC 是天顶与黄道的交点，代表事业和公众形象。

四、宫位系统（House Systems）

4.1 主流宫位系统对比

4.2 宫位含义

4.3 编程实现

Whole Sign 最容易实现（纯数学），Placidus 需要迭代求解（或调用 Swiss Ephemeris）。高纬度地区 Placidus 会出现异常（某些宫位消失），Whole Sign 不受此限。

五、行星相位（Aspects）

5.1 主要相位及计算

5.2 次要相位

5.3 容许度（Orbs）

容许度 = 实际角度与精确相位角度的允许偏差范围。

标准容许度参考（可配置）：

5.4 相位计算算法

def calculate_aspect(planet1_lon, planet2_lon, aspect_angle, orb):
    """判断两颗行星是否形成某个相位"""
    diff = abs(planet1_lon - planet2_lon)
    if diff > 180:
        diff = 360 - diff  # 取最短角距
    deviation = abs(diff - aspect_angle)
    if deviation <= orb:
        return True, deviation  # 形成相位，偏差度数
    return False, None

六、行星逆行（Retrograde）

6.1 判断规则

从天文学角度，逆行是视运动现象：

• 外行星（火、木、土、天、海、冥）：当地球在轨道内侧”超车”时，外行星看起来向后移动
• 内行星（水、金）：当它们在地球和太阳之间经过（下合）时出现逆行
• 太阳和月亮：永远不逆行

6.2 判断方法

如果行星在某时刻的黄道经度变化率 < 0（即经度在减小），则该行星处于逆行状态。

Swiss Ephemeris 直接提供每颗行星的速度数据，速度为负即逆行。

6.3 逆行频率

七、推运方法（Predictive Techniques）

7.1 行运（Transits）

最直观的推运方法：观察当前天体位置与出生星盘的互动。

计算方法：
1. 计算当前时刻所有行星的黄道经度
2. 将当前行星位置与本命盘行星位置做相位计算
3. 找到形成的相位 → 解读

7.2 太阳回归盘（Solar Return）

每年太阳回到出生时精确经度的那一刻，以当时的星盘作为该年的运势盘。

计算方法：
1. 获取本命太阳经度
2. 逐日搜索当年太阳经度 = 本命太阳经度的精确时刻
3. 以该时刻 + 当前所在地 → 排盘

7.3 次限推运（Secondary Progressions）

日年对应法（Day-for-a-Year）：出生后第 N 天的星盘 ≈ 第 N 年的推运盘。

计算方法：
推运日期 = 出生日期 + (当前年龄) 天
以推运日期排盘 → 次限盘

例：你今年 30 岁 → 用出生后第 30 天的行星位置作为推运盘。

次限太阳每年移动约 1°（因此次限推运中太阳换星座大约 30 年发生一次）。

7.4 太阳弧推运（Solar Arc Directions）

所有行星都按次限太阳的移动速度（约 1°/年）向前推进。

太阳弧 = 次限太阳经度 - 本命太阳经度
每颗行星的推运位置 = 本命位置 + 太阳弧

八、可用的计算库和 API

8.1 Swiss Ephemeris

• 精度：0.0001°（1/36000 度）
• 数据源：NASA JPL Development Ephemeris (DE431)
• 支持：所有主流宫位系统（23 种以上）
• 语言：C 语言核心，有 Python/Java/Node.js 等绑定
• 官网：https://www.astro.com/swisseph/

8.2 Kerykeion（Python）

# pip install kerykeion
from kerykeion import AstrologicalSubjectFactory

subject = AstrologicalSubjectFactory.from_birth_data(
    "示例用户", 1990, 6, 15, 14, 30,
    lng=116.4074, lat=39.9042,
    tz_str="Asia/Shanghai", online=False
)

# 获取行星位置、宫位、相位等全部数据

特性：

• 支持回归黄道（Tropical）和恒星黄道（Sidereal）
• 支持 Placidus、Koch、Equal、Whole Sign 等宫位系统
• 自动计算相位
• 支持本命盘、合盘、行运盘、太阳/月亮回归盘、组合盘
• 可生成 SVG 星盘图
• 提供 AI/LLM 友好的 JSON 数据输出

8.3 Flatlib（Python）

• 专注传统占星
• 较轻量
• GitHub: https://github.com/flatangle/flatlib

8.4 其他

九、编程实现要点总结

可完全自动化的部分

• 行星位置计算（调用 Swiss Ephemeris）
• 上升星座 / MC 计算
• 宫位划分
• 相位计算
• 逆行判断
• 推运计算（行运、太阳/月亮回归、次限、太阳弧、三限）
• 法达星限周期计算
• 合盘计算（比较盘相位、组合盘中点、戴维森盘时空中点）
• 换置盘 / ACG 行星力量线
• 每日天象事件提取（月亮星座、行星相位、换座、逆行）
• 占星骰子随机生成

需要 LLM 辅助的部分

• 相位的组合解读（多个相位同时存在时的综合判断）
• 宫位主星的连锁解读
• 个性化叙事生成
• 流年运势的综合分析
• 合盘关系解读（综合宫位叠加 + 相位的整体判断）
• 每日运势文案生成（天象数据 → 12 星座叙事）
• 占星骰子组合解读

最小可行实现路径

1. pip install kerykeion
2. 输入出生信息 → 获取完整星盘数据（JSON）
3. 将 JSON 数据 + 解读提示词 → 送入 LLM 生成解读文本

十、高级推运星盘类型

10.1 三限盘（Primary Directions）

最古老的推运技术之一，可追溯到托勒密《占星四书》（Tetrabiblos），在中世纪欧洲广泛使用。

核心原理： 天球每旋转 1° 赤经 = 人生中的 1 年。利用天球的周日运动（地球自转导致的视运动），将行星和敏感点在天球上的运动弧度转换为时间。

与次限的关键区别：

计算要素：

• Significator（象征星）：指示事件发生的生活领域（如 MC = 事业，ASC = 自身）
• Promittor（触发星）：指示引发事件的力量（如火星 = 冲突，金星 = 爱情）
• Arc（弧）：两者在天球上的赤经距离 → 转换为年份

Regiomontanus 系统下的主要公式：

sin(RA_end - MP_S) = tan(D_P) × tan(φ) × cos(OA_ASC - MP_S)

其中：
- RA_end = 触发星到达象征星位置时的赤经
- MP_S = 象征星的世界位置（Mundane Position）
- D_P = 触发星的赤纬
- φ = 出生地纬度
- OA_ASC = 上升点的斜升（Oblique Ascension）

方向弧 = RA_end - RA_start → 弧度数 = 事件发生的年龄

编程实现要点：

• 需要球面三角函数库
• Swiss Ephemeris 的 swe_houses_ex() 可提供所需的赤经、赤纬数据
• Morinus 软件（Python/开源）有完整的 Regiomontanus 三限盘实现可参考
• Astro-seek 提供在线三限盘计算器

10.2 月返盘（Lunar Return）

概念： 每月月亮回到本命盘中月亮精确经度的时刻，以该时刻排盘，代表该月的运势。

与太阳回归盘的对比：

计算方法：

1. 获取本命月亮经度 natal_moon_lon
2. 从目标月份起始日开始，逐时搜索月亮经度
3. 找到 current_moon_lon == natal_moon_lon 的精确时刻（需插值精确到秒）
4. 以该时刻 + 所在地 → 排盘

解读要点：

• 月返盘的上升星座代表该月整体基调
• 月返盘行星落入的宫位指示该月活跃的生活领域
• 月返盘与本命盘的行星相位揭示该月的挑战与机遇

编程实现： Kerykeion 的 PlanetaryReturnFactory 直接支持 Lunar Return 计算。

10.3 太阳回归盘（Solar Return）详解

在 7.2 节基础上展开。

解读要点：

1. 太阳回归盘的上升星座 — 定义整年的基调和个人态度
2. 行星落入的宫位 — 指示该年最活跃的生活领域
3. 太阳回归盘中的相位 — 该年的核心挑战和机遇
4. 太阳回归盘的月亮 — 情绪基调和情感需求
5. 逆行行星 — 该年需要内省反思的领域

出生地 vs 当前所在地争议 — 三大流派：

实践建议： 多数占星师建议同时看两张盘（出生地 + 居住地），取交集。短期旅行所在地意义不大，长期居住地更有参考价值。

与本命盘的叠加解读：

• 将太阳回归盘行星叠加在本命盘上，看回归行星落入本命哪个宫位
• 太阳回归盘的 ASC 落入本命的第几宫 → 该宫主题是这一年的焦点
• 回归盘与本命盘的行星互相形成的相位 → 揭示年度关键互动

10.4 法达星限（Firdaria）

概念： 源自波斯-希腊传统的时间主星系统，将人生分为不等长的行星主管阶段，总计 75 年为一个完整周期。每颗行星在其主管期间为人生定调。

日生 vs 夜生的行星顺序：

两者都遵循迦勒底顺序（Saturn → Jupiter → Mars → Sun → Venus → Mercury → Moon），但起始行星不同。

日生（Diurnal）序列：

夜生（Nocturnal）序列：

注：北交/南交的年限存在版本差异。上表采用 Robert Hand 版本（3+2=5）。Robert Zoller 版本中两者均为 3 年（总计 76 年）。

子周期（Sub-period）计算：

每个主周期内部再分为 7 个子周期，由七颗传统行星按迦勒底顺序轮流主管，起始行星 = 该主周期的主管行星。

子周期时长 = 主周期总年限 ÷ 7

例：太阳主周期（10 年）的子周期：
  太阳/太阳：10/7 ≈ 1.43 年（约 17 个月）
  太阳/金星：10/7 ≈ 1.43 年
  太阳/水星：10/7 ≈ 1.43 年
  ...（迦勒底顺序：太阳→金星→水星→月亮→土星→木星→火星）

编程实现：

CHALDEAN_ORDER = ['Sun', 'Venus', 'Mercury', 'Moon', 'Saturn', 'Jupiter', 'Mars']
DAY_SEQUENCE = [('Sun',10), ('Venus',8), ('Mercury',13), ('Moon',9),
                ('Saturn',11), ('Jupiter',12), ('Mars',7),
                ('NNode',3), ('SNode',2)]
NIGHT_SEQUENCE = [('Moon',9), ('Saturn',11), ('Jupiter',12), ('Mars',7),
                  ('Sun',10), ('Venus',8), ('Mercury',13),
                  ('NNode',3), ('SNode',2)]

def get_firdaria(birth_date, is_day_birth, target_date):
    """返回目标日期的主周期行星和子周期行星"""
    sequence = DAY_SEQUENCE if is_day_birth else NIGHT_SEQUENCE
    age_days = (target_date - birth_date).days
    age_years = age_days / 365.25
    cycle_year = age_years % 75  # 75 年一个完整周期

    cumulative = 0
    for planet, years in sequence:
        if cumulative + years > cycle_year:
            # 找到主周期
            year_in_period = cycle_year - cumulative
            if planet in ('NNode', 'SNode'):
                return planet, None  # 交点期无子周期
            # 计算子周期
            sub_len = years / 7
            start_idx = CHALDEAN_ORDER.index(planet)
            sub_idx = int(year_in_period / sub_len)
            sub_planet = CHALDEAN_ORDER[(start_idx + sub_idx) % 7]
            return planet, sub_planet
        cumulative += years

十一、合盘分析（关系占星）

11.1 比较盘（Synastry）

概念： 将两个人的本命盘直接叠加，观察 A 的行星落入 B 的宫位，以及 A 与 B 行星之间形成的相位。

两个分析维度：

维度一：宫位叠加（House Overlay）

• 将 A 的行星投影到 B 的宫位系统中
• A 的行星 = “能量发出者”，B 的宫位 = “能量接收区域”
• 例：A 的金星落入 B 的 7 宫 → A 在 B 眼中具有伴侣吸引力

维度二：行星相位（Inter-aspects）

• 计算 A 的每颗行星与 B 的每颗行星之间的角度
• 相位判定方法与本命盘相同，但容许度更小

比较盘推荐容许度：

关键相位解读：

编程实现： Kerykeion 提供 SynastryAspects 计算两盘之间的相位，HouseComparisonFactory 提供宫位叠加分析。

11.2 组合盘（Composite Chart）

概念： 取两个人所有对应行星位置的中点，合成一张新的星盘，代表”这段关系本身”的特质。

中点计算公式：

composite_point = (A_longitude + B_longitude) / 2

注意：需取"近中点"（nearer midpoint）
- 两个点在圆上有两个中点，取较近的那个
- 如果 |A - B| > 180°，则先将差值调整为 360° - |A - B|

完整算法：

def midpoint(lon_a, lon_b):
    """计算两个黄道经度的近中点"""
    diff = abs(lon_a - lon_b)
    if diff <= 180:
        mid = (lon_a + lon_b) / 2
    else:
        mid = (lon_a + lon_b) / 2 + 180
    return mid % 360

# 对所有行星和轴点（ASC、MC）分别计算
composite_sun = midpoint(a_sun, b_sun)
composite_moon = midpoint(a_moon, b_moon)
# ... 所有行星同理

内行星修正（Mercury/Venus 特殊处理）：

由于水星和金星在天文上不可能与太阳呈 180° 对分相，如果组合盘计算结果出现水星或金星与组合太阳对冲，需要将该行星移到”远中点”（加 180°），使其回到太阳附近。

解读要点：

• 组合盘太阳的星座和宫位 → 关系的核心目的
• 组合盘月亮 → 关系中的情感安全感
• 组合盘金星 → 关系中的爱与和谐方式
• 7 宫行星 → 关系的对外呈现方式

编程实现： Kerykeion v5+ 直接支持 Composite Chart 计算。

11.3 组合推运盘（Progressed Composite / Composite Transit）

概念： 对组合盘施加推运技术，追踪”这段关系”随时间的演变。

两种方式：

1. 组合盘行运（Composite Transit）：计算当前行星与组合盘行星的相位 — 外部事件如何影响这段关系
2. 组合盘次限推运（Progressed Composite）：对组合盘做 day-for-a-year 推运 — 关系本身的内在演化

编程实现： 组合盘行运 = 对组合盘做标准行运计算（参考 7.1 节）；组合盘推运 = 对组合盘做次限推运（参考 7.3 节）。

11.4 时空盘 / 换置盘与星象地理学（Relocation Chart / AstroCartoGraphy）

换置盘（Relocation Chart）：

• 保持出生日期和时间（UTC）不变，仅更换出生地点的经纬度
• 由于地点改变，本地恒星时不同 → ASC 和 MC 改变 → 宫位系统重新划分
• 行星的黄道经度不变（行星在天上的位置不受地面观测点影响）
• 但行星落入的宫位会变 → 不同地方”激活”不同的生活领域

星象地理学（AstroCartoGraphy / ACG）：

由占星师 Jim Lewis 于 1970 年代推广。将出生时刻的行星位置投射到世界地图上，生成”行星力量线”。

四种行星线：

每颗行星有 4 条线，10 颗主要行星 = 40 条行星力量线覆盖全球地图。

计算原理：

对于每颗行星 P（已知其出生时刻的黄道经度 lon_P 和赤纬 dec_P）：

MC 线：找到使 MC(地理经度) = lon_P 的所有地理经度
  → 垂直线（因为 MC 仅取决于本地恒星时，即经度）

ASC 线：找到使 ASC(纬度, 经度) = lon_P 的所有 (纬度, 经度) 组合
  → 曲线（因为 ASC 同时取决于经度和纬度）

实现：遍历世界地图网格，对每个点计算四轴，
     标记行星经度与四轴经度差在容许度内的点 → 连线

编程实现要点：

• Swiss Ephemeris 的 swe_houses() 可以对任意经纬度计算四轴
• 需要遍历经纬度网格（精度取决于需求，通常 1° 步长再插值）
• Astro-seek 和 astrocarto.org 均使用 Swiss Ephemeris 实现，精度可达 1 英里内

11.5 戴维森盘（Davison Relationship Chart）

概念： 取两个人出生日期的时间中点和出生地点的地理中点，以此排出一张”关系诞生盘”。与 Composite 不同的是，Davison 盘是一个真实存在的天文时刻。

计算方法：

时间中点：
  davison_datetime = A_birth_datetime + (B_birth_datetime - A_birth_datetime) / 2

  例：A 生于 1990-01-01，B 生于 2000-01-01
  → davison_date ≈ 1995-01-01

地理中点（简单版）：
  davison_lat = (A_lat + B_lat) / 2
  davison_lon = (A_lon + B_lon) / 2

地理中点（球面中点，更精确）：
  使用大圆距离公式取球面上的最短路径中点
  （避免在东西经交界处 +180/-180 出错）

以 davison_datetime + davison_location → 排盘

与 Composite 的区别：

编程实现：

from datetime import datetime
from kerykeion import AstrologicalSubjectFactory

# 计算时间中点
a_birth = datetime(1990, 6, 15, 14, 30)
b_birth = datetime(1992, 3, 20, 8, 0)
davison_dt = a_birth + (b_birth - a_birth) / 2

# 计算地理中点
davison_lat = (a_lat + b_lat) / 2
davison_lon = (a_lon + b_lon) / 2

# 以中点时空排盘
davison = AstrologicalSubjectFactory.from_birth_data(
    "Davison", davison_dt.year, davison_dt.month, davison_dt.day,
    davison_dt.hour, davison_dt.minute,
    lng=davison_lon, lat=davison_lat,
    tz_str="UTC", online=False
)

十二、运势推算逻辑

12.1 每日/每周星座运势的专业推算方法

核心原理 — 太阳星座宫位系统（Solar Sign Houses）：

专业占星师为 12 星座写运势时，使用 Whole Sign House 系统，以每个太阳星座作为第 1 宫起点，然后看当日行星落入”该星座视角的哪个宫位”。

例：今天月亮在天蝎座

对白羊座（Aries = 第 1 宫）而言：
  天蝎座 = 第 8 宫 → "今天情绪涉及深层心理/财务/亲密关系"

对金牛座（Taurus = 第 1 宫）而言：
  天蝎座 = 第 7 宫 → "今天关注伴侣/合作关系"

对天蝎座（Scorpio = 第 1 宫）而言：
  天蝎座 = 第 1 宫 → "月亮回到你的星座，情绪强烈聚焦自我"

每日运势的关键因素（按优先级）：

专业占星师的写作流程：

1. 查天文历表（Ephemeris），列出当日所有行星位置
2. 识别当日关键天象事件：
   - 月亮在哪个星座？何时换座？
   - 今天月亮与哪些行星形成精确相位？几点？
   - 有没有行星换座、逆行开始/结束、新月/满月？
3. 这些事件构成当日的"旋律"（melody）
4. 将同一旋律在 12 个"调性"（keys）中演奏：
   - 对每个太阳星座，计算上述行星落入其 Solar Sign House 的哪个宫位
   - 将天象事件 + 宫位含义 → 组合出该星座的每日解读

12.2 AI 自动生成每日运势的算法化思路

输入：target_date（目标日期）

Step 1: 获取天象数据
  - 调用 Swiss Ephemeris 计算当日所有行星位置（黄道经度）
  - 计算月亮精确星座及换座时间
  - 计算所有行星间的当日精确相位
  - 识别行星换座事件
  - 检查新月/满月（太阳-月亮合相/对分相）
  - 检查逆行状态

Step 2: 生成天象事件列表
  events = [
    {"type": "moon_sign", "sign": "Scorpio", "time": "..."},
    {"type": "aspect", "planet1": "Moon", "planet2": "Venus", "aspect": "trine", "time": "14:30"},
    {"type": "ingress", "planet": "Mercury", "sign": "Aries", "time": "..."},
    ...
  ]

Step 3: 对每个太阳星座生成运势
  for sign in 12_signs:
    for event in events:
      house = (event.sign_index - sign_index) % 12 + 1
      # 将事件映射到该星座的宫位
      interpretation_data.append({
        "event": event,
        "house": house,
        "house_meaning": HOUSE_MEANINGS[house]
      })
    # 将 interpretation_data 送入 LLM 生成自然语言运势
    prompt = format_horoscope_prompt(sign, interpretation_data, events)
    horoscope_text = llm.generate(prompt)

Step 4: 输出
  - 12 个星座各一段运势文本
  - 可选：标注当日幸运色/幸运数字（基于当日行星能量的对应表）

关键数据表（编程用）：

# 月亮空亡（Void of Course）: 月亮最后一个精确相位到月亮换座之间的时段
# 在此期间发起的事务不易有结果 → 运势中常提及

# 星座-宫位映射（Whole Sign）
def solar_house(event_sign_index, native_sun_sign_index):
    """从太阳星座视角计算事件落入的宫位"""
    return (event_sign_index - native_sun_sign_index) % 12 + 1

十三、占星骰子（Astro Dice）

13.1 概述

占星骰子是一种简化的占星占卜工具，由三个 12 面骰子组成，分别代表占星学的三大要素。

三个骰子：

13.2 使用方法

1. 提出明确问题（与塔罗类似，需要聚焦的提问）
2. 同时掷三个骰子
3. 读取结果：行星 + 星座 + 宫位 = 一个三维组合
4. 解读：综合三者的象征意义回答问题

解读框架：

[行星] 在 [星座] 的 [宫位]

= [这股力量/主题] 以 [这种方式/风格] 在 [这个生活领域] 表现

例：金星 + 天蝎座 + 7 宫
= 爱情/价值（金星）以深层、执着的方式（天蝎）在伴侣关系领域（7 宫）表现
→ 解读："你的伴侣关系中可能出现深层的情感议题，需要直面而非回避"

13.3 编程实现

import random

PLANETS = ['太阳', '月亮', '水星', '金星', '火星', '木星',
           '土星', '天王星', '海王星', '冥王星', '北交点', '南交点']
SIGNS = ['白羊', '金牛', '双子', '巨蟹', '狮子', '处女',
         '天秤', '天蝎', '射手', '摩羯', '水瓶', '双鱼']
HOUSES = list(range(1, 13))

# 行星关键词（用于 LLM 提示词）
PLANET_KEYWORDS = {
    '太阳': '自我、意志、核心议题',
    '月亮': '情绪、直觉、内心需求',
    '水星': '沟通、思考、信息',
    '金星': '爱情、金钱、审美、价值',
    '火星': '行动、冲突、欲望、勇气',
    '木星': '扩展、机遇、乐观、成长',
    '土星': '限制、责任、纪律、时间',
    '天王星': '突变、创新、意外、自由',
    '海王星': '幻想、灵性、迷惑、直觉',
    '冥王星': '转化、权力、深层变化',
    '北交点': '灵魂方向、成长课题',
    '南交点': '过去模式、需要释放的',
}

def roll_astro_dice():
    """掷占星骰子，返回三维组合"""
    planet = random.choice(PLANETS)
    sign = random.choice(SIGNS)
    house = random.choice(HOUSES)
    return {
        'planet': planet,
        'sign': sign,
        'house': house,
        'summary': f"{planet} 在 {sign} 的 第{house}宫"
    }

def generate_dice_prompt(result, question):
    """生成送入 LLM 的解读提示词"""
    return f"""
用户问题：{question}
占星骰子结果：{result['summary']}

行星 {result['planet']} 代表：{PLANET_KEYWORDS[result['planet']]}
星座 {result['sign']} 代表的风格：[元素+性质的组合特征]
第 {result['house']} 宫代表的领域：[该宫位关键词]

请综合三者，针对用户的问题给出占星骰子的解读（3-5 句话）。
"""

可编程性评估： 占星骰子的随机性（random.choice）+ 组合解读（LLM）是最容易实现的占星工具，无需天文计算。总组合数 = 12 × 12 × 12 = 1,728 种。

来源

• Swiss Ephemeris 官方文档: https://www.astro.com/swisseph/
• Kerykeion GitHub: https://github.com/g-battaglia/kerykeion
• Flatlib GitHub: https://github.com/flatangle/flatlib
• Saravali House Systems: https://saravali.github.io/astrology/housesystems.html
• RadixPro Ascendant 计算: https://radixpro.com/a4a-start/the-ascendant/
• Cafe Astrology 相位解读: https://cafeastrology.com/articles/aspectsinastrology.html
• Astro-seek 推运工具: https://horoscopes.astro-seek.com/
• Morinus Primary Directions 公式: https://morinus-astrology.com/regiomontanus-direction/
• Altair Astrology Primary Directions 手算教程: https://altairastrology.wordpress.com/charts-2/calculating-primary-directions-by-hand/
• Astro-seek Firdaria 计算器: https://horoscopes.astro-seek.com/firdaria-astrology-calculator
• Skyscript Firdaria 词条: https://www.skyscript.co.uk/glossary/firdar-firdaria/
• Starzology Composite Chart 中点计算: https://www.starzology.com/midpoint-composite-charts/
• Astro.com Davison Relationship Chart: https://www.astro.com/astrology/tma_article150106_e.htm
• Starzology Davison Charts: https://www.starzology.com/davison/
• Tarot.com 运势写作方法论: https://www.tarot.com/astrology/how-horoscopes-work
• Cafe Astrology Synastry 宫位叠加: https://cafeastrology.com/articles/synastryplanetsinhouses.html
• Kerykeion 官网 (v5+ 支持 Composite/Synastry/Returns): https://kerykeion.net/

八字/四柱命理 — 完整测算规则

📍 位置：玄学测算体系 / 3-八字四柱 📌 核心发现：八字排盘本质是日期时间到天干地支的映射 + 五行生克关系推演，所有规则均可精确编程实现 📥 输入：GitHub 开源库（hkargc/paipan、triumpher/bazidivination、axbug/8Char-Uni-App）、百度百科、知乎专栏、CSDN 博客 📤 流向：→ findings.md

一、基础数据定义

1.1 十天干

1.2 十二地支

1.3 五行生克关系

相生：木→火→土→金→水→木

相克：木→土→水→火→金→木

二、排盘规则：四柱推算

2.1 年柱推算

公式（公元纪年法，公元4年=甲子年）：

天干序号 = (年份 - 3) % 10
地支序号 = (年份 - 3) % 12

• 余数为 0 时：天干=癸(10)，地支=亥(12)
• 余数 1-9/1-11 直接对应上表

注意：年柱以立春为分界，不是以农历正月初一。 立春前出生的人仍算上一年。

示例：1984 年 → (1984-3)%10=1 → 甲，(1984-3)%12=1 → 子 → 甲子年

2.2 月柱推算

地支固定规则：

注意：月柱以节气为分界，不是以农历月份：

天干推算（五虎遁年起月诀）：

甲己之年丙作首，乙庚之岁戊为头，丙辛之岁寻庚上，丁壬壬位顺行流，更有戊癸何处觅，甲寅之上好追求。

编程公式：

月干序号 = (年干序号 % 5) * 2 + 月份数（地支序号-1）

更精确的表达：设年干序号为 Y（1-10），月份为 M（1-12）：

月干 = ((Y % 5) * 2 + M) % 10
// 其中 Y%5==0 时视为5

2.3 日柱推算

日柱无法通过简单公式计算，传统上需查万年历。但有近似公式可用：

蔡勒公式变体（日柱速算）：

日柱干支需要一个基准日期 + 天数差来推算。已知公元 1 年 1 月 1 日为甲子日的偏移量。

实际编程中推荐方法：

1. 选择一个已知日柱的基准日期（如 1900年1月1日 = 甲子日偏移量已知）
2. 计算目标日期与基准日期的天数差
3. 日柱序号 = (基准序号 + 天数差) % 60

来源: hkargc/paipan 项目使用寿星万年历算法，精度达到秒级。

2.4 时柱推算

地支固定：按出生时间对应十二时辰（见 1.2 表）

注意：23:00-01:00 为子时。关于”早子时/晚子时”有流派差异：

• 传统派：23:00后即算次日子时（日柱进一位）
• 现代派：23:00-24:00仍算当日晚子时

天干推算（五鼠遁日起时诀）：

甲己还加甲，乙庚丙作初，丙辛从戊起，丁壬庚子居，戊癸何方发，壬子是真途。

编程公式：

时干序号 = ((日干序号 % 5) * 2 - 1 + 时辰序号 - 1) % 10 + 1

三、地支藏干

四、纳音五行（六十甲子纳音表）

每两个干支为一组，共 30 组纳音：

编程实现：将六十甲子按序号 0-59 排列，纳音序号 = 甲子序号 / 2（整除），用数组直接查表。

五、十神推算规则

5.1 十神定义

以**日干（日主）**为核心，与其他天干的关系：

5.2 推算方法

已知：日干 D，待测天干 X

1. 判断 D 与 X 的五行关系（生/克/同）
2. 判断 D 与 X 的阴阳是否相同
3. 查上表得十神

5.3 完整对照表（日干→其他天干→十神）

以甲日干为例：

通用公式：根据五行关系 + 阴阳关系自动推导，无需硬编码所有组合。

六、用神取法规则

6.1 扶抑法（最常用）

• 日主旺：取克泄耗为用神（官杀、食伤、财星）
• 日主弱：取生扶为用神（印星、比劫）

6.2 调候法

根据出生月份（季节）选用神：

• 冬月生人（亥子丑）：喜火暖之
• 夏月生人（巳午未）：喜水润之

6.3 通关法

当命局中两种五行相克且势均力敌时，取能通关（同时泄一方生另一方）的五行为用神。

6.4 从格

日主极弱，无根无助，则”从”其旺势：

• 从财格、从官格、从儿格等

流派差异：用神取法是八字命理中争议最大的部分，不同门派规则差异显著。上述为”子平真诠”体系的基本取法。

七、神煞速查表

7.1 天乙贵人

甲戊并牛羊，乙己鼠猴乡，丙丁猪鸡位，壬癸兔蛇藏，庚辛逢虎马。

7.2 驿马

以年支或日支查：申子辰见寅，寅午戌见申，巳酉丑见亥，亥卯未见巳。

7.3 桃花（咸池）

以年支或日支查：申子辰见酉，寅午戌见卯，巳酉丑见午，亥卯未见子。

7.4 天德贵人

7.5 月德贵人

7.6 华盖

7.7 空亡

以日柱所在旬来定。六十甲子分六旬，每旬10个干支，12地支中有2个地支不在该旬中，此2地支即为空亡。

八、大运排法

8.1 顺逆规则

• 阳年男命 / 阴年女命 → 大运顺排
• 阴年男命 / 阳年女命 → 大运逆排

阳年：年干为甲、丙、戊、庚、壬 阴年：年干为乙、丁、己、辛、癸

8.2 起运数计算

• 顺排：从出生日起，顺数到下一个节（注意是节不是气）的天数，除以 3 = 起运岁数
• 逆排：从出生日起，逆数到上一个节的天数，除以 3 = 起运岁数

换算精度：

• 3 天 = 1 年
• 1 天 = 4 个月
• 1 个时辰 = 10 天

8.3 大运干支

从月柱开始：

• 顺排：按六十甲子顺序排下去
• 逆排：按六十甲子逆序排下去

每步大运管 10 年。

8.4 十二节（非气）

九、流年断法基本规则

9.1 流年天干地支

每个年份对应一个干支（与年柱算法相同），即该年的流年。

9.2 流年与命局的关系

• 流年天干克日主 → 压力年
• 流年天干生日主 → 助力年
• 流年地支冲命局地支 → 动荡变化
• 流年地支合命局地支 → 合化变化

9.3 流年与大运的叠加

流年需与当前大运合看：

• 流年犯大运忌神 → 凶
• 流年引动大运喜神 → 吉
• 天克地冲 → 大变动之年

十、刑冲合害关系

10.1 地支六合

子丑合（土）、寅亥合（木）、卯戌合（火）、辰酉合（金）、巳申合（水）、午未合（土/火）

10.2 地支三合

申子辰合水局、亥卯未合木局、寅午戌合火局、巳酉丑合金局

10.3 地支六冲

子午冲、丑未冲、寅申冲、卯酉冲、辰戌冲、巳亥冲

10.4 地支三刑

• 寅巳申 → 无恩之刑
• 丑未戌 → 持势之刑
• 子卯 → 无礼之刑
• 辰辰、午午、酉酉、亥亥 → 自刑

10.5 天干五合

甲己合（土）、乙庚合（金）、丙辛合（水）、丁壬合（木）、戊癸合（火）

参考来源

• hkargc/paipan — PHP/JS 八字排盘，支持-1000到3000年
• triumpher/bazidivination — Python 八字排盘，含子平真诠教程
• axbug/8Char-Uni-App — UniApp 八字排盘，含四柱、十神、纳音、大运等
• china-testing/bazi — Python 八字排盘，含冲刑合会分析
• 《三命通会》— 纳音五行权威来源
• 《子平真诠》— 十神用神体系权威来源
• 《渊海子平》— 神煞体系权威来源
• 百度百科”生辰八字”、“四柱神煞”、“六十甲子纳音表”

紫微斗数 — 完整测算规则

📍 位置：玄学测算体系 / 4-紫微斗数 📌 核心发现：紫微斗数排盘是一套确定性的映射算法——从农历生年月日时出发，经五行局定位紫微星，再由紫微星推导全盘 100+ 颗星的宫位 📥 输入：GitHub 开源库（SylarLong/iztro、haibolian/natal-chart）、紫微研习社 iztro.com、ziweicn.com、维基百科 📤 流向：→ findings.md

一、基础概念

1.1 十二宫位

紫微斗数的命盘为 12 宫格，对应十二地支宫位：

巳    午    未    申
辰              酉
卯              戌
寅    丑    子    亥

十二宫含义（从命宫起逆时针排列）：

二、安命宫与身宫

2.1 安命宫

口诀：寅起正月，顺数至生月，逆数生时为命宫。

算法：

1. 从寅宫开始，代表正月（农历一月）
2. 从寅宫顺时针数到出生的农历月份，停在该宫
3. 从该宫起算子时，逆时针数到出生的时辰，所到之宫即为命宫

编程公式：

命宫地支序号 = (寅的序号 + 月份 - 1 - 时辰序号)
// 需要 mod 12，确保在 0-11 范围内
// 寅=2（0-indexed），月份1-12，时辰0-11（子=0）
命宫 = (2 + month - 1 - hour) % 12
// 若结果为负，加12

2.2 安身宫

口诀：寅起正月，顺数至生月，顺数生时为身宫。

算法：与命宫相同，但第 3 步改为顺时针数到出生时辰。

编程公式：

身宫 = (2 + month - 1 + hour) % 12

2.3 安十二宫

从命宫位置开始，逆时针依次排列：命宫、兄弟、夫妻、子女、财帛、疾厄、迁移、交友、事业、田宅、福德、父母。

三、定五行局

3.1 起寅首

确定命宫的天干地支。天干由出生年的天干推算（五虎遁，与八字月柱天干规则相同）。

3.2 纳音定五行局

天干取数：

地支取数：

计算方法：

sum = 天干数 + 地支数
if sum > 5: sum -= 5

结果对应五行局：

四、安紫微星

4.1 安星口诀

六五四三二，酉午亥辰丑，局数除日数，商数宫前走；若见数无余，便要起虎口，日数小于局，还直宫中守。

4.2 算法

设五行局数为 J，出生农历日数为 D：

1. D 能被 J 整除：商 Q = D/J，从寅宫起顺数 Q 个宫位，该宫安紫微星
2. D 不能被 J 整除：
   • 需要找到最小的补数 K（K=1,2,3,…），使 (D+K) 能被 J 整除
   • 商 Q = (D+K)/J
   • 从寅宫起顺数 Q 个宫位
   • 若 K 为奇数：从该宫逆数 K 个宫位
   • 若 K 为偶数：从该宫顺数 K 个宫位
   • 最终所到之宫安紫微星
3. D < J（日数小于局数）：紫微星安在寅宫（或按上述规则计算 K）

4.3 完整对照表（安紫微星宫位）

以水二局为例（局数=2）：

（实际编程建议直接查表，下面给出完整查表数据结构）

编程中通常预生成一个 紫微星位表[局数][日数] 的二维数组。iztro 项目即采用此方式。

五、安十四主星

5.1 紫微星系（6颗，从紫微星位置逆排）

口诀：紫微逆去天机星，隔一太阳武曲辰，连接天同空二宫，廉贞居处方是真。

从紫微星位置开始，逆时针排列：

5.2 天府星系（8颗，从天府星位置顺排）

口诀：天府顺行有太阴，贪狼而后巨门临，随来天相天梁继，七杀空三是破军。

天府星与紫微星的对称关系：

编程规律：紫微在第 N 宫，天府在第 (寅+申-N)%12 = (2+8-N)%12 宫（但需验证，不完全线性，建议查表）。

从天府星位置开始，顺时针排列：

六、安辅星

6.1 左辅、右弼（按月安）

• 左辅：辰宫起正月，顺数至出生月
• 右弼：戌宫起正月，逆数至出生月

左辅宫 = (辰 + 月 - 1) % 12 = (4 + month - 1) % 12
右弼宫 = (戌 - 月 + 1) % 12 = (10 - month + 1) % 12

6.2 文昌、文曲（按时安）

• 文昌：戌宫起子时，逆数至出生时辰
• 文曲：辰宫起子时，顺数至出生时辰

文昌宫 = (戌 - 时辰) % 12 = (10 - hour) % 12
文曲宫 = (辰 + 时辰) % 12 = (4 + hour) % 12

6.3 禄存（按年干安）

七、安煞星

7.1 擎羊、陀罗（按年干安）

以禄存位置为基准：

• 擎羊：禄存的下一宫（顺时针）
• 陀罗：禄存的上一宫（逆时针）

7.2 火星、铃星（按年支 + 时辰安）

火星起始宫位：

从起始宫顺数至出生时辰。

铃星起始宫位：

流派差异：火星铃星的安法在三合派与飞星派之间有较大差异，以上为三合派常用规则。

7.3 天魁、天钺（按年干安）

甲戊庚牛（丑）羊（未），乙己鼠（子）猴（申）乡，丙丁猪（亥）鸡（酉）位，壬癸兔（卯）蛇（巳）藏，六辛逢马（午）虎（寅）。

7.4 地空、地劫（按时辰安）

• 地劫：亥宫起子时，顺数至出生时辰
• 地空：亥宫起子时，逆数至出生时辰

地劫宫 = (亥 + 时辰) % 12 = (11 + hour) % 12
地空宫 = (亥 - 时辰) % 12 = (11 - hour) % 12

八、四化规则

8.1 按出生年天干定四化

四化：化禄、化权、化科、化忌

四化对照表（南派/三合派标准）：

8.2 流派差异

注意：四化的流派差异主要体现在化科和化忌的个别星曜上。最大争议在”戊干化科”是右弼还是天机。

九、大限与流年

9.1 大限（十年大运）

• 每个大限管 10 年
• 起始年龄 = 五行局数（水二局从 2 岁起，木三局从 3 岁起…）
• 阳男阴女：从命宫顺时针排大限
• 阴男阳女：从命宫逆时针排大限

阳年：甲丙戊庚壬年出生 阴年：乙丁己辛癸年出生

每个大限宫位的天干地支 = 该宫位本身的天干地支。

9.2 小限（一年一宫）

小限一律男命顺行、女命逆行（不分阴阳）。

起始宫位按年支分组：

9.3 流年

• 流年命宫 = 该年地支所在的宫位
• 如甲子年，流年命宫在子宫
• 流年十二宫从流年命宫开始，按与本命盘相同的顺序排列

十、星曜亮度（庙旺利平陷）

每颗星在不同宫位有不同亮度等级：

（完整的庙旺表需要 14 主星 x 12 宫位 = 168 个数据点，建议直接从 iztro 源码中提取。）

参考来源

• SylarLong/iztro — 轻量级紫微斗数排盘 JS 库，基于古籍安星诀算法
• 紫微研习社安星诀 — 完整安星口诀与规则
• 紫微斗数学堂 — 安星诀详解
• 紫微取象派 — 六吉六凶安法
• haibolian/natal-chart — 移动端紫微排盘
• cubshuang/ZiWeiDouShu — 简易紫微命盘网页
• 维基百科”紫微斗数”条目
• 《紫微斗数全书》— 安星诀权威来源

塔罗牌体系与解读规则

📍 位置：玄学测算体系 / 塔罗牌 📌 核心发现：塔罗牌没有”计算公式”，核心是一套结构化的符号系统 + 组合解读规则。牌义体系（78 张牌 × 正逆位）是确定性的，可作为 LLM 的 reference 数据；但牌面间的互动解读本质上是语义推理任务，天然适合 LLM 📥 输入：Rider-Waite-Smith 体系（最通用）、卡巴拉对应体系 📤 流向：→ findings.md 可编程性评估

一、体系概述

标准塔罗牌共 78 张：

• 大阿尔卡纳（Major Arcana）：22 张，编号 0~21，代表人生重大主题和灵性旅程
• 小阿尔卡纳（Minor Arcana）：56 张，分 4 个花色，每花色 14 张（Ace~10 + Page/Knight/Queen/King）

主流体系：

• Rider-Waite-Smith（RWS）：最通用，1909 年，Arthur Edward Waite 设计、Pamela Colman Smith 绘制
• Thoth：Aleister Crowley 设计，更偏神秘学和卡巴拉
• Marseille：最古老的传统牌面

二、大阿尔卡纳（22 张）完整牌义

愚者之旅（The Fool’s Journey）

大阿尔卡纳讲述从 0（愚者）到 21（世界）的灵性成长之旅。

三、小阿尔卡纳（56 张）

3.1 四花色与元素对应

3.2 数字牌（Ace~10）牌义框架

数字命理贯穿全部四花色，同一数字在不同花色中展现同一主题在不同生命领域的表达：

3.3 宫廷牌（Court Cards）

3.4 权杖花色完整牌义

3.5 圣杯花色完整牌义

3.6 宝剑花色完整牌义

3.7 金币花色完整牌义

四、主要牌阵（Spreads）

4.1 三牌阵（Three-Card Spread）

最基础的牌阵，3 张牌分别代表：

4.2 凯尔特十字（Celtic Cross）—— 10 张牌

最经典、最全面的牌阵。分为两部分：十字形（6 张）+ 权杖柱（4 张）

4.3 马蹄形牌阵（Horseshoe）—— 7 张牌

4.4 关系牌阵 —— 5 张牌

五、牌面间的互动解读规则

5.1 元素互动

5.2 数字重复规则

当牌阵中出现多张相同数字的牌时：

• 2 张同数字：主题强调，该阶段的能量显著
• 3 张同数字：强烈信号，该主题是核心
• 4 张同数字：极其罕见，该主题已成为不可忽视的力量

5.3 大小阿尔卡纳比例

• 多数为大阿尔卡纳 → 问题涉及重大人生转变、业力课题
• 多数为小阿尔卡纳 → 日常问题、可控范围内的事件
• 混合 → 日常事件中有更深层的灵性意义

5.4 花色主导

• 权杖主导 → 行动和创意是关键
• 圣杯主导 → 情感和关系是核心
• 宝剑主导 → 冲突和思维是焦点
• 金币主导 → 物质和实际是重点

六、卡巴拉生命之树与大阿尔卡纳的对应

6.1 基本框架

生命之树（Tree of Life）有 10 个质点（Sephiroth）和 22 条路径（Paths）。22 条路径对应 22 张大阿尔卡纳和 22 个希伯来字母。

6.2 完整路径对应表

6.3 小阿尔卡纳与质点对应

七、编程实现要点

可完全自动化的部分

• 牌库定义（78 张牌的完整数据结构）
• 随机抽牌（含正逆位随机）
• 牌阵布局（位置 + 含义映射）
• 元素互动规则（查表）
• 数字/花色统计

需要 LLM 的部分

• 牌面组合的综合解读（核心价值所在）
• 根据问题类型调整解读方向
• 叙事化输出
• 跨位置的关联分析

数据结构示例

MAJOR_ARCANA = {
    0: {
        "name": "The Fool",
        "name_cn": "愚者",
        "upright": ["天真", "新开始", "自由精神"],
        "reversed": ["鲁莽", "被利用", "欠考虑"],
        "element": "Air",
        "hebrew": "Aleph",
        "kabbalah_path": "Kether → Chokmah",
    },
    # ... 其余 21 张
}

MINOR_ARCANA = {
    "wands": {
        "element": "Fire",
        "domain": "passion_action_will",
        "cards": {
            "ace": {"upright": [...], "reversed": [...]},
            # ...
        }
    },
    # ... 其余 3 花色
}

SPREADS = {
    "three_card": {
        "positions": [
            {"index": 1, "name": "Past", "meaning": "过去的影响"},
            {"index": 2, "name": "Present", "meaning": "当前的情况"},
            {"index": 3, "name": "Future", "meaning": "可能的未来"},
        ]
    },
    "celtic_cross": {
        "positions": [
            {"index": 1, "name": "Present", "meaning": "当下情境"},
            # ... 10 个位置
        ]
    }
}

来源

• Labyrinthos 78 牌完整牌义: https://labyrinthos.co/blogs/tarot-card-meanings-list
• Labyrinthos 凯尔特十字牌阵: https://labyrinthos.co/blogs/learn-tarot-with-labyrinthos-academy/the-celtic-cross-tarot-spread-exploring-the-classic-10-card-tarot-spread
• Labyrinthos 卡巴拉对应: https://labyrinthos.co/blogs/learn-tarot-with-labyrinthos-academy/the-tarot-and-the-tree-of-life-correspondences
• Biddy Tarot 凯尔特十字: https://biddytarot.com/blog/how-to-read-the-celtic-cross-tarot-spread/
• Tarot Elements 数字命理: https://tarotelements.com/numerology-of-the-minor-arcana/
• Wikipedia Major Arcana: https://en.wikipedia.org/wiki/Major_Arcana

风水测算规则

📍 位置：玄学测算体系 / 风水 📌 核心发现：风水中”理气派”（玄空飞星、八宅）有明确的数学计算规则，可完全编程实现；“形势派”依赖地形判断，不可编程 📥 输入：专业风水书籍、开源排盘工具、百度百科/知乎专业解答 📤 流向：→ findings.md 可编程性评估

一、风水两大流派

本文聚焦理气派的两大体系：八宅风水和玄空飞星。

二、三元九运（时间框架）

三元九运是风水的时间坐标系，是玄空飞星的时间基础。

2.1 划分规则

以 180 年为一个大周期（正元），分为三元，每元 60 年，再各分三运，每运 20 年。

2.2 天文依据

土星与木星每隔约 20 年会合一次（形成合相），三次合相约 60 年（一元），九次合相约 180 年（一个正元）。

2.3 编程计算

def get_period(year):
    """计算某年所属的运"""
    # 以1864为基准年（一运起始）
    cycle_year = (year - 1864) % 180
    period = (cycle_year // 20) + 1
    return min(period, 9)  # 最大为9

三、八宅风水

3.1 核心概念

八宅风水将住宅和人各分为八种类型，通过匹配确定吉凶方位。

3.2 本命卦计算

2000 年之前出生：

2000 年之后出生：

3.3 余数→卦 对照表

注意：余数为 0 视为 9（离卦）。余数为 5 男女不同卦。

3.4 东四命 / 西四命

核心规则：东四命住东四宅，西四命住西四宅。

3.5 八方吉凶星配置

每种命卦在八个方位上分布四吉星和四凶星：

四吉星：

四凶星：

3.6 各命卦的八方吉凶对照表

流派差异：不同八宅派别的吉凶方位表略有出入，上表为主流版本，建议实现时以《八宅明镜》为准，或提供多版本切换。

四、玄空飞星

4.1 核心概念

玄空飞星以洛书九宫为空间模型，以三元九运为时间框架，通过飞星排布分析住宅的时空能量。

4.2 洛书九宫基础

┌───┬───┬───┐
│ 4 │ 9 │ 2 │  巽（东南）  离（南）  坤（西南）
├───┼───┼───┤
│ 3 │ 5 │ 7 │  震（东）    中宫      兑（西）
├───┼───┼───┤
│ 8 │ 1 │ 6 │  艮（东北）  坎（北）  乾（西北）
└───┴───┴───┘

这是”元旦盘”（基础盘），所有飞星运动以此为参照。

4.3 飞星飞布轨迹

入中宫的星按以下固定顺序飞布八方：

中宫 → 西北(乾6) → 西(兑7) → 东北(艮8) → 南(离9)
→ 北(坎1) → 西南(坤2) → 东(震3) → 东南(巽4)

数字用 1~9 循环（9 之后回到 1）。

4.4 顺飞与逆飞

• 顺飞：按 1→2→3→…→9→1 递增
• 逆飞：按 9→8→7→…→1→9 递减

4.5 排运盘

1. 确定建筑物”入伙”年份所属的运数
2. 将运数放入中宫
3. 运盘一律顺飞

示例：九运（2024~2043）运盘

┌───┬───┬───┐
│ 3 │ 8 │ 1 │
├───┼───┼───┤
│ 2 │ 4(←9入中,顺飞) │ 6 │  （注：这里9入中顺飞）
├───┼───┼───┤
│ 7 │ 9(←原5位) │ 5 │
└───┴───┴───┘

实际九运运盘（9入中宫顺飞）：

4.6 排山盘和向盘

步骤：

1. 用罗盘测量建筑的坐向（坐山和朝向），精确到 24 山
2. 找到运盘中坐山方位的星数 → 作为山盘的入中宫数
3. 找到运盘中朝向方位的星数 → 作为向盘的入中宫数
4. 判断顺飞还是逆飞

4.7 顺逆飞判断规则——三元龙阴阳

24 山分为天元龙、人元龙、地元龙，各有阴阳属性：

判断流程：

1. 确定坐山/朝向属于哪个三元龙
2. 该三元龙是阳 → 顺飞
3. 该三元龙是阴 → 逆飞

4.8 九星含义

当令判断：当前运数及其前后一运的星为”当令”或”将令”，其余为”退令”。九运中，9 当令，1 将令，8 退令。

4.9 山向星组合解读

每个宫位有三个数字：运盘星（底层）、山星（左上）、向星（右上）。

关键组合判断：

• 旺山旺向：山星和向星都是当令星，最吉
• 上山下水：山星飞到向方（水位），向星飞到山方，最凶
• 双星到向：山星和向星都飞到向方
• 双星到坐：山星和向星都飞到坐方

五、罗盘（罗经）基本层次

24 山的排布：

北：壬、子、癸
东北：丑、艮、寅
东：甲、卯、乙
东南：辰、巽、巳
南：丙、午、丁
西南：未、坤、申
西：庚、酉、辛
西北：戌、乾、亥

每山占 15°（360° ÷ 24 = 15°）。

六、五行生克在风水中的应用

6.1 基础生克关系

生：木→火→土→金→水→木
克：木→土→水→火→金→木

6.2 风水中的五行应用

6.3 飞星化解方案（程序化规则）

七、编程实现要点

可完全自动化的部分

• 本命卦计算（纯数学）
• 东四命/西四命判断
• 八方吉凶星配置（查表）
• 三元九运判断（纯数学）
• 运盘排布（固定算法）
• 山盘/向盘排布（固定算法 + 查表）
• 飞星组合判断（旺山旺向等）
• 五行化解建议（查表）

需要人工输入的部分

• 建筑坐向（需罗盘实测）
• 入伙年份
• 室内格局

不可编程的部分

• 形势派的外部环境判断（山形、水势、路冲等）

来源

• 百度百科 三元九运: https://baike.baidu.com/item/三元九运
• 阐微堂 无常派玄空: https://www.chanweitang.com/post/155.html
• 知乎 八宅风水计算: https://zhuanlan.zhihu.com/p/698462765
• FengShuiBalanz 飞星计算器: https://www.fengshuibalanz.com/flying-star-calculator/
• 神机阁 八宅风水: https://www.shenjige.cn/details/yx0pMtrNQ.html
• Wikipedia Flying Star Feng Shui: https://en.wikipedia.org/wiki/Flying_Star_Feng_Shui

奇门遁甲 — 完整测算规则

📍 位置：玄学测算体系 / 7-奇门遁甲 📌 核心发现：奇门遁甲是一套时空合一的模型，核心是将时间（干支历）映射到九宫格的四层盘面（天地人神），共 1080 种局面 📥 输入：GitHub 开源库（kentang2017/kinqimen、Taogram/taobi、qfdk/qimen）、堪舆宙 exzh.net、CSDN 博客、知乎专栏 📤 流向：→ findings.md

一、基础结构

1.1 九宫格（洛书九宫）

┌────────┬────────┬────────┐
│ 巽四宫 │ 离九宫 │ 坤二宫 │
│ 东南   │ 正南   │ 西南   │
├────────┼────────┼────────┤
│ 震三宫 │ 中五宫 │ 兑七宫 │
│ 正东   │ 中央   │ 正西   │
├────────┼────────┼────────┤
│ 艮八宫 │ 坎一宫 │ 乾六宫 │
│ 东北   │ 正北   │ 西北   │
└────────┴────────┴────────┘

洛书数：戴九履一，左三右七，二四为肩，六八为足，五居中宫。

1.2 四层盘面

1.3 三奇六仪

三奇：

• 乙（日奇/文官）
• 丙（月奇/武官）
• 丁（星奇/后勤）

六仪：

• 戊、己、庚、辛、壬、癸

固定排列顺序（永不改变）：

戊 → 己 → 庚 → 辛 → 壬 → 癸 → 丁 → 丙 → 乙

1.4 六甲隐遁规则

甲为十干之首，藏而不现，隐遁于六仪之下：

二、九星

2.1 九星名称与固定宫位

2.2 九星排列顺序

天蓬 → 天芮 → 天冲 → 天辅 → 天禽 → 天心 → 天柱 → 天任 → 天英

三、八门

3.1 八门名称与固定宫位

3.2 八门排列顺序

休 → 生 → 伤 → 杜 → 景 → 死 → 惊 → 开

（注意：此为排列顺序，非宫位顺序）

四、八神

4.1 八神名称与排列顺序

注意：阳遁顺排八神（顺时针），阴遁逆排八神（逆时针）。

流派差异：第5、6神有两种版本：

• 版本A：值符、腾蛇、太阴、六合、白虎、玄武、九地、九天
• 版本B：值符、腾蛇、太阴、六合、勾陈、朱雀、九地、九天

五、阳遁与阴遁

5.1 基本规则

• 冬至后 → 用阳遁（冬至到芒种，共12个节气）

• 夏至后 → 用阴遁（夏至到大雪，共12个节气）

• 阳遁：三奇六仪在地盘顺排（1→2→3→…→9）

• 阴遁：三奇六仪在地盘逆排（9→8→7→…→1）

5.2 二十四节气对应局数

每个节气 15 天，分为上元（前5天）、中元（中5天）、下元（后5天）。

阳遁用局表

记忆口诀：冬至惊蛰一七四，小寒二八五相随，大寒春分三九六，立春八五二为期，雨水九六三流去，清明立夏四一七，谷雨小满五二八，芒种六三九是仪。

阴遁用局表

记忆口诀：夏至白露九三六，小暑八二五之间，大暑秋分七一四，立秋二五八方安，处暑一四七相寻，寒露立冬六九三，霜降小雪五八二，大雪四七一为关。

5.3 确定上中下元（符头）

每元的第一天的天干必为甲或己（称为”符头”）。

通过日干支判断所在旬的符头，再判断属于上元、中元还是下元：

编程方法：

1. 找到当前日干支所在的旬首（甲X）
2. 从旬首往前找到最近的甲或己日（符头）
3. 根据符头的地支判断上中下元
4. 结合当前节气查局数表

流派差异：

• 置闰法：当节气与符头不吻合时，需要”超神接气”处理
• 拆补法：以实际节气为准，节气前用上一个节气的局数，节气后用新节气的局数
• 茅山法：更简化的定局方式

六、起局完整步骤（时家奇门）

第一步：确定干支历

将起局时间转换为年干支、月干支、日干支、时干支。

第二步：定阳遁/阴遁和局数

1. 根据日期确定所在节气
2. 判断用阳遁还是阴遁
3. 确定上中下元
4. 查用局表得到局数 N

第三步：排地盘三奇六仪

阳遁：从第 N 宫开始，按洛书顺序（1→2→3→4→5→6→7→8→9），依次排入”戊己庚辛壬癸丁丙乙”。

阴遁：从第 N 宫开始，按洛书逆序（9→8→7→6→5→4→3→2→1），依次排入”戊己庚辛壬癸丁丙乙”。

洛书宫位顺序：1→2→3→4→5→6→7→8→9

示例（阳遁一局）：从1宫（坎）开始顺排

• 坎一宫：戊
• 坤二宫：己
• 震三宫：庚
• 巽四宫：辛
• 中五宫：壬
• 乾六宫：癸
• 兑七宫：丁
• 艮八宫：丙
• 离九宫：乙

第四步：找旬首，定值符值使

1. 查时柱干支所在的旬首（甲子、甲戌、甲申、甲午、甲辰、甲寅）
2. 根据六甲隐遁规则，找到旬首隐遁的仪（如甲子→戊）
3. 在地盘上找到该仪所在的宫位
4. 该宫位的固定九星 = 值符（天盘主星）
5. 该宫位的固定八门 = 值使（人盘主门）

第五步：排天盘九星

规则：值符随时干

1. 找到时干在地盘上所在的宫位
2. 将值符（九星）放在该宫位上
3. 其余八星按九星顺序依次排入后续宫位

中五宫处理：天禽星寄坤二宫。若值符为天禽星，寄入坤二宫。

第六步：排人盘八门

规则：值使随时宫

1. 确定值使门
2. 从值使门的原始宫位起算
3. 数到时辰地支所在的宫位数（阳遁顺数，阴遁逆数）
4. 将值使门安在目标宫位
5. 其余七门按八门顺序依次排入

具体计算：

• 值使原始宫位为 A
• 时辰地支对应的宫位为 B
• 从 A 数到 B 的步数（宫数），按阳顺阴逆
• 值使放在 B 宫，其他门按顺序排

第七步：排神盘八神

规则：小值符追随大值符

1. 神盘的值符放在天盘值符所在的宫位
2. 阳遁：从值符宫位顺时针排其余七神
3. 阴遁：从值符宫位逆时针排其余七神