周易占卜 - ZhouYi Divin

基于《周易》的完整占卜系统，支持铜钱起卦 + 八字排盘 + 综合解读

Security Scan

The package is internally consistent with a local, pure‑Python Zhouyi divination tool (no credentials, no installs); one minor inconsistencies and a prompt‑injection style scanner hit warrant caution before use.

Purpose & Capability

Name/description (周易占卜) match the included code: scripts/divine.py and scripts/bazi.py implement coin-casting, hexagram lookup, Bazi calculation and combined output. The skill requests no env vars or external binaries. Minor inconsistency: INSTALL.md references start.bat and gua.bat launchers that are mentioned but not present in the file manifest — nothing dangerous but slightly sloppy packaging.

Instruction Scope

SKILL.md instructs the agent/user to run the local Python scripts and explicitly claims 'pure local run, no external API calls, no sensitive file reads/writes'. The visible code (bazi.py and the shown part of divine.py) uses only stdlib modules and local data structures. There is a scanner finding of unicode control characters in SKILL.md (possible prompt-injection attempt) — SKILL.md itself is the interaction contract for the agent, so hidden characters are worth reviewing. Also verify the rest of divine.py (file truncated in the provided snippet) to confirm there are no hidden network calls or unexpected file operations.

Install Mechanism

No install spec; this is an instruction-only skill with included Python files. That is low risk — nothing is being downloaded or executed by an installer during installation.

Credentials

The skill declares no required environment variables, no credentials, and no special config paths. The code uses local time and command-line parameters only, which is proportionate for a divination/CLI utility.

Persistence & Privilege

Flags show always:false and normal autonomous invocation allowed. The package does not request permanent presence or system-wide configuration changes. The included .workbuddy/memory/MEMORY.md is a local project note and not an external credential store.

Scan Findings in Context

[unicode-control-chars] unexpected: The SKILL.md was flagged for unicode control characters. A local divination instruction file has no need for invisible control characters; these can be used to manipulate prompt parsing or to conceal injected instructions. Review SKILL.md for hidden characters and sanitize before trusting automatic ingestion.

Assessment

This skill appears to do what it says: a local Python-based Zhouyi divination tool with no external dependencies or credential requests. Before installing or running it, do the following: 1) Open SKILL.md and the two Python files in a text editor that can show invisible characters (to inspect the unicode-control-chars the scanner flagged) and search for suspicious strings like 'http', 'socket', 'requests', 'urllib', 'subprocess', 'os.system', or any unexpected file paths. 2) Inspect the remainder of scripts/divine.py (the provided snippet was truncated) to ensure there are no network calls or unexpected file writes. 3) Run the scripts in a network-isolated sandbox (or with networking disabled) the first time to verify behavior and outputs. 4) Note the minor packaging sloppiness (INSTALL.md mentions start.bat/gua.bat that are not in the manifest) — benign but a sign to inspect the package thoroughly. If you are not comfortable doing these checks, run it only on an offline/test machine.

🔮 周易占卜 - ZhouYi Divination

基于《周易》的完整占卜系统，支持铜钱法起卦、八字排盘、五行分析、大运推演，以及卦象与命理的综合解读。

纯 Python 实现，无外部依赖，安全本地运行。

---

📖 核心功能

模块	功能说明
① 铜钱起卦	传统三枚铜钱摇卦法，模拟古代占卜仪式
② 64 卦查询	完整卦名、卦辞、大象、爻辞数据库
③ 本卦/变卦	自动识别动爻（老阴×、老阳○）并生成变卦
④ 八字排盘	四柱（年月日时）干支自动计算
⑤ 五行分析	五行分布统计、日主强弱判断
⑥ 用神推断	根据身强身弱推荐用神
⑦ 大运推演	每十年一大运，推算当前大运
⑧ 综合解读	八字背景 + 卦象 + 问题关键词的智能分析

---

🎯 快速开始

方式一：纯起卦（最简单）

python scripts/divine.py --question "我今年的事业运势如何？"

输出包含：

• 六爻起卦过程
• 本卦 + 变卦信息
• 卦辞解读
• Oracle 寄语

---

方式二：八字 + 起卦综合解读（推荐）

python scripts/divine.py ^
  --question "今年适合创业吗？" ^
  --birth-year 1990 ^
  --birth-month 5 ^
  --birth-day 15 ^
  --birth-hour 14 ^
  --gender 男

输出包含：

• ✅ 完整八字排盘
• ✅ 五行分布图
• ✅ 日主强弱分析
• ✅ 用神建议
• ✅ 当前大运
• ✅ 卦象 + 八字综合解读

---

方式三：只排八字（不占卦）

python scripts/divine.py --mode bazi ^
  --birth-year 1990 ^
  --birth-month 5 ^
  --birth-day 15 ^
  --birth-hour 14

---

方式四：JSON 格式输出

python scripts/divine.py --question "问题" --json

适合编程调用或保存结果。

---

方式五：交互模式

python scripts/divine.py

按屏幕提示选择模式，逐步操作。

---

📋 参数说明

参数	简称	说明	必填
--question	-q	你想问的问题	否
--birth-year	-	出生年份	可选
--birth-month	-	出生月份 (1-12)	可选
--birth-day	-	出生日期 (1-31)	可选
--birth-hour	-	出生时辰 (0-23)	可选
--gender	-	性别 (男/女)	可选，默认"男"
--mode	-	模式 (hexagram/bazi/both)	可选，默认"both"
--json	-	JSON 格式输出	可选

---

📊 输出示例

纯起卦输出

==================================================
📜 八字排盘报告
==================================================

👶 出生信息：1990 年 5 月 15 日 14:00

🔮 四柱八字:
   年柱：庚午
   月柱：丙午
   日柱：丁酉 ← 日主
   时柱：丁未

⚖️  五行分布:
   金：██ (2)
   木：  (0)
   水：  (0)
   火：█████ (5)
   土：█ (1)

💎 日主分析:
   日元：丁 (火)
   强弱指数：5/8
   状态：🟢 身强
   建议用神：土，金，水

...

═══════════════ 🎯 本卦信息 ═══════════════
   卦名：山地剥 (第 23 卦)
   卦象：上艮下坤
   卦辞：不利有攸往

...

💭 Oracle 寄语:
您的八字显示'丁'日主身强，精力充沛。当前山地剥提醒您 '不利有攸往'。
建议发挥优势但注意收敛锋芒，配合流年运势把握机遇。

---

📚 哲学参考

本工具参考以下经典：

• 《周易·系辞传》
• 《周易正义》（孔颖达）
• 《朱子本义》
• 《三命通会》
• 《渊海子平》

---

⚠️ 安全说明

• ✅ 纯本地运行：无任何外部 API 调用
• ✅ 开源代码：所有逻辑透明可见
• ✅ 无敏感权限：不访问网络、不读写敏感文件
• ✅ 数据保密：所有个人信息仅在内存中处理

---

💡 温馨提示

《周易》的核心是"观其德义"，不是单纯的算命。

"善为易者不占" — 真正懂易经的人，重视的是其中的人生智慧，而不是依赖占卜结果。

本工具仅供学习和娱乐，最终决策请结合自身实际情况～ 💕

---

🛠️ 技术栈

项目	内容
语言	Python 3.8+
依赖	无第三方库
平台	Windows / Linux / macOS
编码	UTF-8

---

Created by 小艺 · 公司办公室行政 AI 🌸