# Qiuqian

> 赛博抽签 — 六爻铜钱起卦，装卦断卦，五维运势评分与建议

- **Type:** Skill
- **Install:** `agentstack add skill-kenn-w-qiuqian-skill-qiuqian-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Kenn-W](https://agentstack.voostack.com/s/kenn-w)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Kenn-W](https://github.com/Kenn-W)
- **Source:** https://github.com/Kenn-W/qiuqian-skill

## Install

```sh
agentstack add skill-kenn-w-qiuqian-skill-qiuqian-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 求签 · 六爻赛博抽签

模拟三钱摇卦六次，生成六爻卦象，完成装卦断卦，输出五维运势评分与建议。

## 环境依赖

首次部署到 Linux 需安装：

```bash
# Python 包
pip install pillow jinja2 playwright

# Chromium (Playwright 截图用)
python -m playwright install chromium

# 中文字体 (推荐 Noto CJK，避免 fallback)
# Debian/Ubuntu
sudo apt install fonts-noto-cjk
# CentOS/Rocky
sudo dnf install google-noto-cjk-fonts
# Arch
sudo pacman -S noto-fonts-cjk
```

macOS 开箱即用（系统自带 PingFang / Songti / Heiti）。

## 数据文件

| 文件 | 内容 |
|:--|:--|
| `data/hexagrams-1-64.json` | 64卦卦辞 + 386爻爻辞 (ctext.org) |
| `data/zhuang-gua-rules.json` | 八宫卦序、纳甲、六亲、六兽规则 |
| `data/index-64-full.json` | 64卦索引 (id/卦符/卦名/上下卦) |
| `engine.py` | 起卦+装卦+评分引擎 |
| `render_qian.py` | 签文图片渲染器 (PIL 方案，纯 Python) |
| `render_qian_html.py` | 签文图片渲染器 (HTML/CSS + Playwright，推荐) |
| `templates/qianwen.html` | Jinja2 模板 |
| `static/qianwen.css` | 签文样式 |

## 执行流程

### 步骤 1：运行引擎

```bash
python3 engine.py
```

引擎输出 JSON 到 stdout，包含本卦/变卦/互卦、装卦详情、动爻爻辞、五维评分、分析提示。

### 步骤 2：生成签文图片

**推荐 (HTML/CSS + Playwright)：**

```bash
python3 engine.py | python3 render_qian_html.py -o /tmp/qianwen.png
```

跨平台字体、CSS 手绘六爻、自然间距。需 `pip install jinja2 playwright && python -m playwright install chromium`。

**备选 (PIL 纯 Python，无外部依赖)：**

```bash
python3 engine.py | python3 render_qian.py -o /tmp/qianwen.png
```

### 步骤 3：解析引擎输出

从 JSON 提取以下字段用于格式化：

- `date` / `sexagenary_day` — 日期和日柱
- `ben` / `bian` / `hu` — 本卦/变卦/互卦 (含 symbol, name, id)
- `zhuang.palace` / `palace_wuxing` / `gua_type` — 宫位/五行/卦型
- `zhuang.lines[]` — 六爻详情 (pos_name, yang, moving, branch, wuxing, liuqin, shiying, liushou)
- `moving_texts[]` — 动爻爻辞 (pos, text)
- `ben_data.judgment` — 本卦卦辞
- `scores` — 五维评分 dict (dim→[score, note])
- `analysis_hints[]` — 断卦提示

### 步骤 4：格式化文本输出

先发送签文图片，然后按以下模板生成 markdown 文本。一条消息输出。**必须严格按此模板格式**。

---

## 输出模板

