---
slug: fortune-reading-studio
name: fortune-reading-studio
version: "1.0.1"
displayName: "赛博命理师"
summary: "一人开命理工作室,8种命理体系排盘+AI深度解读,9.9到99元全价位变现。赛博命理师是一款面向命理咨询从业者的AI命理解读工具. 支持8种命理体系排盘、AI深度解读生成报告、安全交付与运势"
summary_zh: "一人开命理工作室,8种命理体系排盘+AI深度解读,9.9到99元全价位变现。赛博命理师是一款面向命理咨询从业者的AI命理解读工具. 支持8种命理体系排盘、AI深度解读生成报告、安全交付与运势"
license: "MIT"
description: |-
  赛博命理师是一款面向命理咨询从业者的AI命理解读工具.
  支持8种命理体系排盘、AI深度解读生成报告、安全交付与运势引流,9.9到99元全价位变现.
  核心能力:
  - 8种命理体系全覆盖
  - AI深度解读生成报告
  - 敏感词审核与合规
  - 安全报告交付与运势内容引流
homepage: ""
tags:
  - 命理咨询
  - 内容变现
  - 副业工具
  - AI解读
  - 工具
  - 效率
  - 通信
  - 邮件
  - 写作
  - type
  - llm
  - api
  - 不适用
tools:
  - read
  - exec
  - write
category: "Automation"
---
# 赛博命理师 Cyber Fortune Teller

赛博命理师,基于命理排盘引擎支持8种命理体系,AI深度解读生成专业命理报告,支持报告交付与运势摘要生成.
## 付费版专享能力

| 能力 | 免费版 | 付费版 |
|---|---|---|
| 基础功能 | 支持 | 支持 |
| 高级参数配置与自定义规则 | 不支持 | 支持 |
| 批量任务编排与队列管理 | 不支持 | 支持 |
| 结果导出与多格式转换 | 不支持 | 支持 |
| 实时状态监控与异常告警 | 不支持 | 支持 |
| 历史记录回溯与差异对比 | 不支持 | 支持 |

## 核心能力

1. **8种命理体系全覆盖**:八字排盘(四柱+大运流年)/紫微斗数(12宫+108星+四化)/塔罗占卜(抽牌+解读)/梅花易数(起卦+断卦)/六爻(排卦+分析)/奇门遁甲(天地人神四盘)/西方占星(星盘+流运)/黄历查询(宜忌),定价9.9-99元全价位覆盖
2. **AI深度解读生成报告**:排盘数据+用户信息组合为LLM提示词,每种type有专属角色名+结构化输出格式+免责声明,输出800-1500字命理报告(含事业/感情/财运/健康四维度)
3. **敏感词审核与合规**:检测报告内容中的封建迷信敏感词,自动替换为心理学术语(例:"命中注定"→"性格倾向"),添加免责声明,定位为"心理娱乐"服务确保合规
4. **安全报告交付**:报告保存为文件→上传文件存储→生成安全分享链接(随机6位密码+3天有效期)→通过电商平台消息发送→事后验证发货结果,全链路闭环
5. **运势内容引流**:生成50字运势摘要(含今日运势+幸运色/数字),发布到社交平台引流,格式"[星座/生肖]今日运势 | [50字摘要] | #运势 #今日运势"
#
## 快速开始

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

> 详细的输入输出格式请参考下方章节说明。

## 适用场景

| 场景 | 输入 | 输出 | 是否适用 |
|:-----|:-----|:-----|:-----|
| 电商命理服务自动接单 | 出生信息+type命理体系+order_id | 命理报告+安全分享链接+社交引流 | 适用 |
| 内容矩阵运势引流 | type+出生信息 | 50字运势摘要+社交发布文案 | 适用 |
| 私域社群运势推送 | type+出生信息 | 命理报告+推送内容 | 适用 |
| 多体系交叉验证 | 多个type+同一出生信息 | 多体系报告对比分析 | 适用 |
| 黄历免费引流服务 | 日期+type=almanac | 黄历宜忌查询结果 | 适用 |
| 专业命理师咨询服务 | 一对一深度咨询对话 | 不适用(本Skill为报告生成非实时咨询) | 不适用 |
| 风水布局实地勘测 | 实地房屋方位测量 | 不适用(本Skill为命理排盘非风水) | 不适用 |
| 命理教学培训 | 命理知识体系教学 | 不适用(本Skill为生成服务非教学) | 不适用 |

