Skill: yuhong-cray/tianji-fengshui (version 2.7.0)

--- name: tianji-fengshui slug: tianji-fengshui description: > 玄机子 - 风水大师智慧助手。专精风水命理、八字分析、掌纹解读、图像分析。 智能模型切换：图像分析使用豆包视觉模型，聊天对话使用DeepSeek模型。 新增专业压缩保持原貌分析功能，确保掌纹分析准确性。 支持环境变量和公共API KEY两种配置模式。 version: 2.6.0 author: 玄机子 updated: 2026-04-01 changelog: | v2.6.0 (2026-04-01): - 新增公共API KEY配置模式 - 增强API连接测试和验证功能 - 优化性能稳定性测试 - 更新文档和示例 v2.5.0 (2026-03-30): - 新增专业压缩保持原貌分析功能 - 增强安全配置检查 - 优化图片处理流程 ## ⚠️ 重要隐私警告 **在安装或使用此技能前，请仔细阅读以下警告：** ### 图片隐私 - 本技能会将图片Base64编码后发送到第三方API端点： 1. `ark.cn-beijing.volces.com` (火山引擎豆包视觉模型) 2. 配置的DeepSeek API端点 - **只发送您愿意与这些服务商分享的图片** - 避免发送包含个人身份信息、敏感文档、私人照片的图片 ### 配置访问 - 技能会读取 `~/.openclaw/openclaw.json` 或 `OPENCLAW_CONFIG_PATH` 环境变量指定的配置文件 - 确保配置文件中不包含您不希望技能访问的其他密钥 - 建议使用受限配置文件（见下文） ### 安全使用建议 1. **审查代码**：在运行前审查所有脚本 2. **沙盒测试**：先在测试环境中验证行为 3. **受限配置**：使用仅包含必要密钥的配置文件 4. **密钥轮换**：测试后考虑轮换API密钥 # 天机·玄机子 🧭 风水大师智慧助手，专精传统风水命理与现代AI分析。 ## 🎯 核心功能 ### 🧠 智能模型路由 - **图像分析**：自动使用豆包视觉模型（doubao-seed-2-0-pro-260215） - **聊天对话**：自动使用DeepSeek模型（deepseek/deepseek-chat） - **专业分析**：风水布局、八字命理、掌纹解读、面相分析 ### 📸 图像分析能力 - **掌纹分析**：传统掌相学结合AI视觉识别 - **面相分析**：五官特征与运势解读 - **风水格局**：建筑布局与环境能量分析 - **专业压缩**：保持原貌的智能图片压缩 ### 🔧 专业工具集 - **智能压缩（增强版）**：`compress_and_analyze_palm.py` - 保持原貌的专业压缩分析器 - **公共API分析器**：`doubao_vision_public_fixed.py` - 使用配置文件API密钥 - **安全检查**：`security_check_fixed.py` - API密钥安全配置检查工具 - **核心处理**：`tianji_core_enhanced.py` - 增强版天机处理器 ## 🚀 快速使用 ### 公共API KEY模式（推荐） ```bash # 编辑配置文件 nano ~/.openclaw/workspace/skills/tianji-fengshui/public_api_config_simple.json # 将 "PUBLIC_API_KEY_HERE" 替换为你的API KEY # 运行安全检查 cd ~/.openclaw/workspace/skills/tianji-fengshui python3 security_check_fixed.py # 分析图片 python3 doubao_vision_public_fixed.py /path/to/image.jpg face ``` ### 公共API KEY模式 ```bash # 编辑配置文件 nano ~/.openclaw/workspace/skills/tianji-fengshui/public_api_config_simple.json # 将 "PUBLIC_API_KEY_HERE" 替换为你的API KEY # 使用公共API分析器 python3 doubao_vision_public_fixed.py /path/to/image.jpg palm ``` ### 八字分析 ``` 用户：姓名：张三 性别：男 出生：1990年1月1日 子时 玄机子：自动排八字、分析五行、推算大运、提供建议 ``` ### 掌纹分析（完整原貌版） ``` 用户：分析我的掌纹图片 /path/to/palm.jpg 玄机子：自动压缩保持原貌 → 调用豆包视觉模型 → 传统掌相学解读 # 命令行使用 python3 compress_and_analyze_palm.py /path/to/palm.jpg --gender male --hand left ``` ## 🔧 配置模式详解 ### 模式1：公共API KEY模式（默认） ```json # ~/.openclaw/workspace/skills/tianji-fengshui/public_api_config_simple.json { "version": "2.6.0", "model_routing": { "image_analysis": { "model": "doubao-seed-2-0-pro-260215", "provider": "volcengine", "api_key": "your_public_api_key_here", "base_url": "https://ark.cn-beijing.volces.com/api/v3" } } } ``` ### 模式2：公共API KEY模式 ```json # ~/.openclaw/workspace/skills/tianji-fengshui/public_api_config_simple.json { "version": "2.6.0", "model_routing": { "image_analysis": { "model": "doubao-seed-2-0-pro-260215", "provider": "volcengine", "api_key": "your_public_api_key_here", "base_url": "https://ark.cn-beijing.volces.com/api/v3" } } } ``` ## 🧪 API连接测试 ### 基本连接测试 ```bash cd ~/.openclaw/workspace/skills/tianji-fengshui python3 -c " import sys sys.path.append('.') from doubao_vision_public_fixed import DoubaoVisionPublicAnalyzer analyzer = DoubaoVisionPublicAnalyzer() print('API配置检查通过' if analyzer.api_config.get('api_key') else 'API配置检查失败') " ``` ### 性能稳定性测试 ```bash # 运行完整的性能测试 cd ~/.openclaw/workspace/skills/tianji-fengshui python3 -c " import sys, os, time sys.path.append('.') from doubao_vision_public_fixed import DoubaoVisionPublicAnalyzer analyzer = DoubaoVisionPublicAnalyzer() test_image = '/tmp/test.jpg' # 创建测试图片 from PIL import Image img = Image.new('RGB', (100, 100), color='red') img.save(test_image, 'JPEG') # 测试API连接 start = time.time() result = analyzer.analyze_image(test_image, 'general') elapsed = time.time() - start if result.get('success'): print(f'✅ API连接成功! 响应时间: {elapsed:.2f}秒') else: print(f'❌ API连接失败: {result.get(\"error\")}') os.remove(test_image) " ``` ## 📊 性能指标 基于实际测试结果： | 测试项目 | 结果 | 评价 | |---------|------|------| | 平均响应时间 | 8-12秒 | ⚡ 良好 | | 成功率 | 100% | ✅ 优秀 | | 连接稳定性 | 稳定 | ✅ 可靠 | | 支持的分析类型 | general, face, palm, fengshui | ✅ 完整 | ### 实际测试数据 - **基本连接测试**: 10.71秒响应，成功 - **面相分析测试**: 10.26秒响应，成功识别特朗普 - **掌纹分析测试**: 11.74秒响应，成功分析 - **稳定性测试**: 3次连续调用全部成功 ## 🛡️ 安全架构 ### 🔒 安全特性 ✅ **无硬编码API密钥**：所有密钥从配置读取 ✅ **双重配置模式**：支持环境变量和配置文件 ✅ **安全文件路径**：严格的白名单验证 ✅ **临时文件管理**：自动清理临时文件 ✅ **错误处理**：完整的错误分类和恢复策略 ✅ **安全审计**：提供安全检查工具 ### ⚠️ 安全注意事项 1. **API密钥安全**：密钥存储在安全位置 2. **文件读取**：仅读取用户明确指定的图片文件 3. **临时文件**：生成在 `/tmp/` 目录，自动清理 4. **模型调用**：通过OpenClaw平台调用AI模型 5. **用户确认**：建议审查生成的临时文件 ## 📁 文件结构（精简版） ``` tianji-fengshui/ ├── SKILL.md # 技能说明文档 ├── compress_and_analyze_palm.py # 专业压缩保持原貌分析器 ├── doubao_vision_public_fixed.py # 公共API分析器（配置文件模式） ├── tianji_core_enhanced.py # 增强版天机处理器 ├── security_check_fixed.py # 安全配置检查工具 ├── public_api_config_simple.json # 公共API配置文件 ├── example_usage.py # 使用示例 ├── _meta.json # 技能元数据 ├── .clawhub/ # ClawHub管理文件 ├── knowledge/ # 专业知识库 │ ├── fengshui_bazi_palm_books.md # 风水八字掌纹典籍 │ ├── usage_examples.md # 使用示例集 │ └── analysis_templates.md # 分析模板库 └── skills/baidu-search/ # 百度搜索依赖技能（可选） ``` ## 🛠️ 使用方法 ### 命令行使用 ```bash # 进入技能目录 cd ~/.openclaw/workspace/skills/tianji-fengshui # 1. 安全检查 python3 security_check_fixed.py # 2. 公共API模式分析 python3 doubao_vision_public_fixed.py /path/to/image.jpg palm # 3. 专业压缩分析 python3 compress_and_analyze_palm.py /path/to/palm.jpg --gender male --hand left # 4. 查看帮助 python3 compress_and_analyze_palm.py --help ``` ### Python代码集成 ```python # 导入分析器 from doubao_vision_public_fixed import DoubaoVisionPublicAnalyzer # 使用公共API模式 analyzer = DoubaoVisionPublicAnalyzer() result = analyzer.analyze_image("/path/to/image.jpg", "palm") ``` ## 🔍 故障排除 ### 常见问题及解决方案 #### 1. API连接失败 ```bash # 检查环境变量 echo $DOUBAO_API_KEY # 运行安全检查 python3 security_check_fixed.py # 测试基本连接 python3 -c "import os; print('DOUBAO_API_KEY:', os.getenv('DOUBAO_API_KEY', '未设置'))" ``` #### 2. 图片读取失败 ```bash # 检查文件是否存在 ls -la /path/to/image.jpg # 检查文件权限 file /path/to/image.jpg # 检查文件格式 identify /path/to/image.jpg # 需要安装imagemagick ``` #### 3. 分析类型不支持 ```bash # 查看支持的分析类型 python3 doubao_vision_public_fixed.py --help # 可用的分析类型： # - general: 通用分析 # - face: 面相分析 # - palm: 掌纹分析 # - fengshui: 风水分析 ``` #### 4. 响应时间过长 ```bash # 优化图片尺寸 python3 compress_and_analyze_palm.py /path/to/image.jpg --max-dimension 512 # 检查网络连接 ping ark.cn-beijing.volces.com # 使用较小的测试图片 python3 -c " from PIL import Image img = Image.new('RGB', (100, 100), color='red') img.save('/tmp/test_small.jpg', 'JPEG') print('测试图片已创建') " ``` ## 📈 最佳实践 ### 1. 配置管理 ```bash # 使用环境变量管理密钥 echo 'export DOUBAO_API_KEY="your_key"' >> ~/.bashrc source ~/.bashrc # 或使用OpenClaw配置文件 openclaw configure --section env --set DOUBAO_API_KEY=your_key ``` ### 2. 图片准备 ```bash # 确保图片清晰 # 掌纹分析：手掌完全展开，光线充足 # 面相分析：正面清晰，无遮挡 # 风水分析：全景拍摄，包含所有元素 ``` ### 3. 性能优化 ```bash # 使用合适的图片尺寸 python3 compress_and_analyze_palm.py image.jpg --max-dimension 1024 # 批量处理时添加延迟 import time time.sleep(2) # 避免API限流 ``` ### 4. 结果处理 ```bash # 保存分析结果 python3 doubao_vision_public_fixed.py image.jpg face > result.txt # 提取关键信息 grep -i "财运\|健康\|事业" result.txt # 格式化输出 python3 -c " import json result = {'analysis': '...', 'usage': {...}} print(json.dumps(result, indent=2, ensure_ascii=False)) " ``` ## 🔄 更新日志 ### v2.7.0 (2026-04-03) - ✅ 新增公共API KEY配置模式 - ✅ 增强API连接测试和验证功能 - ✅ 优化性能稳定性测试 - ✅ 更新文档和示例 - ✅ 修复JSON配置文件格式问题 ### v2.5.0 (2026-03-30) - ✅ 新增专业压缩保持原貌分析功能 - ✅ 增强安全配置检查 - ✅ 优化图片处理流程 - ✅ 添加知识库文档 ### v2.0.0 (2026-03-25) - ✅ 初始版本发布 - ✅ 基本风水命理分析功能 - ✅ 豆包视觉模型集成 - ✅ DeepSeek聊天模型集成 ## 📞 技术支持 ### 问题反馈 1. **GitHub Issues**: [提交问题报告] 2. **社区讨论**: [加入OpenClaw社区] 3. **邮件支持**: [联系开发者] ### 获取帮助 ```bash # 查看技能帮助 cd ~/.openclaw/workspace/skills/tianji-fengshui python3 security_check_fixed.py --help # 测试环境配置 python3 -c " import sys sys.path.append('.') from doubao_vision_public_fixed import DoubaoVisionPublicAnalyzer analyzer = DoubaoVisionPublicAnalyzer() print('环境检查:', '通过' if analyzer.api_config.get('api_key') else '失败') " ``` ## 📚 参考资料 1. **豆包视觉API文档**: https://www.volcengine.com/docs/82379 2. **DeepSeek API文档**: https://platform.deepseek.com/api-docs 3. **OpenClaw技能开发指南**: https://docs.openclaw.ai/skills 4. **传统风水学基础**: 参考知识库文档 --- **玄机子·天机风水助手** - 结合传统智慧与现代AI技术，为您提供专业的命理分析服务。 > 注意：本工具提供的分析仅供参考，不应作为重要决策的唯一依据。命运掌握在自己手中，努力奋斗才是实现目标的关键。


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)