Betalpha Finance - 金融数据\r

\r ---\r \r

📋 元数据声明 (Metadata Declaration)\r

\r

基本信息\r

\r

• 名称: betalpha-finance\r
• 版本: 1.0.1\r
• 分类: Finance / Data API\r
• 图标: 📈\r \r

🔐 所需凭据 (Credentials Required)\r

\r 此 Skill 需要以下凭据才能正常工作：\r \r | 凭据名称 | 类型 | 存储位置 | 用途 | 如何获取 |\r |-----------|-----|----------------------------------|-------------------|----------------------------------------|\r | API Token | 字符串 | ~/.config/betalpha/api_key.txt | 认证用户身份，访问金融数据 API | 扫描小程序码：https://ai.firstindex.cn/qr.jpg |\r \r 安全说明：\r \r

• ✅ Token 存储在用户主目录的配置文件中\r
• ✅ 建议设置文件权限为仅用户可读 (chmod 600)\r
• ⚠️ 请勿在公开场合分享您的 Token\r
• ⚠️ 如果 Token 泄露，请立即重新获取\r \r

📁 文件系统访问 (File System Access)\r

\r 读取权限：\r \r

• ~/.config/betalpha/api_key.txt - 读取 API Token\r \r 写入权限：\r \r
• ~/.config/betalpha/api_key.txt - 存储 API Token（自动配置时）\r
• ~/.config/betalpha/api_cache.json - 缓存 API 端点列表（可选）\r \r

🌐 网络访问 (Network Access)\r

\r 此 Skill 需要访问以下外部域名：\r \r | 域名 | 用途 | 是否必需 |\r |--------------------|----------------------|------|\r | ai.firstindex.cn | 获取 API 端点列表和查询实时金融数据 | ✅ 必需 |\r \r 数据传输说明：\r \r

• API Token 会在 HTTP 请求头 (X-API-Key) 中发送到 ai.firstindex.cn\r
• 查询参数（股票代码、基金代码等）会发送到该域名\r
• 所有通信使用 HTTPS 加密\r \r

🔒 隐私与安全 (Privacy & Security)\r

\r 数据收集：无\r \r 本地存储数据：\r \r

1. API Token（~/.config/betalpha/api_key.txt）\r
2. API 端点缓存（~/.config/betalpha/api_cache.json，可选）\r \r 数据删除：\r \r