## 使用流程

### Step 1: 接收算命请求
- 解析输入:birth_date(出生日期)、birth_time(出生时辰)、gender(性别)、type(命理体系类型)
- 验证:日期格式合法,时辰在12地支范围内,性别为男/女
- 校验失败处理:参数缺失→提示补全;格式错误→给出正确格式示例

| type值 | 命理体系 | 排盘内容 | 定价建议 |
|---:|---:|---:|---:|
| bazi | 八字排盘 | 四柱+大运流年 | 9.9-29.9元 |
| ziwei | 紫微斗数 | 12宫+108星+四化 | 49.9-99元 |
| tarot | 塔罗占卜 | 抽牌+解读 | 9.9-19.9元 |
| meihua | 梅花易数 | 起卦+断卦 | 19.9-49.9元 |
| liuyao | 六爻 | 排卦+分析 | 19.9-49.9元 |
| qimen | 奇门遁甲 | 天地人神四盘 | 49.9-99元 |
| astrology | 西方占星 | 星盘+流运 | 9.9-29.9元 |
| almanac | 黄历查询 | 黄历宜忌 | 免费(引流) |

### Step 2: 调用命理排盘API生成基础排盘
- 八字:排四柱+五行+十神+纳音,排大运流年
- 紫微:排12宫+108星+四化,排运限
- 塔罗:抽牌+解读
- 梅花:起卦+断卦(体用生克+互卦+变卦)
- 六爻:排卦+分析
- 奇门:排盘(天盘地盘人盘神盘)
- 占星:排星盘+流运
- 异常:排盘引擎不可用→提示"命理引擎维护中,请稍后再试"(不降级,避免计算错误)

### Step 3: AI深度解读
- 将排盘数据+用户信息组合为LLM提示词
- 提示词模板按type选择,每种type有专属角色名+结构化输出格式+免责声明
- 输出:800-1500字命理报告(含事业/感情/财运/健康四维度)
- 异常:LLM超时→返回原始排盘数据+简短解读(200字)

| type | 角色名 | 输出结构 |
|:---:|:---:|:---:|
| bazi | 玄微子 | 日主强弱+五行平衡+十神格局+大运走势+流年细断+四维度 |
| tarot | 月曦 | 逐牌解读+牌阵整体+综合建议(1核心+3行动+2注意+时间线) |
| meihua | 观梅老人 | 体用生克+互卦过程+变卦结果+应期+建议 |
| astrology | 星言 | 星盘核心+四维度运势+重点提醒 |
| ziwei | 天机子 | 命宫格局+四化飞星+关键宫位+大限流年 |

### Step 4: 敏感词审核
- 检测报告内容中的敏感词
- 替换封建迷信敏感词为心理学术语(例:"命中注定"→"性格倾向")
- 添加免责声明:"本报告仅供娱乐参考,不构成任何决策建议"
- 异常:审核不通过→重新生成解读段落

### Step 5: 报告交付
1. 将命理报告保存为文件(PDF/文本),文件名格式:{order_id}_{type}_{timestamp}
2. 上传报告文件到文件存储服务指定目录
3. 生成安全分享链接(随机6位密码+3天有效期)
4. 将分享链接通过电商平台消息发送给买家
5. 事后验证发货结果(链接可达+消息已送达)
- 异常:上传失败→记录待发送队列,下次重试;发送失败→记录待发送队列;验证失败→触发告警

### Step 6: 运势内容引流(可选)
1. 生成50字运势摘要:从命理报告中提取核心运势关键词,生成精简摘要(含今日运势+幸运色/数字)
2. 发布运势摘要到社交平台(可配置)
3. 发布内容格式:"[星座/生肖]今日运势 | [50字摘要] | #运势 #今日运势"
4. 记录发布结果
- 异常:发布不可用→跳过,不影响核心流程;发布失败→记录日志,不重试

