> ## Documentation Index
> Fetch the complete documentation index at: https://www.worldmonitor.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Premium 股票分析

> Premium 股票分析支持按股票代码按需生成完整的基本面与技术面综合分析报告，附带明确的买入、持有、卖出交易信号、多档价格目标区间、华尔街分析师共识评级、近期评级升降调整记录、公司高管内部人买卖交易明细以及可视化的价格走势迷你图，为个股深度研究、组合构建与投资决策提供统一工作区。

**Premium Stock Analysis** 面板（内部 id `stock-analysis`）是仪表盘的按代码深度分析：一次一个分析，包含信号的结构化综合（买入/持有/卖出）、价格目标、分析师共识、近期评级升降、内部人交易和价格迷你图。由 Market service 的分析师/价格目标/内部人 RPC 支持。

## 面板显示内容

每个所选代码一张分析卡片。每张卡片渲染：

* **代码 + 价格** — 当前价格，带货币格式化（`formatPrice()`），今日百分比变化（`formatChange()`）。
* **信号徽章** — `Buy` / `Hold` / `Watch` / `Sell`，通过 `stockSignalClass()` 分类为看涨/中性/看跌视觉桶。
* **论点要点** — 通过 `list()` 渲染为消毒后的 `<ul>`。
* **分析师共识** — 来自生成的 Market service 客户端的 `AnalystConsensus` 形状。
* **价格目标** — 来自 `PriceTarget[]` 的低/平均/高。
* **近期评级升降** — `UpgradeDowngrade[]` 列表。
* **内部人交易** — 来自 `InsiderTransactionsResult` 的文件，通过 `setInsiderData(symbol, data)` 单独附加。
* **迷你图** — 通过 `@/utils/sparkline` 渲染的价格历史。
* **历史** — 同一代码的先前分析保存在 `StockAnalysisHistory` 中。

面板 id 为 `stock-analysis`；规范组件为 `src/components/StockAnalysisPanel.ts`。标题 "Premium Stock Analysis" 来自面板自身的 `super({...})` 调用。

## 如何访问

* **Cmd+K**：输入 *stock* 或代码符号。
* **按变体的可用性**：在 **full/geopolitical** 和 **finance** 变体中注册并默认启用 — 两者均锁定。在 tech、commodity 或 happy 变体中不存在。来源：`src/config/panels.ts:49` 和 `:422` 处 `FULL_PANELS` 和 `FINANCE_PANELS` 中的 `'stock-analysis'` 条目。

## 数据来源

所有字段来自生成的 `MarketServiceClient` 路由。面板已锁定，付费股票分析调用使用 `premiumFetch`；内部人富化路由仅在此锁定面内渲染。

| 方法 + 路由                                         | 支撑内容                                      |
| ----------------------------------------------- | ----------------------------------------- |
| `GET /api/market/v1/analyze-stock`              | 按代码分析卡片：当前价格、迷你图、技术信号、论点、目标、评级、标题与 AI 综合。 |
| `GET /api/market/v1/get-stock-analysis-history` | 缓存/共享的先前分析，使面板可在重新计算陈旧代码之前渲染已存储快照。        |
| `GET /api/market/v1/get-insider-transactions`   | 内部人活动板块，在分析卡片渲染后附加。                       |

## 刷新频率

分析按需进行；无轮询。面板在 `StockAnalysisHistory` 中缓存先前分析，因此重新打开一个代码会立即显示上次分析，同时获取新的分析。

## 层级与门控

**PRO（硬锁定）。** 两个变体注册中的 `premium: 'locked'`。当存在有效的 `WORLDMONITOR_API_KEY` **或** `isPro` 为 true 时，`isPanelEntitled` 解锁该面板（`stock-analysis` 在 `src/config/panels.ts:973` 的 `apiKeyPanels` 允许列表中）。

## API 参考

* [Markets service](/api/MarketService.openapi.yaml) — `analyze-stock`、`get-stock-analysis-history` 与 `get-insider-transactions` 的 schema 和参数。
* 相关：[Premium 回测](/zh/panels/stock-backtest) — 同一数据集的回测面。