# hdsljp-api：日文人類圖命盤計算 API：技能書與協作來源 把出生日期、時間、地點與時區送入 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