## 输入格式

```json
{
  "birth_date": "1990-01-15",
  "birth_time": "子时",
  "gender": "男",
  "type": "bazi",
  "channel": "ecommerce",
  "order_id": "ORDER20240115001"
}
```

## 输出格式

```json
{
  "success": true,
  "data": {
    "type": "bazi",
    "pillars": {"year": "己巳", "month": "丁丑", "day": "庚辰", "hour": "丙子"},
    "wuxing": {"木": 2, "火": 2, "土": 3, "金": 2, "水": 1},
    "nayin": "大林木",
    "dayun": ["戊寅", "己卯", "庚辰", "辛巳", "壬午"],
    "report": "800-1500字命理报告",
    "summary": "50字运势摘要(用于社交平台)",
    "disclaimer": "本报告由AI辅助生成,仅供娱乐参考,不构成任何决策建议",
    "delivery": {
      "file_path": "报告文件路径",
      "share_link": "安全分享链接",
      "share_password": "6位密码",
      "expire_at": "2026-04-18T00:00:00Z",
      "verified": true
    },
    "social_post": {
      "published": true,
      "platforms": ["小红书", "微博"],
      "summary": "50字运势摘要"
    }
  },
  "error": null,
  "code": null
}
```

## 异常处理

| 异常场景 | 原因 | 处理方式 | 错误码 |
|:------|------:|:------|:------|
| 参数缺失 | birth_date/birth_time/gender/type未提供 | 提示补全所需参数 | MISSING_PARAMS |
| 排盘引擎不可用 | 命理API服务宕机或Key无效 | 提示维护中,不降级(避免计算错误) | ENGINE_UNAVAILABLE |
| LLM超时 | LLM响应超过超时阈值 | 返回排盘数据+简短解读(200字) | LLM_TIMEOUT |
| 敏感词审核不通过 | 报告内容命中违禁词 | 重新生成解读段落 | SENSITIVE_CONTENT |
| 报告发送失败 | 网盘上传失败或消息发送失败 | 记录待发送队列,稍后 | DELIVERY_FAILED |
| 社交发布不可用 | 社交平台API不可用 | 跳过运势引流,不影响核心流程 | CONTENT_PUBLISH_SKIPPED |

## 合规提醒

- 定位为"心理娱乐"服务,避免封建迷信宣传
- 所有报告必须附带免责声明+AI生成声明
- 禁止使用"必应""化解""破灾"等违规词
- 电商商品描述使用"性格分析""趋势参考"等替代话术
- AI生成声明:"本报告由AI辅助生成,仅供参考娱乐"

## 依赖说明

### 运行环境
- **Agent平台**: Claude Code / Cursor / Codex / Gemini CLI / Windsurf 等支持SKILL.md的任意Agent
- **操作系统**: Windows / macOS / Linux
- **运行时**: 需要Agent支持exec(命令行执行)能力

### 依赖说明(补充)
| 依赖项 | 类型 | 是否必需 | 获取方式 | 国内替代方案 |
|---:|:---|---:|---:|:---|
| LLM API | API | 必需 | 任意LLM服务商,由Agent内置LLM提供 | DeepSeek/通义千问/文心一言/Kimi等国内模型 |
| 命理排盘引擎 | API | 必需 | 八字/紫微/塔罗/梅花/六爻/奇门/占星/黄历 | 开源排盘库lunar-python(本地运行,无海外依赖) |
| 文件存储 | 文件系统 | 可选 | exec工具保存报告文件 | 本地文件系统,无海外依赖 |

### API Key 配置与安全要求
- **LLM_API_KEY**: 必需(通常由Agent内置) - AI深度解读命理报告
- **FORTUNE_API_KEY**: 可选 - 命理排盘引擎(可使用开源排盘库lunar-python替代)
- 配置方式: 在Agent的环境变量中设置
- **零暴露原则**: API Key必须通过环境变量注入(如`$env:FORTUNE_API_KEY`),严禁硬编码在SKILL.md或脚本源码中;所有示例代码中Key位置使用环境变量占位符;禁止在日志、错误信息、输出JSON中打印Key明文

