stock-analysis-plugin 0.2.0__tar.gz → 0.2.2__tar.gz

{stock_analysis_plugin-0.2.0 → stock_analysis_plugin-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: stock-analysis-plugin
-Version: 0.2.0
+Version: 0.2.2
 Summary: Hermes plugin for stock analysis, screening, and strategy backtesting across A/HK/US/JP/KR/TW markets
 Project-URL: Homepage, https://github.com/Weaxs/stock-analysis-plugin
 Project-URL: Repository, https://github.com/Weaxs/stock-analysis-plugin
@@ -266,7 +266,7 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
 | 工具 | 说明 |
 |------|------|
 | `get_kline` | K 线数据（OHLCV），支持日/周/月线 |
-| `get_quote` | 实时行情快照 |
+| `get_quote` | 实时行情快照（非交易时段返回最近交易日收盘价并以 as_of/stale 标注） |
 | `get_capital_flow` | 资金流向（仅 A 股） |
 | `get_news` | 个股相关新闻 |
 | `get_financials` | 财务指标 |
@@ -277,8 +277,8 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
 | `get_sector_constituents` | 板块成分股查询（仅 A 股，板块名模糊匹配） |
 | `resolve_stock_sectors` | 个股所属板块查询（A 股行业+概念 / 港股 GICS） |
 | `get_market_stats` | 市场统计（涨跌家数、涨停等） |
-| `get_limit_up_pool` | 涨停池/涨停板复盘（连板数、封板资金、炸板次数等，仅 A 股） |
-| `get_dragon_tiger` | 龙虎榜（净买额/上榜原因/解读，仅 A 股） |
+| `get_limit_up_pool` | 涨停池/涨停板复盘（连板数、封板资金、炸板次数等，仅 A 股；非交易日自动回退到最近交易日并以 requested_date/stale 标注） |
+| `get_dragon_tiger` | 龙虎榜（净买额/上榜原因/解读，仅 A 股；非交易日自动回退到最近交易日并以 requested_date/stale 标注） |
 | `get_hot_stocks` | 全市场人气热搜榜（东财→雪球→百度，仅 A 股） |
 | `get_fundamental_context` | 基本面综合上下文 |
 

{stock_analysis_plugin-0.2.0 → stock_analysis_plugin-0.2.2}/README.md

@@ -236,7 +236,7 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
 | 工具 | 说明 |
 |------|------|
 | `get_kline` | K 线数据（OHLCV），支持日/周/月线 |
-| `get_quote` | 实时行情快照 |
+| `get_quote` | 实时行情快照（非交易时段返回最近交易日收盘价并以 as_of/stale 标注） |
 | `get_capital_flow` | 资金流向（仅 A 股） |
 | `get_news` | 个股相关新闻 |
 | `get_financials` | 财务指标 |
@@ -247,8 +247,8 @@ Agent 会自动调用行情 → 技术面 → 基本面 → 资金面 → 消息
 | `get_sector_constituents` | 板块成分股查询（仅 A 股，板块名模糊匹配） |
 | `resolve_stock_sectors` | 个股所属板块查询（A 股行业+概念 / 港股 GICS） |
 | `get_market_stats` | 市场统计（涨跌家数、涨停等） |
-| `get_limit_up_pool` | 涨停池/涨停板复盘（连板数、封板资金、炸板次数等，仅 A 股） |
-| `get_dragon_tiger` | 龙虎榜（净买额/上榜原因/解读，仅 A 股） |
+| `get_limit_up_pool` | 涨停池/涨停板复盘（连板数、封板资金、炸板次数等，仅 A 股；非交易日自动回退到最近交易日并以 requested_date/stale 标注） |
+| `get_dragon_tiger` | 龙虎榜（净买额/上榜原因/解读，仅 A 股；非交易日自动回退到最近交易日并以 requested_date/stale 标注） |
 | `get_hot_stocks` | 全市场人气热搜榜（东财→雪球→百度，仅 A 股） |
 | `get_fundamental_context` | 基本面综合上下文 |
 

{stock_analysis_plugin-0.2.0 → stock_analysis_plugin-0.2.2}/dsh/index.ts

@@ -147,7 +147,7 @@ export function apply(ctx: Context) {
   ctx.tools.register(
     pyTool({
       name: "get_quote",
-      description: "获取股票实时行情报价（现价、涨跌幅、量比等）。支持A股、港股、美股、日股、韩股、台股",
+      description: "获取股票实时行情报价（现价、涨跌幅、量比等）。支持A股、港股、美股、日股、韩股、台股；非交易时段返回最近交易日收盘价并以 as_of/stale 标注",
       parameters: {
         symbol: { type: "string", required: true, description: "股票代码（A股如600519，美股如AAPL，港股如00700.HK）" },
       },
@@ -402,7 +402,7 @@ export function apply(ctx: Context) {
       description:
         "获取A股涨停池/涨停板复盘——当日涨停个股，含连板数、封板资金、炸板次数、首末次封板时间、所属行业。短线情绪与龙头战法核心数据",
       parameters: {
-        date: { type: "string", description: "日期（YYYYMMDD），默认当日" },
+        date: { type: "string", description: "日期（YYYYMMDD），默认当日；非交易日或未来日期自动回退到最近交易日（返回含 requested_date 与 stale 标注）" },
       },
       script: "stock_data.py",
       argv: (p) => {
@@ -419,7 +419,7 @@ export function apply(ctx: Context) {
       description:
         "获取A股龙虎榜——上榜个股净买额/买入额/卖出额/上榜原因/解读，可按个股过滤",
       parameters: {
-        date: { type: "string", description: "日期（YYYY-MM-DD），默认当日" },
+        date: { type: "string", description: "日期（YYYY-MM-DD），默认当日；非交易日或未来日期自动回退到最近交易日（返回含 requested_date 与 stale 标注）" },
         symbol: { type: "string", description: "A股股票代码（可选，按个股过滤），如 600519" },
         top: { type: "number", description: "返回前N条，默认 20" },
       },

{stock_analysis_plugin-0.2.0 → stock_analysis_plugin-0.2.2}/dsh/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weaxs/dsh-stock-analysis",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "DeepSeek Harness (dsh) plugin for stock analysis, screening, and strategy backtesting across A/HK/US/JP/KR/TW markets",
   "type": "module",
   "main": "./dist/index.js",

{stock_analysis_plugin-0.2.0 → stock_analysis_plugin-0.2.2}/hermes/schemas.py

@@ -24,7 +24,7 @@ TOOL_SCHEMAS = [
     },
     {
         "name": "get_quote",
-        "description": "获取股票实时行情报价（现价、涨跌幅、量比等）。支持A股、港股、美股、日股、韩股、台股",
+        "description": "获取股票实时行情报价（现价、涨跌幅、量比等）。支持A股、港股、美股、日股、韩股、台股；非交易时段返回最近交易日收盘价并以 as_of/stale 标注",
         "parameters": {
             "type": "object",
             "properties": {
@@ -246,7 +246,7 @@ TOOL_SCHEMAS = [
             "properties": {
                 "date": {
                     "type": "string",
-                    "description": "日期（YYYYMMDD），默认当日",
+                    "description": "日期（YYYYMMDD），默认当日；非交易日或未来日期自动回退到最近交易日（返回含 requested_date 与 stale 标注）",
                 },
             },
         },
@@ -259,7 +259,7 @@ TOOL_SCHEMAS = [
             "properties": {
                 "date": {
                     "type": "string",
-                    "description": "日期（YYYY-MM-DD），默认当日",
+                    "description": "日期（YYYY-MM-DD），默认当日；非交易日或未来日期自动回退到最近交易日（返回含 requested_date 与 stale 标注）",
                 },
                 "symbol": {
                     "type": "string",

{stock_analysis_plugin-0.2.0 → stock_analysis_plugin-0.2.2}/openclaw/index.ts

@@ -88,7 +88,7 @@ export default definePluginEntry({
 
     api.registerTool({
       name: "get_quote",
-      description: "获取股票实时行情报价（现价、涨跌幅、量比等）。支持A股、港股、美股、日股、韩股、台股",
+      description: "获取股票实时行情报价（现价、涨跌幅、量比等）。支持A股、港股、美股、日股、韩股、台股；非交易时段返回最近交易日收盘价并以 as_of/stale 标注",
       parameters: Type.Object({
         symbol: Type.String({ description: "股票代码（A股如600519，美股如AAPL，港股如00700.HK）" }),
       }),
@@ -363,7 +363,7 @@ export default definePluginEntry({
         "获取A股涨停池/涨停板复盘——当日涨停个股，含连板数、封板资金、炸板次数、首末次封板时间、所属行业。短线情绪与龙头战法核心数据",
       parameters: Type.Object({
         date: Type.Optional(
-          Type.String({ description: "日期（YYYYMMDD），默认当日" })
+          Type.String({ description: "日期（YYYYMMDD），默认当日；非交易日或未来日期自动回退到最近交易日（返回含 requested_date 与 stale 标注）" })
         ),
       }),
       async execute(_id, params) {
@@ -380,7 +380,7 @@ export default definePluginEntry({
         "获取A股龙虎榜——上榜个股净买额/买入额/卖出额/上榜原因/解读，可按个股过滤",
       parameters: Type.Object({
         date: Type.Optional(
-          Type.String({ description: "日期（YYYY-MM-DD），默认当日" })
+          Type.String({ description: "日期（YYYY-MM-DD），默认当日；非交易日或未来日期自动回退到最近交易日（返回含 requested_date 与 stale 标注）" })
         ),
         symbol: Type.Optional(
           Type.String({ description: "A股股票代码（可选，按个股过滤），如 600519" })

{stock_analysis_plugin-0.2.0 → stock_analysis_plugin-0.2.2}/openclaw/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weaxs/openclaw-stock-analysis",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "OpenClaw plugin for stock analysis, screening, and strategy backtesting across A/HK/US/JP/KR/TW markets",
   "type": "module",
   "main": "./index.ts",

{stock_analysis_plugin-0.2.0 → stock_analysis_plugin-0.2.2}/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@weaxs/stock-analysis-plugin",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@weaxs/stock-analysis-plugin",
-      "version": "0.2.0",
+      "version": "0.2.2",
       "hasInstallScript": true,
       "license": "MIT",
       "devDependencies": {

{stock_analysis_plugin-0.2.0 → stock_analysis_plugin-0.2.2}/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weaxs/stock-analysis-plugin",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Pi Agent extension for stock analysis, screening, and strategy backtesting across A/HK/US markets",
   "type": "module",
   "main": "./pi/index.ts",

{stock_analysis_plugin-0.2.0 → stock_analysis_plugin-0.2.2}/pi/index.ts

@@ -63,7 +63,7 @@ export default (pi: ExtensionAPI) => {
   pi.registerTool({
     name: "get_quote",
     description:
-      "获取股票实时行情报价（现价、涨跌幅、量比等）。支持A股、港股、美股、日股、韩股、台股",
+      "获取股票实时行情报价（现价、涨跌幅、量比等）。支持A股、港股、美股、日股、韩股、台股；非交易时段返回最近交易日收盘价并以 as_of/stale 标注",
     parameters: {
       type: "object",
       properties: {
@@ -401,7 +401,7 @@ export default (pi: ExtensionAPI) => {
       properties: {
         date: {
           type: "string",
-          description: "日期（YYYYMMDD），默认当日",
+          description: "日期（YYYYMMDD），默认当日；非交易日或未来日期自动回退到最近交易日（返回含 requested_date 与 stale 标注）",
         },
       },
     },
@@ -423,7 +423,7 @@ export default (pi: ExtensionAPI) => {
       properties: {
         date: {
           type: "string",
-          description: "日期（YYYY-MM-DD），默认当日",
+          description: "日期（YYYY-MM-DD），默认当日；非交易日或未来日期自动回退到最近交易日（返回含 requested_date 与 stale 标注）",
         },
         symbol: {
           type: "string",

{stock_analysis_plugin-0.2.0 → stock_analysis_plugin-0.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "stock-analysis-plugin"
-version = "0.2.0"
+version = "0.2.2"
 description = "Hermes plugin for stock analysis, screening, and strategy backtesting across A/HK/US/JP/KR/TW markets"
 readme = "README.md"
 requires-python = ">=3.10"

{stock_analysis_plugin-0.2.0 → stock_analysis_plugin-0.2.2}/skills/dragon-head/SKILL.md

@@ -24,7 +24,7 @@ python3 scripts/gather.py <symbol>
 同时用 resolve_stock_sectors 确认个股所属板块，再用 get_sector_constituents 拉取同板块个股列表——后续「龙头 vs 跟风」的强弱对比都在这个板块池内进行。
 获取不到板块池或池内个股同期表现时，只评估候选股的强势特征，不给出“龙头/龙一”结论。
 
-短线情绪与资金席位补充：`get_limit_up_pool`（涨停池的连板数、首末次封板时间、封板资金、炸板次数）用于确认板块内个股的高度与封板质量；`get_dragon_tiger`（龙虎榜）用于查看上榜个股的席位净买额与上榜原因。
+短线情绪与资金席位补充：`get_limit_up_pool`（涨停池的连板数、首末次封板时间、封板资金、炸板次数）用于确认板块内个股的高度与封板质量；`get_dragon_tiger`（龙虎榜）用于查看上榜个股的席位净买额与上榜原因。两者在非交易日或未来日期会自动回退到最近交易日的数据（返回含 `requested_date` 与 `stale: true` 标注），解读时以 `date` 字段的实际数据日期为准，不得把回退数据当成请求日当日数据。
 
 ### 2. 相对强弱验证
 

{stock_analysis_plugin-0.2.0 → stock_analysis_plugin-0.2.2}/skills/emotion-cycle/SKILL.md

@@ -17,7 +17,7 @@ description: 市场情绪周期：用市场宽度、涨跌停、成交额和热
 python3 scripts/gather.py [A|HK|US]
 ```
 
-A 股情绪另有两个直接数据源：`get_limit_up_pool`（涨停池：连板梯队高度、炸板率、封板资金）与 `get_hot_stocks`（全市场人气热搜榜）。
+A 股情绪另有两个直接数据源：`get_limit_up_pool`（涨停池：连板梯队高度、炸板率、封板资金）与 `get_hot_stocks`（全市场人气热搜榜）。`get_limit_up_pool` 在非交易日或未来日期会回退到最近交易日数据（返回含 `requested_date` 与 `stale: true`），情绪判断以其 `date` 字段的实际数据日期为准。
 
 ### 2. 情绪指标
 

{stock_analysis_plugin-0.2.0 → stock_analysis_plugin-0.2.2}/tests/e2e/test_provider_network.py

@@ -107,7 +107,7 @@ class TestScreenerNetwork:
             assert 0 <= sent["score"] <= 100, f"sentiment score out of range: {sent}"
 
     def test_screen_a_with_sentiment(self):
-        out = _run_cli("screener.py", ["screen", "--market", "A", "--top", "3"], timeout=180)
+        out = _run_cli("screener.py", ["screen", "--market", "A", "--top", "3"], timeout=300)
         assert isinstance(out, dict) and "candidates" in out, f"unexpected shape: {list(out)}"
         assert out["l2_enabled"] is False
         self._assert_sentiment(out)