@xgjktech/xg_cwork_im 1.19.21 → 1.19.23

package/dist/src/session/auto-model-router.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=auto-model-router.test.d.ts.map

package/dist/src/session/auto-model-router.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-model-router.test.d.ts","sourceRoot":"","sources":["../../../src/session/auto-model-router.test.ts"],"names":[],"mappings":""}

package/dist/src/session/auto-model-router.test.js

@@ -0,0 +1,99 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { AUTO_ROUTER_VERSION, resolveAutoModelRoute, resolveModelThinkingDefault, } from "./auto-model-router.js";
+const SLOTS = {
+    simpleModel: "openai/gpt-5.6-luna",
+    standardModel: "openai/gpt-5.6-terra",
+    complexModel: "openai/gpt-5.6-sol",
+    criticalModel: "openai/gpt-5.6-sol",
+};
+const input = (query, extras = {}) => ({
+    query,
+    attachmentKinds: extras.attachmentKinds ?? [],
+    attachmentFormats: extras.attachmentFormats ?? [],
+    agentId: "agent-1",
+});
+describe("auto-model-router", () => {
+    it("simple translation → simple tier (luna/low)", () => {
+        const r = resolveAutoModelRoute(input("请把这句翻译成英文"), SLOTS);
+        assert.equal(r.tier, "simple");
+        assert.equal(r.model, SLOTS.simpleModel);
+        assert.equal(r.thinking, "low");
+        assert.equal(r.reason, "simple_task");
+        assert.equal(r.version, AUTO_ROUTER_VERSION);
+    });
+    it("ordinary Q&A → standard tier (terra/medium)", () => {
+        const r = resolveAutoModelRoute(input("这是什么意思？"), SLOTS);
+        assert.equal(r.tier, "standard");
+        assert.equal(r.model, SLOTS.standardModel);
+        assert.equal(r.thinking, "medium");
+        assert.equal(r.reason, "general_task");
+    });
+    it("routine coding → standard tier", () => {
+        const r = resolveAutoModelRoute(input("帮我写一个排序函数"), SLOTS);
+        assert.equal(r.tier, "standard");
+        assert.equal(r.model, SLOTS.standardModel);
+    });
+    it("architecture design → complex tier (sol/high)", () => {
+        const r = resolveAutoModelRoute(input("请完成这个微服务系统的架构设计"), SLOTS);
+        assert.equal(r.tier, "complex");
+        assert.equal(r.model, SLOTS.complexModel);
+        assert.equal(r.thinking, "high");
+        assert.equal(r.reason, "complex_reasoning");
+    });
+    it("security analysis → complex tier", () => {
+        const r = resolveAutoModelRoute(input("做一次安全分析，找出漏洞"), SLOTS);
+        assert.equal(r.tier, "complex");
+        assert.equal(r.thinking, "high");
+    });
+    it("explicit comprehensive audit → critical tier (sol/max)", () => {
+        const r = resolveAutoModelRoute(input("请做一次全面审计，不要遗漏任何风险"), SLOTS);
+        assert.equal(r.tier, "critical");
+        assert.equal(r.model, SLOTS.criticalModel);
+        assert.equal(r.thinking, "max");
+        assert.equal(r.reason, "explicit_quality_first");
+    });
+    it("long simple input does not upgrade solely by length", () => {
+        const long = `请把下面这段话润色一下：${"很长很长的文本。".repeat(120)}`;
+        const r = resolveAutoModelRoute(input(long), SLOTS);
+        assert.notEqual(r.tier, "simple");
+        assert.equal(r.tier, "standard");
+        assert.equal(r.model, SLOTS.standardModel);
+    });
+    it("attachment-only ordinary request does not upgrade by attachment", () => {
+        const r = resolveAutoModelRoute(input("看一下这个文件", { attachmentKinds: ["工作汇报"], attachmentFormats: ["pdf"] }), SLOTS);
+        assert.equal(r.tier, "standard");
+        assert.equal(r.model, SLOTS.standardModel);
+    });
+    it("empty / unclassifiable query → standard tier", () => {
+        const r = resolveAutoModelRoute(input("   "), SLOTS);
+        assert.equal(r.tier, "standard");
+        assert.equal(r.model, SLOTS.standardModel);
+        assert.equal(r.thinking, "medium");
+    });
+    it("max only appears on critical (no spurious max)", () => {
+        const tiers = ["simple", "standard", "complex"].map((q) => resolveAutoModelRoute(input(q), SLOTS).thinking);
+        assert.ok(!tiers.includes("max"));
+    });
+});
+describe("auto-model-router thinking defaults", () => {
+    const DEFAULTS = {
+        "openai/gpt-5.6-luna": "low",
+        "openai/gpt-5.6-terra": "medium",
+        "openai/gpt-5.6-sol": "high",
+    };
+    it("reads configured model default", () => {
+        assert.equal(resolveModelThinkingDefault(DEFAULTS, "openai/gpt-5.6-terra"), "medium");
+    });
+    it("returns undefined for unknown model", () => {
+        assert.equal(resolveModelThinkingDefault(DEFAULTS, "other/gpt-x"), undefined);
+    });
+    it("returns undefined when mapping missing or empty", () => {
+        assert.equal(resolveModelThinkingDefault(undefined, "openai/gpt-5.6-terra"), undefined);
+        assert.equal(resolveModelThinkingDefault({}, "openai/gpt-5.6-terra"), undefined);
+    });
+    it("trims model ref", () => {
+        assert.equal(resolveModelThinkingDefault(DEFAULTS, "  openai/gpt-5.6-luna  "), "low");
+    });
+});
+//# sourceMappingURL=auto-model-router.test.js.map

