Horace-Maxwell/horosa-skill

解决的问题

Horosa Skill 为 AI 代理提供了一个本地优先的接口，使其能够访问 106 种专业占星术和神秘学技术。通过用决定性、本地运行的运行时替代 AI 从内存中尝试计算图表或解释规则的做法，防止 AI 在神秘学解读中产生“幻觉”。

工作原理

该项目作为 MCP（模型上下文协议）服务器和 CLI，将 AI 客户端（如 Claude Desktop 或 Cursor）与无头 JS 引擎以及 Java/Python 后端连接起来。

• 决定性运行时：算法在本地（离线）运行，确保计算结果与专业 Horosa 桌面应用程序完全一致。
• 澄清门控：如果关键参数（时间、位置、时区）缺失，系统会拦截调用，强制 AI 向用户确认，而不是猜测。
• 结构化输出：每个工具返回一个统一的“信封”，包含图表快照和记录了具体规则及版本的“技术卡”。
• 可追溯性：包含一个 31 个领域的知识库，共 408 个引用条目，确保 AI 提供的任何解读都能追溯到特定手册或规则书。
• 忠实度基准测试：一个决定性验证器会将 AI 的解读与实际图表数据进行比对，标记出虚构或矛盾的事实。

适用人群

• 构建专业神秘学或占星术代理的 AI 开发者。
• 希望将专业级、本地优先的占星计算集成到其 LLM 工作流中的 AI 客户端高级用户。
• 在神秘学解读中需要高精度和可追溯性的从业者。

主要亮点

• 106 项集成技术：涵盖西方占星术、中国神秘学（八字、紫微、奇门等）以及 14 种“神数”（神数）。
• 本地优先且离线运行：所有计算都在用户设备上完成，数据不会上传至云端。
• MCP 兼容：可轻松集成到 Claude Code、Claude Desktop、Cursor 和 Open WebUI 中。
• 防幻觉套件：结合澄清门控、引用知识库和忠实度评估器，确保 AI 的准确性。
• 多技术综合分析：horosa_hecan 工具支持并行执行多个技术，比较结果并明确披露差异。