@keyou007/agent-bot 0.1.17-alpha.1 → 0.1.17-alpha.2

package/dist/supervision/SafeRestartScheduler.js

@@ -8,6 +8,7 @@ export class SafeRestartScheduler {
     idleSince;
     idleInboundAt;
     scheduleId = 0;
+    restartImmediatelyIfIdle = false;
     constructor(options) {
         this.options = options;
     }
@@ -17,10 +18,14 @@ export class SafeRestartScheduler {
     get pendingReason() {
         return this.reason;
     }
-    schedule(reason, notificationTarget) {
+    schedule(reason, notificationTarget, options = {}) {
         const newlyScheduled = !this.reason;
         if (newlyScheduled) {
             this.notificationTargets = [];
+            this.restartImmediatelyIfIdle = options.restartImmediatelyIfIdle === true;
+        }
+        else if (options.restartImmediatelyIfIdle) {
+            this.restartImmediatelyIfIdle = true;
         }
         this.scheduleId += 1;
         this.addNotificationTarget(notificationTarget, reason);
@@ -65,6 +70,7 @@ export class SafeRestartScheduler {
         this.notificationTargets = [];
         this.idleSince = undefined;
         this.idleInboundAt = undefined;
+        this.restartImmediatelyIfIdle = false;
     }
     async poll() {
         const reason = this.reason;
@@ -84,6 +90,10 @@ export class SafeRestartScheduler {
             });
             return;
         }
+        if (this.restartImmediatelyIfIdle) {
+            await this.restart(reason, scheduleId, state);
+            return;
+        }
         const quietPeriodMs = this.options.quietPeriodMs ?? 15_000;
         const latestInboundAt = state.latestInboundAt ?? "";
         if (this.idleSince === undefined || this.idleInboundAt !== latestInboundAt) {
@@ -138,6 +148,9 @@ export class SafeRestartScheduler {
             }
             return;
         }
+        await this.restart(reason, scheduleId, confirmed);
+    }
+    async restart(reason, scheduleId, activity) {
         const notificationTargets = this.notificationTargetsSnapshot();
         this.clear();
         await this.emitStatus({
@@ -145,7 +158,7 @@ export class SafeRestartScheduler {
             reason,
             notificationTargets,
             phase: "restarting",
-            activity: confirmed,
+            activity,
             remainingMs: 0,
         });
         await this.options.onReady(reason, notificationTargets);

package/dist/supervision/SafeRestartScheduler.js.map

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

package/docs/technical-reference.md

@@ -156,6 +156,12 @@ feishu:
 console:
   enabled: true
 
+fileViewer:
+  enabled: true
+  host: "127.0.0.1"
+  port: 0
+  # publicBaseUrl: "https://agentbot.example.com/files"
+
 agents:
   codex:
     kind: "app-server"
@@ -187,6 +193,8 @@ logging:
   path: "./logs/agent-bot.log"
 ```
 
+`fileViewer` turns local non-image files and directories in final replies into signed, read-only HTTP links. The default `host: "127.0.0.1"` accepts connections only from the Agent Bot machine. With `0.0.0.0` or `::`, the server listens on every interface and automatically chooses a non-internal IPv4 link address in wired, Wi-Fi, other physical, then VPN order. Docker, Hyper-V, VMware, VirtualBox, WSL, loopback, and link-local interfaces are excluded; if no candidate remains, links fall back to loopback. `publicBaseUrl` has the highest priority and overrides automatic selection for domains, HTTPS reverse proxies, NAT, or port mappings. With `port: 0`, the first startup selects a free port and stores it in `<data>/file-viewer/port`; later restarts reuse it, while separate Profiles avoid a shared fixed port. The signing key is stored beside it as `secret`. File URLs can read only their signed absolute path. Directory URLs list direct children and allow downward navigation without exposing a parent-directory action. Text identity is detected from a content sample, and text pages preview the first 2 MiB with line anchors; images, PDFs, audio, and video use native browser previews; other binary files expose raw and download actions. Treat each signed URL as a bearer credential and do not share it publicly.
+
 `feishu.respondToOwnerOnly` defaults to `true`. It compares each message sender and card-action operator Open ID with `feishu.userOpenId`, ignoring non-owner input before durable event claims, reactions, downloads, commands, or Agent work. Set it to `false` to allow other users. If it is enabled without a configured owner Open ID, all Feishu messages and card actions are ignored; configure `FEISHU_USER_OPEN_ID` or temporarily disable the restriction to bootstrap from a private message.
 
 `feishu.respondToAllGroupMessages` defaults to `true` in the template, while first initialization and `init --reset` write the user's selected mode. Set it to `false` to ignore owner group messages unless they mention the current bot. The worker resolves the bot's Open ID at startup so mentioning another member does not trigger it. Owner private messages are unaffected. Initialization requests all-user group-message delivery only when this value is `true`; changing a mention-only Profile to `true` later requires rerunning `agentbot init` to add the permission.

package/docs/technical-reference.zh.md

@@ -156,6 +156,12 @@ feishu:
 console:
   enabled: true
 
+fileViewer:
+  enabled: true
+  host: "127.0.0.1"
+  port: 0
+  # publicBaseUrl: "https://agentbot.example.com/files"
+
 agents:
   codex:
     kind: "app-server"
@@ -187,6 +193,8 @@ logging:
   path: "./logs/agent-bot.log"
 ```
 
+`fileViewer` 为最终回答中的本地非图片文件和目录生成带签名的只读 HTTP 链接。默认 `host: "127.0.0.1"`，只能从运行 Agent Bot 的机器访问。设为 `0.0.0.0` 或 `::` 时，服务会监听所有网卡，并从非内部 IPv4 地址中按有线、Wi-Fi、其他物理网卡、VPN 的顺序自动选择链接地址；Docker、Hyper-V、VMware、VirtualBox、WSL、回环和链路本地地址会被排除，没有候选地址时回退到本机环回地址。`publicBaseUrl` 的优先级最高，用于域名、HTTPS 反向代理、NAT 或端口映射。`port: 0` 会在第一次启动时选择空闲端口，并保存到 `<data>/file-viewer/port`，以后重启继续使用，同一机器上的多个 Profile 不会争用固定端口。签名密钥保存在同目录的 `secret` 文件中。文件 URL 只能读取签发时对应的绝对路径；目录 URL 会列出其直接子项并允许继续向下浏览，但不提供向父目录跳转。文本身份由内容采样识别，页面显示带行号的开头 2 MiB；图片、PDF、音视频使用浏览器原生预览，其他二进制文件提供原始打开和下载入口。签名 URL 是持有者凭证，不应公开分享。
+
 `feishu.respondToOwnerOnly` 默认为 `true`。每条消息的发送者及卡片操作人的 Open ID 都会与 `feishu.userOpenId` 比较；非拥有者输入会在持久化事件、添加 reaction、下载图片、执行命令或启动 Agent 前被忽略。设为 `false` 可允许其他用户。开启后若未配置拥有者 Open ID，所有飞书消息和卡片操作都会被忽略；需先配置 `FEISHU_USER_OPEN_ID`，或临时关闭限制后通过私聊完成补全。
 
 `feishu.respondToAllGroupMessages` 在模板中默认为 `true`，第一次初始化和 `init --reset` 会按用户选择写入实际值。设为 `false` 后，拥有者未 @ 当前机器人的群消息也会被忽略；Worker 启动时会解析机器人的 Open ID，因此 @ 其他成员不会误触发。拥有者私聊不受影响。初始化只在该值为 `true` 时申请接收全部群消息的权限；仅 @ 响应的 Profile 后续改为 `true` 时，需要重新运行 `agentbot init` 补充权限。

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@keyou007/agent-bot",
-  "version": "0.1.17-alpha.1",
+  "version": "0.1.17-alpha.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@keyou007/agent-bot",
-      "version": "0.1.17-alpha.1",
+      "version": "0.1.17-alpha.2",
       "license": "GPL-3.0-only",
       "dependencies": {
         "@agentclientprotocol/sdk": "1.2.1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keyou007/agent-bot",
-  "version": "0.1.17-alpha.1",
+  "version": "0.1.17-alpha.2",
   "type": "module",
   "description": "Use Codex, TraeX, and compatible coding agents from Lark/Feishu.",
   "license": "GPL-3.0-only",

package/skills/agent-bot/SKILL.md

@@ -144,7 +144,7 @@ agentbot server restart --task <task> --reason "<reason>"
 agentbot server stop
 ```
 
-`update` is only for npm-installed Agent Bot packages. It verifies the new package before waiting for a safe service stop and automatically restores the prior version if activation fails. It refuses source checkouts and `npm link` installations.
+`update` is only for npm-installed Agent Bot packages. It verifies the new package, sends a safe-restart card, waits for active tasks, and restarts immediately when the service is already idle. It automatically restores the prior version if activation fails. It refuses source checkouts and `npm link` installations.
 
 Autostart is Profile-specific. Use `server autostart enable` for login startup, `server autostart enable --linger` on Linux only when the user explicitly requests startup before login, and `server autostart disable` to remove registration without stopping the current Server. Disabling Agent Bot autostart must not disable Linux user lingering because other services may use it.
 

package/src/config/loadConfig.ts

@@ -26,6 +26,16 @@ const DEFAULT_CONFIG = `feishu:
 console:
   enabled: true
 
+fileViewer:
+  enabled: true
+  # Use 0.0.0.0 to accept LAN connections and automatically prefer
+  # wired, Wi-Fi, other physical, then VPN addresses in generated links.
+  host: "127.0.0.1"
+  # 0 selects a free port once and reuses it for this Profile.
+  port: 0
+  # Overrides the automatically selected URL for domains or reverse proxies.
+  # publicBaseUrl: "https://agentbot.example.com/files"
+
 agents:
   codex:
     kind: "app-server"

package/src/config/schema.ts

@@ -62,6 +62,15 @@ export const appConfigSchema = z.object({
       enabled: z.boolean().default(true),
     })
     .default({ enabled: true }),
+  fileViewer: z.object({
+    enabled: z.boolean().default(true),
+    host: z.string().min(1).default("127.0.0.1"),
+    port: z.number().int().min(0).max(65_535).default(0),
+    publicBaseUrl: z.string().url().refine(
+      (value) => ["http:", "https:"].includes(new URL(value).protocol),
+      "fileViewer.publicBaseUrl must use http or https.",
+    ).optional(),
+  }).default({ enabled: true, host: "127.0.0.1", port: 0 }),
   feishu: z.object({
     transport: z.enum(["auto", "sdk", "console"]).default("auto"),
     appId: z.string().optional(),

package/src/feishu/FeishuMarkdown.ts

@@ -8,10 +8,17 @@ interface FenceState {
 }
 
 const FENCE_OPENER = /^([ \t]*)((?:`{3,})|(?:~{3,}))(.*)$/;
-const MARKDOWN_LINK = /(!?)\[([^\]\r\n]*)\]\((<?[^)\r\n]+>?)\)/g;
+const MARKDOWN_LINK = /(!?)\[([^\]\r\n]*)\]\((<[^>\r\n]+>|[^)\r\n]+)\)/g;
 const LOCAL_FILE_LINE_REFERENCE = /(:\d+(?::\d+)?)$/;
+const LOCAL_IMAGE_EXTENSIONS = new Set([".png", ".jpg", ".jpeg", ".gif", ".webp", ".tiff", ".bmp", ".ico"]);
 
-export function normalizeFeishuMarkdown(markdown: string, projectCwd?: string): string {
+export type LocalFileUrlResolver = (filePath: string, reference?: string) => string | undefined;
+
+export function normalizeFeishuMarkdown(
+  markdown: string,
+  projectCwd?: string,
+  localFileUrl?: LocalFileUrlResolver,
+): string {
   const lines = markdown.match(/[^\r\n]*(?:\r\n|\n)|[^\r\n]+$/g) ?? [];
   let fence: FenceState | undefined;
 
@@ -21,7 +28,7 @@ export function normalizeFeishuMarkdown(markdown: string, projectCwd?: string):
 
     if (!fence) {
       const opener = FENCE_OPENER.exec(body);
-      if (!opener?.[2]) return `${includeLocalFileLineReferences(body, projectCwd)}${ending}`;
+      if (!opener?.[2]) return `${includeLocalFileLineReferences(body, projectCwd, localFileUrl)}${ending}`;
 
       const indent = opener[1] ?? "";
       const delimiter = opener[2];
@@ -42,18 +49,38 @@ export function normalizeFeishuMarkdown(markdown: string, projectCwd?: string):
   }).join("");
 }
 
-function includeLocalFileLineReferences(markdown: string, projectCwd?: string): string {
+function includeLocalFileLineReferences(
+  markdown: string,
+  projectCwd?: string,
+  localFileUrl?: LocalFileUrlResolver,
+): string {
   return markdown.replace(MARKDOWN_LINK, (link, imageMarker: string, label: string, rawTarget: string) => {
     if (imageMarker) return link;
 
     const target = unwrapMarkdownTarget(rawTarget.trim());
     if (!isLocalFileTarget(target)) return link;
+    if (isLocalImageTarget(target)) return link;
 
     const reference = LOCAL_FILE_LINE_REFERENCE.exec(target)?.[1];
+    const targetWithoutReference = reference ? target.slice(0, -reference.length) : target;
+    const filePath = localFilePath(targetWithoutReference);
+    const viewerUrl = filePath ? localFileUrl?.(filePath, reference) : undefined;
     const projectPathLabel = projectCwd ? projectFilePathLabel(target, projectCwd, reference) : undefined;
-    const normalizedLabel = projectPathLabel
-      ?? (reference && !label.endsWith(reference) ? `${label}${reference}` : label);
-    return normalizedLabel === label ? link : `[${normalizedLabel}](${rawTarget})`;
+    if (!projectPathLabel) {
+      const normalizedLabel = reference && !label.endsWith(reference) ? `${label}${reference}` : label;
+      if (viewerUrl) return `[${normalizedLabel}](${viewerUrl})`;
+      return normalizedLabel === label ? link : `[${normalizedLabel}](${rawTarget})`;
+    }
+
+    if (projectPathLabel === label) return viewerUrl ? `[${label}](${viewerUrl})` : link;
+    if (reference && projectPathLabel === `${label}${reference}`) {
+      return `[${projectPathLabel}](${viewerUrl ?? rawTarget})`;
+    }
+
+    if (!label) return viewerUrl ? `[${projectPathLabel}](${viewerUrl})` : inlineCode(projectPathLabel);
+    return viewerUrl
+      ? `[${label}](${viewerUrl})(${inlineCode(projectPathLabel)})`
+      : `${label}(${inlineCode(projectPathLabel)})`;
   });
 }
 
@@ -71,11 +98,7 @@ function projectFilePathLabel(
 
   const pathApi = usesWindowsPaths(filePath, projectCwd) ? path.win32 : path.posix;
   const parsed = pathApi.parse(filePath);
-  if (Array.from(parsed.name).length > 5) return undefined;
-
-  const parentName = pathApi.basename(pathApi.dirname(filePath));
-  if (!parentName) return undefined;
-  return `${parentName}${pathApi.sep}${parsed.base}${reference ?? ""}`;
+  return `${parsed.base}${reference ?? ""}`;
 }
 
 function localFilePath(target: string): string | undefined {
@@ -108,10 +131,26 @@ function displayAbsolutePath(filePath: string): string {
   return path.win32.normalize(filePath);
 }
 
+function inlineCode(value: string): string {
+  const longestDelimiter = Math.max(0, ...(value.match(/`+/g) ?? []).map((run) => run.length));
+  const delimiter = "`".repeat(longestDelimiter + 1);
+  const padding = value.startsWith("`") || value.endsWith("`") ? " " : "";
+  return `${delimiter}${padding}${value}${padding}${delimiter}`;
+}
+
 function usesWindowsPaths(...values: string[]): boolean {
   return values.some((value) => /^\/?[a-z]:[\\/]/i.test(value) || /^\\\\/.test(value));
 }
 
+function isLocalImageTarget(target: string): boolean {
+  const reference = LOCAL_FILE_LINE_REFERENCE.exec(target)?.[1];
+  const targetWithoutReference = reference ? target.slice(0, -reference.length) : target;
+  const filePath = localFilePath(targetWithoutReference);
+  if (!filePath) return false;
+  const pathApi = usesWindowsPaths(filePath) ? path.win32 : path.posix;
+  return LOCAL_IMAGE_EXTENSIONS.has(pathApi.extname(filePath).toLowerCase());
+}
+
 function unwrapMarkdownTarget(target: string): string {
   return target.startsWith("<") && target.endsWith(">") ? target.slice(1, -1) : target;
 }

package/src/feishu/FeishuTurnPresenter.ts

@@ -8,7 +8,7 @@ import { splitMarkdown } from "../presentation/splitMarkdown.js";
 import type { TurnViewState } from "../presentation/turnViewTypes.js";
 import { CardRenderer } from "./CardRenderer.js";
 import { CardUpdateScheduler } from "./CardUpdateScheduler.js";
-import { normalizeFeishuMarkdown } from "./FeishuMarkdown.js";
+import { normalizeFeishuMarkdown, type LocalFileUrlResolver } from "./FeishuMarkdown.js";
 import type { FeishuOutbound, MessageReplyTarget } from "./types.js";
 import {
   FINAL_RESPONSE_BRANDING_BLOCK,
@@ -50,6 +50,7 @@ export interface FeishuTurnPresenterOptions {
   finalChunkLength?: number;
   onError?: (error: unknown) => void;
   finalRetryBackoffMs?: number[];
+  localFileUrl?: LocalFileUrlResolver;
 }
 
 const MAX_FINAL_TABLES_PER_CARD = 5;
@@ -215,7 +216,7 @@ export class FeishuTurnPresenter {
     }
     const delivery = this.store.getTurnDelivery(turnId);
     if (delivery?.progressMessageId) {
-      await this.outbound.updateInteractiveCard(delivery.progressMessageId, this.renderer.renderTurn(state));
+      await this.outbound.updateInteractiveCard(delivery.progressMessageId, this.renderTurn(state));
     }
   }
 
@@ -332,7 +333,7 @@ export class FeishuTurnPresenter {
       await this.outbound.sendText(contextKey, "未找到这次执行的详情。可能已被清理。");
       return;
     }
-    await this.outbound.sendInteractiveCard(contextKey, this.renderer.renderTurnDetails(snapshot));
+    await this.outbound.sendInteractiveCard(contextKey, this.renderTurnDetails(snapshot));
   }
 
   async showActivityPage(
@@ -355,9 +356,9 @@ export class FeishuTurnPresenter {
           entry.scheduler.invalidateRenderedCard();
           await entry.scheduler.flush(entry.state);
         } else if (targetMessageId) {
-          await this.outbound.updateInteractiveCard(targetMessageId, this.renderer.renderTurn(entry.state));
+          await this.outbound.updateInteractiveCard(targetMessageId, this.renderTurn(entry.state));
         } else {
-          await this.outbound.sendInteractiveCard(contextKey, this.renderer.renderTurn(entry.state));
+          await this.outbound.sendInteractiveCard(contextKey, this.renderTurn(entry.state));
         }
         return;
       }
@@ -366,7 +367,7 @@ export class FeishuTurnPresenter {
         entry.historySnapshot = entry.state;
         await entry.scheduler?.flush();
       }
-      const card = this.renderer.renderActivityHistory(entry.historySnapshot, page);
+      const card = this.renderActivityHistory(entry.historySnapshot, page);
       if (targetMessageId) await this.outbound.updateInteractiveCard(targetMessageId, card);
       else await this.outbound.sendInteractiveCard(contextKey, card);
       return;
@@ -375,8 +376,8 @@ export class FeishuTurnPresenter {
     const snapshot = this.store.getTurnSnapshot(turnId);
     if (!isTurnViewState(snapshot)) throw new Error("未找到这次执行的活动历史。");
     const card = page === "latest"
-      ? this.renderer.renderTurn(snapshot)
-      : this.renderer.renderActivityHistory(snapshot, page);
+      ? this.renderTurn(snapshot)
+      : this.renderActivityHistory(snapshot, page);
     if (messageId) await this.outbound.updateInteractiveCard(messageId, card);
     else await this.outbound.sendInteractiveCard(contextKey, card);
   }
@@ -428,7 +429,7 @@ export class FeishuTurnPresenter {
 
   private async initializeEntry(entry: TurnEntry): Promise<void> {
     const sentState = entry.state;
-    const card = this.renderer.renderTurn(sentState);
+    const card = this.renderTurn(sentState);
     const delivery = this.store.getTurnDelivery(sentState.turnId);
     const persistedMessageId = delivery?.progressMessageId;
     if (delivery?.finalDelivered && !persistedMessageId) return;
@@ -449,7 +450,7 @@ export class FeishuTurnPresenter {
     if (!messageId) return;
     this.store.saveTurnDelivery(entry.state.turnId, { progressMessageId: messageId });
     entry.scheduler = new CardUpdateScheduler<TurnViewState>({
-      render: (state) => this.renderer.renderTurn(state),
+      render: (state) => this.renderTurn(state),
       write: (card) => this.outbound.updateInteractiveCard(messageId, card),
       normalIntervalMs: this.options.normalIntervalMs,
       criticalGapMs: this.options.criticalGapMs,
@@ -461,6 +462,18 @@ export class FeishuTurnPresenter {
     await this.syncThinkingCardReaction(entry);
   }
 
+  private renderTurn(state: TurnViewState): Record<string, unknown> {
+    return this.renderer.renderTurn(normalizeTurnCardMarkdown(state, this.options.localFileUrl));
+  }
+
+  private renderTurnDetails(state: TurnViewState): Record<string, unknown> {
+    return this.renderer.renderTurnDetails(normalizeTurnCardMarkdown(state, this.options.localFileUrl));
+  }
+
+  private renderActivityHistory(state: TurnViewState, page: number): Record<string, unknown> {
+    return this.renderer.renderActivityHistory(normalizeTurnCardMarkdown(state, this.options.localFileUrl), page);
+  }
+
   private startElapsedUpdates(entry: TurnEntry): void {
     if (entry.elapsedTimer || isTerminalViewStatus(entry.state.status)) return;
     const intervalMs = Math.max(1, this.options.elapsedUpdateIntervalMs ?? DEFAULT_ELAPSED_UPDATE_INTERVAL_MS);
@@ -539,7 +552,7 @@ export class FeishuTurnPresenter {
     if (delivery?.finalDelivered || !state.finalResponse) return;
     const finalChunkLength = this.options.finalChunkLength ?? 4_000;
     const chunks = brandedFinalChunks(
-      normalizeFeishuMarkdown(state.finalResponse, state.projectCwd),
+      normalizeFeishuMarkdown(state.finalResponse, state.projectCwd, this.options.localFileUrl),
       finalChunkLength,
     );
     const messageIds = [...(delivery?.finalMessageIds ?? [])];
@@ -579,6 +592,23 @@ export class FeishuTurnPresenter {
   }
 }
 
+function normalizeTurnCardMarkdown(
+  state: TurnViewState,
+  localFileUrl: LocalFileUrlResolver | undefined,
+): TurnViewState {
+  if (!localFileUrl) return state;
+  const normalize = (value: string): string => normalizeFeishuMarkdown(value, state.projectCwd, localFileUrl);
+  return {
+    ...state,
+    assistantText: normalize(state.assistantText),
+    ...(state.progressText !== undefined ? { progressText: normalize(state.progressText) } : {}),
+    plan: state.plan.map((step) => ({ ...step, text: normalize(step.text) })),
+    activities: state.activities.map((activity) => activity.kind === "tool"
+      ? activity
+      : { ...activity, text: normalize(activity.text) }),
+  };
+}
+
 function brandedFinalChunks(response: string, maxLength: number): string[] {
   const chunks = splitMarkdown(response, maxLength, MAX_FINAL_TABLES_PER_CARD);
   if (chunks.length <= 1 && response.length <= FINAL_RESPONSE_BRANDING_THRESHOLD) return chunks;

package/src/feishu/LocalImageMarkdown.ts

@@ -29,7 +29,7 @@ export async function renderMarkdownWithLocalImages(
       continue;
     }
 
-    appendMarkdown(elements, markdown.slice(cursor, matchIndex));
+    appendMarkdown(elements, markdownBeforeLocalImage(markdown, cursor, matchIndex, matchIndex + match[0].length));
     try {
       let upload = uploads.get(filePath);
       if (!upload) {
@@ -86,7 +86,28 @@ function unsupportedImageFallback(label: string, rawTarget: string): string {
     : `图片不可用：${label || "本地图片"}`;
 }
 
+function markdownBeforeLocalImage(
+  markdown: string,
+  cursor: number,
+  matchStart: number,
+  matchEnd: number,
+): string {
+  const lineStart = markdown.lastIndexOf("\n", matchStart - 1) + 1;
+  if (lineStart < cursor) return markdown.slice(cursor, matchStart);
+
+  const lineEndIndex = markdown.indexOf("\n", matchEnd);
+  const lineEnd = lineEndIndex === -1 ? markdown.length : lineEndIndex;
+  const beforeLink = markdown.slice(lineStart, matchStart);
+  const afterLink = markdown.slice(matchEnd, lineEnd);
+  const standaloneListMarker = /^[ \t]*(?:[-+*]|\d+[.)])[ \t]+$/u.test(beforeLink);
+  if (!standaloneListMarker || !/^[ \t]*\r?$/u.test(afterLink)) {
+    return markdown.slice(cursor, matchStart);
+  }
+
+  return markdown.slice(cursor, lineStart);
+}
+
 function appendMarkdown(elements: Array<Record<string, unknown>>, content: string): void {
-  if (!content) return;
+  if (!content.trim()) return;
   elements.push({ tag: "markdown", content });
 }

package/src/index.ts

@@ -44,6 +44,7 @@ import { SafeRestartScheduler } from "./supervision/SafeRestartScheduler.js";
 import type { RestartNotificationTarget } from "./supervision/SafeRestartScheduler.js";
 import { SafeRestartNotifier } from "./supervision/SafeRestartNotifier.js";
 import { privateRestartNotificationTarget } from "./supervision/restartNotificationTarget.js";
+import { LocalFileViewerServer } from "./local-files/LocalFileViewerServer.js";
 import {
   nodeDiagnosticReportArguments,
   prepareCrashReportDirectory,
@@ -72,6 +73,22 @@ const config = loadConfig();
 const transport = consoleOnly ? "console" : requireServerFeishuTransport(config.feishu);
 const logger = createLogger(config);
 const store = new StateStore(config.storage.sqlitePath);
+let localFileViewer: LocalFileViewerServer | undefined;
+if (config.fileViewer.enabled) {
+  const viewer = new LocalFileViewerServer({
+    host: config.fileViewer.host,
+    port: config.fileViewer.port,
+    publicBaseUrl: config.fileViewer.publicBaseUrl,
+    stateDirectory: path.join(path.dirname(config.storage.sqlitePath), "file-viewer"),
+  });
+  try {
+    const address = await viewer.start();
+    localFileViewer = viewer;
+    logger.info(address, "Local file viewer started.");
+  } catch (error) {
+    logger.warn({ error }, "Local file viewer failed to start; local file links will remain plain text.");
+  }
+}
 
 const configuredConfigPath = process.env.AGENT_BOT_CONFIG?.trim();
 const activeConfigPath = configuredConfigPath ? resolveUserPath(configuredConfigPath) : defaultConfigPath();
@@ -98,6 +115,7 @@ if (feishuOutbound) {
     normalIntervalMs: 2_000,
     criticalGapMs: 500,
     onError: (error) => logger.warn({ error }, "Failed to update Agent progress card."),
+    localFileUrl: (filePath, reference) => localFileViewer?.createFileUrl(filePath, reference),
   });
   routes.push({ matches: (contextKey) => !contextKey.startsWith("console:"), outbound: feishuOutbound, presenter });
   const defaultAgentName = config.defaults.agent!;
@@ -215,7 +233,7 @@ function recoverPendingSelfUpdate(): void {
   if (!pending || pendingSelfUpdatePlanPath || restartRequested || safeRestart.scheduled) return;
   let notificationTarget: RestartNotificationTarget | undefined;
   try {
-    notificationTarget = inferControlRestartTarget(pending.plan.notificationSessionId);
+    notificationTarget = inferServerRestartTarget(pending.plan.notificationSessionId);
   } catch (error) {
     logger.warn({ error }, "Could not restore the self-update notification target; update recovery will continue.");
   }
@@ -223,6 +241,9 @@ function recoverPendingSelfUpdate(): void {
   safeRestart.schedule(
     pending.plan.reason ?? `Resume Agent Bot update to ${pending.plan.toVersion}`,
     notificationTarget,
+    {
+      restartImmediatelyIfIdle: isServerIdle(store.getServerActivityState()),
+    },
   );
   logger.warn(
     { planPath: pending.planPath, toVersion: pending.plan.toVersion },
@@ -390,12 +411,15 @@ async function handleControlRequest(request: ControlRequest): Promise<ControlRes
         return { ok: false, message: "A restart or update is already pending." };
       }
       assertSelfUpdatePlanPath(request.planPath, agentBotHome());
-      const notificationTarget = inferControlRestartTarget(request.notificationSessionId);
+      const notificationTarget = inferServerRestartTarget(request.notificationSessionId);
+      const restartImmediatelyIfIdle = isServerIdle(store.getServerActivityState());
       pendingSelfUpdatePlanPath = request.planPath;
-      safeRestart.schedule(request.reason, notificationTarget);
+      safeRestart.schedule(request.reason, notificationTarget, { restartImmediatelyIfIdle });
       return {
         ok: true,
-        message: "Agent Bot update scheduled after active tasks finish and the server becomes idle.",
+        message: restartImmediatelyIfIdle
+          ? "Agent Bot update will start immediately because the server is idle."
+          : "Agent Bot update scheduled after active tasks finish and the server becomes idle.",
       };
     }
     case "server_stop":
@@ -517,6 +541,7 @@ async function shutdown(
   ]);
   runtimes.close();
   await controlServer?.close().catch((error: unknown) => logger.warn({ error }, "Failed to close local control endpoint."));
+  await localFileViewer?.close().catch((error: unknown) => logger.warn({ error }, "Failed to close local file viewer."));
   store.close();
   if (restartReason) startReplacementSupervisor(restartReason, restartNotificationTargets);
   process.exit(exitCode);
@@ -586,6 +611,10 @@ function inferServerRestartTarget(notificationSessionId?: string): RestartNotifi
   return privateRestartNotificationTarget(config.feishu.userOpenId);
 }
 
+function isServerIdle(activity: { runningSessions: number; pendingFinalDeliveries: number }): boolean {
+  return activity.runningSessions === 0 && activity.pendingFinalDeliveries === 0;
+}
+
 function restartNotificationTargetForSession(
   session: { localSessionId: string; contextKey: string },
 ): RestartNotificationTarget {