package/dist/src/session/auto-model-router.test.js.map

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

package/dist/src/session/build-project-prompt.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 将 IM 下发的 agentContext 渲染为 GroupSystemPrompt 追加段。
+ */
+import type { Log } from "../plugin/auth.js";
+import { type RobotMentionAgentContext } from "./agent-context-types.js";
+import { type LocalRootSpec } from "../workspace/project-path-normalize.js";
+import type { XgImConfig } from "../plugin/types.js";
+export declare function resolvePromptMaxChars(config: XgImConfig): number;
+export interface AgentContextPromptInput {
+    agentContext: RobotMentionAgentContext;
+    config: XgImConfig;
+    workspaceHostRoot?: string;
+    log?: Log;
+}
+export interface AgentContextPromptResult {
+    block: string;
+    sandboxProjectPath?: string;
+}
+/** Agent 沙箱内可见的项目目录路径（供 Prompt / 工具使用） */
+export declare function resolveSandboxProjectPath(localRoot: LocalRootSpec, config: XgImConfig): {
+    sandboxPath: string;
+    workspaceRelativeSegment?: string;
+    hostNote?: string;
+    pathMode: "prefixed" | "relative" | "host";
+};
+export interface UserContextPromptInput {
+    senderId?: string;
+    senderName?: string;
+    senderBackground?: string;
+    config: XgImConfig;
+}
+/**
+ * 渲染当前发送者块（`userInfo.background` 由 IM 服务端拼接，写入 GroupSystemPrompt）。
+ */
+export declare function buildUserContextPromptBlock(input: UserContextPromptInput): string | undefined;
+/**
+ * 渲染项目工作区、目录用途、操作约束与可选项目背景（不含用户个人 background）。
+ */
+export declare function buildAgentContextPromptBlock(input: AgentContextPromptInput): AgentContextPromptResult;
+//# sourceMappingURL=build-project-prompt.d.ts.map

