@dshtrading/hk 0.1.3 → 0.1.5

package/lib/index.d.ts

@@ -1,47 +1,14 @@
 import Schema from "@deepseek-ai/schemastery";
-import { Context } from "@deepseek-ai/cordis";
 //#region src/index.d.ts
-/**
- * Cordis 插件名 = patch 行 id（TEMPLATES §8）：`dsh-trading-hk-*` 市场命名空间，
- * 全仓唯一（insert-only 铁律 #1）。
- */
 declare const name = "dsh-trading-hk-installer";
 interface Config {
-  /** preset 自安装 root 覆盖；默认 ~/.dsh-trading-presets（须与 base 层 agent-presets 行的 roots 一致）。 */
   presetRoot?: string;
 }
 declare const Config: Schema<Config>;
-declare const PRESET_ID = "hk-trader";
-/** 默认安装 root：市场自有目录（S3 建议——绝不写进 ~/.dsh/.agent-presets 用户创作区）。 */
-declare const DEFAULT_PRESET_ROOT: string;
-interface SelfInstallResult {
-  /** 安装目录（preset 目录名即 roster id）。 */
-  dir: string;
-  /** 本次实际写入的文件名；空数组 = 内容已是当前代际。 */
-  wrote: string[];
-  /** 被跳过的文件与原因（用户改过/无管理戳）。 */
-  skipped: string[];
-}
-/**
- * 幂等自安装 preset（S3 机制 + 2026-08-29 代际管理戳升级）：mkdir -p + 逐文件按管理戳
- * 三代裁决——
- *
- *   1. 目标不存在 → 写入（头行 = `# dsh-trading-managed: <内容sha前8>` + shipped 内容）；
- *   2. 目标存在且带本包可识别的管理戳（托管文件）→ 正文与 shipped 内容不同则整文件更新
- *      （以新代际覆盖——戳即「本文件归安装器托管」的约定）；
- *   3. 目标存在但无管理戳（用户改过/前代安装器所装）→ 跳过并记录提示（删除该文件即可
- *      让安装器重新提供）。
- *
- * 迁移注意：代际升级前由旧安装器写入的已装文件没有管理戳，按第 3 条处理（跳过 + log
- * 提示）——宁可不更新，绝不覆盖用户改动。
- *
- * 卸载本 bundle 不删除已安装目录（有意为之）：升级/重装后再次 apply 即恢复一致；本包
- * 被移除后 preset 行不可解析只会得到带原因的 broken 行，无进程崩溃（S3 REPORT broken 语义）。
- * preset 引用的插件包必须进本 bundle 的 dependencies（S3 坑 3），见 package.json。
- */
-declare function installPreset(options?: {
-  presetRoot?: string;
-}): Promise<SelfInstallResult>;
-declare function apply(ctx: Context, config: Config): void;
+declare function getPresetContribution(): Promise<{
+  market: "hk";
+  traderRows: string;
+}>;
+declare function apply(): void;
 //#endregion
-export { Config, DEFAULT_PRESET_ROOT, PRESET_ID, SelfInstallResult, apply, installPreset, name };
+export { Config, apply, getPresetContribution, name };

package/lib/index.js

@@ -1,108 +1,18 @@
-import { createHash } from "node:crypto";
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { homedir } from "node:os";
-import { join } from "node:path";
-import { fileURLToPath } from "node:url";
+import { readFile } from "node:fs/promises";
 import Schema from "@deepseek-ai/schemastery";
 //#region src/index.ts
-/**
-* @dshtrading/hk — hk 市场 bundle。包承载两块实质内容（实装形态抄 @dshtrading/us）：
-*
-*   1. `cordis.patch.yml`（由 package.json 的 `dsh.bundle.patch` 声明）：insert-only
-*      聚合本 bundle 的 host 面常驻行（铁律 #1）。connector/kit 两行在 preset 的
-*      agent.cordis.yml（preset 级会话隔离，见 assets/preset/hk-trader/）。
-*   2. `dsh-trading-hk-installer` 插件（本模块）：hk-trader preset 幂等自安装（S3 机制）。
-*      自安装职责必须在 bundle（host 面常驻）而非 kit 插件——kit 行在 preset 平面，
-*      preset 不存在时 kit.apply() 永不运行，鸡生蛋（2026-08-29 主 agent 结构性修复）。
-*
-* cn/hk 是**同一个 connector-tencent 插件包的两个实例**（单包双市场，手册 §8）：
-* 本 bundle 的 preset 行挂 market=hk 实例（提供 tradingHkMarketData + hk_* 工具）。
-*
-* @module @dshtrading/hk
-*/
-/**
-* Cordis 插件名 = patch 行 id（TEMPLATES §8）：`dsh-trading-hk-*` 市场命名空间，
-* 全仓唯一（insert-only 铁律 #1）。
-*/
+/** Market bundle capability source. @dshtrading/base/presets is the sole preset writer. */
 const name = "dsh-trading-hk-installer";
 const Config = Schema.object({ presetRoot: Schema.string() });
