@dshtrading/hk 0.1.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/assets/preset/hk-trader/agent.cordis.yml

@@ -0,0 +1,97 @@
+# hk-trader agent preset —— dsh-trading hk 切片（实装形态抄 us-trader/cn-trader）。
+#
+# 本文件由 @dshtrading/hk 的 dsh-trading-hk-installer 插件（bundle host 面常驻行）在
+# apply() 时幂等自安装到市场自有 preset root（默认 ~/.dsh-trading-presets/hk-trader；
+# agent-presets 行需把该 root 配进 roots，统一配置归 @dshtrading/base）。插件卸载不
+# 删除已安装目录；升级/重装后再次 apply 即恢复一致，行不可解析时只会得到带原因的
+# broken 行，无进程崩溃（S3 REPORT broken 语义）。
+#
+# **单包双市场多实例模式（手册 §8，本仓新模式）**：connector 行 name 指向
+# @dshtrading/connector-tencent（cn/hk 共用同一插件包），行 id 用市场命名空间的
+# dsh-trading-hk-connector（cn preset 用 dsh-trading-cn-connector——不同 id 即不同
+# 实例，行 id 即命名空间），config.market=hk 分流。provide 服务键 tradingHkMarketData，
+# 组行 isolate 键 = 服务名（官方 standard preset 挂载硬规则；不包组则被
+# dsh-agent-presets 以 published process-global service 拒绝，acceptance「修复 1」）。
+#
+# 组合形态对照官方 standard preset：本文件是 AGENT-PLANE 组合，不持有审批/沙箱/模型路由
+# （host 面职责）。kit 行只向 scope 分层注册表（ctx.skills）注册、不 provide 服务，无需 realm。
+- id: persona
+  name: '@deepseek-ai/dsh-persona'
+  config:
+    text: >-
+      你是一名严谨的港股交易员，由 {{model}} 模型驱动，工作目录为 {{cwd}}。基于腾讯
+      公开行情（实时快照与前权 OHLCV）做客观、量化的分析；下单类操作一律默认 dry-run
+      模拟，liveTrading 关闭时直接拒绝实盘，未经用户明确确认绝不触碰真实资金；涉及
+      T+0 无涨跌幅、碎股手数、供股配股、窝轮牛熊证时逐项核对 hk-risk-checklist 风控
+      清单，并明确提示跳空与流动性风险；你给出的任何内容都不构成投资建议。每次会话开始时，
+      先检查工作目录下是否已有交易日志目录 .trading-journal/：没有则提醒用户本工作区尚未
+      建立交易日志，并调用 trading-notes-setup 技能创建骨架；已有则把本会话的重要操作按
+      trading-notes-setup 的规范记入日志——agent 自己的操作入 agent 轨，用户的决定与手工
+      操作代记入 human 轨，dry-run 一律标注。
+
+# connector 行 provide 服务（tradingHkMarketData），必须包进 cordis:group + isolate，
+# isolate 键 = 服务名（commit 8f75804 + acceptance「修复 1」）。
+- id: dsh-trading-hk-connector-group
+  name: cordis:group
+  group: true
+  isolate:
+    tradingHkMarketData: true
+  config:
+    # 同包双实例：行 id 市场命名空间，name 指向共用插件包，market 分流。
+    - id: dsh-trading-hk-connector-tencent
+      name: '@dshtrading/connector-tencent'
+      config:
+        enabled: true
+        market: hk
+        dryRun: true
+        liveTrading: false
+
+- id: dsh-trading-hk-connector-futu-group
+  name: cordis:group
+  group: true
+  isolate:
+    tradingHkMarketData: true
+    tradingHkTrade: true
+  config:
+    - id: dsh-trading-hk-connector-futu
+      name: '@dshtrading/connector-futu'
+      config:
+        enabled: true
+        dryRun: true
+        liveTrading: false
+
+- id: dsh-trading-hk-connector-longbridge-group
+  name: cordis:group
+  group: true
+  isolate:
+    tradingHkMarketData: true
+    tradingHkTrade: true
+  config:
+    - id: dsh-trading-hk-connector-longbridge
+      name: '@dshtrading/connector-longbridge'
+      config:
+        enabled: true
+        dryRun: true
+        liveTrading: false
+
+- id: dsh-trading-hk-connector-tiger-group
+  name: cordis:group
+  group: true
+  isolate:
+    tradingHkMarketData: true
+    tradingHkTrade: true
+  config:
+    - id: dsh-trading-hk-connector-tiger
+      name: '@dshtrading/connector-tiger'
+      config:
+        enabled: true
+        dryRun: true
+        liveTrading: false
+
+
+- id: dsh-trading-hk-kit
+  name: '@dshtrading/kit-hk'
+  config:
+    dryRun: true
+    liveTrading: false
+

