@zqagent/core 0.2.20 → 0.3.7

package/dist/internal/mcp/presets.js

@@ -0,0 +1,158 @@
+// src/mcp/presets.ts
+var MCP_PRESETS = [
+  {
+    id: "filesystem",
+    title: "Filesystem\uFF08\u672C\u5730\u6587\u4EF6\uFF09",
+    description: "\u8BA9 MCP \u8BFB\u5199\u6307\u5B9A\u76EE\u5F55\uFF0Cnpx \u81EA\u52A8\u62C9\u53D6\u5B98\u65B9 server",
+    config: {
+      name: "filesystem",
+      type: "stdio",
+      command: [
+        "npx",
+        "-y",
+        "@modelcontextprotocol/server-filesystem",
+        "{{dir}}"
+      ],
+      enabled: true
+    },
+    fields: [
+      {
+        key: "dir",
+        label: "\u5141\u8BB8\u8BBF\u95EE\u7684\u76EE\u5F55\uFF08\u7EDD\u5BF9\u8DEF\u5F84\uFF09",
+        required: true
+      }
+    ]
+  },
+  {
+    id: "memory",
+    title: "Memory\uFF08\u77E5\u8BC6\u56FE\u8C31\u8BB0\u5FC6\uFF09",
+    description: "\u5B98\u65B9 memory server\uFF0C\u63D0\u4F9B\u5B9E\u4F53/\u5173\u7CFB\u8BB0\u5FC6",
+    config: {
+      name: "memory",
+      type: "stdio",
+      command: ["npx", "-y", "@modelcontextprotocol/server-memory"],
+      enabled: true
+    }
+  },
+  {
+    id: "sequential-thinking",
+    title: "Sequential Thinking\uFF08\u5206\u6B65\u63A8\u7406\uFF09",
+    description: "\u5B98\u65B9\u5206\u6B65\u601D\u8003 server",
+    config: {
+      name: "sequential-thinking",
+      type: "stdio",
+      command: [
+        "npx",
+        "-y",
+        "@modelcontextprotocol/server-sequential-thinking"
+      ],
+      enabled: true
+    }
+  },
+  {
+    id: "github",
+    title: "GitHub",
+    description: "\u5B98\u65B9 GitHub server\uFF08\u9700\u8981 Personal Access Token\uFF09",
+    config: {
+      name: "github",
+      type: "stdio",
+      command: ["npx", "-y", "@modelcontextprotocol/server-github"],
+      env: { GITHUB_PERSONAL_ACCESS_TOKEN: "{{token}}" },
+      enabled: true
+    },
+    fields: [
+      {
+        key: "token",
+        label: "GitHub Personal Access Token",
+        required: true,
+        secret: true
+      }
+    ]
+  },
+  {
+    id: "fetch",
+    title: "Fetch\uFF08\u7F51\u9875\u6293\u53D6\uFF09",
+    description: "\u5B98\u65B9 Python server\uFF0C\u9700\u8981 uvx\uFF08pip install uv\uFF09",
+    config: {
+      name: "fetch",
+      type: "stdio",
+      command: ["uvx", "mcp-server-fetch"],
+      enabled: true
+    }
+  },
+  {
+    id: "postgres",
+    title: "PostgreSQL\uFF08\u53EA\u8BFB\u67E5\u8BE2\uFF09",
+    description: "\u5B98\u65B9 postgres server\uFF08\u9700\u8981\u8FDE\u63A5\u4E32\uFF09",
+    config: {
+      name: "postgres",
+      type: "stdio",
+      command: [
+        "npx",
+        "-y",
+        "@modelcontextprotocol/server-postgres",
+        "{{dsn}}"
+      ],
+      enabled: true
+    },
+    fields: [
+      {
+        key: "dsn",
+        label: "\u8FDE\u63A5\u4E32\uFF08postgresql://user:pass@host/db\uFF09",
+        required: true,
+        secret: true
+      }
+    ]
+  },
+  {
+    id: "ocr",
+    title: "OCR\uFF08\u5185\u7F6E\uFF0C\u5F00\u7BB1\u5373\u7528\uFF09",
+    description: "\u8FDB\u7A0B\u5185 OCR\uFF1AmacOS Vision / tesseract / \u591A\u6A21\u6001\u6A21\u578B\u81EA\u52A8\u964D\u7EA7\uFF0C\u65E0\u9700\u5B89\u88C5",
+    config: {
+      name: "ocr",
+      type: "builtin",
+      builtin: "ocr",
+      enabled: true
+    }
+  }
+];
+function replacePlaceholders(value, values) {
+  return value.replace(/\{\{([A-Za-z0-9_]+)\}\}/g, (_m, key) => {
+    return values[key] ?? "";
+  });
+}
+function applyMcpPreset(preset, values) {
+  const base = preset.config;
+  const config = {
+    ...base,
+    name: base.name ?? preset.id
+  };
+  if (config.command)
+    config.command = config.command.map(
+      (c) => replacePlaceholders(c, values)
+    );
+  if (config.url) config.url = replacePlaceholders(config.url, values);
+  if (config.cwd) config.cwd = replacePlaceholders(config.cwd, values);
+  if (config.env) {
+    config.env = Object.fromEntries(
+      Object.entries(config.env).map(([k, v]) => [
+        k,
+        replacePlaceholders(v, values)
+      ])
+    );
+  }
+  if (config.headers) {
+    config.headers = Object.fromEntries(
+      Object.entries(config.headers).map(([k, v]) => [
+        k,
+        replacePlaceholders(v, values)
+      ])
+    );
+  }
+  return config;
+}
+export {
+  MCP_PRESETS,
+  applyMcpPreset
+};
+//# sourceMappingURL=presets.js.map

