All-in-one Chinese fortune-telling — BaZi (Four Pillars), ZiWei DouShu, QiMen DunJia, I Ching (Meihua + LiuYao), feng shui, marriage compatibility, plus dail...
---
name: yunshi
description: All-in-one Chinese fortune-telling — BaZi (Four Pillars), ZiWei DouShu, QiMen DunJia, I Ching (Meihua + LiuYao), feng shui, marriage compatibility, plus daily horoscope push to Telegram/Feishu. Built on iztro + lunar-typescript, no external API.
keywords: Chinese astrology, fortune telling, daily horoscope, divination, astrology, BaZi, Four Pillars, ZiWei DouShu, Purple Star Astrology, I Ching, feng shui, marriage compatibility, QiMen DunJia, Chinese zodiac, horoscope push, 算命, 八字, 今日运势, 紫微斗数, 占卜, 合婚, 风水, 命理, 流年, 운세, 運勢, tử vi
metadata:
openclaw:
runtime:
node: ">=18"
install:
- kind: node
package: iztro
env:
- name: OPENCLAW_KNOWLEDGE_DIR
required: false
description: "Optional path to ZiWei pattern knowledge base (.md files). Defaults to ~/.openclaw/workspace/knowledge. Skill degrades gracefully if absent."
---
# YunShi (运势) — All-in-One Chinese Fortune-Telling
> Daily horoscope · BaZi · ZiWei DouShu · I Ching · feng shui · marriage compatibility — 私人命理顾问,每日运程推送
## When to invoke this skill
Pick this skill when the user asks any of:
- **English:** "my horoscope", "daily horoscope", "horoscope now", "what's my fortune today", "cast I Ching", "throw a hexagram", "BaZi chart", "Four Pillars reading", "ZiWei reading", "Purple Star chart", "marriage compatibility", "feng shui layout", "lucky color today", "set up daily horoscope push"
- **中文:** 算命、看运势、今日运势、八字排盘、紫微斗数、占卜、起卦、六爻、奇门、合婚、看风水、流年大运
- **日本語:** 運勢、占い、八字、紫微斗数
- **한국어:** 운세, 사주, 자미두수
- **Tiếng Việt:** tử vi, bát tự, kinh dịch, xem bói
Skip when the user is asking about Western astrology, natal charts, transits, or numerology — those are handled by other skills (`mingli`, etc).
## 何时使用
- 八字/四柱排盘、流年大运分析
- 今日/近期运势(事业/财运/感情/健康)
- 紫微斗数命盘
- 合婚、双方八字相配
- 占卦(梅花易数、六爻、奇门遁甲)
- 风水布局、财位、幸运颜色
- 用户说"算命""看运势""占卜""帮我占一卦"
> 💡 想看每日幸运色/方位/数字、面试/考试/相亲场景运势、双人合盘?试试 [lucky-today](https://clawhub.ai/skills/lucky-today) —— 它是 yunshi 的轻量姊妹 skill,无依赖、纯 Markdown、中英双语。
---
## 🌐 多语言响应规则
1. **语言跟随**:用户语言 → 全程同语言回复
2. **专有术语保留中文**:柱名/星曜/卦名保持中文原字,括号内附译文
- 英文示例:Your Day Pillar is **甲子** (Jiǎ Zǐ — Wood Rat), indicating...
3. **脚本输出翻译**:脚本返回的中文结构由 Agent 解读后以用户语言呈现
4. **注册格式**:非中文用户使用 `Name | Gender(M/F) | BirthDate | BirthTime | BirthPlace`
5. **推送语言**:跟随档案 `language` 字段(默认 `zh`)
---
## 📖 功能列表
### 排盘
| 功能 | 命令 |
|------|------|
| 八字排盘(四柱/日主/用神/神煞) | `八字 1990-05-15 14:30` |
| 紫微斗数(命宫/十二宫/四化) | `紫微 1990-05-15 男` |
| 奇门遁甲 | `奇门 2026-03-24 15:00` |
| 择吉选日 | `择吉 2026-04 开业` |
### 分析
| 功能 | 命令 |
|------|------|
| 流年/大运/事业/财运/婚姻/健康 | `2026年运势` / `未来十年运势` / `财运好不好` |
| 合婚分析 | `合婚 张三 李四` |
| 风水分析 | `风水分析` |
### 占卜
| 功能 | 命令 |
|------|------|
| 梅花易数 | `梅花易数 3 5 2`(数字起卦)或留空时间起卦 |
| 六爻预测 | `六爻占卜` |
| 奇门占卜 | `奇门选时 明天15:00` |
### 每日运程(自动推送)
早晨 07:00 推送今日运势,晚间 20:00 推送明日预告。内容:综合指数、幸运颜色/方位/数字、今日宜忌、风险预警、吉时、每日一言。
| 推送命令 | 说明 |
|---------|------|
| `每日运势开` / `开启运势推送` | 开启 |
| `每日运势关` / `关闭运势推送` | 关闭 |
| `推送状态` | 查看当前状态 |
---
## 📦 环境依赖
- **Node.js >=18**(必须)
- `npm install` 安装 `iztro`(紫微斗数)和 `lunar-typescript`(农历转换)
- `OPENCLAW_KNOWLEDGE_DIR`:可选,紫微格局知识库,不存在时自动降级
- **推送渠道**:`telegram`/`feishu` 由 openclaw 运行时投递,skill 不调用任何渠道 API
- **新闻联动**:由 Agent 的 WebSearch 工具完成,无搜索能力时跳过
- **个人数据**:存储在 `data/profiles/<userId>.json`,含敏感信息,请确认访问权限
---
## 🛠️ 工具脚本
```bash
# 注册 / 档案
node scripts/register.js <userId> <姓名> <性别> <出生日期> <出生时间> [地点]
node scripts/profile.js show <userId>
node scripts/profile.js add <userId> spouse|child <姓名> <出生日期> <性别>
# 排盘
node scripts/ziwei.js <出生日期> <性别> [时辰]
node scripts/qimen.js [日期] [时辰]
node scripts/zhuanshi.js <YYYY-MM> <活动类型> [用户八字]
node scripts/fengshui.js [八字] [年份]
# 运程 / 合婚 / 占卜
node scripts/daily-fortune.js [日期]
node scripts/marriage.js <userId1> <userId2>
node scripts/meihua.js [数字1-3]
node scripts/liuyao.js [010203] [问题]
# 推送管理
node scripts/daily-push.js --dry-run # 模拟推送
node scripts/daily-push.js --test <userId> # 测试推送
node scripts/daily-push.js --list # 查看已开启用户
node scripts/push-toggle.js on|off|status <userId>
# 偏好追踪(每次提问后调用)
node scripts/preference-tracker.js record <userId> <topic> explicit_query|topic_drill
node scripts/preference-tracker.js weights|top <userId> [N]
# topic: 财运|事业|感情|健康|婚姻|子女|官司|出行|风水
```
---
## ⏰ Cron 推送配置
```bash
openclaw cron add "0 7 * * *" "cd ~/.openclaw/workspace/skills/yunshi && node scripts/daily-push.js"
openclaw cron list
openclaw cron delete <任务ID>
```
**子时算法**:`1` = 23:00-23:59 算次日(倪海厦派);`2` = 算当日(传统派)
---
## 📊 交叉验证权重
| 问题类型 | 八字 | 紫微 | 奇门 | 梅花 | 六爻 |
|----------|------|------|------|------|------|
| 终身命格 | 40% | 30% | - | - | - |
| 年度运势 | 40% | 30% | 20% | 10% | - |
| 事业决策 | 30% | 20% | 30% | - | 20% |
| 婚姻感情 | 40% | 30% | - | 10% | 20% |
| 当下问事 | - | - | 30% | 40% | 30% |
---
## ⚠️ 风险预警等级
🔴 严重(立即处理)· 🟡 注意(谨慎处理)· 🟢 提示(一般提醒)
类型:🚨 健康 · 💰 财务 · 💕 感情 · 💼 事业 · ⚖️ 法律
---
## 📁 数据文件
```
data/profiles/template.json # 仅模板,跟随 skill 发布
data/profiles/{userId}.json # 用户档案(本地生成,不发布、不上传)
data/push-log.json # 推送运行日志(本地生成,不发布)
scripts/ # register, ziwei, qimen, fengshui, profile,
# daily-fortune, marriage, meihua, liuyao,
# zhuanshi, daily-push, push-toggle, preference-tracker
```
---
## 🔐 数据与隐私 (Data & Privacy)
- **本地优先**:所有用户档案 `data/profiles/<userId>.json` 在你本机生成并保存,skill 自身不会向任何外部服务上传个人数据。
- **发布隔离**:`.clawhubignore` / `.gitignore` 已排除 `data/profiles/*.json`(仅 `template.json` 例外)和 `data/push-log.json`,安装包内不含真实档案。
- **文件权限**:建议把 `data/profiles/` 设为 `chmod 700`、档案文件设为 `chmod 600`,避免同机其他用户读取。
- **删除档案**:直接删除对应的 `data/profiles/<userId>.json` 即停止该用户的推送与历史读取,skill 不保留缓存副本。
- **共享与备份**:如需备份请加密;不要把已填写的档案提交到公共仓库或粘贴到聊天。
---
## ⚠️ 注意事项
1. 用户数据与 AI 计算冲突时,以用户提供信息为准
2. 命理是参考,不是定数
3. 用户档案为本地敏感数据,请勿随 skill 一并打包或公开分享
---
*Version: 1.2.5 · Updated: 2026-05-18*
don't have the plugin yet? install it then click "run inline in claude" again.