F
licenseNot graded
qualityC
maintenanceMulti-tradition astrology engine that computes real birth charts, transits, and synastry for AI agents via MCP tools.
15
-
Horosa Skill
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
A local-first MCP server & CLI that exposes 114 real astrology / metaphysics techniques from Horosa (星阙) to any AI client.
简体中文 · English | 快速开始 · 架构 · 技法总览 · 接入客户端 · 可信度 · 文档
Horosa Skill 把星阙（Horosa）的 114 个真实术数 / 占星技法，做成任何 AI 都能本地调用的 MCP server 与 CLI。 克隆仓库、装一次离线 runtime，Claude Code / Claude Desktop / Codex / Cursor / Open WebUI 等客户端就能通过 MCP 或 JSON-first CLI 直接调用真实的星阙方法：西洋本命 / 推运 / 卜卦 / 择日，八字 / 紫微 / 大六壬 / 奇门 / 太乙 / 金口诀 / 三式合一，六爻 / 塔罗 / 天文地占 / 灵棋经 / 小六壬 / 飞宫小奇门 / 小成图 / 皇极轨策 / 神数正传，以及全 14 路神数。
算法在本机运行，断网可用；每个技法返回统一 envelope 与星阙式导出结构，并附一张确定性的技法依据卡；每次调用自动落成可检索的本地记录。与星阙桌面端共用同一套后端、逐值同源（导出契约 v16 镜像桌面端 aiExport v60）。
NOTE
它不是又造一个简化占算器，而是把星阙已有的本地算法、星历与导出协议，整理成一层适合 GitHub 分发、适合 AI 调用、适合长期本地管理的接口。桌面端算出来是什么，这里就是什么——而且每个结论都能回答「这盘怎么来的」。
114 个真实技法，一次安装，全程离线。 覆盖西洋占星全链路、中文术数主干、数算与卜法、全 14 路神数；算法在本机运行，不联网、不上传。
为 AI 消费而设计的稳定契约。 每次调用返回统一 envelope，接入导出协议的技法附带
export_snapshot（段结构化正文）。同一技法连续调用得到同一套字段，落库后结构不丢。调用前的硬性澄清闸。 只要技法受时间 / 地点 / 时区 / 性别 / 事项 / 宫制 / 历法 / 起局方式影响，agent 在用户回答前会被结构化拦截，并收到可直接转发给用户的追问文本；只问还没回答的，钟点、性别这类事实不能用「确认」代替；读不懂的入参按字段说清楚，不再算出另一张盘。
每个结论可溯源。 响应自带技法依据卡（技法 / 流派口径 / 谁算的 / 段落全不全 / 版本链），
horosa_technique_report一键出方法报告，会话级自动检出跨技法口径冲突。31 域方法论知识库，引必带出处。 星阙 app 内 hover 知识三域 + 27 份技法操作手册 + 八字断语库（21 类口诀）共 416 条，逐条带上游文件与版本出处；没有出处的解读必须明说是通则推理。
盘面事实忠实性评测。 确定性校验器把 AI 解读逐句对盘面机读真值，判 supported / invented / contradicted；喂错盘与诱导复述判红；120 条基准用例与工具注册表锁步。
一问多技法合参。
horosa_hecan至少两种技法交叉印证（可复用此前的run_id）+ 合参模板（带各技法正文节选）：每条结论必须绑定真实段落，收敛与分歧分开填，分歧必须披露、不许平均。精简的响应体量。 MCP 结果缺省是阅读视图：正文一遍 + 段索引 + 技法依据卡，不带引擎原始树；正文过长按段裁，
warnings写明续读调用。response_view=sections|titles|full改取分段正文 / 只要段标题 / 带原始树，完整结果始终已归档。主限法可推至 3000 年。 逐位核验的核5方位法 + 22 项时间钥匙 + In Zodiaco / In Mundo + 宿命点(Vertex)应星 + 映点 / 界作迫星，多圈复发行。
完整的本地记录系统。 SQLite 全文检索（trigram，中文子串可命中）+ JSON artifact 归档；按人名 / 技法 / 日期区间 / 全文组合检索，跨会话找回历史。
结构化报告导出。 一条命令生成 DOCX / PDF / JSON；Markdown 表格渲染为真 Word 表格，含导航大纲、目录、页码与中文字体；
style=chart不经 AI 直接出完整排盘报告。自备知识库。 自己的笔记放进知识库文件夹，计算时按名 / 标签 /
auto点选，随结果附进 AI 上下文。成熟的安装与升级链。 断点续传、多镜像回退、实时进度；版本短路（已最新则跳过下载）；
upgrade/uninstall/selfcheck/doctor环境体检齐备。同源后端。 奇门 / 太乙 / 金口诀走星阙
ken后端；14 路神数走 chart 服务上挂载的 kentang 引擎；结果由 headless JS 层重排为aiExport.js段结构。
架构
AI 客户端经 MCP（stdio / streamable-http）或 JSON-first CLI 接入 Horosa Skill（本地进程 · 114 工具 · 澄清闸 · 统一 envelope）；
它在本机调起离线 runtime——Java 后端（农历 / 八字 / 紫微 / 六壬）、Python chart 服务（西洋星盘、ken 三式引擎、kentang 神数引擎）与
headless JS 层 horosa-core-js（把结果重排成 aiExport.js 段结构）——再把每次调用写进本地 SQLite 与 JSON 归档。
上游星阙只单向同步进本仓，runtime 随 GitHub Releases 分发。
一次调用
以「查今年事业，1995-06-03 05:30 上海出生」为例，agent 端的实际序列：
澄清闸兜底：只问还没回答的问题——缺出生钟点、性别这类只有用户知道的事实时单独问（确认标记代替不了）；宫制等设置没给时问是否沿用星阙默认。工具返回可直接转给用户的追问文本，agent 不自行补参。
起盘：用户答完后把答案放进载荷（地点可直接写
place: "上海"，按地点 + 日期推出坐标与含夏令时的时区），设置类的确认再带agent_confirmed_settings: true；返回统一 envelope，含memory_ref.run_id与data.export_snapshot。读盘：读
export_snapshot.export_text撰写解读（MCP 缺省只给正文与段索引；被裁的段按warnings里的horosa_memory_show调用续读；要原始树传response_view: "full"）。溯源尾注：把
data.technique_card转述成尾注——用了什么技法、什么口径、谁算的、段落全不全、版本链。出报告：
report_render生成解读终稿 DOCX（自动写回记忆）；horosa_technique_report另出「技法依据报告」。跨会话找回：
memory_query按人名 / 技法 / 日期检索，memory_show取完整记录。
NOTE
最短路径为2 次工具调用 + 1 次本地分析：起盘拿到 run_id，本地撰写 ai_report，再 report_render 出 Word 并自动归档。一问需要多技法互证时，改用一次 horosa_hecan 并行起盘（见可信度体系）。全程算法在本机、AI 只负责解读、结构永不丢。
Related MCP server: auseklis
快速开始
TIP
前置只需uv：macOS / Linux curl -LsSf https://astral.sh/uv/install.sh | sh；Windows（PowerShell）powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"。装完 重开终端（或 source $HOME/.local/bin/env）让 uv 进 PATH；Python ≥ 3.12 由 uv 自动准备；磁盘预留约 5 GB（runtime 下载约 730 MB、解压后约 2 GB）。
git clone https://github.com/Horace-Maxwell/horosa-skill.git
cd horosa-skill/horosa-skill
uv sync
uv run horosa-skill install # 安装离线 runtime（带进度 / 断点续传；已最新则跳过下载）
uv run horosa-skill doctor # 环境体检（磁盘 / 端口 / node 实跑探针，期望 issues: []）
uv run horosa-skill selfcheck # 活体验证：起一张盘 → 存 → 读回
uv run horosa-skill serve # 启动本地 MCP（默认 http://127.0.0.1:8765/mcp）不想 clone 源码？零安装（无需 git、无需 PyPI）——每个发布页都附带纯 Python wheel，uvx 直接从 URL 起，
HOROSA_RUNTIME_MIRROR 对 wheel 与 runtime 一并生效：
WHL="https://github.com/Horace-Maxwell/horosa-skill/releases/download/v0.50.1/horosa_skill-0.50.1-py3-none-any.whl"
uvx --from "$WHL" horosa-skill install # 装离线 runtime（同上）
uvx --from "$WHL" horosa-skill doctor # 体检
uvx --from "$WHL" horosa-skill setup --client cursor # 零安装一条命令接入（自动选 `--launcher uvx-wheel`，配置里写 wheel URL）
uvx --from "$WHL" horosa-skill serve --transport stdio # 给客户端直连；`client config --launcher uvx-wheel` 生成对应配置github.com 直连不通（镜像 / API 直链 / U 盘离线搬运 / 代理与企业证书）见 docs/INSTALL_RESTRICTED_NETWORK.md。 PyPI 通道（
uvx horosa-skill …）已就绪但暂未开通（等维护者完成一次性 Trusted Publisher 配置），开通后命令更短、行为不变。
NOTE
Linux / Intel Mac / Docker（实验）：离线 runtime 只发布 macOS(arm64) / Windows(x64) 两个 payload。其它平台上
horosa-skill install 自 0.50.1 起改装平台无关的 JS 引擎资产（horosa-core-js-v<版本>.tar.gz，约 7 MB，装到 runtime 根下的 core-js/；
需要系统里有 Node.js ≥ 20.10，没有时引擎照装、结果里说明装什么）：八字、六爻、大六壬、河洛、参评、一掌经、塔罗、黄历等本地 JS 技法因此可用；
任何平台都可以用 install --engine-only 只装它，uninstall --engine-only 只删它。要 Java / chart 服务算的技法（紫微、西占、三式、神数等）
走 MCP 网关：把 HOROSA_SERVER_ROOT / HOROSA_CHART_SERVER_ROOT 指向宿主机或另一台装了 runtime 的机器即可。
仓库附带实验性的 horosa-skill/Dockerfile + docker-compose.yml（网关镜像：自带钉版本的 Node 与 JS 引擎，容器内没有离线 runtime，
必须设上面两个变量；绑 0.0.0.0 必须给 HOROSA_MCP_TOKEN）；
手工起也行：pip install "https://github.com/Horace-Maxwell/horosa-skill/releases/download/v0.50.1/horosa_skill-0.50.1-py3-none-any.whl" 后 horosa-skill serve --transport streamable-http 即为网关（PyPI 尚未开通，装的是发布页的 wheel）。
症状 | 处理 |
| 先安装 uv： |
八字 / 六爻 / 六壬等报 | 本机没有 JS 引擎（Linux / Intel Mac / Docker 外的 pip 网关 / 没跑过 |
下载缓慢或中断 | 重跑 |
| 走 API 资产直链下载后本地安装：先 |
Java 后端(:9999)未就绪 / | 会自动降级 chart-only 而不是全盘卡死：三式(奇门/太乙/金口)、神数、地占、塔罗、西占 chart 族照常可用；nongli/bazi/ziwei/liureng 与「占时」起课暂不可用。 |
Windows 上 Java 进程秒退、无任何日志 | 已知诱因：代理/VPN/安全软件的 WFP 过滤会拦 |
磁盘不足 / 端口被占 / 看不懂 doctor 的码 |
|
macOS 首次起 runtime 失败且无日志 / | 浏览器下载的归档解出来的 python / java / node 带 Gatekeeper 隔离属性：运行报告里 |
Windows 路径太长（ |
|
Windows 上 install 报 | runtime 目录路径含中文等非英文字符（中文用户名下的默认路径即是）；随包的 Java 17 与 Swiss Ephemeris 用窄字符 API 访问文件。设纯英文路径： |
慢网 / 企业代理下载总超时 |
|
Windows 首次启动弹防火墙 / | 旧版启动器把 Java 绑在 0.0.0.0；升级后 |
Codex 里一堆报错 / 首轮看不到工具 | 多半是超时没写（Codex 默认 10 s/60 s）： |
终端里 | GUI 客户端不继承 shell PATH；重跑 |
Windows 用户名带空格 / 中文时服务起不来 | v0.38.0 起启动器给每个路径参数加了引号；升级后 |
升级 |
|
卸载 |
|
接入 AI 客户端
setup --client <客户端> 一条命令走完接入（v0.38.0）：探网（5 s）→ 装 / 校验离线 runtime →（--vectors 时）准备向量检索 → 写配置（自动定位、
只动 horosa 条目、内容没变不写、首次改写前把原文件存为 .horosa-bak、原子替换并保留权限；终端里设的引擎 / 数据目录变量写进条目 env）→ 把 horosa-agent skill 装进该客户端读的 skills 目录（v0.50.1；
多数客户端读共享的 ~/.agents/skills；--no-skill 跳过、--skill-dir 指定）→ doctor → 回读磁盘体检 → 用客户端将要执行的那条命令真起一次
stdio server 并数工具 → 打印下一步。失败时 stderr 给出结构化失败包（step / code / config_untouched /
backup_path / retry_command），退出码 2；写配置之前失败保证 config_untouched: true。只想看配置不落盘用 client config：
uv run horosa-skill setup --client cursor # 一条命令接入（25 个客户端，见下方 Works with 表）
uv run horosa-skill setup --client cursor --dry-run # 只看计划：零副作用
uv run horosa-skill client config --format claude-code # 只生成不落盘：输出 claude mcp add … 命令
uv run horosa-skill client config --format codex # config.toml 片段（含超时设置）
uv run horosa-skill client check # 体检本机各客户端**实际写着什么**（含 skill 装没装、是不是本版）
uv run horosa-skill client skill --client codex # 只装 skill 规则（手动配过 MCP 的用户；不带 --client = 共享目录）skill 是 agent 读的规则（先问后调 / 只读返回的快照 / 禁手算），此前只有打开本仓的 agent 读得到；wheel 里现在带一份，setup 顺手装好。
已有同名目录时：由 npx skills 等工具以软链接管理的、或不是本工具装的，一律不动；你改过的旧版先备份成 horosa-agent.horosa-bak 再更新。
仓根另带 6 份薄镜像——GEMINI.md（Gemini CLI）、.github/copilot-instructions.md（Copilot）、.windsurf/rules/、
.clinerules/、.cursor/rules/（Cursor）、.agents/skills/horosa-agent/（Codex / agentskills.io）——让这些 agent 打开仓库就知道闸门、读盘规则与精简面下的 horosa_tool_run 直呼；策略唯一源仍是 SKILL.md，
其中「Shell-only agents」一节给没有 MCP 的 agent 一套纯 CLI 契约（tool run --input/--output、退出码、闸门流程）。
客户端 | 传输 | 一行接入 | 默认工具面 | 注意 |
Claude Code | stdio |
| 全量 127 | 项目内直接用仓根 |
Claude Code Plugin | stdio |
| 全量 127 | skill + MCP 一步到位；插件装在 |
Agent Plugins v1（VS Code · Copilot CLI · Codex · Kiro · OpenHands · Qwen Code） | stdio |
| 精简 14 | 仓根 |
MCP 官方注册中心 | stdio（ | 在支持注册中心的客户端里搜 | 全量 127 | 条目 |
Claude Desktop | stdio |
| 全量 127 |
|
Cursor | stdio |
| 精简 14 | Cursor 全局约 40 工具上限，超出静默丢弃 |
VS Code (Copilot) | stdio |
| 精简 14 | 跨所有 server 共 128 工具上限；仓内已带 |
Codex | stdio |
| 精简 14 | 必须调高 |
Gemini CLI | stdio |
| 精简 14 | 工具名 ≤63 字符 + 严格 JSON Schema 2020-12（广告层已按它收敛） |
Windsurf → Devin Desktop | stdio |
| 精简 14 | 2026-09 起 Cascade 已移除，Devin Local 读 Devin CLI 的 MCP 文件；旧 Cascade 100 工具上限 |
Cline | stdio |
| 精简 14 | 无工具搜索，全量面偏重 |
Zed | stdio |
| 精简 14 | 配置根键是 |
OpenCode | stdio |
| 精简 14 | 缺省连接 / 调用超时撑不过冷启动与择日扫描，已写 |
Goose | stdio |
| 精简 14 | 超时单位是秒，已写 600 |
Kiro | stdio |
| 精简 14 | Kiro CLI 启动缺省只等 5 s：先 |
GitHub Copilot CLI | stdio |
| 精简 14 | 只转发 PATH：env 表写入 HOME 与两个 runtime 根，探针按同样形状验证 |
JetBrains Junie | stdio |
| 精简 14 | 无超时字段：首次用前 |
Qwen Code | stdio |
| 精简 14 |
|
Kimi Code CLI | stdio |
| 精简 14 | 严格 JSON、一条坏整份拒；已写 |
Qoder | stdio |
| 精简 14 | 旧版 Qoder IDE 只能在界面里配 MCP |
CodeBuddy | stdio |
| 精简 14 | 超时只能用环境变量 |
TRAE | stdio |
| 精简 14 | 所有 MCP 合计 40 个工具上限；command 不能含空格 |
Amp | stdio |
| 精简 14 | 条目不许多余字段（无超时）：首次用前先预热 |
Warp | stdio |
| 精简 14 | 若同时让 Warp 自动拉起 Claude Code / Codex 的 server，可能出现两份 |
Factory Droid | stdio |
| 精简 14 | 改完自动重载 |
Augment Auggie CLI | stdio |
| 精简 14 | IDE 扩展用自己的设置面板，不读这个文件 |
Deep Code | stdio |
| 精简 14 | 单次工具调用固定 60 s 上限，长任务会超时；启动超时用 |
DeepSeek Harness（dsh） | stdio |
| 精简 14 | 开发者预览版，格式可能变 |
OpenClaw / mcporter | stdio |
| 全量 127 | — |
Open WebUI · n8n · Dify | streamable-http |
| 全量 127 | 接入说明；跨机必须带令牌，且没有 TLS，请放反代后面 |
ChatGPT / claude.ai 远程连接器 | streamable-http | 同上，再套一层终结 OAuth 的 HTTPS 网关（Cloudflare Access / oauth2-proxy）——两家连接器只接 OAuth，本 server 只提供静态 Bearer，网关负责把 OAuth 换成注入 | 全量 127 | 没有托管端点；配方见 说明 |
--surface full / --surface compact 可覆盖默认；--launcher uvx-git 生成免 checkout 的
零安装命令（uvx --from "git+…#subdirectory=horosa-skill"，PyPI 通道尚未开通）。
平台
平台 | 离线 runtime | 说明 |
macOS arm64 | ✅ 官方载荷 | 主力平台 |
Windows x64 | ✅ 官方载荷 | |
Windows ARM（骁龙本 / Surface 等） | ✅ 自动装 x64 载荷走仿真（自 0.38.0） | Windows 11 的 x64 仿真下 Java / Python / Node 都能起（GitHub |
Linux | ⚠️ 无载荷（实验）；JS 引擎可装（自 0.50.1） |
|
Intel Mac | ❌ 不支持载荷；JS 引擎可装（自 0.50.1） | arm64 载荷不能在 Rosetta 下跑（内含 JDK/Python 是原生 arm64）；本轮明确不做 x86_64 载荷。 |
TIP
上下文预算受限的客户端可设HOROSA_MCP_COMPACT=1，只暴露 14 个门面工具（含按名直调的 horosa_tool_run，114 个技法仍可按名到达），澄清闸照常生效。或用 HOROSA_TOOLSETS=astro,cn 按域裁剪平铺面（合法域 astro/predict/chart/cn/shenshu/other/export/knowledge，别名 western/chinese/reference/all/none；认不出的值会被忽略，问题写在 stderr、horosa_agent_guidance 的 server_profile 与 doctor 里；一个合法值都没有时只注册门面工具 + horosa_tool_run，不会悄悄变成全量；只要裁剪生效就注册 horosa_tool_run 直呼通道；门面工具恒在）。根目录 server.json 为 MCP Registry 元数据，普通用户无需手改。
TIP
繁体输出：在 Claude Desktop 扩展设置 / Claude Code 插件设置里勾「繁體中文輸出」，或设 HOROSA_OUTPUT_SCRIPT=zh-Hant（香港字形用 zh-Hant-HK；setup --client <名> --output-script zh-Hant 直接写进客户端配置）。排盘正文、段名、提示与报告转成繁体；回显的入参、设置值、选项、错误码保持原样（AI 原样送回也对得上），不设就是简体、与原来逐字相同。术数用字按 沖 / 剋 / 曆 而非 衝 / 克 / 歷。
TIP
配好了却在客户端里看不到 horosa？跑uv run horosa-skill client check —— 它读的是各客户端实际写着什么，能指出未展开的占位符、缺失的 --transport stdio、搬走的目录、以及 Codex 的默认超时。
技法总览
所有业务技法都返回统一 envelope 并附星阙式 export_snapshot。带 ⓟ 的工具受设置影响，调用前必须先确认参数。
工具 ID | 名称 | 说明 |
| 标准星盘 | 基础西洋星盘 + 完整导出正文（12 分度 / 主宰星链 / 寿命格局 / 古典 + 古典衍化 / 古典格局） |
| 13 宫扩展盘 |
|
| 十二分盘 / Dwadasamsa | 黄经×12 mod 360，与十三分盘同结构 |
| 巴比伦占星 | 恒星黄道·毕宿锚 + 算术历日 + 「位」三法 + 行星神性 + 微黄道 |
| 龙盘 / Draconic | 各点黄经减北交点（交点归零的盘）+ 龙首基准专属段 |
| 重置盘 / Relocation | 出生时刻不变，按新居住地重算宫位与角点 + 四角对比段 |
| 希腊星盘 | 希腊占星取向盘面 |
| 印度盘 | 分宫 4→24 制、岁差 6→47 制 |
| 七政四余盘 | 七政四余 / 果老法盘面 |
| 合盘 / 关系盘 | 双人关系、合盘、关系量化评分 |
| 量化盘 / 汉堡学派 | 90° 拨盘 + 8 颗 TNP + 中点树 / 相位 / 列表 |
工具 ID | 名称 | 说明 |
| 太阳 / 太阴返照 | 本命 + 返照盘 + 相位 |
| 太阳弧推运 | 本命 + 推运盘 + 相位 |
| 指定年推运 | 本命 + 流年盘 + 相位 |
| 小限 / 年运推限 | profection 时间层 |
| 本初方向 / 主限 | 逐位核验核5方位法 + 22 项时间钥匙，可推运至 3000 年 |
| 主限盘 | 可读主限盘面 + 相位 |
| 黄道释放 | zodiacal release 时间轴 |
| 法达星限 | 法达星限结构与时间轴 |
| 十年大运 | 与星阙 |
| 年龄推进点 / Huber | Koch 宫 6 年一宫周期 |
| 界推运 / 分配法 | 上升点行经埃及界的分配主时间轴 |
| 世俗盘 | 年度入宫盘 + 子盘群（新月 / 满月 / 日月食 / 地区盘 / 行星周期 / 定局 / 分野） |
| 赤纬推运 | 二次推运 + 赤纬平行 / 反平行 |
| 恒星推运 | sidereal 下的二次推运 |
| 二次推运（回归黄道） | 次限 / 三限 / 小限推运（minorVariant：synodic 缺省 / sidereal / engine），上游 v3.11 新导出键 |
| 星历 | 日期窗内入座·留逆·朔望弦·食相 + 行运触发本命（缺省今日起 90 天） |
| 回归轴 | 逐年太阳 / 月亮返照时间轴（起始年 + 年数 1–40） |
| 产前朔望 | 出生前最近朔 / 望、所落度数与该时刻的星盘 |
| 行星弧 | 整盘按 arcSource 二次弧方向 |
| 行星年龄 | 托勒密人生七阶 + 当前主运 |
| 129 年系统 | 七政各管小年的 129 年一轮 |
| 波斯向运 | 黄经象征向运（1°/年）应期表 + 指定日期整铸向运盘 |
| Balbillus 129 年 | 旺距削减主限 + 递归子限 |
| 三分主星推运 | 昼夜换序划分人生阶段 |
| 数字相位推运 | 七星小年数 + 座距按年龄因数激活 |
| 月相推运 | 次限日月黄经差八相时间轴 |
| 多重回归 | 土 / 木 / 月交三体返照应期 + 日月返照年表 |
| 演进推运（Néroman） | 对数时标弧逆行演进全部点 + 对本命相位 + 天顶 / 上升过本命点年表 |
| 推运图（Bezza） | 真太阳弧下 Placidus 世俗推进：各点时位 + 四类接触应期 |
| 周日小限（Jay） | 赤经中天每年 +30°：当前小限 + 十二年逐年表 |
| 双黄道（Michon） | 回归 / 恒星黄道叠合：十二叠合 + 互动的五类谐波族 |
| 占星地图 | 行星地理投影线（MC/IC / 天顶点 / 偕升带 / 线交点）+ 落点分析 / 世运事件时刻 |
| 印度生时校正 | KP 法锚点±半窗扫描：RP / Pranapada / gandanta 边界判据打分候选榜 |
| 行星周期 | 任意两星合冲精确时间轴（木土 / 土冥…；地心 / 日心 / 站心） |
| 名人星盘库 | 数万条 A/AA 级出生数据离线检索（FTS / 分类 / Rodden 评级） |
| 玄史知识库 | 7900+ 玄学事件（原文/白话/解读/引证）· 27000+ 史书天象 · 人物图谱 · 朝代/术数/时间线（只读检索） |
工具 ID | 名称 | 说明 |
| 卜卦（horary） | 根本性 / 14 类征象星 / 完成分析 / 月亮的故事 / 裁决 / 应期方位 |
| 择日（electional） | 红线 / 28 类用事规则包 / 评分定级 / 起盘时刻 / 建议 |
| 天星择日·征象搜索 | 时间窗内扫西占征象条件树 / 命中区间 + 单时判读 + 选中时刻星盘 |
| 七政择日动盘 | 十一曜二十四山方位 / 地平高度顺逆 / 日月食搜索 / 方位到达搜索 |
| 奇门择日「找局」 | 时间窗内扫奇门条件树 / 命中时辰 + 完整奇门盘 17 段 |
| 黄历择吉 | 日期范围内扫通书条件树（26 类）/ 命中日段 + 完整黄历日课 10 段 |
| 八字择时 | 时间窗内扫八字条件树（26 类：十神在柱 / 刑冲穿破 / 纳音星运…）/ 命中时段 + 完整八字盘 |
| 太乙择时 | 时间窗内扫太乙条件树（24 类：十精诸算 / 九州分野…）/ 命中时段 + 完整太乙盘 |
| 紫微择时 | 时间窗内扫紫微条件树（28 类：格局含破格 / 宫干四化 / 来因宫…）/ 命中时段 + 完整紫微盘 |
| 六壬择时 | 时间窗内扫六壬条件树（27 类：小局大格 / 遁干 / 旺衰…）/ 命中时段 + 完整六壬盘 |
| 三式合一择时 | 条件跨六壬 / 奇门 / 太乙三盘自由组合（70 类，最多的一支）+ 三式合一盘 |
| 七政择时 | 分钟级区间搜索（七态庙旺等 11 类，判定跑后端 swisseph）+ 果老盘 |
| 印度择时 Muhurta | 分钟级区间搜索（Panchanga 五肢 / Lagna / 三十须臾 / Choghadia / 五祸等 18 类，判定跑后端） |
工具 ID | 名称 | 说明 |
| 八字命盘 / 直断 / 八字反查 | 四柱 + 大运 + 神煞 + 干支合冲 + 五行力量 / 格局 / 盲派结构；反查 = 四柱干支 → 候选出生时刻（Java 逐年回推，免确认门） |
| 紫微斗数 | 自定义四化 / 流派 / 身宫 / 八字大运 / 命中格局；22 个传本开关（非缺省即按星阙本地 ZiweiCalc 重排） |
| 紫微规则库 | 返回紫微命中格局规则全库（免确认直读） |
| 大六壬起课 / 行年 | 26 起课法 / 四课三传（递生递克）神煞 / 毕法 100 法 / 占断向导 / 七政 |
| 奇门遁甲 | ken（ |
| 太乙神数 | ken（ |
| 金口诀 | ken（ |
| 三式合一 | 一页聚合奇门 + 太乙 + 大六壬，统一导出 |
工具 ID | 名称 | 说明 |
| 统摄法 | 卦象 / 六爻 / 潜藏 / 亲和 |
| 邵子参评数 / 金锁银匙 | 四柱起数 + 本命 / 大运歲運条文 |
| 河洛理数 | 先后天卦 + 元堂爻辞 + 大限岁运断验 |
| 一掌经 | 十二支六道 + 十二宫 + 大限流年十二神 + 神煞合参 |
| 神数正传 | 铁板 / 邵子 / 大定 / 六亲 / 铁算心易 五流派·四柱起数 + 条文 + 大运死月 |
| 小六壬 | 三数起三传·主流六宫 / 道门九宫 + 生克 + 九神 + 拜解 |
| 飞宫小奇门 | 时上起青龙飞九宫 + 主客命宫 + 八门九星 + 流年流月 + 应期 |
| 小成图 | 洛书九宫佈局 + 正旁推 + 四象 + 应期 + 股市研判（五式起卦） |
| 皇极轨策 | 十二法起卦 + 演数四位 + 卦变断法 + 三要十应 + 元会运世 + 大定 |
| 调波盘 | 黄经 × 调波数取位、同频合相 + H 数表专属段 |
| 宿占 / 宿盘 | 宿占结构与宿曜信息（缺省八字公式起盘，宿度制 0–8） |
| 六爻 / 易卦 | 本 / 互 / 之 / 错 / 综卦 + 断卦结构 + 断诀命中 / 占类断语（星阙以时起卦与断语库） |
| 天文地占 | 4 母卦 → 16 图形 + 十二宫入宫 + 判官 / 见证 |
| 塔罗 | 78 牌确定性洗牌 + 牌阵直断 / 细论 / 综合建议 |
| 灵棋经 | 十二棋一时掷之（上四中四下四）→ 六十四卦 + 棋势三才 / 繇辞 / 诸家注 / 课断 / 断诗 |
| 占星骰子 | 星骰与对应解读结构 |
工具 ID | 名称 | 引擎 | 工具 ID | 名称 | 引擎 |
| 皇极经世 | 标准 |
| 铁板神数 | kinastro |
| 五兆 | 标准 |
| 鬼谷分定经 | kinastro |
| 太玄筮法 | 标准 |
| 北极神数 | kinastro |
| 荆诀 | 标准 |
| 南极神数 | kinastro |
| 神易数 | 标准 |
| 蠢子数 | kinastro |
| 邵子神数 | kinastro |
| 万化仙禽（演禽） | kinastro |
| 策天飞星 | kinastro |
| 七政四余（七政·张果） | kinastro |
工具 ID | 名称 | 说明 |
| 全年节气盘 / 农历换算 | 节气节点 / 农历干支 |
| 出生节气窗 | 出生前后节气精确时刻 + 所落区间（八字起运窗同源） |
| 黄历 / 万年历 | 整月农历 / 干支 / 节气 / 朔望 + 选中日详情（农历 / 老黄历 / 日子馆三源合一） |
| 老黄历日课 | 今日宜忌 / 值神值宿 / 彭祖百忌 / 吉神凶煞 / 冲煞·胎神·方位 / 时辰吉凶 / 物候 / 流年年神方位 |
| 通书择日 | 董公 / 奇门叠数 / 三垣列宿 / 天元乌兔 / 三元玄空大卦 五流派 |
工具 ID | 名称 | 说明 |
| 卦义 / 梅易卦义 | 卦名卦辞 / 梅花易数卦义 |
| 导出协议注册表 / 正文解析器 | 机器可读导出总表 / 把导出文本解析回 JSON |
| 知识目录 / 读取器 | 31 域（hover 知识 + 技法操作手册 + 八字断语库）列出 / 读取 / |
计算工具之外是门面工具：全量面 = 114 技法 + 13 个门面（共 127）；精简面（HOROSA_MCP_COMPACT=1）只给 14 个门面工具 = 这 13 个 + 按名直呼的 horosa_tool_run（精简面没有平铺的知识 / 导出工具，knowledge_read 等也经 horosa_tool_run 到达）：
门面 | 作用 |
| 总调度：按问句意图选技法（繁体、全角、英文、拼音说法同样路由）。起课类（奇门 / 六壬 / 六爻 / 塔罗 / 黄历…）按 |
| 合参：一问多技法交叉印证。 |
| 按名直呼（精简面 / |
| 参数指引： |
| 技法依据报告：单次 / 整场问答「用了什么技法、什么口径、谁算的」的确定性报告 |
| 咨询报告：AI 终稿 → JSON / DOCX / PDF，自动写回记忆； |
| 本地记忆：检索（人名 / 档案别名、技法中文名或 MCP 名、日期）/ 回看完整记录（阅读视图，可按段续读， |
| 检索知识：内置知识 + 你自己的笔记一起查（中文两字词即可、繁简互通，问句按知识库词表切词，常用英文术语换成中文再搜），每条带出处与行号，再用 |
| 地名检索：星阙城市库离线解析（简繁 / 拼音 / 英文 / 常见缩写与旧称，可带省 / 国家 / 州），候选带 |
| 命主档案：把出生信息存成「我」「妈妈」（本机保存； |
NOTE
明确排除项：fengshui（风水尚未完成 headless 化，不作为可发布能力）。
输出契约与澄清闸
输出契约
每个工具调用返回统一 envelope：
{
"ok": true, "tool": "qimen", "version": "0.50.1",
"input_normalized": {}, "data": {}, "summary": [],
"warnings": [], "memory_ref": {}, "error": null
}这是 CLI 与本地存档里的完整信封。接入导出协议的技法额外带 data.export_snapshot，含 export_text（段结构化正文）、sections（逐段标题 + 正文）、selected_sections、provenance 等；起盘类技法另附 data.technique_card（技法依据卡，见可信度体系；知识库 / 导出注册表这类不起盘的工具不附）。因此 ——
AI 无需从自由文本猜结构；
同一技法连续调用得到同一套契约；
summary第一行是一句有信息的标题（「已生成八字（11 段）：日期…；时区…」），地点怎么解析的也写在summary与依据卡里；warnings是要转告用户的说明：有的是缺段 / 降级（「结果不完整」「降级：…」），有的是入参怎么读的、哪些参数没人读、正文被裁后怎么续读——逐条看，不要一律当成「结果不完整」；择日结果的
summary多一行「条件按此理解」，data.condition_echo逐行写出引擎怎么读条件树；dispatch 的time_basis写明每个技法用的是出生时刻还是context里的此刻；落库到 JSON artifact 后结构不丢。
NOTE
MCP 返回的是阅读视图（v0.50.0 起缺省）：正文 export_text 一遍 + 段索引（序号 / 标题 / 字数）+ 技法依据卡 + run_id，不带引擎原始树；单次结果上限约 48 000 字符 / 20 000 估算 token（HOROSA_MCP_RESULT_MAX_CHARS / HOROSA_MCP_RESULT_MAX_TOKENS 可调），一张八字约 1.5 万字节、星盘到上限时按整段裁并在 warnings 写出照抄可用的续读调用（horosa_memory_show(run_id, response_tool, response_sections=[…])）。response_view: "sections" | "titles" | "full" 改取分段正文 / 只要段索引 / 带原始树的完整信封（星盘的 full 约 28 万字节，只在要原始字段时用）；HOROSA_MCP_RESULT_VIEW=full 把缺省改回完整信封。dispatch / 合参里每个技法也是阅读视图，共用一份预算。完整结果始终已归档，memory_show(run_id) 随时取回。字段全表见 docs/DATA_CONTRACTS.md 与 docs/INPUT_CONTRACTS.md。
调用前的澄清闸
IMPORTANT
只要技法受时间 / 地点 / 时区 / 性别 / 事项 / 宫制 / 历法 / 起局方式影响，agent 在用户确认前会被拦截，返回agent_guidance.required 与可直接转发给用户的追问文本。杜绝「AI 自己脑补一个生辰就开算」。
// ❌ horosa_cn_qimen 被拦截：起盘地点、所问何事、起局方式都没答
{ "date": "2026-05-18", "time": "13:14:00" }
// ✅ horosa_cn_qimen 通过：用户答完，地点用 place（按地点 + 日期推出 -07:00）
{
"agent_confirmed_settings": true,
"clarification_notes": "用户确认：此刻 2026-05-18 13:14，人在旧金山，所问为工作决策；奇门起局按星阙默认。",
"question": "这份工作要不要接",
"date": "2026-05-18", "time": "13:14:00", "place": "旧金山"
}闸门怎么判（v0.50.1）：
只问还没回答的问题。 载荷已经回答的不再问，跟这次无关的不问（上海出生不问南半球月令）；什么都不缺就直接起盘，不用确认标记（如
huangli {"date": "2026-11-12"}）。事实与设置分开。 出生 / 起课的钟点、性别（八字、紫微、六壬行年、参评、河洛、一掌经、神数正传与各神数等 17 种技法缺性别会单独问）、合盘的另一个人、起课的「此刻」是只有用户知道的事实：
agent_confirmed_settings/defaults_accepted代替不了，得把值放进载荷。宫制、流派、起局方式这类设置，用户回答或明说「按星阙默认」后才带确认标记（必须是 JSONtrue，"true"/1会得到专门的错误）。读不懂的值按字段拒。 日期、时刻、时区、经纬度、性别对所有技法同一套规则：「东八区 / UTC+8 / 北京时间」「8点半 / 8:30 PM」「1990年5月3日 / 19900503」「北纬31.22 / 31°13′N」「坤造 / 女士」都能读（读法写进
warnings）；zone=480、CST、「辰时」「不详」、03/05/1990、农历日期、40n75、经纬对调、性别「其他」会被拒，错误里每个字段一条（收到什么、要什么、例子、可选项），只有用户知道的会标明要问用户。设置值（宫制名、流派、口径…）认不出时回tool.invalid_option并在details.accepted列出可选值，不再悄悄换成缺省。地名与时区。 技法与 dispatch 都收
place：按地名 + 日期推出坐标与当时的时区（含夏令时，如 1986–1991 年的中国夏令时），有歧义时把候选给用户选。显式给的zone照原样用、不再按地点核对夏令时；IANA 名（America/New_York）按日期换算，钟点落在夏令时空档或重叠里会请用户在两个偏移里选。没有「时间不详」模式。 钟点缺失、写成「不详」或只给时辰时一律拒绝并请你问用户；农历日期会被拒并指向
horosa_cn_calendar_month查对应的公历日。
标准流程：用户说出需求 → 参数不足则查 horosa_agent_guidance 或直接询问 → 用户明确回答 → 把事实写进载荷，设置类再带 agent_confirmed_settings: true + clarification_notes 调真实工具 → 用 export_snapshot 解释，不自行手算。
可信度体系
IMPORTANT
玄学输出最大的风险不是算错，而是 AI 在盘面之外自由发挥。这里把「结论怎么来的」做成机器契约：每个答案可溯源、每条教义有出处、每句断言可对盘校验、多技法互证有纪律——四件都由确定性代码守着，不靠模型自觉。
1. 每个结论带技法依据卡
每个起盘技法的响应附 data.technique_card（知识库 / 导出注册表这 5 个不起盘的工具不附）：技法名与流派口径——列出这个技法每一项会改结果的设置，写成人读的值并注明来源（用户给的 / 命主档案 / 按地点推得 / 缺省），含 排盘规则 晚子时开关——、地点怎么解析的、算源声明 vs 运行实测（compute.matches_declaration=false 时必须提示「结果请谨慎采信」）、段落完整性、版本链。horosa_technique_report 把单次调用（run_id）或整场问答（group_id）渲染成 markdown / json / docx / pdf 方法报告，会话级还会检出跨技法口径冲突（两个技法晚子时开关不同 = 结论不可互证）。不需要时 HOROSA_TECHNIQUE_CARD=0 关闭。
uv run horosa-skill report technique --group-id <group_id> --format markdown2. 31 域方法论知识库 · 引必带出处
knowledge_registry / knowledge_read 覆盖 31 域 = 星阙 app 内 hover 知识三域 + 27 份技法操作手册 + 八字断语库 21 类（共 416 条：各设置项取值与差别、流派分歧、算法与口径、八字口诀），逐条带「星阙操作手册 · 域 · 条目（源文件 @ 上游版本）」出处。配套策略写进 SKILL.md：引教义必带出处；没有出处的解读必须明说是通则推理——反 Barnum 效应的第一机制。
3. 盘面事实忠实性评测
horosa-skill benchmark faithfulness 用确定性校验器（非 LLM 打分）把 AI 解读中的事实断言逐条对盘面机读真值：四柱干支 / 行星落座 / 紫微主星落宫与身宫 / 大六壬三传 / 六爻卦名与动爻 / 塔罗牌名正逆……三通道判 supported / invented / contradicted。喂错盘的答案、诱导复述（「我月亮在天蝎对吧」「我抽到的月亮是逆位吧」而实际不是）都会判红。HorosaBench 120 条基准用例（手写用例 + 每个导出技法一条由工具注册表生成的用例）与工具集锁步——新增技法没有用例直接红。
4. 一问多技法合参
horosa_hecan（CLI：horosa-skill hecan）：一问多技法交叉印证（同 group_id 落库；max_tools 缺省 5、最多 8）。tools 可点名技法，也可写此前运行的 run_id（那次的结果原样复用、不重算；复用的本命盘出生时刻与这次不同会提醒）；不给 tools 时按问题领域缺省配一对（命理 八字 + 紫微、起课 六壬 + 奇门、运势 八字直断 + 紫微、卜卦 六爻 + 卜卦占星），并在 warnings 里说明；择日请点名两种择日法。少于两个技法算成就不是合参：cross_validation: false、consistency.all_clear: null，结果里明说。返回合参模板而非终稿——每个技法带一段有上限的正文节选（4000 字，写明其余怎么续读），逐技法结论槽必须绑定该技法真实段落；合参有自己的一条存档，memory_show 打开它会带上各技法结果；convergence 只在多技法独立同判时填；divergence 逐条披露，不许平均、不许只挑一边；口径冲突（consistency.setting_conflicts）必须先声明。
5. 可选云端决策层（TypeSafe Jev · 默认关闭）
上面所有承诺（不联网、不上传）在默认状态下原样成立。v0.39.0 起可以显式开启一个云端「决策层」—— TypeSafe 的 Jev（System One 决策模型，只回类型化的选择/概率，不生成文本）——只做三件窄事：确定性关键词 路由无匹配时兜底选技法；把用户原话里明说的设置（如「我老婆的八字」→ 性别女）变成「已提供」 （词表证据 + 模型判定 + 置信阈值三钥齐才填，永不替用户选默认）；六壬问题的占断门类分类。它不算盘、不解盘。
项 | 说明 |
开关 |
|
离机的数据 | 一档 |
不离机的数据 | 出生日期、时刻、坐标、地名原值；盘面与导出全文（一档）；密钥；本地记忆 |
残余风险（认不出的写法会原样离机） | 不经引导词、单独出现的人名（「我老公李雷」「王小明 1990…」里的名字）；地名库里没有、也不带 省/市/县/区/镇/乡/村 后缀的地名（如「台中」「九龙」）、小区 / 单位 / 学校名、不带门牌号的街道；不带单位的汉字数字（「三十五」）。过度替换也有：与地名同字的普通词偶尔变成 |
服务商事实 | 托管闭源模型，美国机房；「不用于训练」是合同承诺（非架构保证）；数据留存无公开数字，零留存仅企业版 |
每次自陈 |
|
权限边界 | 代码持有权限：确定性路径永远是权威； |
本地记忆与报告
本地数据默认写入 ~/.horosa-skill/（Windows：%APPDATA%/HorosaSkill/）。每次 run 沉淀：run 元信息、tool call 记录、entity 索引、JSON artifact、run manifest、原始 query_text、用户问题、AI 最终回答与可选结构化回答。
SQLite 全文检索（trigram，中文子串可命中，繁简互通，空格分开的词都要中）+ 热路径索引 + WAL 并发；按人名（命主档案的别名也算）/ 技法（键、MCP 名、中文名）/ 日期区间 / 全文组合检索，支持分页。搜的是问题、答案、技法、人名与盘面正文，不搜路径与 JSON 键。想按人找回，起盘时带
name（当事人）或profile；after/before只给日期就是那一整天（按zone，缺省本机时区），「昨天」这类写法会被拒收并给出可用写法。删除与导出（只在命令行）：
horosa-skill memory delete --entity 妈妈（或--run-id …/--before 2026-01-01）先列出会删的记录，加--yes才删库里的行、检索条目、产物与 manifest；已经交付的报告文件只列出、不删。horosa-skill memory export --entity 妈妈 --out <空文件夹>导出成人能直接读的文件夹（index.md+ 每条一个run.md、manifest、产物与报告副本）。删除命主档案不会连带删存档，结果会告诉你还有几条记录提到这个人、用哪条命令删。记忆库坏了不丢记录：数据库只是
runs/里产物文件的索引。坏库被隔离为memory.db.corrupt-<时间>.bak（永不自动删除）后会照产物自动重建；horosa-skill memory rebuild随时可以手动重建（只增不删，--sweep另清崩溃留下的临时文件与空记录），memory query与doctor会提醒还有没进库的记录。report_render生成 DOCX / PDF / JSON：Markdown 表格渲染为真 Word 表格（跨页重复表头）、导航大纲、目录、页码、中文字体，异常自动降级保全文。report technique生成技法依据报告（机器元数据），与咨询报告（AI 终稿）分轨，互不混入。完整排盘报告：
report render --style chart（或report_render {style:"chart"}）不经 AI 解读，直接把该技法的全部盘面段落排成 PDF / DOCX——封面、基本信息、盘图（星盘轮 / 合盘双圈 / 紫微十二宫 / 奇门九宫 / 六壬天地盘 / 六爻卦图 / 太乙十六宫 / 七政四余方盘 / 南印方盘 / 量化盘 90° 度盘；择日结果画选中时刻的盘；全部取自引擎数据；西洋盘、合盘、紫微、七政四余、太乙、大六壬、六爻、90° 度盘、金口诀、宿占、巴比伦、飞宫、米雄双黄道、坚七政、策天、演禽直接用星阙 app 自己的绘图代码画；奇门、南印、八字、地占、小六壬、小成图、轨策、灵棋、五兆、一掌经、统摄法、三式合一照 app 的版式与配色重画，天文地图直接用 app 的地图代码，配色、星体符号与 app 一致）、可点击目录与书签、「第 N 页 / 共 M 页」、技法依据附录。自备知识库：把自己的笔记（
.md/.markdown/.txt文本文件；PDF、Word、JSON、没有扩展名的文件和隐藏文件不读，knowledge mine的not_indexed与检索结果的warnings会按原因和扩展名列出来，另存成 .md 或 .txt 即可）放进horosa-skill knowledge mine列出的文件夹（或knowledge add <名> --file …），计算时传knowledge:["条目名", "#标签", "auto"]，选中的正文随结果挂在data.knowledge_context供 AI 参考（不进引擎、不改盘面；总字数受HOROSA_USER_KNOWLEDGE_MAX_CHARS限）。GBK / UTF-16 文件也能读，读不了的在knowledge mine的problems里写明原因；删除与覆盖先进回收站（knowledge trash/knowledge restore）；运行存档只记引用、不存笔记正文；runtime uninstall --purge-data默认保留知识库。检索：horosa_knowledge_search/horosa-skill knowledge search "词"（两字词即可、繁简互通，标出处行号）；长笔记计算时只带与本盘相关的段落。笔记原文（检索摘要、精读正文、knowledge_context）一律标untrusted: true、夹在固定的中英双语围栏之间，AI 只当参考资料、不当指令。检索问句按知识库自己的词表切词，常用英文术语（primary direction → 主限法、solar return → 太阳返照…）换成中文再搜，零命中时给近似词。可选向量检索（换了说法也能找到）：setup --client <客户端> --vectors——把依赖（约 128 MB）装进客户端起 server 的环境、下载并校验 24 MB 的 bge-small-zh 模型、向量化笔记，全部验证通过才写配置；连不上 Hugging Face 时设HF_ENDPOINT=<镜像>（内容有 sha256 把关）。之后重跑setup会沿用，--no-vectors关闭。.mcpb一键包不带这些依赖，要用向量请走setup --client claude-desktop --vectors。
uv run horosa-skill knowledge add 八字/滴天髓笔记 --file ./notes.md --techniques bazi_birth --tags 古籍
uv run horosa-skill knowledge mine
uv run horosa-skill knowledge trash # 删除 / 覆盖下来的旧版，可 restoreuv run horosa-skill memory query # 按 tool / entity / run_id / 全文 检索
uv run horosa-skill memory show <run_id> # 精确回看某次完整调用项目结构
仓库分为三层，兼顾「代码仓库轻量、Release 资产完整、本地运行离线」：
层 | 位置 | 作用 |
公开仓库层 | GitHub repo | 代码、文档、CLI、MCP、测试、示例、打包脚本 |
打包输入层 |
| 构建离线 runtime 的大体积输入（不进 Git 历史） |
用户运行层 |
| 用户安装后本地执行算法的 runtime |
奇门 / 太乙 / 金口诀（及三式合一中的奇门 + 太乙）走星阙 ken 后端；14 路神数走 chart 服务上挂载的 kentang 引擎；结果由 headless JS 层重排为 aiExport.js 段结构，与星阙桌面端逐值同源。配套阅读：Offline Runtime Releases · Runtime Manifest Spec · Repo Layout。
质量与验证
检查项 | 结果 |
可调用工具 | 114 / 114 |
工程测试 | 6661 / 6661 pass（离线 CI 形状：契约 + 导出 fixture + node JS golden；另 204 项 live 集成测试需本地 runtime，服务未起时自动 skip） |
未确认参数时强制追问 | 104 个技法工具触发 |
免闸直读 | 10 个注册表 / 知识 / 解析类工具不经澄清闸 |
星阙式导出结构 | 每个业务技法均带 |
技法依据卡 | 每个起盘技法的响应附 |
知识库 | 31 域；技法操作手册 243 条逐条带出处（生成器幂等，随上游版本重收割） |
HorosaBench | 120 条基准用例与工具注册表锁步 + 盘面事实忠实性评测（喂错盘 / 诱导复述判红的对抗用例全过） |
本地 memory / report | 每次技法调用写 1 条本地 run 记录 + 1 份 JSON artifact |
GitHub CI | Linux 单测 + JS golden 自检 + Windows OpenClaw smoke（不覆盖跨树上游校验——那两闸需要上游 checkout，只能在维护机跑 |
Release runtime | macOS (arm64) + Windows (x64) 随每个 release 打包并校验（本仓版本 |
第一次 clone 后确认非空壳的最小验证：
cd horosa-skill && uv sync && uv run horosa-skill install
uv run horosa-skill doctor # 期望 issues: []
uv run pytest -q # 6661 passed（live 集成测试在服务未起时 skip）
uv run python scripts/run_full_self_check.py --rounds 1 # 全工具调用 / 导出 / 落库 / 检索 / dispatch 汇总WARNING
审计推运 / 神数类工具时不要只看短预览——其正文通常先写本命盘再写返照 / 推运 / 流年 / 主限表格，只截前若干字符可能只看到本命盘。应打开完整 artifact，按export_snapshot.sections 逐段检查。详见 docs/EXPORT_AUDIT_GUIDE.md。
文档
文档 | 内容 |
架构设计 | |
每个工具的输入契约（必填字段） | |
输出 / envelope / export 数据契约 | |
推运类导出的逐段审计方法 | |
运维 · 评测体系（HorosaBench / 忠实性） | |
离线 runtime 打包与发布 | |
逐版本经验台账 · 领域名词表 | |
AI 客户端行为策略源 · Agent 总规则与路由 |
致谢与许可证
奇门遁甲 / 太乙神数 / 金口诀（及三式合一中的奇门 + 太乙）的盘面，由 kentang2017 开源的三个 Python 引擎计算，随离线 runtime 一起分发：
kinqimen（奇门遁甲）— MIT — https://github.com/kentang2017/kinqimen
kintaiyi（太乙神数）— MIT — https://github.com/kentang2017/kintaiyi
kinjinkou（金口诀）— MIT — https://github.com/kentang2017/kinjinkou
上述三个 ken 引擎为第三方 MIT 组件。本仓库其余术数实现——统摄法、十年大运，以及奇门 / 太乙 / 金口 / 大六壬 / 星盘 / 推运 / 卜卦 / 择日 / 神数等的 aiExport.js 格式化与 headless 适配——均为星阙自有算法，按根目录 GNU AGPL-3.0-only 授权。传统术数体系本身（京房八宫、希腊十年星限等）属公共知识，不构成第三方版权。
玄学工具，本地优先，掌握在你自己手里。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
ActivityActive
ResponsivenessUsually handled
Related MCP Connectors
78 astrology calculations, Tarot, symbolic readings and Vedic calendars via two scoped MCP tools.
Professional Vedic astrology tools for AI agents via MCP.
Real astrology for AI agents: cosmic weather, synastry, timing, astrocartography, and divination.
Real-time planetary signal engine and Model Context Protocol (MCP) server for autonomous AI agents.
Related MCP Servers
- AlicenseAqualityCmaintenanceAstrology MCP server that computes natal charts, transits, synastry, progressions, returns, eclipses, retrogrades, and moon phases from a real ephemeris, enabling AI agents to provide accurate astrological calculations without hallucination.1275 npm1MIT
- FlicenseNot gradedqualityBmaintenanceEnables Claude and other MCP clients to compute Vedic astrology chart facts locally with a private Swiss Ephemeris engine — positions, divisional charts, dashas, transits, Shadbala, Ashtakavarga, Jaimini analysis, birth-time sensitivity, and PDF-ready structured reports. All calculation runs on the user's own machine, keeping birth data local while the interpretation layer reasons over validated chart facts rather than inventing them.-
- AlicenseAqualityBmaintenanceEnables AI agents to compute natal charts, horoscopes, synastry, transits, Vedic kundli, panchang, tarot, numerology and other insight domains through 258+ typed tools, hosted as Remote MCP over Streamable HTTP or run locally over stdio with one key.39439 npmMIT
