hdsljp-api：日文人類圖命盤計算 API

讀取 Markdown 原文 · 下載 Agent SKILL.md

把出生日期、時間、地點與時區送入 API，取得日文人類圖命盤的計算欄位。

工坊收錄說明

定位與社群

想替人類圖網站接上計算服務的人、能準備 Python 與星曆資料的開發者。

一份虛構出生資料的 API 對照表：四個輸入、回傳命盤欄位、星曆準備情況及尚未核對的準確度。

可和夥伴一起讀請求／回覆範例，先分清「能串接」和「計算已核對」，再回原作補欄位文件。

先對照 README 的請求與回覆範例，列出日期、時間、地點和 tz 四個輸入，確認自己需要哪些命盤欄位。

封面與來源署名

作者：ken-kk

封面插畫：/art/skills/hdsljp-api.webp

原作者 GitHub：https://github.com/kieiken/hdsljp-api

登入自由工坊並連結自己的 GitHub，即可在技能書加星或取消星星。

原作數據：/api/v1/github/books/hdsljp-api/metrics

Stars、Forks、追蹤數、未結 Issues 與 PR 合計、最近程式更新時間以 GitHub 回覆為準；數據附核對時間，讀取失敗不冒充零。

讀者與格式

Python／Flask 命盤計算 API

• 想替人類圖網站接上計算服務的人
• 能準備 Python 與星曆資料的開發者

功能與使用範圍

這是計算 API，需自行架設，沒有現成命盤網站。AGPL-3.0；本書只描述並連結，不複製程式碼。網路提供服務及修改版的對應原始碼義務須依 LICENSE 核對；Swiss Ephemeris 另有 AGPL／專業授權雙軌。必要的 .se1 星曆資料不附在 repo。需 Python 3.10 以上，原作建議 Linux。出生資料需本人同意；命盤不作健康或任職能力判定。工坊未執行 API，也未驗證計算準確度。

• GET /health 檢查服務狀態，POST /calculate 接收 birth_date、birth_time、birth_place、tz。
• 以 X-API-Key 驗證計算請求，回傳 type、authority、profile、definition 等欄位。
• 回傳 personality／design 的閘門與線位，以及 defined_centers、defined_channels。

開始前準備

• Python 3.10 以上、requirements.txt 所列依賴；Linux 為原作建議環境。
• 另備 seas_18.se1、semo_18.se1、sepl_18.se1，並在 app.py 調整 EPHE_PATH。
• 一組虛構出生資料與自己的 API_KEY；先確認 LICENSE 及星曆授權。

第一個練習

1. 先對照 README 的請求與回覆範例，列出日期、時間、地點和 tz 四個輸入，確認自己需要哪些命盤欄位。

2. 在隔離環境準備 requirements.txt、三個星曆檔與 EPHE_PATH；依 README 啟動 app.py 後，先查看 GET /health。

3. 向 POST /calculate 送入虛構出生資料與 X-API-Key，保存欄位名稱、時區與錯誤紀錄；不要把收到回覆當成準確度已驗證。

練習成果

一份虛構出生資料的 API 對照表：四個輸入、回傳命盤欄位、星曆準備情況及尚未核對的準確度。

專案與授權

原作 Repo：https://github.com/kieiken/hdsljp-api

從原作建立自己的版本：https://github.com/kieiken/hdsljp-api/fork

工坊整合參考：https://github.com/kieiken/hdsljp-api

記錄的授權：AGPL-3.0

一起改這本技能書

在原作 Issues 提供合成時區案例、日文／繁中欄位說明或安裝重現。不要貼真實出生資料或 API_KEY；保留 ken-kk 的分享來源、AGPL 與星曆授權要求。

原作 Repo：https://github.com/kieiken/hdsljp-api

預設 PR 目標：kieiken/hdsljp-api:main

從原作建立自己的版本：https://github.com/kieiken/hdsljp-api/fork

原作 PR：https://github.com/kieiken/hdsljp-api/pulls

工坊整合參考：https://github.com/kieiken/hdsljp-api

工坊整合任務專用 Fork：https://github.com/kieiken/hdsljp-api/fork

工坊任務：https://github.com/kieiken/hdsljp-api/issues

工坊 PR：https://github.com/kieiken/hdsljp-api/pulls

GitHub Milestones：https://github.com/kieiken/hdsljp-api/milestones

先閱讀原作現行的貢獻規則。Fork 不會自動回饋原作；修改要以 PR 提交，由原作維護者決定是否合併。工坊整合任務可在工坊審查，另外記錄回饋原作的 PR 或未回送原因。

以下是入口與建議，不代表已認領或已完成。以 GitHub 最新 Issue、PR 與維護者確認為準。

• 第一份可重用的共同成果（建議里程碑）：提交可重現案例、來源與驗證結果，由維護者審查；這是建議里程碑，尚未建立為 GitHub milestone。

### 改善Python／Flask 命盤計算 API的第一個案例 · 建議任務

在原作 Issues 提供合成時區案例、日文／繁中欄位說明或安裝重現。不要貼真實出生資料或 API_KEY；保留 ken-kk 的分享來源、AGPL 與星曆授權要求。

• 驗收：一份虛構出生資料的 API 對照表：四個輸入、回傳命盤欄位、星曆準備情況及尚未核對的準確度。 記錄實際驗證與未執行項目；以原作 Issue／PR 協調。

Agent Skill：/development/skills/hdsljp-api/SKILL.md

協作 JSON：/api/v1/skills/hdsljp-api/collaboration

參與開發

在原作 Issues 提供合成時區案例、日文／繁中欄位說明或安裝重現。不要貼真實出生資料或 API_KEY；保留 ken-kk 的分享來源、AGPL 與星曆授權要求。

工坊 Issue／PR 協調入口：https://github.com/kieiken/hdsljp-api/issues

先讀該 Repo 根目錄 README.md、AGENTS.md、CONTRIBUTING.md；原始程式、測試及來源授權留在該專案。平台介紹與公會收錄則在 freedom-platform 的 modules/community 維護。

要改善平台介紹：https://github.com/FreeTWAI/freedom-platform/issues

閱讀與來源

閱讀原始專案：https://github.com/kieiken/hdsljp-api/blob/a3fc3b4ff2a3acf0df541da1b83a3688e0be8a19/README.md

核對日期：2026-10-20

核對版本：a3fc3b4ff2a3acf0df541da1b83a3688e0be8a19

• README.md：https://github.com/kieiken/hdsljp-api/blob/a3fc3b4ff2a3acf0df541da1b83a3688e0be8a19/README.md
• LICENSE：https://github.com/kieiken/hdsljp-api/blob/a3fc3b4ff2a3acf0df541da1b83a3688e0be8a19/LICENSE

共創原則

GitHub Issue 是待辦與協調來源，PR 是審查與合併紀錄。先確認任務範圍，再用自己的分支完成相關驗證；保留上游與實際貢獻者。Fork 不等於平台認證、已測試運行或新授權。

完整結構化目錄：/api/v1/development-map