better-dsh 0.2.5 → 0.3.0

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/finance/finance-merger-model.md

@@ -1,162 +0,0 @@
----
-title: "并购模型 — 在 Excel 中构建增厚/摊薄（并购）模型 — 备考损益表、协同效应、融资结构、每股收益影响"
-sidebar_label: "Merger Model"
-description: "在 Excel 中构建增厚/摊薄（并购）模型 — 备考损益表、协同效应、融资结构、每股收益影响"
----
-
-{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
-
-# Merger Model
-
-在 Excel 中构建增厚/摊薄（并购）模型 — 备考损益表、协同效应、融资结构、每股收益影响。与 excel-author 配合使用。适用于并购提案、董事会材料或交易评估。
-
-## Skill 元数据
-
-| | |
-|---|---|
-| 来源 | 可选 — 通过 `hermes skills install official/finance/merger-model` 安装 |
-| 路径 | `optional-skills/finance/merger-model` |
-| 版本 | `1.0.0` |
-| 作者 | Anthropic（由 Nous Research 改编） |
-| 许可证 | Apache-2.0 |
-| 平台 | linux, macos, windows |
-| 标签 | `finance`, `m-and-a`, `merger`, `accretion-dilution`, `excel`, `openpyxl`, `modeling`, `investment-banking` |
-| 相关 skill | [`excel-author`](/user-guide/skills/optional/finance/finance-excel-author), [`pptx-author`](/user-guide/skills/optional/finance/finance-pptx-author), [`dcf-model`](/user-guide/skills/optional/finance/finance-dcf-model), [`3-statement-model`](/user-guide/skills/optional/finance/finance-3-statement-model) |
-
-## 参考：完整 SKILL.md
-
-:::info
-以下是 Hermes 在触发该 skill 时加载的完整 skill 定义。这是 skill 激活时 agent 所看到的指令内容。
-:::
-
-## 环境
-
-本 skill 假定使用**无界面 openpyxl** — 即在磁盘上生成 .xlsx 文件。
-遵循 `excel-author` skill 关于单元格着色、公式、命名区域和敏感性表格的约定。
-交付前重新计算：`python /path/to/excel-author/scripts/recalc.py ./out/model.xlsx`。
-
-# Merger Model
-
-为并购交易构建增厚/摊薄分析。对备考每股收益影响、协同效应敏感性及购买价格分配进行建模。适用于评估潜在收购、为提案准备并购影响分析，或就交易条款提供建议。
-
-## 工作流程
-
-### 第一步：收集输入数据
-
-**收购方：**
-- 公司名称、当前股价、流通股数
-- LTM 和 NTM 每股收益（GAAP 及调整后）
-- 市盈率倍数
-- 税前债务成本、税率
-- 资产负债表上的现金、现有债务
-
-**目标方：**
-- 公司名称、当前股价、流通股数（如为上市公司）
-- LTM 和 NTM 每股收益或净利润
-- 企业价值或股权价值
-
-**交易条款：**
-- 每股要约价格（或相对当前价格的溢价）
-- 对价结构：现金比例 vs. 股票比例
-- 为现金部分融资而新增的债务
-- 预期协同效应（收入和成本）及分阶段时间表
-- 交易费用和融资成本
-- 预期交割日期
-
-### 第二步：购买价格分析
-
-| 项目 | 金额 |
-|------|-------|
-| 每股要约价格 | |
-| 相对当前价格的溢价 | |
-| 股权价值 | |
-| 加：承接净债务 | |
-| 企业价值 | |
-| 隐含 EV / EBITDA | |
-| 隐含市盈率 | |
-
-### 第三步：资金来源与用途
-
-| 来源 | $ | 用途 | $ |
-|---------|---|------|---|
-| 新增债务 | | 股权收购价格 | |
-| 自有现金 | | 偿还目标方债务 | |
-| 新发行股票 | | 交易费用 | |
-| | | 融资费用 | |
-| **合计** | | **合计** | |
-
-### 第四步：备考每股收益（增厚/摊薄）
-
-逐年计算（第 1-3 年）：
-
-| | 独立口径 | 备考口径 | 增厚/（摊薄） |
-|---|-----------|-----------|---------------------|
-| 收购方净利润 | | | |
-| 目标方净利润 | | | |
-| 协同效应（税后） | | | |
-| 动用现金的利息损失（税后） | | | |
-| 新增债务利息（税后） | | | |
-| 无形资产摊销（税后） | | | |
-| 备考净利润 | | | |
-| 备考股份数 | | | |
-| **备考每股收益** | | | |
-| **增厚/（摊薄）%** | | | |
-
-### 第五步：敏感性分析
-
-**增厚/摊薄 vs. 协同效应与要约溢价：**
-
-| | 协同效应 $0M | 协同效应 $25M | 协同效应 $50M | 协同效应 $75M | 协同效应 $100M |
-|---|---------|----------|----------|----------|-----------|
-| 溢价 15% | | | | | |
-| 溢价 20% | | | | | |
-| 溢价 25% | | | | | |
-| 溢价 30% | | | | | |
-
-**增厚/摊薄 vs. 现金/股票对价结构：**
-
-| | 100% 现金 | 75/25 | 50/50 | 25/75 | 100% 股票 |
-|---|-----------|-------|-------|-------|------------|
-| 第 1 年 | | | | | |
-| 第 2 年 | | | | | |
-
-### 第六步：盈亏平衡协同效应
-
-计算交易在第 1 年实现每股收益中性所需的最低协同效应。
-
-### 第七步：输出
-
-- Excel 工作簿，包含：
-  - 假设条件标签页
-  - 资金来源与用途
-  - 备考利润表
-  - 增厚/摊薄汇总
-  - 敏感性表格
-  - 盈亏平衡分析
-- 用于提案材料的单页并购影响摘要
-
-## 重要说明
-
-- 在相关情况下，始终同时展示 GAAP 和调整后（现金）每股收益
-- 股票交易：使用收购方当前股价计算换股比例，并注明新发行股份带来的稀释效应
-- 包含购买价格分配 — 商誉和无形资产摊销对 GAAP 每股收益至关重要
-- 协同效应分阶段实现至关重要 — 第 1 年通常仅为运行率协同效应的 25%-50%
-- 不要遗漏动用现金的利息损失收入及新增债务的利息支出
-- 协同效应和利息调整的税率应与收购方的边际税率保持一致
-
-
-## 数据来源 — 优先使用 MCP，其次使用网络
-
-以下部分内容提及"使用 S&P Kensho MCP / Daloopa MCP / FactSet MCP"。这些是原 Cowork 插件场景中的商业金融数据 MCP。在 Hermes 中：
-
-- **如已配置任何结构化金融数据 MCP**（Hermes 支持 MCP — 参见 `native-mcp` skill），优先用于时点可比数据、前例交易及文件。
-- **否则**，回退至：
-  - 针对 SEC EDGAR（`https://www.sec.gov/cgi-bin/browse-edgar`）使用 `web_search` / `web_extract` 获取美国文件
-  - 公司投资者关系页面获取新闻稿、财报材料
-  - 使用 `browser_navigate` 访问交互式数据门户
-  - 用户提供的数据（当上下文中没有时，明确向用户询问）
-- **严禁捏造数据**。如果某个倍数、前例交易或文件数字无法溯源，将该单元格标记为 `[UNSOURCED]` 并告知用户。
-
-## 归属声明
-
-本 skill 改编自 Anthropic 的 Claude for Financial Services 插件套件（Apache-2.0）。Office-JS / Cowork 实时 Excel 路径已移除；本版本通过 `excel-author` skill 的约定，面向无界面 openpyxl。原始来源：https://github.com/anthropics/financial-services

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/finance/finance-polymarket.md

@@ -1,94 +0,0 @@
----
-title: "Polymarket — 查询 Polymarket：市场、价格、订单簿、历史记录"
-sidebar_label: "Polymarket"
-description: "查询 Polymarket：市场、价格、订单簿、历史记录"
----
-
-{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
-
-# Polymarket
-
-查询 Polymarket：市场、价格、订单簿、历史记录。
-
-## Skill 元数据
-
-| | |
-|---|---|
-| 来源 | 可选 — 通过 `hermes skills install official/finance/polymarket` 安装 |
-| 路径 | `optional-skills/finance/polymarket` |
-| 版本 | `1.0.0` |
-| 作者 | Hermes Agent + Teknium |
-| 平台 | linux, macos, windows |
-
-## 参考：完整 SKILL.md
-
-:::info
-以下是 Hermes 在触发此 skill 时加载的完整 skill 定义。这是 agent 在 skill 激活时所看到的指令内容。
-:::
-
-# Polymarket — 预测市场数据
-
-使用 Polymarket 的公开 REST API 查询预测市场数据。
-所有端点均为只读，无需任何身份验证。
-
-完整端点参考及 curl 示例请见 `references/api-endpoints.md`。
-
-## 使用场景
-
-- 用户询问预测市场、博彩赔率或事件概率
-- 用户想了解"X 发生的概率是多少？"
-- 用户专门询问 Polymarket
-- 用户需要市场价格、订单簿数据或价格历史
-- 用户希望监控或追踪预测市场动态
-
-## 核心概念
-
-- **Events（事件）** 包含一个或多个 **Markets（市场）**（1:many 关系）
-- **Markets** 是二元结果，Yes/No 价格区间为 0.00 到 1.00
-- 价格即概率：价格 0.65 表示市场认为该事件有 65% 的可能性发生
-- `outcomePrices` 字段：JSON 编码的数组，格式如 `["0.80", "0.20"]`
-- `clobTokenIds` 字段：包含两个 token ID 的 JSON 编码数组 [Yes, No]，用于价格/订单簿查询
-- `conditionId` 字段：十六进制字符串，用于价格历史查询
-- 成交量单位为 USDC（美元）
-
-## 三个公开 API
-
-1. **Gamma API**，地址 `gamma-api.polymarket.com` — 发现、搜索、浏览
-2. **CLOB API**，地址 `clob.polymarket.com` — 实时价格、订单簿、历史记录
-3. **Data API**，地址 `data-api.polymarket.com` — 交易记录、未平仓合约
-
-## 典型工作流程
-
-当用户询问预测市场赔率时：
-
-1. **搜索** — 使用 Gamma API 的 public-search 端点，传入用户的查询词
-2. **解析** — 处理响应，提取 events 及其嵌套的 markets
-3. **展示** — 市场问题、当前价格（以百分比表示）及成交量
-4. **深入分析** — 如有需要，使用 `clobTokenIds` 查询订单簿，使用 `conditionId` 查询历史记录
-
-## 结果展示
-
-将价格格式化为百分比以提高可读性：
-- `outcomePrices` 为 `["0.652", "0.348"]` 时，展示为"Yes: 65.2%，No: 34.8%"
-- 始终显示市场问题和概率
-- 有成交量时一并展示
-
-示例：`"Will X happen?" — 65.2% Yes（成交量 $1.2M）`
-
-## 解析双重编码字段
-
-Gamma API 返回的 `outcomePrices`、`outcomes` 和 `clobTokenIds` 是 JSON 响应中的 JSON 字符串（双重编码）。在 Python 中处理时，需使用 `json.loads(market['outcomePrices'])` 解析以获取实际数组。
-
-## 速率限制
-
-限制宽松，正常使用基本不会触发：
-- Gamma：每 10 秒 4,000 次请求（通用）
-- CLOB：每 10 秒 9,000 次请求（通用）
-- Data：每 10 秒 1,000 次请求（通用）
-
-## 限制说明
-
-- 此 skill 为只读模式，不支持下单交易
-- 交易需要基于钱包的加密身份验证（EIP-712 签名）
-- 部分新市场的价格历史可能为空
-- 交易受地理限制，但只读数据在全球范围内均可访问

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/finance/finance-pptx-author.md

@@ -1,191 +0,0 @@
----
-title: "Pptx Author — 使用 python-pptx 无头构建 PowerPoint 演示文稿"
-sidebar_label: "Pptx Author"
-description: "使用 python-pptx 无头构建 PowerPoint 演示文稿"
----
-
-{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
-
-# Pptx Author
-
-使用 python-pptx 无头构建 PowerPoint 演示文稿。与 excel-author 配合使用，可构建每个数字都追溯到工作簿单元格的模型驱动演示文稿。适用于融资路演材料、IC 备忘录、盈利说明。
-
-## Skill 元数据
-
-| | |
-|---|---|
-| 来源 | 可选 — 通过 `hermes skills install official/finance/pptx-author` 安装 |
-| 路径 | `optional-skills/finance/pptx-author` |
-| 版本 | `1.0.0` |
-| 作者 | Anthropic（由 Nous Research 改编） |
-| 许可证 | Apache-2.0 |
-| 平台 | linux, macos, windows |
-| 标签 | `powerpoint`, `pptx`, `python-pptx`, `presentation`, `finance` |
-| 相关 skill | [`excel-author`](/user-guide/skills/optional/finance/finance-excel-author), [`powerpoint`](/user-guide/skills/bundled/productivity/productivity-powerpoint) |
-
-## 参考：完整 SKILL.md
-
-:::info
-以下是 Hermes 在触发此 skill 时加载的完整 skill 定义。这是 skill 激活时 agent 所看到的指令内容。
-:::
-
-# pptx-author
-
-使用 `python-pptx` 在磁盘上生成 .pptx 文件。当需要将演示文稿作为文件产物交付，而非驱动实时 PowerPoint 会话时使用。
-
-改编自 Anthropic 在 [anthropics/financial-services](https://github.com/anthropics/financial-services) 中的 `pptx-author` 和 `pitch-deck` skill。原版中的 MCP / Office-JS 分支已移除 — 本 skill 假定使用无头 Python。
-
-如需更全面的、已内置的 PowerPoint 创作 skill（幻灯片、演讲者备注、嵌入、媒体），请参阅内置的 `powerpoint` skill。本 skill 是一个更轻量的模式，专为模型驱动的演示文稿（融资路演、IC 备忘录、盈利说明）调优，要求每个数字都必须追溯到源工作簿。
-
-## 输出约定
-
-- 写入 `./out/<name>.pptx`。如果 `./out/` 不存在则创建。
-- 在最终消息中返回相对路径。
-
-## 安装
-
-```bash
-pip install "python-pptx>=0.6"
-```
-
-## 核心约定
-
-### 每张幻灯片一个观点
-标题陈述结论；正文支撑结论。标题为"Q3 Revenue"的幻灯片表达力弱；"Revenue growth accelerated to 14% Y/Y in Q3"则更有力。
-
-### 每个数字都追溯到模型
-如果幻灯片上的数字来自 `./out/model.xlsx`，则在脚注中注明工作表和单元格。
-
-```
-Revenue: $1,250M  (Source: model.xlsx, Inputs!C3)
-```
-
-切勿凭记忆或摘要转录数字 — 打开工作簿，读取命名区域，并在可能的情况下以编程方式将演示文稿中的值绑定到工作簿。
-
-### 存在公司模板时使用公司模板
-如果 `./templates/firm-template.pptx` 存在，则加载它，使演示文稿继承品牌颜色、字体和母版布局。
-
-```python
-from pptx import Presentation
-from pathlib import Path
-
-template = Path("./templates/firm-template.pptx")
-prs = Presentation(str(template)) if template.exists() else Presentation()
-```
-
-### 图表：从模型导出 PNG 优于原生 pptx 图表
-当保真度要求较高时（模型的图表样式必须与演示文稿完全匹配），从源工作簿将图表渲染为 PNG 并嵌入图片。原生 `pptx.chart` 图表较脆弱，且通常不符合公司规范。
-
-```python
-from pptx.util import Inches
-slide.shapes.add_picture("./out/charts/football_field.png",
-                         Inches(1), Inches(2),
-                         width=Inches(8))
-```
-
-### 不对外发送
-本 skill 只写入文件，不发送邮件、上传或发布。交付由编排层处理。
-
-## 骨架代码
-
-```python
-from pptx import Presentation
-from pptx.util import Inches, Pt
-from pptx.dml.color import RGBColor
-from pathlib import Path
-
-template = Path("./templates/firm-template.pptx")
-prs = Presentation(str(template)) if template.exists() else Presentation()
-
-# Title slide
-slide = prs.slides.add_slide(prs.slide_layouts[0])
-slide.shapes.title.text = "Project Aurora — Strategic Alternatives"
-slide.placeholders[1].text = "Preliminary Discussion Materials"
-
-# Valuation summary slide (title-only layout)
-slide = prs.slides.add_slide(prs.slide_layouts[5])
-slide.shapes.title.text = "Valuation implies $38–$52 per share across methodologies"
-
-# Add a table bound to model outputs
-rows, cols = 5, 4
-tbl_shape = slide.shapes.add_table(rows, cols,
-                                   Inches(0.5), Inches(1.5),
-                                   Inches(9), Inches(3))
-tbl = tbl_shape.table
-headers = ["Methodology", "Low ($)", "Mid ($)", "High ($)"]
-for c, h in enumerate(headers):
-    tbl.cell(0, c).text = h
-
-# In a real deck, read these from the model workbook with openpyxl
-data = [
-    ("Trading comps",     "35", "41", "48"),
-    ("Precedent M&A",     "39", "45", "52"),
-    ("DCF (base)",        "36", "43", "51"),
-    ("LBO (10% IRR)",     "33", "38", "44"),
-]
-for r, row in enumerate(data, start=1):
-    for c, val in enumerate(row):
-        tbl.cell(r, c).text = val
-
-# Embed a chart rendered from the model
-slide = prs.slides.add_slide(prs.slide_layouts[5])
-slide.shapes.title.text = "Football field — current price $42"
-slide.shapes.add_picture("./out/charts/football_field.png",
-                         Inches(1), Inches(1.8), width=Inches(8))
-
-Path("./out").mkdir(exist_ok=True)
-prs.save("./out/pitch-aurora.pptx")
-```
-
-## 将演示文稿数字绑定到源工作簿
-
-从 Excel 模型中读取命名区域或特定单元格，确保演示文稿中的数字不会偏离。
-
-```python
-from openpyxl import load_workbook
-
-wb = load_workbook("./out/model.xlsx", data_only=True)
-def nr(name):
-    """Resolve a named range to its current computed value."""
-    rng = wb.defined_names[name]
-    sheet, coord = next(rng.destinations)
-    return wb[sheet][coord].value
-
-revenue_fy24 = nr("RevenueFY24")
-implied_mid  = nr("ImpliedSharePriceBase")
-```
-
-然后使用这些值构建演示文稿内容：
-```python
-slide.shapes.title.text = f"Implied share price of ${implied_mid:.2f} (base case)"
-```
-
-请记住在读取工作簿之前重新计算 — openpyxl 只有在工作表已经被计算过的情况下才能看到计算值。请先运行 `excel-author` skill 中的重算辅助函数，或通过真实的 Excel 会话打开并保存。
-
-## 融资路演幻灯片类型清单
-
-典型的投行融资路演演示文稿遵循以下结构。不作强制要求，但可作为起始骨架参考：
-
-1. 封面 / 标题页
-2. 免责声明
-3. 目录
-4. 情况概述
-5. 公司概况（目标公司）
-6. 市场 / 行业背景
-7. 估值摘要（football field）— 核心幻灯片
-8. 可比交易详情
-9. 先例交易详情
-10. DCF 摘要
-11. 示意性 LBO / 财务投资人情景
-12. 流程考量
-13. 附录
-
-## 不适用本 skill 的情形
-
-- 用户正在进行实时 PowerPoint 会话且有 Office MCP 可用 — 应直接驱动其实时文档。
-- 非金融类幻灯片（季度全员会议、市场营销演示文稿）— 使用更全面的 `powerpoint` skill。
-- 包含大量动画、切换效果或演讲者备注的演示文稿 — 使用更全面的 `powerpoint` skill。
-
-## 致谢
-
-约定改编自 Anthropic 的 Claude for Financial Services 插件套件，采用 Apache-2.0 许可证。原始来源：https://github.com/anthropics/financial-services/tree/main/plugins/agent-plugins/pitch-agent/skills/pptx-author

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/finance/finance-stocks.md

@@ -1,108 +0,0 @@
----
-title: "Stocks — 通过 Yahoo 获取股票报价、历史、搜索、比较及加密货币数据"
-sidebar_label: "Stocks"
-description: "通过 Yahoo 获取股票报价、历史、搜索、比较及加密货币数据"
----
-
-{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
-
-# Stocks
-
-通过 Yahoo 获取股票报价、历史、搜索、比较及加密货币数据。
-
-## Skill 元数据
-
-| | |
-|---|---|
-| 来源 | 可选 — 使用 `hermes skills install official/finance/stocks` 安装 |
-| 路径 | `optional-skills/finance/stocks` |
-| 版本 | `0.1.0` |
-| 作者 | Mibay (Mibayy), Hermes Agent |
-| 许可证 | MIT |
-| 平台 | linux, macos, windows |
-| 标签 | `Stocks`, `Finance`, `Market`, `Crypto`, `Investing` |
-| 相关 skill | [`dcf-model`](/user-guide/skills/optional/finance/finance-dcf-model), [`comps-analysis`](/user-guide/skills/optional/finance/finance-comps-analysis), [`lbo-model`](/user-guide/skills/optional/finance/finance-lbo-model) |
-
-## 参考：完整 SKILL.md
-
-:::info
-以下是 Hermes 在触发此 skill 时加载的完整 skill 定义。这是 agent 在 skill 激活时所看到的指令内容。
-:::
-
-# Stocks Skill
-
-通过 Yahoo Finance 提供只读市场数据。五个命令：`quote`、`search`、
-`history`、`compare`、`crypto`。仅使用 Python 标准库——无需 API key，无需 pip
-安装。Yahoo 的接口为非官方接口，可能存在频率限制或发生变更。
-
-## 使用场景
-
-- 用户询问当前股票价格（AAPL、TSLA、MSFT 等）
-- 用户希望通过公司名称查找股票代码
-- 用户需要 OHLCV 历史数据或某日期范围内的表现
-- 用户希望并排比较多个股票代码
-- 用户询问加密货币价格（BTC、ETH、SOL 等）
-
-## 前置条件
-
-仅需 Python 3.8+ 标准库。可选：设置 `ALPHA_VANTAGE_KEY` 以在 Yahoo 的 crumb 保护字段返回 null 时补充 `market_cap`、`pe_ratio` 及 52 周高低点数据。免费 key 申请：https://www.alphavantage.co/support/#api-key
-
-## 运行方式
-
-通过 `terminal` 工具调用。安装完成后：
-
-```
-SCRIPT=~/.hermes/skills/finance/stocks/scripts/stocks_client.py
-python3 $SCRIPT quote AAPL
-```
-
-所有输出均为 stdout 上的 JSON——如需切片处理，可通过管道传给 `jq`。
-
-## 快速参考
-
-```
-python3 $SCRIPT quote AAPL
-python3 $SCRIPT quote AAPL MSFT GOOGL TSLA
-python3 $SCRIPT search "Tesla"
-python3 $SCRIPT history NVDA --range 6mo
-python3 $SCRIPT compare AAPL MSFT GOOGL
-python3 $SCRIPT crypto BTC ETH SOL
-```
-
-## 命令
-
-### `quote SYMBOL [SYMBOL2 ...]`
-
-当前价格、涨跌额、涨跌幅、成交量、52 周高低点。
-
-### `search QUERY`
-
-通过公司名称查找股票代码。返回前 5 条结果：代码、名称、交易所、类型。
-
-### `history SYMBOL [--range RANGE]`
-
-每日 OHLCV 数据及统计信息（最小值、最大值、均值、总回报率 %）。时间范围：`1mo`、
-`3mo`、`6mo`、`1y`、`5y`。默认：`1mo`。
-
-### `compare SYMBOL1 SYMBOL2 [...]`
-
-并排对比：价格、涨跌幅、52 周表现。
-
-### `crypto SYMBOL [SYMBOL2 ...]`
-
-加密货币价格。传入 `BTC`（脚本会自动追加 `-USD`）。
-
-## 注意事项
-
-- Yahoo Finance 的 API 为非官方接口。接口可能在未通知的情况下发生变更或触发频率限制——如果请求开始失败，原因即在于此。
-- 当 Yahoo 的 crumb 会话未建立时，`quote` 命令中的 `market_cap` 和 `pe_ratio` 可能返回 null。设置 `ALPHA_VANTAGE_KEY` 可进行补充。
-- 批量请求之间请添加适当延迟，以避免触发频率限制。
-- 本 skill 为只读——不支持下单，不集成账户。
-
-## 验证
-
-```
-python3 ~/.hermes/skills/finance/stocks/scripts/stocks_client.py quote AAPL
-```
-
-返回包含 `symbol: "AAPL"` 及数值型 `price` 字段的 JSON 对象。