@dshtrading/dsh-home 0.1.6

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/lib/index.d.ts

@@ -0,0 +1,63 @@
+//#region src/index.d.ts
+/**
+ * dsh home 根目录解析，与宿主 @deepseek-ai/dsh-home-paths 同语义：
+ * 优先级 显式传入 > `$DSH_HOME`（空白视为未设，支持 `~` 展开）> `~/.dsh`，
+ * 相对路径按 CWD 解析。
+ *
+ * dsh-trading 各包的 home 数据文件（watchlists.json、knowledge/cards.json、
+ * trading-tasks/ledger 等）一律经此解析，使整套 trading 实例可以通过
+ * `DSH_HOME=~/.dsh-trading` 迁到独立 home，与 dsh web 宿主 home 彻底分开
+ * （2026-09-08 DSH_HOME 分离，note: implemented/process/2026-09-08-separate-dsh-home.md）。
+ */
+/**
+ * 解析 dsh home 根目录。
+ * @param env 环境变量映射，缺省读 `process.env`；空白 `$DSH_HOME` 视为未设。
+ */
+declare function dshHomeDir(env?: Record<string, string | undefined>): string;
+/** 缺省 home（`~/.dsh`）——迁移判据用：解析结果等于它就没有旧 home 可迁。 */
+declare function defaultDshHome(): string;
+/**
+ * dsh-trading 自有数据条目（迁移白名单）。
+ *
+ * 只搬这些——`sessions/`、`storages/`、`memory/`、`task-board/`、`integrations/`
+ * 是宿主/共居资产（搬了会双实例重复收发消息或抢会话），settings/credentials 是
+ * 宿主级配置（两个 home 刻意各自演化）。见
+ * `.agents/notes/implemented/process/2026-09-08-separate-dsh-home.md`。
+ */
+declare const TRADING_HOME_ENTRIES: readonly ["watchlists.json", "selection.json", "watchlist-groups.json", "knowledge", "holdings", "indicators", "strategies", "trading-tasks", "trading-updater"];
+/** 迁移标记文件名（写在目标 home；存在即不再迁移，用户删档也不会被搬回）。 */
+declare const HOME_MIGRATION_MARKER = ".legacy-home-migrated.json";
+interface LegacyHomeMigrationOptions {
+  /** 环境变量映射（缺省 `process.env`）；解析结果等于缺省 home 时直接跳过。 */
+  env?: Record<string, string | undefined>;
+  /** 旧 home 根（缺省 `~/.dsh`）。 */
+  legacyHome?: string;
+  /** 日志回调（缺省静默）。 */
+  log?: (message: string) => void;
+}
+interface LegacyHomeMigrationResult {
+  from: string;
+  to: string;
+  /** 本次复制过来的条目。 */
+  copied: string[];
+  /** 旧 home 有、目标 home 已有而跳过的条目（用户已自行迁移或本就同源）。 */
+  skipped: string[];
+}
+/**
+ * 旧 home → 当前 home 的一次性数据迁移（2026-09-08 审查 H4）。
+ *
+ * 背景：桌面壳内置缺省 home 翻到 `~/.dsh-trading` 后，老用户 `~/.dsh` 下的自选/
+ * 持仓/知识库/定时任务数据不再被读取——表现是升级后「数据全空」。
+ *
+ * 语义（严格非破坏）：
+ * - 解析结果等于缺省 home（`~/.dsh`）→ 不做任何事（CLI 缺省路径零影响）；
+ * - 目标 home 已有标记文件 → 不再迁移（幂等；用户删除的文件不会被搬回）；
+ * - 逐条目：目标已存在 → 跳过；旧 home 存在 → `cpSync` 复制（**复制不是移动**，
+ *   旧 home 原样保留，回滚即删新 home 或继续用旧 home）；
+ * - 只处理 {@link TRADING_HOME_ENTRIES} 白名单，绝不触碰宿主资产。
+ *
+ * @returns 迁移结果；未触发（同源/已迁移）返回 null。
+ */
+declare function migrateLegacyTradingHome(options?: LegacyHomeMigrationOptions): LegacyHomeMigrationResult | null;
+//#endregion
+export { HOME_MIGRATION_MARKER, LegacyHomeMigrationOptions, LegacyHomeMigrationResult, TRADING_HOME_ENTRIES, defaultDshHome, dshHomeDir, migrateLegacyTradingHome };

package/lib/index.js

