helixlife-expert-cli 0.1.0

package/cli/dist/modules/shared/workflow-app/run.js

@@ -0,0 +1,71 @@
+// 工作流执行：POST SSE，按 output id 收集结果
+import { ApiClient, collectOutputs, extractRecordId, helixlifeError, helixlifeErrorCode, } from "../../../core/index.js";
+import { buildWorkflowAppHeaders, WORKFLOW_APP_EXECUTE_PATH, WORKFLOW_APP_RESPONSE_MODE, } from "./constants.js";
+/** 终端事件：正常结束发 end_message，流关闭发 done */
+const TERMINAL_EVENTS = new Set(["end_message", "done"]);
+/** 后端把业务失败放在 error 事件里，HTTP 状态仍为 200，必须逐条检查 */
+function assertNoErrorEvent(events) {
+    for (const event of events) {
+        if (event.event !== "error") {
+            continue;
+        }
+        const message = (typeof event.message === "string" && event.message) ||
+            (typeof event.err_msg === "string" && event.err_msg) ||
+            "工作流执行失败";
+        throw new helixlifeError(helixlifeErrorCode.REQUEST_FAILED, message);
+    }
+}
+export async function executeWorkflow(options) {
+    const client = new ApiClient();
+    const events = [];
+    let received = 0;
+    const body = {
+        app_id: options.source,
+        app_name: options.appName,
+        response_mode: WORKFLOW_APP_RESPONSE_MODE,
+        query: options.query,
+    };
+    await client.requestSse(WORKFLOW_APP_EXECUTE_PATH, {
+        method: "POST",
+        body,
+        headers: buildWorkflowAppHeaders(options.source),
+    }, (payload) => {
+        events.push(payload);
+        if (typeof payload.answer === "string") {
+            received += payload.answer.length;
+            options.onProgress?.(received);
+        }
+    });
+    assertNoErrorEvent(events);
+    if (!events.some((event) => TERMINAL_EVENTS.has(String(event.event)))) {
+        throw new helixlifeError(helixlifeErrorCode.INVALID_RESPONSE, "SSE 流未收到结束事件，生成可能被中断");
+    }
+    const outputs = collectOutputs(events);
+    if (!Object.values(outputs).some((value) => value.trim())) {
+        throw new helixlifeError(helixlifeErrorCode.INVALID_RESPONSE, "工作流未返回任何输出内容");
+    }
+    return { outputs, recordId: extractRecordId(events) };
+}
+/**
+ * 按表单声明的 outputs 顺序拼 Markdown。
+ * 以 outputs 为准而非 SSE 顺序，保证同一工作流每次交付结构一致。
+ */
+export function renderOutputsAsMarkdown(outputs, declared) {
+    const ordered = declared.length
+        ? declared.map((item) => item.id)
+        : Object.keys(outputs);
+    const seen = new Set(ordered);
+    const extras = Object.keys(outputs).filter((id) => !seen.has(id));
+    const labels = new Map(declared.map((item) => [item.id, item.titleProps?.label?.trim() || item.id]));
+    return [...ordered, ...extras]
+        .map((id) => {
+        const content = outputs[id]?.trim();
+        if (!content) {
+            return "";
+        }
+        return `## ${labels.get(id) ?? id}\n\n${content}`;
+    })
+        .filter(Boolean)
+        .join("\n\n");
+}
+//# sourceMappingURL=run.js.map