### 使用流程(补充)
命理排盘可使用开源排盘库(如lunar-python)替代API。LLM超时时返回原始排盘数据+简短解读.
只需将SKILL.md文件放入Agent的skills目录即可直接使用.
如果Skill中包含exec工具调用,需要Agent支持命令行执行能力.
### 可用性分类
- **分类**: MD+EXEC
- **说明**: 纯Markdown,但需要exec能力(命令行执行),用于文件读写和命令调用

## 示例

### 示例1: 电商八字排盘服务

**输入**:
```json
{
  "birth_date": "1990-01-15",
  "birth_time": "子时",
  "gender": "男",
  "type": "bazi",
  "channel": "ecommerce",
  "order_id": "ORDER20240115001"
}
```

**执行流程**: 接收订单→提取出生信息(1990-01-15,子时,男)→调用命理排盘API排盘→排大运→AI解读生成1200字四维度报告→敏感词审核替换3处+添加免责声明→保存报告文件→上传文件存储→生成安全分享链接(6位密码+3天有效期)→电商平台消息发送→验证发货→生成50字运势摘要→社交平台发布引流

**输出**:
```json
{
  "success": true,
  "data": {
    "type": "bazi",
    "pillars": {"year": "己巳", "month": "丁丑", "day": "庚辰", "hour": "丙子"},
    "wuxing": {"木": 2, "火": 2, "土": 3, "金": 2, "水": 1},
    "nayin": "大林木",
    "dayun": ["戊寅", "己卯", "庚辰", "辛巳", "壬午"],
    "report": "玄微子老师解读:日主庚金生于丑月,土旺金相,日主偏强。五行中土重金旺,需水泄金、木疏土为用...(1200字四维度报告)",
    "summary": "属蛇今日运势平稳,事业有贵人助力,幸运色蓝色,幸运数字3",
    "disclaimer": "本报告由AI辅助生成,仅供娱乐参考,不构成任何决策建议",
    "delivery": {
      "file_path": "reports/ORDER20240115001_bazi_20260115.pdf",
      "share_link": "https://pan.example.com/s/abc123def",
      "share_password": "8k9m2x",
      "expire_at": "2026-04-18T00:00:00Z",
      "verified": true
    },
    "social_post": {
      "published": true,
      "platforms": ["小红书", "微博"],
      "summary": "属蛇今日运势平稳,事业有贵人助力,幸运色蓝色,幸运数字3"
    }
  },
  "error": null,
  "code": null
}
```

### 示例2: 塔罗占卜服务

**输入**:
```json
{
  "birth_date": "1995-06-20",
  "birth_time": "午时",
  "gender": "女",
  "type": "tarot",
  "channel": "ecommerce",
  "order_id": "ORDER20240115002"
}
```

**执行流程**: 接收订单→提取信息→塔罗抽牌+解读→AI解读(月曦角色,逐牌解读+牌阵整体+综合建议)→敏感词审核→报告交付→运势引流

**输出**:
```json
{
  "success": true,
  "data": {
    "type": "tarot",
    "cards": [{"name": "愚者", "position": "过去", "meaning": "新的开始"}, {"name": "恋人", "position": "现在", "meaning": "选择与关系"}, {"name": "太阳", "position": "未来", "meaning": "成功与快乐"}],
    "report": "月曦老师解读:过去愚者牌显示你曾勇敢迈出舒适区...(800字塔罗解读报告)",
    "summary": "塔罗指引:近期感情有积极进展,保持开放心态迎接新机会",
    "disclaimer": "本报告由AI辅助生成,仅供娱乐参考,不构成任何决策建议",
    "delivery": {
      "file_path": "reports/ORDER20240115002_tarot_20260115.pdf",
      "share_link": "https://pan.example.com/s/xyz789ghi",
      "share_password": "4p7q1r",
      "expire_at": "2026-04-18T00:00:00Z",
      "verified": true
    }
  },
  "error": null,
  "code": null
}
```

### 示例3: LLM超时降级(LLM_TIMEOUT)

**输入**: LLM响应超时时的八字排盘请求
```json
{"birth_date": "1990-01-15", "birth_time": "子时", "gender": "男", "type": "bazi"}
```

