@dshtrading/connector-tencent 0.5.0 → 0.6.0

package/lib/index.d.ts

@@ -15,7 +15,7 @@ interface Config {
   market: MarketOption;
   /** 交易安全闸门（铁律 #3）：true 时下单类工具强制 dry-run。 */
   dryRun: boolean;
-  /** 实盘总闸门：默认 false；false 时无论 dryRun 与否都拒绝实盘下单 [S4]。 */
+  /** 实盘镜像：默认 false。它是非权威镜像——只能收紧、永不能授予；实盘授权由 @dshtrading/authority 的人工签署平面裁定 [S4]。 */
   liveTrading: boolean;
 }
 declare const Config: Schema<Config>;
@@ -76,7 +76,7 @@ declare function buildDryRunReceipt(market: MarketOption, args: PlaceOrderArgs,
 interface PlaceOrderToolDeps {
   /** 行情服务（dry-run 回执的市价参照），按接口取用，不直连 HTTP。 */
   readonly marketData: Pick<MarketDataService, 'getTicker'>;
-  /** 插件配置（market 分流 + dryRun 强制模拟 / liveTrading 总闸门）。 */
+  /** 插件配置（market 分流 + dryRun 强制模拟 / liveTrading 非权威镜像——实盘授权由 @dshtrading/authority 人工签署平面裁定）。 */
   readonly config: Config;
 }
 /**

package/lib/index.js

@@ -1,9 +1,32 @@
 import { INTERVAL_VOCABULARY, TencentRestClient, TradingServiceError, klineDateToEpochMs, minuteKlineTimeToEpochMs, normalizeCnSymbol, normalizeHkSymbol, normalizeSymbol, parseCnOrderbook, toCanonicalTencentSymbol, wallTimeToEpochMs } from "./rest.js";
+import { liveTradingEnabled } from "@dshtrading/authority";
 import { Service } from "@deepseek-ai/cordis";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import Schema from "@deepseek-ai/schemastery";
 //#region src/index.ts
 /**
+* 腾讯行情连接器插件（dsh-trading cn+hk 双市场切片）：**单包双市场**——这是手册
+* （docs/replication.md §1-§4「一市场一连接器包」）之外的**多实例新模式**：
+*
+*   - 同一个插件包（插件名 `dsh-trading-tencent`，export const name）被挂载两次，
+*     preset 行用**不同行 id**（`dsh-trading-cn-connector` / `dsh-trading-hk-connector`）
+*     指向**同一 bare 包名**（`@dshtrading/connector-tencent`），以 `config.market`
+*     分流 cn/hk（行 id 即命名空间——不同 id 即两个独立实例，互不整行替换）；
+*   - provide 服务键按实例分流：cn → `tradingCnMarketData`，hk → `tradingHkMarketData`
+*     （api 包 Context 模块增强统一声明两个键）；
+*   - 工具按市场注册：market=cn 挂 `cn_get_ticker/cn_get_klines/cn_place_order`，
+*     market=hk 挂 `hk_` 同名三件。工具前缀落在 base 闸门模式
+*     `/^(?:crypto|us|cn|hk)_(?:place|cancel)_order$/` 内，闸门接线与 crypto/us 同构。
+*
+* 下单三段闸门语义照抄 crypto/us 切片（README 铁律 #3 / S4 修订）；审批不在工具内做。
+* 腾讯本身无交易 API——live 路径恒为 TRADING_NOT_IMPLEMENTED（券商 API 是后续任务）。
+*
+* 合规（README 铁律 #5）：腾讯公共行情端点，无 key、无官方授权；个人使用边界自负
+* （详见 src/rest.ts 头注与 README 数据源节）。
+*
+* @module @dshtrading/connector-tencent
+*/
+/**
 * Cordis 插件名：`dsh-trading-*` 命名空间（TEMPLATES §8）。**两个 preset 实例共享此
 * 插件名**——实例区分靠 preset 行 id（dsh-trading-cn-connector / dsh-trading-hk-connector）
 * 与 config.market，不再依赖插件名后缀（单包双市场与 crypto/us 的「一市场一插件名」不同）。
@@ -61,10 +84,10 @@ var TencentMarketDataService = class extends Service {
 };
 function evaluateOrderGate(config, args) {
 	const requestedDryRun = args.dryRun ?? true;
-	if (!requestedDryRun && !config.liveTrading) return {
+	if (!requestedDryRun && !liveTradingEnabled(config.liveTrading)) return {
 		action: "reject",
 		code: "TRADING_LIVE_TRADING_DISABLED",
-		message: `${config.market}_place_order rejected: the call requests real execution (dryRun=${String(args.dryRun)}) but live trading is disabled (liveTrading=false). Ask the user to enable liveTrading explicitly after confirmation, or keep dryRun=true for a simulated fill.`
+		message: `${config.market}_place_order rejected: the call requests real execution (dryRun=${String(args.dryRun)}) but live trading is disabled (no signed live-trading grant from the authority plane). Ask the operator to sign a live-trading grant (packages/authority/bin/sign-live-trading.mjs) after confirmation, or keep dryRun=true for a simulated fill.`
 	};
 	if (requestedDryRun || config.dryRun) return { action: "simulate" };
 	return { action: "live" };
@@ -133,7 +156,7 @@ function createPlaceOrderTool(deps) {
 	const market = deps.config.market;
 	return defineTool({
 		name: `${market}_place_order`,
-		description: `Place a ${market === "hk" ? "Hong Kong" : "China A-share"} stock order, or simulate one. dryRun defaults to true and returns a DRY-RUN simulated fill receipt referencing the latest Tencent public quote. Real execution (dryRun=false) requires the plugin liveTrading switch plus user approval, and is not implemented yet in this slice (Tencent has no trading API).`,
+		description: `Place a ${market === "hk" ? "Hong Kong" : "China A-share"} stock order, or simulate one. dryRun defaults to true and returns a DRY-RUN simulated fill receipt referencing the latest Tencent public quote. Real execution (dryRun=false) requires the signed live-trading grant plus user approval, and is not implemented yet in this slice (Tencent has no trading API).`,
 		parameters: {
 			symbol: {
 				type: "string",
@@ -163,7 +186,7 @@ function createPlaceOrderTool(deps) {
 			},
 			dryRun: {
 				type: "boolean",
-				description: "true (default) = simulate only and return a DRY-RUN receipt; false = request real execution (gated by liveTrading and user approval)",
+				description: "true (default) = simulate only and return a DRY-RUN receipt; false = request real execution (gated by the signed live-trading authority and user approval)",
 				default: true
 			}
 		},

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dshtrading/connector-tencent",
   "description": "CN + HK dual-market connector plugin for dsh-trading: public market data from Tencent quote/kline endpoints implementing the @dshtrading/api contracts (single package, per-instance market split; no key, no official authorization — personal use boundary at your own discretion)",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -21,7 +21,8 @@
   ],
   "license": "PolyForm-Noncommercial-1.0.0",
   "dependencies": {
-    "@dshtrading/api": "^0.5.0"
+    "@dshtrading/authority": "^0.6.0",
+    "@dshtrading/api": "^0.6.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.0",