package/dist/internal/mcp/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/mcp/presets.ts"],"sourcesContent":["/**\n * MCP 安装模板\n *\n * 用于 `/mcp add` 交互式向导：把常见官方服务器的启动命令与参数固化，\n * 用户只需按提示填写少量占位符。`{{key}}` 会在安装时被替换。\n */\n\nimport type { McpServerConfig } from \"./McpClient.js\";\n\n/** 模板占位符 */\nexport interface McpPresetField {\n  /** 替换 config 中的 {{key}} */\n  key: string;\n  /** 提示文案 */\n  label: string;\n  /** 必填（为空则取消安装） */\n  required?: boolean;\n  /** 隐藏输入（写入 env/headers 的密钥） */\n  secret?: boolean;\n  /** 默认值 */\n  default?: string;\n}\n\n/** 安装模板 */\nexport interface McpPreset {\n  id: string;\n  title: string;\n  description: string;\n  /** name 缺省时使用 id */\n  config: Omit<McpServerConfig, \"name\"> & { name?: string };\n  fields?: McpPresetField[];\n}\n\n/** 内置模板（官方服务器为主，命令与包名可被用户覆盖） */\nexport const MCP_PRESETS: McpPreset[] = [\n  {\n    id: \"filesystem\",\n    title: \"Filesystem（本地文件）\",\n    description: \"让 MCP 读写指定目录，npx 自动拉取官方 server\",\n    config: {\n      name: \"filesystem\",\n      type: \"stdio\",\n      command: [\n        \"npx\",\n        \"-y\",\n        \"@modelcontextprotocol/server-filesystem\",\n        \"{{dir}}\",\n      ],\n      enabled: true,\n    },\n    fields: [\n      {\n        key: \"dir\",\n        label: \"允许访问的目录（绝对路径）\",\n        required: true,\n      },\n    ],\n  },\n  {\n    id: \"memory\",\n    title: \"Memory（知识图谱记忆）\",\n    description: \"官方 memory server，提供实体/关系记忆\",\n    config: {\n      name: \"memory\",\n      type: \"stdio\",\n      command: [\"npx\", \"-y\", \"@modelcontextprotocol/server-memory\"],\n      enabled: true,\n    },\n  },\n  {\n    id: \"sequential-thinking\",\n    title: \"Sequential Thinking（分步推理）\",\n    description: \"官方分步思考 server\",\n    config: {\n      name: \"sequential-thinking\",\n      type: \"stdio\",\n      command: [\n        \"npx\",\n        \"-y\",\n        \"@modelcontextprotocol/server-sequential-thinking\",\n      ],\n      enabled: true,\n    },\n  },\n  {\n    id: \"github\",\n    title: \"GitHub\",\n    description: \"官方 GitHub server（需要 Personal Access Token）\",\n    config: {\n      name: \"github\",\n      type: \"stdio\",\n      command: [\"npx\", \"-y\", \"@modelcontextprotocol/server-github\"],\n      env: { GITHUB_PERSONAL_ACCESS_TOKEN: \"{{token}}\" },\n      enabled: true,\n    },\n    fields: [\n      {\n        key: \"token\",\n        label: \"GitHub Personal Access Token\",\n        required: true,\n        secret: true,\n      },\n    ],\n  },\n  {\n    id: \"fetch\",\n    title: \"Fetch（网页抓取）\",\n    description: \"官方 Python server，需要 uvx（pip install uv）\",\n    config: {\n      name: \"fetch\",\n      type: \"stdio\",\n      command: [\"uvx\", \"mcp-server-fetch\"],\n      enabled: true,\n    },\n  },\n  {\n    id: \"postgres\",\n    title: \"PostgreSQL（只读查询）\",\n    description: \"官方 postgres server（需要连接串）\",\n    config: {\n      name: \"postgres\",\n      type: \"stdio\",\n      command: [\n        \"npx\",\n        \"-y\",\n        \"@modelcontextprotocol/server-postgres\",\n        \"{{dsn}}\",\n      ],\n      enabled: true,\n    },\n    fields: [\n      {\n        key: \"dsn\",\n        label: \"连接串（postgresql://user:pass@host/db）\",\n        required: true,\n        secret: true,\n      },\n    ],\n  },\n  {\n    id: \"ocr\",\n    title: \"OCR（内置，开箱即用）\",\n    description:\n      \"进程内 OCR：macOS Vision / tesseract / 多模态模型自动降级，无需安装\",\n    config: {\n      name: \"ocr\",\n      type: \"builtin\",\n      builtin: \"ocr\",\n      enabled: true,\n    },\n  },\n];\n\nfunction replacePlaceholders(\n  value: string,\n  values: Record<string, string>,\n): string {\n  return value.replace(/\\{\\{([A-Za-z0-9_]+)\\}\\}/g, (_m, key: string) => {\n    return values[key] ?? \"\";\n  });\n}\n\n/** 用填写的占位符生成最终配置（不会修改模板对象） */\nexport function applyMcpPreset(\n  preset: McpPreset,\n  values: Record<string, string>,\n): McpServerConfig {\n  const base = preset.config;\n  const config: McpServerConfig = {\n    ...base,\n    name: base.name ?? preset.id,\n  };\n  if (config.command)\n    config.command = config.command.map((c) =>\n      replacePlaceholders(c, values),\n    );\n  if (config.url) config.url = replacePlaceholders(config.url, values);\n  if (config.cwd) config.cwd = replacePlaceholders(config.cwd, values);\n  if (config.env) {\n    config.env = Object.fromEntries(\n      Object.entries(config.env).map(([k, v]) => [\n        k,\n        replacePlaceholders(v, values),\n      ]),\n    );\n  }\n  if (config.headers) {\n    config.headers = Object.fromEntries(\n      Object.entries(config.headers).map(([k, v]) => [\n        k,\n        replacePlaceholders(v, values),\n      ]),\n    );\n  }\n  return config;\n}\n"],"mappings":"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","names":[]}