**输出**: 返回原始排盘数据+简短解读
```json
{
  "success": true,
  "data": {
    "type": "bazi",
    "pillars": {"year": "己巳", "month": "丁丑", "day": "庚辰", "hour": "丙子"},
    "report": "日主庚金生于丑月,土旺金相。大运戊寅起运...(200字简短解读)",
    "downgraded": true,
    "downgrade_reason": "LLM_TIMEOUT"
  },
  "error": "LLM超时,已返回简短解读",
  "code": "LLM_TIMEOUT"
}
```

## 案例展示

以下案例展示了skill的工作流程和预期输出效果，由LLM按照skill定义的流程生成.
### 案例1: 八字排盘深度解读(电商订单全流程交付)

**输入**:
```json
{
  "birth_date": "1990-01-15",
  "birth_time": "子时",
  "gender": "男",
  "type": "bazi",
  "channel": "ecommerce",
  "order_id": "ORDER20260720001"
}
```

**LLM生成输出**:
```json
{
  "success": true,
  "data": {
    "type": "bazi",
    "pillars": {"year": "己巳", "month": "丁丑", "day": "庚辰", "hour": "丙子"},
    "wuxing": {"木": 1, "火": 2, "土": 3, "金": 2, "水": 2},
    "nayin": "大林木",
    "dayun": ["戊寅", "己卯", "庚辰", "辛巳", "壬午"],
    "report": "【玄微子·八字命理分析报告】\n\n一、日主强弱分析：庚金生于丑月，土旺金相，日主偏强。喜用神为水木，忌神为土金。\n\n二、五行平衡度：土3金2火2水2木1，五行分布偏燥，土气过重，需水润木疏。\n\n三、十神格局：偏印格，食神生财，格局清奇。丙火七杀透出时干，事业心强，有开创精神。\n\n四、大运走势：目前行庚辰大运(2024-2033)，与日柱相同，伏吟之象，主事业变动期。35岁后转辛巳运，渐入佳境。\n\n五、四维度细断：\n• 事业：适合技术、金融、管理类方向，2026年有晋升机遇\n• 感情：配偶宫辰土为喜，伴侣性格务实稳重，2027年感情稳定\n• 财运：正财为主，偏财需谨慎，35岁后财运渐旺\n• 健康：注意脾胃和呼吸系统，建议规律作息\n\n六、流年提醒：2026丙午年，七杀透出，事业上宜主动出击，但注意人际关系处理。",
    "summary": "庚金日主偏强，喜水木忌土金。2026事业有机遇，感情2027趋稳，财运35岁后渐旺。",
    "disclaimer": "本报告由AI辅助生成,仅供娱乐参考,不构成任何决策建议",
    "delivery": {
      "file_path": "reports/ORDER20260720001_bazi_20260720.pdf",
      "share_link": "https://share.fortune-reader.com/r/ORDER20260720001",
      "share_password": "Kx9mP2",
      "expire_at": "2026-07-23T00:00:00Z",
      "verified": true
    },
    "social_post": {
      "published": true,
      "platforms": ["小红书", "微博"],
      "summary": "属蛇今日运势：事业有转机，贵人相助，幸运色蓝色，幸运数字3"
    }
  },
  "error": null,
  "code": null
}
```

**效果验证**: ✓八字四柱排盘正确(己巳/丁丑/庚辰/丙子) ✓800字以上深度报告(含六维度分析) ✓敏感词审核通过(无封建迷信词) ✓安全分享链接生成(6位密码+3天有效期) ✓社交引流文案自动生成

### 案例2: 塔罗占卜(三牌阵解读,电商订单)

**输入**:
```json
{
  "birth_date": "1995-08-20",
  "birth_time": "午时",
  "gender": "女",
  "type": "tarot",
  "question": "近期感情发展如何?",
  "channel": "ecommerce",
  "order_id": "ORDER20260720002"
}
```