package/cli/dist/modules/shared/workflow-app/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../../src/modules/shared/workflow-app/run.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,OAAO,EACL,SAAS,EACT,cAAc,EACd,eAAe,EACf,cAAc,EACd,kBAAkB,GAEnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAQxB,uCAAuC;AACvC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;AAEzD,+CAA+C;AAC/C,SAAS,kBAAkB,CAAC,MAAwB;IAClD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YAC5B,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GACX,CAAC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC;YACpD,CAAC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC;YACpD,SAAS,CAAC;QACZ,MAAM,IAAI,cAAc,CAAC,kBAAkB,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;AACH,CAAC;AAUD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAA+B;IAE/B,MAAM,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,MAAM,IAAI,GAAwB;QAChC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE,OAAO,CAAC,OAAO;QACzB,aAAa,EAAE,0BAA0B;QACzC,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC;IAEF,MAAM,MAAM,CAAC,UAAU,CACrB,yBAAyB,EACzB;QACE,MAAM,EAAE,MAAM;QACd,IAAI;QACJ,OAAO,EAAE,uBAAuB,CAAC,OAAO,CAAC,MAAM,CAAC;KACjD,EACD,CAAC,OAAO,EAAE,EAAE;QACV,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrB,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACvC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;YAClC,OAAO,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CACF,CAAC;IAEF,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE3B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,cAAc,CACtB,kBAAkB,CAAC,gBAAgB,EACnC,sBAAsB,CACvB,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,cAAc,CACtB,kBAAkB,CAAC,gBAAgB,EACnC,cAAc,CACf,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAA+B,EAC/B,QAA0B;IAE1B,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM;QAC7B,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAC7E,CAAC;IAEF,OAAO,CAAC,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC;SAC3B,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QACV,MAAM,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,OAAO,EAAE,CAAC;IACpD,CAAC,CAAC;SACD,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC"}

package/cli/dist/modules/shared/workflow-app/types.d.ts