package/dist/internal/node-name.cjs

@@ -0,0 +1,45 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/node-name.ts
+var node_name_exports = {};
+__export(node_name_exports, {
+  defaultNodeLabel: () => defaultNodeLabel
+});
+module.exports = __toCommonJS(node_name_exports);
+var os = __toESM(require("os"), 1);
+function defaultNodeLabel() {
+  const name = os.hostname().trim();
+  return name || "zqagent-node";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defaultNodeLabel
+});
+//# sourceMappingURL=node-name.cjs.map

package/dist/internal/node-name.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/node-name.ts"],"sourcesContent":["/**\n * 节点显示名的默认值。\n *\n * 接入 Hub 时若没显式给 `--label`，用主机名：Hub 界面显示的是可读的机器名，\n * 而不是一串 nodeId。用户之后可在 Hub 界面或本机 `zqagent rename` 修改。\n */\nimport * as os from \"os\";\n\nexport function defaultNodeLabel(): string {\n  const name = os.hostname().trim();\n  return name || \"zqagent-node\";\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAoB;AAEb,SAAS,mBAA2B;AACzC,QAAM,OAAU,YAAS,EAAE,KAAK;AAChC,SAAO,QAAQ;AACjB;","names":[]}

package/dist/internal/node-name.d.cts