```
🔮 今日一卦
`{date}` `{sexagenary_day}日`

　　本卦　　　　变卦　　　　互卦
　**{ben.symbol}**　→　**{bian.symbol}**　　　**{hu.symbol}**
　**{ben.name}**　　　**{bian.name}**　　　**{hu.name}**
　`{palace}·{gua_type}`

---

**📖 卦辞**

> {ben_data.judgment}
> 
> *{一句白话解读，≤20字}*

---

**⚡ 动爻**

若无动爻（静卦），写：
> 本卦无动爻，以卦辞为断。{一句静卦解读}

若有动爻，每条格式：
> **{pos}**｜{text}
> *{一句白话解读，≤20字}*

---

**📊 装卦**

```
爻位  阴阳  地支  五行  六亲  世应  六兽
━━━━━━━━━━━━━━━━━━━━━━━━
上爻   {⚊/⚋}{⊙}  {branch}   {wx}   {liuqin}   {世/应/空}   {liushou}
五爻   ...
四爻   ...
三爻   ...
二爻   ...
初爻   ...
```
> ⊙ = 动爻　世 = 自己　应 = 对方/事体

阳爻用 `⚊`，阴爻用 `⚋`。动爻在符号后加 `⊙`。

---

**🔮 五维运势**

| | 维度 | 评分 | 简评 |
|:--|:--|:--|:--|
| {色} | 事业 | {score} | {note} |
| {色} | 财运 | {score} | {note} |
| {色} | 感情 | {score} | {note} |
| {色} | 健康 | {score} | {note} |
| {色} | 人际 | {score} | {note} |

> 🟢 吉 (≥70)　🟡 平 (50–69)　🔴 慎 (20字），适当精简。

### 卦辞白话解读

用一句话（≤20字）以日常语言解释卦辞。参考：
- 乾：自强不息，大有作为之日
- 坤：厚德载物，以柔克刚
- 随：顺势而行，跟从正道
- 賁：外饰内质，宜文宜朴
- etc.

根据卦辞原意，结合日柱和动爻，给出一句贴合当下的解读。

### 动爻白话解读

每句≤20字，点出该爻对今日的实际影响。参考引擎的 `analysis_hints`。

### 结语

综合以下要素写 2-3 句结语：
1. 卦辞总体吉凶
2. 世应关系
3. 动爻关键提示
4. 五维评分中的高点和低点
5. 给出一个关键行动建议

语气：客观、有帮助性、不制造焦虑。

### 建议

- 宜：基于高评分维度和吉祥爻辞
- 忌：基于低评分维度和凶险爻辞
- 幸运色：宫位五行 → 金=白/银, 木=绿/青, 水=黑/蓝, 火=红/紫, 土=黄/棕
- 幸运方位：宫位八卦 → 乾=西北, 坤=西南, 震=东, 巽=东南, 坎=北, 离=南, 艮=东北, 兑=西

### 长度控制

- 卦辞白话 ≤20 字
- 每条动爻白话 ≤20 字
- 五维评分简评每项 ≤18 字
- 结语 ≤80 字
- 最终总消息控制在 600 字以内（不含装卦 code block）

---

## 特殊情形

### 静卦（无动爻）
- 不展示变卦、互卦
- 以本卦卦辞为主断
- 动爻段改为 "本卦无动爻，以卦辞为断"
- 评分趋保守（加减幅度减半）

### 六爻全动
- 以变卦卦辞为主断
- 附本卦动爻爻辞供参考

### 用九/用六（乾卦六爻全阳动、坤卦六爻全阴动）
- 乾卦全动 → 引用「用九：见群龙无首，吉」
- 坤卦全动 → 引用「用六：利永贞」

### 艮宫/坤宫卦
- 艮宫属土 → 幸运色黄/棕，方位东北
- 坤宫属土 → 幸运色黄/棕，方位西南
- 注意区分艮宫≠坤宫

### 评分边界
- 评分为引擎计算值，不要手动修改
- 如果某项 score > 90，颜色仍为 🟢
- 如果某项 score < 30，颜色为 🔴，结语中委婉提醒

---

## 示例

用户输入：`/openclaw`

执行：
```bash
python3 engine.py
```

读取输出 JSON，按模板格式化。

参考文件：
- 卦辞爻辞原文：`data/hexagrams-1-64.json`
- 装卦规则：`data/zhuang-gua-rules.json`

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Kenn-W](https://github.com/Kenn-W)
- **Source:** [Kenn-W/qiuqian-skill](https://github.com/Kenn-W/qiuqian-skill)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-kenn-w-qiuqian-skill-qiuqian-skill
- Seller: https://agentstack.voostack.com/s/kenn-w
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.