AsianSeeker - Openclaw FortuneTeller

核心功能

Mingli（命理）是一款整合四大命理体系的综合占卜工具，涵盖：

• 西方占星：基于 Kerykeion 生成本命盘（宫位、相位、交点），支持行运推运
• 八字四柱：计算天干地支、五行、日主强弱，融合东西方星座对照
• 生命灵数：LifePath、挑战数、高峰数、个人周期等完整数命分析
• 易经占卜：六十四卦随机或手动起卦，含动爻变卦与 SPARK 解读

显著优势

1. 多源校验：Kerykeion 失败时自动 fallback 至 astronomyapi.com，双重保障
2. 自动化交付：通过 cron 定时推送至 Telegram，无需手动触发
3. 全本地化计算：除天文 API 外，所有脚本仅依赖 Python 标准库，零外部依赖风险
4. 灵活交互：支持即时查询、暂停/恢复/修改推送时间等完整生命周期管理

潜在局限

• 占星宫位计算依赖 Kerykeion 库，若持续失败则降级为无宫位的行星位置
• astronomyapi.com 需注册获取 App ID/Secret，存在 API 配额限制
• 所有解读依赖 LLM 生成，非专业命理师人工批断，深度有限
• 八字未涉及大运流年排盘，功能偏基础

适合人群

• 对命理学有兴趣的日常参考者
• 希望自动化获取每日运势的 Telegram 用户
• 需要快速起卦决策的易经爱好者
• 东西方占星文化交叉学习者

风险提示

• 心理依赖风险：每日推送可能强化占卜依赖心理，建议明确标注"娱乐参考"
• 隐私敏感：需收集精确出生时间、地点及 Telegram 聊天 ID
• API 稳定性：astronomyapi.com 为第三方服务，存在服务中断或计费变更可能
• 解读偏差：LLM 生成的命理解读缺乏专业资质背书，重大决策不应依赖

核心用法

Mingli（命理）是一款融合东西方四大命理体系的综合性运势助手，支持：

• 西方占星：基于Kerykeion库计算本命盘（Placidus宫位、精确相位、南北交点）及行星过境
• 八字/四柱：计算日元天干、五行强弱、十神关系
• 数字命理：LifePath生命路径、生日数、态度数、挑战数、巅峰周期、个人年/月/日周期
• 易经占卜：六十四卦随机起卦或手动输入，含变卦解析与SPARK摘要

使用流程分四步：首次Setup录入出生数据与Telegram配置 → 系统生成Daily定时任务 → 用户可On-demand即时查询 → I Ching独立占卜模式。所有计算脚本均为Python本地执行，仅行星位置数据需调用astronomyapi.com，支持Kerykeion故障时自动降级。

显著优点

1. 系统整合度极高：单一入口同时输出四大体系解读，避免用户跨平台切换
2. 自动化交付：Cron定时推送至Telegram，符合现代异步信息消费习惯
3. 数据主权明确：出生数据本地存储（~/clawd/memory/），无云端持久化，符合GDPR数据最小化原则
4. 技术栈透明：纯Python标准库+kerykeion，无黑盒模型依赖，计算逻辑可审计
5. 鲁棒性设计：三级降级机制（Kerykeion → API → LLM知识库），确保服务连续性

潜在局限

• 占星精度边界：宫位计算依赖出生时间精确度，误差15分钟可能导致上升星座偏移；极地地区Placidus宫位可能出现异常
• API单点依赖：astronomyapi.com为唯一外部数据源，免费套餐有调用限制（1000次/日）
• 文化语境局限：八字十神、易经卦辞的英文/越南语翻译可能损失古典 nuances
• 无交互式解盘：当前为文本推送模式，不支持用户追问式深度解读
• 加密存储缺失：用户数据明文存储，本地设备若被入侵存在泄露风险

适合人群

• 对命理学有基础兴趣、希望系统对比不同体系解读的文化探索者
• 追求自动化日常仪式感、偏好Telegram异步接收信息的效率型用户
• 重视数据隐私、不愿将出生信息提交至商业占星平台的隐私敏感者
• 已具备一定命理知识、能自主判断算法输出质量的进阶爱好者

常规风险

| 风险类别 | 等级 | 说明 |

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

| 心理暗示依赖 | 中 | 每日运势可能强化确认偏误，建议明确标注娱乐性质 |

| 出生时间误差 | 低 | 用户可能误报出生时间，导致全盘计算偏差 |

| API密钥泄露 | 低 | 环境变量读取虽安全，但共享设备仍存在泄露可能 |

| 跨文化误读 | 低 | 易经/八字术语的机器翻译可能造成误解 |

使用建议：将该Skill视为文化探索工具而非决策依据；首次使用时尽量核实出生时间（可查询出生医学证明）；定期检查horoscope-users.md文件权限。