package/dist/src/session/build-project-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-project-prompt.d.ts","sourceRoot":"","sources":["../../../src/session/build-project-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAGH,KAAK,wBAAwB,EAChC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAGH,KAAK,aAAa,EACrB,MAAM,wCAAwC,CAAC;AAEhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAKrD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAIhE;AAED,MAAM,WAAW,uBAAuB;IACpC,YAAY,EAAE,wBAAwB,CAAC;IACvC,MAAM,EAAE,UAAU,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,GAAG,CAAC;CACb;AAED,MAAM,WAAW,wBAAwB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAQD,0CAA0C;AAC1C,wBAAgB,yBAAyB,CACrC,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,UAAU,GACnB;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,CAAA;CAAE,CAuB3H;AAOD,MAAM,WAAW,sBAAsB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,UAAU,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,GAAG,SAAS,CAmB7F;AAkCD;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,uBAAuB,GAAG,wBAAwB,CA8GrG"}

package/dist/src/session/build-project-prompt.js

@@ -0,0 +1,190 @@
+/**
+ * 将 IM 下发的 agentContext 渲染为 GroupSystemPrompt 追加段。
+ */
+import { isKnowledgeBaseByPath, isKnowledgeBaseByProjectIdOnly, } from "./agent-context-types.js";
+import { normalizeWorkspaceRelativeSegment, resolveLocalAbsolutePath, } from "../workspace/project-path-normalize.js";
+import { normalizeNasVolumesForPrompt } from "../workspace/nas-volumes.js";
+const DEFAULT_SANDBOX_PREFIX = "/workspace";
+const DEFAULT_PROJECT_PROMPT_MAX_CHARS = 15_000;
+export function resolvePromptMaxChars(config) {
+    return typeof config.projectPromptMaxChars === "number" && config.projectPromptMaxChars > 0
+        ? config.projectPromptMaxChars
+        : DEFAULT_PROJECT_PROMPT_MAX_CHARS;
+}
+function sandboxPrefix(config) {
+    const p = config.inboundMediaSandboxRootPrefix?.trim();
+    if (p && p.startsWith("/"))
+        return p.replace(/\/+$/, "");
+    return undefined;
+}
+/** Agent 沙箱内可见的项目目录路径（供 Prompt / 工具使用） */
+export function resolveSandboxProjectPath(localRoot, config) {
+    if (localRoot.kind === "host_absolute") {
+        return {
+            sandboxPath: localRoot.path.trim(),
+            hostNote: "该项目目录为宿主机绝对路径；沙箱 Agent 可能无法直接读写，请勿默认向该路径写入。",
+            pathMode: "host",
+        };
+    }
+    const rel = normalizeWorkspaceRelativeSegment(localRoot.path);
+    const prefix = sandboxPrefix(config);
+    if (!prefix) {
+        return {
+            sandboxPath: `./${rel}`,
+            workspaceRelativeSegment: rel,
+            pathMode: "relative",
+        };
+    }
+    return {
+        sandboxPath: `${prefix}/${rel}`,
+        workspaceRelativeSegment: rel,
+        pathMode: "prefixed",
+    };
+}
+function truncate(text, max) {
+    if (text.length <= max)
+        return text;
+    return `${text.slice(0, max)}\n\n…（内容已截断）`;
+}
+/**
+ * 渲染当前发送者块（`userInfo.background` 由 IM 服务端拼接，写入 GroupSystemPrompt）。
+ */
+export function buildUserContextPromptBlock(input) {
+    const bg = input.senderBackground?.trim();
+    if (!bg)
+        return undefined;
+    const lines = [];
+    lines.push("## 当前用户");
+    lines.push("");
+    const name = input.senderName?.trim();
+    const id = input.senderId?.trim();
+    if (name || id) {
+        const label = name || id || "未知用户";
+        const idPart = name && id ? `（userId=${id}）` : id ? `（userId=${id}）` : "";
+        lines.push(`发送者：${label}${idPart}`);
+        lines.push("");
+    }
+    lines.push(truncate(bg, resolvePromptMaxChars(input.config)));
+    return lines.join("\n");
+}
+function displayFolderPath(folderPath) {
+    let p = folderPath.trim().replace(/\\/g, "/");
+    while (p.startsWith("/"))
+        p = p.slice(1);
+    return p.replace(/\/+$/, "") || folderPath.trim();
+}
+function knowledgeBasePurposeLine(agentContext) {
+    const kb = agentContext.knowledgeBase;
+    if (!kb)
+        return undefined;
+    if (isKnowledgeBaseByPath(kb)) {
+        const folder = displayFolderPath(kb.folderPath);
+        return (`- **知识库资料**：本项目已与知识库（空间 \`${kb.projectId.trim()}\`）目录「${folder}」建立同步；` +
+            `来自知识库的文件会出现在项目根目录及子路径中，可作为背景资料使用。`);
+    }
+    if (isKnowledgeBaseByProjectIdOnly(kb)) {
+        return (`- **知识库资料**：本项目已与知识库空间 \`${kb.projectId.trim()}\` 关联；` +
+            `来自知识库的文件会出现在项目根目录及子路径中，可作为背景资料使用。`);
+    }
+    const fileId = kb.rootFileId.trim();
+    return (`- **知识库资料**：本项目已与知识库目录（fileId: \`${fileId}\`）建立同步；` +
+        `来自知识库的文件会出现在项目根目录及子路径中，可作为背景资料使用。`);
+}
+/**
+ * 渲染项目工作区、目录用途、操作约束与可选项目背景（不含用户个人 background）。
+ */
+export function buildAgentContextPromptBlock(input) {
+    const { agentContext, config, workspaceHostRoot, log } = input;
+    const lines = [];
+    const maxChars = resolvePromptMaxChars(config);
+    const pathInfo = agentContext.localRoot
+        ? resolveSandboxProjectPath(agentContext.localRoot, config)
+        : undefined;
+    const nasVolumes = normalizeNasVolumesForPrompt(agentContext.nasVolumes);
+    lines.push("## 当前项目");
+    if (pathInfo) {
+        lines.push("");
+        lines.push(`- 项目根目录：\`${pathInfo.sandboxPath}\``);
+        if (pathInfo.workspaceRelativeSegment) {
+            lines.push(`- Workspace 相对路径：\`${pathInfo.workspaceRelativeSegment}\``);
+            lines.push(`- 本条消息入站附件：\`${pathInfo.sandboxPath}/input\``);
+            if (pathInfo.pathMode === "relative") {
+                lines.push(`- 未配置 \`inboundMediaSandboxRootPrefix\`，默认采用 workspace 相对路径（\`./...\`）以兼容沙箱与非沙箱环境。`);
+                lines.push(`- 若当前运行时要求绝对前缀路径，请在通道配置中显式设置 \`inboundMediaSandboxRootPrefix\`（例如 \`${DEFAULT_SANDBOX_PREFIX}\`）。`);
+            }
+        }
+        if (pathInfo.hostNote) {
+            lines.push(`- ${pathInfo.hostNote}`);
+            lines.push(`- 注意：host_absolute 模式下附件落盘路径为宿主机绝对路径，沙箱 Agent 可能无法读取`);
+        }
+    }
+    if (nasVolumes.length > 0) {
+        lines.push("");
+        lines.push("### 本次会话文件目录");
+        lines.push("本次会话需要读取的文件位于以下已授权目录：");
+        for (const volume of nasVolumes) {
+            const access = volume.syncMode === "pull"
+                ? `${volume.mode === "ro" ? "只读" : "可读写"}，已从 NAS 同步到工作区`
+                : volume.syncMode === "push"
+                    ? `${volume.mode === "ro" ? "只读" : "可读写"}，工作区内容可同步回 NAS`
+                    : volume.mode === "ro"
+                        ? "只读挂载"
+                        : "可读写挂载";
+            lines.push(`- \`${volume.sandboxDir}\`（${access}）`);
+        }
+        const preferredWritePath = pathInfo?.sandboxPath ?? nasVolumes.find((volume) => volume.mode === "rw")?.sandboxDir;
+        if (preferredWritePath) {
+            lines.push(`- 首选文件写入目录：\`${preferredWritePath}\`${pathInfo ? "（localRoot 优先）" : ""}`);
+        }
+        else {
+            lines.push("- 当前 NAS 目录均为只读；不要尝试向这些目录写入文件。");
+        }
+    }
+    lines.push("");
+    lines.push("### 目录用途");
+    if (pathInfo) {
+        lines.push("- **项目产出**：项目相关文件的创建与修改应保存在项目根目录或其子目录下；子目录结构由已启用的 skill 决定。");
+    }
+    else {
+        const writableNas = nasVolumes.find((volume) => volume.mode === "rw");
+        lines.push(writableNas
+            ? `- **项目产出**：项目相关文件优先保存到可写目录 \`${writableNas.sandboxDir}\` 或其子目录。`
+            : "- **项目产出**：当前未指定可写项目目录；除非用户另有明确要求，不要向只读 NAS 目录写入。");
+    }
+    const kbLine = knowledgeBasePurposeLine(agentContext);
+    if (kbLine) {
+        lines.push(kbLine);
+    }
+    lines.push("");
+    lines.push("### 操作约束");
+    if (pathInfo) {
+        lines.push(nasVolumes.length > 0
+            ? "- 仅在本项目根目录及上述已授权 NAS 目录下处理项目相关文件；不要在 workspace 其他位置查找类似目录。"
+            : "- 仅在本项目根目录下处理项目相关文件；不要在 workspace 其他位置查找类似目录。");
+        lines.push("- 项目根目录可能尚无文件或仅有部分内容，向用户如实说明即可，不要猜测其他路径。");
+    }
+    else {
+        lines.push("- 仅在上述已授权 NAS 目录下读取或处理项目文件；不要在 workspace 其他位置查找类似目录。");
+    }
+    lines.push('- 对用户统一称为「本项目」，不要提及 OpenClaw workspace 等实现细节。');
+    if (workspaceHostRoot?.trim() && agentContext.localRoot?.kind === "workspace_relative") {
+        try {
+            resolveLocalAbsolutePath(agentContext.localRoot, workspaceHostRoot);
+        }
+        catch (e) {
+            log?.warn?.(`[agent-context] localRoot host resolve failed: ${String(e)}`);
+        }
+    }
+    const bg = agentContext.background?.trim();
+    if (bg) {
+        lines.push("");
+        lines.push("## 项目背景");
+        lines.push("");
+        lines.push(truncate(bg, maxChars));
+    }
+    return {
+        block: lines.join("\n"),
+        sandboxProjectPath: pathInfo?.sandboxPath,
+    };
+}
+//# sourceMappingURL=build-project-prompt.js.map