@@ -0,0 +1,74 @@
+/** 表单字段类型；后端可能新增类型，故保留 string 兜底 */
+export type WorkflowFieldType = "textarea" | "input" | "select" | "hidden" | (string & {});
+export interface WorkflowSelectOption {
+    label: string;
+    value: string;
+}
+/** 动态表单字段 */
+export interface WorkflowComponent {
+    id: string;
+    type: WorkflowFieldType;
+    /** 后端必填标记；缺省视为选填（与 application 模块的默认必填相反，以线上表单为准） */
+    notNull?: boolean;
+    hidden?: boolean;
+    value?: unknown;
+    titleProps?: {
+        label?: string;
+        icon?: string;
+    };
+    props?: {
+        maxLength?: number;
+        placeholder?: string;
+        showCount?: boolean;
+        defaultValue?: string;
+        options?: WorkflowSelectOption[];
+    };
+}
+/** 输出字段声明，决定结果的展示顺序与标题 */
+export interface WorkflowOutput {
+    id: string;
+    type?: string;
+    titleProps?: {
+        label?: string;
+        icon?: string;
+    };
+}
+/** GET 返回的工作流配置 */
+export interface WorkflowConfig {
+    id: string;
+    components: WorkflowComponent[];
+    outputs: WorkflowOutput[];
+    export_as?: string[];
+    workflow?: {
+        node_index?: number;
+        progress_time?: number | null;
+    }[];
+}
+/** 单个提交字段；后端要求 query 为对象而非字符串 */
+export interface WorkflowQueryField {
+    type: string;
+    content: string;
+}
+export type WorkflowQuery = Record<string, WorkflowQueryField>;
+/** POST 执行请求体，四个字段均为必填 */
+export interface WorkflowExecuteBody {
+    app_id: string;
+    app_name: string;
+    response_mode: "streaming";
+    query: WorkflowQuery;
+}
+/** SSE 执行结果 */
+export interface WorkflowExecuteResult {
+    /** 按 output id 分组的原始正文 */
+    outputs: Record<string, string>;
+    recordId?: string;
+}
+/**
+ * anyOf 约束：组内字段至少填一项。
+ * 后端对这类字段的 notNull 均为 false，只在运行期报错，故在 CLI 侧前置拦截。
+ */
+export interface WorkflowAnyOfGroup {
+    fields: string[];
+    message: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/cli/dist/modules/shared/workflow-app/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/modules/shared/workflow-app/types.ts"],"names":[],"mappings":"AAEA,oCAAoC;AACpC,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,aAAa;AACb,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iBAAiB,CAAC;IACxB,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,KAAK,CAAC,EAAE;QACN,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,oBAAoB,EAAE,CAAC;KAClC,CAAC;CACH;AAED,0BAA0B;AAC1B,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAED,mBAAmB;AACnB,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,EAAE,CAAC;CACrE;AAED,iCAAiC;AACjC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAE/D,0BAA0B;AAC1B,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,WAAW,CAAC;IAC3B,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,eAAe;AACf,MAAM,WAAW,qBAAqB;IACpC,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/cli/dist/modules/shared/workflow-app/types.js

@@ -0,0 +1,3 @@
+// AI 应用工作流的动态表单与执行结构，字段名对齐后端 GET 返回
+export {};
+//# sourceMappingURL=types.js.map

package/cli/dist/modules/shared/workflow-app/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/modules/shared/workflow-app/types.ts"],"names":[],"mappings":"AAAA,oCAAoC"}

package/cli/dist/modules/site-configs.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from "commander";
+export declare const WORKBENCH_SITE_CONFIGS_PATH: "agent/v1/ai/workbench/site-configs";
+export declare function registerSiteConfigsCommand(program: Command): void;
+//# sourceMappingURL=site-configs.d.ts.map

package/cli/dist/modules/site-configs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-configs.d.ts","sourceRoot":"","sources":["../../src/modules/site-configs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,eAAO,MAAM,2BAA2B,EACtC,oCAA6C,CAAC;AAGhD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuBjE"}

package/cli/dist/modules/site-configs.js

@@ -0,0 +1,21 @@
+import { ApiClient, emitJson, unwrapApiData, } from "../core/index.js";
+export const WORKBENCH_SITE_CONFIGS_PATH = "agent/v1/ai/workbench/site-configs";
+// 顶层共享门禁：meta 等工作台类专家在业务命令前统一探测
+export function registerSiteConfigsCommand(program) {
+    program
+        .command("site-configs")
+        .description("探测工作台业务 API 是否可用（GET site-configs，仅判通不通，不输出列表数据）")
+        // 与业务命令对齐：接受 --format=json，避免 Agent 按全局约定附加后报 unknown option
+        .option("--format <format>", "输出格式：markdown | json（本命令固定 JSON）", "json")
+        .action(async () => {
+        const client = new ApiClient();
+        const response = await client.request(WORKBENCH_SITE_CONFIGS_PATH, { method: "GET" });
+        // 与项目其他接口一致：仅 success === false 视为失败（见 unwrapApiData）
+        unwrapApiData(response, "工作台接口探测");
+        emitJson({
+            ok: true,
+            message: "success",
+        });
+    });
+}
+//# sourceMappingURL=site-configs.js.map

package/cli/dist/modules/site-configs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-configs.js","sourceRoot":"","sources":["../../src/modules/site-configs.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,SAAS,EACT,QAAQ,EACR,aAAa,GAEd,MAAM,kBAAkB,CAAC;AAE1B,MAAM,CAAC,MAAM,2BAA2B,GACtC,oCAA6C,CAAC;AAEhD,gCAAgC;AAChC,MAAM,UAAU,0BAA0B,CAAC,OAAgB;IACzD,OAAO;SACJ,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CACV,kDAAkD,CACnD;QACD,6DAA6D;SAC5D,MAAM,CAAC,mBAAmB,EAAE,kCAAkC,EAAE,MAAM,CAAC;SACvE,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CACnC,2BAA2B,EAC3B,EAAE,MAAM,EAAE,KAAK,EAAE,CAClB,CAAC;QAEF,sDAAsD;QACtD,aAAa,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAEnC,QAAQ,CAAC;YACP,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,SAAS;SACnB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}

package/cli/dist/modules/upgrade/index.d.ts

@@ -0,0 +1,6 @@
+import type { Command } from "commander";
+export declare function compareSemver(a: string, b: string): number;
+export declare function fetchRegistryVersion(): Promise<string>;
+export declare function installLatestCli(): Promise<void>;
+export declare function registerUpgradeCommand(program: Command): void;
+//# sourceMappingURL=index.d.ts.map