@@ -0,0 +1,3 @@
+declare function defaultNodeLabel(): string;
+
+export { defaultNodeLabel };

package/dist/internal/node-name.d.ts

@@ -0,0 +1,3 @@
+declare function defaultNodeLabel(): string;
+
+export { defaultNodeLabel };

package/dist/internal/node-name.js

@@ -0,0 +1,10 @@
+// src/node-name.ts
+import * as os from "os";
+function defaultNodeLabel() {
+  const name = os.hostname().trim();
+  return name || "zqagent-node";
+}
+export {
+  defaultNodeLabel
+};
+//# sourceMappingURL=node-name.js.map

package/dist/internal/node-name.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/node-name.ts"],"sourcesContent":["/**\n * 节点显示名的默认值。\n *\n * 接入 Hub 时若没显式给 `--label`，用主机名：Hub 界面显示的是可读的机器名，\n * 而不是一串 nodeId。用户之后可在 Hub 界面或本机 `zqagent rename` 修改。\n */\nimport * as os from \"os\";\n\nexport function defaultNodeLabel(): string {\n  const name = os.hostname().trim();\n  return name || \"zqagent-node\";\n}\n"],"mappings":";AAMA,YAAY,QAAQ;AAEb,SAAS,mBAA2B;AACzC,QAAM,OAAU,YAAS,EAAE,KAAK;AAChC,SAAO,QAAQ;AACjB;","names":[]}

package/dist/internal/paths.cjs

@@ -0,0 +1,63 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/paths.ts
+var paths_exports = {};
+__export(paths_exports, {
+  DEFAULT_DATA_DIR: () => DEFAULT_DATA_DIR,
+  DEFAULT_HUB_URL: () => DEFAULT_HUB_URL,
+  configDir: () => configDir,
+  stateDir: () => stateDir
+});
+module.exports = __toCommonJS(paths_exports);
+var os = __toESM(require("os"), 1);
+var path = __toESM(require("path"), 1);
+var APP_DIR_NAME = "zqagent";
+var DEFAULT_DATA_DIR = ".zqagent_data";
+var DEFAULT_HUB_URL = "https://hub.cd-zq.com";
+var IS_WINDOWS = process.platform === "win32";
+function homeDir() {
+  return process.env.HOME || process.env.USERPROFILE || os.homedir() || os.tmpdir();
+}
+function configDir() {
+  const base = process.env.XDG_CONFIG_HOME || (IS_WINDOWS ? process.env.APPDATA : void 0) || path.join(homeDir(), ".config");
+  return path.join(base, APP_DIR_NAME);
+}
+function stateDir() {
+  const base = process.env.XDG_STATE_HOME || (IS_WINDOWS ? process.env.LOCALAPPDATA : void 0) || path.join(homeDir(), ".local", "state");
+  return path.join(base, APP_DIR_NAME);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_DATA_DIR,
+  DEFAULT_HUB_URL,
+  configDir,
+  stateDir
+});
+//# sourceMappingURL=paths.cjs.map

