🔮 循古·算命（八字·每日运势·六爻·大六壬·禄命·大运流年）

循古排盘：传统命理的现代数字化实践

循古排盘（xungu-query）是一款基于禄命古法与子平八字理论开发的命理分析工具，通过对接 cdndns.org 的排盘服务，为用户提供八字命盘打分、当日运势查询及深度命理分析等功能。该工具试图将传统中国命理学的复杂体系转化为可交互的数字服务，在保留"古法"内核的同时降低使用门槛。

核心用法与功能架构

技能采用档案制用户管理：首次使用时需收集出生年月日时、性别、出生地等信息，经用户确认后本地存储于 ~/.openclaw/workspace-jarvis/memory/xungu-users.json，后续查询自动调用档案免重复输入。基础功能包括：

• 八字命盘打分：输出命格评级（如"上上""中平"等）与稳定分
• 每日运势推送：基于日主与流年流月关系生成吉凶提示
• 深度命理解析：贵人方位、用神喜忌、化解建议（需注册 API Token 解锁）

技术实现上，通过 HTTP POST 请求向 cdndns.org 传输出生数据，支持 Bearer Token 认证；代码层面采用精准环境变量读取（ASI03 修复），避免 os.environ.update() 的全量加载风险。

显著优点

1. 理论溯源明确：标榜"禄命古法""子平正宗"，对命理研究者具备文化认同感
2. 隐私设计克制：出生档案仅本地存储，明确声明"删除我的档案"指令可清空数据
3. 渐进式功能开放：基础排盘免费，深度功能需 Token 验证，符合 SaaS 常见模式
4. 中文语境适配：术语体系（八字、大运、流年、用神）贴合目标用户认知

潜在局限与风险

| 维度 | 具体表现 |

|------|---------|

| **来源可信度** | 服务依赖第三方域名 `cdndns.org`，ICP 备案、运营主体信息未披露，长期稳定性存疑 |

| **科学性争议** | 命理预测属于**非实证传统知识体系**，输出结果无统计学验证，存在巴纳姆效应风险 |

| **心理暗示** | 命格评级（如"下下"）可能对敏感用户产生负面心理暗示，缺乏干预机制 |

| **数据跨境** | 未明确说明 cdndns.org 服务器地理位置，出生信息传输存在合规模糊地带 |

| **功能边界** | 免费版功能受限较深，核心解读依赖付费解锁，体验割裂 |

适合人群

• 文化体验型用户：对周易、禄命文化有猎奇或研究兴趣，追求仪式感与符号消费
• 决策辅助型用户：将运势作为日常决策的参考维度之一（需具备批判性思维）
• 命理学习者：希望通过结构化输出理解八字排盘逻辑，作为传统典籍的辅助工具

不推荐：将命理结果作为重大人生决策（婚恋、投资、医疗）的唯一依据；心理脆弱易受暗示者；未成年用户无监护人陪同使用。

常规风险提示

• 出生信息传输至第三方服务器，虽声明 Token 隔离，但无法完全排除服务端数据泄露
• 命理分析结果不具备医学、心理咨询或法律建议效力
• API Token 需自行保管，避免在公共仓库暴露 .env 文件

核心用法

循古查询是一款基于传统禄命古法的八字命理分析工具，主要功能包括：八字命盘打分（分析先天命格并给出评级）、当日运势查询（每日吉凶提示）、命理详细分析（贵人方位、化解建议等高级功能）。用户首次使用时需提供出生日期、性别、出生地点等基本信息，经确认后可选择保存至本地档案以便后续快速查询。

该技能采用「档案记忆」机制：首次查询时提示用户输入信息，确认后自动保存到 ~/.openclaw/workspace-jarvis/memory/xungu-users.json，后续查询无需重复输入。基础功能（命盘评级、基础打分）可免费使用，完整分析需注册获取 API Token。

显著优点

1. 传统文化专业化：基于子平八字、禄命古法等传统命理体系，而非娱乐化算法，满足对正统命理分析有需求的用户
2. 零依赖轻量设计：仅使用 Python 标准库（urllib、json、pathlib、os），无第三方依赖包，降低供应链攻击风险
3. 隐私声明完备：明确标注数据传输范围（ASI07）、凭证隔离机制（ASI03）、档案存储规则（ASI06），用户可主动删除档案
4. 使用门槛低：自然语言触发（"帮我查八字""今日运势"），无需学习复杂指令

潜在缺点与局限性

1. 核心计算依赖外部服务：八字排盘和命理分析完全依赖 cdndns.org 第三方 API，无法离线使用，若服务中断则功能失效
2. 敏感数据外传：出生日期、性别、地点等个人信息必须传输至第三方服务器，该服务商隐私政策不透明
3. 来源可信度受限：T3 级别个人开发者项目，无公开 GitHub 仓库，代码未经社区广泛审查
4. 功能深度受 API 限制：完整分析需付费注册，免费版仅提供基础打分，详细解读（如流年大运、神煞分析）可能受限
5. 科学性质疑：八字命理属于传统文化范畴，非科学验证体系，结果仅供参考

适合的目标群体

• 对中国传统命理文化（子平八字、禄命法、周易）有浓厚兴趣的研究者或爱好者
• 希望获得日常运势参考、心理暗示导向的娱乐型用户
• 需要快速八字排盘工具替代手动查万年历的 convenience 用户
• 愿意接受出生信息外传以换取在线分析服务的非隐私敏感型用户

不适合人群：极度重视个人隐私（不愿外传出生信息）、追求科学验证决策依据的用户、将命理结果作为重大人生决策唯一依据者。

常规风险提示

1. 网络依赖与服务质量：API 响应超时（当前设置 10 秒）、服务商稳定性、域名续费风险均可能导致服务中断
2. 数据安全：TLS 加密传输虽保障传输安全，但 cdndns.org 的数据存储策略、是否留存日志、是否与其他业务共享数据均不明确
3. 本地存储泄露：档案以明文 JSON 存储于本地，多用户设备或系统被入侵时存在泄露风险
4. 凭证管理：API Token 需手动配置于 .env 文件，存在误提交至版本控制或权限配置不当的风险
5. 结果误导风险：命理分析的模糊性可能导致用户过度解读或产生心理暗示，需理性看待