@dshtrading/connector-akshare 0.6.0 → 0.6.2

package/README.md

@@ -1,34 +1,131 @@
-# @dshtrading/connector-template
+# @dshtrading/connector-akshare
 
-**本包是脚手架源，不是可安装的连接器**：不入任何 bundle 依赖，仅在 `pnpm -r build/test`
-基线内保证可编译、冒烟测试绿。真实接入用生成器：
+A 股行情连接器：包名取 AkShare，**实现面是东方财富公开 REST 直连**（`push2` / `push2his` 两域）。
+只提供 `tradingCnMarketData` 一个服务与 3 个 `cn_*` 工具，无交易通道（`src/index.ts` 无 TradeService、
+无 `tradingCnTrade`）。配置只有 `enabled`；本包不连任何 AkShare / Python 本地服务，也没有需要填的凭证。
 
-```sh
-node scripts/new-connector.mjs --slug bybit --title Bybit --market crypto
-```
+## 状态
+
+**未实证（本出口当前不可用）**。
+
+2026-10-14 本次会话实测，上游 push2 域不可达：
+
+    curl -m 15 'https://push2.eastmoney.com/api/qt/ulist.np/get?secids=1.600519&fields=f1,f2,f14'
+    # curl: (52) Empty reply from server
+
+同刻连接器经 `RestClient.getSectorFundFlow()` 表现为 `TradingServiceError`，code `TRADING_NETWORK`
+（`fetch failed`）。该现象与 `packages/connector-eastmoney/README.md`「已知边界」记录的 push2 整域空回一致。
+
+2026-10-15 复测 push2his 同样空回（`kline/get` 各 klt 一律 `curl: (52)`），故本文「周期与契约」里
+补上的 `1w/1M` 映射本次**未做真网络复验**，取值沿用同端点的 connector-eastmoney 映射表。
+
+本仓唯一一份 akshare 真实网络记录是 [spikes/verify-connectors-suite/EVIDENCE.md](../../spikes/verify-connectors-suite/EVIDENCE.md)
+（2026-08-31，针对 commit `b80000e`，import `lib/index.js` 直调各包 Rest 客户端）：
+板块资金流返回 10 条，但当时 `changePercent` 少除 100（现 `src/rest.ts:205` 已除 100）；
+北向资金接口当时恒返回 0 条（该工具与该能力现已从源码移除，当前 `src/` 无 `getNorthboundFlow`）。
+报价与日 K 走同一组东财端点，该组端点的 2026-10-14 实测记录在
+[spikes/impl-eastmoney-quote-endpoint/](../../spikes/impl-eastmoney-quote-endpoint/)（由 `src/rest.ts:144-146` 引用）。
+
+## 配置
+
+| 字段 | 默认 | 说明 |
+|---|---|---|
+| `enabled` | `true` | 是否激活本连接器（`src/index.ts:29-35`） |
+
+## 接线
+
+- **数据面行**：`packages/cn/cordis.patch.yml:35-38` → 行 id `dsh-trading-cn-dataplane-akshare`
+  （name `@dshtrading/connector-akshare/dataplane`，行 config 只写 `enabled: true`）。
+  注册 `(cn, akshare)` 进 `tradingMarketDataRegistry`（`src/dataplane.ts:36`），不占根市场键。
+- **preset 行**：`packages/cn/assets/preset/cn-trader/agent.cordis.yml:62-67` → 行 id
+  `dsh-trading-cn-connector-akshare`（`config: {enabled: true, dryRun: true, liveTrading: false}`）。
+- **bundle 依赖**：`packages/cn/package.json:31` 的 `"@dshtrading/connector-akshare": "workspace:*"`。
+- **provider 词汇**：`packages/router/src/index.ts:77`（`PROVIDER_VOCABULARY` 成员）与
+  `src/index.ts:74` 的 `ROUTER_PROVIDER = 'akshare'` 同名。
+- **服务键**：`tradingCnMarketData`（`src/index.ts:37`；dataplane 侧 isolate 同名，`src/dataplane.ts:34`）。
+- **激活判定**：`routeAllows`（`src/index.ts:76-81`）——`enabled` 为真、且 router 的 `cn` 路由选中
+  `akshare` 才 provide；router 缺席时视为允许。
+- **设置页登记**：显示名 `packages/client-ui-settings/src/client/locales.ts` 的 `'provider.akshare'` 条目
+  （zh `AkShare (东方财富公开端点)` / en `AkShare (Eastmoney public endpoints)`）；
+  候选行 `packages/client-ui-settings/src/client/trading-settings-controller.ts:60` 只标
+  `markets: ['cn']`（= 本包 dataplane 的真实注册面），**无 `env`、无 `configField`、无凭据字段**——
+  本包没有本地服务或凭证可填。
 