package/dist/internal/paths.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/paths.ts"],"sourcesContent":["/**\n * 本机配置 / 状态目录的跨平台解析\n *\n * POSIX 沿用 XDG 约定；Windows 上 `HOME` 在 cmd / PowerShell 中通常不存在，\n * 若直接回退 `/tmp` 会把配置写到 `\\tmp\\...`（当前盘符根），且与\n * `%APPDATA%` 的常规位置不一致。统一顺序：显式 XDG 变量（用户显式指定，\n * 优先级最高）→ 平台原生目录 → XDG 默认位置（家目录）→ 临时目录。\n */\nimport * as os from \"os\";\nimport * as path from \"path\";\n\n/** 应用目录名（`~/.config/zqagent` 的最后一段） */\nconst APP_DIR_NAME = \"zqagent\";\n\n/**\n * 节点默认数据目录名（相对启动目录，即 `./.zqagent_data`）。\n * server / CLI 在既无 `--data-dir` 也无 `DATA_DIR` 时用它兜底，\n * 集中在此避免各处字面量走散。\n */\nexport const DEFAULT_DATA_DIR = \".zqagent_data\";\n\n/**\n * 官方 Hub 基址（不带结尾斜杠）：CLI 在既无 `--hub` 也无 `HUB_URL` 时用它兜底\n * （首个交互式接入提示的默认值）。自建 Hub 请用 `--hub` / `HUB_URL` 覆盖。\n */\nexport const DEFAULT_HUB_URL = \"https://hub.cd-zq.com\";\n\n/** 是否为 Windows（仅此处需要区分平台；APPDATA 在别的系统上可能是无关变量） */\nconst IS_WINDOWS = process.platform === \"win32\";\n\n/** 用户主目录：`HOME` → Windows `USERPROFILE` → `os.homedir()` → 临时目录 */\nfunction homeDir(): string {\n  return (\n    process.env.HOME || process.env.USERPROFILE || os.homedir() || os.tmpdir()\n  );\n}\n\n/** 配置目录：`$XDG_CONFIG_HOME/zqagent`、Windows `%APPDATA%\\zqagent`、其余 `~/.config/zqagent` */\nexport function configDir(): string {\n  const base =\n    process.env.XDG_CONFIG_HOME ||\n    (IS_WINDOWS ? process.env.APPDATA : undefined) ||\n    path.join(homeDir(), \".config\");\n  return path.join(base, APP_DIR_NAME);\n}\n\n/** 状态目录：`$XDG_STATE_HOME/zqagent`、Windows `%LOCALAPPDATA%\\zqagent`、其余 `~/.local/state/zqagent` */\nexport function stateDir(): string {\n  const base =\n    process.env.XDG_STATE_HOME ||\n    (IS_WINDOWS ? process.env.LOCALAPPDATA : undefined) ||\n    path.join(homeDir(), \".local\", \"state\");\n  return path.join(base, APP_DIR_NAME);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,SAAoB;AACpB,WAAsB;AAGtB,IAAM,eAAe;AAOd,IAAM,mBAAmB;AAMzB,IAAM,kBAAkB;AAG/B,IAAM,aAAa,QAAQ,aAAa;AAGxC,SAAS,UAAkB;AACzB,SACE,QAAQ,IAAI,QAAQ,QAAQ,IAAI,eAAkB,WAAQ,KAAQ,UAAO;AAE7E;AAGO,SAAS,YAAoB;AAClC,QAAM,OACJ,QAAQ,IAAI,oBACX,aAAa,QAAQ,IAAI,UAAU,WAC/B,UAAK,QAAQ,GAAG,SAAS;AAChC,SAAY,UAAK,MAAM,YAAY;AACrC;AAGO,SAAS,WAAmB;AACjC,QAAM,OACJ,QAAQ,IAAI,mBACX,aAAa,QAAQ,IAAI,eAAe,WACpC,UAAK,QAAQ,GAAG,UAAU,OAAO;AACxC,SAAY,UAAK,MAAM,YAAY;AACrC;","names":[]}

