@dshtrading/connector-xysz 0.5.0

package/LICENSE

@@ -0,0 +1,75 @@
+Copyright (c) 2026 zhu1090093659 (dsh-trading)
+
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose.  However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license to distribute copies of the software.  Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution is use for a permitted purpose regardless of the source of funding or obligations resulting from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else.  These terms do not imply any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice.  Otherwise, all your licenses end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
+
+**You** refers to the individual or entity agreeing to these terms.
+
+**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization.  **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the software under these terms.
+
+**Use** means anything you do with the software requiring one of your licenses.

package/README.md

@@ -0,0 +1,64 @@
+# @dshtrading/connector-xysz
+
+中国银河证券**星耀数智**（AmazingData / tgw）A 股数据源适配器。**数据面-only**：
+提供 \`tradingCnMarketData\` 与 \`cn_*\` 行情工具，无交易通道（星耀数智是行情与资讯数据服务）。
+
+## 架构
+
+上游不是公开 Web 端点，而是券商 SDK：
+
+    connector-xysz ──HTTP──> xysz-api（FastAPI 封装，局域网 Ubuntu 机器）
+                                └──AmazingData/tgw Python SDK──> 101.230.159.235:8600
+
+AmazingData 是**有状态**的 Python SDK（调用前必须 \`ad.login()\`），不能在 Node 侧直连；
+\`xysz-api\` 承担登录单例与 SDK 调用串行化（见该服务 README）。本连接器只认 \`apiUrl\`。
+
+## 配置
+
+| 字段 | 默认 | 说明 |
+|---|---|---|
+| \`enabled\` | \`false\` | 互斥激活总开关（同一市场同一时刻至多一个数据源激活） |
+| \`apiUrl\` | \`http://127.0.0.1:8191\` | xysz-api 地址；可用环境变量 \`XYSZ_API_URL\` |
+| \`timeoutMs\` | \`60000\` | 单次上游请求超时 |
+
+## 接线
+
+- **数据面行**：\`packages/cn/cordis.patch.yml\` → \`dsh-trading-cn-dataplane-xysz\`
+  （注册 \`(cn, xysz)\` 进 \`tradingMarketDataRegistry\`，不占根市场键）。
+- **preset 行**：\`packages/cn/assets/preset/cn-trader/agent.cordis.yml\` →
+  \`dsh-trading-cn-connector-xysz\`（在既有 \`tradingCnMarketData\` isolate 组内）。
+- **provider 词汇**：\`packages/router/src/index.ts\` 的 \`PROVIDER_VOCABULARY\` 加 \`xysz\`；
+  设置页显示名 \`packages/client-ui-settings\`（\`PROVIDER_LABELS\` + \`locales.ts\` 中英）。
+- **profile overrides**：\`node scripts/sync-profile-overrides.mjs --all --dsh-home ~/.dsh-trading\`
+  （坑 #15；注意 \`--dsh-home\`，Web 会话的 \`DSH_HOME\` 指向 ~/.dsh 会找错 profile 集）。
+
+用户切换：设置 → 数据源 → cn → 银河星耀数智（AmazingData）。
+
+## 工具
+
+| 工具 | 说明 |
+|---|---|
+| \`cn_get_ticker\` | 最新行情（价/昨收/涨跌幅/买卖一档） |
+| \`cn_get_klines\` | K 线（1m/3m/5m/15m/30m/1h/2h/1d/1w/1M，A 股全历史） |
+| \`cn_get_orderbook\` | 五档盘口 |
+| \`cn_list_instruments\` | A 股名册（沪深北 ~5570 只，含中文简称） |
+| \`cn_get_fundamentals\` | 基本面快照（简称/板块 + 52 周高低） |
+
+## 契约
+
+- **符号**：入参接受规范形 \`600519.SH\`、裸 6 位 \`600519\`、前缀形 \`sh600519\`；
+  输出一律规范形。港股/加密形态显式拒绝（\`TRADING_UNSUPPORTED_SYMBOL\`，fail-closed）。
+- **周期**：本连接器支持 \`1m/3m/5m/15m/30m/1h/2h/1d/1w/1M\`；上游未覆盖的周期
+  （如 \`4h\`/\`3d\`）抛 \`TRADING_UNSUPPORTED_INTERVAL\`，不静默降级。
+- **错误映射**：上游 400 → \`TRADING_UNSUPPORTED_SYMBOL\`；5xx/502 → \`TRADING_UPSTREAM_ERROR\`；
+  不可达 → \`TRADING_NETWORK\`；非 JSON → \`TRADING_EXCHANGE_ERROR\`。
+- **服务类字段**用 TS 编译期 \`private\`（禁 ECMAScript \`#\`，cordis realm 代理会炸）。
+
+## 出网验证（铁律）
+
+    node spikes/impl-xysz/r3-real-network-verify.mjs   # 连接器链路 13 项
+    node spikes/impl-xysz/r3-dataplane-e2e.mjs         # 数据面装配 + loader 解析面
+
+证据落 \`spikes/impl-xysz/r3-*.raw.json\` + \`r3-verify-summary.json\`。
+前置：xysz-api 在跑；8191 被 ufw 拦时先开隧道
+\`ssh -f -N -L 127.0.0.1:8191:127.0.0.1:8191 local1\`。

package/lib/dataplane.d.ts

@@ -0,0 +1,7 @@
+import { Config } from "./index.js";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/dataplane.d.ts
+declare const inject: string[];
+declare function apply(ctx: Context, config?: Partial<Config>): void;
+//#endregion
+export { Config, apply, inject };

package/lib/dataplane.js

@@ -0,0 +1,26 @@
+import { Config, ROUTER_PROVIDER, TRADING_CN_MARKET_DATA_KEY, XyszMarketDataService } from "./index.js";
+//#region src/dataplane.ts
+const inject = [];
+/** 解析注册表服务；老部署（base/router 未升级）返回 undefined → 调用方回退直接 provide。 */
+function resolveMarketDataRegistry(ctx) {
+	const candidate = ctx.get?.("tradingMarketDataRegistry", false);
+	return candidate !== void 0 ? candidate : void 0;
+}
+const MARKET = "cn";
+function apply(ctx, config) {
+	if (config?.enabled === false) return;
+	const options = {
+		apiUrl: config?.apiUrl ?? "http://127.0.0.1:8191",
+		timeoutMs: config?.timeoutMs ?? 6e4
+	};
+	const registry = resolveMarketDataRegistry(ctx);
+	if (registry === void 0) {
+		new XyszMarketDataService(ctx, options);
+		return;
+	}
+	const inner = ctx.isolate(TRADING_CN_MARKET_DATA_KEY);
+	const service = new XyszMarketDataService(inner, options);
+	ctx.effect(() => registry.register(MARKET, ROUTER_PROVIDER, service));
+}
+//#endregion
+export { Config, apply, inject };

package/lib/index.d.ts

@@ -0,0 +1,42 @@
+import { INTERVAL_VOCABULARY, Interval, Kline, Orderbook, StockFundamentals, Ticker, TradingServiceError, XyszRestClient, XyszRestOptions, XyszSymbol, assertSupportedInterval, toXyszSymbol } from "./rest.js";
+import { Context, Service } from "@deepseek-ai/cordis";
+import Schema from "@deepseek-ai/schemastery";
+import { Disposable, Interval as Interval$1, Kline as Kline$1, MarketDataService, Orderbook as Orderbook$1, StockFundamentals as StockFundamentals$1, Ticker as Ticker$1 } from "@dshtrading/api";
+//#region src/index.d.ts
+/** 插件名 = preset 行 id（全仓唯一，insert-only 铁律 #1）。 */
+declare const name = "dsh-trading-cn-connector-xysz";
+interface Config {
+  /** 互斥激活总开关（默认 false）：false 时本插件不注册任何服务/工具。 */
+  enabled: boolean;
+  /** 星耀数智 FastAPI 封装服务地址（局域网 192.168.31.50:8191 或本机 SSH 隧道 127.0.0.1:8191）。 */
+  apiUrl?: string;
+  /** 单次上游请求超时（ms）。 */
+  timeoutMs?: number;
+}
+declare const Config: Schema<Config>;
+/** 需要宿主提供的 Cordis 服务。 */
+declare const inject: string[];
+/** 行情服务键（@dshtrading/api 的 Context 增强：tradingCnMarketData）。 */
+declare const TRADING_CN_MARKET_DATA_KEY = "tradingCnMarketData";
+/** 路由 provider slug（开放词汇 = 数据源 slug）。 */
+declare const ROUTER_PROVIDER = "xysz";
+declare class XyszMarketDataService extends Service implements MarketDataService {
+  private readonly client;
+  constructor(ctx: Context, options?: XyszRestOptions, serviceName?: string);
+  getTicker(symbol: string): Promise<Ticker$1>;
+  getKlines(symbol: string, interval?: Interval$1, limit?: number): Promise<Kline$1[]>;
+  getOrderbook(symbol: string): Promise<Orderbook$1>;
+  listInstruments(query?: string): Promise<Array<{
+    symbol: string;
+    name?: string;
+  }>>;
+  getFundamentals(symbol: string): Promise<StockFundamentals$1>;
+  subscribeTicker(symbol: string, cb: (ticker: Ticker$1) => void, options?: {
+    intervalMs?: number;
+  }): Disposable;
+}
+/** 路由闸门：选中的 provider 不是本连接器时让位（老部署无路由则放行）。 */
+declare function routeAllows(ctx: Context, config: Config, market?: string): boolean;
+declare function apply(ctx: Context, config: Config): void;
+//#endregion
+export { Config, INTERVAL_VOCABULARY, type Interval, type Kline, type Orderbook, ROUTER_PROVIDER, type StockFundamentals, TRADING_CN_MARKET_DATA_KEY, type Ticker, TradingServiceError, XyszMarketDataService, XyszRestClient, XyszRestOptions, XyszSymbol, apply, assertSupportedInterval, inject, name, routeAllows, toXyszSymbol };

package/lib/index.js

@@ -0,0 +1,182 @@
+import { INTERVAL_VOCABULARY, TradingServiceError, XyszRestClient, assertSupportedInterval, toXyszSymbol } from "./rest.js";
+import { Service } from "@deepseek-ai/cordis";
+import { defineTool } from "@deepseek-ai/dsh-tools";
+import Schema from "@deepseek-ai/schemastery";
+//#region src/index.ts
+/** 插件名 = preset 行 id（全仓唯一，insert-only 铁律 #1）。 */
+const name = "dsh-trading-cn-connector-xysz";
+const Config = Schema.object({
+	enabled: Schema.boolean().default(false).description("是否激活星耀数智连接器（同一市场同一时刻至多一个数据源激活）"),
+	apiUrl: Schema.string().default("http://127.0.0.1:8191").description("星耀数智 AmazingData REST 封装服务地址"),
+	timeoutMs: Schema.number().default(6e4).description("上游请求超时（毫秒）")
+});
+/** 需要宿主提供的 Cordis 服务。 */
+const inject = ["tools"];
+/** 行情服务键（@dshtrading/api 的 Context 增强：tradingCnMarketData）。 */
+const TRADING_CN_MARKET_DATA_KEY = "tradingCnMarketData";
+/** 路由 provider slug（开放词汇 = 数据源 slug）。 */
+const ROUTER_PROVIDER = "xysz";
+const SUBSCRIBE_MIN_MS = 1e3;
+const SUBSCRIBE_DEFAULT_MS = 5e3;
+var XyszMarketDataService = class extends Service {
+	client;
+	constructor(ctx, options = {}, serviceName = TRADING_CN_MARKET_DATA_KEY) {
+		super(ctx, serviceName);
+		this.client = new XyszRestClient(options);
+	}
+	async getTicker(symbol) {
+		return this.client.getTicker(symbol);
+	}
+	async getKlines(symbol, interval = "1d", limit = 100) {
+		return this.client.getKlines(symbol, interval, limit);
+	}
+	async getOrderbook(symbol) {
+		return this.client.getOrderbook(symbol);
+	}
+	async listInstruments(query) {
+		return this.client.listInstruments(query);
+	}
+	async getFundamentals(symbol) {
+		return this.client.getFundamentals(symbol);
+	}
+	subscribeTicker(symbol, cb, options) {
+		const ms = Math.max(options?.intervalMs ?? SUBSCRIBE_DEFAULT_MS, SUBSCRIBE_MIN_MS);
+		const tick = () => {
+			this.getTicker(symbol).then(cb, () => {});
+		};
+		tick();
+		const timer = setInterval(tick, ms);
+		return { dispose: () => clearInterval(timer) };
+	}
+};
+/** 路由闸门：选中的 provider 不是本连接器时让位（老部署无路由则放行）。 */
+function routeAllows(ctx, config, market = "cn") {
+	if (!config.enabled) return false;
+	const router = ctx.get?.("tradingMarketRouter", false);
+	if (router === void 0) return true;
+	return router.activeProvider(market) === ROUTER_PROVIDER;
+}
+function apply(ctx, config) {
+	if (!config.enabled) return;
+	if (!routeAllows(ctx, config, "cn")) return;
+	const options = {};
+	if (config.apiUrl !== void 0) options.apiUrl = config.apiUrl;
+	if (config.timeoutMs !== void 0) options.timeoutMs = config.timeoutMs;
+	const marketData = new XyszMarketDataService(ctx, options);
+	ctx.inject(["tools"], (ctx) => {
+		const tools = ctx.tools;
+		const register = (t) => {
+			if (tools.get(t.name) === void 0) tools.register(t);
+		};
+		register(defineTool({
+			name: "cn_get_ticker",
+			description: "Get the latest Level-1 quote for an A-share stock from 中国银河证券星耀数智 (AmazingData). Symbol accepts the canonical A-share form (600519.SH) or a bare 6-digit code (600519). Returns last price, previous close, change percent and bid/ask-1 from the authoritative exchange feed.",
+			parameters: { symbol: {
+				type: "string",
+				required: true,
+				description: "A-share symbol, e.g. 600519.SH (or 600519)"
+			} },
+			output: {
+				schema: { type: "string" },
+				render: (_a, v) => [{
+					type: "text",
+					text: v
+				}]
+			},
+			async execute(args) {
+				return JSON.stringify(await marketData.getTicker(args.symbol));
+			}
+		}));
+		register(defineTool({
+			name: "cn_get_klines",
+			description: "Get historical K-lines for A-share stocks from 中国银河证券星耀数智 (AmazingData). Intervals: " + INTERVAL_VOCABULARY.join("/") + " (dsh-trading vocabulary; upstream serves the full A-share history since 2013). Returns up to limit most recent candles in ascending time order.",
+			parameters: {
+				symbol: {
+					type: "string",
+					required: true,
+					description: "A-share symbol, e.g. 600519.SH (or 600519)"
+				},
+				interval: {
+					type: "string",
+					enum: [...INTERVAL_VOCABULARY],
+					default: "1d",
+					description: "K-line interval"
+				},
+				limit: {
+					type: "integer",
+					default: 100,
+					description: "Number of most recent candles (ascending)"
+				}
+			},
+			output: {
+				schema: { type: "string" },
+				render: (_a, v) => [{
+					type: "text",
+					text: v
+				}]
+			},
+			async execute(args) {
+				const klines = await marketData.getKlines(args.symbol, args.interval ?? "1d", args.limit ?? 100);
+				return JSON.stringify(klines);
+			}
+		}));
+		register(defineTool({
+			name: "cn_get_orderbook",
+			description: "Get the 5-level order book (bid/ask prices and sizes) for an A-share stock from 中国银河证券星耀数智 (AmazingData). Derived from the latest exchange Level-1 snapshot row of the current trading day.",
+			parameters: { symbol: {
+				type: "string",
+				required: true,
+				description: "A-share symbol, e.g. 600519.SH (or 600519)"
+			} },
+			output: {
+				schema: { type: "string" },
+				render: (_a, v) => [{
+					type: "text",
+					text: v
+				}]
+			},
+			async execute(args) {
+				return JSON.stringify(await marketData.getOrderbook(args.symbol));
+			}
+		}));
+		register(defineTool({
+			name: "cn_list_instruments",
+			description: "List the A-share instrument universe (Shanghai/Shenzhen/Beijing, about 5500 symbols with Chinese short names) from 中国银河证券星耀数智 (AmazingData). Optional query filters by code or name substring.",
+			parameters: { query: {
+				type: "string",
+				description: "Optional code or name filter, e.g. 茅台 or 6005"
+			} },
+			output: {
+				schema: { type: "string" },
+				render: (_a, v) => [{
+					type: "text",
+					text: v
+				}]
+			},
+			async execute(args) {
+				return JSON.stringify(await marketData.listInstruments(args.query));
+			}
+		}));
+		register(defineTool({
+			name: "cn_get_fundamentals",
+			description: "Get an A-share fundamental snapshot from 中国银河证券星耀数智 (AmazingData): company short name, listing board/date and the 52-week high/low derived from weekly K-lines.",
+			parameters: { symbol: {
+				type: "string",
+				required: true,
+				description: "A-share symbol, e.g. 600519.SH (or 600519)"
+			} },
+			output: {
+				schema: { type: "string" },
+				render: (_a, v) => [{
+					type: "text",
+					text: v
+				}]
+			},
+			async execute(args) {
+				return JSON.stringify(await marketData.getFundamentals(args.symbol));
+			}
+		}));
+	});
+}
+//#endregion
+export { Config, INTERVAL_VOCABULARY, ROUTER_PROVIDER, TRADING_CN_MARKET_DATA_KEY, TradingServiceError, XyszMarketDataService, XyszRestClient, apply, assertSupportedInterval, inject, name, routeAllows, toXyszSymbol };

package/lib/rest.d.ts

@@ -0,0 +1,45 @@
+import { Interval as Interval$1, Kline as Kline$1, Orderbook as Orderbook$1, StockFundamentals as StockFundamentals$1, Ticker as Ticker$1, TradingErrorCode } from "@dshtrading/api";
+//#region src/rest.d.ts
+declare class TradingServiceError extends Error {
+  readonly code: TradingErrorCode;
+  constructor(code: TradingErrorCode, message: string, cause?: unknown);
+}
+/** dsh-trading 规范 interval 词汇（星耀数智上游覆盖 A 股全部周期）。 */
+declare const INTERVAL_VOCABULARY: readonly ["1m", "3m", "5m", "15m", "30m", "1h", "2h", "1d", "1w", "1M"];
+/** 星耀数智上游支持的周期（与 xysz-api 的 _INTERVAL_TO_PERIOD 一一对应）。 */
+declare function assertSupportedInterval(interval: Interval$1): void;
+interface XyszSymbol {
+  /** A 股规范形（docs/symbol-vocabulary.md：NNNNNN.SH / NNNNNN.SZ / NNNNNN.BJ）。 */
+  readonly canonical: string;
+  readonly code: string;
+  readonly exchange: 'SH' | 'SZ' | 'BJ';
+}
+/**
+ * A 股符号归一：接受规范形 600519.SH、裸 6 位 600519、带市场前缀形
+ * sh600519 / 600519.sh；港股、加密等跨市场形态显式拒绝（fail-closed）。
+ */
+declare function toXyszSymbol(symbol: string): XyszSymbol;
+interface XyszRestOptions {
+  /** 星耀数智 FastAPI 封装服务基址（缺省读 XYSZ_API_URL，再缺省回本机隧道端口）。 */
+  apiUrl?: string;
+  fetchImpl?: typeof fetch;
+  /** 单次请求超时（ms）。 */
+  timeoutMs?: number;
+}
+declare class XyszRestClient {
+  readonly apiUrl: string;
+  private readonly fetchImpl;
+  private readonly timeoutMs;
+  constructor(options?: XyszRestOptions);
+  private requestJson;
+  getTicker(symbol: string): Promise<Ticker$1>;
+  getKlines(symbol: string, interval?: Interval$1, limit?: number): Promise<Kline$1[]>;
+  getOrderbook(symbol: string): Promise<Orderbook$1>;
+  listInstruments(query?: string): Promise<Array<{
+    symbol: string;
+    name?: string;
+  }>>;
+  getFundamentals(symbol: string): Promise<StockFundamentals$1>;
+}
+//#endregion
+export { INTERVAL_VOCABULARY, type Interval$1 as Interval, type Kline$1 as Kline, type Orderbook$1 as Orderbook, type StockFundamentals$1 as StockFundamentals, type Ticker$1 as Ticker, TradingServiceError, XyszRestClient, XyszRestOptions, XyszSymbol, assertSupportedInterval, toXyszSymbol };

package/lib/rest.js

@@ -0,0 +1,190 @@
+//#region src/rest.ts
+var TradingServiceError = class extends Error {
+	code;
+	constructor(code, message, cause) {
+		super(message);
+		this.name = "TradingServiceError";
+		this.code = code;
+		if (cause !== void 0) this.cause = cause;
+	}
+};
+/** dsh-trading 规范 interval 词汇（星耀数智上游覆盖 A 股全部周期）。 */
+const INTERVAL_VOCABULARY = [
+	"1m",
+	"3m",
+	"5m",
+	"15m",
+	"30m",
+	"1h",
+	"2h",
+	"1d",
+	"1w",
+	"1M"
+];
+/** 星耀数智上游支持的周期（与 xysz-api 的 _INTERVAL_TO_PERIOD 一一对应）。 */
+function assertSupportedInterval(interval) {
+	if (!INTERVAL_VOCABULARY.includes(interval)) throw new TradingServiceError("TRADING_UNSUPPORTED_INTERVAL", "Xysz upstream does not serve interval \"" + interval + "\"; supported: " + INTERVAL_VOCABULARY.join(", "));
+}
+const EXCHANGE_BY_PREFIX = [
+	[/^(6|9)/, "SH"],
+	[/^(0|2|3)/, "SZ"],
+	[/^(4|8)/, "BJ"]
+];
+/**
+* A 股符号归一：接受规范形 600519.SH、裸 6 位 600519、带市场前缀形
+* sh600519 / 600519.sh；港股、加密等跨市场形态显式拒绝（fail-closed）。
+*/
+function toXyszSymbol(symbol) {
+	const clean = symbol.trim().toUpperCase();
+	if (clean === "") throw new TradingServiceError("TRADING_UNSUPPORTED_SYMBOL", "Xysz: empty symbol");
+	if (/\.HK$/.test(clean) || /^HK\.?\d/.test(clean) || /(USDT|BTC|ETH)$/.test(clean)) throw new TradingServiceError("TRADING_UNSUPPORTED_SYMBOL", "Xysz cn: " + JSON.stringify(symbol) + " is not an A-share symbol (this connector serves cn/A-share only)");
+	const dotted = /^(\d{6})\.(SH|SZ|BJ)$/.exec(clean);
+	if (dotted) {
+		const code = dotted[1];
+		const exchange = dotted[2];
+		return {
+			canonical: code + "." + exchange,
+			code,
+			exchange
+		};
+	}
+	const bare = /^(\d{6})$/.exec(clean);
+	if (bare) {
+		const code = bare[1];
+		const matched = EXCHANGE_BY_PREFIX.find(([re]) => re.test(code));
+		const exchange = matched !== void 0 ? matched[1] : "SZ";
+		return {
+			canonical: code + "." + exchange,
+			code,
+			exchange
+		};
+	}
+	const prefixed = /^(SH|SZ|BJ)\.?(\d{6})$/.exec(clean);
+	if (prefixed) {
+		const code = prefixed[2];
+		const exchange = prefixed[1];
+		return {
+			canonical: code + "." + exchange,
+			code,
+			exchange
+		};
+	}
+	throw new TradingServiceError("TRADING_UNSUPPORTED_SYMBOL", "Xysz cn: malformed A-share symbol " + JSON.stringify(symbol) + " — expected NNNNNN.SH / NNNNNN.SZ / NNNNNN.BJ, a bare 6-digit code, or sh600519");
+}
+var XyszRestClient = class {
+	apiUrl;
+	fetchImpl;
+	timeoutMs;
+	constructor(options = {}) {
+		this.apiUrl = (options.apiUrl ?? process.env.XYSZ_API_URL ?? "http://127.0.0.1:8191").replace(/\/+$/, "");
+		this.fetchImpl = options.fetchImpl ?? globalThis.fetch;
+		this.timeoutMs = options.timeoutMs ?? 6e4;
+	}
+	async requestJson(path, params = {}) {
+		const search = new URLSearchParams();
+		for (const [key, value] of Object.entries(params)) if (value !== void 0) search.set(key, String(value));
+		const url = this.apiUrl + path + (search.size > 0 ? "?" + search.toString() : "");
+		let res;
+		try {
+			res = await this.fetchImpl(url, { signal: AbortSignal.timeout(this.timeoutMs) });
+		} catch (err) {
+			throw new TradingServiceError("TRADING_NETWORK", "Xysz upstream unreachable at " + this.apiUrl + ": " + (err instanceof Error ? err.message : String(err)), err);
+		}
+		if (!res.ok) {
+			const detail = (await res.text().catch(() => "")).slice(0, 400);
+			if (res.status === 400) throw new TradingServiceError("TRADING_UNSUPPORTED_SYMBOL", "Xysz upstream rejected the request: " + detail);
+			throw new TradingServiceError("TRADING_UPSTREAM_ERROR", "Xysz upstream HTTP " + res.status + " for " + path + ": " + detail);
+		}
+		try {
+			return await res.json();
+		} catch (err) {
+			throw new TradingServiceError("TRADING_EXCHANGE_ERROR", "Xysz upstream returned non-JSON for " + path, err);
+		}
+	}
+	async getTicker(symbol) {
+		const { canonical } = toXyszSymbol(symbol);
+		const data = await this.requestJson("/api/v1/ticker", { symbol: canonical });
+		const price = typeof data.price === "number" && Number.isFinite(data.price) ? data.price : 0;
+		const optional = {};
+		for (const [src, dst] of [
+			["volume", "volume"],
+			["prevClose", "prevClose"],
+			["changePercent", "changePercent"],
+			["bid", "bid"],
+			["ask", "ask"]
+		]) {
+			const value = data[src];
+			if (typeof value === "number" && Number.isFinite(value)) optional[dst] = value;
+		}
+		return {
+			symbol: canonical,
+			price,
+			timestamp: typeof data.timestamp === "number" ? data.timestamp : Date.now(),
+			...optional
+		};
+	}
+	async getKlines(symbol, interval = "1d", limit = 100) {
+		assertSupportedInterval(interval);
+		const { canonical } = toXyszSymbol(symbol);
+		const data = await this.requestJson("/api/v1/klines", {
+			symbol: canonical,
+			interval,
+			limit
+		});
+		const rows = Array.isArray(data.klines) ? data.klines : [];
+		const klines = [];
+		for (const row of rows) {
+			if (typeof row.openTime !== "number" || typeof row.open !== "number" || typeof row.high !== "number" || typeof row.low !== "number" || typeof row.close !== "number") continue;
+			klines.push({
+				openTime: row.openTime,
+				open: row.open,
+				high: row.high,
+				low: row.low,
+				close: row.close,
+				volume: typeof row.volume === "number" ? row.volume : 0,
+				closeTime: row.openTime
+			});
+		}
+		return klines;
+	}
+	async getOrderbook(symbol) {
+		const { canonical } = toXyszSymbol(symbol);
+		const data = await this.requestJson("/api/v1/orderbook", { symbol: canonical });
+		const levels = (rows) => (rows ?? []).filter((r) => typeof r.price === "number" && r.price > 0).map((r) => ({
+			price: r.price,
+			amount: typeof r.amount === "number" ? r.amount : 0
+		}));
+		return {
+			symbol: canonical,
+			bids: levels(data.bids),
+			asks: levels(data.asks),
+			timestamp: typeof data.timestamp === "number" ? data.timestamp : Date.now()
+		};
+	}
+	async listInstruments(query) {
+		const data = await this.requestJson("/api/v1/instruments", {
+			security_type: "EXTRA_STOCK_A",
+			with_names: true
+		});
+		const items = Array.isArray(data.items) ? data.items : [];
+		if (query === void 0 || query.trim() === "") return items;
+		const needle = query.trim().toUpperCase();
+		return items.filter((it) => it.symbol.toUpperCase().includes(needle) || (it.name ?? "").toUpperCase().includes(needle));
+	}
+	async getFundamentals(symbol) {
+		const { canonical } = toXyszSymbol(symbol);
+		const data = await this.requestJson("/api/v1/fundamentals", { symbol: canonical });
+		const name = typeof data.name === "string" && data.name !== "" ? data.name : void 0;
+		const high = typeof data.fiftyTwoWeekHigh === "number" ? data.fiftyTwoWeekHigh : void 0;
+		const low = typeof data.fiftyTwoWeekLow === "number" ? data.fiftyTwoWeekLow : void 0;
+		return {
+			symbol: canonical,
+			timestamp: typeof data.timestamp === "number" ? data.timestamp : Date.now(),
+			...name !== void 0 ? { name } : {},
+			...high !== void 0 ? { fiftyTwoWeekHigh: high } : {},
+			...low !== void 0 ? { fiftyTwoWeekLow: low } : {}
+		};
+	}
+};
+//#endregion
+export { INTERVAL_VOCABULARY, TradingServiceError, XyszRestClient, assertSupportedInterval, toXyszSymbol };

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@dshtrading/connector-xysz",
+  "description": "中国银河证券星耀数智（AmazingData / tgw）A 股数据源连接器（数据面-only）：经本机/局域网的 FastAPI 封装服务 xysz-api 提供 tradingCnMarketData 与 cn_* 行情工具，无交易通道",
+  "version": "0.5.0",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./dataplane": {
+      "types": "./lib/dataplane.d.ts",
+      "default": "./lib/dataplane.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib"
+  ],
+  "license": "PolyForm-Noncommercial-1.0.0",
+  "dependencies": {
+    "@dshtrading/api": "^0.5.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.0",
+    "@deepseek-ai/dsh-tools": ">=0.2.0-rc.2",
+    "@deepseek-ai/schemastery": ">=3.18.0"
+  },
+  "devDependencies": {
+    "tsdown": "^0.22.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run"
+  }
+}