**LLM生成输出**:
```json
{
  "success": true,
  "data": {
    "type": "tarot",
    "cards": [
      {"position": "过去", "name": "圣杯三(逆位)", "meaning": "过去感情中存在不平等付出,社交圈影响了关系稳定"},
      {"position": "现在", "name": "恋人(正位)", "meaning": "当前面临重要感情选择,真诚沟通是关键"},
      {"position": "未来", "name": "星星(正位)", "meaning": "未来充满希望,保持信心将迎来和谐关系"}
    ],
    "report": "【月曦·塔罗占卜报告】\n\n问题：近期感情发展如何？\n\n牌阵：过去-现在-未来 三牌阵\n\n一、逐牌解读：\n• 过去位-圣杯三(逆位)：这段关系中,你可能经历过付出与回报不对等的阶段。社交圈的介入或第三者因素曾影响关系稳定性。这并非坏事,而是让你更清楚自己真正需要什么。\n\n• 现在位-恋人(正位)：你正处于一个重要的感情十字路口。恋人牌代表真诚的选择——不是被动等待,而是主动面对内心的声音。当前最需要的是坦诚沟通,无论结果如何,真实比完美更重要。\n\n• 未来位-星星(正位)：星星是塔罗中最温柔的希望之牌。它预示着经过选择后的平静与重生。保持信心,即使过程有波折,结局将趋于和谐。\n\n二、综合建议：\n• 核心提示：真诚是当前最重要的品质\n• 3个行动建议：1)主动表达真实感受 2)给对方理解的空间 3)不急于做决定\n• 2个注意：避免社交圈过度介入；不要因害怕失去而妥协底线\n• 时间线：近期1-2周是关键沟通期,1个月内关系走向将逐渐明朗\n\n三、结语：感情如星河流转,暂时的暗淡是为了让星光更耀眼。保持你内心那份温柔与坚定。",
    "summary": "塔罗三牌阵：过去圣杯三逆位(不平等付出)，现在恋人正位(重要选择)，未来星星正位(希望重生)。",
    "disclaimer": "本报告由AI辅助生成,仅供娱乐参考,不构成任何决策建议",
    "delivery": {
      "file_path": "reports/ORDER20260720002_tarot_20260720.pdf",
      "share_link": "https://share.fortune-reader.com/r/ORDER20260720002",
      "share_password": "7nWqL3",
      "expire_at": "2026-07-23T00:00:00Z",
      "verified": true
    }
  },
  "error": null,
  "code": null
}
```

**效果验证**: ✓三牌阵抽牌+逐牌解读完整 ✓800字以上深度报告(含核心+行动+注意+时间线) ✓敏感词审核通过 ✓安全分享链接生成 ✓问题导向解读(感情发展)

### 案例3: 西方占星星盘解读(四维度运势)

**输入**:
```json
{
  "birth_date": "1992-06-15",
  "birth_time": "辰时",
  "gender": "女",
  "type": "astrology",
  "channel": "ecommerce",
  "order_id": "ORDER20260720003"
}
```

**LLM生成输出**:
```json
{
  "success": true,
  "data": {
    "type": "astrology",
    "star_chart": {
      "sun": "双子座",
      "moon": "天秤座",
      "rising": "狮子座",
      "mercury": "巨蟹座",
      "venus": "金牛座",
      "mars": "白羊座"
    },
    "report": "【星言·西方占星报告】\n\n一、星盘核心配置：\n太阳双子座赋予你敏捷的思维和强烈的好奇心,你喜欢探索多元领域。月亮天秤座让你天生追求和谐的人际关系,情感上需要被认可和陪伴。上升狮子座为你增添了自信和领导力的外在气质。\n\n二、四维度运势分析：\n• 事业运：水星落巨蟹座,你的沟通方式富有同理心,适合教育、心理咨询、内容创作类工作。火星白羊赋予行动力,但需注意冲动决策。2026年下半年木星过境,事业有扩张机遇。\n\n• 感情运：金星金牛让你在感情中重视稳定和物质安全感。月亮天秤追求对等关系。当前金星与土星呈和谐相位,适合巩固已有关系或遇到成熟稳重的对象。\n\n• 财运：金牛金星带来稳健的理财直觉,不喜冒险。2026年财运平稳上升,适合长期投资而非短期投机。注意8-9月有一次额外收入机会。\n\n• 健康运：双子座掌管呼吸系统和手臂,需注意季节性过敏和肩颈疲劳。月亮天秤影响肾脏,建议多饮水,保持电解质平衡。\n\n三、重点提醒：2026年土星双鱼考验你的边界感,学会说'不'是今年的成长课题。木星巨蟹带来家庭领域的幸运,适合处理房产或家庭关系。",
    "summary": "太阳双子+月亮天秤+上升狮子。2026事业有机遇，感情求稳定，财运平稳上升。",
    "disclaimer": "本报告由AI辅助生成,仅供娱乐参考,不构成任何决策建议",
    "delivery": {
      "file_path": "reports/ORDER20260720003_astrology_20260720.pdf",
      "share_link": "https://share.fortune-reader.com/r/ORDER20260720003",
      "share_password": "P4tR8s",
      "expire_at": "2026-07-23T00:00:00Z",
      "verified": true
    }
  },
  "error": null,
  "code": null
}
```

