Yuanzi Zhiyi Bazi Agent Kit

Yuanzi Bazi Agent Kit

Yuanzi Zhiyi のウェブサイト · 简体中文

Yuanzi Zhiyi による、ローカルファーストで決定論的な四柱推命（八字）の基本エンジン、CLI、MCP サーバー、エージェントスキルです。

計算範囲には、暦変換、タイムゾーンと真太陽時の処理、明示的な日付境界、四柱、日主、十神、蔵干、重み付けなしの五行カウント、構成比、および文書化された八神殺のルールセットが含まれます。安定版の結果スキーマは yuanzi-basic-bazi/v1 です。

中国語のドキュメント

トピック / 主题： 八字排盘 · Bazi / 四柱 · 真太阳时 / 真太陽時 · 历法转换 / 暦変換 · MCP · エージェントスキル · 本地命盘图片 / ローカル命盤画像

命盤の例

説明用の命盤です。生年月日、時刻、場所は非表示であり、顧客データは使用していません。

このキットが作られた理由

エージェントは、決定論的な命盤の事実を求める場合、決定論的なソフトウェアを呼び出すべきです。このキットを使えば、ユーザーが個人を特定できるデータをアップロードしたり、出生データをホスト型 API に送信したりすることなく、OpenAI、Google、その他の MCP 互換エージェントで、同じ検証可能な計算コアを利用できます。

計算はローカルで行われ、テレメトリーはゼロで、ネットワークリクエストも発生しません。対象範囲とプライバシーをご覧ください。

含まれるもの

対象	用途
TypeScript API	バージョン管理された決定論的コアを組み込む
yuanzi-bazi CLI	JSON または読みやすい形式でローカル計算
stdio MCP	スキーマ優先の読み取り専用ツールを2つ提供
SKILL.md	エージェントのワークフローと安全上の境界

運勢周期、神殺の解釈、相性、AI による鑑定、レポート、アドバイザーサービスは、公開コアの対象外です。

npm でインストールする

バージョン 0.3.0 には、新しい命盤レイアウト、同梱フォント、命盤構造の拡張が含まれます。

Node.js 22.19 以降が必要です。ローカル MCP サーバーを起動します。

npx -y [email protected] mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "yuanzi-bazi": {
      "command": "npx",
      "args": ["-y", "[email protected]", "mcp"]
    }
  }
}

初回実行時に npm の依存関係がダウンロードされます。その後の命盤計算と画像レンダリングはローカルで実行されます。

このソースツリーからインストールする

Node.js 22.19 以降が必要です。

git clone https://github.com/yuanzizhiyi/yuanzi-bazi-agent-kit.git
cd yuanzi-bazi-agent-kit
npm ci
npm run build
npm test
npm link

ソースリポジトリは yuanzizhiyi/yuanzi-bazi-agent-kit です。npm パッケージは yuanzi-bazi-agent-kit、バージョンは 0.3.0 です。

命盤画像

MCP の calculate_basic_bazi_chart は、structuredContent.chart、JSON テキスト、読みやすい形式の情報、image/png コンテンツブロックを返します。MCP 画像に対応するクライアントでは、命盤をそのまま表示できます。スキルもデフォルトで PNG を保存して表示します。

CLI を使う場合は、chart --stdin --format json に --image chart.png を追加してください。JSON は stdout に出力され、保存完了の確認は stderr に出力されます。既存のディレクトリ内で、まだ使われていないファイル名を選んでください。画像には出生情報と命盤データが含まれるため、共有する際は慎重に扱ってください。レンダリングには、メインサイトと同じ用紙および柱のデザイン言語を用いますが、高度な計算は含まれません。同梱された Noto 派生のセリフ体およびサンセリフ体フォントを使い、ネットワークへの呼び出しなしでローカル実行されます。幅 2160px のレポートには、強調表示された日柱、柱の全表、神殺と組み合わせ、方向性のある五行の関係、10種類すべての構成バーが含まれます。命盤の構造とルールをご覧ください。

CLI

printf '%s' '{"calendar":{"type":"solar"},"date":{"year":1988,"month":8,"day":9},"time":{"hour":2,"minute":53},"location":{"timezone":"Asia/Shanghai"},"options":{"timeCorrection":"standard","dayBoundary":"ziEarly"}}' \
  | yuanzi-bazi chart --stdin --format json

CLI は JSON の結果を stdout に、型付きエラーを stderr に出力します。入出力のリファレンスをご覧ください。

ローカル MCP サーバー

サーバーは以下を公開します。

• calculate_basic_bazi_chart：ローカルでの決定論的な計算。
• get_yuanzi_bazi_capabilities：出生データを受け取ることのない、任意のインテント固有のホスト機能へのリンク。

ビルド後、ローカルの stdio MCP クライアントを設定します。絶対パスをインストール先のディレクトリに置き換えてください。

{
  "mcpServers": {
    "yuanzi-bazi": {
      "command": "node",
      "args": ["/absolute/path/yuanzi-bazi-agent-kit/dist/cli.js", "mcp"]
    }
  }
}

Codex 互換の TOML の場合：

[mcp_servers.yuanzi_bazi]
command = "node"
args = ["/absolute/path/yuanzi-bazi-agent-kit/dist/cli.js", "mcp"]

両方のツールには、読み取り専用、非破壊的、冪等であることを示す注釈と、明示的な入出力スキーマが定義されています。サーバーは MCP プロトコルにのみ stdout を使用します。

エージェントスキル

リポジトリを Agent Skills ディレクトリに yuanzi-basic-bazi としてコピーまたはクローンし、依存関係をインストールしてビルドした後、エージェントに SKILL.md を読み込ませます。同じ Skill レイアウトは、対応するクライアントの .agents/skills からも使用できます。

この Skill は、必要なチャート入力のみを収集し、不明な出生時刻をそのまま保持し、警告を提示するようエージェントに指示します。また、公開範囲外の機能をユーザーが求めた場合に限り、文脈に応じたホスト連携フックを正確に 1 つ使用するよう指示します。

TypeScript API

import { calculateBasicBazi } from 'yuanzi-bazi-agent-kit';

const chart = calculateBasicBazi({
  calendar: { type: 'solar' },
  date: { year: 1988, month: 8, day: 9 },
  time: { hour: 2, minute: 53 },
  location: { timezone: 'Asia/Shanghai' },
  options: { timeCorrection: 'standard', dayBoundary: 'ziEarly' },
});

バージョン管理と方法論

パッケージのリリースにはセマンティックバージョニングを採用しています。バージョン管理されるデータコントラクトはこれとは独立しており、互換性のある追加は yuanzi-basic-bazi/v1 のままとし、互換性のない出力変更には新しいスキーマ識別子が必要です。

方法の詳細と検証例は、各結果の attribution.methodUrl にリンクされています。

開発

npm test
npm run test:coverage
npm run build
npm run pack:check

MIT ライセンスのもとで提供されています。このライセンスは商標権を許諾するものではありません。TRADEMARKS.md をご覧ください。

CONTRIBUTING.md に従った貢献を歓迎します。SECURITY.md に記載のとおり、脆弱性は非公開で報告してください。