package/dist/internal/paths.d.cts

@@ -0,0 +1,17 @@
+/**
+ * 节点默认数据目录名（相对启动目录，即 `./.zqagent_data`）。
+ * server / CLI 在既无 `--data-dir` 也无 `DATA_DIR` 时用它兜底，
+ * 集中在此避免各处字面量走散。
+ */
+declare const DEFAULT_DATA_DIR = ".zqagent_data";
+/**
+ * 官方 Hub 基址（不带结尾斜杠）：CLI 在既无 `--hub` 也无 `HUB_URL` 时用它兜底
+ * （首个交互式接入提示的默认值）。自建 Hub 请用 `--hub` / `HUB_URL` 覆盖。
+ */
+declare const DEFAULT_HUB_URL = "https://hub.cd-zq.com";
+/** 配置目录：`$XDG_CONFIG_HOME/zqagent`、Windows `%APPDATA%\zqagent`、其余 `~/.config/zqagent` */
+declare function configDir(): string;
+/** 状态目录：`$XDG_STATE_HOME/zqagent`、Windows `%LOCALAPPDATA%\zqagent`、其余 `~/.local/state/zqagent` */
+declare function stateDir(): string;
+
+export { DEFAULT_DATA_DIR, DEFAULT_HUB_URL, configDir, stateDir };

package/dist/internal/paths.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 节点默认数据目录名（相对启动目录，即 `./.zqagent_data`）。
+ * server / CLI 在既无 `--data-dir` 也无 `DATA_DIR` 时用它兜底，
+ * 集中在此避免各处字面量走散。
+ */
+declare const DEFAULT_DATA_DIR = ".zqagent_data";
+/**
+ * 官方 Hub 基址（不带结尾斜杠）：CLI 在既无 `--hub` 也无 `HUB_URL` 时用它兜底
+ * （首个交互式接入提示的默认值）。自建 Hub 请用 `--hub` / `HUB_URL` 覆盖。
+ */
+declare const DEFAULT_HUB_URL = "https://hub.cd-zq.com";
+/** 配置目录：`$XDG_CONFIG_HOME/zqagent`、Windows `%APPDATA%\zqagent`、其余 `~/.config/zqagent` */
+declare function configDir(): string;
+/** 状态目录：`$XDG_STATE_HOME/zqagent`、Windows `%LOCALAPPDATA%\zqagent`、其余 `~/.local/state/zqagent` */
+declare function stateDir(): string;
+
+export { DEFAULT_DATA_DIR, DEFAULT_HUB_URL, configDir, stateDir };

package/dist/internal/paths.js

@@ -0,0 +1,25 @@
+// src/paths.ts
+import * as os from "os";
+import * as path from "path";
+var APP_DIR_NAME = "zqagent";
+var DEFAULT_DATA_DIR = ".zqagent_data";
+var DEFAULT_HUB_URL = "https://hub.cd-zq.com";
+var IS_WINDOWS = process.platform === "win32";
+function homeDir() {
+  return process.env.HOME || process.env.USERPROFILE || os.homedir() || os.tmpdir();
+}
+function configDir() {
+  const base = process.env.XDG_CONFIG_HOME || (IS_WINDOWS ? process.env.APPDATA : void 0) || path.join(homeDir(), ".config");
+  return path.join(base, APP_DIR_NAME);
+}
+function stateDir() {
+  const base = process.env.XDG_STATE_HOME || (IS_WINDOWS ? process.env.LOCALAPPDATA : void 0) || path.join(homeDir(), ".local", "state");
+  return path.join(base, APP_DIR_NAME);
+}
+export {
+  DEFAULT_DATA_DIR,
+  DEFAULT_HUB_URL,
+  configDir,
+  stateDir
+};
+//# sourceMappingURL=paths.js.map

