helixlife-expert-cli 0.1.0

package/cli/dist/modules/sci/commands/article-create.js

@@ -0,0 +1,315 @@
+import { helixlifeError, helixlifeErrorCode, isInteractiveTerminal, printOutput, createFormatLogger, ApiClient, extractSseText, assertWorkflowSucceeded, } from "../../../core/index.js";
+import { resolveMarkdownContent, resolveTextOrFile, } from "../content-source.js";
+import { getSciArticleAppIds, getSciTemplateLabel, parseSciTemplateType, SCI_ARTICLE_WAIT_HINT, SCI_EXECUTE_API_PATH, } from "../constants.js";
+import { resolveSciArticleSelection, } from "../prompt-article.js";
+import { extractReferences, formatElapsedHint, pickWebsiteWorkflowOutputText, } from "../sse-utils.js";
+import { buildSciExecuteBody } from "../apps.js";
+import { clearSciArticleCache, saveSciArticleCache, } from "../article-cache.js";
+import { assertSciArticleComplete, isCompleteSciArticleMarkdown, } from "../article-validate.js";
+import { wrapWorkbenchResult } from "../../shared/result-wrapper.js";
+import { appendFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+/**
+ * 诊断用：设置 HELIX_SCI_DEBUG=1 时把全文 SSE 的事件类型计数与
+ * workflow_finished 全量 payload 落盘，用于定位偶发空正文真因。
+ * 行为中性：未设置环境变量时完全无副作用。
+ */
+const SCI_DEBUG_ENABLED = Boolean(process.env.HELIX_SCI_DEBUG);
+const SCI_DEBUG_FILE = process.env.HELIX_SCI_DEBUG_FILE ||
+    join(tmpdir(), "helixlife-sci-debug.log");
+function sciDebugLog(entry) {
+    if (!SCI_DEBUG_ENABLED) {
+        return;
+    }
+    try {
+        appendFileSync(SCI_DEBUG_FILE, `${JSON.stringify({ ts: new Date().toISOString(), ...entry })}\n`, "utf8");
+    }
+    catch {
+        /* 诊断失败不影响主流程 */
+    }
+}
+// ============================================================
+// 工具函数（导出供单测）
+// ============================================================
+/** 检查是否为有效 Markdown（提纲格式：至少含 # 标题） */
+export function isValidOutlineMarkdown(text) {
+    const trimmed = text.trim();
+    return trimmed.length > 0 && /^#{1,6}\s+\S/.test(trimmed);
+}
+/** 从提纲 Markdown 提取首个标题文本（对齐官网 outline_title） */
+export function extractOutlineTitle(outline) {
+    const match = outline.trim().match(/^#{1,6}\s+(.+)$/m);
+    return match?.[1]?.trim() ?? "";
+}
+/** 解析模板类型 */
+function resolveTemplate(template) {
+    return parseSciTemplateType(template ?? "basic");
+}
+/**
+ * 组装全文 execute inputs（对齐官网 Writing.getParams SCI existing）
+ * keywords ≈ outlineParams.query（existing 常为空，不用 results 冒充）
+ */
+export function buildSciArticleInputs(options) {
+    return {
+        outline: options.outline,
+        language: options.language,
+        methods: options.methods,
+        results: options.results,
+        keywords: "",
+        _bibliography: 0,
+        MethodAndResult: options.methodAndResult ?? "",
+        outline_title: extractOutlineTitle(options.outline),
+    };
+}
+/**
+ * 标题段规范化：官网 title 工作流前强制写入 "# "
+ */
+export function normalizeSciTitleSection(text) {
+    const trimmed = text.trim();
+    if (!trimmed) {
+        return "";
+    }
+    if (/^#\s/.test(trimmed)) {
+        return trimmed;
+    }
+    return `# ${trimmed}`;
+}
+/**
+ * 合并 title + body 各段（官网 list.join("\\n")）
+ */
+export function assembleSciArticleMarkdown(sections) {
+    return sections
+        .map((section) => section.trim())
+        .filter(Boolean)
+        .join("\n");
+}
+/** 解析 Step1 方法/结果：内联或 *-file，非空才通过 */
+async function resolveMethodsAndResults(options) {
+    const methods = await resolveTextOrFile({
+        text: options.methods,
+        file: options.methodsFile,
+        label: "methods",
+    });
+    const results = await resolveTextOrFile({
+        text: options.results,
+        file: options.resultsFile,
+        label: "results",
+    });
+    if (!methods || !results) {
+        throw new helixlifeError(helixlifeErrorCode.INVALID_ARGUMENT, "缺少 methods/results：请传 --methods/--results 或 --methods-file/--results-file（取步骤①返回值）");
+    }
+    return { methods, results };
+}
+// 批量调用 SSE 流式生成 SCI 全文（与官网 batchFetchWorkflows + Writing.onMessage 对齐）
+async function batchStreamSciArticle(appIds, orderId, parentOrderId, outline, language, methods, results, methodAndResult, format) {
+    const client = new ApiClient();
+    const streamToStdout = format !== "json";
+    const sectionTexts = [];
+    const allOutputs = [];
+    let lastWorkflowRunId;
+    let lastElapsedTime;
+    let totalElapsedTime = 0;
+    // 全文生成耗时长：一次性提示，不做百分比假进度（避免 Agent 订阅/轮询冲突）
+    process.stderr.write(`${SCI_ARTICLE_WAIT_HINT}\n`);
+    const inputs = buildSciArticleInputs({
+        outline,
+        language,
+        methods,
+        results,
+        methodAndResult,
+    });
+    for (let i = 0; i < appIds.length; i++) {
+        const appId = appIds[i];
+        const isTitleApp = i === 0;
+        if (streamToStdout) {
+            process.stderr.write(`\n[${i + 1}/${appIds.length}] 正在生成${isTitleApp ? "标题" : "正文"}...\n`);
+        }
+        const executeBody = buildSciExecuteBody({
+            // 官网 existing：query 多为 outlineParams.query（常空），results 在 inputs
+            query: "",
+            inputs,
+            appId,
+            appName: "全文",
+            appType: 1,
+            index: 1,
+            orderId,
+            // 官网 Writing extraParams.end=true 同时传给所有 app
+            end: true,
+            count: appIds.length,
+            parentOrderId,
+        });
+        const chunks = [];
+        let overrideText;
+        let elapsedTime;
+        const eventCounts = {};
+        let sawWorkflowFinished = false;
+        await new Promise((resolve, reject) => {
+            client
+                .requestSse(SCI_EXECUTE_API_PATH, { method: "POST", body: executeBody }, (payload) => {
+                const evt = typeof payload.event === "string" ? payload.event : "unknown";
+                eventCounts[evt] = (eventCounts[evt] ?? 0) + 1;
+                assertWorkflowSucceeded(payload, "全文生成失败，请稍后重试", [
+                    "workflow_finished",
+                ]);
+                const chunk = extractSseText(payload, { nested: true });
+                if (chunk) {
+                    chunks.push(chunk);
+                    if (streamToStdout) {
+                        process.stdout.write(chunk);
+                    }
+                }
+                if (payload.event === "workflow_finished") {
+                    sawWorkflowFinished = true;
+                    const data = payload.data;
+                    if (typeof data === "object" && data !== null) {
+                        const record = data;
+                        if (typeof record.elapsed_time === "number") {
+                            elapsedTime = record.elapsed_time;
+                            lastElapsedTime = elapsedTime;
+                            totalElapsedTime += elapsedTime;
+                        }
+                        if (typeof record.outputs === "object" && record.outputs) {
+                            const outputs = record.outputs;
+                            allOutputs.push(outputs);
+                            // 对齐官网 Object.values(outputs)[0]
+                            const finishedText = pickWebsiteWorkflowOutputText(outputs);
+                            if (finishedText) {
+                                overrideText = finishedText;
+                                if (streamToStdout && chunks.length === 0) {
+                                    process.stdout.write(finishedText);
+                                }
+                            }
+                        }
+                        sciDebugLog({
+                            phase: "workflow_finished",
+                            appIndex: i,
+                            isTitleApp,
+                            appId,
+                            status: record.status,
+                            elapsedTime: record.elapsed_time,
+                            outputsKeys: typeof record.outputs === "object" && record.outputs
+                                ? Object.keys(record.outputs)
+                                : null,
+                            data: record,
+                        });
+                    }
+                    if (typeof payload.workflow_run_id === "string") {
+                        lastWorkflowRunId = payload.workflow_run_id;
+                    }
+                }
+            })
+                .then(resolve)
+                .catch((err) => {
+                sciDebugLog({
+                    phase: "sse_error",
+                    appIndex: i,
+                    isTitleApp,
+                    appId,
+                    eventCounts,
+                    sawWorkflowFinished,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+                reject(err);
+            });
+        });
+        const streamed = chunks.join("").trim();
+        const finished = (overrideText ?? "").trim();
+        let sectionText = finished || streamed;
+        // 避免短 result 覆盖长流式正文
+        if (finished &&
+            streamed &&
+            streamed.length > finished.length * 2 &&
+            streamed.length - finished.length > 500) {
+            sectionText = streamed;
+        }
+        if (isTitleApp) {
+            sectionText = normalizeSciTitleSection(sectionText);
+        }
+        sciDebugLog({
+            phase: "section_done",
+            appIndex: i,
+            isTitleApp,
+            appId,
+            eventCounts,
+            sawWorkflowFinished,
+            streamedLen: streamed.length,
+            finishedLen: finished.length,
+            sectionTextLen: sectionText.length,
+            sectionHead: sectionText.slice(0, 120),
+        });
+        sectionTexts.push(sectionText);
+    }
+    assertSciArticleComplete(sectionTexts);
+    const article = assembleSciArticleMarkdown(sectionTexts);
+    const allReferences = [];
+    for (const outputs of allOutputs) {
+        const refs = extractReferences(outputs);
+        allReferences.push(...refs);
+    }
+    if (!isCompleteSciArticleMarkdown(article)) {
+        throw new helixlifeError(helixlifeErrorCode.INVALID_RESPONSE, "全文生成不完整：正文为空或过短（仅有标题不能视为成功），请重试 outline confirm create");
+    }
+    return {
+        article,
+        references: allReferences,
+        workflowRunId: lastWorkflowRunId,
+        elapsedTime: lastElapsedTime ?? totalElapsedTime,
+    };
+}
+// ============================================================
+// 主入口：确认提纲并生成全文（Step2）
+// ============================================================
+export async function runCreateSciArticle(options = {}) {
+    const format = options.format ?? "markdown";
+    const interactive = isInteractiveTerminal() && !options.yes && options.format !== "json";
+    const log = createFormatLogger(format);
+    const template = resolveTemplate(options.template);
+    const outline = await resolveMarkdownContent(options, "请通过 --content、--file 或 --stdin 提供提纲 Markdown 内容");
+    if (!isValidOutlineMarkdown(outline)) {
+        throw new helixlifeError(helixlifeErrorCode.INVALID_ARGUMENT, "提纲内容格式无效，应为 Markdown 格式（以 # 标题开头）");
+    }
+    if (!options.orderId?.trim()) {
+        throw new helixlifeError(helixlifeErrorCode.INVALID_ARGUMENT, "缺少 orderId，请先执行 outline create 获取订单 ID");
+    }
+    // 直接复用步骤① 提纲订单（对齐官网首次生成 needRefreshOrder=false 路径）；
+    // 不新建订单、不切换订单号（全文接口仅在结束时返回内容，切单只会丢弃进行中的生成）
+    const orderId = options.orderId.trim();
+    const { methods, results } = await resolveMethodsAndResults(options);
+    const methodAndResult = options.methodAndResult?.trim() ?? "";
+    const selection = await resolveSciArticleSelection({ language: options.language }, interactive);
+    const { language } = selection;
+    const appIds = getSciArticleAppIds(template);
+    // 生成前清理该订单可能残留的脏缓存（历史仅标题假成功）
+    await clearSciArticleCache(orderId);
+    const stream = await batchStreamSciArticle(appIds, orderId, null, outline, language, methods, results, methodAndResult, format);
+    const result = {
+        orderId,
+        template,
+        language,
+        article: stream.article,
+        references: stream.references,
+        workflowRunId: stream.workflowRunId,
+        elapsedTime: stream.elapsedTime,
+    };
+    const cacheReady = await saveSciArticleCache({
+        orderId,
+        template,
+        language,
+        article: stream.article,
+        references: stream.references,
+        workflowRunId: stream.workflowRunId,
+    });
+    if (format === "json") {
+        printOutput(wrapWorkbenchResult(result, { step: "article", subType: "sci" }, {
+            orderId,
+            workflowRunId: stream.workflowRunId,
+            cacheReady,
+        }), "json");
+        return;
+    }
+    const elapsedHint = formatElapsedHint(stream.elapsedTime);
+    log(`\n---\n模板：${getSciTemplateLabel(template)} | 语言：${language} | 参考文献 ${stream.references.length} 条${elapsedHint}`);
+    log("\n✅ 确认提纲并生成全文（Step2）完成。\n");
+}
+//# sourceMappingURL=article-create.js.map

package/cli/dist/modules/sci/commands/article-create.js.map

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

package/cli/dist/modules/sci/commands/article-download.d.ts

@@ -0,0 +1,50 @@
+import { type OutputFormat } from "../../../core/index.js";
+import { type SciArticleDownloadResult, type SciLanguage } from "../constants.js";
+export type { SciArticleDownloadResult } from "../constants.js";
+export interface DownloadSciArticleOptions {
+    orderId?: string;
+    file?: string;
+    references?: string[];
+    referencesFile?: string;
+    language?: string;
+    output?: string;
+    produceId?: string;
+    format?: OutputFormat;
+    emitOutput?: boolean;
+}
+/**
+ * 将标题候选收成安全导出 basename（不含扩展名）。
+ * 对齐官网：整题作文件名、不截断；CLI 仅替换 Windows 非法字符以便 writeFile。
+ */
+export declare function toSciExportBasename(titleCandidate: string): string;
+/**
+ * 从全文 Markdown 提取论文标题（对齐官网 getTitleFromArticle）
+ * 优先首个 H1（恰好一个 `#`）；兼容「标题:」前缀；否则取首个非 ATX 标题段落；空则「未命名」
+ */
+export declare function extractSciArticleTitle(markdown: string): string;
+/**
+ * 专供导出文件名：只信任严格 H1；无 H1 或正文泄漏 →「未命名」
+ */
+export declare function extractSciExportTitle(markdown: string): string;
+/**
+ * 若 Markdown 开头缺少 H1 标题，则注入 `# ${title}`（防御旧缓存 / 残缺正文）
+ * 注入标题经 toSciExportBasename，避免整篇正文写进 H1。
+ */
+export declare function ensureSciArticleTitleHeading(markdown: string, title?: string): {
+    markdown: string;
+    title: string;
+};
+export declare function resolveSciArticleDownloadLanguage(explicitLanguage: string | undefined, cachedLanguage?: string): SciLanguage;
+export declare function appendReferencesToMarkdown(article: string, references: string[], language?: string): string;
+export declare function downloadSciArticleDocx(markdown: string, options?: Pick<DownloadSciArticleOptions, "produceId">): Promise<{
+    buffer: Buffer;
+    contentType: string | null;
+    filename?: string;
+}>;
+/**
+ * 确定全文 docx 输出路径：默认 / -o 目录时用论文标题命名（对齐官网 saveAs）
+ * 文件名只吃 toSciExportBasename，禁止正文泄漏进路径。
+ */
+export declare function resolveArticleDownloadPath(outputOption: string | undefined, articleTitle: string): string;
+export declare function runDownloadSciArticle(options?: DownloadSciArticleOptions): Promise<SciArticleDownloadResult>;
+//# sourceMappingURL=article-download.d.ts.map

package/cli/dist/modules/sci/commands/article-download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-download.d.ts","sourceRoot":"","sources":["../../../../src/modules/sci/commands/article-download.ts"],"names":[],"mappings":"AAGA,OAAO,EASL,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAGL,KAAK,wBAAwB,EAC7B,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAGhE,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAkCD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAUlE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAoC/D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiB9D;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAmBrC;AAgCD,wBAAgB,iCAAiC,CAC/C,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,cAAc,CAAC,EAAE,MAAM,GACtB,WAAW,CAIb;AAGD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAAE,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAWR;AAkBD,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,IAAI,CAAC,yBAAyB,EAAE,WAAW,CAAM,GACzD,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAS5E;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,YAAY,EAAE,MAAM,GACnB,MAAM,CAWR;AAYD,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,wBAAwB,CAAC,CAsGnC"}

package/cli/dist/modules/sci/commands/article-download.js

@@ -0,0 +1,281 @@
+// SCI 全文导出（Step3）：命中步骤② 系统临时目录缓存 → 追加参考文献 → 输出 MD + Word
+import { readFile, writeFile } from "node:fs/promises";
+import { extname, join } from "node:path";
+import { ApiClient, getDefaultNewideaBaseUrl, helixlifeError, helixlifeErrorCode, getUserDownloadsDir, printOutput, resolveUserPath, sanitizeFilename, } from "../../../core/index.js";
+import { SCI_ARTICLE_CONTENT_PRODUCER, SCI_DOCX_CONVERT_API_PATH, } from "../constants.js";
+import { loadSciArticleCache, popSciArticleCache } from "../article-cache.js";
+const DEFAULT_SCI_ARTICLE_TITLE = "未命名";
+/** 检测行首「标题:」/「Title:」类前缀（对齐官网语义，避免正文中含「标题」误伤） */
+function checkIsTitleLabel(text) {
+    return /^(?:项目名称|标题|Title)\s*[:：]?/.test(text);
+}
+/** 从「标题: xxx」提取标题正文（对齐官网 extractTitle） */
+function extractLabeledTitle(text) {
+    const match = text.match(/^(?:项目名称|标题|Title)\s*[:：]?\s*\*{0,2}([^*]+)\*{0,2}/);
+    return match?.[1]?.trim() || "";
+}
+/**
+ * 候选是否像正文（禁止当文件名）。
+ * 对齐官网：不因长度否决；仅空串 / 换行 / `##` 等多段泄漏（MD 特有防护）。
+ */
+function looksLikeArticleBody(text) {
+    if (!text.trim()) {
+        return true;
+    }
+    if (/[\r\n]/.test(text)) {
+        return true;
+    }
+    if (text.includes("##") || /\n#{1,6}/.test(text)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * 将标题候选收成安全导出 basename（不含扩展名）。
+ * 对齐官网：整题作文件名、不截断；CLI 仅替换 Windows 非法字符以便 writeFile。
+ */
+export function toSciExportBasename(titleCandidate) {
+    const raw = titleCandidate.trim();
+    if (!raw || looksLikeArticleBody(raw)) {
+        return DEFAULT_SCI_ARTICLE_TITLE;
+    }
+    const sanitized = sanitizeFilename(raw, { maxLength: null });
+    // sanitizeFilename 可能带扩展名；导出 basename 只要 stem
+    return (sanitized.replace(/\.[A-Za-z0-9]{1,8}$/, "") || DEFAULT_SCI_ARTICLE_TITLE);
+}
+/**
+ * 从全文 Markdown 提取论文标题（对齐官网 getTitleFromArticle）
+ * 优先首个 H1（恰好一个 `#`）；兼容「标题:」前缀；否则取首个非 ATX 标题段落；空则「未命名」
+ */
+export function extractSciArticleTitle(markdown) {
+    const lines = markdown.split(/\r?\n/);
+    for (const raw of lines) {
+        const line = raw.trim();
+        if (!line) {
+            continue;
+        }
+        // 恰好 H1：`# title`，排除 `##` / `###`
+        const h1Match = line.match(/^#(?!#)\s+(.+)$/);
+        if (h1Match) {
+            const heading = h1Match[1].trim();
+            if (checkIsTitleLabel(heading)) {
+                return (extractLabeledTitle(heading) || heading || DEFAULT_SCI_ARTICLE_TITLE);
+            }
+            return heading || DEFAULT_SCI_ARTICLE_TITLE;
+        }
+        // 跳过二级及以下标题，避免把「## 摘要」当成文件名
+        if (/^#{2,6}\s+/.test(line)) {
+            continue;
+        }
+        if (checkIsTitleLabel(line)) {
+            const labeled = extractLabeledTitle(line);
+            if (labeled) {
+                return labeled;
+            }
+        }
+        // 非 ATX 标题的首个非空行（官网 else if nodeText）
+        return line;
+    }
+    return DEFAULT_SCI_ARTICLE_TITLE;
+}
+/**
+ * 专供导出文件名：只信任严格 H1；无 H1 或正文泄漏 →「未命名」
+ */
+export function extractSciExportTitle(markdown) {
+    const lines = markdown.split(/\r?\n/);
+    for (const raw of lines) {
+        const line = raw.trim();
+        if (!line) {
+            continue;
+        }
+        const h1Match = line.match(/^#(?!#)\s+(.+)$/);
+        if (h1Match) {
+            let heading = h1Match[1].trim();
+            if (checkIsTitleLabel(heading)) {
+                heading = extractLabeledTitle(heading) || heading;
+            }
+            return toSciExportBasename(heading);
+        }
+    }
+    return DEFAULT_SCI_ARTICLE_TITLE;
+}
+/**
+ * 若 Markdown 开头缺少 H1 标题，则注入 `# ${title}`（防御旧缓存 / 残缺正文）
+ * 注入标题经 toSciExportBasename，避免整篇正文写进 H1。
+ */
+export function ensureSciArticleTitleHeading(markdown, title) {
+    const rawTitle = (title?.trim() || extractSciArticleTitle(markdown)).trim() ||
+        DEFAULT_SCI_ARTICLE_TITLE;
+    // 正文 H1 保留完整题目；文件名截断由 toSciExportBasename / extractSciExportTitle 负责
+    const resolvedTitle = looksLikeArticleBody(rawTitle)
+        ? DEFAULT_SCI_ARTICLE_TITLE
+        : rawTitle;
+    const trimmed = markdown.trimStart();
+    if (/^#(?!#)\s+\S/.test(trimmed)) {
+        return {
+            markdown,
+            title: extractSciExportTitle(markdown) || toSciExportBasename(resolvedTitle),
+        };
+    }
+    return {
+        markdown: `# ${resolvedTitle}\n\n${markdown.trimStart()}`,
+        title: toSciExportBasename(resolvedTitle),
+    };
+}
+// 解析参考文献列表：CLI 参数或 JSON 文件
+async function resolveReferences(options) {
+    if (options.references?.length) {
+        return options.references;
+    }
+    if (options.referencesFile) {
+        try {
+            const raw = await readFile(resolveUserPath(options.referencesFile), "utf8");
+            const parsed = JSON.parse(raw);
+            if (Array.isArray(parsed)) {
+                return parsed.filter((item) => typeof item === "string");
+            }
+        }
+        catch {
+            throw new helixlifeError(helixlifeErrorCode.INVALID_ARGUMENT, `无法读取参考文献文件: ${options.referencesFile}`);
+        }
+    }
+    return [];
+}
+// 解析步骤③ 参考文献标题语言：显式 --language 优先，否则缓存，否则中文
+export function resolveSciArticleDownloadLanguage(explicitLanguage, cachedLanguage) {
+    return (explicitLanguage?.trim() ||
+        cachedLanguage?.trim() ||
+        "中文");
+}
+// 将参考文献追加到正文 Markdown（原始引文格式，全量保留）
+export function appendReferencesToMarkdown(article, references, language) {
+    if (!references.length) {
+        return `${article.trim()}\n`;
+    }
+    const heading = language === "英文" ? "## References" : "## 参考文献";
+    const body = references
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .join("\n");
+    return `${article.trim()}\n\n${heading}\n\n${body}\n`;
+}
+// 组装全文 markdown 转 docx 的 multipart 表单（原始引文格式，csl_key 留空）
+function buildArticleDownloadFormData(markdown, produceId) {
+    const form = new FormData();
+    const blob = new Blob([markdown], { type: "text/plain" });
+    form.append("data", blob, "blob");
+    form.append("is_aigc", "true");
+    form.append("content_producer", SCI_ARTICLE_CONTENT_PRODUCER);
+    form.append("produce_id", produceId || "");
+    form.append("csl_key", "");
+    return form;
+}
+// 调用 PaaS 接口将全文 Markdown 转为 docx
+export async function downloadSciArticleDocx(markdown, options = {}) {
+    const client = new ApiClient();
+    const form = buildArticleDownloadFormData(markdown, options.produceId ?? "");
+    return client.requestBinary(SCI_DOCX_CONVERT_API_PATH, {
+        method: "POST",
+        baseUrl: getDefaultNewideaBaseUrl(),
+        body: form,
+    });
+}
+/**
+ * 确定全文 docx 输出路径：默认 / -o 目录时用论文标题命名（对齐官网 saveAs）
+ * 文件名只吃 toSciExportBasename，禁止正文泄漏进路径。
+ */
+export function resolveArticleDownloadPath(outputOption, articleTitle) {
+    const safeName = `${toSciExportBasename(articleTitle)}.docx`;
+    if (outputOption) {
+        const resolved = resolveUserPath(outputOption);
+        if (extname(resolved)) {
+            return resolved;
+        }
+        return join(resolved, safeName);
+    }
+    return join(getUserDownloadsDir(), safeName);
+}
+// 由 docx 路径推导配套 MD 路径（同目录同名，扩展名替换为 .md）
+function resolveArticleMarkdownPath(docxPath) {
+    const ext = extname(docxPath);
+    if (ext) {
+        return docxPath.slice(0, docxPath.length - ext.length) + ".md";
+    }
+    return `${docxPath}.md`;
+}
+// 执行全文下载：读取 Markdown → 追加参考文献 → 同时输出 MD 与 docx
+export async function runDownloadSciArticle(options = {}) {
+    const explicitProvided = Boolean(options.file);
+    if (options.orderId && explicitProvided) {
+        throw new helixlifeError(helixlifeErrorCode.INVALID_ARGUMENT, "--order-id 与 --file 互斥，请二选一");
+    }
+    let article;
+    let references;
+    let produceId = options.produceId ?? "";
+    let language = "中文";
+    if (options.orderId) {
+        const cached = await loadSciArticleCache(options.orderId);
+        if (!cached) {
+            throw new helixlifeError(helixlifeErrorCode.INVALID_ARGUMENT, `订单 ${options.orderId} 的全文缓存缺失或已清理，请重新执行步骤② 或通过 --file <path> 显式提供全文 Markdown`);
+        }
+        article = cached.article;
+        references = cached.references;
+        if (!options.produceId && cached.workflowRunId) {
+            produceId = cached.workflowRunId;
+        }
+        language = resolveSciArticleDownloadLanguage(options.language, cached.language);
+    }
+    else if (options.file) {
+        try {
+            article = await readFile(resolveUserPath(options.file), "utf8");
+        }
+        catch {
+            throw new helixlifeError(helixlifeErrorCode.INVALID_ARGUMENT, `无法读取全文文件: ${options.file}`);
+        }
+        references = await resolveReferences(options);
+        language = resolveSciArticleDownloadLanguage(options.language);
+    }
+    else {
+        throw new helixlifeError(helixlifeErrorCode.INVALID_ARGUMENT, "请通过 --order-id 命中步骤② 缓存，或通过 --file <path> 显式提供全文 Markdown");
+    }
+    const withTitle = ensureSciArticleTitleHeading(article);
+    const markdown = appendReferencesToMarkdown(withTitle.markdown, references, language);
+    const articleTitle = extractSciExportTitle(markdown);
+    const { buffer, contentType } = await downloadSciArticleDocx(markdown, {
+        produceId,
+    });
+    const docxPath = resolveArticleDownloadPath(options.output, articleTitle);
+    await writeFile(docxPath, buffer);
+    const mdPath = resolveArticleMarkdownPath(docxPath);
+    const mdBuffer = Buffer.from(markdown, "utf8");
+    await writeFile(mdPath, mdBuffer);
+    if (options.orderId) {
+        try {
+            await popSciArticleCache(options.orderId);
+        }
+        catch (error) {
+            console.warn(`[sci-cache] 清理失败 orderId=${options.orderId}: ${error.message}`);
+        }
+    }
+    const filename = `${toSciExportBasename(articleTitle)}.docx`;
+    const result = {
+        mdPath,
+        mdSize: mdBuffer.byteLength,
+        docxPath,
+        docxSize: buffer.byteLength,
+        contentType,
+        filename,
+    };
+    const emitOutput = options.emitOutput !== false;
+    if (!emitOutput) {
+        return result;
+    }
+    if (options.format === "json") {
+        printOutput(result, "json");
+        return result;
+    }
+    console.log(`全文 Markdown 已保存: ${mdPath} (${result.mdSize} 字节)`);
+    console.log(`全文 Word 已保存: ${docxPath} (${result.docxSize} 字节)`);
+    return result;
+}
+//# sourceMappingURL=article-download.js.map