@dshtrading/futures 0.3.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/futures-trader/agent.cordis.yml

@@ -0,0 +1,45 @@
+# futures-trader agent preset —— dsh-trading futures 切片（实装形态抄 cn-trader）。
+#
+# 本文件由 @dshtrading/futures 的 dsh-trading-futures-installer 插件（bundle host 面
+# 常驻行）经 @dshtrading/base/presets 幂等装配到 trader/master 角色组合（统一 preset
+# root 归 @dshtrading/base，见 packages/base/src/presets.ts）。
+#
+# 期货切片（issue #97）：connector 行 provide tradingFuturesMarketData（同花顺期货
+# 数据服务：日K + 当日分时 + 品种/代码表），无实盘交易面（A 股期货执行走本地
+# MiniQMT 等账户侧，铁律 #3 统一闸门；本切片为数据面）。kit 行只注册 skill
+# provider（futures-risk-checklist），不 provide 服务，无需 realm。
+#
+# 组合形态对照官方 standard preset：AGENT-PLANE 组合，不持有审批/沙箱/模型路由。
+- id: persona
+  name: '@deepseek-ai/dsh-persona'
+  config:
+    text: >-
+      你是一名严谨的国内期货交易员，由 {{model}} 模型驱动，工作目录为 {{cwd}}。基于
+      同花顺期货数据（日K 与当日分时、品种目录）做客观、量化的分析；数据当前仅覆盖
+      日K与当日分时，不得用当日分时冒充历史分钟数据；涉及保证金、强平价、移仓换月、
+      夜盘与涨跌停板时逐项核对 futures-risk-checklist 风控清单；期货执行面本切片不
+      提供，真实下单走账户侧人工流程，你输出的是计划与提醒，不构成投资建议。每次会话
+      开始时，先检查工作目录下是否已有交易日志目录 .trading-journal/：没有则提醒用户
+      本工作区尚未建立交易日志，并调用 trading-notes-setup 技能创建骨架；已有则把本
+      会话的重要操作按规范记入日志。
+
+# connector 行 provide 服务（tradingFuturesMarketData），必须包进 cordis:group + isolate，
+# isolate 键 = 服务名（官方 standard preset 挂载硬规则）。preset 面走直接 provide 入口；
+# host 面注册表行（cordis.patch.yml 的 futures-dataplane）负责 GUI 行情桥，两面同挂
+# 若都用 dataplane 会触发注册表 (futures, hithink) 重复注册的响亮失败。
+- id: dsh-trading-futures-connector-group
+  name: cordis:group
+  group: true
+  isolate:
+    tradingFuturesMarketData: true
+  config:
+    - id: dsh-trading-futures-connector
+      name: '@dshtrading/connector-hithink/futures-plugin'
+      config:
+        enabled: true
+
+- id: dsh-trading-futures-kit
+  name: '@dshtrading/kit-futures'
+  config:
+    dryRun: true
+    liveTrading: false

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

@@ -0,0 +1,3 @@
+name: 期货交易员
+description: 国内期货市场会话：同花顺期货行情工具与交易员人设（由 @dshtrading/futures 自安装，普通会话不可见期货工具）。
+order: 22

package/cordis.patch.yml

@@ -0,0 +1,20 @@
+# @dshtrading/futures —— 期货市场 bundle 的 patch 层（insert-only，README 设计铁律 #1）。
+#
+# 实装形态抄 @dshtrading/cn：connector/kit 的插件行在 preset 的 agent.cordis.yml
+# （preset 级会话隔离）。本 bundle 的职责：
+#   1. dsh-trading-futures-installer —— host 面常驻安装器插件（src/index.ts）：boot 时
+#      幂等贡献 futures-trader 切片（经 base/presets 统一装配）；
+#   2. host 面数据行：@dshtrading/connector-hithink/futures-dataplane 注册
+#      (market=futures, provider=hithink) 到 tradingMarketDataRegistry（GUI 行情桥）。
+#
+# 注意：patch 文件必须保持「顶层 YAML 数组」形状（loadProfile → parsePatchList 对非数组
+# 直接抛错）；只允许 insert（按 id 打已存在行 = 整行替换，多市场并存会互相覆盖）。
+- insert:
+    - id: dsh-trading-futures-installer
+      name: '@dshtrading/futures'
+
+    # host 面数据行（issue #97）：注册 futures 市场行情服务（同花顺期货源）。
+    - id: dsh-trading-futures-dataplane
+      name: '@dshtrading/connector-hithink/futures-dataplane'
+      config:
+        enabled: true

package/lib/index.d.ts

@@ -0,0 +1,14 @@
+import Schema from "@deepseek-ai/schemastery";
+//#region src/index.d.ts
+declare const name = "dsh-trading-futures-installer";
+interface Config {
+  presetRoot?: string;
+}
+declare const Config: Schema<Config>;
+declare function getPresetContribution(): Promise<{
+  market: "futures";
+  traderRows: string;
+}>;
+declare function apply(): void;
+//#endregion
+export { Config, apply, getPresetContribution, name };

package/lib/index.js

@@ -0,0 +1,18 @@
+import { readFile } from "node:fs/promises";
+import Schema from "@deepseek-ai/schemastery";
+//#region src/index.ts
+/** Market bundle capability source. @dshtrading/base/presets is the sole preset writer. */
+const name = "dsh-trading-futures-installer";
+const Config = Schema.object({ presetRoot: Schema.string() });
+async function getPresetContribution() {
+	const asset = (await readFile(new URL("../assets/preset/futures-trader/agent.cordis.yml", import.meta.url), "utf8")).replace(/\r\n/g, "\n");
+	const start = asset.indexOf("- id: dsh-trading-futures-connector-group\n");
+	if (start < 0) throw new Error("Missing futures capability rows");
+	return {
+		market: "futures",
+		traderRows: asset.slice(start)
+	};
+}
+function apply() {}
+//#endregion
+export { Config, apply, getPresetContribution, name };

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@dshtrading/futures",
+  "description": "Futures market bundle for dsh-trading: host-plane futures-trader preset installer + insert-only aggregation of the HiThink futures connector dataplane row and futures kit row (design rule #1)",
+  "version": "0.3.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-hithink": "0.3.0",
+    "@dshtrading/kit-futures": "0.3.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.0",
+    "@deepseek-ai/schemastery": ">=3.18.0"
+  },
+  "devDependencies": {
+    "tsdown": "^0.22.0"
+  },
+  "scripts": {
+    "build": "tsdown"
+  }
+}