@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.
Files changed (88) hide show
  1. package/README.md +185 -2
  2. package/dist/board/ge7-themes.d.ts +4 -0
  3. package/dist/board/ge7-themes.d.ts.map +1 -0
  4. package/dist/board/ge7-themes.js +10 -0
  5. package/dist/board/limit-up-ladder.d.ts +8 -0
  6. package/dist/board/limit-up-ladder.d.ts.map +1 -0
  7. package/dist/board/limit-up-ladder.js +13 -0
  8. package/dist/client.d.ts +76 -0
  9. package/dist/client.d.ts.map +1 -0
  10. package/dist/client.js +130 -0
  11. package/dist/config.d.ts +34 -0
  12. package/dist/config.d.ts.map +1 -0
  13. package/dist/config.js +12 -0
  14. package/dist/http.d.ts +12 -0
  15. package/dist/http.d.ts.map +1 -0
  16. package/dist/http.js +60 -0
  17. package/dist/index.d.ts +35 -0
  18. package/dist/index.d.ts.map +1 -0
  19. package/dist/index.js +22 -0
  20. package/dist/kline/capture-kline-screenshots.d.ts +10 -0
  21. package/dist/kline/capture-kline-screenshots.d.ts.map +1 -0
  22. package/dist/kline/capture-kline-screenshots.js +155 -0
  23. package/dist/kline/capture-market-kline-screenshots.d.ts +8 -0
  24. package/dist/kline/capture-market-kline-screenshots.d.ts.map +1 -0
  25. package/dist/kline/capture-market-kline-screenshots.js +149 -0
  26. package/dist/kline/fetch-kline.d.ts +30 -0
  27. package/dist/kline/fetch-kline.d.ts.map +1 -0
  28. package/dist/kline/fetch-kline.js +54 -0
  29. package/dist/kline/fetch-market-kline.d.ts +10 -0
  30. package/dist/kline/fetch-market-kline.d.ts.map +1 -0
  31. package/dist/kline/fetch-market-kline.js +67 -0
  32. package/dist/kline/kline-list-url.d.ts +14 -0
  33. package/dist/kline/kline-list-url.d.ts.map +1 -0
  34. package/dist/kline/kline-list-url.js +46 -0
  35. package/dist/kline/market-symbols.d.ts +22 -0
  36. package/dist/kline/market-symbols.d.ts.map +1 -0
  37. package/dist/kline/market-symbols.js +105 -0
  38. package/dist/kline/normalize.d.ts +17 -0
  39. package/dist/kline/normalize.d.ts.map +1 -0
  40. package/dist/kline/normalize.js +34 -0
  41. package/dist/kline/screenshot-route.d.ts +25 -0
  42. package/dist/kline/screenshot-route.d.ts.map +1 -0
  43. package/dist/kline/screenshot-route.js +65 -0
  44. package/dist/kline/webbridge-client.d.ts +22 -0
  45. package/dist/kline/webbridge-client.d.ts.map +1 -0
  46. package/dist/kline/webbridge-client.js +41 -0
  47. package/dist/pool/large-cap-limit-up-3d.d.ts +7 -0
  48. package/dist/pool/large-cap-limit-up-3d.d.ts.map +1 -0
  49. package/dist/pool/large-cap-limit-up-3d.js +20 -0
  50. package/dist/pool/large-cap-trend.d.ts +7 -0
  51. package/dist/pool/large-cap-trend.d.ts.map +1 -0
  52. package/dist/pool/large-cap-trend.js +20 -0
  53. package/dist/pool/limit-up-30d.d.ts +8 -0
  54. package/dist/pool/limit-up-30d.d.ts.map +1 -0
  55. package/dist/pool/limit-up-30d.js +21 -0
  56. package/dist/pool/pick-and-merge.d.ts +12 -0
  57. package/dist/pool/pick-and-merge.d.ts.map +1 -0
  58. package/dist/pool/pick-and-merge.js +110 -0
  59. package/dist/pool/query-bodies.d.ts +68 -0
  60. package/dist/pool/query-bodies.d.ts.map +1 -0
  61. package/dist/pool/query-bodies.js +121 -0
  62. package/dist/pool/small-cap-trend.d.ts +8 -0
  63. package/dist/pool/small-cap-trend.d.ts.map +1 -0
  64. package/dist/pool/small-cap-trend.js +27 -0
  65. package/dist/pool/snapshot-query.d.ts +5 -0
  66. package/dist/pool/snapshot-query.d.ts.map +1 -0
  67. package/dist/pool/snapshot-query.js +15 -0
  68. package/dist/types/board.d.ts +67 -0
  69. package/dist/types/board.d.ts.map +1 -0
  70. package/dist/types/board.js +1 -0
  71. package/dist/types/kline-screenshot.d.ts +62 -0
  72. package/dist/types/kline-screenshot.d.ts.map +1 -0
  73. package/dist/types/kline-screenshot.js +1 -0
  74. package/dist/types/kline.d.ts +31 -0
  75. package/dist/types/kline.d.ts.map +1 -0
  76. package/dist/types/kline.js +6 -0
  77. package/dist/types/market-kline-screenshot.d.ts +27 -0
  78. package/dist/types/market-kline-screenshot.d.ts.map +1 -0
  79. package/dist/types/market-kline-screenshot.js +1 -0
  80. package/dist/types/snapshot-pool.d.ts +53 -0
  81. package/dist/types/snapshot-pool.d.ts.map +1 -0
  82. package/dist/types/snapshot-pool.js +1 -0
  83. package/docs//344/270/244/344/270/252/350/266/213/345/212/277/347/245/250curl.md +102 -0
  84. 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
  85. package/examples/capture-kline-screenshots.ts +151 -0
  86. package/examples/capture-market-kline-screenshots.ts +81 -0
  87. package/examples/fetch-snapshot-pools.ts +237 -0
  88. 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
+ })