@xgjktech/xg_cwork_im 1.11.5 → 1.11.7

package/README.md

@@ -9,7 +9,7 @@ IM 系统  →  WebSocket  →  插件（本项目）  →  OpenClaw AI  →  IM
 ```
 
 1. 插件启动时用 `robotKey`（兼容旧字段 `appKey`）换取 `access_token` 和 `userId`
-2. 建立 WebSocket 长连接，接收 `robotMention` 事件
+2. 建立 WebSocket 长连接，接收带业务 `params` 的推送（当前代码会处理 **`robotMention`** 与 **`groupMessage`**，条件：`parsed.params` 存在且 `cmd` 为上述二者之一）
 3. 将收到的消息转发给 OpenClaw 处理
 4. OpenClaw AI 回复后，插件：
    - 先通过 WebSocket `START` 让 IM 端显示一条「思考中」占位消息；
@@ -226,19 +226,20 @@ openclaw gateway restart
 |---|---|---|---|
 | `baseUrl` | string | **必填** | IM 服务域名（API 接口地址） |
 | `wsBaseUrl` | string | — | **可选**。WebSocket 独立域名。若不填，插件将尝试自动映射。 |
-| `groupPolicy` | string | `"mention"` | `open`=收全部消息；`mention`=仅 @ 机器人触发 |
+| `groupPolicy` | string | `"mention"` | 用于 OpenClaw **`groups.resolveRequireMention`**：`"open"` 时返回「不必强制仅 @ 才参与提及策略」；`"mention"` 时返回「需要 @」。**注意**：网关 **`handleMessage` 是否把消息交给 AI** 仅取决于 **`actuallyMentioned`**（`mentions` 含机器人 `userId` 或 **`"all"`**，或旧版正文匹配 `@机器人名`）。**`groupPolicy: open` 不会**变成「群里任意发言都自动触发 AI」；未 @ 时仍会 **recordInboundSession** 记记忆，但不走 `dispatchMentionedReply`。 |
 | `enabled` | boolean | `true` | 是否启用 |
 | `debug` | boolean | `false` | 开启调试日志 |
-| `maxConnectionAttempts` | number | `10` | WebSocket 最大重连次数 |
+| `maxConnectionAttempts` | number | 见下 | Channel 配置经 Zod 校验时默认 **`10`**（`channel.ts` 中 `XgImConfigSchema`）。`connection.ts` 读取配置时若该字段仍为 **`undefined`**，则回退为 **`200`**。建议在 `openclaw.json` 中显式填写以避免与直觉不一致。 |
 | `initialReconnectDelay` | number | `1000` | 初始重连延迟（ms） |
 | `maxReconnectDelay` | number | `60000` | 最大重连延迟（ms） |
 | `reconnectJitter` | number | `0.3` | 重连抖动因子（0-1） |
-| `firstReplyTimeoutMs` | number | `300000` | **首条 AI 回复超时时间（毫秒）**。用于保护「思考中」占位消息：若在该时间窗口内 AI 没有任何回复，则自动将占位消息更新为「当前请求处理超时，请稍后重试」。|
+| `firstReplyTimeoutMs` | number | `1800000`（30 分钟） | **首条 AI 回复超时时间（毫秒）**。未配置时代码使用 **`30 * 60_000`**（`channel.ts` 中 `dispatchMentionedReply`）。超时后通过 HTTP 将占位更新为超时提示。该键目前**未**写入 `XgImConfigSchema`，仅作为运行时字段生效（`types.ts` 中有类型说明）。 |
 | `inboundMediaWorkspaceSubdir` | string | — | **可选**。非空时，将入站附件先下载到**当前 Agent workspace** 下该**相对子目录**（如 `xg_im_inbound`），路径约定：`{子目录}/{发送者 userId}/{YYYY-MM-DD}/{文件名}_{HHmmssmmm}.ext`（时间为本机写入时刻），再向 OpenClaw 传入 **MediaPath**；默认使用 **workspace 相对路径**（如 `./xg_im_inbound/...`），便于 **沙箱** 将 `/workspace` 映射到同一套目录树；未配置则仍使用 IM 返回的 URL。需 runtime 提供 `resolveAgentWorkspaceDir`。 |
 | `inboundMediaOpenClawPath` | string | `workspaceRelative`（默认） | `workspaceRelative`：入站落盘后 `MediaPath` 为 `./子目录/...`（若配置了 `inboundMediaSandboxRootPrefix` 则为该前缀 + 相对路径，如 `/workspace/xg_im_inbound/...`）；`absoluteFileUrl`：宿主机 `file://...`（仅适合无沙箱、网关与 Agent 同盘场景）。 |
 | `inboundMediaSandboxRootPrefix` | string | — | **可选**。沙箱内 workspace 挂载根，填 **`/workspace`** 时，在 `workspaceRelative` 模式下 `MediaPath` 为 **`/workspace/xg_im_inbound/...`**，避免 `./` 被 `read` 等工具按**进程 cwd**解析导致「不可访问」。须以 `/` 开头。 |
