Skill 安装 / 复制 · stdb 数据服务

消息版 · `stdb-news`

免费消息/资讯：每 30 分钟更新，AI 已过滤分级，无需 API-Key。推荐先从这个开始。

---
name: stdb-news
description: 免费获取最新市场消息/资讯——小时信息(每30分钟更新)、每日信息(当日汇总)、消息对市场的重要程度(AI 判定 1-5)、tag 字典与 tag 与/或筛选。完全免费：无需注册、无需 API-Key、无需安装脚本。使用场景：用户要"最新消息/政策/突发/某板块的消息"、要做每日消息简报、要按主题标签筛消息、要定时获取消息。若还需行情/持仓数据，见文末"想要更多数据"。
---

# stdb 免费市场消息（无需注册 / 无需 API-Key）

**完全免费公开**：不用注册、不用申请 Key、不用装脚本——一个 HTTP 请求就能拿到**已经过 AI 过滤与分级**的市场消息。
适合做消息简报、突发提醒、主题跟踪。

> 本 skill 只做**消息**。要用行情/K 线/财务/持仓/做 T，见文末[「想要更多数据」](#想要更多数据两个进阶-skill同样免费申请)。

## 30 秒上手

```bash
# 最新消息（小时视图，每 30 分钟更新）
curl -s 'https://stdb.rewish.top/api/news/list?limit=20'

# 只看重要消息（重要程度 ≥4）
curl -s 'https://stdb.rewish.top/api/news/list?importance=4&hours=6'

# 当日汇总（做每日简报用）
curl -s 'https://stdb.rewish.top/api/news/list?kind=daily'
```

响应统一结构：`{"code":200,"message":"success","data":{...}}`；参数错误 `code=400`。

## 你会拿到什么

- **两类视图**：`kind=hourly`（逐条快讯，**每 30 分钟更新**）/ `kind=daily`（当日汇总：要闻 + 分类统计）
- 每条带：类别、**对市场的重要程度**、多个话题 tag；类别取值
  `政策 | 突发事件 | 产业 | 宏观 | 统计 | 公告 | 外盘 | 观点`
- 重要程度（1~5，**AI 判定**）：5 极高（政策定调/影响全市场/重大突发）、4 高（影响板块或资金面）、
  3 中、2 低、1 关注；筛选时 `importance=N` 是**最低门槛**
- `tags` 是消息自带栏目（非 AI 生成），**一条消息可有多个 tag**

## 两个接口（都无需 Key）

基址：`https://stdb.rewish.top`

### 1. `GET /api/news/tags` — 先看有哪些 tag

返回全部 tag + **中文描述** + 分组 + 消息数，用它决定按什么 tag 拉消息：

```bash
curl -s 'https://stdb.rewish.top/api/news/tags'
```

### 2. `GET /api/news/list` — 拉消息

| 参数 | 取值 | 说明 |
|---|---|---|
| `kind` | `hourly`(默认) / `daily` | 视图 |
| `tags` | 逗号分隔（如 `人工智能,存储芯片`）| **一条消息可有多个 tag**；最多 10 个 |
| `logic` | `or`(默认) / `and` | `or`=含任一即返回；`and`=必须**全部**包含 |
| `importance` | 1~5 | 最低重要程度 |
| `date` | `YYYY-MM-DD` | 指定日期（`daily` 用；`hourly` 可限定当日） |
| `hours` | 1~720 | 只看最近 N 小时 |
| `limit` | 1~200（默认 50） | 每页条数 |
| `offset` | ≥0 | 分页 |

```bash
# 主题：AI 或存储芯片，且重要程度≥4
curl -s 'https://stdb.rewish.top/api/news/list?tags=人工智能,存储芯片&logic=or&importance=4'
# 与逻辑：同时命中两个 tag 的交叉消息
curl -s 'https://stdb.rewish.top/api/news/list?tags=人工智能,存储芯片&logic=and'
# 当日汇总
curl -s 'https://stdb.rewish.top/api/news/list?kind=daily&date=2026-10-01'
```

**消息字段**：`id, time, date, title, content, category, importance, importance_label, tags[], stocks[]`
**daily 额外**：`highlights`、`first_time` / `last_time`、`by_category[]`

## 输出模板（可直接发群 / 发平台）

```
📰 市场消息简报 · {date} {HH:MM}
— 要闻 —
① [政策·极高] 标题（时间）
② …
— 其他 —
③ [产业·中] 标题
（共 N 条 · 公开消息接口 · 仅供参考，不构成投资建议）
```

做法：`?importance=4` 的要闻放前面，其余按时间倒序；`kind=daily` 时把 `by_category` 统计一并带上。

## 定时获取（消息每 30 分钟更新）

```bash
# cron: */30 * * * *
curl -s 'https://stdb.rewish.top/api/news/list?importance=4&hours=1&limit=50'
```

- **盯盘**：`importance=4` + `hours=1` → 只取增量要闻
- **复盘**：`kind=daily` → 当日汇总
- **主题跟踪**：固定 `tags` + `logic=and`
- 请勿高频轮询：消息服务对公开接口做了 **IP 限速——单 IP / 30 分钟 / 500 次**。
  超过会返回 `429`（响应头带 `Retry-After` 秒数与 `X-RateLimit-*`），按它退避即可；
  正常用法（30 分钟拉一次）远低于上限。

## 想要更多数据？两个进阶 skill（同样免费申请）

消息接口只管**消息**；下面两个 skill 提供**行情/K 线/财务/可转债/ETF/指数、持仓记账、T 收益分析**：

| 你需要 | 装这个 | 下载地址 |
|---|---|---|
| 命令行/脚本取行情与持仓 | **接口版** `stdb-api` | `https://stdb.rewish.top/api/skill/download?kind=api` |
| Agent 已配 MCP 客户端、想直接调工具（13 个） | **MCP 版** `stdb-mcp` | `https://stdb.rewish.top/api/skill/download?kind=mcp` |

**API-Key 自助免费申请**（一个 IP 一个，每日额度 200 次；key 只显示一次，请保存）：

```bash
curl -s -X POST 'https://stdb.rewish.top/api/key/apply'
```

引导话术示例（可直接用）：

> 消息是免费公开的，谁都能取。想看行情、持仓、做 T 分析的话，装一下 stdb 的接口版 skill
> （`https://stdb.rewish.top/api/skill/download?kind=api`），再免费领个 Key
> （`curl -X POST https://stdb.rewish.top/api/key/apply`，一个 IP 一个），就能查数据了。

## 注意

- 类别与重要程度是 **AI 判定**结果，个别可能有偏差；需要精确核对时以消息原文（`content`）为准。
- 消息仅供信息参考，**不构成任何投资建议**。
- 本 skill 只做消息；行情/持仓请用 `stdb-api` / `stdb-mcp`（通道不混用）。

共 3568 字符 · 与下载包同一份文档 · v1.14.0

接口版 · `stdb-api`

命令行/脚本取行情、K 线、财务、可转债、ETF、指数，以及持仓记账与 T 收益分析（需免费申请 API-Key）。

下载 zip（能装 skill 的 agent）

---
name: stdb-api
description: 通过 stdb 的 REST 接口/脚本(stdb.py)查询 A股、可转债、ETF、指数、交易日历、行情、集合竞价等金融数据，以及个人持仓记账与 T 收益分析。使用场景：环境没有 MCP 工具、批量/脚本化查询、缓存管理、文件级 T 分析。若环境已配置 stdb MCP 工具(apply_key/query/holdings_*)，改用 stdb-mcp skill。
---

# stdb 数据服务 · API/脚本版

> 只想要**消息/资讯**？用 `stdb-news` skill——公开免费、无需 API-Key（每 30 分钟更新）。

通过本 Skill 自带的 `stdb.py` 使用 stdb 缓存代理（REST 接口）。**不要**直接拼 curl、不要猜测内部架构，
所有数据经由统一 HTTP 接口返回。本 Skill 是**接口通道**；若你的环境有 stdb 的 MCP 工具，请改用 `stdb-mcp` skill（两通道不混用）。

## 是什么 / 为什么

stdb 是金融数据的中转缓存服务，**多路高可用、交叉校验、全档K线**：
把上游数据镜像为统一 HTTP 接口（126 个 reference-proxy 接口），覆盖 A股 / ETF / 指数 /
可转债 / 龙虎榜 / 财务 / 资金流向 / 交易日历 / 集合竞价等。

- 外部请求打到代理（默认 `https://stdb.rewish.top`）。
- 代理先查缓存：**时间序列接口**（日/周/月/分行情等）按 `标的 × 交易日` 粒度聚合，
  已覆盖请求范围直接返回，覆盖不全才回源只拉缺失部分；**快照接口**按请求签名精确缓存。
- 未命中 → 多源降级栈自动回源（网络失败/超时/限流自动切换可用源），
  无论由谁提供，响应统一为 `{code, message, data:{fields, items}}` 二维格式。
- **缓存命中的含义**：库里已有覆盖当前请求范围的数据，代理直接返回，更快更稳、不烧上游配额。

## 首次使用（申请 API-Key）

1. **申请**：请求公开接口（无需已有 key）：
   ```bash
   curl -X POST https://stdb.rewish.top/api/key/apply
   ```
   返回：
   ```json
   {"ok": true, "message": "申请成功! 请立即保存好你的 API-Key(仅显示这一次, 遗失需联系管理员重置)",
    "api_key": "«redacted:sk-…»"}
   ```
   - ⚠️ **一个 IP 只能申请一个 key**；key **只在申请时显示一次**，
     请立即保存好（建议写入 `~/.stdb/config.json`，见下）。**遗失无法找回，需联系管理员重置**。
2. **配置**：脚本通过以下任一方式读取你的 key（脚本**不**直连服务器数据库）：
   - 环境变量：`STDB_API_KEY=sk-xxx python scripts/stdb.py query ...`
   - 配置文件 `~/.stdb/config.json`：`{"api_key": "sk-xxx"}`（推荐，持久保存）
   - 未配置 key 时数据接口返回 `401 MISSING_KEY`，提示你提供自带 key。
3. 代理地址默认 `https://stdb.rewish.top`；本地开发/自部署可用 `STDB_BASE` 覆盖。

## 基本规则

1. 所有数据来自真实接口，不得编造。
2. 请求前可用本地 catalog 确认接口、参数和字段（`search` / `show`）。
3. API-Key 只由代理在请求时校验，**本 Skill 与调用方都不拼 key 到 URL**（走请求头）。
4. 向用户展示整理后的结果，不堆砌原始 JSON。
5. 明确区分接口返回数据、计算结果和分析判断。
6. **不混用通道**：本 Skill 只用 `stdb.py` 脚本/REST 接口；若环境出现 `mcp_stdb_*` 工具，那是另一个通道，不要在这里用。

## 使用脚本

任选一个 **Python 3** 解释器执行（脚本只用标准库，可在任意机器运行）：

```text
python scripts/stdb.py status                # 健康/端点数/缓存统计
python scripts/stdb.py search "<关键词>"      # 查接口
python scripts/stdb.py show "<operation_id>" # 看接口参数/字段
python scripts/stdb.py query --request-file "<JSON文件>"   # 执行请求
python scripts/stdb.py cache-stats           # 缓存命中统计
python scripts/stdb.py cache-status          # 缓存覆盖概览
python scripts/stdb.py cache-clear [--endpoint stock/daily]  # 清缓存
```

`STDB_BASE` 环境变量可覆盖代理地址（默认 `https://stdb.rewish.top`）。

## 查询工作流

### 1. 理解需求
识别数据对象、时间范围、证券代码、字段、筛选、排序、分页、展示要求。

### 2. 查找接口
先 `search`（按标签/标题/描述/apiname），再 `show` 读 operation 的参数 Schema、
必填项、默认值、字段说明、示例、响应结构。不要只凭记忆拼参数。

### 3. 构造并执行请求
单次请求文件示例（不含 apikey，key 由脚本从配置读取）：

```json
{
  "apiname": "daily",
  "fields": "tradedate,symbol,close",
  "params": {"symbols": "000001", "startdate": "20260801", "enddate": "20260820"}
}
```

普通请求用 `query`。一次请求即享受缓存合并：
- 同一范围重复请求 → 命中缓存（`cache-stats` 中 source 为 `cache`）。
- 扩大范围 → 代理只回源**缺失尾部**并合并（source 为 `merged`）。
- 收窄范围 → 命中缓存。

### 4. 处理错误
- 上游业务错误（如 `今日调用额度已用完` / `RATE_LIMIT_EXCEEDED`）是账号配额问题，
  代理已透传，需等次日或联系服务方，不是代理故障。
- 400 参数错误：重新 `show` 该接口，修正后重试。
- 无数据：先检查日期、代码、筛选；分布式行情在未成交日期本就无记录。
- 缓存被 `cache-clear` 清空后首次请求会正常回源。

## 配额体系

- **每日**：新申请 key 默认 **200 次/天**（可联系管理员调）。
- **每分钟**：单 key 每分钟 ≤ 30 次，超限 429 `RATE_EXCEEDED`。
- 成功请求扣 1 次配额（命中缓存也计 1）；`401` 不消耗；`429` 不再放行。
- **省配额**：用一次全量请求（`startdate~enddate` 覆盖整段）拉大范围，
  避免按日/按片多次小请求（每片独立计 1 次）。
- 用量查询：`GET https://stdb.rewish.top/api/usage?api_key=sk-xxx`。

## 用户持仓管理（按 API-Key 隔离）

你的持仓记录与你的 API-Key 绑定，完全独立（别人看不到、互不影响）。
所有持仓命令都用你自己的 key 鉴权，**不扣**数据配额。

```text
python scripts/stdb.py holdings-buy    --symbol 600111 --price 40.00 --qty 100 [--name 北方稀土] [--date 2026-09-01] [--time 10:30]
python scripts/stdb.py holdings-sell   --symbol 600111 --price 43.50 --qty 100 [--date 2026-09-02]
python scripts/stdb.py holdings-adjust --symbol 600111 --qty 600 --avg-cost 44.89 [--name 北方稀土]
python scripts/stdb.py holdings-flow   --symbol 600050 --kind dividend --amount 46.97 [--name 中国联通]
python scripts/stdb.py holdings-flow   --symbol 600050 --kind tax --amount 9.39 [--name 中国联通]
python scripts/stdb.py holdings-reset  --symbol 600111
python scripts/stdb.py holdings-list
python scripts/stdb.py t-ledger        --symbol 600111
python scripts/stdb.py t-analyze       --symbol 600111 [--cost-price 44.89] [--current-price 45.0] [--fee 5] [--lot-size 100]
python scripts/stdb.py t-analyze       --trades-file t_records.json [--symbol 600111] [--cost-price 44.89]
python scripts/stdb.py t-save          --symbol 600111 --trades-file t_records.json
```

**命令语义**（每笔交易默认 5 元手续费，已计入成本/盈亏）：

### 买入 / 卖出
- **买入** `holdings-buy --price --qty`：同标的合并成**加权平均成本**；买入手续费(5元)摊进成本。
- **卖出** `holdings-sell --price --qty`：按净额(价×量−手续费)冲减成本，卖出手续费(5元)已扣。
- **保本均价 = 累计成本 / 持股数**：低价卖出→均价上升（反映"清了亏"）；高价卖出→均价下降甚至为负（锁定盈利）。
- **跨清仓继承**：某个标的全部卖光(qty=0)后，它的累计盈亏(carry)仍挂留在该标的上，
  下次再买入会自动并入新成本——单标的的盈亏会一直跟随，直到 `holdings-reset` 才彻底清零。

### 配置成本（不含原始流水，从最近开始）
当你不提供最早的历史交易记录、只想从当前某笔持仓开始记账时，用 `holdings-adjust`
**直接设置**数量+成本，历史盈亏完全清零、全新起算：
```text
python scripts/stdb.py holdings-adjust --symbol 600111 --qty 600 --avg-cost 44.89 --name 北方稀土
```

### 股息分红 / 补税
- **股息** `holdings-flow --kind dividend --amount X`：分红入账=降成本(carry 减)，保本价下降。
- **补税** `holdings-flow --kind tax --amount X`：补缴红利税=额外支出(carry 加)，保本价上升。

### 查看 & 重置
- `holdings-list`：显示所有持仓，含**保本均价**、累计成本(carry)、结合最近收盘价算出的浮动盈亏/市值。
- `holdings-reset --symbol`：**彻底清空**该标的历史盈亏与持仓（仅当你确认要完全放弃该标的的累计收益时用）。

## T收益分析（单标的做 T 的收益核算 + 下次决策）

**数据来源**：`user_trades` 流水表（按 API-Key 隔离）。两个入口：
- **持仓路径**：`holdings-buy/sell`（及 adjust/dividend/tax/reset）自动写入流水；
  如需补录历史成交，给 `--date`/`--time`。
- **手动路径**：`t-save` 把 JSON 记录覆盖式保存为 `src=manual`。

```text
python scripts/stdb.py t-ledger  --symbol 600111                     # 看流水
python scripts/stdb.py t-analyze --symbol 600111                     # 分析该标的流水
python scripts/stdb.py t-analyze --trades-file t_records.json        # 分析临时记录(不落库)
python scripts/stdb.py t-save    --symbol 600111 --trades-file t_records.json   # 保存手动记录
```

`t_records.json` 示例（字段 `date` 必填，`time/side/price/qty/fee/note`，side 支持 buy/sell 或 买/卖）：

```json
[
  {"date":"2026-08-20","side":"sell","price":45.5,"qty":200},
  {"date":"2026-08-21","side":"buy","price":44.0,"qty":200}
]
```

**配对规则（FIFO 先进先出）**：一次完整 T = 一买一卖（数量相等），
收益 = (卖出价-买入价)×数量 − 双边手续费。先 T 出、跌了再 T 进（倒T）与先买后卖（正T）都被正确识别。

**返回报告**：`pairs[]`（每笔 T 的模式/买卖价/价差/收益/收益率/持仓成本影响）、
`pending`（未完成的待卖出/待买回）、`summary`（总收益/收益率/胜率/总手续费/倒T降成本）、
`context`（成本价/现价/浮盈亏）、`decisions`（下次做 T 决策：盈亏平衡公式 价差×数量=双边手续费，
含降本矩阵/建议数量等）。

**费用口径提示**：所有收益/盈亏/降本均未计印花税（卖出单边约 0.05%）。

## 整理结果

1. 根据响应 `data.fields` 顺序解释二维 `items`。
2. 优先采用 OpenAPI 中文字段说明（`show`）。
3. 股票代码、日期、标识符按字符串处理。
4. 金额/比例/数量按文档单位格式化，不猜单位。
5. 多条对比用紧凑表格，时间序列说明趋势/范围/关键节点。
6. 数据量大先概括再展示最相关部分。
7. 用户要求保存时再输出 CSV/JSON/文件。

最终答复跟随用户语言。

## 配置映射

- "查看代理状态/健康" → `status`
- "查 stdb 有没有某接口" → `search`
- "看某接口参数" → `show`
- "通过代理查行情" → `query`
- "看缓存命中率" → `cache-stats` / `cache-status`
- "清缓存" → `cache-clear`

共 6870 字符 · 与下载包同一份文档 · v1.14.0

MCP 版 · `stdb-mcp`

已配置 MCP 客户端的 agent 直接调用（13 个工具，无需脚本）；配置方式见「MCP 接入」页。

下载 zip（能装 skill 的 agent）

---
name: stdb-mcp
description: 通过 stdb MCP 服务(13 个工具)查询 A股、可转债、ETF、指数、交易日历、行情等金融数据，以及个人持仓记账与 T 收益分析。使用场景：环境已配置 stdb MCP server（工具形如 mcp_stdb_query / query / apply_key 等）。若环境没有 MCP 工具，改用 stdb-api skill（脚本/接口通道）。
---

# stdb 数据服务 · MCP 版

> 只想要**消息/资讯**？用 `stdb-news` skill——公开免费、无需 API-Key（每 30 分钟更新）。

你的环境已接入 **stdb MCP 服务**——数据查询、持仓记账、T 收益分析全部通过 MCP 工具完成，
**不需要** stdb.py 脚本、不需要拼 curl。本 Skill 是 **MCP 通道**；若你的环境没有 MCP 工具，请改用 `stdb-api` skill（两通道不混用）。

## 是什么 / 为什么

stdb 是金融数据的中转缓存服务，**多路高可用、交叉校验、全档K线**：
把上游数据镜像为统一 HTTP 接口（126 个 reference-proxy 接口），覆盖 A股 / ETF / 指数 /
可转债 / 龙虎榜 / 财务 / 资金流向 / 交易日历 / 集合竞价等。MCP 服务把这些接口包成 13 个工具，
agent 原生调用：先查缓存命中即返，未命中自动回源，响应统一为二维表结构。

## Agent 配置（一次性）

MCP 端点：`https://stdb.rewish.top/mcp`（Streamable HTTP）。

- **Hermes**：`~/.hermes/config.yaml` 加：
  ```yaml
  mcp_servers:
    stdb:
      url: "https://stdb.rewish.top/mcp"
  ```
  重启后工具以 `mcp_stdb_*` 前缀出现（如 `mcp_stdb_query`）。
- **Claude / 其他 MCP 客户端**：标准 MCP server 配置，url 同上。

工具名在不同客户端可能带前缀（Hermes `mcp_stdb_*`）或不带（`query`），下文按工具名描述。

## 首次使用（申请 API-Key）

1. **申请**：调用工具 `apply_key`（无需已有 key）。返回 `sk-xxx`：
   - ⚠️ **一个 IP/标识只能申请一个 key**；key **只在申请时显示一次**，
     请立即保存到密码管理器/安全存储。**遗失无法找回，需联系管理员重置**。
   - 同 IP 再次调用 `apply_key` 会返回同一个 key（`reused: true`），可当找回入口。
2. **保存并复用**：后续所有数据/持仓工具都传 `api_key` 参数 = 你保存的 key。
3. 未配置 key 时数据接口返回 `401 MISSING_KEY`，提示先 `apply_key`。

## 工具清单（13 个）

### 数据 / 目录（search/show 无需 key）
| 工具 | 用途 | 关键参数 |
|------|------|---------|
| `apply_key` | 自助申请 API-Key（一个 IP/标识一个，只显示一次）| — |
| `search` | 按关键词搜接口目录（126 个）| query |
| `show` | 看接口参数与返回字段 | interface（apiname 或 short_path，如 stock/daily）|
| `query` | **核心数据查询** | api_name, fields, params(JSON), api_key |
| `usage` | 查 Key 当日用量与额度 | api_key |

### 持仓 / 交易（按 API-Key 隔离，不扣数据配额）
| 工具 | 用途 | 关键参数 |
|------|------|---------|
| `holdings_list` | 查看我的持仓（保本均价/浮盈亏）| api_key |
| `holdings_buy` | 记录买入（加权成本，5 元手续费）| symbol, price, qty, api_key |
| `holdings_sell` | 记录卖出（净额冲减成本，5 元手续费）| symbol, price, qty, api_key |
| `holdings_adjust` | 配置成本（设数量+均价，历史盈亏清零）| symbol, qty, avg_cost, api_key |
| `holdings_flow` | 股息(dividend 降成本)/补税(tax 加成本) | symbol, kind, amount, api_key |
| `holdings_reset` | 彻底清空该标的持仓与历史盈亏（谨慎）| symbol, api_key |
| `t_ledger` | 查看做 T 交易流水 | symbol, api_key |
| `t_analyze` | T 收益分析（配对/胜率/降本矩阵）；**游客纯计算免 key**（传 cost_price+current_price）| symbol / cost_price+current_price, api_key |

## 查询工作流

### 1. 理解需求
识别数据对象、时间范围、证券代码、字段、筛选、排序、分页、展示要求。

### 2. 查找接口
先 `search("<关键词>")`（如"日线"），再 `show("stock/daily")` 看参数与字段。不要凭记忆拼参数。

### 3. 执行查询
```text
query(api_name="stock/daily", fields="tradedate,symbol,close",
      params='{"symbols":"600111","startdate":"20260901","enddate":"20260920"}',
      api_key="sk-xxx")
```
- `params` 是 JSON 字符串（日期格式 `YYYYMMDD`，多标的逗号分隔）。
- 一次请求即享受缓存合并：同范围重复请求命中缓存；扩大范围只回源缺失部分。
- 返回 `{ok, fields:[列名], items:[[行…]]}`——按 `fields` 顺序解释 `items`。

### 4. 处理错误
- `401 MISSING_KEY`：没传 key → 先 `apply_key` 并保存。
- `401 INVALID_KEY`：key 错误/停用 → 检查是否复制完整（只显示一次，易截断）。
- `RATE_LIMIT_EXCEEDED` / 今日额度用完：当日 200 次配额耗尽 → 等次日或联系管理员；省配额用一次全量请求覆盖整段。
- `未找到接口`：先 `search` / `show` 确认接口名。
- 无数据：先检查日期、代码、筛选；休市日/未成交日期本就无记录。

## 配额体系

- **每日**：默认 **200 次/天**；**每分钟** ≤ 30 次，超限 429。
- 成功请求扣 1 次配额（命中缓存也计 1）；`401` 不消耗。
- 持仓/交易工具（holdings_* / t_*）**不扣**数据配额。
- 用量查询：`usage(api_key)` 工具，或 `GET https://stdb.rewish.top/api/usage?api_key=sk-xxx`。

## 持仓管理（按 API-Key 隔离）

你的持仓与 API-Key 绑定，完全独立（别人看不到）。语义：

### 买入 / 卖出
- `holdings_buy(symbol, price, qty, api_key)`：同标的合并**加权平均成本**；手续费 5 元摊进成本。
- `holdings_sell(symbol, price, qty, api_key)`：按净额(价×量−手续费)冲减成本。
- **保本均价 = 累计成本 / 持股数**：低价卖出→均价上升；高价卖出→均价下降甚至为负。
- **跨清仓继承**：全部卖光后累计盈亏(carry)仍挂留在该标的，下次买入自动并入，直到 `holdings_reset` 才清零。

### 配置成本 / 股息补税 / 查看
- `holdings_adjust(symbol, qty, avg_cost, api_key)`：直接设数量+成本，历史盈亏清零（从当前开始记账用）。
- `holdings_flow(symbol, kind="dividend"|"tax", amount, api_key)`：股息降成本 / 补税加成本。
- `holdings_list(api_key)`：持仓列表（保本均价/累计成本/浮盈亏/市值）。
- `holdings_reset(symbol, api_key)`：**彻底清空**该标的历史盈亏与持仓（确认放弃才用）。

## T收益分析

- `t_ledger(symbol, api_key)`：看该标的交易流水。
- `t_analyze(symbol, api_key)`：分析流水 → `pairs[]`（每笔 T 模式/买卖价/收益）、`summary`（总收益/胜率/手续费）、`decisions`（下次做 T：价差×数量=双边手续费，含降本矩阵）。
- `t_analyze(cost_price=…, current_price=…)`：**游客纯计算**（不读持仓/流水，免 key）——给定成本价+现价即可算做 T 决策。
- 配对规则 FIFO：一次完整 T = 一买一卖数量相等；倒 T（先卖后买）与正 T 都正确识别。
- 费用口径：每笔默认 5 元手续费已计入；未计印花税（卖出单边约 0.05%）。

## 整理结果

1. 按 `fields` 顺序解释 `items` 二维数组。
2. 优先用 `show` 的中文字段说明。
3. 股票代码、日期按字符串处理；金额/比例按文档单位格式化，不猜单位。
4. 多条对比用紧凑表格，时间序列说明趋势/范围/关键节点。
5. 数据量大先概括再展示最相关部分；用户要求保存时再输出 CSV/JSON/文件。
6. 最终答复跟随用户语言。

## 配置映射

- "查行情/数据" → `query`（先 `search`/`show` 确认接口）
- "申请 key" → `apply_key`
- "查用量" → `usage`
- "查/记持仓" → `holdings_*`
- "T 收益分析" → `t_analyze` / `t_ledger`
- **不混用通道**：本 Skill 只用 MCP 工具；环境里若出现 `stdb.py` 脚本或 REST 调用需求，那是 stdb-api 通道，不要在 MCP 场景混用。

共 4759 字符 · 与下载包同一份文档 · v1.14.0

AI Skill 安装（含"只能创建自定义 skill"的用法）

📱 手机端添加 skill？扫码直达复制页

消息版 · `stdb-news`

接口版 · `stdb-api`

MCP 版 · `stdb-mcp`

复制之后怎么用

AI Skill 安装（含"只能创建自定义 skill"的用法）

📱 手机端添加 skill？扫码直达复制页

消息版 · stdb-news

接口版 · stdb-api

MCP 版 · stdb-mcp

复制之后怎么用

消息版 · `stdb-news`

接口版 · `stdb-api`

MCP 版 · `stdb-mcp`