package/dist/src/session/build-project-prompt.js.map

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

package/dist/src/session/build-project-prompt.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=build-project-prompt.test.d.ts.map

package/dist/src/session/build-project-prompt.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-project-prompt.test.d.ts","sourceRoot":"","sources":["../../../src/session/build-project-prompt.test.ts"],"names":[],"mappings":""}

package/dist/src/session/build-project-prompt.test.js

@@ -0,0 +1,100 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { buildAgentContextPromptBlock } from "./build-project-prompt.js";
+const config = { baseUrl: "https://im.example.test" };
+describe("buildAgentContextPromptBlock nasVolumes", () => {
+    it("lists NAS directories and selects the first rw directory without localRoot", () => {
+        const result = buildAgentContextPromptBlock({
+            config,
+            agentContext: {
+                nasVolumes: [
+                    { realDir: "/data/touqian/a", dockerDir: "case/archive", mode: "ro" },
+                    { realDir: "/data/touqian/b", dockerDir: "case/output", mode: "rw" },
+                ],
+            },
+        });
+        assert.match(result.block, /本次会话需要读取的文件位于以下已授权目录/);
+        assert.match(result.block, /`\/workspace\/case\/archive`（只读挂载）/);
+        assert.match(result.block, /`\/workspace\/case\/output`（可读写挂载）/);
+        assert.match(result.block, /首选文件写入目录：`\/workspace\/case\/output`/);
+    });
+    it("prefers localRoot as the write directory", () => {
+        const result = buildAgentContextPromptBlock({
+            config,
+            agentContext: {
+                localRoot: { kind: "workspace_relative", path: "project/main" },
+                nasVolumes: [{ realDir: "/data/touqian/b", dockerDir: "case/output", mode: "rw" }],
+            },
+        });
+        assert.match(result.block, /首选文件写入目录：`\.\/project\/main`（localRoot 优先）/);
+    });
+    it("keeps the legacy prompt unchanged when nasVolumes is empty", () => {
+        const base = {
+            config,
+            agentContext: { localRoot: { kind: "workspace_relative", path: "project/main" } },
+        };
+        const omitted = buildAgentContextPromptBlock(base);
+        const empty = buildAgentContextPromptBlock({
+            ...base,
+            agentContext: { ...base.agentContext, nasVolumes: [] },
+        });
+        assert.equal(empty.block, omitted.block);
+        assert.ok(empty.block.includes("仅在本项目根目录下处理项目相关文件"));
+        assert.ok(!empty.block.includes("NAS"));
+    });
+    it("renders the touqian workbench context with the rw input directory as output", () => {
+        const background = [
+            "用户从工作台待办进入，请结合以下背景信息协助用户处理待办:",
+            "待办内容：Rezpegaldesleukin-Nektar Therapeutics-特应性皮炎，斑秃-初级BD快核",
+            "待办分类：产品引进-投前",
+            "分组名称：无",
+            "业务类型：touqian",
+            "业务ID：3090270000000000307",
+            "引用内容：使用bd-fast-review-revision这个skill进行处理，按BD首轮复核指示函的事项描述进行首轮核验。",
+            "引用技能：这是投前报告修订业务，处理待办的时候需要使用bd-fast-review-revision（skill）处理待办的流程",
+        ].join("\n");
+        const result = buildAgentContextPromptBlock({
+            config,
+            agentContext: {
+                nasVolumes: [
+                    {
+                        realDir: "/data/touqian/CP202205250005/deliverables",
+                        dockerDir: "touqian/2026/08/3090270000000000307/CP202205250005/deliverables",
+                        mode: "ro",
+                    },
+                    {
+                        realDir: "/data/touqian/CP202205250005/sequences/0000",
+                        dockerDir: "touqian/2026/08/3090270000000000307/CP202205250005/sequences/0000",
+                        mode: "ro",
+                    },
+                    {
+                        realDir: "/data/touqian/CP202205250005/sequences/0001/input",
+                        dockerDir: "touqian/2026/08/3090270000000000307/CP202205250005/sequences/0001/input",
+                        mode: "rw",
+                    },
+                ],
+                background,
+            },
+        });
+        assert.equal(result.block, `## 当前项目
+
+### 本次会话文件目录
+本次会话需要读取的文件位于以下已授权目录：
+- \`/workspace/touqian/2026/08/3090270000000000307/CP202205250005/deliverables\`（只读挂载）
+- \`/workspace/touqian/2026/08/3090270000000000307/CP202205250005/sequences/0000\`（只读挂载）
+- \`/workspace/touqian/2026/08/3090270000000000307/CP202205250005/sequences/0001/input\`（可读写挂载）
+- 首选文件写入目录：\`/workspace/touqian/2026/08/3090270000000000307/CP202205250005/sequences/0001/input\`
+
+### 目录用途
+- **项目产出**：项目相关文件优先保存到可写目录 \`/workspace/touqian/2026/08/3090270000000000307/CP202205250005/sequences/0001/input\` 或其子目录。
+
+### 操作约束
+- 仅在上述已授权 NAS 目录下读取或处理项目文件；不要在 workspace 其他位置查找类似目录。
+- 对用户统一称为「本项目」，不要提及 OpenClaw workspace 等实现细节。
+
+## 项目背景
+
+${background}`);
+    });
+});
+//# sourceMappingURL=build-project-prompt.test.js.map