+| `syncServiceBaseUrl` | string | — | **可选**。openclaw-xgkb-sync **管理 API** 根地址（如 `http://127.0.0.1:9090`）。配置后插件可处理 IM 下发的 `openclawApplySyncMapping` 信令并登记目录映射。详见 `docs/im服务接口说明.md`。 |
 
-### 账户配置（`accounts.<accountId>` / `accounts[n]`）
+### 账户配置（`accounts.<accountId>`，对象 map）
 
 | 选项 | 类型 | 默认值 | 说明 |
 |---|---|---|---|
@@ -249,6 +250,11 @@ openclaw gateway restart
 | `inboundMediaWorkspaceSubdir` | string | 继承顶层 | 可覆盖顶层的入站附件落盘子目录 |
 | `inboundMediaOpenClawPath` | string | 继承顶层 | 可覆盖顶层的 MediaPath 形式（相对路径 vs file://） |
 | `inboundMediaSandboxRootPrefix` | string | 继承顶层 | 可覆盖沙箱根前缀（如 `/workspace`） |
+| `syncServiceBaseUrl` | string | 继承顶层 | 可覆盖同步服务管理 API 地址 |
+
+### Agent 工具（`optional: true`）
+
+`xg_cwork_im_get_group_chat_history` 与 `xg_cwork_im_send_group_message` 在 `index.ts` 中以 **`api.registerTool(..., { optional: true })`** 注册。需在对应 Agent 的 **`tools.allow`**（或你们环境中的工具白名单配置）中**显式加入**上述工具名后，模型才会在运行时获得它们。
 
 ---
 
@@ -293,7 +299,12 @@ openclaw-channel-xg-cwork-im/
 │   ├── group-history-tool.ts      # 拉取群消息历史的 Agent Tool
 │   ├── send-group-message-tool.ts # 发送群消息的 Agent Tool
 │   ├── inbound-media-local.ts   # 可选：入站附件落盘到 workspace 子目录
