四柱推命鑑定書
ツール一覧

OPEN SOURCE · CLI + AGENT SKILL

AI が命式を読むとき、用神を推測させない。

個人命書の AI エージェント向けクライアントと Skill を MIT ライセンスでオープンソース公開しています。コードは GitHub にあります。クライアントは mymingshu.com のサーバーで動く計算エンジンを呼び出し、1回の呼び出しで命式の事実とエンジンの判断が返ります。四柱・蔵干・通変星だけでなく、格局、身旺身弱の根拠、用神と喜神忌神、調候、財庫、貴人、特殊星(神殺)、事業宮まで含まれます。判断はエンジンが、説明はお使いの AI が担当します。

コマンド1つでインストール
npm install -g github:PanYX/mingshu-bazi
  • MIT ライセンス
  • Node.js 20+
  • Codex と Claude Code に対応

01 / インストール

AI に任せる、自分で入れる、まずオンラインで試す。

CLI は GitHub から直接インストールするため、npm アカウントは不要です。インストール後に mingshu setup を実行すると、お使いの AI アシスタントに計算エンジンが接続されます。

AI にインストールさせる

ローカルコマンドを実行できる Codex や Claude Code などのアシスタントに、下のメッセージをそのまま送ってください。インストールと接続確認まで済ませます。

個人命書をインストールしてください:https://github.com/PanYX/mingshu-bazi
プロジェクトの docs/agent-install.md を読み、インストールと接続確認まで完了させてください。

自分でインストールする

Node.js 20 以降と Git が必要です。コマンドは2つで、2つ目で Codex か Claude Code を選びます。

npm install -g github:PanYX/mingshu-bazi
mingshu setup

ここでの npm はインストーラーです。github:PanYX/mingshu-bazi のアドレスはそのまま使ってください。npm に未公開の mingshu-cli というパッケージ名には置き換えないでください。

まずオンラインで試す

インストールしなくても使えます。公式サイトで命式を作成し、同じエンジンが返す内容を確認してください。

サイトで命式を作成

オンラインでの利用にインストールは不要で、ローカルのファイルを送信したり保存したりすることもありません。

02 / 違い

四柱を出せるところまでは同じ。
判断を誰がするかで分かれます。

多くのオープンソースの四柱推命 Skill は、四柱と通変星だけを返します。では用神は何かと聞かれると、アシスタントが自分で作るしかありません。個人命書は判断をエンジンに任せ、AI はそれを説明します。

返る内容四柱だけのオープンソース個人命書 CLI
四柱 · 蔵干 · 通変星ありあり(五行の比重つき)
身旺・身弱根拠なし得令・得地・得勢を1つずつ提示
用神 · 喜神 · 忌神アシスタントがその場で判断エンジンが結果を返す
調候通常なし調候の天干と評価
財星 · 財庫 · 担財通常なし開庫の条件と担財力
事業宮 · 貴人 · 特殊星通常なし位置と根拠を提示
時刻の基準記載なし真太陽時か時計時間かを明記し、曖昧な場合はエラー
言語通常は中国語のみ5言語。事実と要約は変わらない

差がつくのは四柱の計算精度ではありません。用神と喜神忌神、身旺身弱の根拠を誰が決めるかです。エンジンが結論と根拠を返し、AI がそれを説明する。どちらかがもう一方の役を演じることはありません。

03 / 実際の出力

1回の呼び出しで、そのまま説明できる命式が返ります。

以下は架空の例に対する実際の戻り値で、加工していません。用神・喜神・忌神と身旺身弱の根拠が含まれているため、アシスタントが推測する必要はありません。

mingshu chart
辛(かのと) · 従強格 · 従強
用神: 金    喜神: 土    忌神: 火
調候: 丙(ひのえ) · 壬(みずのえ) · 戊(つちのえ) (非常に良好)
五行: 木 4%   火 10%   土 43%   金 38%   水 5%
通変星: 比劫 38%   印星 43%   食傷 5%   財星 4%   官殺 10%
年柱  辛未  比肩
月柱  辛丑  比肩
日柱  辛巳  日干
時柱  己亥  偏印
大運: 甲辰 2021-2030 · 乙巳 2031-2040 · 丙午 2041-2050 · 丁未 2051-2060

引数なしの場合、ターミナルには読める形の要約が表示されます。

mingshu chart --json
{
  "judgments": {
    "pattern": "従強格",
    "strength": {
      "label": "従強",
      "deLing": {
        "ok": true,
        "text": "月令の丑土は日干を生じて支えます。"
      }
    },
    "useful": [
      "金"
    ],
    "favorable": [
      "土"
    ],
    "unfavorable": [
      "火"
    ]
  },
  "chartDigest": "e733dfec6fbb98c2f17b4dd946ad19aa1f6bd76476b7cda226f12431a1eb0226"
}

