Grupo Venus — 免费星盘与流年运势 API 接入
Grupo Venus 是一个非官方的技能接口，用于调用阿根廷经典占星平台 grupovenus.com 的免费服务层。该技能允许用户通过程序化方式获取本命星盘图像、一年期外行星流年运势图（Saturn–Pluto）、配对合盘报告及多种解读文本，无需 API 密钥，完全基于会话 Cookie 和表单 POST 机制。
核心用法
1. 人员注册与坐标获取：通过三步骤会话流程（info.asp → personas.asp?nue → POST ciuda.asp）向服务器注册出生信息，解析返回的 d0 Cookie 获取时区偏移、经纬度（度分秒转十进制）。需特别注意 ISO-8859-1 编码要求，西语重音字符（如 í/á）必须使用 Latin-1 百分编码（%ED/%E1），UTF-8 编码会导致城市识别失败。
2. 星盘图像生成：调用 dibujo.aspx 端点，传入出生日期、时区、经纬度等参数，直接返回 PNG 格式的本命盘图像，支持热带/恒星黄道切换。
3. 流年运势解析：POST 至 informes3.asp，使用 INFORMEDESEADO=8 获取一年期外行星流年图（免费层级最丰富的数据集，涵盖 Saturn、Uranus、Neptune、Pluto 对 10 个本命点的全部相位）。响应 HTML 中 <img class="barras"> 元素的 title 属性包含精确日期和容许度， bar 高度（1–55）可作为相位强度代理指标。
4. 配对合盘：在 nombre 参数中用 | 分隔两人数据，调用 INFORMEDESEADO=16/17 获取伴侣/友谊合盘报告。
5. transit 解读文本：通过 sacainter.asp 获取三种风格的相位解读——技术古典（tratsp）、潜能灵性（starsolues）、日常口语（transiaw），全部免费且无需认证。
显著优点
- 零成本入门：无需注册账号或 API 密钥，利用平台公开的免费层级即可获得专业级占星数据。
- 数据维度丰富：
INFORMEDESEADO=8的一年期外行星流年覆盖所有慢行星对日月水金火木天升天顶的相位，每 2 天一个数据点，含精确 peak 日期和容许度。 - 多风格解读：同一相位可获取技术、灵性、口语三种解读，适配不同用户需求。
- 可视化输出：直接生成 PNG 星盘图，便于展示和存档。
- 本地人员管理：通过
~/.openclaw/workspace/memory/grupo-venus.json本地存储多人档案，支持会话式对比分析。
潜在缺点与局限性
- 非官方与稳定性风险：技能非 Grupo Venus 官方提供，平台随时可能更改端点、增加验证或关闭服务。无 SLA 保障。
- 复杂的会话管理：注册流程必须使用 Cookie Jar 三步骤，手动处理 ASPSESSION Cookie 会导致 "session expired" 错误。Referer 头严格校验，任何跳过都会导致失败。
- 编码陷阱：POST 数据强制 ISO-8859-1，现代工具默认 UTF-8，极易导致坐标获取错误（城市字段为空）而不报错。
- 免费层级限制：一年期流年仅限未来日期（
DIA1/MES1/ANO1 ≥ today），回溯历史需付费 Ticket；完整本命盘报告、部分合盘解读也为付费内容。 - HTML 解析依赖：所有数据嵌套在 HTML 属性和标签中，无结构化 JSON 返回，解析脆弱，页面微调即可能破坏提取逻辑。
- 安全与隐私：出生数据通过 HTTP（非 HTTPS 强制）传输，虽文档未明确说明，但 2025 年仍使用 HTTP 平台存在中间人风险。个人敏感信息（精确出生时间、地点）存储于本地明文 JSON。
适合人群
- 占星爱好者与学习者：希望程序化探索本命盘和流年运势，不满足于现成 App 的固定解读。
- 技术型用户：具备 curl、正则提取、编码转换能力的开发者，能处理复杂的会话流和 HTML 解析。
- 西班牙语/英语用户：平台原生支持西/英/法三语，解读文本质量以西语最佳。
- 轻量级咨询场景：占星师希望快速生成图表和 transit 时间窗口，辅助人工解读。
常规风险
- 服务中断：依赖单一第三方平台，无备用方案。
- 数据解析失效：HTML 结构调整导致正则提取失败，需持续维护适配。
- 时区与坐标错误：编码或 DMS/十进制转换错误会导致星盘偏差，用户需自行校验。
- 隐私泄露：本地存储的出生数据若环境共享可能被访问；网络传输无明确加密说明。