package/dist/internal/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/paths.ts"],"sourcesContent":["/**\n * 本机配置 / 状态目录的跨平台解析\n *\n * POSIX 沿用 XDG 约定；Windows 上 `HOME` 在 cmd / PowerShell 中通常不存在，\n * 若直接回退 `/tmp` 会把配置写到 `\\tmp\\...`（当前盘符根），且与\n * `%APPDATA%` 的常规位置不一致。统一顺序：显式 XDG 变量（用户显式指定，\n * 优先级最高）→ 平台原生目录 → XDG 默认位置（家目录）→ 临时目录。\n */\nimport * as os from \"os\";\nimport * as path from \"path\";\n\n/** 应用目录名（`~/.config/zqagent` 的最后一段） */\nconst APP_DIR_NAME = \"zqagent\";\n\n/**\n * 节点默认数据目录名（相对启动目录，即 `./.zqagent_data`）。\n * server / CLI 在既无 `--data-dir` 也无 `DATA_DIR` 时用它兜底，\n * 集中在此避免各处字面量走散。\n */\nexport const DEFAULT_DATA_DIR = \".zqagent_data\";\n\n/**\n * 官方 Hub 基址（不带结尾斜杠）：CLI 在既无 `--hub` 也无 `HUB_URL` 时用它兜底\n * （首个交互式接入提示的默认值）。自建 Hub 请用 `--hub` / `HUB_URL` 覆盖。\n */\nexport const DEFAULT_HUB_URL = \"https://hub.cd-zq.com\";\n\n/** 是否为 Windows（仅此处需要区分平台；APPDATA 在别的系统上可能是无关变量） */\nconst IS_WINDOWS = process.platform === \"win32\";\n\n/** 用户主目录：`HOME` → Windows `USERPROFILE` → `os.homedir()` → 临时目录 */\nfunction homeDir(): string {\n  return (\n    process.env.HOME || process.env.USERPROFILE || os.homedir() || os.tmpdir()\n  );\n}\n\n/** 配置目录：`$XDG_CONFIG_HOME/zqagent`、Windows `%APPDATA%\\zqagent`、其余 `~/.config/zqagent` */\nexport function configDir(): string {\n  const base =\n    process.env.XDG_CONFIG_HOME ||\n    (IS_WINDOWS ? process.env.APPDATA : undefined) ||\n    path.join(homeDir(), \".config\");\n  return path.join(base, APP_DIR_NAME);\n}\n\n/** 状态目录：`$XDG_STATE_HOME/zqagent`、Windows `%LOCALAPPDATA%\\zqagent`、其余 `~/.local/state/zqagent` */\nexport function stateDir(): string {\n  const base =\n    process.env.XDG_STATE_HOME ||\n    (IS_WINDOWS ? process.env.LOCALAPPDATA : undefined) ||\n    path.join(homeDir(), \".local\", \"state\");\n  return path.join(base, APP_DIR_NAME);\n}\n"],"mappings":";AAQA,YAAY,QAAQ;AACpB,YAAY,UAAU;AAGtB,IAAM,eAAe;AAOd,IAAM,mBAAmB;AAMzB,IAAM,kBAAkB;AAG/B,IAAM,aAAa,QAAQ,aAAa;AAGxC,SAAS,UAAkB;AACzB,SACE,QAAQ,IAAI,QAAQ,QAAQ,IAAI,eAAkB,WAAQ,KAAQ,UAAO;AAE7E;AAGO,SAAS,YAAoB;AAClC,QAAM,OACJ,QAAQ,IAAI,oBACX,aAAa,QAAQ,IAAI,UAAU,WAC/B,UAAK,QAAQ,GAAG,SAAS;AAChC,SAAY,UAAK,MAAM,YAAY;AACrC;AAGO,SAAS,WAAmB;AACjC,QAAM,OACJ,QAAQ,IAAI,mBACX,aAAa,QAAQ,IAAI,eAAe,WACpC,UAAK,QAAQ,GAAG,UAAU,OAAO;AACxC,SAAY,UAAK,MAAM,YAAY;AACrC;","names":[]}