-生成后按 [docs/guides/connector-playbook.md](../../docs/guides/connector-playbook.md) 的填写顺序
-（src/rest.ts 头部清单 7 项）实现 TODO。每个 TODO 的参照段都在 connector-okx
-（packages/connector-okx/），它是本仓第一个真实 TradeService 连接器。
+## 上游端点
 
-## 结构
+| 用途 | 端点 | 源码 |
+|---|---|---|
+| 报价（单只与批量同端点） | `https://push2.eastmoney.com/api/qt/ulist.np/get?secids=<secid>&fields=f1,f2,f3,f5,f12,f13,f14,f18,f124` | `src/rest.ts:81,147` |
+| K 线 | `https://push2his.eastmoney.com/api/qt/stock/kline/get?secid=<secid>&klt=<klt>&fqt=1&lmt=<limit>&fields2=f51,f52,f53,f54,f55,f56` | `src/rest.ts:180` |
+| 板块资金流（东财行业板块 `fs=m:90+t:2`，固定取前 10） | `https://push2.eastmoney.com/api/qt/clist/get?pn=1&pz=10&po=1&np=1&fields=f12,f14,f3,f62&fs=m:90+t:2` | `src/rest.ts:200` |
 
-- `src/rest.ts` —— 错误载体（TradingServiceError）+ 通用请求管线（超时/错误映射/
-  模拟盘头/注入 fetch）直接可用；签名与端点 TODO。
-- `src/index.ts` —— Config（enabled/env/dryRun/liveTrading + 三 ref 凭证组）、
-  闸门三态判定、凭证解析（BYOK + 环境变量回落）、MarketDataService/TradeService 骨架、
-  7 个市场前缀工具注册（duplicate-safe）、apply（enabled=false 静默退出）。
-- `test/template.test.ts` —— 结构冒烟 7 用例。
+## 周期与契约
 
-## Token
+- **周期词汇**：`INTERVAL_VOCABULARY = ['1m','5m','15m','30m','1h','1d','1w','1M']`（`src/rest.ts:24`），
+  同一数组进 `cn_get_klines` 的 `interval` 枚举（`src/index.ts:110`）。
+- **真实可服务子集**：`SUPPORTED_KLINES_INTERVALS = ['5m','15m','30m','1h','1d','1w','1M']`（`src/rest.ts:44`，
+  由 `KLINES_INTERVAL_SPEC` 的键导出，`src/rest.ts:33-41`）；工具描述里如实标注该子集（`src/index.ts:114`）。
+- **klt 映射与拒绝**：`5m→5`、`15m→15`、`30m→30`、`1h→60`、`1d→101`、`1w→102`、`1M→103`；
+  表外周期（含 `1m`）在**发请求前**由 `resolveKlinesInterval` 抛 `TRADING_UNSUPPORTED_INTERVAL`
+  （`src/rest.ts:51-60`），不静默按日线返回。`1m` 被拒是因为 `kline/get` 的 `klt=1` 只回当日、
+  `lmt` 被上游忽略（connector-eastmoney 实测），本包没有 trends2 分时通道。
+- **`closeTime` 按周期**：`closeTime = openTime + stepMs - 1`（`src/rest.ts:194`），
+  stepMs 与 klt 同表（1d/1w/1M = 24h/7d/30d）——周/月 K 跨度 ≥ 2 天，`packages/indicators` 的
+  `klineTradingDay` 才会按周期末对齐；旧的一律 `+86400000-1` 会把周 K 当单日 K。
+- **符号形态**（`toEastmoneySecid`，`src/rest.ts:62-75`）：含 `.` 时 `.<市场>` 原样取（`600519.SH`）；
+  裸 6 位不以 `0`/`3` 开头视为 `SH`、以 `0`/`3` 开头视为 `SZ`；输出规范形 `<code>.<MARKET>`，
+  东财 `secid` = `<SH→1，其余→0>.<code>`。不接受 `sh600519` 前缀形（会拼成 `1.SH600519`），
+  也不做市场白名单或显式拒绝。
+- **取价按行**：`price = f2 / 10^f1`；`f1` 缺失或不在 `0..6` 时回落市场级 `×100`（`src/rest.ts:99-108,156-158`）。
+- **错误映射**（`src/rest.ts:123-140,153`）：非 2xx → `TRADING_UPSTREAM_ERROR`；
+  不可达与响应非 JSON 均 → `TRADING_NETWORK`；报价端点少返回行（`data.diff` 空或 `data` 为 `null`）
+  → `TRADING_SYMBOL_NOT_FOUND`；周期表外 → `TRADING_UNSUPPORTED_INTERVAL`（本地判定，不出网）；
+  `getSectorFundFlow` 对空结果返回 `[]`，不报错。
 