package/cli/dist/modules/upgrade/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/upgrade/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAiB1D;AAGD,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,CAa5D;AAGD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKtD;AAGD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgE7D"}

package/cli/dist/modules/upgrade/index.js

@@ -0,0 +1,105 @@
+// helixlife-expert upgrade：检查 npm registry 版本并按需全局升级 CLI。
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { emitJson, getPackageVersion } from "../../core/index.js";
+const execAsync = promisify(exec);
+const NPM_PACKAGE_NAME = "helixlife-expert-cli";
+// 比较 semver 版本号：a < b 返回 -1，相等返回 0，a > b 返回 1
+export function compareSemver(a, b) {
+    const parse = (version) => version
+        .trim()
+        .replace(/^v/, "")
+        .split(".")
+        .map((part) => Number.parseInt(part, 10) || 0);
+    const left = parse(a);
+    const right = parse(b);
+    const length = Math.max(left.length, right.length);
+    for (let i = 0; i < length; i += 1) {
+        const diff = (left[i] ?? 0) - (right[i] ?? 0);
+        if (diff !== 0)
+            return diff > 0 ? 1 : -1;
+    }
+    return 0;
+}
+// 查询 npm registry 上的最新版本号（强制在线校验，避免命中过期 packument 缓存）
+export async function fetchRegistryVersion() {
+    const { stdout } = await execAsync(`npm view ${NPM_PACKAGE_NAME} dist-tags.latest --prefer-online --prefer-offline=false`, {
+        encoding: "utf-8",
+        windowsHide: true,
+    });
+    const version = stdout.trim();
+    if (!version) {
+        throw new Error("无法获取 npm registry 版本");
+    }
+    return version;
+}
+// 全局安装最新版 CLI
+export async function installLatestCli() {
+    await execAsync(`npm install -g ${NPM_PACKAGE_NAME}@latest`, {
+        encoding: "utf-8",
+        windowsHide: true,
+    });
+}
+// 注册 helixlife-expert upgrade 命令
+export function registerUpgradeCommand(program) {
+    program
+        .command("upgrade")
+        .description("检查并升级 CLI 到 npm registry 最新版本")
+        .action(async () => {
+        const localVersion = getPackageVersion();
+        let registryVersion;
+        try {
+            registryVersion = await fetchRegistryVersion();
+        }
+        catch (error) {
+            emitJson({
+                ok: false,
+                action: "upgrade",
+                local_version: localVersion,
+                message: error instanceof Error
+                    ? `查询 registry 版本失败：${error.message}`
+                    : "查询 registry 版本失败",
+            });
+            process.exitCode = 1;
+            return;
+        }
+        const needsUpgrade = compareSemver(localVersion, registryVersion) < 0;
+        if (!needsUpgrade) {
+            emitJson({
+                ok: true,
+                action: "upgrade",
+                local_version: localVersion,
+                registry_version: registryVersion,
+                upgraded: false,
+                message: `当前已是最新版本 (${localVersion})`,
+            });
+            return;
+        }
+        try {
+            await installLatestCli();
+        }
+        catch (error) {
+            emitJson({
+                ok: false,
+                action: "upgrade",
+                local_version: localVersion,
+                registry_version: registryVersion,
+                upgraded: false,
+                message: error instanceof Error
+                    ? `升级失败：${error.message}`
+                    : "升级失败，请手动执行 npm install -g helixlife-expert-cli@latest",
+            });
+            process.exitCode = 1;
+            return;
+        }
+        emitJson({
+            ok: true,
+            action: "upgrade",
+            local_version: localVersion,
+            registry_version: registryVersion,
+            upgraded: true,
+            message: `已从 ${localVersion} 升级至 ${registryVersion}，请重新打开终端或再次运行 helixlife-expert --version 确认`,
+        });
+    });
+}
+//# sourceMappingURL=index.js.map

package/cli/dist/modules/upgrade/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/upgrade/index.ts"],"names":[],"mappings":"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"}

package/cli/dist/program.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function createProgram(): Command;
+//# sourceMappingURL=program.d.ts.map

