命数天问 · Mingshu Tianwen

一个暗色主题的 Web 客户端 + 六个可离线运行的 Claude Code 占卜技能

---

一、这是什么 · 为什么做

命数天问 把中国传统数术（四柱八字、周公解梦、黄历择日、新生起名、风水堪舆）与西洋塔罗占星，做成六个真正跑起来的 Claude Code Agent Skill，并配一个暗色 Web 客户端把它们串成流式、可多轮追问的对话。每个技能都不是「让大模型编一段吉凶话术」——它先用内置的确定性 Python 脚本把公历转农历、排四柱、排玄空飞星、抽可复现的塔罗牌、排本命星盘等硬事实算准，再参照经典古籍（《穷通宝典》《周公解梦》《周易》《葬书》《青囊经》等）分层推演，最后给出「文化参照 + 现代视角」的交叉解读，而非字面预言。

做它的动机很简单：市面上的「AI 算命」大多是把星座运势换皮成聊天机器人，该算的没算准，该有的依据没有。这个项目想验证另一条路——让脚本负责事实、让典籍负责依据、让模型负责组织与表达，并且全程本地：Web 端驱动你本机已登录的 claude CLI（复用 Max 订阅的 OAuth，不要 API key），脚本也在本机执行，隐私不出机器；同时保留 OpenAI 兼容通路，让没有 Claude 订阅的人也能用自己的模型跑同一套技能。

Web 客户端首页——诸术同参，点技能卡即可发起对话

---

二、内置的六个技能

触发方式：在对话里用自然语言描述你的问题即可，模型会自动选择合适的技能；也可在左侧「技能库」里显式指定。

技能	目录名	一句话功能	内置脚本
📜 四柱八字	bazi	排四柱命盘，参照命理典籍看格局、用神与大运流年	纯典籍知识（references/）
🌙 周公解梦	zhougong-dream-interpretation	周公断语 · 五行天人感应 · 现代心理学，三层交叉解读	birthinfo.py geoweather.py
📅 占事吉凶	zhanshi-jixiong	针对某件事、某一天，四层推演吉凶与择吉建议	almanac.py bazi.py geoweather.py
🔮 塔罗占星	tarot-astrology	亲手抽三张塔罗，再与西洋占星本命盘交叉对照	draw_cards.py natal_chart.py transit.py synastry.py solar_arc.py …
🍼 新生起名	qiming	为宝宝取 5 个精选名字，音韵·五行·寓意·出处兼美	bazi_wuxing.py char_lookup.py name_score.py hepan.py
🧭 风水堪舆	fengshui-kanyu	形势峦头 · 玄空理气 · 现代人居，三层看阳宅阴宅	compass.py xuankong.py bazhai.py sanyuan.py surroundings.py + mcp/（stdio MCP server）

展开：每个技能的详细说明与使用示例

📜 四柱八字 bazi

交互式收集出生信息（阳历/农历、时辰、性别、出生地），排出年月日时四柱，参照《穷通宝典》《三命通会》《滴天髓》《渊海子平》《子平真诠》等九部典籍分析日主强弱、十神、格局、大运流年。

• 1995年3月8日辰时，男，杭州出生，帮我排八字
• 农历1990年腊月十五子时，女，看看格局与用神
• 2001年7月20日下午两点，成都，今年运势如何

🌙 周公解梦 zhougong-dream-interpretation

先按类别检索《周公解梦》原文吉凶断语，再以《周易》阴阳八卦、《尚书·洪范》五行学说与天人感应推演（结合本命纳音五行、做梦当天当地天气），最后辅以弗洛伊德/荣格/睡眠科学的心理学视角，形成「文化参照 + 心理洞察」式解读。

• 梦见水里游着一条大蛇
• 梦到自己的牙齿掉了好几颗
• 昨晚梦见在天上飞，越飞越高

📅 占事吉凶 zhanshi-jixiong

针对某一件具体事、某一天，用「黄历择日 + 四柱本命喜忌 + 阴阳五行天时 + 天人感应/梅花心易」四层独立推演，交叉汇聚成【吉 / 平·宜谨慎 / 凶·宜改期】的倾向与可执行建议。脚本排完整黄历（宜忌、建除、值神、廿八宿、彭祖百忌、冲煞、逐时辰吉凶）。

• 这周六适合搬家吗
• 下个月八号签合同好不好
• 明天出远门，帮我看看吉凶

🔮 塔罗占星 tarot-astrology

把「抽三张塔罗牌」与「西洋占星本命盘」合为一次解读：你带着具体问题来 → 在抽牌台亲手抽三张牌（可复现 seed，方向可手动转定）→ 若提供生日则脚本确定性排出星盘 → 用黄金黎明的塔罗↔占星对应把两者接起来 → 给出交叉对照表与审慎建议。脚本涵盖本命盘、相位、必然/偶然尊贵、行运、比较盘/组合盘、太阳弧推运。

• 抽三张牌看看这段关系会怎样
• 我该不该接受这份新工作
• 1998年5月生，看看本命盘与近期行运

🍼 新生起名 qiming

为宝宝取 5 个各有侧重的名字：有生辰则先用脚本排八字五行、判喜用，再从《诗经》《楚辞》《论语》《周易》、唐诗宋词等素材选字组名，按「音韵和谐·避免谐音·书写便利·性别适配·寓意美好」五大原则逐项体检，有父母姓名则做家族合参/避讳。

• 姓李，女孩，希望名字优雅有智慧，帮宝宝起个名
• 姓王的男孩，2025年8月15日9点20分出生，按八字五行取名
• 姓陈，女孩，家里辈分字是「思」，取个诗经里的名字

🧭 风水堪舆 fengshui-kanyu

你提供地点（最好经纬度）、周边环境描述或照片、阳宅或阴宅（可选坐向、建造年、居者生辰）→ 脚本确定性定位、查砂水地势、定二十四山坐向、排三元九运玄空飞星、八宅游年 → 再参《葬书》《青囊经》《撼龙经》《雪心赋》，以「形势派·理气派·现代建筑学」三层解读 → 给出交叉对照表与可执行、非破坏性的改善建议。

• 杭州西湖区，房子坐北朝南，帮我看看风水
• 我家大门正对阳台，是不是穿堂煞，怎么化解
• 办公室的财位、文昌位在哪，怎么布置

---

三、安装与使用

前置条件