**效果验证**: ✓星盘配置正确(太阳/月亮/上升/水金火) ✓四维度运势分析完整(事业/感情/财运/健康) ✓800字以上深度报告 ✓敏感词审核通过 ✓安全分享链接生成

### 案例4: 黄历查询(免费引流服务)

**输入**:
```json
{
  "birth_date": "2026-07-20",
  "type": "almanac",
  "channel": "social_media"
}
```

**LLM生成输出**:
```json
{
  "success": true,
  "data": {
    "type": "almanac",
    "date": "2026-07-20",
    "lunar_date": "农历丙午年六月初七",
    "gan_zhi": "丙午年 乙未月 庚寅日",
    "yi": ["祭祀", "祈福", "出行", "嫁娶", "开市", "交易", "立券"],
    "ji": ["动土", "破土", "安葬", "行丧"],
    "chong": "冲猴(甲申)煞北",
    "report": "【黄历查询·2026年7月20日】\n\n农历：丙午年六月初七 庚寅日\n\n宜：祭祀、祈福、出行、嫁娶、开市、交易、立券\n\n忌：动土、破土、安葬、行丧\n\n冲煞：冲猴(甲申)煞北\n\n彭祖百忌：庚不经络织机虚张，寅不祭祀神鬼不尝\n\n今日胎神：碓磨炉外正北\n\n吉神宜趋：母仓、五合、圣心\n\n凶神宜忌：劫煞、天罡\n\n【今日提醒】今日适宜出行和商业活动，若有嫁娶之喜亦为吉日。但不宜动土破土等工程事宜。属猴者今日注意北方出行安全。",
    "summary": "7月20日黄历：宜出行嫁娶开市，忌动土破土，冲猴煞北。",
    "disclaimer": "本报告由AI辅助生成,仅供娱乐参考,不构成任何决策建议",
    "social_post": {
      "published": true,
      "platforms": ["小红书", "微博"],
      "summary": "今日黄历7.20 | 宜出行嫁娶开市交易 | 忌动土破土 | 冲猴煞北 | #黄历 #今日宜忌"
    }
  },
  "error": null,
  "code": null
}
```

**效果验证**: ✓黄历宜忌正确查询 ✓农历日期转换正确 ✓社交引流文案自动生成 ✓免费引流场景适配 ✓输出格式合规

### 案例5: LLM超时降级(返回排盘+简短解读)

**输入**:
```json
{
  "birth_date": "1988-03-22",
  "birth_time": "卯时",
  "gender": "男",
  "type": "bazi",
  "channel": "ecommerce",
  "order_id": "ORDER20260720004"
}
```