package/cli/dist/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBpC,wBAAgB,aAAa,IAAI,OAAO,CAkEvC"}

package/cli/dist/program.js

@@ -0,0 +1,69 @@
+import { Command } from "commander";
+import { getPackageVersion, emitJson, getDefaultBaseUrl, getDefaultAuthBaseUrl, updateLocalConfigField, isValidConfigSetKey, CONFIG_SET_KEYS, } from "./core/index.js";
+import { registerUpgradeCommand } from "./modules/upgrade/index.js";
+import { registerSiteConfigsCommand } from "./modules/site-configs.js";
+import { registerMetaCommands } from "./modules/meta/index.js";
+import { registerFundCommands } from "./modules/fund/index.js";
+import { registerSciCommands } from "./modules/sci/index.js";
+import { registerAnalysisCommands } from "./modules/analysis/index.js";
+import { registerLiteratureCommands } from "./modules/literature/index.js";
+import { registerProposalCommands } from "./modules/proposal/index.js";
+// 创建 CLI 根命令并挂载各模块
+export function createProgram() {
+    const program = new Command();
+    program
+        .name("helixlife-expert")
+        .description("解螺旋科研专家合集 CLI")
+        .version(getPackageVersion());
+    // 本地配置：helixlife-expert config / helixlife-expert config set <key> <value>
+    const config = program
+        .command("config")
+        .description("查看或修改本地接口基址配置");
+    // helixlife-expert config：查看当前生效的 api / agent_api
+    config.action(() => {
+        emitJson({
+            api: getDefaultBaseUrl(),
+            agent_api: getDefaultAuthBaseUrl(),
+        });
+    });
+    // helixlife-expert config set api|agent_api <完整基址>
+    config
+        .command("set <key> <value>")
+        .description(`设置本地接口基址覆盖（${CONFIG_SET_KEYS.join(" | ")}），值为完整 URL`)
+        .action((key, value) => {
+        if (!isValidConfigSetKey(key)) {
+            emitJson({
+                ok: false,
+                message: `非法配置项 "${key}"，合法值：${CONFIG_SET_KEYS.join(", ")}`,
+            });
+            process.exitCode = 1;
+            return;
+        }
+        if (!value.trim()) {
+            emitJson({
+                ok: false,
+                message: "配置值不能为空",
+            });
+            process.exitCode = 1;
+            return;
+        }
+        updateLocalConfigField(key, value);
+        emitJson({
+            ok: true,
+            key,
+            value: key === "api" ? getDefaultBaseUrl() : getDefaultAuthBaseUrl(),
+            api: getDefaultBaseUrl(),
+            agent_api: getDefaultAuthBaseUrl(),
+        });
+    });
+    registerUpgradeCommand(program);
+    registerSiteConfigsCommand(program);
+    registerMetaCommands(program);
+    registerFundCommands(program);
+    registerSciCommands(program);
+    registerAnalysisCommands(program);
+    registerLiteratureCommands(program);
+    registerProposalCommands(program);
+    return program;
+}
+//# sourceMappingURL=program.js.map

package/cli/dist/program.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "helixlife-expert-cli",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "helixlife 科研专家合集后台命令行工具",
+  "bin": {
+    "helixlife-expert": "./cli/bin/helixlife-expert.js"
+  },
+  "main": "./cli/dist/index.js",
+  "types": "./cli/dist/index.d.ts",
+  "files": [
+    "cli/bin",
+    "cli/dist"
+  ],
+  "scripts": {
+    "build": "tsc -p cli/tsconfig.json",
+    "dev": "node --import tsx cli/src/index.ts",
+    "typecheck": "tsc -p cli/tsconfig.json --noEmit",
+    "test": "tsx --test cli/tests/*.test.ts",
+    "sync:skills": "node scripts/sync-skills.mjs",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@resvg/resvg-js": "^2.6.2",
+    "commander": "^13.0.0",
+    "docx": "^9.7.1",
+    "pdf-lib": "^1.17.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}