package/dist/src/session/build-project-prompt.test.js.map

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

package/dist/src/session/inbound-model.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 入站模型选择：从 msgContent.ext.ai_model 解析三种模式（default / auto / explicit）。
+ * - default：未传或空值或控制命令 → 使用 Agent 默认配置。
+ * - auto：由 Auto Router 同时决定模型与推理等级。
+ * - explicit：严格使用指定模型，推理等级用该模型默认配置。
+ * 另从 msgContent.ext.ai_thinking 解析单轮推理强度（客户端按条指定）。
+ * 不注入正文、不伪造 /model 指令、不写 session。
+ */
+import type { WsMessageContent } from "../plugin/types.js";
+/** 客户端可按条指定的推理强度（与 OpenClaw ThinkLevel 的规范值对齐）。 */
+export declare const INBOUND_THINKING_LEVELS: readonly ["off", "minimal", "low", "medium", "high", "xhigh", "adaptive", "max", "ultra"];
+export type InboundThinkingLevel = (typeof INBOUND_THINKING_LEVELS)[number];
+/**
+ * 从 ext.ai_thinking 解析单轮推理强度（大小写不敏感，仅接受规范值）。
+ * 未传、非字符串、空白或非法值一律返回 undefined（由上层回落到既有默认）。
+ */
+export declare function parseInboundThinkingLevel(msgExt: WsMessageContent["ext"]): InboundThinkingLevel | undefined;
+/** 首行去掉 @ 前缀后是否为 slash 控制命令（/stop、/reset、/model、/think 等） */
+export declare function isInboundControlCommandMessage(displayText: string): boolean;
+/**
+ * 正文任意位置是否出现 `/think` 指令（含行内写法，如 `帮我总结 /think high`）。
+ * 首行控制命令已由 isInboundControlCommandMessage 排除，这里兜底行内指令：
+ * 只要存在用户显式 /think，Auto Router / 模型默认的 thinking 就让位。
+ */
+export declare function hasUserThinkDirective(displayText: string): boolean;
+export type InboundModelSelection = {
+    mode: "default";
+} | {
+    mode: "auto";
+} | {
+    mode: "explicit";
+    model: string;
+};
+/**
+ * 从 ext.ai_model 解析本条消息的模型选择模式。
+ * 控制命令忽略 IM 元数据；`auto`（不区分大小写、忽略首尾空白）为模式标识，不是真实模型名。
+ */
+export declare function extractInboundModelSelection(msgExt: WsMessageContent["ext"], displayText: string): InboundModelSelection;
+//# sourceMappingURL=inbound-model.d.ts.map

