taskmeld 0.1.1 → 0.1.41

package/dist/src/cli/commands/pipeline.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.pipelineRoutes = exports.pipelineDiagnoseCommand = exports.pipelineRetryNodeCommand = exports.pipelineStopCommand = exports.pipelineWatchCommand = exports.pipelineStatusCommand = exports.pipelineStartCommand = exports.pipelineGetCommand = exports.pipelineListCommand = void 0;
 const errors_1 = require("../errors");
+const i18n_1 = require("../i18n");
 const errors_2 = require("./pipeline/errors");
 const result_1 = require("./pipeline/result");
 const selector_1 = require("./pipeline/selector");
@@ -146,56 +147,56 @@ exports.pipelineRoutes = [
     {
         key: "pipeline.list",
         path: ["pipeline", "list"],
-        description: "输出流水线列表",
+        description: (0, i18n_1.t)("pipeline.list.description"),
         handler: exports.pipelineListCommand,
         help: {
             usage: "taskmeld pipeline list [--format <json|md>]",
-            summary: "输出流水线列表",
+            summary: (0, i18n_1.t)("pipeline.list.summary"),
         },
     },
     {
         key: "pipeline.get",
         path: ["pipeline", "get"],
-        description: "输出指定流水线详情",
+        description: (0, i18n_1.t)("pipeline.get.description"),
         handler: exports.pipelineGetCommand,
         help: {
             usage: "taskmeld pipeline get <id> [--format <json|md>]",
-            args: [{ name: "id", required: true, description: "流水线 ID" }],
-            summary: "输出指定流水线详情",
+            args: [{ name: "id", required: true, description: (0, i18n_1.t)("pipeline.get.argId") }],
+            summary: (0, i18n_1.t)("pipeline.get.summary"),
         },
     },
     {
         key: "pipeline.start",
         path: ["pipeline", "start"],
-        description: "发起指定流水线运行（不承诺已完成）",
+        description: (0, i18n_1.t)("pipeline.start.description"),
         handler: exports.pipelineStartCommand,
         bootstrap: { runtimeApiOnly: true, ensureServerReady: true },
         help: {
             usage: "taskmeld pipeline start <pipelineId> [--watch] [--timeout <ms>] [--interval <ms>] [--format <json|md>]",
-            args: [{ name: "pipelineId", required: true, description: "流水线 ID" }],
+            args: [{ name: "pipelineId", required: true, description: (0, i18n_1.t)("pipeline.start.argPipelineId") }],
             options: [
-                { flags: ["--watch"], description: "启动后继续等待运行完成" },
-                { flags: ["--timeout"], valueName: "ms", description: "watch 超时时间，默认 600000" },
-                { flags: ["--interval"], valueName: "ms", description: "watch 轮询间隔，默认 1200" },
+                { flags: ["--watch"], description: (0, i18n_1.t)("pipeline.start.optWatch") },
+                { flags: ["--timeout"], valueName: "ms", description: (0, i18n_1.t)("pipeline.start.optTimeout") },
+                { flags: ["--interval"], valueName: "ms", description: (0, i18n_1.t)("pipeline.start.optInterval") },
             ],
             notes: [
-                "start 只负责发起运行请求，不承诺命令返回时业务已执行完成。",
-                "--watch 会在发起成功后进入等待流程。",
+                (0, i18n_1.t)("pipeline.start.noteOnlyStart"),
+                (0, i18n_1.t)("pipeline.start.noteWatch"),
             ],
         },
     },
     {
         key: "pipeline.status",
         path: ["pipeline", "status"],
-        description: "输出指定流水线当前运行状态",
+        description: (0, i18n_1.t)("pipeline.status.description"),
         handler: exports.pipelineStatusCommand,
         bootstrap: { runtimeApiOnly: true, ensureServerReady: true },
         help: {
             usage: "taskmeld pipeline status [<pipelineId>] [--run-id <id>] [--batch-run-id <id>] [--format <json|md>]",
-            args: [{ name: "pipelineId", description: "兼容入口，按流水线 ID 查询当前运行" }],
+            args: [{ name: "pipelineId", description: (0, i18n_1.t)("pipeline.status.argPipelineId") }],
             options: [
-                { flags: ["--run-id"], valueName: "id", description: "按单次运行 ID 精确查询" },
-                { flags: ["--batch-run-id"], valueName: "id", description: "按批跑 ID 精确查询" },
+                { flags: ["--run-id"], valueName: "id", description: (0, i18n_1.t)("pipeline.status.optRunId") },
+                { flags: ["--batch-run-id"], valueName: "id", description: (0, i18n_1.t)("pipeline.status.optBatchRunId") },
             ],
             examples: [
                 "taskmeld pipeline status A",
@@ -203,25 +204,25 @@ exports.pipelineRoutes = [
                 "taskmeld pipeline status A --batch-run-id batch:A:2026-05-08T18:34:08.978Z",
             ],
             notes: [
-                "需要至少提供 <pipelineId>、--run-id、--batch-run-id 之一。",
-                "未提供 selector 时，默认按 pipelineId 查询当前活动运行。",
+                (0, i18n_1.t)("pipeline.status.noteNeedSelector"),
+                (0, i18n_1.t)("pipeline.status.noteDefaultQuery"),
             ],
         },
     },
     {
         key: "pipeline.watch",
         path: ["pipeline", "watch"],
-        description: "监听指定流水线直到结束或超时",
+        description: (0, i18n_1.t)("pipeline.watch.description"),
         handler: exports.pipelineWatchCommand,
         bootstrap: { runtimeApiOnly: true, ensureServerReady: true },
         help: {
             usage: "taskmeld pipeline watch [<pipelineId>] [--run-id <id>] [--batch-run-id <id>] [--timeout <ms>] [--interval <ms>] [--format <json|md>]",
-            args: [{ name: "pipelineId", description: "兼容入口，监听该流水线当前运行" }],
+            args: [{ name: "pipelineId", description: (0, i18n_1.t)("pipeline.watch.argPipelineId") }],
             options: [
-                { flags: ["--run-id"], valueName: "id", description: "按单次运行 ID 精确监听" },
-                { flags: ["--batch-run-id"], valueName: "id", description: "按批跑 ID 精确监听" },
-                { flags: ["--timeout"], valueName: "ms", description: "watch 超时时间，默认 600000" },
-                { flags: ["--interval"], valueName: "ms", description: "watch 轮询间隔，默认 1200" },
+                { flags: ["--run-id"], valueName: "id", description: (0, i18n_1.t)("pipeline.watch.optRunId") },
+                { flags: ["--batch-run-id"], valueName: "id", description: (0, i18n_1.t)("pipeline.watch.optBatchRunId") },
+                { flags: ["--timeout"], valueName: "ms", description: (0, i18n_1.t)("pipeline.watch.optTimeout") },
+                { flags: ["--interval"], valueName: "ms", description: (0, i18n_1.t)("pipeline.watch.optInterval") },
             ],
             examples: [
                 "taskmeld pipeline watch A",
@@ -229,68 +230,68 @@ exports.pipelineRoutes = [
                 "taskmeld pipeline watch --batch-run-id batch:A:2026-05-08T18:34:08.978Z --timeout 900000",
             ],
             notes: [
-                "watch 是监听命令，不负责发起新运行。",
-                "需要至少提供 <pipelineId>、--run-id、--batch-run-id 之一。",
-                "当前 watch 语义为事件流优先，轮询作为兜底路径。",
+                (0, i18n_1.t)("pipeline.watch.noteIsWatch"),
+                (0, i18n_1.t)("pipeline.watch.noteNeedSelector"),
+                (0, i18n_1.t)("pipeline.watch.notePollingFallback"),
             ],
         },
     },
     {
         key: "pipeline.stop",
         path: ["pipeline", "stop"],
-        description: "停止指定流水线批跑任务",
+        description: (0, i18n_1.t)("pipeline.stop.description"),
         handler: exports.pipelineStopCommand,
         bootstrap: { runtimeApiOnly: true, ensureServerReady: true },
         help: {
             usage: "taskmeld pipeline stop [<pipelineId>] [--run-id <id>] [--batch-run-id <id>] [--format <json|md>]",
-            args: [{ name: "pipelineId", description: "兼容入口，停止该流水线当前运行" }],
+            args: [{ name: "pipelineId", description: (0, i18n_1.t)("pipeline.stop.argPipelineId") }],
             options: [
-                { flags: ["--run-id"], valueName: "id", description: "按单次运行 ID 精确停止" },
-                { flags: ["--batch-run-id"], valueName: "id", description: "按批跑 ID 精确停止" },
+                { flags: ["--run-id"], valueName: "id", description: (0, i18n_1.t)("pipeline.stop.optRunId") },
+                { flags: ["--batch-run-id"], valueName: "id", description: (0, i18n_1.t)("pipeline.stop.optBatchRunId") },
             ],
             notes: [
-                "需要至少提供 <pipelineId>、--run-id、--batch-run-id 之一。",
-                "当前 stop 主要用于停止批跑任务。",
-                "对非批跑运行会返回业务错误，而不是静默成功。",
+                (0, i18n_1.t)("pipeline.stop.noteNeedSelector"),
+                (0, i18n_1.t)("pipeline.stop.noteBatchOnly"),
+                (0, i18n_1.t)("pipeline.stop.noteNonBatch"),
             ],
         },
     },
     {
         key: "pipeline.retry-node",
         path: ["pipeline", "retry-node"],
-        description: "重试指定节点或节点条目",
+        description: (0, i18n_1.t)("pipeline.retryNode.description"),
         handler: exports.pipelineRetryNodeCommand,
         bootstrap: { gateway: "required" },
         help: {
             usage: "taskmeld pipeline retry-node <pipelineId> <nodeId> [--item <itemKey>] [--format <json|md>]",
             args: [
-                { name: "pipelineId", required: true, description: "流水线 ID" },
-                { name: "nodeId", required: true, description: "节点 ID" },
+                { name: "pipelineId", required: true, description: (0, i18n_1.t)("pipeline.retryNode.argPipelineId") },
+                { name: "nodeId", required: true, description: (0, i18n_1.t)("pipeline.retryNode.argNodeId") },
             ],
-            options: [{ flags: ["--item"], valueName: "itemKey", description: "指定重试的条目键" }],
-            summary: "重试指定节点或节点条目",
+            options: [{ flags: ["--item"], valueName: "itemKey", description: (0, i18n_1.t)("pipeline.retryNode.optItem") }],
+            summary: (0, i18n_1.t)("pipeline.retryNode.summary"),
         },
     },
     {
         key: "pipeline.diagnose",
         path: ["pipeline", "diagnose"],
-        description: "诊断指定节点依赖状态，输出阻塞原因",
+        description: (0, i18n_1.t)("pipeline.diagnose.description"),
         handler: exports.pipelineDiagnoseCommand,
         bootstrap: { runtimeApiOnly: true, ensureServerReady: true },
         help: {
             usage: "taskmeld pipeline diagnose <pipelineId> <nodeId> [--item <itemKey>] [--format <json|md>]",
             args: [
-                { name: "pipelineId", required: true, description: "流水线 ID" },
-                { name: "nodeId", required: true, description: "节点 ID" },
+                { name: "pipelineId", required: true, description: (0, i18n_1.t)("pipeline.diagnose.argPipelineId") },
+                { name: "nodeId", required: true, description: (0, i18n_1.t)("pipeline.diagnose.argNodeId") },
             ],
-            options: [{ flags: ["--item"], valueName: "itemKey", description: "可选，指定条目键精确诊断" }],
-            summary: "诊断指定节点依赖状态，输出阻塞原因",
+            options: [{ flags: ["--item"], valueName: "itemKey", description: (0, i18n_1.t)("pipeline.diagnose.optItem") }],
+            summary: (0, i18n_1.t)("pipeline.diagnose.summary"),
         },
     },
     {
         key: "pipeline.output",
         path: ["pipeline", "output"],
-        description: "查询流水线最终产物",
+        description: (0, i18n_1.t)("pipeline.output.description"),
         handler: async (input, ctx) => {
             const pipelineId = (0, errors_1.assertRequiredArg)(input.args[0], "pipelineId");
             const runId = (0, selector_1.pickOptionalStringFlag)(input.flags.run);
@@ -303,28 +304,28 @@ exports.pipelineRoutes = [
         },
         help: {
             usage: "taskmeld pipeline output <pipelineId> [--run <runId>]",
-            args: [{ name: "pipelineId", required: true, description: "流水线 ID" }],
-            options: [{ flags: ["--run"], valueName: "runId", description: "按 runId 精确查询" }],
-            summary: "查询流水线最终产物",
+            args: [{ name: "pipelineId", required: true, description: (0, i18n_1.t)("pipeline.output.argPipelineId") }],
+            options: [{ flags: ["--run"], valueName: "runId", description: (0, i18n_1.t)("pipeline.output.optRun") }],
+            summary: (0, i18n_1.t)("pipeline.output.summary"),
         },
     },
     {
         key: "pipeline.link-list",
         path: ["pipeline", "link", "list"],
-        description: "列出所有流水线投递链接",
+        description: (0, i18n_1.t)("pipeline.linkList.description"),
         handler: async (_input, ctx) => {
             const links = await ctx.app.pipelineService.listLinks();
             return { ok: true, items: links };
         },
         help: {
             usage: "taskmeld pipeline link list",
-            summary: "列出所有流水线投递链接",
+            summary: (0, i18n_1.t)("pipeline.linkList.summary"),
         },
     },
     {
         key: "pipeline.queue",
         path: ["pipeline", "queue"],
-        description: "查询流水线接收队列",
+        description: (0, i18n_1.t)("pipeline.queue.description"),
         handler: async (input, ctx) => {
             const pipelineId = (0, errors_1.assertRequiredArg)(input.args[0], "pipelineId");
             const items = ctx.app.pipelineService.getQueue(pipelineId);
@@ -332,8 +333,8 @@ exports.pipelineRoutes = [
         },
         help: {
             usage: "taskmeld pipeline queue <pipelineId>",
-            args: [{ name: "pipelineId", required: true, description: "流水线 ID" }],
-            summary: "查询流水线接收队列",
+            args: [{ name: "pipelineId", required: true, description: (0, i18n_1.t)("pipeline.queue.argPipelineId") }],
+            summary: (0, i18n_1.t)("pipeline.queue.summary"),
         },
     },
 ];

package/dist/src/cli/commands/scheduler.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.schedulerRoutes = exports.schedulerModeCommand = exports.schedulerToggleCommand = void 0;
 const errors_1 = require("../errors");
+const i18n_1 = require("../i18n");
 const assertSchedulerMode = (value) => {
     if (typeof value === "string") {
         const normalized = value.trim().toLowerCase();
@@ -57,25 +58,25 @@ exports.schedulerRoutes = [
     {
         key: "scheduler.toggle",
         path: ["scheduler", "toggle"],
-        description: "启用或停用调度器",
+        description: (0, i18n_1.t)("scheduler.toggle.description"),
         handler: exports.schedulerToggleCommand,
         help: {
             usage: "taskmeld scheduler toggle <pipelineId> --enabled <true|false> [--format <json|md>]",
-            args: [{ name: "pipelineId", required: true, description: "流水线 ID" }],
-            options: [{ flags: ["--enabled"], valueName: "true|false", required: true, description: "是否启用调度器" }],
-            notes: ["<pipelineId> 与 --enabled 均为必填控制项。"],
+            args: [{ name: "pipelineId", required: true, description: (0, i18n_1.t)("scheduler.toggle.argPipelineId") }],
+            options: [{ flags: ["--enabled"], valueName: "true|false", required: true, description: (0, i18n_1.t)("scheduler.toggle.optEnabled") }],
+            notes: [(0, i18n_1.t)("scheduler.toggle.note")],
         },
     },
     {
         key: "scheduler.mode",
         path: ["scheduler", "mode"],
-        description: "切换调度器模式",
+        description: (0, i18n_1.t)("scheduler.mode.description"),
         handler: exports.schedulerModeCommand,
         help: {
             usage: "taskmeld scheduler mode <pipelineId> --mode <auto|manual> [--format <json|md>]",
-            args: [{ name: "pipelineId", required: true, description: "流水线 ID" }],
-            options: [{ flags: ["--mode"], valueName: "auto|manual", required: true, description: "调度器模式" }],
-            notes: ["<pipelineId> 与 --mode 均为必填控制项。"],
+            args: [{ name: "pipelineId", required: true, description: (0, i18n_1.t)("scheduler.mode.argPipelineId") }],
+            options: [{ flags: ["--mode"], valueName: "auto|manual", required: true, description: (0, i18n_1.t)("scheduler.mode.optMode") }],
+            notes: [(0, i18n_1.t)("scheduler.mode.note")],
         },
     },
 ];

package/dist/src/cli/commands/server.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.serverRoutes = exports.serverStopCommand = exports.serverStatusCommand = exports.serverStartCommand = exports.serverEnsureCommand = void 0;
+const i18n_1 = require("../i18n");
 const serverEnsureCommand = async (_input, ctx) => {
     return ctx.app.serverService.ensureServerReady();
 };
@@ -21,50 +22,50 @@ exports.serverRoutes = [
     {
         key: "server.ensure",
         path: ["server", "ensure"],
-        description: "确保本地控制面后端已启动并健康",
+        description: (0, i18n_1.t)("server.ensure.description"),
         handler: exports.serverEnsureCommand,
         bootstrap: { runtimeApiOnly: true },
         help: {
             usage: "taskmeld server ensure [--format <json|md>]",
-            summary: "确保本地 control-plane daemon 已启动并健康",
+            summary: (0, i18n_1.t)("server.ensure.summary"),
             notes: [
-                "daemon-first 语义：优先复用已存在且健康的本地实例。",
-                "仅在没有可复用健康实例时，才会启动新的 daemon。",
+                (0, i18n_1.t)("server.ensure.noteDaemonFirst"),
+                (0, i18n_1.t)("server.ensure.noteNewDaemon"),
             ],
         },
     },
     {
         key: "server.start",
         path: ["server", "start"],
-        description: "显式启动本地控制面后端",
+        description: (0, i18n_1.t)("server.start.description"),
         handler: exports.serverStartCommand,
         bootstrap: { runtimeApiOnly: true },
         help: {
             usage: "taskmeld server start [--format <json|md>]",
-            summary: "显式启动本地 control-plane daemon",
+            summary: (0, i18n_1.t)("server.start.summary"),
         },
     },
     {
         key: "server.status",
         path: ["server", "status"],
-        description: "输出本地控制面后端状态",
+        description: (0, i18n_1.t)("server.status.description"),
         handler: exports.serverStatusCommand,
         bootstrap: { runtimeApiOnly: true },
         help: {
             usage: "taskmeld server status [--format <json|md>]",
-            summary: "查看本地 control-plane daemon 的健康、ownership 与 pid 信息",
-            notes: ["状态输出用于确认本地 daemon 是否可复用以及当前 owner 元数据是否一致。"],
+            summary: (0, i18n_1.t)("server.status.summary"),
+            notes: [(0, i18n_1.t)("server.status.note")],
         },
     },
     {
         key: "server.stop",
         path: ["server", "stop"],
-        description: "停止本地控制面后端",
+        description: (0, i18n_1.t)("server.stop.description"),
         handler: exports.serverStopCommand,
         bootstrap: { runtimeApiOnly: true },
         help: {
             usage: "taskmeld server stop [--format <json|md>]",
-            summary: "停止本地 control-plane daemon",
+            summary: (0, i18n_1.t)("server.stop.summary"),
         },
     },
 ];

package/dist/src/cli/commands/system.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.systemRoutes = exports.systemSnapshotCommand = void 0;
+const i18n_1 = require("../i18n");
 const systemSnapshotCommand = async (_input, ctx) => {
-    // 系统快照由主线 service 层提供，CLI 只做编排与输出。
+    // The system snapshot is provided by the mainline service layer; the CLI only handles orchestration and output.
     return ctx.app.systemService.getSnapshot();
 };
 exports.systemSnapshotCommand = systemSnapshotCommand;
@@ -10,12 +11,12 @@ exports.systemRoutes = [
     {
         key: "system.snapshot",
         path: ["system", "snapshot"],
-        description: "输出系统全局快照",
+        description: (0, i18n_1.t)("system.snapshot.description"),
         handler: exports.systemSnapshotCommand,
         bootstrap: { gateway: "warmup" },
         help: {
             usage: "taskmeld system snapshot [--format <json|md>]",
-            summary: "输出系统全局快照",
+            summary: (0, i18n_1.t)("system.snapshot.summary"),
         },
     },
 ];

package/dist/src/cli/errors.js

@@ -14,7 +14,7 @@ class CliError extends Error {
     }
 }
 exports.CliError = CliError;
-// 统一把未知异常规范化，避免 CLI 输出结构漂移。
+// Unify unknown exception normalization to prevent CLI output structure drift.
 const toCliError = (error) => {
     if (error instanceof CliError)
         return error;
@@ -31,7 +31,7 @@ const toCliError = (error) => {
     });
 };
 exports.toCliError = toCliError;
-// 在不改动原错误元信息的前提下，为参数类错误附加帮助提示。
+// Without altering the original error metadata, attach a help hint to argument-type errors.
 const withHelpHint = (error, hint) => {
     if (!hint.trim())
         return error;

package/dist/src/cli/help.js

@@ -1,21 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveHelpHintByRouteKey = exports.resolveHelpHint = exports.resolveHelp = void 0;
-const ROOT_USAGE = "taskmeld <resource> <action> [args] [--flags]";
+const i18n_1 = require("./i18n");
+const ROOT_USAGE = (0, i18n_1.t)("help.usage");
 const GROUP_DESCRIPTIONS = {
-    agent: "智能体管理",
-    artifact: "产物管理",
-    init: "First-time setup",
-    pipeline: "流水线管理",
-    scheduler: "调度控制",
-    server: "后端服务管理",
-    system: "系统信息",
+    agent: (0, i18n_1.t)("help.groups.agent"),
+    artifact: (0, i18n_1.t)("help.groups.artifact"),
+    init: (0, i18n_1.t)("help.groups.init"),
+    pipeline: (0, i18n_1.t)("help.groups.pipeline"),
+    scheduler: (0, i18n_1.t)("help.groups.scheduler"),
+    server: (0, i18n_1.t)("help.groups.server"),
+    system: (0, i18n_1.t)("help.groups.system"),
 };
 const COMMON_OPTIONS_LINES = [
-    "Common Options:",
-    "  -f, --format <json|md>  输出格式（默认: md）",
-    "  --envelope              仅与 --format json 搭配可用，输出完整包装层",
-    "  -h, --help      显示当前命令帮助",
+    (0, i18n_1.t)("help.commonOptions.title"),
+    `  -f, --format <json|md>  ${(0, i18n_1.t)("help.commonOptions.format")}`,
+    `  --envelope              ${(0, i18n_1.t)("help.commonOptions.envelope")}`,
+    `  -h, --help      ${(0, i18n_1.t)("help.commonOptions.help")}`,
 ];
 const listPublicRoutes = (routes) => {
     return routes.filter((route) => route.hidden !== true);
@@ -38,7 +39,7 @@ const formatArgsBlock = (args) => {
         "Arguments:",
         ...args.map((item) => {
             const printableName = item.name.startsWith("<") ? item.name : `<${item.name}>`;
-            const requiredLabel = item.required ? "必填" : "可选";
+            const requiredLabel = item.required ? (0, i18n_1.t)("help.label.required") : (0, i18n_1.t)("help.label.optional");
             const detail = item.description ? `，${item.description}` : "";
             return `  ${printableName}  ${requiredLabel}${detail}`;
         }),
@@ -52,7 +53,7 @@ const formatOptionsBlock = (options) => {
         ...options.map((item) => {
             const flagName = item.flags.join(", ");
             const valueHint = item.valueName ? ` <${item.valueName}>` : "";
-            const requiredLabel = item.required ? "必填" : "可选";
+            const requiredLabel = item.required ? (0, i18n_1.t)("help.label.required") : (0, i18n_1.t)("help.label.optional");
             const detail = item.description ? `，${item.description}` : "";
             return `  ${flagName}${valueHint}  ${requiredLabel}${detail}`;
         }),
@@ -84,8 +85,8 @@ const renderRoot = (routes) => {
         }),
         "",
         "Tips:",
-        "  taskmeld <resource> -h         查看一级命令帮助",
-        "  taskmeld <resource> <action> -h  查看二级命令帮助",
+        `  taskmeld <resource> -h         ${(0, i18n_1.t)("help.tips.groupHelp")}`,
+        `  taskmeld <resource> <action> -h  ${(0, i18n_1.t)("help.tips.commandHelp")}`,
     ];
     return lines.join("\n");
 };
@@ -127,7 +128,7 @@ const renderAutoCommandHelp = (route) => {
     return lines.join("\n");
 };
 const renderCommand = (route) => {
-    // 保留特例出口是为了兼容未来极少数需要完全自定义排版的命令；默认路径必须使用路由元数据生成。
+    // This special-case exit point exists for future compatibility with the very few commands that require fully custom layout; the default path must use route metadata generation.
     const text = route.renderHelp ? route.renderHelp(route) : renderAutoCommandHelp(route);
     const lines = text.split("\n");
     appendCommonOptions(lines);

package/dist/src/cli/i18n.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.changeLocale = exports.t = void 0;
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const node_fs_1 = require("node:fs");
+const i18next_1 = __importDefault(require("i18next"));
+const zh_json_1 = __importDefault(require("./locales/zh.json"));
+const en_json_1 = __importDefault(require("./locales/en.json"));
+const resolveLocale = () => {
+    // 1. env override
+    const envLocale = process.env.TASKMELD_LOCALE?.trim();
+    if (envLocale && ["zh", "en"].includes(envLocale))
+        return envLocale;
+    // 2. config.json
+    try {
+        const configPath = (0, node_path_1.join)((0, node_os_1.homedir)(), ".taskmeld", "config.json");
+        const raw = (0, node_fs_1.readFileSync)(configPath, "utf8");
+        const config = JSON.parse(raw);
+        if (config.locale && ["zh", "en"].includes(config.locale)) {
+            return config.locale;
+        }
+    }
+    catch {
+        // config file not found or invalid, fall through
+    }
+    return "en";
+};
+i18next_1.default.init({
+    lng: resolveLocale(),
+    resources: {
+        zh: { cli: zh_json_1.default },
+        en: { cli: en_json_1.default },
+    },
+    defaultNS: "cli",
+    fallbackLng: "en",
+    interpolation: { escapeValue: false },
+});
+exports.t = i18next_1.default.t.bind(i18next_1.default);
+const changeLocale = async (locale) => {
+    await i18next_1.default.changeLanguage(locale);
+};
+exports.changeLocale = changeLocale;