@t2b2c/agent-stock-sdk 0.0.0-stage → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +185 -2
- package/dist/board/ge7-themes.d.ts +4 -0
- package/dist/board/ge7-themes.d.ts.map +1 -0
- package/dist/board/ge7-themes.js +10 -0
- package/dist/board/limit-up-ladder.d.ts +8 -0
- package/dist/board/limit-up-ladder.d.ts.map +1 -0
- package/dist/board/limit-up-ladder.js +13 -0
- package/dist/client.d.ts +76 -0
- package/dist/client.d.ts.map +1 -0
- package/dist/client.js +130 -0
- package/dist/config.d.ts +34 -0
- package/dist/config.d.ts.map +1 -0
- package/dist/config.js +12 -0
- package/dist/http.d.ts +12 -0
- package/dist/http.d.ts.map +1 -0
- package/dist/http.js +60 -0
- package/dist/index.d.ts +35 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +22 -0
- package/dist/kline/capture-kline-screenshots.d.ts +10 -0
- package/dist/kline/capture-kline-screenshots.d.ts.map +1 -0
- package/dist/kline/capture-kline-screenshots.js +155 -0
- package/dist/kline/capture-market-kline-screenshots.d.ts +8 -0
- package/dist/kline/capture-market-kline-screenshots.d.ts.map +1 -0
- package/dist/kline/capture-market-kline-screenshots.js +149 -0
- package/dist/kline/fetch-kline.d.ts +30 -0
- package/dist/kline/fetch-kline.d.ts.map +1 -0
- package/dist/kline/fetch-kline.js +54 -0
- package/dist/kline/fetch-market-kline.d.ts +10 -0
- package/dist/kline/fetch-market-kline.d.ts.map +1 -0
- package/dist/kline/fetch-market-kline.js +67 -0
- package/dist/kline/kline-list-url.d.ts +14 -0
- package/dist/kline/kline-list-url.d.ts.map +1 -0
- package/dist/kline/kline-list-url.js +46 -0
- package/dist/kline/market-symbols.d.ts +22 -0
- package/dist/kline/market-symbols.d.ts.map +1 -0
- package/dist/kline/market-symbols.js +105 -0
- package/dist/kline/normalize.d.ts +17 -0
- package/dist/kline/normalize.d.ts.map +1 -0
- package/dist/kline/normalize.js +34 -0
- package/dist/kline/screenshot-route.d.ts +25 -0
- package/dist/kline/screenshot-route.d.ts.map +1 -0
- package/dist/kline/screenshot-route.js +65 -0
- package/dist/kline/webbridge-client.d.ts +22 -0
- package/dist/kline/webbridge-client.d.ts.map +1 -0
- package/dist/kline/webbridge-client.js +41 -0
- package/dist/pool/large-cap-limit-up-3d.d.ts +7 -0
- package/dist/pool/large-cap-limit-up-3d.d.ts.map +1 -0
- package/dist/pool/large-cap-limit-up-3d.js +20 -0
- package/dist/pool/large-cap-trend.d.ts +7 -0
- package/dist/pool/large-cap-trend.d.ts.map +1 -0
- package/dist/pool/large-cap-trend.js +20 -0
- package/dist/pool/limit-up-30d.d.ts +8 -0
- package/dist/pool/limit-up-30d.d.ts.map +1 -0
- package/dist/pool/limit-up-30d.js +21 -0
- package/dist/pool/pick-and-merge.d.ts +12 -0
- package/dist/pool/pick-and-merge.d.ts.map +1 -0
- package/dist/pool/pick-and-merge.js +110 -0
- package/dist/pool/query-bodies.d.ts +68 -0
- package/dist/pool/query-bodies.d.ts.map +1 -0
- package/dist/pool/query-bodies.js +121 -0
- package/dist/pool/small-cap-trend.d.ts +8 -0
- package/dist/pool/small-cap-trend.d.ts.map +1 -0
- package/dist/pool/small-cap-trend.js +27 -0
- package/dist/pool/snapshot-query.d.ts +5 -0
- package/dist/pool/snapshot-query.d.ts.map +1 -0
- package/dist/pool/snapshot-query.js +15 -0
- package/dist/types/board.d.ts +67 -0
- package/dist/types/board.d.ts.map +1 -0
- package/dist/types/board.js +1 -0
- package/dist/types/kline-screenshot.d.ts +62 -0
- package/dist/types/kline-screenshot.d.ts.map +1 -0
- package/dist/types/kline-screenshot.js +1 -0
- package/dist/types/kline.d.ts +31 -0
- package/dist/types/kline.d.ts.map +1 -0
- package/dist/types/kline.js +6 -0
- package/dist/types/market-kline-screenshot.d.ts +27 -0
- package/dist/types/market-kline-screenshot.d.ts.map +1 -0
- package/dist/types/market-kline-screenshot.js +1 -0
- package/dist/types/snapshot-pool.d.ts +53 -0
- package/dist/types/snapshot-pool.d.ts.map +1 -0
- package/dist/types/snapshot-pool.js +1 -0
- package/docs//344/270/244/344/270/252/350/266/213/345/212/277/347/245/250curl.md +102 -0
- package/docs//350/266/213/345/212/277/347/245/250/344/270/216/346/211/223/346/235/277/350/202/241/347/245/250/346/261/240.md +260 -0
- package/examples/capture-kline-screenshots.ts +151 -0
- package/examples/capture-market-kline-screenshots.ts +81 -0
- package/examples/fetch-snapshot-pools.ts +237 -0
- package/package.json +52 -4
|
@@ -0,0 +1,260 @@
|
|
|
1
|
+
# 趋势票 / 打板股票池(snapshot query)
|
|
2
|
+
|
|
3
|
+
数据源统一为 `POST http://192.168.188.1:9301/stocks/snapshot/query`。
|
|
4
|
+
完整 curl 见 [`两个趋势票curl.md`](./两个趋势票curl.md)。
|
|
5
|
+
|
|
6
|
+
query 单行字段很多;Agent / SDK 消费时只保留 **K 线网格 item(`KlineGridCard`)会展示或由其筛选条件驱动展示** 的字段(见下文「必要字段」)。
|
|
7
|
+
|
|
8
|
+
SDK 封装(`@t2b2c/agent-stock-sdk`):
|
|
9
|
+
|
|
10
|
+
| 池 | 方法 | 实现 |
|
|
11
|
+
|----|------|------|
|
|
12
|
+
| A 小市值趋势股 | `sdk.getSmallCapTrendPool()` / `fetchSmallCapTrendPool` | A1∪A2,按 `code` 合并后裁剪 |
|
|
13
|
+
| B 近 30 日涨停活跃 | `sdk.getLimitUp30dPool()` / `fetchLimitUp30dPool` | 单次 query 后裁剪 |
|
|
14
|
+
| C 大市值趋势 | `sdk.getLargeCapTrendPool()` / `fetchLargeCapTrendPool` | 市值 ≥500 亿等 |
|
|
15
|
+
| D 大市值涨停观察 | `sdk.getLargeCapLimitUp3dPool()` / `fetchLargeCapLimitUp3dPool` | ≥300 亿 + 异动近 3 日 |
|
|
16
|
+
|
|
17
|
+
```ts
|
|
18
|
+
import { AgentStockSdk } from '@t2b2c/agent-stock-sdk'
|
|
19
|
+
|
|
20
|
+
const sdk = new AgentStockSdk()
|
|
21
|
+
|
|
22
|
+
const trendPool = await sdk.getSmallCapTrendPool()
|
|
23
|
+
const limitUpPool = await sdk.getLimitUp30dPool()
|
|
24
|
+
const largeTrend = await sdk.getLargeCapTrendPool()
|
|
25
|
+
const largeLimitUp3d = await sdk.getLargeCapLimitUp3dPool()
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
可执行案例:
|
|
29
|
+
|
|
30
|
+
```bash
|
|
31
|
+
pnpm --filter @t2b2c/agent-stock-sdk example:snapshot-pools
|
|
32
|
+
pnpm --filter @t2b2c/agent-stock-sdk example:snapshot-pools -- --pool=large-trend --out=./tmp/snapshot-pools
|
|
33
|
+
pnpm --filter @t2b2c/agent-stock-sdk example:snapshot-pools -- --pool=large-limitup --codes-only
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
---
|
|
37
|
+
|
|
38
|
+
## 池 A:小市值找趋势股
|
|
39
|
+
|
|
40
|
+
**用途**:小市值趋势股票池(可能含主线、副线、打板票)。
|
|
41
|
+
|
|
42
|
+
**构成**:下列两个 query 的 `items` 按 `code` **去重合并**(同一 `code` 保留一条;后写覆盖前写,即 A2 覆盖 A1)。
|
|
43
|
+
|
|
44
|
+
| 来源 | 文档标题 | 关键筛选差异 |
|
|
45
|
+
|------|----------|--------------|
|
|
46
|
+
| Query A1 | 小市值找趋势票 | 流通市值 ≤ 300 亿;`dayReturn20d ≥ 30`;无基金持股门槛 |
|
|
47
|
+
| Query A2 | 基金持股大于 3,小市值找趋势票 2 | 流通市值 ≤ 300 亿;`fundHoldingsCount ≥ 3`;`dayReturn20d ≥ 25` |
|
|
48
|
+
|
|
49
|
+
### 共同筛选(A1 / A2)
|
|
50
|
+
|
|
51
|
+
| 条件 | 含义 |
|
|
52
|
+
|------|------|
|
|
53
|
+
| `floatMarketCapYuan.max = 3e10` | 流通市值 ≤ 300 亿 |
|
|
54
|
+
| `weekReturn26w.max = 180` | 26 周收益上限 |
|
|
55
|
+
| `dayReturn60d` ∈ `[25, 140]` | 60 日收益区间 |
|
|
56
|
+
| `boxAmplitudePct.max = 150` | 箱体振幅% 上限 |
|
|
57
|
+
| `jiuyanLimitUpTotalDays.min = 2` | 涨停总天数 ≥ 2 |
|
|
58
|
+
| `sort.field = jiuyanActDate` desc | 按韭研异动日倒序 |
|
|
59
|
+
| `pageSize = 100` | 单页上限(可经 paging 覆盖) |
|
|
60
|
+
|
|
61
|
+
### 合并逻辑
|
|
62
|
+
|
|
63
|
+
```ts
|
|
64
|
+
// 包内:mergeSnapshotPoolByCode(a1Items, a2Items)
|
|
65
|
+
const byCode = new Map<string, SnapshotPoolItem>()
|
|
66
|
+
for (const row of [...a1Items, ...a2Items]) {
|
|
67
|
+
byCode.set(row.code.toUpperCase(), row) // A2 覆盖 A1
|
|
68
|
+
}
|
|
69
|
+
return [...byCode.values()]
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
---
|
|
73
|
+
|
|
74
|
+
## 池 B:近 30 自然日涨停板概况
|
|
75
|
+
|
|
76
|
+
**用途**:近 30 个自然日涨停活跃股池,后续用于找 **打板二波** 或 **打板中军**。
|
|
77
|
+
|
|
78
|
+
**来源**:Query B(文档:韭研异动日近 30 个自然日,涨停总天数 ≥ 5)。
|
|
79
|
+
|
|
80
|
+
| 条件 | 含义 |
|
|
81
|
+
|------|------|
|
|
82
|
+
| `dateRanges.jiuyanActDate.lastNDays = 30` | 韭研异动日落在近 30 个自然日 |
|
|
83
|
+
| `jiuyanLimitUpTotalDays.min = 5` | 涨停总天数 ≥ 5 |
|
|
84
|
+
| `boards = ["hz_zb","cyb","sz_zb"]` | 沪主板 / 创业板 / 深主板 |
|
|
85
|
+
| `sort.field = jiuyanActDate` desc | 按韭研异动日倒序 |
|
|
86
|
+
| `pageSize = 100` | 单页上限 |
|
|
87
|
+
|
|
88
|
+
与池 A **不要混并**:池 A 偏趋势/市值结构,池 B 偏近期涨停强度。
|
|
89
|
+
|
|
90
|
+
---
|
|
91
|
+
|
|
92
|
+
## 池 C:大市值趋势(哪个涨的好)
|
|
93
|
+
|
|
94
|
+
**用途**:大市值里涨得好的观察池(沪/深主板)。
|
|
95
|
+
|
|
96
|
+
| 条件 | 含义 |
|
|
97
|
+
|------|------|
|
|
98
|
+
| `floatMarketCapYuan.min = 5e10` | 流通市值 ≥ 500 亿 |
|
|
99
|
+
| `fundHoldingsCount.min = 40` | 基金持股家数 ≥ 40 |
|
|
100
|
+
| `dayReturn60d.min = 20` | 60 日收益 ≥ 20 |
|
|
101
|
+
| `dayReturn40d.max = 100` | 40 日收益 ≤ 100 |
|
|
102
|
+
| `boards = ["hz_zb","sz_zb"]` | 沪主板 / 深主板 |
|
|
103
|
+
| `sort.field = jiuyanActDate` desc | 按韭研异动日倒序 |
|
|
104
|
+
|
|
105
|
+
---
|
|
106
|
+
|
|
107
|
+
## 池 D:大市值涨停观察(异动近 3 自然日)
|
|
108
|
+
|
|
109
|
+
**用途**:大市值近期异动/涨停观察(≥300 亿)。
|
|
110
|
+
|
|
111
|
+
| 条件 | 含义 |
|
|
112
|
+
|------|------|
|
|
113
|
+
| `floatMarketCapYuan.min = 3e10` | 流通市值 ≥ 300 亿 |
|
|
114
|
+
| `dateRanges.jiuyanActDate.lastNDays = 3` | 韭研异动日落在近 3 个自然日 |
|
|
115
|
+
| `boards = ["hz_zb","sz_zb","cyb"]` | 沪主板 / 深主板 / 创业板 |
|
|
116
|
+
| `sort.field = jiuyanActDate` desc | 按韭研异动日倒序 |
|
|
117
|
+
|
|
118
|
+
注:对应 curl **未**写 `jiuyanLimitUpTotalDays.min`;窗口靠近 3 日异动日。
|
|
119
|
+
|
|
120
|
+
---
|
|
121
|
+
|
|
122
|
+
## K 线网格 item 对应必要字段
|
|
123
|
+
|
|
124
|
+
对齐 `packages/ts-market-signal-snapshot`:
|
|
125
|
+
|
|
126
|
+
- 卡片头固定区:`code` / `name` + `JjSzTierChips`(基金持股 / 流通市值 / 融资余额)
|
|
127
|
+
- 默认可见 meta 列(`columnConfigs.defaultVisible`,且非 `klineMini`)
|
|
128
|
+
- 本两池筛选会 **额外驱动显示** 的列(`deriveFilterDrivenColumnIds`)
|
|
129
|
+
|
|
130
|
+
类型:`SnapshotPoolItem`(`src/types/snapshot-pool.ts`),由 `pickSnapshotPoolItem` 从 query 行裁剪。
|
|
131
|
+
|
|
132
|
+
### 1. 身份与头区(必取)
|
|
133
|
+
|
|
134
|
+
| 字段 | 说明 | 网格位置 |
|
|
135
|
+
|------|------|----------|
|
|
136
|
+
| `code` | 股票代码 | 标题 |
|
|
137
|
+
| `name` | 名称 | 标题旁 |
|
|
138
|
+
| `floatMarketCapYuan` | 流通市值(元) | JJ/SZ chip · 流通档 |
|
|
139
|
+
| `fundHoldingsCount` | 基金持股家数 | JJ/SZ chip · 基金档 |
|
|
140
|
+
| `financingBalanceYuan` | 融资余额(元) | JJ/SZ chip · 融资 |
|
|
141
|
+
|
|
142
|
+
### 2. 行情 / 默认 meta(必取)
|
|
143
|
+
|
|
144
|
+
| 字段 | UI 列名 | 说明 |
|
|
145
|
+
|------|---------|------|
|
|
146
|
+
| `price` | 价格 | 最新收盘价 |
|
|
147
|
+
| `changePercent` | 涨跌幅 | % |
|
|
148
|
+
| `klineTurnover` | 当日换手 | % |
|
|
149
|
+
| `amount` | 成交额 | — |
|
|
150
|
+
| `bullBarDate` | 走牛点 | 走牛确认 bar 日 |
|
|
151
|
+
|
|
152
|
+
### 3. 主副线定量(展示依赖前端 enrich)
|
|
153
|
+
|
|
154
|
+
| 字段 / 来源 | UI 列名 | 说明 |
|
|
155
|
+
|-------------|---------|------|
|
|
156
|
+
| `themeQuantSummaryLine`(前端用 code 查主题定量索引后挂上) | 主副线定量 | **不在** Nest query 原始 JSON 里;Agent 若只要「池子 codes」可先不取;若要复现网格文案需另读主题定量索引 |
|
|
157
|
+
|
|
158
|
+
### 4. 本池筛选驱动的技术 / 韭研字段(建议一并保留)
|
|
159
|
+
|
|
160
|
+
池 A(A1∪A2)筛选激活后网格会带出:
|
|
161
|
+
|
|
162
|
+
| 字段 | UI 列名 | 筛选用途 |
|
|
163
|
+
|------|---------|----------|
|
|
164
|
+
| `dayReturn20d` | 20 日收益 | A1≥30 / A2≥25 |
|
|
165
|
+
| `dayReturn40d` | 40 日收益 | 池 C ≤100 |
|
|
166
|
+
| `dayReturn60d` | 60 日收益 | 池 A ∈[25,140];池 C ≥20 |
|
|
167
|
+
| `weekReturn26w` | 26 周收益 | ≤180 |
|
|
168
|
+
| `boxAmplitudePct` | 箱体振幅% | ≤150 |
|
|
169
|
+
| `jiuyanLimitUpTotalDays` | 涨停总天数 | ≥2 |
|
|
170
|
+
| `jiuyanActDate` | 韭研异动日 | 排序键 |
|
|
171
|
+
|
|
172
|
+
池 B 额外 / 重点:
|
|
173
|
+
|
|
174
|
+
| 字段 | UI 列名 | 筛选用途 |
|
|
175
|
+
|------|---------|----------|
|
|
176
|
+
| `jiuyanLimitUpTotalDays` | 涨停总天数 | ≥5 |
|
|
177
|
+
| `jiuyanActDate` | 韭研异动日 | 近 30 自然日 + 排序 |
|
|
178
|
+
|
|
179
|
+
池 C / D 额外:
|
|
180
|
+
|
|
181
|
+
| 字段 | 筛选用途 |
|
|
182
|
+
|------|----------|
|
|
183
|
+
| `floatMarketCapYuan` | C≥500 亿 / D≥300 亿 |
|
|
184
|
+
| `fundHoldingsCount` | C≥40 |
|
|
185
|
+
| `dayReturn40d` | C≤100 |
|
|
186
|
+
| `jiuyanActDate` | D 近 3 自然日 |
|
|
187
|
+
|
|
188
|
+
打板二波 / 中军研判时建议再带(网格韭研列,query 已返回):
|
|
189
|
+
|
|
190
|
+
| 字段 | 说明 |
|
|
191
|
+
|------|------|
|
|
192
|
+
| `jiuyanFieldName` | 韭研板块 / 题材名 |
|
|
193
|
+
| `jiuyanLimitUpDuringDays` | 连板天数 |
|
|
194
|
+
| `jiuyanConsecutiveLimitUpDays` | 连续涨停天数 |
|
|
195
|
+
| `jiuyanLimitUpTime` | 涨停时间 |
|
|
196
|
+
| `jiuyanBriefReason` / `jiuyanDetailReason` | 涨停原因(简/详) |
|
|
197
|
+
| `jiuyanThemeRank` | 题材当日涨停强度排名 |
|
|
198
|
+
|
|
199
|
+
### 5. 响应壳(非 item 字段)
|
|
200
|
+
|
|
201
|
+
| 字段 | 说明 |
|
|
202
|
+
|------|------|
|
|
203
|
+
| `items` | 行数组(SDK 已裁剪为 `SnapshotPoolItem`) |
|
|
204
|
+
| `sourceTotals` | 各源 `total` + `merged` 条数 |
|
|
205
|
+
| `dataVersion` / `stale` | 缓存版本 / 是否陈旧 |
|
|
206
|
+
| `recentTradingDays10` | 近 10 个上证交易日(部分 UI 用) |
|
|
207
|
+
|
|
208
|
+
---
|
|
209
|
+
|
|
210
|
+
## Agent 推荐裁剪形状
|
|
211
|
+
|
|
212
|
+
```ts
|
|
213
|
+
/** 池 A / 池 B 共用的必要子集(对齐 K 线网格 item) */
|
|
214
|
+
type SnapshotPoolItem = {
|
|
215
|
+
code: string
|
|
216
|
+
name?: string | null
|
|
217
|
+
// 头区 chips
|
|
218
|
+
floatMarketCapYuan?: number | null
|
|
219
|
+
fundHoldingsCount?: number | null
|
|
220
|
+
financingBalanceYuan?: number | null
|
|
221
|
+
// 默认行情 meta
|
|
222
|
+
price?: number | null
|
|
223
|
+
changePercent?: number | null
|
|
224
|
+
klineTurnover?: number | null
|
|
225
|
+
amount?: number | null
|
|
226
|
+
bullBarDate?: string | null
|
|
227
|
+
// 池筛选 / 韭研
|
|
228
|
+
dayReturn20d?: number | null
|
|
229
|
+
dayReturn40d?: number | null
|
|
230
|
+
dayReturn60d?: number | null
|
|
231
|
+
weekReturn26w?: number | null
|
|
232
|
+
boxAmplitudePct?: number | null
|
|
233
|
+
jiuyanActDate?: string | null
|
|
234
|
+
jiuyanFieldName?: string | null
|
|
235
|
+
jiuyanLimitUpTotalDays?: number | null
|
|
236
|
+
jiuyanLimitUpDuringDays?: number | null
|
|
237
|
+
jiuyanConsecutiveLimitUpDays?: number | null
|
|
238
|
+
jiuyanLimitUpTime?: string | null
|
|
239
|
+
jiuyanBriefReason?: string[] | null
|
|
240
|
+
jiuyanDetailReason?: string[] | null
|
|
241
|
+
jiuyanThemeRank?: number | null
|
|
242
|
+
}
|
|
243
|
+
```
|
|
244
|
+
|
|
245
|
+
K 线图本身由前端 / WebBridge 按 `code` 另拉,**不必**从 query 行里取 K 线序列。
|
|
246
|
+
|
|
247
|
+
---
|
|
248
|
+
|
|
249
|
+
## 源码对照
|
|
250
|
+
|
|
251
|
+
| 文件 | 职责 |
|
|
252
|
+
|------|------|
|
|
253
|
+
| `src/pool/query-bodies.ts` | A1 / A2 / B 的 request body |
|
|
254
|
+
| `src/pool/pick-and-merge.ts` | 字段裁剪 + 按 code 合并 |
|
|
255
|
+
| `src/pool/small-cap-trend.ts` | 池 A |
|
|
256
|
+
| `src/pool/limit-up-30d.ts` | 池 B |
|
|
257
|
+
| `src/pool/large-cap-trend.ts` | 池 C |
|
|
258
|
+
| `src/pool/large-cap-limit-up-3d.ts` | 池 D |
|
|
259
|
+
| `src/types/snapshot-pool.ts` | `SnapshotPoolItem` 等类型 |
|
|
260
|
+
| `src/client.ts` | `getSmallCapTrendPool` / `getLimitUp30dPool` / `getLargeCapTrendPool` / `getLargeCapLimitUp3dPool` |
|
|
@@ -0,0 +1,151 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Executable demo: capture A-share K-line cards via Kimi WebBridge + stock-app `/kline-list`.
|
|
3
|
+
*
|
|
4
|
+
* Prerequisites:
|
|
5
|
+
* ~/.kimi-webbridge/bin/kimi-webbridge start
|
|
6
|
+
* Browser extension connected; stock-app reachable (default :9311)
|
|
7
|
+
*
|
|
8
|
+
* Run from monorepo root:
|
|
9
|
+
* pnpm --filter @t2b2c/agent-stock-sdk example:kline-shot
|
|
10
|
+
*
|
|
11
|
+
* Or with custom codes / years / output:
|
|
12
|
+
* pnpm --filter @t2b2c/agent-stock-sdk example:kline-shot -- \
|
|
13
|
+
* --codes=000595,000665,002187 --years=2.5 --out=./tmp/kline-exports
|
|
14
|
+
*/
|
|
15
|
+
|
|
16
|
+
import { mkdir } from 'node:fs/promises'
|
|
17
|
+
import { resolve } from 'node:path'
|
|
18
|
+
import {
|
|
19
|
+
AgentStockSdk,
|
|
20
|
+
DEFAULT_KLINE_SCREENSHOT_YEARS,
|
|
21
|
+
WebbridgeError,
|
|
22
|
+
} from '../src/index.js'
|
|
23
|
+
|
|
24
|
+
function printUsage(): void {
|
|
25
|
+
console.log(`Usage:
|
|
26
|
+
pnpm --filter @t2b2c/agent-stock-sdk example:kline-shot -- [options]
|
|
27
|
+
|
|
28
|
+
Options:
|
|
29
|
+
--codes=000595,000665 Stock codes (default: 000595,000665,002187)
|
|
30
|
+
--years=2.5 Visible years (default: ${DEFAULT_KLINE_SCREENSHOT_YEARS})
|
|
31
|
+
--period=day|week|month Chart period (default: day)
|
|
32
|
+
--out=DIR Output directory (default: ./tmp/kline-exports under cwd)
|
|
33
|
+
--stock-app=URL stock-app origin (default: http://192.168.188.1:9311)
|
|
34
|
+
--webbridge=URL WebBridge daemon (default: http://127.0.0.1:10086)
|
|
35
|
+
--help Show this help
|
|
36
|
+
`)
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
function parseArgs(argv: string[]) {
|
|
40
|
+
const opts: {
|
|
41
|
+
codes: string[]
|
|
42
|
+
years: number
|
|
43
|
+
period: 'day' | 'week' | 'month'
|
|
44
|
+
out: string
|
|
45
|
+
stockAppBaseUrl?: string
|
|
46
|
+
webbridgeBaseUrl?: string
|
|
47
|
+
help: boolean
|
|
48
|
+
} = {
|
|
49
|
+
codes: ['000595', '000665', '002187'],
|
|
50
|
+
years: DEFAULT_KLINE_SCREENSHOT_YEARS,
|
|
51
|
+
period: 'day',
|
|
52
|
+
out: resolve(process.cwd(), 'tmp/kline-exports'),
|
|
53
|
+
help: false,
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
for (const arg of argv) {
|
|
57
|
+
if (arg === '--') continue
|
|
58
|
+
if (arg === '--help' || arg === '-h') {
|
|
59
|
+
opts.help = true
|
|
60
|
+
continue
|
|
61
|
+
}
|
|
62
|
+
const m = /^--([^=]+)=(.*)$/.exec(arg)
|
|
63
|
+
if (!m) {
|
|
64
|
+
console.warn(`Ignoring unknown argument: ${arg}`)
|
|
65
|
+
continue
|
|
66
|
+
}
|
|
67
|
+
const [, key, value] = m
|
|
68
|
+
switch (key) {
|
|
69
|
+
case 'codes':
|
|
70
|
+
opts.codes = value.split(/[,,\s]+/).map((c) => c.trim()).filter(Boolean)
|
|
71
|
+
break
|
|
72
|
+
case 'years': {
|
|
73
|
+
const n = Number(value)
|
|
74
|
+
if (!Number.isFinite(n) || n <= 0) throw new Error(`Invalid --years=${value}`)
|
|
75
|
+
opts.years = n
|
|
76
|
+
break
|
|
77
|
+
}
|
|
78
|
+
case 'period':
|
|
79
|
+
if (value !== 'day' && value !== 'week' && value !== 'month') {
|
|
80
|
+
throw new Error(`Invalid --period=${value}`)
|
|
81
|
+
}
|
|
82
|
+
opts.period = value
|
|
83
|
+
break
|
|
84
|
+
case 'out':
|
|
85
|
+
opts.out = resolve(process.cwd(), value)
|
|
86
|
+
break
|
|
87
|
+
case 'stock-app':
|
|
88
|
+
opts.stockAppBaseUrl = value
|
|
89
|
+
break
|
|
90
|
+
case 'webbridge':
|
|
91
|
+
opts.webbridgeBaseUrl = value
|
|
92
|
+
break
|
|
93
|
+
default:
|
|
94
|
+
console.warn(`Ignoring unknown option: --${key}`)
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
return opts
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
async function main(): Promise<void> {
|
|
102
|
+
const opts = parseArgs(process.argv.slice(2))
|
|
103
|
+
if (opts.help) {
|
|
104
|
+
printUsage()
|
|
105
|
+
return
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
await mkdir(opts.out, { recursive: true })
|
|
109
|
+
|
|
110
|
+
const sdk = new AgentStockSdk({
|
|
111
|
+
stockAppBaseUrl: opts.stockAppBaseUrl,
|
|
112
|
+
webbridgeBaseUrl: opts.webbridgeBaseUrl,
|
|
113
|
+
})
|
|
114
|
+
|
|
115
|
+
console.log('Capturing K-line cards…')
|
|
116
|
+
console.log(` codes: ${opts.codes.join(', ')}`)
|
|
117
|
+
console.log(` years: ${opts.years}`)
|
|
118
|
+
console.log(` period: ${opts.period}`)
|
|
119
|
+
console.log(` out: ${opts.out}`)
|
|
120
|
+
console.log(` app: ${sdk.stockAppBaseUrl}`)
|
|
121
|
+
console.log(` bridge: ${sdk.webbridgeBaseUrl}`)
|
|
122
|
+
|
|
123
|
+
const result = await sdk.captureKlineScreenshots({
|
|
124
|
+
codes: opts.codes,
|
|
125
|
+
years: opts.years,
|
|
126
|
+
period: opts.period,
|
|
127
|
+
outputDir: opts.out,
|
|
128
|
+
filePrefix: 'wb',
|
|
129
|
+
session: `example-kline-${Date.now().toString(36)}`,
|
|
130
|
+
})
|
|
131
|
+
|
|
132
|
+
console.log('\nDone.')
|
|
133
|
+
console.log(` url: ${result.url}`)
|
|
134
|
+
console.log(` barsHint: ${result.visibleBarsHint}`)
|
|
135
|
+
for (const card of result.cards) {
|
|
136
|
+
console.log(` card: ${card.code} → ${card.path} (${card.sizeBytes} bytes)`)
|
|
137
|
+
}
|
|
138
|
+
console.log(` tabClosed: ${result.tabClosed}`)
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
main().catch((err) => {
|
|
142
|
+
if (err instanceof WebbridgeError) {
|
|
143
|
+
console.error(`\nWebBridge error [${err.code ?? 'unknown'}]: ${err.message}`)
|
|
144
|
+
console.error('Check: daemon running + extension connected')
|
|
145
|
+
console.error(' ~/.kimi-webbridge/bin/kimi-webbridge start')
|
|
146
|
+
console.error(' https://www.kimi.com/zh-cn/features/webbridge')
|
|
147
|
+
} else {
|
|
148
|
+
console.error(err instanceof Error ? err.message : err)
|
|
149
|
+
}
|
|
150
|
+
process.exitCode = 1
|
|
151
|
+
})
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Capture market K-line cards (indices / gold / US) via WebBridge + `/market-kline-list`.
|
|
3
|
+
*
|
|
4
|
+
* pnpm --filter @t2b2c/agent-stock-sdk example:market-kline-shot
|
|
5
|
+
* pnpm --filter @t2b2c/agent-stock-sdk example:market-kline-shot -- \
|
|
6
|
+
* --symbols=cyb,sse,nasdaq,gold,us:AAPL --years=2.5
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
import { mkdir } from 'node:fs/promises'
|
|
10
|
+
import { resolve } from 'node:path'
|
|
11
|
+
import {
|
|
12
|
+
AgentStockSdk,
|
|
13
|
+
DEFAULT_KLINE_SCREENSHOT_YEARS,
|
|
14
|
+
WebbridgeError,
|
|
15
|
+
} from '../src/index.js'
|
|
16
|
+
|
|
17
|
+
function parseArgs(argv: string[]) {
|
|
18
|
+
const opts = {
|
|
19
|
+
symbols: ['cyb', 'sse', 'nasdaq', 'gold'] as string[],
|
|
20
|
+
years: DEFAULT_KLINE_SCREENSHOT_YEARS,
|
|
21
|
+
period: 'day' as 'day' | 'week',
|
|
22
|
+
out: resolve(process.cwd(), 'tmp/market-kline-exports'),
|
|
23
|
+
help: false,
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
for (const arg of argv) {
|
|
27
|
+
if (arg === '--') continue
|
|
28
|
+
if (arg === '--help' || arg === '-h') {
|
|
29
|
+
opts.help = true
|
|
30
|
+
continue
|
|
31
|
+
}
|
|
32
|
+
const m = /^--([^=]+)=(.*)$/.exec(arg)
|
|
33
|
+
if (!m) continue
|
|
34
|
+
const [, key, value] = m
|
|
35
|
+
if (key === 'symbols') {
|
|
36
|
+
opts.symbols = value.split(/[,,\s]+/).map((s) => s.trim()).filter(Boolean)
|
|
37
|
+
} else if (key === 'years') {
|
|
38
|
+
opts.years = Number(value)
|
|
39
|
+
} else if (key === 'period' && (value === 'day' || value === 'week')) {
|
|
40
|
+
opts.period = value
|
|
41
|
+
} else if (key === 'out') {
|
|
42
|
+
opts.out = resolve(process.cwd(), value)
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
return opts
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
async function main() {
|
|
49
|
+
const opts = parseArgs(process.argv.slice(2))
|
|
50
|
+
if (opts.help) {
|
|
51
|
+
console.log(`Usage: example:market-kline-shot -- --symbols=cyb,us:AAPL --years=2.5`)
|
|
52
|
+
return
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
await mkdir(opts.out, { recursive: true })
|
|
56
|
+
const sdk = new AgentStockSdk()
|
|
57
|
+
console.log('Capturing market K-line cards…', opts)
|
|
58
|
+
|
|
59
|
+
const result = await sdk.captureMarketKlineScreenshots({
|
|
60
|
+
symbols: opts.symbols,
|
|
61
|
+
years: opts.years,
|
|
62
|
+
period: opts.period,
|
|
63
|
+
outputDir: opts.out,
|
|
64
|
+
filePrefix: 'mk',
|
|
65
|
+
})
|
|
66
|
+
|
|
67
|
+
console.log('Done.', {
|
|
68
|
+
url: result.url,
|
|
69
|
+
tabClosed: result.tabClosed,
|
|
70
|
+
cards: result.cards,
|
|
71
|
+
})
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
main().catch((err) => {
|
|
75
|
+
if (err instanceof WebbridgeError) {
|
|
76
|
+
console.error(`WebBridge error [${err.code ?? 'unknown'}]: ${err.message}`)
|
|
77
|
+
} else {
|
|
78
|
+
console.error(err instanceof Error ? err.message : err)
|
|
79
|
+
}
|
|
80
|
+
process.exitCode = 1
|
|
81
|
+
})
|