package/dist/src/session/inbound-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-model.d.ts","sourceRoot":"","sources":["../../../src/session/inbound-model.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,mDAAmD;AACnD,eAAO,MAAM,uBAAuB,2FAU1B,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E;;;GAGG;AACH,wBAAgB,yBAAyB,CACrC,MAAM,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAChC,oBAAoB,GAAG,SAAS,CAOlC;AAED,6DAA6D;AAC7D,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAI3E;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAElE;AAED,MAAM,MAAM,qBAAqB,GAC3B;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,4BAA4B,CACxC,MAAM,EAAE,gBAAgB,CAAC,KAAK,CAAC,EAC/B,WAAW,EAAE,MAAM,GACpB,qBAAqB,CAgBvB"}

package/dist/src/session/inbound-model.js

@@ -0,0 +1,66 @@
+/**
+ * 入站模型选择：从 msgContent.ext.ai_model 解析三种模式（default / auto / explicit）。
+ * - default：未传或空值或控制命令 → 使用 Agent 默认配置。
+ * - auto：由 Auto Router 同时决定模型与推理等级。
+ * - explicit：严格使用指定模型，推理等级用该模型默认配置。
+ * 另从 msgContent.ext.ai_thinking 解析单轮推理强度（客户端按条指定）。
+ * 不注入正文、不伪造 /model 指令、不写 session。
+ */
+/** 客户端可按条指定的推理强度（与 OpenClaw ThinkLevel 的规范值对齐）。 */
+export const INBOUND_THINKING_LEVELS = [
+    "off",
+    "minimal",
+    "low",
+    "medium",
+    "high",
+    "xhigh",
+    "adaptive",
+    "max",
+    "ultra",
+];
+/**
+ * 从 ext.ai_thinking 解析单轮推理强度（大小写不敏感，仅接受规范值）。
+ * 未传、非字符串、空白或非法值一律返回 undefined（由上层回落到既有默认）。
+ */
+export function parseInboundThinkingLevel(msgExt) {
+    const raw = msgExt?.ai_thinking;
+    if (typeof raw !== "string" || !raw.trim())
+        return undefined;
+    const key = raw.trim().toLowerCase();
+    return INBOUND_THINKING_LEVELS.includes(key)
+        ? key
+        : undefined;
+}
+/** 首行去掉 @ 前缀后是否为 slash 控制命令（/stop、/reset、/model、/think 等） */
+export function isInboundControlCommandMessage(displayText) {
+    const head = displayText.trim().split(/\r?\n/)[0]?.trim() ?? "";
+    const withoutLeads = head.replace(/^(@\S+\s+)+/u, "").trim();
+    return withoutLeads.startsWith("/");
+}
+/**
+ * 正文任意位置是否出现 `/think` 指令（含行内写法，如 `帮我总结 /think high`）。
+ * 首行控制命令已由 isInboundControlCommandMessage 排除，这里兜底行内指令：
+ * 只要存在用户显式 /think，Auto Router / 模型默认的 thinking 就让位。
+ */
+export function hasUserThinkDirective(displayText) {
+    return /\/think\b/i.test(displayText);
+}
+/**
+ * 从 ext.ai_model 解析本条消息的模型选择模式。
+ * 控制命令忽略 IM 元数据；`auto`（不区分大小写、忽略首尾空白）为模式标识，不是真实模型名。
+ */
+export function extractInboundModelSelection(msgExt, displayText) {
+    if (isInboundControlCommandMessage(displayText)) {
+        return { mode: "default" };
+    }
+    const raw = msgExt?.ai_model;
+    if (typeof raw !== "string" || !raw.trim()) {
+        return { mode: "default" };
+    }
+    const normalized = raw.trim();
+    if (normalized.toLowerCase() === "auto") {
+        return { mode: "auto" };
+    }
+    return { mode: "explicit", model: normalized };
+}
+//# sourceMappingURL=inbound-model.js.map

