循古排盘：传统命理的现代数字化实践
循古排盘（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文件