-│   └── channel.ts          # Channel Plugin 主定义
+│   ├── channel.ts          # Channel 组装（meta / config / outbound / gateway）
+│   ├── channel-config.ts   # Zod schema、getXgImConfig、GroupSystemPrompt、命令门控
+│   ├── channel-log.ts      # toLogger 适配
+│   ├── inbound-display.ts  # 入站正文、@ 判定、MediaPath(s)、UntrustedContext
+│   ├── dispatch-mentioned-reply.ts  # OpenClaw 派发 + 流式 + HTTP deliver
+│   ├── gateway-session-queue.ts    # 按 session 排队与 /stop 清队列
 ├── package.json
 ├── tsconfig.json
 ├── openclaw.plugin.json

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EAAE,uCAAuC,EAAE,MAAM,oCAAoC,CAAC;AAE7F,QAAA,MAAM,MAAM,EAAE,qBAmBb,CAAC;AAEF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EAAE,uCAAuC,EAAE,MAAM,oCAAoC,CAAC;AAW7F,QAAA,MAAM,MAAM,EAAE,qBAmCb,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -16,13 +16,18 @@ const plugin = {
     register(api) {
         setXgImRuntime(api.runtime);
         api.registerChannel({ plugin: xgCworkImChannelPlugin });
-        // 注册 AI 工具（静态工具对象，确保 toolNames 正确注册）
-        const cworkConfig = extractXgCworkImConfig(api.config);
-        if (cworkConfig) {
-            // 工具涉及网络请求 / 副作用，按文档要求标记为 optional，由用户在 Agent 的 tools.allow 中显式启用
-            api.registerTool(buildGroupHistoryTool(cworkConfig), { optional: true });
-            // 主动推送（Cron/定时等）向 IM 发纯文本；用户经 IM 对话时不用此工具
-            api.registerTool(buildSendGroupMessageTool(cworkConfig), { optional: true });
+        // 必须使用工厂 `(ctx) => tool`：OpenClaw 文档化行为为「静态工具等价于 (_ctx)=>tool」，会丢弃每回合的
+        // runtimeConfig / agentAccountId / requesterSenderId；工厂才能在执行前重建工具并打通鉴权与多账户路由。
+        const snapshot = extractXgCworkImConfig(api.config);
+        if (snapshot?.baseUrl) {
+            const resolveToolConfig = (ctx) => extractXgCworkImConfig(ctx.getRuntimeConfig?.() ?? ctx.runtimeConfig ?? ctx.config ?? api.config) ??
+                snapshot;
+            const sessionHints = (ctx) => ({
+                channelAccountId: ctx.agentAccountId ?? undefined,
+                requesterSenderId: ctx.requesterSenderId ?? undefined,
+            });
+            api.registerTool((ctx) => buildGroupHistoryTool(resolveToolConfig(ctx), sessionHints(ctx)), { optional: true });
+            api.registerTool((ctx) => buildSendGroupMessageTool(resolveToolConfig(ctx), sessionHints(ctx)), { optional: true });
         }
         else {
             console.warn("[xg_cwork_im] channel config not found, skipping tool registration");

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC5F,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAG7E,OAAO,EAAE,uCAAuC,EAAE,MAAM,oCAAoC,CAAC;AAE7F,MAAM,MAAM,GAA0B;IAClC,EAAE,EAAE,aAAa;IACjB,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,2CAA2C;IACxD,YAAY,EAAE,uBAAuB,EAAE;IACvC,QAAQ,CAAC,GAAsB;QAC3B,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5B,GAAG,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAC;QACxD,qCAAqC;QACrC,MAAM,WAAW,GAAG,sBAAsB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvD,IAAI,WAAW,EAAE,CAAC;YACd,kEAAkE;YAClE,GAAG,CAAC,YAAY,CAAC,qBAAqB,CAAC,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YACzE,0CAA0C;YAC1C,GAAG,CAAC,YAAY,CAAC,yBAAyB,CAAC,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACjF,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;QACvF,CAAC;IACL,CAAC;CACJ,CAAC;AAEF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC5F,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAG7E,OAAO,EAAE,uCAAuC,EAAE,MAAM,oCAAoC,CAAC;AAW7F,MAAM,MAAM,GAA0B;IAClC,EAAE,EAAE,aAAa;IACjB,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,2CAA2C;IACxD,YAAY,EAAE,uBAAuB,EAAE;IACvC,QAAQ,CAAC,GAAsB;QAC3B,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5B,GAAG,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAC;QACxD,uEAAuE;QACvE,8EAA8E;QAC9E,MAAM,QAAQ,GAAG,sBAAsB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,QAAQ,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,iBAAiB,GAAG,CAAC,GAA0B,EAAE,EAAE,CACrD,sBAAsB,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,IAAI,GAAG,CAAC,aAAa,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC;gBACjG,QAAQ,CAAC;YAEb,MAAM,YAAY,GAAG,CAAC,GAA0B,EAAE,EAAE,CAAC,CAAC;gBAClD,gBAAgB,EAAE,GAAG,CAAC,cAAc,IAAI,SAAS;gBACjD,iBAAiB,EAAE,GAAG,CAAC,iBAAiB,IAAI,SAAS;aACxD,CAAC,CAAC;YAEH,GAAG,CAAC,YAAY,CACZ,CAAC,GAA0B,EAAE,EAAE,CAC3B,qBAAqB,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,EACpE,EAAE,QAAQ,EAAE,IAAI,EAAE,CACrB,CAAC;YACF,GAAG,CAAC,YAAY,CACZ,CAAC,GAA0B,EAAE,EAAE,CAC3B,yBAAyB,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,EACxE,EAAE,QAAQ,EAAE,IAAI,EAAE,CACrB,CAAC;QACN,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;QACvF,CAAC;IACL,CAAC;CACJ,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/src/agent-context-types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * robotMention.params.agentContext — 精简版：工作区路径 + 可选项目背景
+ */
+import { z } from "zod";
+/** 与 IM 后台约定的 `params.agentContext` 结构 */
+export declare const robotMentionAgentContextSchema: z.ZodObject<{
+    localRoot: z.ZodObject<{
+        kind: z.ZodEnum<["workspace_relative", "host_absolute"]>;
+        path: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        kind: "workspace_relative" | "host_absolute";
+    }, {
+        path: string;
+        kind: "workspace_relative" | "host_absolute";
+    }>;
+    background: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    localRoot: {
+        path: string;
+        kind: "workspace_relative" | "host_absolute";
+    };
+    background?: string | undefined;
+}, {
+    localRoot: {
+        path: string;
+        kind: "workspace_relative" | "host_absolute";
+    };
+    background?: string | undefined;
+}>;
+export type RobotMentionAgentContext = z.infer<typeof robotMentionAgentContextSchema>;
+export declare function parseRobotMentionAgentContext(params: unknown): RobotMentionAgentContext | undefined;
+//# sourceMappingURL=agent-context-types.d.ts.map

package/dist/src/agent-context-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-context-types.d.ts","sourceRoot":"","sources":["../../src/agent-context-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,0CAA0C;AAC1C,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;EAGzC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,OAAO,GAAG,wBAAwB,GAAG,SAAS,CAUnG"}

package/dist/src/agent-context-types.js

@@ -0,0 +1,26 @@
+/**
+ * robotMention.params.agentContext — 精简版：工作区路径 + 可选项目背景
+ */
+import { z } from "zod";
+import { LOCAL_ROOT_KINDS } from "./project-path-normalize.js";
+const localRootSchema = z.object({
+    kind: z.enum(LOCAL_ROOT_KINDS),
+    path: z.string().min(1),
+});
+/** 与 IM 后台约定的 `params.agentContext` 结构 */
+export const robotMentionAgentContextSchema = z.object({
+    localRoot: localRootSchema,
+    background: z.string().optional(),
+});
+export function parseRobotMentionAgentContext(params) {
+    if (params == null || typeof params !== "object") {
+        return undefined;
+    }
+    const raw = params.agentContext;
+    if (raw == null || typeof raw !== "object") {
+        return undefined;
+    }
+    const parsed = robotMentionAgentContextSchema.safeParse(raw);
+    return parsed.success ? parsed.data : undefined;
+}
+//# sourceMappingURL=agent-context-types.js.map

package/dist/src/agent-context-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-context-types.js","sourceRoot":"","sources":["../../src/agent-context-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC1B,CAAC,CAAC;AAEH,0CAA0C;AAC1C,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,SAAS,EAAE,eAAe;IAC1B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAIH,MAAM,UAAU,6BAA6B,CAAC,MAAe;IACzD,IAAI,MAAM,IAAI,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/C,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,MAAM,GAAG,GAAI,MAAkC,CAAC,YAAY,CAAC;IAC7D,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACzC,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,MAAM,MAAM,GAAG,8BAA8B,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7D,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACpD,CAAC"}

package/dist/src/apply-sync-mapping.d.ts

@@ -0,0 +1,17 @@
+/**
+
+ * 处理 IM WebSocket 下发的 openclawApplySyncMapping 信令。
+
+ */
+import type { OpenClawConfig } from "openclaw/plugin-sdk";
+import type { Log } from "./auth.js";
+import type { XgImConfig } from "./types.js";
+export interface ApplySyncMappingContext {
+    config: XgImConfig;
+    cfg: OpenClawConfig;
+    rt: unknown;
+    log: Log;
+    logPrefix: string;
+}
+export declare function applySyncMappingFromWsParams(ctx: ApplySyncMappingContext, rawParams: unknown): Promise<void>;
+//# sourceMappingURL=apply-sync-mapping.d.ts.map

package/dist/src/apply-sync-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-sync-mapping.d.ts","sourceRoot":"","sources":["../../src/apply-sync-mapping.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAUrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAU7C,MAAM,WAAW,uBAAuB;IAEpC,MAAM,EAAE,UAAU,CAAC;IAEnB,GAAG,EAAE,cAAc,CAAC;IAEpB,EAAE,EAAE,OAAO,CAAC;IAEZ,GAAG,EAAE,GAAG,CAAC;IAET,SAAS,EAAE,MAAM,CAAC;CAErB;AAID,wBAAsB,4BAA4B,CAE9C,GAAG,EAAE,uBAAuB,EAE5B,SAAS,EAAE,OAAO,GAEnB,OAAO,CAAC,IAAI,CAAC,CAwDf"}

package/dist/src/apply-sync-mapping.js

@@ -0,0 +1,86 @@
+/**
+
+ * 处理 IM WebSocket 下发的 openclawApplySyncMapping 信令。
+
+ */
+import { normalizeRemoteRootFolderPath, resolveLocalAbsolutePath } from "./project-path-normalize.js";
+import { resolveAgentWorkspaceDirFromRuntime } from "./inbound-media-local.js";
+import { parseSyncMappingParams } from "./sync-mapping-types.js";
+import { deleteSyncMapping, upsertSyncMapping } from "./sync-service-client.js";
+const DEFAULT_FILE_PATTERNS = ["**/*"];
+const DEFAULT_EXCLUDE = ["**/_conflict_*", "**/.tmp/**", "**/.openclaw/**"];
+export async function applySyncMappingFromWsParams(ctx, rawParams) {
+    const { config, cfg, rt, log, logPrefix } = ctx;
+    const syncBase = config.syncServiceBaseUrl?.trim();
+    if (!syncBase) {
+        log.warn?.(`${logPrefix} [sync-mapping] received openclawApplySyncMapping but syncServiceBaseUrl is not configured; ignored`);
+        return;
+    }
+    let params;
+    try {
+        params = parseSyncMappingParams(rawParams);
+    }
+    catch (e) {
+        log.error(`${logPrefix} [sync-mapping] invalid params: ${String(e)}`);
+        return;
+    }
+    if (params.action === "delete") {
+        try {
+            await deleteSyncMapping(syncBase, params.mappingId, log);
+        }
+        catch (e) {
+            log.error(`${logPrefix} [sync-mapping] delete failed: ${String(e)}`);
+        }
+        return;
+    }
+    await applyUpsert(ctx, syncBase, params);
+}
+async function applyUpsert(ctx, syncBase, params) {
+    const { config, cfg, rt, log, logPrefix } = ctx;
+    const localRoot = params.localRoot;
+    let remoteRootFolderPath;
+    try {
+        remoteRootFolderPath = normalizeRemoteRootFolderPath(params.remoteRootFolderPath);
+    }
+    catch (e) {
+        log.error(`${logPrefix} [sync-mapping] remote path: ${String(e)}`);
+        return;
+    }
+    const workspaceHost = localRoot.kind === "workspace_relative"
+        ? resolveAgentWorkspaceDirFromRuntime(rt, cfg)
+        : undefined;
+    let resolvedLocalAbs;
+    try {
+        resolvedLocalAbs = resolveLocalAbsolutePath(localRoot, workspaceHost);
+    }
+    catch (e) {
+        log.error(`${logPrefix} [sync-mapping] resolve local path: ${String(e)}`);
+        return;
+    }
+    const syncOpts = params.sync;
+    const filePatterns = syncOpts?.filePatterns && syncOpts.filePatterns.length > 0
+        ? syncOpts.filePatterns
+        : DEFAULT_FILE_PATTERNS;
+    const excludePatterns = syncOpts?.excludePatterns && syncOpts.excludePatterns.length > 0
+        ? syncOpts.excludePatterns
+        : DEFAULT_EXCLUDE;
+    const body = {
+        mappingId: params.mappingId,
+        localRoot: resolvedLocalAbs,
+        enabled: params.enabled ?? true,
+        appKey: params.appKey.trim(),
+        remoteRootFolderPath,
+        ...(params.kbProjectId?.trim() ? { projectId: params.kbProjectId.trim() } : {}),
+        filePatterns,
+        excludePatterns,
+        ...(syncOpts?.direction ? { syncDirection: syncOpts.direction } : {}),
+    };
+    log.info(`${logPrefix} [sync-mapping] upsert mappingId=${params.mappingId} localRoot=${resolvedLocalAbs} remote=${remoteRootFolderPath} agent=${config.agentId ?? "main"}`);
+    try {
+        await upsertSyncMapping(syncBase, params.mappingId, body, log);
+    }
+    catch (e) {
+        log.error(`${logPrefix} [sync-mapping] upsert failed: ${String(e)}`);
+    }
+}
+//# sourceMappingURL=apply-sync-mapping.js.map

package/dist/src/apply-sync-mapping.js.map

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

package/dist/src/auth.d.ts

@@ -1,7 +1,7 @@
 /**
  * XG-IM 认证模块
  *
- * 通过 appKey 换取 access_token 和机器人 userId。
+ * 通过 robotKey（或兼容旧字段 appKey）换取 access_token 和机器人 userId。
  * token 有效期一年，启动时获取一次并缓存，无需定期刷新。
  */
 import type { BotIdentity, XgImConfig } from "./types.js";
@@ -12,7 +12,7 @@ export type Log = {
     debug?: (msg: string) => void;
 };
 /**
- * 通过 appKey 获取机器人身份信息（token + userId）。
+ * 通过 robotKey 获取机器人身份信息（token + userId）。
  * 若缓存中已有有效 token，直接返回缓存；否则请求接口。
  *
  * @param config  插件配置

package/dist/src/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAoB,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5E,MAAM,MAAM,GAAG,GAAG;IACd,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,CAAC;AAKF;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC1B,MAAM,EAAE,UAAU,EAClB,GAAG,CAAC,EAAE,GAAG,EACT,KAAK,UAAQ,GACd,OAAO,CAAC,WAAW,CAAC,CAwCtB;AAED,oCAAoC;AACpC,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAGxD"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAoB,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5E,MAAM,MAAM,GAAG,GAAG;IACd,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,CAAC;AAKF;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC1B,MAAM,EAAE,UAAU,EAClB,GAAG,CAAC,EAAE,GAAG,EACT,KAAK,UAAQ,GACd,OAAO,CAAC,WAAW,CAAC,CA4CtB;AAED,oCAAoC;AACpC,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAKxD"}

package/dist/src/auth.js

@@ -1,14 +1,15 @@
 /**
  * XG-IM 认证模块
  *
- * 通过 appKey 换取 access_token 和机器人 userId。
+ * 通过 robotKey（或兼容旧字段 appKey）换取 access_token 和机器人 userId。
  * token 有效期一年，启动时获取一次并缓存，无需定期刷新。
  */
 import axios from "axios";
-/** 运行时 token 缓存，按 appKey 索引 */
+import { normalizeRobotKey } from "./channel-config.js";
+/** 运行时 token 缓存，按 baseUrl + robotKey 索引 */
 const tokenCache = new Map();
 /**
- * 通过 appKey 获取机器人身份信息（token + userId）。
+ * 通过 robotKey 获取机器人身份信息（token + userId）。
  * 若缓存中已有有效 token，直接返回缓存；否则请求接口。
  *
  * @param config  插件配置
@@ -16,19 +17,21 @@ const tokenCache = new Map();
  * @param force   强制重新获取（忽略缓存）
  */
 export async function getToken(config, log, force = false) {
-    if (!config.appKey) {
-        throw new Error("[cwork_im] appKey is required");
+    const normalized = normalizeRobotKey(config);
+    const robotKey = normalized.appKey?.trim();
+    if (!robotKey) {
+        throw new Error("[cwork_im] robotKey is required (set channels.xg_cwork_im.robotKey or accounts.<id>.robotKey)");
     }
-    const cacheKey = `${config.baseUrl}:${config.appKey}`;
+    const cacheKey = `${normalized.baseUrl}:${robotKey}`;
     if (!force) {
         const cached = tokenCache.get(cacheKey);
         if (cached) {
-            log?.info?.(`[cwork_im] Using cached token for appKey=${config.appKey}`);
+            log?.info?.(`[cwork_im] Using cached token for robotKey=${robotKey}`);
             return cached;
         }
     }
-    const url = `${config.baseUrl}/user/login/appkey?appKey=${encodeURIComponent(config.appKey)}&appCode=im`;
-    log?.info(`[cwork_im:auth] GET ${url} appKey=${config.appKey}`);
+    const url = `${normalized.baseUrl}/user/login/appkey?appKey=${encodeURIComponent(robotKey)}&appCode=im`;
+    log?.info(`[cwork_im:auth] GET ${url} robotKey=${robotKey}`);
     const response = await axios.get(url, {
         headers: { "Content-Type": "application/json" },
         timeout: 10_000,
@@ -44,12 +47,15 @@ export async function getToken(config, log, force = false) {
         name: body.data.userName ?? "bot",
     };
     tokenCache.set(cacheKey, identity);
-    log?.info(`[cwork_im:auth] Token acquired: userId=${identity.userId} name=${identity.name} appKey=${config.appKey}`);
+    log?.info(`[cwork_im:auth] Token acquired: userId=${identity.userId} name=${identity.name} robotKey=${robotKey}`);
     return identity;
 }
 /** 清除指定账户的 token 缓存（用于重连时强制重新鉴权） */
 export function clearTokenCache(config) {
-    const cacheKey = `${config.baseUrl}:${config.appKey}`;
-    tokenCache.delete(cacheKey);
+    const normalized = normalizeRobotKey(config);
+    const robotKey = normalized.appKey?.trim();
+    if (!robotKey || !normalized.baseUrl)
+        return;
+    tokenCache.delete(`${normalized.baseUrl}:${robotKey}`);
 }
 //# sourceMappingURL=auth.js.map

package/dist/src/auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAU1B,+BAA+B;AAC/B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAuB,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC1B,MAAkB,EAClB,GAAS,EACT,KAAK,GAAG,KAAK;IAEb,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACrD,CAAC;IACD,MAAM,QAAQ,GAAG,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;IAEtD,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,MAAM,EAAE,CAAC;YACT,GAAG,EAAE,IAAI,EAAE,CAAC,4CAA4C,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YACzE,OAAO,MAAM,CAAC;QAClB,CAAC;IACL,CAAC;IAED,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,OAAO,6BAA6B,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC;IACzG,GAAG,EAAE,IAAI,CAAC,uBAAuB,GAAG,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAEhE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAmB,GAAG,EAAE;QACpD,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,OAAO,EAAE,MAAM;KAClB,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,GAAG,EAAE,IAAI,CAAC,mCAAmC,QAAQ,CAAC,MAAM,eAAe,IAAI,EAAE,UAAU,IAAI,KAAK,EAAE,CAAC,CAAC;IACxG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACX,qDAAqD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAC9E,CAAC;IACN,CAAC;IAED,MAAM,QAAQ,GAAgB;QAC1B,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO;QACxB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,KAAK;KACpC,CAAC;IAEF,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACnC,GAAG,EAAE,IAAI,CAAC,0CAA0C,QAAQ,CAAC,MAAM,SAAS,QAAQ,CAAC,IAAI,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAErH,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,eAAe,CAAC,MAAkB;IAC9C,MAAM,QAAQ,GAAG,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;IACtD,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC"}
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAUxD,2CAA2C;AAC3C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAuB,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC1B,MAAkB,EAClB,GAAS,EACT,KAAK,GAAG,KAAK;IAEb,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACX,+FAA+F,CAClG,CAAC;IACN,CAAC;IACD,MAAM,QAAQ,GAAG,GAAG,UAAU,CAAC,OAAO,IAAI,QAAQ,EAAE,CAAC;IAErD,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,MAAM,EAAE,CAAC;YACT,GAAG,EAAE,IAAI,EAAE,CAAC,8CAA8C,QAAQ,EAAE,CAAC,CAAC;YACtE,OAAO,MAAM,CAAC;QAClB,CAAC;IACL,CAAC;IAED,MAAM,GAAG,GAAG,GAAG,UAAU,CAAC,OAAO,6BAA6B,kBAAkB,CAAC,QAAQ,CAAC,aAAa,CAAC;IACxG,GAAG,EAAE,IAAI,CAAC,uBAAuB,GAAG,aAAa,QAAQ,EAAE,CAAC,CAAC;IAE7D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAmB,GAAG,EAAE;QACpD,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,OAAO,EAAE,MAAM;KAClB,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,GAAG,EAAE,IAAI,CAAC,mCAAmC,QAAQ,CAAC,MAAM,eAAe,IAAI,EAAE,UAAU,IAAI,KAAK,EAAE,CAAC,CAAC;IACxG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACX,qDAAqD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAC9E,CAAC;IACN,CAAC;IAED,MAAM,QAAQ,GAAgB;QAC1B,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO;QACxB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,KAAK;KACpC,CAAC;IAEF,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACnC,GAAG,EAAE,IAAI,CAAC,0CAA0C,QAAQ,CAAC,MAAM,SAAS,QAAQ,CAAC,IAAI,aAAa,QAAQ,EAAE,CAAC,CAAC;IAElH,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,eAAe,CAAC,MAAkB;IAC9C,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAI,CAAC,QAAQ,IAAI,CAAC,UAAU,CAAC,OAAO;QAAE,OAAO;IAC7C,UAAU,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,OAAO,IAAI,QAAQ,EAAE,CAAC,CAAC;AAC3D,CAAC"}

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

@@ -0,0 +1,28 @@
+/**
+ * 将 IM 下发的 agentContext 渲染为 GroupSystemPrompt 追加段。
+ */
+import type { Log } from "./auth.js";
+import { type LocalRootSpec } from "./project-path-normalize.js";
+import type { RobotMentionAgentContext } from "./agent-context-types.js";
+import type { XgImConfig } from "./types.js";
+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;
+};
+/**
+ * 渲染项目工作区 + 可选项目背景 + 入站落盘说明（不含用户个人 background）。
+ */
+export declare function buildAgentContextPromptBlock(input: AgentContextPromptInput): AgentContextPromptResult;
+//# sourceMappingURL=build-project-prompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build-project-prompt.d.ts","sourceRoot":"","sources":["../../src/build-project-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAGH,KAAK,aAAa,EACrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK7C,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;AAOD,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,CAAA;CAAE,CAc/E;AAgBD;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,uBAAuB,GAAG,wBAAwB,CAgDrG"}

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

@@ -0,0 +1,86 @@
+/**
+ * 将 IM 下发的 agentContext 渲染为 GroupSystemPrompt 追加段。
+ */
+import { normalizeWorkspaceRelativeSegment, resolveLocalAbsolutePath, } from "./project-path-normalize.js";
+const DEFAULT_SANDBOX_PREFIX = "/workspace";
+const DEFAULT_PROJECT_PROMPT_MAX_CHARS = 12_000;
+function sandboxPrefix(config) {
+    const p = config.inboundMediaSandboxRootPrefix?.trim();
+    return p && p.startsWith("/") ? p.replace(/\/+$/, "") : DEFAULT_SANDBOX_PREFIX;
+}
+/** Agent 沙箱内可见的项目目录路径（供 Prompt / 工具使用） */
+export function resolveSandboxProjectPath(localRoot, config) {
+    if (localRoot.kind === "host_absolute") {
+        return {
+            sandboxPath: localRoot.path.trim(),
+            hostNote: "该项目目录为宿主机绝对路径；沙箱 Agent 可能无法直接读写，请勿默认向该路径写入。",
+        };
+    }
+    const rel = normalizeWorkspaceRelativeSegment(localRoot.path);
+    const prefix = sandboxPrefix(config);
+    return {
+        sandboxPath: `${prefix}/${rel}`,
+        workspaceRelativeSegment: rel,
+    };
+}
+function truncate(text, max) {
+    if (text.length <= max)
+        return text;
+    return `${text.slice(0, max)}\n\n…（内容已截断）`;
+}
+function inboundMediaPromptLines(config, sandboxPrefixValue) {
+    const sub = config.inboundMediaWorkspaceSubdir?.trim();
+    if (!sub)
+        return [];
+    const normalized = sub.replace(/^\/+/, "").replace(/\/+$/, "");
+    return [
+        `- 用户从 IM 上传的附件会落盘到 \`${normalized}\`（路径约为 \`${sandboxPrefixValue}/${normalized}/…\`）`,
+    ];
+}
+/**
+ * 渲染项目工作区 + 可选项目背景 + 入站落盘说明（不含用户个人 background）。
+ */
+export function buildAgentContextPromptBlock(input) {
+    const { agentContext, config, workspaceHostRoot, log } = input;
+    const lines = [];
+    const maxChars = typeof config.projectPromptMaxChars === "number" && config.projectPromptMaxChars > 0
+        ? config.projectPromptMaxChars
+        : DEFAULT_PROJECT_PROMPT_MAX_CHARS;
+    const pathInfo = resolveSandboxProjectPath(agentContext.localRoot, config);
+    lines.push("## 项目工作区");
+    lines.push("");
+    lines.push(`- 读写项目文件请使用: \`${pathInfo.sandboxPath}\``);
+    if (pathInfo.workspaceRelativeSegment) {
+        lines.push(`- 对应该 Agent workspace 根下的 \`${pathInfo.workspaceRelativeSegment}\``);
+    }
+    if (pathInfo.hostNote) {
+        lines.push(`- ${pathInfo.hostNote}`);
+    }
+    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 mediaLines = inboundMediaPromptLines(config, sandboxPrefix(config));
+    if (mediaLines.length > 0) {
+        lines.push("");
+        lines.push("## 入站附件");
+        lines.push("");
+        lines.push(...mediaLines);
+    }
+    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/build-project-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-project-prompt.js","sourceRoot":"","sources":["../../src/build-project-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACH,iCAAiC,EACjC,wBAAwB,GAE3B,MAAM,6BAA6B,CAAC;AAIrC,MAAM,sBAAsB,GAAG,YAAY,CAAC;AAC5C,MAAM,gCAAgC,GAAG,MAAM,CAAC;AAchD,SAAS,aAAa,CAAC,MAAkB;IACrC,MAAM,CAAC,GAAG,MAAM,CAAC,6BAA6B,EAAE,IAAI,EAAE,CAAC;IACvD,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC;AACnF,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,yBAAyB,CACrC,SAAwB,EACxB,MAAkB;IAElB,IAAI,SAAS,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QACrC,OAAO;YACH,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE;YAClC,QAAQ,EACJ,6CAA6C;SACpD,CAAC;IACN,CAAC;IACD,MAAM,GAAG,GAAG,iCAAiC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO;QACH,WAAW,EAAE,GAAG,MAAM,IAAI,GAAG,EAAE;QAC/B,wBAAwB,EAAE,GAAG;KAChC,CAAC;AACN,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,GAAW;IACvC,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC;AAC/C,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAkB,EAAE,kBAA0B;IAC3E,MAAM,GAAG,GAAG,MAAM,CAAC,2BAA2B,EAAE,IAAI,EAAE,CAAC;IACvD,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC/D,OAAO;QACH,wBAAwB,UAAU,aAAa,kBAAkB,IAAI,UAAU,OAAO;KACzF,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAAC,KAA8B;IACvE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,iBAAiB,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;IAC/D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,QAAQ,GACV,OAAO,MAAM,CAAC,qBAAqB,KAAK,QAAQ,IAAI,MAAM,CAAC,qBAAqB,GAAG,CAAC;QAChF,CAAC,CAAC,MAAM,CAAC,qBAAqB;QAC9B,CAAC,CAAC,gCAAgC,CAAC;IAE3C,MAAM,QAAQ,GAAG,yBAAyB,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAE3E,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,kBAAkB,QAAQ,CAAC,WAAW,IAAI,CAAC,CAAC;IACvD,IAAI,QAAQ,CAAC,wBAAwB,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,+BAA+B,QAAQ,CAAC,wBAAwB,IAAI,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,iBAAiB,EAAE,IAAI,EAAE,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;QACpF,IAAI,CAAC;YACD,wBAAwB,CAAC,YAAY,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;QACxE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,GAAG,EAAE,IAAI,EAAE,CAAC,kDAAkD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/E,CAAC;IACL,CAAC;IAED,MAAM,UAAU,GAAG,uBAAuB,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1E,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,EAAE,GAAG,YAAY,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAI,EAAE,EAAE,CAAC;QACL,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,OAAO;QACH,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QACvB,kBAAkB,EAAE,QAAQ,CAAC,WAAW;KAC3C,CAAC;AACN,CAAC"}