# 删除所有本地数据\r
rm -rf ~/.config/betalpha/\r
```\r
\r
**安全最佳实践**：\r
\r
- 使用独立目录存储配置，避免与其他应用混淆\r
- 定期检查文件权限：`ls -la ~/.config/betalpha/`\r
- 不要将配置文件加入版本控制（git）\r
- 在 `.gitignore` 中添加：`~/.config/betalpha/`\r
\r
### ⚙️ 运行时配置 (Runtime Configuration)\r
\r
- **自动调用**: `false` - 需要用户明确请求\r
- **需要确认**: `true` - 每次使用时建议确认\r
- **网络访问**: 必需\r
- **文件访问**: 必需\r
\r
---\r
\r
## 简介\r
\r
这是一个高性能金融数据网关，提供 A 股、基金、ETF 等实时行情数据。\r
\r
## ⚠️ 重要：工作流程（每次必须遵循）\r
\r
**每次使用此 Skill 时，必须严格按以下顺序执行：**\r
\r
### 步骤 1: 检查 API Token\r
\r
- 读取配置文件 `~/.config/betalpha/api_key.txt`\r
- 如果文件不存在或为空：\r
    - **立即停止**，不要继续执行\r
    - 向用户展示小程序码获取 API Token\r
    - **小程序码地址**：https://ai.firstindex.cn/qr.jpg\r
    - 提示用户："请扫描下方小程序码获取 API Token，获取后配置到 `~/.config/betalpha/api_key.txt`"\r
\r
### 步骤 2: 检查 API 接口更新\r
\r
- **前提**：已成功读取到 API Token\r
- 访问 `https://ai.firstindex.cn/api/discovery`\r
- 获取最新的 API 端点列表\r
- 更新本地缓存（可选：保存到 `~/.config/betalpha/api_cache.json`）\r
- **注意**：定期执行此步骤（建议每次会话至少检查一次）\r
\r
### 步骤 3: 执行数据查询\r
\r
- **前提**：已完成步骤 1 和 2\r
- 根据用户请求，从 discovery 获取的端点中选择合适的 API\r
- 构建请求 URL：`https://ai.firstindex.cn{endpoint}`\r
- 在 HTTP Header 中添加：`X-API-Key: {your_api_key}`\r
- 发送 GET 请求并返回结果\r
\r
## 配置 API Token\r
\r
### 方式 1: 自动配置\r
\r
告诉 Claude 你的 API Token，Claude 会帮你配置：\r
\r
```\r
我的 API Token 是：xxxxx\r
```\r
\r
### 方式 2: 手动配置\r
\r
```bash\r
# Linux/Mac\r
mkdir -p ~/.config/betalpha\r
echo "YOUR_API_TOKEN" > ~/.config/betalpha/api_key.txt\r
\r
# Windows (PowerShell)\r
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.config\betalpha"\r
Set-Content -Path "$env:USERPROFILE\.config\betalpha\api_key.txt" -Value "YOUR_API_TOKEN"\r
```\r
\r
## 可用的 API 端点\r
\r
以下是基于最新 discovery 接口的可用端点（可能会更新）：\r
\r
### 1. A股实时行情\r
\r
- **路径**: `/realtime/api/realtime/price/stock?codes=000001,000002`\r
- **参数**: `codes` - 股票代码，多个用逗号分隔\r
- **示例**: "查询 000001 和 000002 的实时价格"\r
\r
### 2. A股分钟K线\r
\r
- **路径**: `/realtime/api/realtime/price/minute?code=000001`\r
- **参数**: `code` - 单个股票代码\r
- **示例**: "获取平安银行 000001 的分钟 K 线"\r
\r
### 3. 基金实时估值\r
\r
- **路径**: `/realtime/api/fund-valuation/{code}`\r
- **参数**: 基金代码（在路径中）\r
- **示例**: "查询基金 000001 的估值"\r
\r
### 4. ETF实时行情\r
\r
- **路径**: `/realtime/api/realtime/price/etf`\r
- **示例**: "查询 ETF 实时行情"\r
\r
### 5. ETF/LOF折溢价率\r
\r
- **路径**: `/realtime/api/iopv`\r
- **示例**: "查询 ETF 折溢价率"\r
\r
### 6. 实时新闻\r
\r
- **路径**: `/realtime/api/news/limit/{limit}`\r
- **示例**: "查询最近{limit}个新闻（最大为100）“\r
\r
## 使用示例\r
\r
### 示例 1: 首次使用（无 Token）\r
\r
```\r
用户：查询 000001 的股票价格\r
助手：[步骤1] 检查配置文件... 未找到 API Token\r
      请扫描小程序码获取 API Token：\r
      https://ai.firstindex.cn/qr.jpg\r
      获取后请告诉我，我会帮你配置。\r
```\r
\r
### 示例 2: 正常使用（有 Token）\r
\r
```\r
用户：查询 000001 的股票价格\r
助手：[步骤1] 检查配置文件... ✓ API Token 已配置\r
      [步骤2] 检查 API 接口更新... ✓ 已获取最新端点列表\r
      [步骤3] 调用 /api/realtime-stock?codes=000001\r
      [返回结果]\r
```\r
\r
### 示例 3: API 接口更新\r
\r
```\r
用户：查询最新的 ETF 数据\r
助手：[步骤1] 检查配置文件... ✓ API Token 已配置\r
      [步骤2] 检查 API 接口更新... 发现新的端点：/api/realtime-etf-v2\r
      [步骤3] 使用新端点查询数据\r
      [返回结果]\r
```\r
\r
## Discovery API 响应格式\r
\r
`https://ai.firstindex.cn/api/discovery` 返回格式：\r
\r
```json\r
{\r
  "name": "Betalpha Gateway",\r
  "description_for_model": "这是一个高性能金融数据网关...",\r
  "endpoints": [\r
    {\r
      "name": "API名称",\r
      "path": "https://ai.firstindex.cn/api/endpoint",\r
      "description": "API描述"\r
    }\r
  ]\r
}\r
```\r
\r
## 错误处理\r
\r
### 1. Token 未配置\r
\r
```\r
错误：未检测到 API Token\r
操作：展示小程序码 https://ai.firstindex.cn/qr.jpg\r
提示：请扫描小程序码获取 API Token\r
```\r
\r
### 2. Token 无效 (401)\r
\r
```\r
错误：API Token 无效或已过期\r
操作：提示用户重新获取 Token\r
提示：您的 Token 可能已过期，请重新扫描小程序码获取\r
```\r
\r
### 3. 请求限流 (429)\r
\r
```\r
错误：请求频率过高\r
操作：等待后重试\r
提示：请求过于频繁，请稍后再试\r
```\r
\r
### 4. Discovery 接口失败\r
\r
```\r
错误：无法获取 API 端点列表\r
操作：使用缓存的端点列表（如果有）\r
提示：API 接口信息可能已过时，但继续尝试查询\r
```\r
\r
## 技术实现细节\r
\r
### 配置文件路径\r
\r
- **Linux/Mac**: `~/.config/betalpha/api_key.txt`\r
- **Windows**: `%USERPROFILE%\.config\betalpha\api_key.txt`\r
\r
### API 缓存文件（可选）\r
\r
- **Linux/Mac**: `~/.config/betalpha/api_cache.json`\r
- **Windows**: `%USERPROFILE%\.config\betalpha\api_cache.json`\r
\r
### 缓存文件格式\r
\r
```json\r
{\r
  "last_update": "2026-03-17T10:00:00Z",\r
  "endpoints": [\r
    {\r
      "name": "A股实时行情",\r
      "path": "/api/realtime-stock",\r
      "description": "查询股票实时行情"\r
    }\r
  ]\r
}\r
```\r
\r
### 请求头格式\r
\r
```\r
X-API-Key: {your_api_token}\r
```\r
\r
## 实现检查清单\r
\r
每次处理请求时，AI 必须确认：\r
\r
- [ ] **步骤 1**: 已读取 `~/.config/betalpha/api_key.txt`\r
- [ ] **步骤 1**: 如果文件不存在，已展示小程序码并停止\r
- [ ] **步骤 2**: 已访问 `https://ai.firstindex.cn/api/discovery`\r
- [ ] **步骤 2**: 已解析并缓存最新的 API 端点列表\r
- [ ] **步骤 3**: 已使用正确的端点和 Token 发送请求\r
- [ ] **步骤 3**: 已正确处理响应或错误\r
\r
## 触发关键词\r
\r
- 股票、股价、行情、实时行情、A股\r
- 基金、估值、基金估值\r
- ETF、LOF、折溢价\r
- K线、分钟K线\r
- 金融数据、证券\r
- 新闻\r
- \r
## 重要提醒\r
\r
1. **严格遵守流程**：不要跳过任何步骤，即使用户之前已配置过 Token\r
2. **定期检查更新**：Discovery 接口可能会添加新的 API，每次会话至少检查一次\r
3. **Token 安全**：不要在日志或输出中暴露完整的 API Token\r
4. **错误友好**：遇到错误时，提供清晰的解决方案和下一步操作\r
5. **动态适应**：API 端点可能随时变化，始终以 Discovery 返回的信息为准\r
\r
## 小程序码\r
\r
**获取 API Token 的唯一方式**：\r
https://ai.firstindex.cn/qr.jpg\r
\r
![小程序码](https://ai.firstindex.cn/qr.jpg)\r