---
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*