package/assets/preset/hk-trader/preset.yml

@@ -0,0 +1,3 @@
+name: HK 交易员
+description: 港股市场会话：腾讯行情工具与交易员人设（由 @dshtrading/hk 自安装，普通会话不可见 hk 工具）。
+order: 22

package/cordis.patch.yml

@@ -0,0 +1,40 @@
+# @dshtrading/hk —— hk 市场 bundle 的 patch 层（insert-only，README 设计铁律 #1）。
+#
+# 实装形态抄 @dshtrading/us（架构修订 2026-08-29 主 agent 决策）：connector/kit 的
+# 插件行在 preset 的 agent.cordis.yml（preset 级会话隔离）。本 bundle 的职责：
+#   1. dsh-trading-hk-installer —— host 面常驻安装器插件（src/index.ts）：boot 时幂等
+#      自安装 hk-trader preset 到 ~/.dsh-trading-presets。自安装必须在 bundle 层而非
+#      kit 插件（kit 行在 preset 平面，preset 不存在则 kit.apply() 永不运行）；
+#   2. 依赖安装载体：preset 行按 bare 包名从 profile node_modules 解析（S3 坑 3），本包
+#      dependencies 实装 @dshtrading/connector-tencent 与 @dshtrading/kit-hk，保证
+#      preset 行可解析、不 broken。**connector-tencent 是 cn/hk 共用的单包双市场插件**：
+#      本包与 @dshtrading/cn 依赖同一个包，preset 行以 config.market 分流（新模式，
+#      手册 §8）；
+#   3. agent-presets root 行归 base 层所有（~/.dsh-trading-presets），本层不得重复配置。
+#
+# 注意：patch 文件必须保持「顶层 YAML 数组」形状（loadProfile → parsePatchList 对非数组
+# 直接抛错）；只允许 insert（按 id 打已存在行 = 整行替换，多市场并存会互相覆盖）。
+- insert:
+    - id: dsh-trading-hk-installer
+      name: '@dshtrading/hk'
+
+    # host 面数据行（2026-08-30 GUI 行情桥配套）：只 provide tradingHkMarketData。
+    - id: dsh-trading-hk-dataplane-tencent
+      name: '@dshtrading/connector-tencent/dataplane'
+      config:
+        enabled: true
+        market: hk
+    - id: dsh-trading-hk-dataplane-futu
+      name: '@dshtrading/connector-futu/dataplane'
+      config:
+        enabled: true
+    - id: dsh-trading-hk-dataplane-longbridge
+      name: '@dshtrading/connector-longbridge/dataplane'
+      config:
+        enabled: true
+    - id: dsh-trading-hk-dataplane-tiger
+      name: '@dshtrading/connector-tiger/dataplane'
+      config:
+        enabled: true
+
+

package/lib/index.d.ts

@@ -0,0 +1,47 @@
+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;
+//#endregion
+export { Config, DEFAULT_PRESET_ROOT, PRESET_ID, SelfInstallResult, apply, installPreset, name };

package/lib/index.js

@@ -0,0 +1,108 @@
+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 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）。
+*/
+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);
+		}
+	}
+	return {
+		dir,
+		wrote,
+		skipped
+	};
+}
+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));
+}
+//#endregion
+export { Config, DEFAULT_PRESET_ROOT, PRESET_ID, apply, installPreset, name };

package/package.json

@@ -0,0 +1,44 @@
+{
+  "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.0",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "assets",
+    "cordis.patch.yml"
+  ],
+  "license": "PolyForm-Noncommercial-1.0.0",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "dependencies": {
+    "@dshtrading/connector-futu": "0.1.0",
+    "@dshtrading/connector-tencent": "0.1.0",
+    "@dshtrading/connector-tiger": "0.1.0",
+    "@dshtrading/kit-hk": "0.1.0",
+    "@dshtrading/connector-longbridge": "0.1.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.0",
+    "@deepseek-ai/schemastery": ">=3.18.0"
+  },
+  "devDependencies": {
+    "tsdown": "^0.22.0"
+  },
+  "scripts": {
+    "build": "tsdown"
+  }
+}