-`akshare`（slug）/ `Akshare`（title）/ `AKSHARE`（ref 前缀）/
-`crypto`（工具前缀）/ `Crypto`（服务键 infix）。token 未展开也可编译；
-生成器保证全部替换。
+## 能力面
 
-## 注意（勿改的坑）
+| 服务方法 | 本包实现 | 工具暴露 |
+|---|---|---|
+| `getTicker` | 有（`src/index.ts:51`） | `cn_get_ticker`（`src/index.ts:96`） |
+| `getKlines` | 有（`src/index.ts:55`） | `cn_get_klines`（`src/index.ts:106`） |
+| `getSectorFundFlow` | 有（`src/index.ts:59`） | `cn_get_sector_fund_flow`（`src/index.ts:126`） |
+| `subscribeTicker`（快照轮询，最小 1000 ms、默认 5000 ms） | 有（`src/index.ts:63-71`） | 缺席 |
+| `listInstruments` / 盘口 / 基本面 / 宏观与另类数据 | 未实现 | 未实现 |
+| TradeService（下单 / 撤单 / 持仓 / 资金） | 未实现（本包无 `tradingCnTrade`） | 未实现 |
+
+## 已知边界
+
+- **`openTime` 按本地时区解析**：`new Date(parts[0].replace(/-/g, '/'))`（`src/rest.ts:186`）。
+- **`1m` 无实现路径**：见「周期与契约」——上层按 `TRADING_UNSUPPORTED_INTERVAL` 自适应更粗粒度
+  （`packages/client-ui-trading/src/client/intraday-series.ts`）。
+- **`1w/1M`（klt 102/103）未真网络复验**：2026-10-15 push2his 空回，映射取自同端点的
+  connector-eastmoney。
+- 板块资金流固定 `pz=10`（只回前 10 个板块，`src/rest.ts:200`）；`changePercent` 由 `f3/100` 得到
+  （`src/rest.ts:205`），`mainNetInflow` 直接取 `f62`，单位未换算（`src/rest.ts:206`）。
+- 无 `listInstruments`、盘口、基本面、主动买盘能力（同市场的 eastmoney、xysz 各有对照实现）。
+- 2026-10-14 起本出口对 `push2.eastmoney.com` 不可达（`curl: (52) Empty reply from server`），
+  故「状态」段按未实证处理；2026-10-15 复测 push2his 同样空回。
+
+## 合规记录
+
+**东方财富公开端点**：无 key、无官方授权，个人使用边界自负，以东方财富服务条款为准。
+本次会话实测该端点不可达。本仓不缓存、不再分发行情数据。
+
+## 出网验证
+
+本包暂无已提交的独立出网验证脚本（`spikes/` 下无 akshare 专属探针；上文引的两份是跨连接器随测与东财端点实测）。
+最小复跑方式（与仓内探针纪律一致：`tsx` 直跑 `src/*.ts`，不依赖 `lib/` 构建产物）：
+
+```sh
+# 板块资金流（单次请求；上游空结果返回 []，不报错）
+./node_modules/.bin/tsx -e "import('./packages/connector-akshare/src/rest.ts').then(async m => console.log(JSON.stringify(await new m.AkshareRestClient().getSectorFundFlow())))"
+
+# 报价（走 push2 ulist.np/get，单只）
+./node_modules/.bin/tsx -e "import('./packages/connector-akshare/src/rest.ts').then(async m => console.log(JSON.stringify(await new m.AkshareRestClient().getTicker('600519.SH'))))"
+
+# 周期映射（不出网）：1w 应得 klt=102；1m 应抛 TRADING_UNSUPPORTED_INTERVAL
+./node_modules/.bin/tsx -e "import('./packages/connector-akshare/src/rest.ts').then(m => { console.log(m.resolveKlinesInterval('1w')); try { m.resolveKlinesInterval('1m') } catch (e) { console.log(e.code) } })"
+```
 