@@ -0,0 +1,123 @@
+import { cpSync, existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+//#region src/index.ts
+/**
+* dsh home 根目录解析，与宿主 @deepseek-ai/dsh-home-paths 同语义：
+* 优先级 显式传入 > `$DSH_HOME`（空白视为未设，支持 `~` 展开）> `~/.dsh`，
+* 相对路径按 CWD 解析。
+*
+* dsh-trading 各包的 home 数据文件（watchlists.json、knowledge/cards.json、
+* trading-tasks/ledger 等）一律经此解析，使整套 trading 实例可以通过
+* `DSH_HOME=~/.dsh-trading` 迁到独立 home，与 dsh web 宿主 home 彻底分开
+* （2026-09-08 DSH_HOME 分离，note: implemented/process/2026-09-08-separate-dsh-home.md）。
+*/
+const DEFAULT_HOME_DIR_NAME = ".dsh";
+/** 展开 `~` 与 `~/` 前缀（对齐宿主 expandHomePath；Windows 反斜杠前缀同样接受）。 */
+function expandHomePath(path) {
+	const home = homedir();
+	if (path === "~") return home;
+	if (path.startsWith("~/") || path.startsWith("~\\")) return resolve(home, path.slice(2));
+	return path;
+}
+/**
+* 解析 dsh home 根目录。
+* @param env 环境变量映射，缺省读 `process.env`；空白 `$DSH_HOME` 视为未设。
+*/
+function dshHomeDir(env = process.env) {
+	const fromEnv = env.DSH_HOME;
+	const configured = fromEnv !== void 0 && fromEnv.trim().length > 0 ? fromEnv : resolve(homedir(), DEFAULT_HOME_DIR_NAME);
+	return resolve(expandHomePath(configured));
+}
+/** 缺省 home（`~/.dsh`）——迁移判据用：解析结果等于它就没有旧 home 可迁。 */
+function defaultDshHome() {
+	return resolve(homedir(), DEFAULT_HOME_DIR_NAME);
+}
+/**
+* dsh-trading 自有数据条目（迁移白名单）。
+*
+* 只搬这些——`sessions/`、`storages/`、`memory/`、`task-board/`、`integrations/`
+* 是宿主/共居资产（搬了会双实例重复收发消息或抢会话），settings/credentials 是
+* 宿主级配置（两个 home 刻意各自演化）。见
+* `.agents/notes/implemented/process/2026-09-08-separate-dsh-home.md`。
+*/
+const TRADING_HOME_ENTRIES = [
+	"watchlists.json",
+	"selection.json",
+	"watchlist-groups.json",
+	"knowledge",
+	"holdings",
+	"indicators",
+	"strategies",
+	"trading-tasks",
+	"trading-updater"
+];
+/** 迁移标记文件名（写在目标 home；存在即不再迁移，用户删档也不会被搬回）。 */
+const HOME_MIGRATION_MARKER = ".legacy-home-migrated.json";
+/**
+* 旧 home → 当前 home 的一次性数据迁移（2026-09-08 审查 H4）。
+*
+* 背景：桌面壳内置缺省 home 翻到 `~/.dsh-trading` 后，老用户 `~/.dsh` 下的自选/
+* 持仓/知识库/定时任务数据不再被读取——表现是升级后「数据全空」。
+*
+* 语义（严格非破坏）：
+* - 解析结果等于缺省 home（`~/.dsh`）→ 不做任何事（CLI 缺省路径零影响）；
+* - 目标 home 已有标记文件 → 不再迁移（幂等；用户删除的文件不会被搬回）；
+* - 逐条目：目标已存在 → 跳过；旧 home 存在 → `cpSync` 复制（**复制不是移动**，
+*   旧 home 原样保留，回滚即删新 home 或继续用旧 home）；
+* - 只处理 {@link TRADING_HOME_ENTRIES} 白名单，绝不触碰宿主资产。
+*
+* @returns 迁移结果；未触发（同源/已迁移）返回 null。
+*/
+function migrateLegacyTradingHome(options = {}) {
+	const log = options.log ?? (() => {});
+	const to = dshHomeDir(options.env ?? process.env);
+	const from = resolve(expandHomePath(options.legacyHome ?? join(homedir(), DEFAULT_HOME_DIR_NAME)));
+	if (from === to) return null;
+	const marker = join(to, HOME_MIGRATION_MARKER);
+	if (existsSync(marker)) return null;
+	const copied = [];
+	const skipped = [];
+	for (const entry of TRADING_HOME_ENTRIES) {
+		const source = join(from, entry);
+		const target = join(to, entry);
+		if (!existsSync(source)) continue;
+		if (existsSync(target)) {
+			skipped.push(entry);
+			continue;
+		}
+		try {
+			mkdirSync(to, { recursive: true });
+			cpSync(source, target, {
+				recursive: true,
+				force: false,
+				errorOnExist: false,
+				preserveTimestamps: true
+			});
+			copied.push(entry);
+		} catch (error) {
+			log(`[dsh-home] legacy home migration failed for ${entry}: ${error instanceof Error ? error.message : String(error)}`);
+		}
+	}
+	try {
+		mkdirSync(to, { recursive: true });
+		writeFileSync(marker, `${JSON.stringify({
+			from,
+			to,
+			copied,
+			skipped,
+			at: (/* @__PURE__ */ new Date()).toISOString()
+		}, null, 2)}\n`, "utf8");
+	} catch (error) {
+		log(`[dsh-home] could not write migration marker ${marker}: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	if (copied.length > 0) log(`[dsh-home] migrated legacy trading data from ${from} to ${to}: ${copied.join(", ")} (originals kept)`);
+	return {
+		from,
+		to,
+		copied,
+		skipped
+	};
+}
+//#endregion
+export { HOME_MIGRATION_MARKER, TRADING_HOME_ENTRIES, defaultDshHome, dshHomeDir, migrateLegacyTradingHome };

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@dshtrading/dsh-home",
+  "description": "dsh home 根目录解析（$DSH_HOME 环境变量感知，缺省 ~/.dsh，对齐宿主 dsh-home-paths 语义）——dsh-trading 各包 home 数据文件的唯一路径来源",
+  "version": "0.1.6",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib"
+  ],
+  "license": "PolyForm-Noncommercial-1.0.0",
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "tsdown": "^0.22.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run"
+  }
+}