@t2b2c/agent-stock-sdk 0.0.0-stage → 0.1.1
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 +188 -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 +133 -0
- package/dist/kline/capture-market-kline-screenshots.d.ts +13 -0
- package/dist/kline/capture-market-kline-screenshots.d.ts.map +1 -0
- package/dist/kline/capture-market-kline-screenshots.js +167 -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-helpers.d.ts +59 -0
- package/dist/kline/screenshot-helpers.d.ts.map +1 -0
- package/dist/kline/screenshot-helpers.js +320 -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 +64 -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 +35 -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/SnapshotPoolItem/345/255/227/346/256/265/350/257/264/346/230/216.md +140 -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 +152 -0
- package/examples/fetch-snapshot-pools.ts +237 -0
- package/package.json +54 -4
package/dist/index.js
ADDED
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
export { AgentStockSdk } from './client.js';
|
|
2
|
+
export { DEFAULT_API_BASE_URL, DEFAULT_STOCK_APP_BASE_URL, DEFAULT_WEBBRIDGE_BASE_URL, normalizeApiBaseUrl, resolveApiBaseUrl, } from './config.js';
|
|
3
|
+
export { AgentStockSdkHttpError, createHttpClient } from './http.js';
|
|
4
|
+
export { fetchGe7BoardThemes } from './board/ge7-themes.js';
|
|
5
|
+
export { fetchJiuyanLimitUpLadder, fetchLimitUpSnapshot, fetchMultiDayCompare, } from './board/limit-up-ladder.js';
|
|
6
|
+
export { buildLargeCapLimitUp3dBody, buildLargeCapTrendBody, buildLimitUp30dBody, buildSmallCapTrendA1Body, buildSmallCapTrendA2Body, } from './pool/query-bodies.js';
|
|
7
|
+
export { mergeSnapshotPoolByCode, pickSnapshotPoolItem, pickSnapshotPoolItems, } from './pool/pick-and-merge.js';
|
|
8
|
+
export { fetchLargeCapLimitUp3dPool } from './pool/large-cap-limit-up-3d.js';
|
|
9
|
+
export { fetchLargeCapTrendPool } from './pool/large-cap-trend.js';
|
|
10
|
+
export { fetchLimitUp30dPool } from './pool/limit-up-30d.js';
|
|
11
|
+
export { fetchSmallCapTrendPool } from './pool/small-cap-trend.js';
|
|
12
|
+
export { SNAPSHOT_QUERY_PATH, postSnapshotQuery } from './pool/snapshot-query.js';
|
|
13
|
+
export { fetchCybKline, fetchGoldKline, fetchIndexKline, fetchNasdaqKline, fetchSseKline, } from './kline/fetch-kline.js';
|
|
14
|
+
export { normalizeKlineBars } from './kline/normalize.js';
|
|
15
|
+
export { captureKlineScreenshots } from './kline/capture-kline-screenshots.js';
|
|
16
|
+
export { captureMarketKlineScreenshots } from './kline/capture-market-kline-screenshots.js';
|
|
17
|
+
export { buildKlineListUrl, DEFAULT_KLINE_SCREENSHOT_YEARS, estimateVisibleBarsForYears, normalizeStockCodes, } from './kline/kline-list-url.js';
|
|
18
|
+
export { buildMarketKlineListUrl, defaultMarketSymbols, parseMarketSymbols, resolveMarketSymbolToken, } from './kline/market-symbols.js';
|
|
19
|
+
export { isAShareStockCode, partitionKlineScreenshotTargets, resolveKlineScreenshotPage, } from './kline/screenshot-route.js';
|
|
20
|
+
export { fetchMarketKlines, fetchMarketSymbolKline, } from './kline/fetch-market-kline.js';
|
|
21
|
+
export { createWebbridgeClient, WebbridgeError } from './kline/webbridge-client.js';
|
|
22
|
+
export { INDEX_KLINE_SYMBOLS, } from './types/kline.js';
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { CaptureKlineScreenshotsOptions, CaptureKlineScreenshotsResult } from '../types/kline-screenshot.js';
|
|
2
|
+
/**
|
|
3
|
+
* Open stock-app `/kline-list` via Kimi WebBridge and screenshot each
|
|
4
|
+
* `[data-kline-card][data-code]`.
|
|
5
|
+
*
|
|
6
|
+
* Requires a running WebBridge daemon + browser extension
|
|
7
|
+
* (`~/.kimi-webbridge/bin/kimi-webbridge start`).
|
|
8
|
+
*/
|
|
9
|
+
export declare function captureKlineScreenshots(options: CaptureKlineScreenshotsOptions): Promise<CaptureKlineScreenshotsResult>;
|
|
10
|
+
//# sourceMappingURL=capture-kline-screenshots.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"capture-kline-screenshots.d.ts","sourceRoot":"","sources":["../../src/kline/capture-kline-screenshots.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EACV,8BAA8B,EAC9B,6BAA6B,EAG9B,MAAM,8BAA8B,CAAA;AA8DrC;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,6BAA6B,CAAC,CA8FxC"}
|
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
import { mkdir } from 'node:fs/promises';
|
|
2
|
+
import { join } from 'node:path';
|
|
3
|
+
import { tmpdir } from 'node:os';
|
|
4
|
+
import { DEFAULT_STOCK_APP_BASE_URL, DEFAULT_WEBBRIDGE_BASE_URL, } from '../config.js';
|
|
5
|
+
import { buildKlineListUrl, DEFAULT_KLINE_SCREENSHOT_YEARS, estimateVisibleBarsForYears, normalizeStockCodes, } from './kline-list-url.js';
|
|
6
|
+
import { captureSelectorPngViaCdp, prepareScreenshotViewport, sleep, unwrapEvaluateValue, } from './screenshot-helpers.js';
|
|
7
|
+
import { createWebbridgeClient, WebbridgeError } from './webbridge-client.js';
|
|
8
|
+
const READY_EVAL_CODE = `(() => {
|
|
9
|
+
const cards = document.querySelectorAll('[data-kline-card]');
|
|
10
|
+
const ready = [...cards]
|
|
11
|
+
.filter((c) => c.querySelectorAll('canvas').length > 0)
|
|
12
|
+
.map((c) => c.getAttribute('data-code'));
|
|
13
|
+
const list = document.querySelector('[data-kline-list]');
|
|
14
|
+
return JSON.stringify({
|
|
15
|
+
count: cards.length,
|
|
16
|
+
ready,
|
|
17
|
+
period: list?.getAttribute('data-kline-period') ?? null,
|
|
18
|
+
bars: list?.getAttribute('data-kline-visible-bars') ?? null,
|
|
19
|
+
});
|
|
20
|
+
})()`;
|
|
21
|
+
function parseReadyProbe(data) {
|
|
22
|
+
const raw = unwrapEvaluateValue(data);
|
|
23
|
+
const parsed = JSON.parse(raw);
|
|
24
|
+
return {
|
|
25
|
+
count: Number(parsed.count) || 0,
|
|
26
|
+
ready: Array.isArray(parsed.ready)
|
|
27
|
+
? parsed.ready.map((c) => String(c ?? '').toUpperCase()).filter(Boolean)
|
|
28
|
+
: [],
|
|
29
|
+
period: parsed.period ?? null,
|
|
30
|
+
bars: parsed.bars ?? null,
|
|
31
|
+
};
|
|
32
|
+
}
|
|
33
|
+
async function waitForCardsReady(command, codes, timeoutMs, pollIntervalMs) {
|
|
34
|
+
const expected = new Set(codes);
|
|
35
|
+
const deadline = Date.now() + timeoutMs;
|
|
36
|
+
let last = null;
|
|
37
|
+
while (Date.now() < deadline) {
|
|
38
|
+
const data = await command('evaluate', { code: READY_EVAL_CODE });
|
|
39
|
+
last = parseReadyProbe(data);
|
|
40
|
+
const readySet = new Set(last.ready);
|
|
41
|
+
const allReady = last.count >= codes.length && codes.every((code) => readySet.has(code));
|
|
42
|
+
if (allReady)
|
|
43
|
+
return last;
|
|
44
|
+
await sleep(pollIntervalMs);
|
|
45
|
+
}
|
|
46
|
+
throw new WebbridgeError(`Timed out waiting for K-line cards (${codes.join(',')}); last=${JSON.stringify(last)}`, 'timeout');
|
|
47
|
+
}
|
|
48
|
+
/**
|
|
49
|
+
* Open stock-app `/kline-list` via Kimi WebBridge and screenshot each
|
|
50
|
+
* `[data-kline-card][data-code]`.
|
|
51
|
+
*
|
|
52
|
+
* Requires a running WebBridge daemon + browser extension
|
|
53
|
+
* (`~/.kimi-webbridge/bin/kimi-webbridge start`).
|
|
54
|
+
*/
|
|
55
|
+
export async function captureKlineScreenshots(options) {
|
|
56
|
+
const codes = normalizeStockCodes(options.codes);
|
|
57
|
+
if (!codes.length) {
|
|
58
|
+
throw new Error('captureKlineScreenshots requires at least one stock code');
|
|
59
|
+
}
|
|
60
|
+
const years = options.years != null && Number.isFinite(options.years) && options.years > 0
|
|
61
|
+
? options.years
|
|
62
|
+
: DEFAULT_KLINE_SCREENSHOT_YEARS;
|
|
63
|
+
const period = options.period ?? 'day';
|
|
64
|
+
const session = options.session?.trim() ||
|
|
65
|
+
`kline-shot-${Date.now().toString(36)}`;
|
|
66
|
+
const timeoutMs = options.timeoutMs ?? 60_000;
|
|
67
|
+
const pollIntervalMs = options.pollIntervalMs ?? 1_000;
|
|
68
|
+
const settleMs = options.settleMs ?? 900;
|
|
69
|
+
const closeTab = options.closeTab !== false;
|
|
70
|
+
const filePrefix = options.filePrefix?.trim() || 'kline';
|
|
71
|
+
const outputDir = options.outputDir?.trim() ||
|
|
72
|
+
join(tmpdir(), 'agent-stock-sdk-kline');
|
|
73
|
+
await mkdir(outputDir, { recursive: true });
|
|
74
|
+
const url = buildKlineListUrl({
|
|
75
|
+
codes,
|
|
76
|
+
years,
|
|
77
|
+
period,
|
|
78
|
+
stockAppBaseUrl: options.stockAppBaseUrl ?? DEFAULT_STOCK_APP_BASE_URL,
|
|
79
|
+
});
|
|
80
|
+
const command = options.command ??
|
|
81
|
+
createWebbridgeClient({
|
|
82
|
+
baseUrl: options.webbridgeBaseUrl ?? DEFAULT_WEBBRIDGE_BASE_URL,
|
|
83
|
+
session,
|
|
84
|
+
fetch: options.fetch,
|
|
85
|
+
}).command;
|
|
86
|
+
let tabOpened = false;
|
|
87
|
+
let tabClosed = false;
|
|
88
|
+
const tryCloseTab = async () => {
|
|
89
|
+
if (!closeTab || !tabOpened || tabClosed)
|
|
90
|
+
return;
|
|
91
|
+
try {
|
|
92
|
+
await command('close_tab', {});
|
|
93
|
+
tabClosed = true;
|
|
94
|
+
}
|
|
95
|
+
catch (err) {
|
|
96
|
+
// Best-effort cleanup; do not mask the original capture error.
|
|
97
|
+
console.warn('[captureKlineScreenshots] close_tab failed:', err instanceof Error ? err.message : err);
|
|
98
|
+
}
|
|
99
|
+
};
|
|
100
|
+
try {
|
|
101
|
+
await command('navigate', {
|
|
102
|
+
url,
|
|
103
|
+
newTab: true,
|
|
104
|
+
group_title: 'K线列表截图',
|
|
105
|
+
});
|
|
106
|
+
tabOpened = true;
|
|
107
|
+
await prepareScreenshotViewport(command);
|
|
108
|
+
const probe = await waitForCardsReady(command, codes, timeoutMs, pollIntervalMs);
|
|
109
|
+
const cards = [];
|
|
110
|
+
for (const code of codes) {
|
|
111
|
+
const selector = `[data-kline-card][data-code="${code}"]`;
|
|
112
|
+
const path = join(outputDir, `${filePrefix}-${code}.png`);
|
|
113
|
+
const shot = await captureSelectorPngViaCdp(command, selector, path, {
|
|
114
|
+
settleMs,
|
|
115
|
+
});
|
|
116
|
+
cards.push({ code, path: shot.path, sizeBytes: shot.sizeBytes });
|
|
117
|
+
}
|
|
118
|
+
await tryCloseTab();
|
|
119
|
+
return {
|
|
120
|
+
url,
|
|
121
|
+
session,
|
|
122
|
+
years,
|
|
123
|
+
period,
|
|
124
|
+
visibleBarsHint: Number(probe.bars) || estimateVisibleBarsForYears(years, period),
|
|
125
|
+
cards,
|
|
126
|
+
tabClosed,
|
|
127
|
+
};
|
|
128
|
+
}
|
|
129
|
+
catch (err) {
|
|
130
|
+
await tryCloseTab();
|
|
131
|
+
throw err;
|
|
132
|
+
}
|
|
133
|
+
}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { CaptureKlineScreenshotsResult } from '../types/kline-screenshot.js';
|
|
2
|
+
import type { CaptureMarketKlineScreenshotsOptions } from '../types/market-kline-screenshot.js';
|
|
3
|
+
/**
|
|
4
|
+
* Open `/market-kline-list` via WebBridge and screenshot each
|
|
5
|
+
* `[data-kline-card][data-symbol]` (indices / gold / US — not A-share stocks).
|
|
6
|
+
*
|
|
7
|
+
* Default `layout: 'per-symbol'` navigates one symbol at a time so each card is
|
|
8
|
+
* above the fold — avoids Kimi WebBridge selector clip bugs on scrollable lists
|
|
9
|
+
* (wrong neighbor / empty strip). Use `layout: 'batch'` only when you need speed
|
|
10
|
+
* and accept scrollIntoView + possible residual clip issues.
|
|
11
|
+
*/
|
|
12
|
+
export declare function captureMarketKlineScreenshots(options?: CaptureMarketKlineScreenshotsOptions): Promise<CaptureKlineScreenshotsResult>;
|
|
13
|
+
//# sourceMappingURL=capture-market-kline-screenshots.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"capture-market-kline-screenshots.d.ts","sourceRoot":"","sources":["../../src/kline/capture-market-kline-screenshots.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,6BAA6B,EAG9B,MAAM,8BAA8B,CAAA;AACrC,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,qCAAqC,CAAA;AA8D/F;;;;;;;;GAQG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,GAAE,oCAAyC,GACjD,OAAO,CAAC,6BAA6B,CAAC,CAmIxC"}
|
|
@@ -0,0 +1,167 @@
|
|
|
1
|
+
import { mkdir } from 'node:fs/promises';
|
|
2
|
+
import { join } from 'node:path';
|
|
3
|
+
import { tmpdir } from 'node:os';
|
|
4
|
+
import { DEFAULT_STOCK_APP_BASE_URL, DEFAULT_WEBBRIDGE_BASE_URL, } from '../config.js';
|
|
5
|
+
import { DEFAULT_KLINE_SCREENSHOT_YEARS } from './kline-list-url.js';
|
|
6
|
+
import { buildMarketKlineListUrl, parseMarketSymbols, } from './market-symbols.js';
|
|
7
|
+
import { captureSelectorPngViaCdp, prepareScreenshotViewport, sleep, unwrapEvaluateValue, } from './screenshot-helpers.js';
|
|
8
|
+
import { createWebbridgeClient, WebbridgeError } from './webbridge-client.js';
|
|
9
|
+
const READY_EVAL_CODE = `(() => {
|
|
10
|
+
const cards = document.querySelectorAll('[data-kline-card]');
|
|
11
|
+
const ready = [...cards]
|
|
12
|
+
.filter((c) => c.querySelectorAll('canvas').length > 0)
|
|
13
|
+
.map((c) => c.getAttribute('data-symbol'));
|
|
14
|
+
const list = document.querySelector('[data-kline-list]');
|
|
15
|
+
return JSON.stringify({
|
|
16
|
+
count: cards.length,
|
|
17
|
+
ready,
|
|
18
|
+
period: list?.getAttribute('data-kline-period') ?? null,
|
|
19
|
+
bars: list?.getAttribute('data-kline-visible-bars') ?? null,
|
|
20
|
+
});
|
|
21
|
+
})()`;
|
|
22
|
+
function parseReadyProbe(data) {
|
|
23
|
+
const raw = unwrapEvaluateValue(data);
|
|
24
|
+
const parsed = JSON.parse(raw);
|
|
25
|
+
return {
|
|
26
|
+
count: Number(parsed.count) || 0,
|
|
27
|
+
ready: Array.isArray(parsed.ready)
|
|
28
|
+
? parsed.ready.map((c) => String(c ?? '')).filter(Boolean)
|
|
29
|
+
: [],
|
|
30
|
+
period: parsed.period ?? null,
|
|
31
|
+
bars: parsed.bars ?? null,
|
|
32
|
+
};
|
|
33
|
+
}
|
|
34
|
+
async function waitForCardsReady(command, symbolIds, timeoutMs, pollIntervalMs) {
|
|
35
|
+
const deadline = Date.now() + timeoutMs;
|
|
36
|
+
let last = null;
|
|
37
|
+
while (Date.now() < deadline) {
|
|
38
|
+
const data = await command('evaluate', { code: READY_EVAL_CODE });
|
|
39
|
+
last = parseReadyProbe(data);
|
|
40
|
+
const readySet = new Set(last.ready);
|
|
41
|
+
const allReady = last.count >= symbolIds.length &&
|
|
42
|
+
symbolIds.every((id) => readySet.has(id));
|
|
43
|
+
if (allReady)
|
|
44
|
+
return last;
|
|
45
|
+
await sleep(pollIntervalMs);
|
|
46
|
+
}
|
|
47
|
+
throw new WebbridgeError(`Timed out waiting for market K-line cards (${symbolIds.join(',')}); last=${JSON.stringify(last)}`, 'timeout');
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* Open `/market-kline-list` via WebBridge and screenshot each
|
|
51
|
+
* `[data-kline-card][data-symbol]` (indices / gold / US — not A-share stocks).
|
|
52
|
+
*
|
|
53
|
+
* Default `layout: 'per-symbol'` navigates one symbol at a time so each card is
|
|
54
|
+
* above the fold — avoids Kimi WebBridge selector clip bugs on scrollable lists
|
|
55
|
+
* (wrong neighbor / empty strip). Use `layout: 'batch'` only when you need speed
|
|
56
|
+
* and accept scrollIntoView + possible residual clip issues.
|
|
57
|
+
*/
|
|
58
|
+
export async function captureMarketKlineScreenshots(options = {}) {
|
|
59
|
+
const resolved = parseMarketSymbols(options.symbols);
|
|
60
|
+
const symbolIds = resolved.map((s) => s.symbolId);
|
|
61
|
+
const years = options.years != null && Number.isFinite(options.years) && options.years > 0
|
|
62
|
+
? options.years
|
|
63
|
+
: DEFAULT_KLINE_SCREENSHOT_YEARS;
|
|
64
|
+
const period = options.period === 'week' ? 'week' : 'day';
|
|
65
|
+
const session = options.session?.trim() || `market-kline-shot-${Date.now().toString(36)}`;
|
|
66
|
+
const timeoutMs = options.timeoutMs ?? 60_000;
|
|
67
|
+
const pollIntervalMs = options.pollIntervalMs ?? 1_000;
|
|
68
|
+
const settleMs = options.settleMs ?? 900;
|
|
69
|
+
const closeTab = options.closeTab !== false;
|
|
70
|
+
const filePrefix = options.filePrefix?.trim() || 'mk';
|
|
71
|
+
const layout = options.layout === 'batch' ? 'batch' : 'per-symbol';
|
|
72
|
+
const stockAppBaseUrl = options.stockAppBaseUrl ?? DEFAULT_STOCK_APP_BASE_URL;
|
|
73
|
+
const outputDir = options.outputDir?.trim() || join(tmpdir(), 'agent-stock-sdk-market-kline');
|
|
74
|
+
await mkdir(outputDir, { recursive: true });
|
|
75
|
+
const command = options.command ??
|
|
76
|
+
createWebbridgeClient({
|
|
77
|
+
baseUrl: options.webbridgeBaseUrl ?? DEFAULT_WEBBRIDGE_BASE_URL,
|
|
78
|
+
session,
|
|
79
|
+
fetch: options.fetch,
|
|
80
|
+
}).command;
|
|
81
|
+
let tabOpened = false;
|
|
82
|
+
let tabClosed = false;
|
|
83
|
+
let lastUrl = '';
|
|
84
|
+
let lastBarsHint = Math.round(years * 250);
|
|
85
|
+
const tryCloseTab = async () => {
|
|
86
|
+
if (!closeTab || !tabOpened || tabClosed)
|
|
87
|
+
return;
|
|
88
|
+
try {
|
|
89
|
+
await command('close_tab', {});
|
|
90
|
+
tabClosed = true;
|
|
91
|
+
}
|
|
92
|
+
catch (err) {
|
|
93
|
+
console.warn('[captureMarketKlineScreenshots] close_tab failed:', err instanceof Error ? err.message : err);
|
|
94
|
+
}
|
|
95
|
+
};
|
|
96
|
+
const shotOne = async (symbolId) => {
|
|
97
|
+
const selector = `[data-kline-card][data-symbol="${symbolId}"]`;
|
|
98
|
+
const safeName = symbolId.replace(/[^a-zA-Z0-9._-]+/g, '_');
|
|
99
|
+
const path = join(outputDir, `${filePrefix}-${safeName}.png`);
|
|
100
|
+
const shot = await captureSelectorPngViaCdp(command, selector, path, {
|
|
101
|
+
settleMs,
|
|
102
|
+
});
|
|
103
|
+
return { code: symbolId, path: shot.path, sizeBytes: shot.sizeBytes };
|
|
104
|
+
};
|
|
105
|
+
try {
|
|
106
|
+
const cards = [];
|
|
107
|
+
if (layout === 'per-symbol') {
|
|
108
|
+
for (let i = 0; i < symbolIds.length; i += 1) {
|
|
109
|
+
const symbolId = symbolIds[i];
|
|
110
|
+
const url = buildMarketKlineListUrl({
|
|
111
|
+
symbols: [symbolId],
|
|
112
|
+
years,
|
|
113
|
+
period,
|
|
114
|
+
stockAppBaseUrl,
|
|
115
|
+
});
|
|
116
|
+
lastUrl = url;
|
|
117
|
+
await command('navigate', {
|
|
118
|
+
url,
|
|
119
|
+
newTab: !tabOpened,
|
|
120
|
+
group_title: '市场K线列表截图',
|
|
121
|
+
});
|
|
122
|
+
tabOpened = true;
|
|
123
|
+
if (i === 0) {
|
|
124
|
+
await prepareScreenshotViewport(command);
|
|
125
|
+
}
|
|
126
|
+
const probe = await waitForCardsReady(command, [symbolId], timeoutMs, pollIntervalMs);
|
|
127
|
+
lastBarsHint = Number(probe.bars) || lastBarsHint;
|
|
128
|
+
cards.push(await shotOne(symbolId));
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
else {
|
|
132
|
+
const url = buildMarketKlineListUrl({
|
|
133
|
+
symbols: symbolIds,
|
|
134
|
+
years,
|
|
135
|
+
period,
|
|
136
|
+
stockAppBaseUrl,
|
|
137
|
+
});
|
|
138
|
+
lastUrl = url;
|
|
139
|
+
await command('navigate', {
|
|
140
|
+
url,
|
|
141
|
+
newTab: true,
|
|
142
|
+
group_title: '市场K线列表截图',
|
|
143
|
+
});
|
|
144
|
+
tabOpened = true;
|
|
145
|
+
await prepareScreenshotViewport(command);
|
|
146
|
+
const probe = await waitForCardsReady(command, symbolIds, timeoutMs, pollIntervalMs);
|
|
147
|
+
lastBarsHint = Number(probe.bars) || lastBarsHint;
|
|
148
|
+
for (const symbolId of symbolIds) {
|
|
149
|
+
cards.push(await shotOne(symbolId));
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
await tryCloseTab();
|
|
153
|
+
return {
|
|
154
|
+
url: lastUrl,
|
|
155
|
+
session,
|
|
156
|
+
years,
|
|
157
|
+
period,
|
|
158
|
+
visibleBarsHint: lastBarsHint,
|
|
159
|
+
cards,
|
|
160
|
+
tabClosed,
|
|
161
|
+
};
|
|
162
|
+
}
|
|
163
|
+
catch (err) {
|
|
164
|
+
await tryCloseTab();
|
|
165
|
+
throw err;
|
|
166
|
+
}
|
|
167
|
+
}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import { type FetchKlineOptions, type IndexKlineSymbol, type KlineBar, type KlinePeriod } from '../types/kline.js';
|
|
2
|
+
export type StockSdkLike = {
|
|
3
|
+
kline: {
|
|
4
|
+
cn: (symbol: string, options?: {
|
|
5
|
+
period?: KlinePeriod;
|
|
6
|
+
adjust?: '' | 'qfq' | 'hfq';
|
|
7
|
+
startDate?: string;
|
|
8
|
+
endDate?: string;
|
|
9
|
+
}) => Promise<Array<Record<string, unknown>>>;
|
|
10
|
+
us: (symbol: string, options?: {
|
|
11
|
+
period?: KlinePeriod;
|
|
12
|
+
adjust?: '' | 'qfq' | 'hfq';
|
|
13
|
+
startDate?: string;
|
|
14
|
+
endDate?: string;
|
|
15
|
+
}) => Promise<Array<Record<string, unknown>>>;
|
|
16
|
+
};
|
|
17
|
+
futures: {
|
|
18
|
+
globalKline: (symbol: string, options?: {
|
|
19
|
+
period?: KlinePeriod;
|
|
20
|
+
startDate?: string;
|
|
21
|
+
endDate?: string;
|
|
22
|
+
}) => Promise<Array<Record<string, unknown>>>;
|
|
23
|
+
};
|
|
24
|
+
};
|
|
25
|
+
export declare function fetchIndexKline(symbol: IndexKlineSymbol, options?: FetchKlineOptions, stockSdk?: StockSdkLike | null): Promise<KlineBar[]>;
|
|
26
|
+
export declare function fetchCybKline(options?: FetchKlineOptions, stockSdk?: StockSdkLike | null): Promise<KlineBar[]>;
|
|
27
|
+
export declare function fetchSseKline(options?: FetchKlineOptions, stockSdk?: StockSdkLike | null): Promise<KlineBar[]>;
|
|
28
|
+
export declare function fetchNasdaqKline(options?: FetchKlineOptions, stockSdk?: StockSdkLike | null): Promise<KlineBar[]>;
|
|
29
|
+
export declare function fetchGoldKline(options?: FetchKlineOptions, stockSdk?: StockSdkLike | null): Promise<KlineBar[]>;
|
|
30
|
+
//# sourceMappingURL=fetch-kline.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fetch-kline.d.ts","sourceRoot":"","sources":["../../src/kline/fetch-kline.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACb,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAA;AAG1B,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE;QACL,EAAE,EAAE,CACF,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;YACR,MAAM,CAAC,EAAE,WAAW,CAAA;YACpB,MAAM,CAAC,EAAE,EAAE,GAAG,KAAK,GAAG,KAAK,CAAA;YAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;YAClB,OAAO,CAAC,EAAE,MAAM,CAAA;SACjB,KACE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;QAC5C,EAAE,EAAE,CACF,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;YACR,MAAM,CAAC,EAAE,WAAW,CAAA;YACpB,MAAM,CAAC,EAAE,EAAE,GAAG,KAAK,GAAG,KAAK,CAAA;YAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;YAClB,OAAO,CAAC,EAAE,MAAM,CAAA;SACjB,KACE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;KAC7C,CAAA;IACD,OAAO,EAAE;QACP,WAAW,EAAE,CACX,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;YACR,MAAM,CAAC,EAAE,WAAW,CAAA;YACpB,SAAS,CAAC,EAAE,MAAM,CAAA;YAClB,OAAO,CAAC,EAAE,MAAM,CAAA;SACjB,KACE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;KAC7C,CAAA;CACF,CAAA;AAoBD,wBAAsB,eAAe,CACnC,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,iBAAsB,EAC/B,QAAQ,CAAC,EAAE,YAAY,GAAG,IAAI,GAC7B,OAAO,CAAC,QAAQ,EAAE,CAAC,CA2BrB;AAED,wBAAsB,aAAa,CACjC,OAAO,CAAC,EAAE,iBAAiB,EAC3B,QAAQ,CAAC,EAAE,YAAY,GAAG,IAAI,GAC7B,OAAO,CAAC,QAAQ,EAAE,CAAC,CAErB;AAED,wBAAsB,aAAa,CACjC,OAAO,CAAC,EAAE,iBAAiB,EAC3B,QAAQ,CAAC,EAAE,YAAY,GAAG,IAAI,GAC7B,OAAO,CAAC,QAAQ,EAAE,CAAC,CAErB;AAED,wBAAsB,gBAAgB,CACpC,OAAO,CAAC,EAAE,iBAAiB,EAC3B,QAAQ,CAAC,EAAE,YAAY,GAAG,IAAI,GAC7B,OAAO,CAAC,QAAQ,EAAE,CAAC,CAErB;AAED,wBAAsB,cAAc,CAClC,OAAO,CAAC,EAAE,iBAAiB,EAC3B,QAAQ,CAAC,EAAE,YAAY,GAAG,IAAI,GAC7B,OAAO,CAAC,QAAQ,EAAE,CAAC,CAErB"}
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
import { StockSDK } from 'stock-sdk';
|
|
2
|
+
import { INDEX_KLINE_SYMBOLS, } from '../types/kline.js';
|
|
3
|
+
import { normalizeKlineBars } from './normalize.js';
|
|
4
|
+
let defaultStockSdk = null;
|
|
5
|
+
function getDefaultStockSdk() {
|
|
6
|
+
if (!defaultStockSdk) {
|
|
7
|
+
defaultStockSdk = new StockSDK();
|
|
8
|
+
}
|
|
9
|
+
return defaultStockSdk;
|
|
10
|
+
}
|
|
11
|
+
function periodOpts(options = {}) {
|
|
12
|
+
const period = options.period ?? 'daily';
|
|
13
|
+
return {
|
|
14
|
+
period,
|
|
15
|
+
...(options.startDate ? { startDate: options.startDate } : {}),
|
|
16
|
+
...(options.endDate ? { endDate: options.endDate } : {}),
|
|
17
|
+
};
|
|
18
|
+
}
|
|
19
|
+
export async function fetchIndexKline(symbol, options = {}, stockSdk) {
|
|
20
|
+
const meta = INDEX_KLINE_SYMBOLS[symbol];
|
|
21
|
+
if (!meta) {
|
|
22
|
+
throw new Error(`Unknown index kline symbol: ${String(symbol)}`);
|
|
23
|
+
}
|
|
24
|
+
const sdk = stockSdk ?? getDefaultStockSdk();
|
|
25
|
+
const base = periodOpts(options);
|
|
26
|
+
if (meta.market === 'cn') {
|
|
27
|
+
const rows = await sdk.kline.cn(meta.code, {
|
|
28
|
+
...base,
|
|
29
|
+
adjust: options.adjust ?? 'qfq',
|
|
30
|
+
});
|
|
31
|
+
return normalizeKlineBars(rows);
|
|
32
|
+
}
|
|
33
|
+
if (meta.market === 'us') {
|
|
34
|
+
const rows = await sdk.kline.us(meta.code, {
|
|
35
|
+
...base,
|
|
36
|
+
...(options.adjust != null ? { adjust: options.adjust } : {}),
|
|
37
|
+
});
|
|
38
|
+
return normalizeKlineBars(rows);
|
|
39
|
+
}
|
|
40
|
+
const rows = await sdk.futures.globalKline(meta.code, base);
|
|
41
|
+
return normalizeKlineBars(rows);
|
|
42
|
+
}
|
|
43
|
+
export async function fetchCybKline(options, stockSdk) {
|
|
44
|
+
return fetchIndexKline('cyb', options, stockSdk);
|
|
45
|
+
}
|
|
46
|
+
export async function fetchSseKline(options, stockSdk) {
|
|
47
|
+
return fetchIndexKline('sse', options, stockSdk);
|
|
48
|
+
}
|
|
49
|
+
export async function fetchNasdaqKline(options, stockSdk) {
|
|
50
|
+
return fetchIndexKline('nasdaq', options, stockSdk);
|
|
51
|
+
}
|
|
52
|
+
export async function fetchGoldKline(options, stockSdk) {
|
|
53
|
+
return fetchIndexKline('gold', options, stockSdk);
|
|
54
|
+
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { FetchKlineOptions, KlineBar } from '../types/kline.js';
|
|
2
|
+
import { type ResolvedMarketSymbol } from './market-symbols.js';
|
|
3
|
+
import { type StockSdkLike } from './fetch-kline.js';
|
|
4
|
+
export type MarketKlineSeries = ResolvedMarketSymbol & {
|
|
5
|
+
bars: KlineBar[];
|
|
6
|
+
};
|
|
7
|
+
/** Fetch OHLCV for one resolved market symbol (preset or us:TICKER). */
|
|
8
|
+
export declare function fetchMarketSymbolKline(symbol: string | ResolvedMarketSymbol, options?: FetchKlineOptions, stockSdk?: StockSdkLike | null): Promise<MarketKlineSeries>;
|
|
9
|
+
export declare function fetchMarketKlines(symbols: Array<string | ResolvedMarketSymbol>, options?: FetchKlineOptions, stockSdk?: StockSdkLike | null): Promise<MarketKlineSeries[]>;
|
|
10
|
+
//# sourceMappingURL=fetch-market-kline.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fetch-market-kline.d.ts","sourceRoot":"","sources":["../../src/kline/fetch-market-kline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACpE,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAuBrE,MAAM,MAAM,iBAAiB,GAAG,oBAAoB,GAAG;IACrD,IAAI,EAAE,QAAQ,EAAE,CAAA;CACjB,CAAA;AAED,wEAAwE;AACxE,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,GAAG,oBAAoB,EACrC,OAAO,GAAE,iBAAsB,EAC/B,QAAQ,CAAC,EAAE,YAAY,GAAG,IAAI,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CAqD5B;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,oBAAoB,CAAC,EAC7C,OAAO,GAAE,iBAAsB,EAC/B,QAAQ,CAAC,EAAE,YAAY,GAAG,IAAI,GAC7B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAM9B"}
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
import { resolveMarketSymbolToken, } from './market-symbols.js';
|
|
2
|
+
import { fetchIndexKline } from './fetch-kline.js';
|
|
3
|
+
import { normalizeKlineBars } from './normalize.js';
|
|
4
|
+
import { StockSDK } from 'stock-sdk';
|
|
5
|
+
import { INDEX_KLINE_SYMBOLS } from '../types/kline.js';
|
|
6
|
+
let defaultStockSdk = null;
|
|
7
|
+
function getDefaultStockSdk() {
|
|
8
|
+
if (!defaultStockSdk) {
|
|
9
|
+
defaultStockSdk = new StockSDK();
|
|
10
|
+
}
|
|
11
|
+
return defaultStockSdk;
|
|
12
|
+
}
|
|
13
|
+
function periodOpts(options = {}) {
|
|
14
|
+
const period = options.period ?? 'daily';
|
|
15
|
+
return {
|
|
16
|
+
period,
|
|
17
|
+
...(options.startDate ? { startDate: options.startDate } : {}),
|
|
18
|
+
...(options.endDate ? { endDate: options.endDate } : {}),
|
|
19
|
+
};
|
|
20
|
+
}
|
|
21
|
+
/** Fetch OHLCV for one resolved market symbol (preset or us:TICKER). */
|
|
22
|
+
export async function fetchMarketSymbolKline(symbol, options = {}, stockSdk) {
|
|
23
|
+
const resolved = typeof symbol === 'string' ? resolveMarketSymbolToken(symbol) : symbol;
|
|
24
|
+
const sdk = stockSdk ?? getDefaultStockSdk();
|
|
25
|
+
const base = periodOpts(options);
|
|
26
|
+
// Preset index/gold ids reuse fetchIndexKline
|
|
27
|
+
if (resolved.symbolId in INDEX_KLINE_SYMBOLS) {
|
|
28
|
+
const bars = await fetchIndexKline(resolved.symbolId, options, sdk);
|
|
29
|
+
const lastName = bars.find((b) => b.name)?.name;
|
|
30
|
+
return {
|
|
31
|
+
...resolved,
|
|
32
|
+
label: lastName?.trim() || resolved.label,
|
|
33
|
+
bars,
|
|
34
|
+
};
|
|
35
|
+
}
|
|
36
|
+
if (resolved.market === 'us') {
|
|
37
|
+
const rows = await sdk.kline.us(resolved.code, {
|
|
38
|
+
...base,
|
|
39
|
+
...(options.adjust != null ? { adjust: options.adjust } : {}),
|
|
40
|
+
});
|
|
41
|
+
const bars = normalizeKlineBars(rows);
|
|
42
|
+
const lastName = bars.find((b) => b.name)?.name;
|
|
43
|
+
return {
|
|
44
|
+
...resolved,
|
|
45
|
+
label: lastName?.trim() || resolved.label,
|
|
46
|
+
bars,
|
|
47
|
+
};
|
|
48
|
+
}
|
|
49
|
+
if (resolved.market === 'futures') {
|
|
50
|
+
const rows = await sdk.futures.globalKline(resolved.code, base);
|
|
51
|
+
const bars = normalizeKlineBars(rows);
|
|
52
|
+
return { ...resolved, bars };
|
|
53
|
+
}
|
|
54
|
+
const rows = await sdk.kline.cn(resolved.code, {
|
|
55
|
+
...base,
|
|
56
|
+
adjust: options.adjust ?? 'qfq',
|
|
57
|
+
});
|
|
58
|
+
const bars = normalizeKlineBars(rows);
|
|
59
|
+
return { ...resolved, bars };
|
|
60
|
+
}
|
|
61
|
+
export async function fetchMarketKlines(symbols, options = {}, stockSdk) {
|
|
62
|
+
const results = [];
|
|
63
|
+
for (const symbol of symbols) {
|
|
64
|
+
results.push(await fetchMarketSymbolKline(symbol, options, stockSdk));
|
|
65
|
+
}
|
|
66
|
+
return results;
|
|
67
|
+
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { DEFAULT_STOCK_APP_BASE_URL } from '../config.js';
|
|
2
|
+
import type { KlineScreenshotPeriod } from '../types/kline-screenshot.js';
|
|
3
|
+
export { DEFAULT_STOCK_APP_BASE_URL };
|
|
4
|
+
export declare const DEFAULT_KLINE_SCREENSHOT_YEARS = 2.5;
|
|
5
|
+
/** Approximate trading bars for a calendar-year window (mirrors stock-app estimate). */
|
|
6
|
+
export declare function estimateVisibleBarsForYears(years: number, period?: KlineScreenshotPeriod): number;
|
|
7
|
+
export declare function normalizeStockCodes(codes: string[]): string[];
|
|
8
|
+
export declare function buildKlineListUrl(input: {
|
|
9
|
+
codes: string[];
|
|
10
|
+
years?: number;
|
|
11
|
+
period?: KlineScreenshotPeriod;
|
|
12
|
+
stockAppBaseUrl?: string;
|
|
13
|
+
}): string;
|
|
14
|
+
//# sourceMappingURL=kline-list-url.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"kline-list-url.d.ts","sourceRoot":"","sources":["../../src/kline/kline-list-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AAEzE,OAAO,EAAE,0BAA0B,EAAE,CAAA;AACrC,eAAO,MAAM,8BAA8B,MAAM,CAAA;AAEjD,wFAAwF;AACxF,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,qBAA6B,GACpC,MAAM,CAWR;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAY7D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,qBAAqB,CAAA;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,GAAG,MAAM,CAgBT"}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import { DEFAULT_STOCK_APP_BASE_URL } from '../config.js';
|
|
2
|
+
export { DEFAULT_STOCK_APP_BASE_URL };
|
|
3
|
+
export const DEFAULT_KLINE_SCREENSHOT_YEARS = 2.5;
|
|
4
|
+
/** Approximate trading bars for a calendar-year window (mirrors stock-app estimate). */
|
|
5
|
+
export function estimateVisibleBarsForYears(years, period = 'day') {
|
|
6
|
+
const safeYears = Number.isFinite(years) && years > 0 ? years : DEFAULT_KLINE_SCREENSHOT_YEARS;
|
|
7
|
+
switch (period) {
|
|
8
|
+
case 'week':
|
|
9
|
+
return Math.round(safeYears * 52);
|
|
10
|
+
case 'month':
|
|
11
|
+
return Math.round(safeYears * 12);
|
|
12
|
+
case 'day':
|
|
13
|
+
default:
|
|
14
|
+
return Math.round(safeYears * 250);
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
export function normalizeStockCodes(codes) {
|
|
18
|
+
const seen = new Set();
|
|
19
|
+
const out = [];
|
|
20
|
+
for (const raw of codes) {
|
|
21
|
+
const code = String(raw ?? '')
|
|
22
|
+
.trim()
|
|
23
|
+
.toUpperCase();
|
|
24
|
+
if (!code || seen.has(code))
|
|
25
|
+
continue;
|
|
26
|
+
seen.add(code);
|
|
27
|
+
out.push(code);
|
|
28
|
+
}
|
|
29
|
+
return out;
|
|
30
|
+
}
|
|
31
|
+
export function buildKlineListUrl(input) {
|
|
32
|
+
const codes = normalizeStockCodes(input.codes);
|
|
33
|
+
if (!codes.length) {
|
|
34
|
+
throw new Error('buildKlineListUrl requires at least one stock code');
|
|
35
|
+
}
|
|
36
|
+
const years = input.years != null && Number.isFinite(input.years) && input.years > 0
|
|
37
|
+
? input.years
|
|
38
|
+
: DEFAULT_KLINE_SCREENSHOT_YEARS;
|
|
39
|
+
const period = input.period ?? 'day';
|
|
40
|
+
const base = (input.stockAppBaseUrl ?? DEFAULT_STOCK_APP_BASE_URL).replace(/\/+$/, '');
|
|
41
|
+
const url = new URL(`${base}/kline-list`);
|
|
42
|
+
url.searchParams.set('codes', codes.join(','));
|
|
43
|
+
url.searchParams.set('years', String(years));
|
|
44
|
+
url.searchParams.set('period', period);
|
|
45
|
+
return url.toString();
|
|
46
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
export type MarketKlineMarket = 'cn' | 'us' | 'futures';
|
|
2
|
+
export type ResolvedMarketSymbol = {
|
|
3
|
+
/** Stable id for URL / data-symbol (e.g. `cyb`, `us:AAPL`). */
|
|
4
|
+
symbolId: string;
|
|
5
|
+
label: string;
|
|
6
|
+
code: string;
|
|
7
|
+
market: MarketKlineMarket;
|
|
8
|
+
};
|
|
9
|
+
/**
|
|
10
|
+
* Parse `symbols` query tokens: presets (`cyb`) and US tickers (`us:AAPL`).
|
|
11
|
+
* Throws on bare A-share 6-digit codes.
|
|
12
|
+
*/
|
|
13
|
+
export declare function parseMarketSymbols(raw: string | string[] | null | undefined): ResolvedMarketSymbol[];
|
|
14
|
+
export declare function resolveMarketSymbolToken(token: string): ResolvedMarketSymbol;
|
|
15
|
+
export declare function defaultMarketSymbols(): ResolvedMarketSymbol[];
|
|
16
|
+
export declare function buildMarketKlineListUrl(input: {
|
|
17
|
+
symbols?: string[];
|
|
18
|
+
years?: number;
|
|
19
|
+
period?: 'day' | 'week';
|
|
20
|
+
stockAppBaseUrl?: string;
|
|
21
|
+
}): string;
|
|
22
|
+
//# sourceMappingURL=market-symbols.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"market-symbols.d.ts","sourceRoot":"","sources":["../../src/kline/market-symbols.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAA;AAEvD,MAAM,MAAM,oBAAoB,GAAG;IACjC,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,iBAAiB,CAAA;CAC1B,CAAA;AAmBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,GACxC,oBAAoB,EAAE,CAyBxB;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAqD5E;AAED,wBAAgB,oBAAoB,IAAI,oBAAoB,EAAE,CAE7D;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;IACvB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,GAAG,MAAM,CAoBT"}
|