-- 服务类用 TS 编译期 `private`（禁 ECMAScript `#`，realm 代理会炸）。
-- 工具名 = 市场前缀 + 语义词（不带交易所名）——base 闸门正则只认市场前缀。
-- 行 id = `dsh-trading-<market>-connector-<slug>`，全仓唯一（insert-only 铁律 #1）。
-- 凭证只进 ref，绝不内置/落日志（铁律 #3/#5）。
+2026-10-14 本次会话下，第一条落在 `TRADING_NETWORK: fetch failed`；2026-10-15 复测 push2his 空回，
+第二、三条未取得上游响应（第三条不出网，本地可判）。

package/lib/dataplane.d.ts

@@ -2,6 +2,6 @@ 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: Config): void;
+declare function apply(ctx: Context, config?: Config): void;
 //#endregion
-export { apply, inject };
+export { Config, apply, inject };

package/lib/dataplane.js

@@ -1,22 +1,23 @@
-import { AkshareMarketDataService, TRADING_CN_MARKET_DATA_KEY } from "./index.js";
+import { AkshareMarketDataService, Config, ROUTER_PROVIDER, TRADING_CN_MARKET_DATA_KEY } from "./index.js";
 //#region src/dataplane.ts
 const inject = [];
+/** schema 的运行时可调用形态（校验即补默认值）；手工构造 ctx 不传 config 时按 schema 默认值处理。 */
+const withDefaults = (value) => Config(value);
 function resolveMarketDataRegistry(ctx) {
 	const candidate = ctx.get?.("tradingMarketDataRegistry", false);
 	return candidate !== void 0 ? candidate : void 0;
 }
-const ROUTER_PROVIDER = "akshare";
 const MARKET = "cn";
