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

核心用法

循古八字算命技能基于xungufa.com API，提供传统周易命理分析服务。用户需提供出生日期时间（YYYY-MM-DDTHH:MM格式）、性别（男/女）及可选出生地，系统即可生成八字命盘。核心功能包括：八字排盘与命格评级（显示四柱、先天命格等级、气运稳定分）、每日运势测算（流日吉凶判断、行动指南）、深度命理分析（贵人方位、五行喜忌、运势化解建议）。支持「现代计时」与「古法计时」双体系对比，日柱和时柱可能出现差异，系统会主动提示用户选择其一贯穿使用。

显著优点

1. 双体系融合：同时支持子平八字与禄命古法，满足传统命理爱好者与学术研究者的不同需求
2. 结构化评分：命盘打分与运势量化评级（如「险位」「预警」等），降低玄学理解门槛
3. 本地化档案管理：用户出生信息经确认后存储于~/.openclaw/workspace-jarvis/memory/xungu-users.json，支持「记住我的信息」与「删除我的档案」指令
4. 凭证隔离设计：仅读取XUNGU_API_TOKEN，不加载系统其他环境变量，符合最小权限原则
5. 渐进式功能解锁：基础命盘评级免费开放，完整分析需注册获取Token，商业模式透明

潜在缺点与局限性

1. 数据来源单一：完全依赖第三方平台xungufa.com，若服务中断或变更接口，技能将失效
2. 科学性质疑：八字命理属传统文化范畴，预测结果缺乏科学依据，存在心理暗示风险
3. 敏感信息处理：出生时间、性别、地点等PII数据需传输至外部服务器，虽有HTTPS加密但仍存在泄露可能
4. 功能锁定机制：未注册用户无法查看完整运势解读，体验割裂感明显
5. 古法计时理解门槛：普通用户难以自行判断现代/古法计时哪种更「准确」，系统建议较模糊

适合人群

• 传统文化爱好者与命理研究者
• 对每日运势、流年吉凶有查询需求的用户
• 已接触或信奉周易、八字体系的人群
• 不适合：寻求科学决策依据者、对玄学预测持批判态度者、未成年用户（涉及命运定论可能产生心理影响）

常规风险

• 隐私风险（ASI07）：出生信息外发至xungufa.com，虽声明HTTPS传输但未披露数据保留期限与第三方共享政策
• 心理依赖风险：量化评分可能导致用户过度解读「命格等级」或「运势分数」，影响现实决策
• API凭证泄露：Token存储于本地.env文件，若设备共享或权限配置不当存在泄露风险
• 结果解释权争议：AI生成的「ai_interpretation」解读具有主观性，不同命理流派可能存在分歧

核心用法

循古八字算命 Skill 是一款基于传统禄命古法与禄命法的专业八字排盘工具，集成于循古排盘（xungufa.com）API 服务。用户首次使用时需提供出生日期时间（YYYY-MM-DDTHH:MM 格式）、性别（男/女）及可选出生地点，系统默认采用现代计时法进行排盘分析，返回四柱八字、命格评级（如险位、中位、上等）、命盘稳定评分及 AI 解读。同时支持当日运势查询，包含运程评级、运势分数及行动提示。

核心亮点在于支持现代计时与古法计时双模式对比。当 API 返回 time_method_warning 字段提示差异时，系统会询问用户是否需要以古法重新排盘，并直观展示日柱、时柱等关键差异，帮助用户理解两种命理体系的区别。

用户档案管理采用本地持久化机制：经用户确认后，出生信息自动保存至 ~/.openclaw/workspace-jarvis/memory/xungu-users.json，下次查询无需重复输入，支持主动更新或删除。

显著优点

1. 专业命理体系：采用传统禄命古法，区别于常见的子平八字简化算法，保留古代禄命学核心逻辑，对命理爱好者具有较高参考价值。
2. 双计时法对比：独创现代与古法计时对比功能，直观呈现时辰分界差异对命盘的影响，适合深度命理研究者使用。
3. 零依赖轻量实现：纯 Python 标准库开发（urllib、json、pathlib、os），无第三方依赖包，部署简单，代码透明可审计。
4. 分级功能设计：基础命盘评级与打分免费开放，完整八字分析、每日详细运势需注册获取 API Token，商业模式清晰。
5. 安全凭证隔离：ASI03 合规实现，精确读取 XUNGU_API_TOKEN，不加载其他环境变量，避免敏感信息泄露风险。

潜在缺点与局限性

1. 隐私数据外传：必须将出生日期、性别、出生地等个人敏感信息发送至第三方 xungufa.com 进行分析，存在数据被第三方收集存储的风险，且第三方数据保护能力未知。
2. 本地明文存储：用户档案以未加密 JSON 格式存储于本地，虽便于用户审计，但可能被本地其他程序读取，依赖文件系统权限控制。
3. 功能解锁门槛：完整运势、详细八字分析需注册并配置 Token，免费版体验受限，且未提供第三方服务的 SLA 或可用性保障。
4. 命理科学性存疑：作为传统文化娱乐工具，其预测结果不具备科学依据，用户需理性看待，避免过度依赖。
5. 地域与格式限制：时间格式要求严格（24小时制 ISO 格式），出生地点为可选文本字段，不支持全球时区自动转换。

适合的目标群体

• 命理文化爱好者：对八字、周易、禄命法有研究兴趣，希望获得比简易八字工具更深入的传统命理分析。
• 日常运势查询用户：习惯通过传统命理方式获取每日行动建议与生活参考的人群。
• 古今历法研究者：关注现代计时与古法计时差异，需要对比两种体系下命盘变化的学术或兴趣用户。
• 轻量级工具偏好者：倾向使用无复杂依赖、代码透明、可本地审计的极简工具的用户。

常规使用风险

1. 隐私合规风险：向境外或未明确披露数据处理方式的服务传输敏感个人信息，需用户自行评估是否符合当地数据保护法规（如 GDPR、PIPL）。
2. 数据持久化风险：本地明文档案若被其他应用读取，可能导致个人出生信息泄露；建议定期检查或主动删除不必要的档案。
3. 服务依赖风险：核心功能依赖 xungufa.com API 可用性，若第三方服务中断或变更接口，Skill 将失效，且未提供离线备用方案。
4. API Token 管理风险：用户需自行保管 Token，若泄露可能被他人冒用配额；建议配置于专属环境文件而非共享配置文件。
5. 结果误读风险：命理分析含主观解读成分，AI 生成的运势建议不宜作为重大决策依据，避免产生心理依赖或误导。