ziwei-cli 1.1.0

package/README.md

@@ -0,0 +1,94 @@
+# 紫微斗数 Ziwei Skill
+
+基于传统紫微斗数命理学的命盘分析与运势预测，支持 Claude Code 和 OpenClaw。
+
+## Quick Start
+
+```bash
+npx ziwei-cli
+```
+
+这会：
+1. 检测你的 Claude Code / OpenClaw 安装
+2. 安装 skill 到正确位置
+3. 全局安装 `ziwei` CLI
+
+## 手动安装
+
+```bash
+# Clone
+git clone https://github.com/shanrichard/ziwei-skill ~/.claude/skills/ziwei
+cd ~/.claude/skills/ziwei
+
+# 安装依赖
+npm install
+
+# 全局安装 CLI
+npm link
+```
+
+## CLI 使用
+
+```bash
+# 本命层 - 查看命宫三方四正
+ziwei palace --date 1990-05-15 --time 10:30 --gender 男 --city 北京 --palace 命宫
+
+# 流年层 - 查看官禄宫流年运势
+ziwei palace --palace 官禄宫 --scope yearly --year 2025 --date 1990-05-15 --time 10:30 --gender 男 --city 北京
+
+# 流月层
+ziwei palace --palace 财帛宫 --scope monthly --year 2025 --month 6 ...
+
+# 本命合盘
+ziwei synastry origin \
+  --a-date 1990-05-15 --a-time 10:30 --a-gender 男 --a-city 北京 \
+  --b-date 1992-03-20 --b-time 14:00 --b-gender 女 --b-city 上海
+```
+
+## Skill 使用
+
+安装后重启 Claude Code / OpenClaw，然后直接说：
+
+- "帮我算命"
+- "看看我今年的运势"
+- "我和对方合适吗"
+
+## 支持的功能
+
+### 宫位查询 (`palace`)
+- 本命层 (`origin`) - 默认
+- 大限层 (`decadal`) - 需指定 `--year`
+- 流年层 (`yearly`) - 需指定 `--year`
+- 流月层 (`monthly`) - 需指定 `--year --month`
+- 流日层 (`daily`) - 需指定 `--year --month --day`
+
+### 合盘分析 (`synastry`)
+- 本命合盘 (`origin`)
+- 流年合盘 (`yearly`)
+
+## 宫位与议题对应
+
+| 议题 | 目标宫 |
+|------|--------|
+| 性格/整体运势 | 命宫 |
+| 事业/升职 | 官禄宫 |
+| 婚恋/感情 | 夫妻宫 |
+| 财运/理财 | 财帛宫 |
+| 健康 | 疾厄宫 |
+| 房产/家庭 | 田宅宫 |
+| 出行/移民 | 迁移宫 |
+| 子女/创作 | 子女宫 |
+| 朋友/同事 | 仆役宫 |
+| 兄弟/合伙 | 兄弟宫 |
+| 学业/考试 | 父母宫 |
+| 心态/福报 | 福德宫 |
+
+## 技术栈
+
+- [iztro](https://github.com/SylarLong/iztro) - 紫微斗数排盘库
+- [lunar-javascript](https://github.com/6tail/lunar-javascript) - 农历转换
+- [commander](https://github.com/tj/commander.js) - CLI 框架
+
+## License
+
+MIT

package/SKILL.md

@@ -0,0 +1,142 @@
+---
+name: ziwei
+description: 紫微斗数 + 八字命理智能算命 - 基于传统命理学的命盘分析与运势预测
+triggers:
+  - 算命
+  - 看命
+  - 命盘
+  - 运势
+  - 合盘
+  - 紫微
+  - 斗数
+  - 八字
+  - 四柱
+  - 流年
+  - 大限
+  - 黄历
+  - 十神
+  - 大运
+---
+
+# 紫微斗数 + 八字命理智能算命
+
+基于传统命理学双体系（紫微斗数 + 八字命理），提供命盘分析、运势预测、合盘匹配等服务。两套体系可独立使用，也可交叉验证。
+
+## 使用方法
+
+### 1. 收集生辰信息
+
+需要以下信息：
+- 出生日期（阳历或农历）
+- 出生时间（尽量精确到分钟）
+- 性别
+- 出生地城市
+
+### 2. 调用 ziwei CLI
+
+根据用户问题映射到对应宫位，查询三方四正：
+
+```bash
+# 本命层（默认）
+ziwei palace --date 1990-05-15 --time 14:30 --gender 男 --city 北京 --palace 命宫
+
+# 大限层
+ziwei palace --palace 官禄宫 --scope decadal --year 2025 ...
+
+# 流年层
+ziwei palace --palace 财帛宫 --scope yearly --year 2025 ...
+
+# 流月层
+ziwei palace --palace 夫妻宫 --scope monthly --year 2025 --month 6 ...
+
+# 流日层
+ziwei palace --palace 疾厄宫 --scope daily --year 2025 --month 6 --day 15 ...
+
+# 本命合盘
+ziwei synastry origin \
+  --a-date 1990-05-15 --a-time 10:30 --a-gender 男 --a-city 北京 \
+  --b-date 1992-03-20 --b-time 14:00 --b-gender 女 --b-city 上海
+
+# 流年合盘
+ziwei synastry yearly --year 2025 ...
+
+# 八字排盘
+ziwei bazi --date 1990-05-15 --time 14:30 --gender 男
+
+# 八字排盘（农历）
+ziwei bazi --date 1990-04-21 --time 14:30 --gender 男 --lunar
+
+# 黄历查询（指定日期）
+ziwei calendar --date 2026-02-12
+
+# 黄历查询（今天）
+ziwei calendar
+```
+
+### 3. 解读结果
+
+根据 CLI 返回的 JSON 数据，按照紫微斗数口径进行解读：
+
+1. **命宫定底**：先查命宫三方四正，确定总体格局基调
+2. **目标宫分析**：根据用户问题映射到相应宫位查询
+3. **动态叠加**：需要时查询运限层级，结合四化进行修正
+4. **好坏并论**：既指出优势潜力，也点出风险隐患
+5. **八字辅助**：需要时调用 `ziwei bazi` 进行交叉验证（十神、大运、五行平衡）
+
+## 参数说明
+
+### 通用参数
+- `--date`：出生日期，格式 YYYY-MM-DD
+- `--time`：出生时间，格式 HH:MM
+- `--gender`：性别，男 或 女
+- `--city`：出生城市名称
+- `--palace`：宫位名称（命宫、财帛宫、官禄宫等）
+- `--lunar`：使用农历日期（可选）
+- `--leap`：农历闰月（可选）
+
+### 层级参数（紫微斗数）
+- `--scope`：查询层级，可选值：
+  - `origin`（默认）：本命层
+  - `decadal`：大限层
+  - `yearly`：流年层
+  - `monthly`：流月层
+  - `daily`：流日层
+- `--year`：查询年份（运限层级必需）
+- `--month`：查询月份（流月/流日必需）
+- `--day`：查询日期（流日必需）
+
+### 八字参数
+- `--sect`：早晚子时配置（1=23:00后算次日，2=算当日，默认2）
+
+## 宫位与议题对应
+
+| 议题 | 目标宫 |
+|------|--------|
+| 性格/整体运势 | 命宫 |
+| 事业/升职 | 官禄宫 |
+| 婚恋/感情 | 夫妻宫 |
+| 财运/理财 | 财帛宫 |
+| 健康 | 疾厄宫 |
+| 房产/家庭 | 田宅宫 |
+| 出行/移民 | 迁移宫 |
+| 子女/创作 | 子女宫 |
+| 朋友/同事 | 仆役宫 |
+| 兄弟/合伙 | 兄弟宫 |
+| 学业/考试 | 父母宫 |
+| 心态/福报 | 福德宫 |
+
+## 八字与紫微的使用场景
+
+| 场景 | 推荐工具 | 说明 |
+|------|----------|------|
+| 整体看命/性格分析 | 紫微 + 八字 | 两套交叉验证最准 |
+| 某领域运势（事业/财运等） | 紫微为主 | 宫位体系擅长分领域分析 |
+| 五行平衡/先天禀赋 | 八字为主 | 干支五行体系更直观 |
+| 大运走势/人生阶段 | 八字为主 | 八字大运体系更清晰 |
+| 流年/流月细节 | 紫微为主 | 紫微流盘数据更丰富 |
+| 合盘/配对 | 紫微为主 | 有量化评分系统 |
+| 今日黄历/择日 | calendar | 快速查询 |
+
+## 详细口径
+
+见 [system-prompt.md](./system-prompt.md)

package/bin/install.cjs

@@ -0,0 +1,249 @@
+#!/usr/bin/env node
+
+/**
+ * Ziwei Skill Installer for Claude Code / OpenClaw
+ *
+ * npx ziwei-cli
+ */
+
+const fs = require("fs");
+const path = require("path");
+const readline = require("readline");
+const { execSync } = require("child_process");
+const os = require("os");
+
+// Colors
+const c = {
+  reset: "\x1b[0m",
+  bright: "\x1b[1m",
+  dim: "\x1b[2m",
+  red: "\x1b[31m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  blue: "\x1b[34m",
+  magenta: "\x1b[35m",
+  cyan: "\x1b[36m",
+};
+
+const color = (col, text) => `${c[col]}${text}${c.reset}`;
+
+// Paths
+const HOME = os.homedir();
+const CLAUDE_SKILLS_DIR = path.join(HOME, ".claude", "skills");
+const OPENCLAW_SKILLS_DIR = path.join(HOME, ".openclaw", "skills");
+const SKILL_NAME = "ziwei";
+const PACKAGE_ROOT = path.resolve(__dirname, "..");
+
+function log(msg) { console.log(msg); }
+function logStep(step, msg) { console.log(`\n${color("cyan", `[${step}]`)} ${msg}`); }
+function logSuccess(msg) { console.log(`${color("green", "✓")} ${msg}`); }
+function logError(msg) { console.log(`${color("red", "✗")} ${msg}`); }
+function logInfo(msg) { console.log(`${color("blue", "→")} ${msg}`); }
+function logWarn(msg) { console.log(`${color("yellow", "!")} ${msg}`); }
+
+function createPrompt() {
+  return readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+}
+
+function ask(rl, question) {
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => resolve(answer.trim()));
+  });
+}
+
+function copyDir(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    // Skip node_modules, .git, bin
+    if (["node_modules", ".git", "bin"].includes(entry.name)) continue;
+
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function printBanner() {
+  console.log(`
+${color("magenta", "┌──────────────────────────────────────────────┐")}
+${color("magenta", "│")}  ${color("bright", "紫微斗数 Ziwei Skill")} - Installer           ${color("magenta", "│")}
+${color("magenta", "└──────────────────────────────────────────────┘")}
+
+基于传统紫微斗数命理学的命盘分析与运势预测
+支持 ${color("cyan", "Claude Code")} 和 ${color("cyan", "OpenClaw")}
+`);
+}
+
+async function detectPlatform() {
+  const hasClaude = fs.existsSync(path.join(HOME, ".claude"));
+  const hasOpenClaw = fs.existsSync(path.join(HOME, ".openclaw"));
+
+  return { hasClaude, hasOpenClaw };
+}
+
+async function selectPlatform(rl, platforms) {
+  logStep("1/4", "检测安装平台...");
+
+  const options = [];
+  if (platforms.hasClaude) {
+    options.push({ key: "1", name: "Claude Code", dir: CLAUDE_SKILLS_DIR });
+    logSuccess("检测到 Claude Code");
+  }
+  if (platforms.hasOpenClaw) {
+    options.push({ key: "2", name: "OpenClaw", dir: OPENCLAW_SKILLS_DIR });
+    logSuccess("检测到 OpenClaw");
+  }
+
+  if (options.length === 0) {
+    logWarn("未检测到 Claude Code 或 OpenClaw");
+    logInfo("将创建 Claude Code skills 目录");
+    fs.mkdirSync(CLAUDE_SKILLS_DIR, { recursive: true });
+    return { name: "Claude Code", dir: CLAUDE_SKILLS_DIR };
+  }
+
+  if (options.length === 1) {
+    return options[0];
+  }
+
+  // Both platforms available
+  log("\n请选择安装平台:");
+  options.forEach((opt, i) => {
+    log(`  ${i + 1}. ${opt.name}`);
+  });
+  log(`  3. 两者都安装`);
+
+  const choice = await ask(rl, "\n选择 (1/2/3): ");
+
+  if (choice === "3") {
+    return "both";
+  }
+
+  return options[parseInt(choice) - 1] || options[0];
+}
+
+async function installSkill(targetDir, platformName) {
+  const skillDest = path.join(targetDir, SKILL_NAME);
+
+  // Check if already installed
+  if (fs.existsSync(skillDest)) {
+    logWarn(`${platformName} 已安装 ziwei skill`);
+    logInfo(`位置: ${skillDest}`);
+    return "exists";
+  }
+
+  // Create skill directory
+  fs.mkdirSync(skillDest, { recursive: true });
+
+  // Copy files
+  const filesToCopy = ["SKILL.md", "system-prompt.md"];
+  for (const file of filesToCopy) {
+    const src = path.join(PACKAGE_ROOT, file);
+    if (fs.existsSync(src)) {
+      fs.copyFileSync(src, path.join(skillDest, file));
+    }
+  }
+
+  logSuccess(`Skill 已安装到: ${skillDest}`);
+  return "installed";
+}
+
+async function installCli() {
+  logStep("3/4", "安装 ziwei CLI...");
+
+  try {
+    // Check if already installed
+    try {
+      execSync("which ziwei", { stdio: "ignore" });
+      logSuccess("ziwei CLI 已安装");
+      return true;
+    } catch {
+      // Not installed, proceed
+    }
+
+    // Try npm link from package root
+    logInfo("正在全局安装 ziwei CLI...");
+    execSync("npm link", { cwd: PACKAGE_ROOT, stdio: "inherit" });
+    logSuccess("ziwei CLI 安装成功");
+
+    // Verify
+    const version = execSync("ziwei --version", { encoding: "utf8" }).trim();
+    logInfo(`版本: ${version}`);
+
+    return true;
+  } catch (error) {
+    logError(`CLI 安装失败: ${error.message}`);
+    logInfo("你可以手动运行: cd " + PACKAGE_ROOT + " && npm link");
+    return false;
+  }
+}
+
+function printSummary(platforms) {
+  logStep("4/4", "安装完成!");
+
+  console.log(`
+${color("green", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")}
+${color("bright", "  紫微斗数 Skill 已就绪!")}
+${color("green", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")}
+
+${color("cyan", "CLI 命令:")}
+  ziwei palace --palace 命宫 --date 1990-05-15 --time 10:30 --gender 男 --city 北京
+  ziwei palace --palace 官禄宫 --scope yearly --year 2025 ...
+
+${color("cyan", "Skill 触发词:")}
+  算命、看命、命盘、运势、合盘、紫微、流年、大限
+
+${color("yellow", "在 Claude Code / OpenClaw 中试试:")}
+  "帮我算命"
+  "看看我今年的运势"
+  "我和对方合适吗"
+
+${color("dim", "重启 Claude Code 会话后 skill 将自动加载")}
+`);
+}
+
+async function main() {
+  const rl = createPrompt();
+
+  try {
+    printBanner();
+
+    // Step 1: Detect platforms
+    const platforms = await detectPlatform();
+    const selected = await selectPlatform(rl, platforms);
+
+    // Step 2: Install skill files
+    logStep("2/4", "安装 Skill 文件...");
+
+    if (selected === "both") {
+      await installSkill(CLAUDE_SKILLS_DIR, "Claude Code");
+      await installSkill(OPENCLAW_SKILLS_DIR, "OpenClaw");
+    } else {
+      await installSkill(selected.dir, selected.name);
+    }
+
+    // Step 3: Install CLI
+    await installCli();
+
+    // Step 4: Summary
+    printSummary(platforms);
+
+    rl.close();
+  } catch (error) {
+    logError(`安装失败: ${error.message}`);
+    console.error(error);
+    rl.close();
+    process.exit(1);
+  }
+}
+
+main();

package/bin/ziwei.js

@@ -0,0 +1,151 @@
+#!/usr/bin/env node
+
+/**
+ * 紫微斗数 CLI 入口
+ */
+
+import { Command } from 'commander';
+import { executePalace } from '../lib/commands/palace.js';
+import { executeSynastry, executeSynastryYearly } from '../lib/commands/synastry.js';
+import { executeBazi, executeCalendar } from '../lib/commands/bazi.js';
+
+const program = new Command();
+
+program
+  .name('ziwei')
+  .description('紫微斗数命理分析工具')
+  .version('1.0.0');
+
+// 宫位查询命令
+program
+  .command('palace')
+  .description('查询指定宫位的三方四正（支持本命/大限/流年/流月/流日）')
+  .requiredOption('--date <date>', '出生日期 (YYYY-MM-DD)')
+  .requiredOption('--time <time>', '出生时间 (HH:MM)')
+  .requiredOption('--gender <gender>', '性别 (男/女)')
+  .requiredOption('--city <city>', '出生城市')
+  .requiredOption('--palace <palace>', '宫位名称')
+  .option('--scope <scope>', '查询层级 (origin/decadal/yearly/monthly/daily)', 'origin')
+  .option('--year <year>', '查询年份（运限层级必需）')
+  .option('--month <month>', '查询月份（流月/流日必需）')
+  .option('--day <day>', '查询日期（流日必需）')
+  .option('--lunar', '农历日期', false)
+  .option('--leap', '闰月', false)
+  .action(async (options) => {
+    const result = await executePalace({
+      ...options,
+      year: options.year ? parseInt(options.year) : undefined,
+      month: options.month ? parseInt(options.month) : undefined,
+      day: options.day ? parseInt(options.day) : undefined
+    });
+    console.log(JSON.stringify(result, null, 2));
+  });
+
+// 合盘分析命令
+const synastry = program
+  .command('synastry')
+  .description('合盘分析');
+
+// 本命合盘
+synastry
+  .command('origin')
+  .description('本命合盘分析')
+  .requiredOption('--a-date <date>', 'A方出生日期 (YYYY-MM-DD)')
+  .requiredOption('--a-time <time>', 'A方出生时间 (HH:MM)')
+  .requiredOption('--a-gender <gender>', 'A方性别 (男/女)')
+  .requiredOption('--a-city <city>', 'A方出生城市')
+  .option('--a-name <name>', 'A方姓名', 'A')
+  .option('--a-lunar', 'A方农历日期', false)
+  .option('--a-leap', 'A方闰月', false)
+  .requiredOption('--b-date <date>', 'B方出生日期 (YYYY-MM-DD)')
+  .requiredOption('--b-time <time>', 'B方出生时间 (HH:MM)')
+  .requiredOption('--b-gender <gender>', 'B方性别 (男/女)')
+  .requiredOption('--b-city <city>', 'B方出生城市')
+  .option('--b-name <name>', 'B方姓名', 'B')
+  .option('--b-lunar', 'B方农历日期', false)
+  .option('--b-leap', 'B方闰月', false)
+  .action(async (options) => {
+    const result = await executeSynastry({
+      aDate: options.aDate,
+      aTime: options.aTime,
+      aGender: options.aGender,
+      aCity: options.aCity,
+      aName: options.aName,
+      aLunar: options.aLunar,
+      aLeap: options.aLeap,
+      bDate: options.bDate,
+      bTime: options.bTime,
+      bGender: options.bGender,
+      bCity: options.bCity,
+      bName: options.bName,
+      bLunar: options.bLunar,
+      bLeap: options.bLeap
+    });
+    console.log(JSON.stringify(result, null, 2));
+  });
+
+// 流年合盘
+synastry
+  .command('yearly')
+  .description('流年合盘分析')
+  .requiredOption('--a-date <date>', 'A方出生日期 (YYYY-MM-DD)')
+  .requiredOption('--a-time <time>', 'A方出生时间 (HH:MM)')
+  .requiredOption('--a-gender <gender>', 'A方性别 (男/女)')
+  .requiredOption('--a-city <city>', 'A方出生城市')
+  .option('--a-name <name>', 'A方姓名', 'A')
+  .option('--a-lunar', 'A方农历日期', false)
+  .option('--a-leap', 'A方闰月', false)
+  .requiredOption('--b-date <date>', 'B方出生日期 (YYYY-MM-DD)')
+  .requiredOption('--b-time <time>', 'B方出生时间 (HH:MM)')
+  .requiredOption('--b-gender <gender>', 'B方性别 (男/女)')
+  .requiredOption('--b-city <city>', 'B方出生城市')
+  .option('--b-name <name>', 'B方姓名', 'B')
+  .option('--b-lunar', 'B方农历日期', false)
+  .option('--b-leap', 'B方闰月', false)
+  .requiredOption('--year <year>', '查询年份')
+  .action(async (options) => {
+    const result = await executeSynastryYearly({
+      aDate: options.aDate,
+      aTime: options.aTime,
+      aGender: options.aGender,
+      aCity: options.aCity,
+      aName: options.aName,
+      aLunar: options.aLunar,
+      aLeap: options.aLeap,
+      bDate: options.bDate,
+      bTime: options.bTime,
+      bGender: options.bGender,
+      bCity: options.bCity,
+      bName: options.bName,
+      bLunar: options.bLunar,
+      bLeap: options.bLeap,
+      year: parseInt(options.year)
+    });
+    console.log(JSON.stringify(result, null, 2));
+  });
+
+// 八字排盘命令
+program
+  .command('bazi')
+  .description('八字排盘（四柱、十神、大运、神煞、刑冲合会）')
+  .requiredOption('--date <date>', '出生日期 (YYYY-MM-DD)')
+  .requiredOption('--time <time>', '出生时间 (HH:MM)')
+  .requiredOption('--gender <gender>', '性别 (男/女)')
+  .option('--lunar', '农历日期', false)
+  .option('--sect <sect>', '早晚子时 (1=次日/2=当日)', '2')
+  .action(async (options) => {
+    const result = await executeBazi(options);
+    console.log(JSON.stringify(result, null, 2));
+  });
+
+// 黄历查询命令
+program
+  .command('calendar')
+  .description('黄历查询（农历、干支、节气、生肖）')
+  .option('--date <date>', '阳历日期 (YYYY-MM-DD)，不传则为当天')
+  .action(async (options) => {
+    const result = await executeCalendar(options);
+    console.log(JSON.stringify(result, null, 2));
+  });
+
+program.parse();

package/lib/commands/bazi.js

@@ -0,0 +1,35 @@
+/**
+ * 八字排盘命令处理
+ */
+
+import { generateBazi, getCalendar } from '../engine/bazi.js';
+
+/**
+ * 执行八字排盘
+ */
+export async function executeBazi(options) {
+  try {
+    const result = generateBazi({
+      date: options.date,
+      time: options.time,
+      gender: options.gender,
+      lunar: options.lunar || false,
+      sect: options.sect ? parseInt(options.sect) : 2,
+    });
+    return { success: true, data: result };
+  } catch (error) {
+    return { success: false, error: error.message };
+  }
+}
+
+/**
+ * 执行黄历查询
+ */
+export async function executeCalendar(options) {
+  try {
+    const result = getCalendar(options.date);
+    return { success: true, data: result };
+  } catch (error) {
+    return { success: false, error: error.message };
+  }
+}