{"repo":"SylarLong/iztro","free":true,"listed":false,"github":"https://github.com/SylarLong/iztro","clone":"git clone https://github.com/SylarLong/iztro.git","description":"⭐This is a lightweight kit for generating astrolabes for Zi Wei Dou Shu (The Purple Star Astrology), an ancient Chinese astrology. It allows you to obtain your horoscope and personality analysis. 支持多语言轻量级获取紫微斗数排盘信息的javascript开源库。","language":"TypeScript","stars":4070,"topics":["astrolabe","astrology","horoscope","ziweidoushu","chinese-astrology","javascript","npm","typescript","natal-chart"],"license":"MIT","category":"api-integrations-sdks","readme_excerpt":"一套轻量级紫微斗数排盘工具库 简体中文 🔸 繁體中文 🔸 English iztro AI · 紫微与奇门模型 除了开源排盘库， iztro 还提供两个托管的专业 AI 模型。它们会自动调用服务端术数工具，并通过 Chat API 或 Iztro Agents SDK 接入；你不需要自行维护排盘提示词或让通用模型猜测盘面。 模型 适合的问题 需要提供 --- --- --- iztro-ziwei-v3 本命性格、人生格局、两人适配度，以及大限、流年、流月、流日等中长期趋势 出生日期、出生时间、性别和分析主题 iztro-qimen-v3 一件当下具体事情的决断、发展、阻力与应期，例如合作、谈判、面试、上线、出行或关系中的下一步 事情背景、一个明确问题和问事时刻； 不需要出生信息 iztro-ziwei-v3 ：命盘与长期趋势 - 自动调用 iztro 排盘工具，按问题读取本命、大限、流年、流月、流日等必要层级。 - 针对紫微解读优化提示词与推理策略，并可在会话中记住出生信息和此前上下文。 iztro-qimen-v3 ：一事一局的决断与应期 - 根据问事时刻分析 一件具体事情 ，给出结论、主要依据、阻力与行动建议。 - 当用户问“什么时候”或时间是结论关键时，给出真实日历中的候选触发窗口。 - 一事一局：互不相关的事情应分开提问。应期日期是结合全局解读的触发候选，不是“某天必然成功”的保证。 例如，一个清晰的奇门问题是：“我们已经谈过两次渠道合作，但分成和上线时间还没定。现在应该推进、继续谈，还是暂缓？如果可以推进，请给出最近的行动窗口和依据。” [!NOTE] NPM 包 iztro 本身仍是开源的 紫微斗数排盘库 ； iztro-qimen-v3 是通过 API/Agents SDK 使用的托管 AI 模型，不是本地奇门排盘模块。 两个模型都支持以下接入方式： 1. iztro Chat API —— 调用我们的 HTTP API 如果你需要紫微或奇门对话能力，可以使用 iztro Chat API。使用时需要 API key，你可以在 开发者文档 查看完整接口，并通过模型指南比较紫微与奇门。 以下示例假设你已把控制台生成的密钥保存到服务端环境变量 ZIWEI API KEY 。不要把密钥写入浏览器代码。 推荐的集成方式是多轮对话 API：先创建会话，再向该会话发送用户消息。API 会自动处理上下文。 奇门会话在创建时选择 iztro-qimen-v3 。默认使用请求时刻起局；如果用户时区不同或结果需要可复现，请在消息中传入带 UTC 偏移量的 current datetime ： JavaScript 和 Python 示例见 examples/chat-api 。完整的前后端流式聊天、编辑、重新发送示例见 examples/fullstack-demo 。 2. iztro Agents SDK —— 构建你自己的 Agent 在 iztro-ziwei-v3 或 iztro-qimen-v3 上构建你自己的 Agent，并加入自己的工具、MCP 服务器和人工确认。它是对 OpenAI Agents SDK 的轻量封装，提供 Python 与 TypeScript 两个版本： - Python —— pip install openai-iztro-agents · github.com/SylarLong/openai-iztro-agents-python - TypeScript / JavaScript —— npm ins","default_branch":null,"files":null,"tree":[],"storefront":"/r/SylarLong","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/SylarLong/iztro/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}