**LLM生成输出**:
```json
{
  "success": true,
  "data": {
    "type": "bazi",
    "pillars": {"year": "戊辰", "month": "乙卯", "day": "壬申", "hour": "癸卯"},
    "wuxing": {"木": 2, "火": 0, "土": 2, "金": 2, "水": 3},
    "nayin": "大林木",
    "dayun": ["丙辰", "丁巳", "戊午", "己未", "庚申"],
    "report": "【八字排盘·简短解读】\n\n日主壬水，生于卯月，水木相生。五行缺火，需补火调候。当前大运戊午，午火补缺，运势向好。建议多参与社交活动，拓展人脉。详细解读请稍后重试或联系客服。",
    "summary": "壬水日主，五行缺火，当前大运补火，运势向好。",
    "disclaimer": "本报告由AI辅助生成,仅供娱乐参考,不构成任何决策建议",
    "delivery": {
      "file_path": "reports/ORDER20260720004_bazi_20260720.pdf",
      "share_link": "https://share.fortune-reader.com/r/ORDER20260720004",
      "share_password": "3mK9xR",
      "expire_at": "2026-07-23T00:00:00Z",
      "verified": true
    }
  },
  "error": "LLM深度解读超时,已返回排盘数据+简短解读(200字)",
  "code": "LLM_TIMEOUT"
}
```

**效果验证**: ✓排盘数据正确返回(四柱+五行+大运) ✓LLM超时降级为简短解读(200字) ✓降级原因在error字段标注 ✓错误码LLM_TIMEOUT正确返回 ✓报告交付流程不受影响

## 常见问题

### Q1: 命理排盘引擎不可用时怎么办?
A: 命理排盘引擎不可用时返回ENGINE_UNAVAILABLE错误,提示"命理引擎维护中,请稍后再试",不降级以避免计算错误。建议:1)使用开源排盘库lunar-python替代API(本地运行无需API Key);2)检查FORTUNE_API_KEY配置是否正确;3)等待排盘引擎服务恢复后重试.
### Q2: 报告如何确保合规不违规?
A: 本Skill有三重合规保障:1)敏感词审核自动替换封建迷信敏感词为心理学术语(如"命中注定"→"性格倾向");2)所有报告强制添加免责声明"本报告由AI辅助生成,仅供娱乐参考,不构成任何决策建议";3)定位为"心理娱乐"服务,禁止使用"必应""化解""破灾"等违规词,电商商品描述使用"性格分析""趋势参考"等替代话术.
### Q3: 报告交付的安全分享链接有效期多久?
A: 安全分享链接有效期为3天,配有随机6位密码保护。交付流程:1)报告保存为PDF/文本文件;2)上传文件存储;3)生成安全分享链接(6位密码+3天有效期);4)通过电商平台消息发送链接+密码给买家;5)事后验证链接可达+消息已送达。发送失败会记录待发送队列支持重试.
### Q4: 8种命理体系分别适合什么定价?
A: 定价建议按深度分级:引流款9.9-19.9元(塔罗/黄历免费/占星/八字基础);标准款19.9-49.9元(梅花/六爻/八字详细);深度款49.9-99元(紫微/奇门/多体系交叉验证)。建议用黄历免费引流→塔罗/八字9.9元转化→紫微/奇门99元深度变现的漏斗模型.
## 错误处理

| 错误场景 | 原因 | 处理方式 |
|:------:|--------|:-------|
| LLM响应超时或无响应 | 网络延迟或模型负载过高 | ，请求；确认Agent平台LLM服务正常 |
| 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求，参考示例章节 |
| 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述，补充必要的上下文信息 |
| 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求；检查命令权限设置 |

## 已知限制

1. **定位心理娱乐非封建迷信**:所有报告必须附带免责声明,禁止"必应""化解""破灾"等违规词,定位为"心理娱乐"服务,不可作为真实命运预测依据
2. **排盘引擎不可用时不降级**:命理排盘需要精确计算,引擎不可用时返回ENGINE_UNAVAILABLE而非降级,避免错误计算导致误导(可使用开源lunar-python库替代)
3. **LLM超时仅返回200字简短解读**:LLM超时时降级返回原始排盘数据+200字简短解读,无法生成完整800-1500字四维度报告
4. **报告有效期3天**:安全分享链接有效期仅3天,超期后买家需联系重新生成,建议买家及时下载保存
5. **不支持实时咨询对话**:本Skill为报告生成模式,不支持一对一实时命理咨询对话,需用户先提供出生信息再生成报告

## 变更历史

| 版本 | 日期 | 变更说明 |
|----|:--:|---:|
| v1.0.0 | 2026-07-17 | 初版创建,8种命理体系+AI深度解读+安全交付+运势引流+合规审核 |