-function apply(ctx, config) {
+function apply(ctx, config = withDefaults(void 0)) {
 	if (!config.enabled) return;
 	const registry = resolveMarketDataRegistry(ctx);
 	if (registry === void 0) {
-		new AkshareMarketDataService(ctx, { apiUrl: config.apiUrl });
+		new AkshareMarketDataService(ctx);
 		return;
 	}
 	const inner = ctx.isolate(TRADING_CN_MARKET_DATA_KEY);
-	const service = new AkshareMarketDataService(inner, { apiUrl: config.apiUrl });
+	const service = new AkshareMarketDataService(inner);
 	ctx.effect(() => registry.register(MARKET, ROUTER_PROVIDER, service));
 }
 //#endregion
-export { apply, inject };
+export { Config, apply, inject };

package/lib/index.d.ts

@@ -1,4 +1,4 @@
-import { AkshareRestClient, AkshareRestOptions, INTERVAL_VOCABULARY, Interval, Kline, Ticker, TradingServiceError, toEastmoneySecid } from "./rest.js";
+import { AkshareRestClient, AkshareRestOptions, INTERVAL_VOCABULARY, Interval, Kline, SUPPORTED_KLINES_INTERVALS, Ticker, TradingServiceError, resolveKlinesInterval, toEastmoneySecid } 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, Ticker as Ticker$1 } from "@dshtrading/api";
@@ -6,7 +6,6 @@ import { Disposable, Interval as Interval$1, Kline as Kline$1, MarketDataService
 declare const name = "dsh-trading-cn-connector-akshare";
 interface Config {
   enabled: boolean;
-  apiUrl?: string;
 }
 declare const Config: Schema<Config>;
 declare const TRADING_CN_MARKET_DATA_KEY = "tradingCnMarketData";
@@ -28,4 +27,4 @@ declare const ROUTER_PROVIDER = "akshare";
 declare function routeAllows(ctx: Context, config: Config, market: string): boolean;
 declare function apply(ctx: Context, config: Config): void;
 //#endregion
-export { AkshareMarketDataService, AkshareRestClient, AkshareRestOptions, Config, INTERVAL_VOCABULARY, type Interval, type Kline, ROUTER_PROVIDER, TRADING_CN_MARKET_DATA_KEY, type Ticker, TradingServiceError, apply, name, routeAllows, toEastmoneySecid };
+export { AkshareMarketDataService, AkshareRestClient, AkshareRestOptions, Config, INTERVAL_VOCABULARY, type Interval, type Kline, ROUTER_PROVIDER, SUPPORTED_KLINES_INTERVALS, TRADING_CN_MARKET_DATA_KEY, type Ticker, TradingServiceError, apply, name, resolveKlinesInterval, routeAllows, toEastmoneySecid };

package/lib/index.js

@@ -1,13 +1,10 @@
-import { AkshareRestClient, INTERVAL_VOCABULARY, TradingServiceError, toEastmoneySecid } from "./rest.js";
+import { AkshareRestClient, INTERVAL_VOCABULARY, SUPPORTED_KLINES_INTERVALS, TradingServiceError, resolveKlinesInterval, toEastmoneySecid } 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
 const name = "dsh-trading-cn-connector-akshare";
-const Config = Schema.object({
-	enabled: Schema.boolean().default(true).description("是否激活 AkShare 连接器"),
-	apiUrl: Schema.string().default("http://127.0.0.1:8080").description("AkShare 本地 RPC/HTTP 服务地址")
-});
+const Config = Schema.object({ enabled: Schema.boolean().default(true).description("是否激活 AkShare 连接器") });
 const TRADING_CN_MARKET_DATA_KEY = "tradingCnMarketData";
 var AkshareMarketDataService = class extends Service {
 	client;
@@ -44,7 +41,7 @@ function routeAllows(ctx, config, market) {
 function apply(ctx, config) {
 	if (!config.enabled) return;
 	if (!routeAllows(ctx, config, "cn")) return;
-	const marketData = new AkshareMarketDataService(ctx, { apiUrl: config.apiUrl });
+	const marketData = new AkshareMarketDataService(ctx);
 	ctx.inject(["tools"], (ctx) => {
 		const tools = ctx.tools;
 		const register = (t) => {
@@ -82,7 +79,7 @@ function apply(ctx, config) {
 					type: "string",
 					enum: INTERVAL_VOCABULARY,
 					default: "1d",
-					description: "Interval"
+					description: `Interval (Eastmoney kline/get serves ${SUPPORTED_KLINES_INTERVALS.join("/")}; 1m and other values are rejected with TRADING_UNSUPPORTED_INTERVAL)`
 				},
 				limit: {
 					type: "integer",
@@ -121,4 +118,4 @@ function apply(ctx, config) {
 	});
 }
 //#endregion
-export { AkshareMarketDataService, AkshareRestClient, Config, INTERVAL_VOCABULARY, ROUTER_PROVIDER, TRADING_CN_MARKET_DATA_KEY, TradingServiceError, apply, name, routeAllows, toEastmoneySecid };
+export { AkshareMarketDataService, AkshareRestClient, Config, INTERVAL_VOCABULARY, ROUTER_PROVIDER, SUPPORTED_KLINES_INTERVALS, TRADING_CN_MARKET_DATA_KEY, TradingServiceError, apply, name, resolveKlinesInterval, routeAllows, toEastmoneySecid };

package/lib/rest.d.ts

@@ -5,16 +5,25 @@ declare class TradingServiceError extends Error {
   constructor(code: TradingErrorCode, message: string, cause?: unknown);
 }
 declare const INTERVAL_VOCABULARY: readonly ["1m", "5m", "15m", "30m", "1h", "1d", "1w", "1M"];
+/** 本包 K 线真实可服务的周期（`INTERVAL_VOCABULARY` 的严格子集：1m 不在其中）。 */
+declare const SUPPORTED_KLINES_INTERVALS: readonly string[];
+/**
+ * 周期 → klt 与时长；映射表外的周期在发请求前显式拒绝（`TRADING_UNSUPPORTED_INTERVAL`），
+ * 不静默按日线返回。`1m` 也在拒绝之列：kline/get 的 klt=1 只回当日（`lmt` 被上游忽略，
+ * connector-eastmoney/src/rest.ts 实测），本包没有 trends2 分时通道，取不到多日 1m 序列。
+ */
+declare function resolveKlinesInterval(interval: Interval$1): {
+  readonly klt: string;
+  readonly stepMs: number;
+};
 declare function toEastmoneySecid(symbol: string): {
   secid: string;
   canonical: string;
 };
 interface AkshareRestOptions {
-  apiUrl?: string;
   fetchImpl?: typeof fetch;
 }
 declare class AkshareRestClient {
-  readonly apiUrl: string;
   private readonly fetchImpl;
   constructor(options?: AkshareRestOptions);
   private requestJson;
@@ -27,4 +36,4 @@ declare class AkshareRestClient {
   }>>;
 }
 //#endregion
-export { AkshareRestClient, AkshareRestOptions, INTERVAL_VOCABULARY, type Interval$1 as Interval, type Kline$1 as Kline, type Ticker$1 as Ticker, TradingServiceError, toEastmoneySecid };
+export { AkshareRestClient, AkshareRestOptions, INTERVAL_VOCABULARY, type Interval$1 as Interval, type Kline$1 as Kline, SUPPORTED_KLINES_INTERVALS, type Ticker$1 as Ticker, TradingServiceError, resolveKlinesInterval, toEastmoneySecid };

package/lib/rest.js

@@ -18,6 +18,55 @@ const INTERVAL_VOCABULARY = [
 	"1w",
 	"1M"
 ];
+/**
+* K 线周期 → 东财 kline/get 的 klt 周期码 + 单根时长。
+*
+* klt 与同打 push2his kline/get 的 connector-eastmoney 同一张表（该包 `mapIntervalToKlt`）；
+* stepMs 是 K 线覆盖时长，用于 closeTime = openTime + stepMs - 1——分钟线不再按日线加满一天，
+* 周/月线也必须长于 2 天，否则 packages/indicators 的 klineTradingDay 会把周 K 当成单日 K。
+*/
+const KLINES_INTERVAL_SPEC = {
+	"5m": {
+		klt: "5",
+		stepMs: 3e5
+	},
+	"15m": {
+		klt: "15",
+		stepMs: 9e5
+	},
+	"30m": {
+		klt: "30",
+		stepMs: 18e5
+	},
+	"1h": {
+		klt: "60",
+		stepMs: 36e5
+	},
+	"1d": {
+		klt: "101",
+		stepMs: 864e5
+	},
+	"1w": {
+		klt: "102",
+		stepMs: 6048e5
+	},
+	"1M": {
+		klt: "103",
+		stepMs: 2592e6
+	}
+};
+/** 本包 K 线真实可服务的周期（`INTERVAL_VOCABULARY` 的严格子集：1m 不在其中）。 */
+const SUPPORTED_KLINES_INTERVALS = Object.keys(KLINES_INTERVAL_SPEC);
+/**
+* 周期 → klt 与时长；映射表外的周期在发请求前显式拒绝（`TRADING_UNSUPPORTED_INTERVAL`），
+* 不静默按日线返回。`1m` 也在拒绝之列：kline/get 的 klt=1 只回当日（`lmt` 被上游忽略，
+* connector-eastmoney/src/rest.ts 实测），本包没有 trends2 分时通道，取不到多日 1m 序列。
+*/
+function resolveKlinesInterval(interval) {
+	const spec = KLINES_INTERVAL_SPEC[interval];
+	if (spec === void 0) throw new TradingServiceError("TRADING_UNSUPPORTED_INTERVAL", `AkShare/Eastmoney klines do not serve interval "${String(interval)}"; supported: ${SUPPORTED_KLINES_INTERVALS.join(", ")}`);
+	return spec;
+}
 function toEastmoneySecid(symbol) {
 	const clean = symbol.trim().toUpperCase();
 	let code = clean;
@@ -32,11 +81,34 @@ function toEastmoneySecid(symbol) {
 		canonical: `${code}.${market}`
 	};
 }
+/**
+* ulist.np/get 报价行字段：f1=小数位数 f2=最新价 f3=涨跌幅(%) f5=成交量(手) f12=代码
+* f13=市场 f14=名称 f18=昨收 f124=行情时间(秒)。价格类字段是 ×10^f1 的整数。
+*/
+const QUOTE_FIELDS = "f1,f2,f3,f5,f12,f13,f14,f18,f124";
+/** 报价字段 → 有限数；null/空串/停牌占位返回 undefined，由调用方决定兜底值。 */
+function toFiniteNumber(value) {
+	if (typeof value === "number") return Number.isFinite(value) ? value : void 0;
+	if (typeof value === "string" && value.trim() !== "") {
+		const parsed = Number(value);
+		return Number.isFinite(parsed) ? parsed : void 0;
+	}
+}
+/** cn 市场的分精度兜底倍率：×100（2 位小数），只在报价行没给出可用的 f1 时使用。 */
+const CN_PRICE_SCALE = 100;
+/**
+* 报价行的价格除数 = 10^f1（f1 = 上游给该标的声明的小数位数）：A 股股票 f1=2、A 股 ETF
+* f1=3（2026-10-14 实测），故取价一律按行——市场级 ×100 会把 ETF 读成 10 倍。
+* f1 缺失或落在 0..6 之外时回落到市场级常数。
+*/
+function quotePriceScale(decimalDigits) {
+	const digits = toFiniteNumber(decimalDigits);
+	if (digits === void 0 || !Number.isInteger(digits) || digits < 0 || digits > 6) return CN_PRICE_SCALE;
+	return 10 ** digits;
+}
 var AkshareRestClient = class {
-	apiUrl;
 	fetchImpl;
 	constructor(options = {}) {
-		this.apiUrl = options.apiUrl ?? (process.env.AKSHARE_API_URL || "http://127.0.0.1:8080");
 		this.fetchImpl = options.fetchImpl ?? globalThis.fetch;
 	}
 	async requestJson(url) {
@@ -51,24 +123,30 @@ var AkshareRestClient = class {
 	}
 	async getTicker(symbol) {
 		const { secid, canonical } = toEastmoneySecid(symbol);
-		const url = `https://push2.eastmoney.com/api/qt/stock/get?secid=${secid}&fields=f43,f47,f60,f86,f170`;
-		const res = await this.requestJson(url);
-		if (!res.data) throw new TradingServiceError("TRADING_SYMBOL_NOT_FOUND", `AkShare/Eastmoney quote not found: ${symbol}`);
-		const rawPrice = typeof res.data.f43 === "number" ? res.data.f43 / 100 : 0;
-		const prevClose = typeof res.data.f60 === "number" && res.data.f60 > 0 ? res.data.f60 / 100 : void 0;
-		const changePercent = typeof res.data.f170 === "number" && Number.isFinite(res.data.f170) ? res.data.f170 / 100 : void 0;
+		const url = `https://push2.eastmoney.com/api/qt/ulist.np/get?secids=${secid}&fields=${QUOTE_FIELDS}`;
+		const row = (await this.requestJson(url)).data?.diff?.[0];
+		if (row === void 0) throw new TradingServiceError("TRADING_SYMBOL_NOT_FOUND", `AkShare/Eastmoney quote not found: ${symbol}`);
+		const scale = quotePriceScale(row.f1);
+		const rawPrice = toFiniteNumber(row.f2);
+		const price = rawPrice !== void 0 && rawPrice > 0 ? rawPrice / scale : 0;
+		const prevClose = toFiniteNumber(row.f18);
+		const changePercent = toFiniteNumber(row.f3);
+		const quoteTime = toFiniteNumber(row.f124);
+		const name = typeof row.f14 === "string" && row.f14.trim() ? row.f14.trim() : void 0;
 		return {
 			symbol: canonical,
-			price: rawPrice > 0 ? rawPrice : 0,
-			volume: res.data.f47 ?? 0,
-			timestamp: res.data.f86 ? res.data.f86 * 1e3 : Date.now(),
-			...prevClose !== void 0 ? { prevClose } : {},
-			...changePercent !== void 0 ? { changePercent } : {}
+			...name ? { name } : {},
+			price,
+			volume: toFiniteNumber(row.f5) ?? 0,
+			timestamp: quoteTime !== void 0 && quoteTime > 0 ? quoteTime * 1e3 : Date.now(),
+			...prevClose !== void 0 && prevClose > 0 ? { prevClose: prevClose / scale } : {},
+			...changePercent !== void 0 ? { changePercent: changePercent / 100 } : {}
 		};
 	}
 	async getKlines(symbol, interval = "1d", limit = 100) {
+		const { klt, stepMs } = resolveKlinesInterval(interval);
 		const { secid } = toEastmoneySecid(symbol);
-		const url = `https://push2his.eastmoney.com/api/qt/stock/kline/get?secid=${secid}&klt=${interval === "5m" ? "5" : interval === "15m" ? "15" : interval === "30m" ? "30" : interval === "1h" ? "60" : "101"}&fqt=1&lmt=${limit}&fields2=f51,f52,f53,f54,f55,f56`;
+		const url = `https://push2his.eastmoney.com/api/qt/stock/kline/get?secid=${secid}&klt=${klt}&fqt=1&lmt=${limit}&fields2=f51,f52,f53,f54,f55,f56`;
 		const res = await this.requestJson(url);
 		if (!res.data?.klines) return [];
 		return res.data.klines.map((line) => {
@@ -81,7 +159,7 @@ var AkshareRestClient = class {
 				high: parseFloat(parts[3]),
 				low: parseFloat(parts[4]),
 				volume: parseFloat(parts[5]),
-				closeTime: openTime + 864e5 - 1
+				closeTime: openTime + stepMs - 1
 			};
 		});
 	}
@@ -94,4 +172,4 @@ var AkshareRestClient = class {
 	}
 };
 //#endregion
-export { AkshareRestClient, INTERVAL_VOCABULARY, TradingServiceError, toEastmoneySecid };
+export { AkshareRestClient, INTERVAL_VOCABULARY, SUPPORTED_KLINES_INTERVALS, TradingServiceError, resolveKlinesInterval, toEastmoneySecid };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dshtrading/connector-akshare",
-  "description": "【模板】交易所连接器插件脚手架：Akshare（akshare）v2 插件骨架 —— 市场数据服务 + 交易服务 + 三态闸门 + BYOK 凭证 ref。生成器：node scripts/new-connector.mjs --slug <exchange>",
-  "version": "0.6.0",
+  "description": "AkShare 名义的 A 股宏观/另类数据连接器：实现面为东方财富公开 REST 直连（push2/push2his），提供 tradingCnMarketData 行情服务与 cn_get_ticker / cn_get_klines / cn_get_sector_fund_flow 三个工具，无交易通道。",
+  "version": "0.6.2",
   "type": "module",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -21,11 +21,11 @@
   ],
   "license": "PolyForm-Noncommercial-1.0.0",
   "dependencies": {
-    "@dshtrading/api": "^0.6.0"
+    "@dshtrading/api": "^0.6.2"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.0",
-    "@deepseek-ai/dsh-tools": ">=0.2.0-rc.2",
+    "@deepseek-ai/dsh-tools": ">=0.2.1-rc.2",
     "@deepseek-ai/schemastery": ">=3.18.0"
   },
   "devDependencies": {