--json を付けると、判断とその根拠、フィールド名がそのまま返り、アシスタントが引用できます。同じ命式を5言語で取得しても、要約は完全に一致します。

04 / 実際に確認する

同じ命式、5言語、要約は完全に一致。

これは実際の呼び出しです。言語を切り替えて実行しても、事実・列挙値・要約は変わらず、言葉だけが言語に合わせて変わります。

05 / コマンド

コマンドは少なめ、アシスタントにも読めます。

すべてのコマンドが --json に対応しています。失敗時は終了コード1で、code と message を含むエラーを返します。

  • mingshu setupお使いの AI アシスタントに Skill をインストールし、接続を確認する
  • mingshu version --jsonCLI と Node.js のバージョンを表示する
  • mingshu capabilities --json機能、入力契約、制限を一覧表示する
  • mingshu doctor --json出生情報を送らずにサービスの接続を確認する
  • mingshu example --json架空のサンプル出生データを表示する
  • mingshu validate --input birth.json --jsonネットワークを使わず、ローカルで入力を検証する
  • mingshu locations --query "Shanghai" --locale en --json都市レベルの地点 ID を検索する
  • mingshu chart --input birth.json --json命式を作成し、事実とエンジンの判断を返す
  • mingshu skills同梱の Skill 全文を出力する
  • mingshu website --locale enブラウザーを開かずに公式サイトのリンクを出力する

接続先は既定で https://mymingshu.com です。--origin または MINGSHU_API_ORIGIN で変更できます。別のアドレスを指定すると、出生情報はそのサーバーへ送信されます。

06 / 境界

オープンソースの範囲と、サーバー側の範囲。

オープンソースの部分

クライアント、API 契約、Skill、ドキュメントは公開リポジトリにあり、MIT ライセンスで自由に利用・改変・再配布できます。

サーバー側

計算エンジン、アカウント、有料レポートは公式サイトのサーバーで動いており、公開リポジトリには含まれません。CLI は公開 API を呼び出すため、自分でサーバーを立てる必要はありません。

出生情報

命式の作成では、入力した内容が指定した接続先にだけ送信されます。データベースへの保存も、プロフィールの作成もありません。公式サイトへのリンクには出所パラメーターだけが付き、出生情報は含まれません。クライアントは課金もモデル呼び出しも行いません。

鑑定の境界

格局、身旺身弱、用神、喜神、忌神、調候はいずれも固定のテーブルから算出される本エンジンの判断で、他の流派と結論が異なる場合があります。五行と通変星の割合はエンジンの比重であり、確率ではありません。鑑定は伝統文化の範囲にとどまり、医療・法律・投資の助言ではありません。

FAQ

この CLI についてよくある質問。

01この CLI は何ですか。費用はかかりますか。

公式サイトの計算エンジンを呼び出すオープンソースのコマンドラインクライアントで、MIT ライセンスのもと無料で利用・再配布できます。命式の作成と判断の返却だけを行い、AI による長文鑑定の生成も課金もありません。

02他のオープンソースの四柱推命ツールと何が違いますか。

多くのオープンソースは四柱と通変星しか返さず、用神と喜神忌神はアシスタントが判断します。ここでは固定のテーブルが格局、身旺身弱の根拠、用神と喜神忌神、調候を返し、アシスタントは説明だけを担当します。

03インストールには何が必要ですか。

Node.js 20 以降と Git が必要です。インストールコマンドは GitHub から直接取得するため npm アカウントは不要で、ローカルコマンドを実行できる AI アシスタントに任せることもできます。

04命式の作成で出生情報は保存されますか。

保存されません。入力内容は指定した接続先にだけ送信され、API はデータベースに書き込まず、プロフィールも作成しません。公式サイトへのリンクには出所パラメーターだけが付き、生年月日や時刻、場所は含まれません。

05結果を確定した予測として受け取れますか。

いいえ。格局、身旺身弱、用神は本エンジンの固定テーブルによるもので、他の流派では結論が異なる場合があります。伝統文化の視点の一つとして参考にし、重要な判断では現実の情報も合わせて確認してください。

07 / ドキュメント

まずコードを読みたい方へ。

公開リポジトリに、接続、API、デモの説明があります。

コマンド1つで、計算エンジンをお使いの AI に。

インストール後、アシスタントに「個人命書で命式を作成して」と伝えてください。出生情報を確認し、CLI を呼び出して、結果を説明します。

npm install -g github:PanYX/mingshu-bazi

クライアントは GitHub から直接配布しています。npm アカウントは不要で、ローカルのファイルを読み取ることもありません。