package/dist/src/session/inbound-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-model.js","sourceRoot":"","sources":["../../../src/session/inbound-model.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,mDAAmD;AACnD,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACnC,KAAK;IACL,SAAS;IACT,KAAK;IACL,QAAQ;IACR,MAAM;IACN,OAAO;IACP,UAAU;IACV,KAAK;IACL,OAAO;CACD,CAAC;AAIX;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACrC,MAA+B;IAE/B,MAAM,GAAG,GAAG,MAAM,EAAE,WAAW,CAAC;IAChC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;QAAE,OAAO,SAAS,CAAC;IAC7D,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAQ,uBAA6C,CAAC,QAAQ,CAAC,GAAG,CAAC;QAC/D,CAAC,CAAE,GAA4B;QAC/B,CAAC,CAAC,SAAS,CAAC;AACpB,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,8BAA8B,CAAC,WAAmB;IAC9D,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAChE,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7D,OAAO,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACrD,OAAO,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AAC1C,CAAC;AAOD;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CACxC,MAA+B,EAC/B,WAAmB;IAEnB,IAAI,8BAA8B,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,EAAE,QAAQ,CAAC;IAC7B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;QACzC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,UAAU,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;QACtC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACnD,CAAC"}

package/dist/src/session/inbound-model.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inbound-model.test.d.ts.map

package/dist/src/session/inbound-model.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-model.test.d.ts","sourceRoot":"","sources":["../../../src/session/inbound-model.test.ts"],"names":[],"mappings":""}