-const PRESET_ID = "hk-trader";
-/** 默认安装 root：市场自有目录（S3 建议——绝不写进 ~/.dsh/.agent-presets 用户创作区）。 */
-const DEFAULT_PRESET_ROOT = join(homedir(), ".dsh-trading-presets");
-/** 预置资产随本包分发（bundle 是市场组装点，preset 资产归 bundle 所有）。 */
-const PRESET_ASSET_DIR = fileURLToPath(new URL("../assets/preset/", import.meta.url));
-const PRESET_FILES = ["agent.cordis.yml", "preset.yml"];
-/** 管理戳注释行前缀：托管安装文件的头行，值 = shipped 内容（不含戳行）的 SHA-256 前 8 位。 */
-const MANAGED_STAMP_PREFIX = "# dsh-trading-managed: ";
-function contentSha8(content) {
-	return createHash("sha256").update(content, "utf8").digest("hex").slice(0, 8);
-}
-/** 提取已安装文件头行的管理戳；null = 无戳（文件视为用户所有）。 */
-function readManagedStamp(current) {
-	if (!current.startsWith(MANAGED_STAMP_PREFIX)) return null;
-	const stamp = (current.includes("\n") ? current.slice(0, current.indexOf("\n")) : current).slice(23).trim();
-	return /^[0-9a-f]{8}$/.test(stamp) ? stamp : null;
-}
-/** 已安装文件去掉管理戳头行后的正文。 */
-function bodyAfterStamp(current) {
-	return current.includes("\n") ? current.slice(current.indexOf("\n") + 1) : "";
-}
-/**
-* 幂等自安装 preset（S3 机制 + 2026-08-29 代际管理戳升级）：mkdir -p + 逐文件按管理戳
-* 三代裁决——
-*
-*   1. 目标不存在 → 写入（头行 = `# dsh-trading-managed: <内容sha前8>` + shipped 内容）；
-*   2. 目标存在且带本包可识别的管理戳（托管文件）→ 正文与 shipped 内容不同则整文件更新
-*      （以新代际覆盖——戳即「本文件归安装器托管」的约定）；
-*   3. 目标存在但无管理戳（用户改过/前代安装器所装）→ 跳过并记录提示（删除该文件即可
-*      让安装器重新提供）。
-*
-* 迁移注意：代际升级前由旧安装器写入的已装文件没有管理戳，按第 3 条处理（跳过 + log
-* 提示）——宁可不更新，绝不覆盖用户改动。
-*
-* 卸载本 bundle 不删除已安装目录（有意为之）：升级/重装后再次 apply 即恢复一致；本包
-* 被移除后 preset 行不可解析只会得到带原因的 broken 行，无进程崩溃（S3 REPORT broken 语义）。
-* preset 引用的插件包必须进本 bundle 的 dependencies（S3 坑 3），见 package.json。
-*/
-async function installPreset(options = {}) {
-	const dir = join(options.presetRoot ?? DEFAULT_PRESET_ROOT, PRESET_ID);
-	await mkdir(dir, { recursive: true });
-	const wrote = [];
-	const skipped = [];
-	for (const file of PRESET_FILES) {
-		const content = await readFile(join(PRESET_ASSET_DIR, PRESET_ID, file), "utf8");
-		const stamped = `${MANAGED_STAMP_PREFIX}${contentSha8(content)}\n${content}`;
-		const target = join(dir, file);
-		let current = null;
-		try {
-			current = await readFile(target, "utf8");
-		} catch {}
-		if (current === null) {
-			await writeFile(target, stamped);
-			wrote.push(file);
-			continue;
-		}
-		if (readManagedStamp(current) === null) {
-			skipped.push(`${file} (no management stamp — user-modified file left untouched; delete it to let the installer re-provision it)`);
-			continue;
-		}
-		if (bodyAfterStamp(current) !== content) {
-			await writeFile(target, stamped);
-			wrote.push(file);
-		}
-	}
+async function getPresetContribution() {
+	const asset = (await readFile(new URL("../assets/preset/hk-trader/agent.cordis.yml", import.meta.url), "utf8")).replace(/\r\n/g, "\n");
+	const start = asset.indexOf("- id: dsh-trading-hk-connector-group\n");
+	if (start < 0) throw new Error("Missing hk capability rows");
 	return {
-		dir,
-		wrote,
-		skipped
+		market: "hk",
+		traderRows: asset.slice(start)
 	};
 }
-function logger(ctx) {
-	const service = ctx.logger;
-	return typeof service === "function" ? service(name) : console;
-}
-function apply(ctx, config) {
-	installPreset({ presetRoot: config?.presetRoot }).then((result) => logger(ctx).info("[dsh-trading-hk-installer] self-install %s preset at %s wrote=[%s] skipped=[%s]", PRESET_ID, result.dir, result.wrote.join(",") || "nothing — already current", result.skipped.join("; ") || "none"), (error) => logger(ctx).warn("[dsh-trading-hk-installer] hk-trader preset self-install failed: %s", error));
-}
+function apply() {}
 //#endregion
-export { Config, DEFAULT_PRESET_ROOT, PRESET_ID, apply, installPreset, name };
+export { Config, apply, getPresetContribution, name };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dshtrading/hk",
   "description": "HK (Hong Kong) market bundle for dsh-trading: host-plane hk-trader preset installer + insert-only aggregation of the Tencent connector (market=hk instance) and hk kit rows (design rule #1)",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "type": "module",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -25,11 +25,11 @@
     }
   },
   "dependencies": {
-    "@dshtrading/connector-futu": "0.1.3",
-    "@dshtrading/connector-longbridge": "0.1.3",
-    "@dshtrading/connector-tencent": "0.1.3",
-    "@dshtrading/connector-tiger": "0.1.3",
-    "@dshtrading/kit-hk": "0.1.3"
+    "@dshtrading/connector-futu": "0.1.5",
+    "@dshtrading/connector-longbridge": "0.1.5",
+    "@dshtrading/connector-tencent": "0.1.5",
+    "@dshtrading/connector-tiger": "0.1.5",
+    "@dshtrading/kit-hk": "0.1.5"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.0",