pi-web-ui 0.90.1 → 0.92.0

package/dist/server/read-tool.js

@@ -0,0 +1,91 @@
+/**
+ * read-tool.ts —— 覆盖 SDK 内置 read：路径是目录时列出目录条目。
+ *
+ * 背景：SDK 内置 `read` 只处理文件，`read('server')` 直接抛
+ * `EISDIR: illegal operation on a directory, read`；模型想「看一眼这个目录」
+ * 只能改用 bash（`ls`）。SDK 自带的 `ls` 工具不在默认活跃集里
+ * （默认 `["read","bash","edit","write"]`），模型并不总能想到它。
+ *
+ * 做法（与 bash 覆盖同一机制）：customTools 按 name 覆盖内置定义 —— 用
+ * `createReadToolDefinition(cwd)` 拿原实现当基底，只在「路径确实是目录」时
+ * 分流到 `createLsToolDefinition(cwd)`（排序、目录 `/` 后缀、条目/字节截断
+ * 与 SDK ls 完全一致）；其余情况（文件、图片、路径不存在、读取报错）原样
+ * 转发基底，行为与内置完全一致。
+ *
+ * 开关：`readDirEnabled`（设置面板「工具」页，默认开）。**行为开关**不是
+ * ActiveSet 开关（read 本体不可关，关了 agent 就残了），因此不进
+ * tool-manager 的 AGENT_TOOL_CATALOG；每次调用实时读设置，改动即时生效。
+ *
+ * 双语约定（issue #91）：definition 走 bilingual(en, zh) 内联双语；per-call
+ * 返回文本（目录头）按 lang 取 pick(lang, zh, en, key)，缺表回落英文内联。
+ *
+ * DSH 引擎无 customTool 注册面（工具来自 shipped preset），本覆盖只服务 pi 引擎。
+ */
+import { stat } from "node:fs/promises";
+import { homedir } from "node:os";
+import { isAbsolute, join, resolve as nodeResolve } from "node:path";
+import { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, createLsToolDefinition, createReadToolDefinition, defineTool, } from "@earendil-works/pi-coding-agent";
+import { bilingual, pick } from "./i18n.js";
+const UNICODE_SPACES = /[\u00A0\u2000-\u200A\u202F\u205F\u3000]/g;
+/**
+ * 目录判定用的路径归一：~ / @ 前缀、Unicode 空格、相对 → 绝对（对齐 SDK
+ * resolveToCwd 的主要语义）。这里只是「猜」，猜不中（例如 macOS 截图名的
+ * 变体路径）就走内置实现，不会比现状更差。
+ */
+export function resolvePathForDirCheck(input, cwd) {
+    let p = String(input ?? "").replace(UNICODE_SPACES, " ");
+    if (p.startsWith("@"))
+        p = p.slice(1);
+    if (p === "~")
+        return homedir();
+    if (p.startsWith("~/") || p.startsWith("~\\"))
+        return join(homedir(), p.slice(2));
+    return isAbsolute(p) ? p : nodeResolve(cwd, p);
+}
+/** 路径是不是目录（不存在/无权限/非目录一律 false → 交回内置实现）。 */
+export async function isDirectoryPath(absolutePath) {
+    try {
+        const st = await stat(absolutePath);
+        return st.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 生成「read 读目录」覆盖定义。cwd 仅供创建时固定；执行时优先 ctx.cwd
+ * （会话工作区）。
+ */
+export function makeReadDirTool(fallbackCwd, options = {}) {
+    const base = createReadToolDefinition(fallbackCwd);
+    const ls = createLsToolDefinition(fallbackCwd);
+    const dirEnabled = options.dirEnabled ?? (() => true);
+    const getLang = options.getLang ?? (() => "en");
+    return defineTool({
+        ...base,
+        description: bilingual(`${base.description} If the path is a directory, its entries are listed instead of file contents (one entry per line, directories suffixed with '/'); in that case \`limit\` caps the number of entries and \`offset\` is ignored.`, `读取文件内容。支持文本文件与图片（jpg, png, gif, webp, bmp），图片作为附件发出。文本输出截断到 ${DEFAULT_MAX_LINES} 行或 ${DEFAULT_MAX_BYTES / 1024}KB（先到者为准），大文件用 offset/limit 续读。路径是目录时改为列出目录条目（一行一项，目录带 '/' 后缀；此时 limit 是条目上限，offset 忽略）。`),
+        promptSnippet: bilingual("Read file contents (a directory path lists its entries)", "读取文件内容（传目录则列出其条目）"),
+        promptGuidelines: [
+            ...(base.promptGuidelines ?? []),
+            bilingual("Use read on a directory to list its entries — no need to shell out to `ls`", "要看目录内容直接把目录路径交给 read，不必再走 bash 的 ls"),
+        ],
+        async execute(toolCallId, params, signal, onUpdate, ctx) {
+            const input = (params ?? {});
+            const path = typeof input.path === "string" ? input.path : "";
+            if (path && dirEnabled()) {
+                const cwd = typeof ctx?.cwd === "string" ? ctx.cwd : fallbackCwd;
+                if (await isDirectoryPath(resolvePathForDirCheck(path, cwd))) {
+                    const limit = typeof input.limit === "number" && input.limit > 0 ? Math.floor(input.limit) : undefined;
+                    // 列目录本体完全复用 SDK 的 ls（排序/`/` 后缀/截断提示口径一致）。
+                    const listed = await ls.execute(toolCallId, { path, ...(limit !== undefined ? { limit } : {}) }, signal, onUpdate, ctx);
+                    const header = pick(getLang(), `[目录：${path}]`, `[Directory: ${path}]`, "read.dir.header", { path });
+                    // 只取列出来的正文：截断/条目上限提示已在正文末尾，read 卡片的
+                    // details 不需要 ls 的字段。
+                    const content = listed.content.map((part, index) => index === 0 && part.type === "text" ? { ...part, text: `${header}\n${part.text}` } : part);
+                    return { content, details: undefined };
+                }
+            }
+            return base.execute(toolCallId, params, signal, onUpdate, ctx);
+        },
+    });
+}

package/dist/server/schedule-agent-tool.js

@@ -111,12 +111,12 @@ export function makeScheduleTools(host, ownerConversationId, lang) {
             "Use it when the user asks for periodic checks, delayed reminders, or scheduled summaries — do NOT fake it with sleep loops (a sleeping script can never push a message back). " +
             'Schedule accepts a 5-field cron ("0 * * * *" = hourly) or a relative delay ("in 30m", "in 1h", "30m"); minimum interval is 60s. ' +
             "One-shot by default (recurring=false auto-deletes the task after it fires); pass recurring=true for repeats. " +
-            "If the conversation is gone when it fires (closed/restarted), the task runs headless in its project and the report stays in the scheduler panel history. " +
+            "The wake-up binds the originating conversation AND its persisted session file: after context compaction or a restart the scheduler re-binds to the same session automatically; if the original conversation is gone it first falls back to the project's active conversation (and visibly reports the move), and only runs headless (report in panel history) when no live conversation exists for the project. " +
             "Manage with schedule_list / schedule_cancel; the user can also cancel from the background-tasks panel.", "在**当前对话**里创建一个定时唤醒：到指定 cron 时间或延迟后，调度器自动把你的 prompt 投回本对话，你继续执行并向用户汇报。" +
             "用户要求定时巡检、延时提醒、定时汇总时用它 —— 不要用 sleep 死循环假装答应（休眠的脚本推不回任何消息）。" +
             "时间写法收 5 字段 cron（“0 * * * *”=每小时）或相对延迟（“in 30m”“in 1h”“30m”）；最短间隔 60s。" +
             "默认单次（recurring=false 触发后自动删除）；传 recurring=true 做周期任务。" +
-            "触发时对话已不在（关闭/重启）则回落无头执行，报告留在调度面板历史里。" +
+            "唤醒绑定发起对话与其落盘会话文件：上下文压缩或重启后自动重绑到同一会话；原对话不在时先回落到同项目的活跃对话（并明确提示迁移），同项目无存活对话才无头执行，报告留在调度面板历史里。" +
             "用 schedule_list / schedule_cancel 管理；用户也可从后台任务面板取消。"),
         promptSnippet: "schedule a wake-up in this conversation (cron or delay), auto-report on fire",
         parameters: Type.Object({
@@ -154,16 +154,34 @@ export function makeScheduleTools(host, ownerConversationId, lang) {
             const labelRaw = typeof p.label === "string" ? p.label.trim().slice(0, 80) : "";
             const name = labelRaw || prompt.split("\n")[0].slice(0, 40) || "定时任务";
             const convId = (ownerConversationId ?? "").trim() || String(host.activeConversationId() ?? "").trim();
+            // 稳定绑定（issue #231）：owner 对话的落盘会话文件 —— 压缩/重启后靠它重认同一会话，
+            // 内存对话 id（c1/c2…）只做首选唤醒键。宿主没实现 conversationInfo 时按原来只绑 id。
+            let bindCwd = cwd;
+            let bindSessionFile = "";
+            try {
+                const info = host.conversationInfo?.((ownerConversationId ?? "").trim() || convId || undefined);
+                if (info) {
+                    if (String(info.cwd ?? "").trim())
+                        bindCwd = String(info.cwd).trim();
+                    bindSessionFile = String(info.sessionFile ?? "")
+                        .trim()
+                        .slice(0, 1024);
+                }
+            }
+            catch {
+                /* 绑定快照尽力而为：拿不到稳定键就按原来的 id 绑定触发 */
+            }
             const recurring = p.recurring === true;
             let task;
             try {
                 task = store.upsert({
                     name,
-                    cwd,
+                    cwd: bindCwd,
                     kind: parsed.kind,
                     spec: parsed.spec,
                     prompt,
                     conversationId: convId,
+                    sessionFile: bindSessionFile,
                     oneShot: !recurring,
                 });
             }
@@ -178,8 +196,8 @@ export function makeScheduleTools(host, ownerConversationId, lang) {
                 : `Fires: ${parsed.kind === "cron" ? `cron ${parsed.spec}` : `every ${Math.round(Number(parsed.spec) / 1000)}s`}, next ${fmtTime(next, L)}${recurring ? " (recurring)" : " (one-shot, auto-deleted after firing)"}`;
             const targetLine = convId
                 ? L === "zh"
-                    ? `汇报：触发时自动唤醒本对话（${convId}）；对话已不在则无头执行，报告进调度面板历史。`
-                    : `Reports: wakes this conversation (${convId}) on fire; runs headless (report in panel history) if it is gone.`
+                    ? `汇报：触发时自动唤醒本对话（${convId}）；压缩/重启后按会话文件自动重绑，原对话不在时先回落同项目活跃对话（明确提示），无存活对话才无头执行。`
+                    : `Reports: wakes this conversation (${convId}) on fire; re-binds by session file after compaction/restart, falls back to the project's active conversation (with a visible note), headless only with no live conversation.`
                 : L === "zh"
                     ? "汇报：无头执行，报告进调度面板历史（创建时没拿到对话 id）。"
                     : "Reports: headless run, report in panel history (no conversation id captured at creation).";

package/dist/server/scheduler-tasks.js

@@ -79,6 +79,11 @@ export function normalizeSchedulerInput(input, now = Date.now()) {
     const conversationId = String(input.conversationId ?? "")
         .trim()
         .slice(0, 128);
+    // 落盘会话文件：稳定身份键（issue #231）。只做归一化（去首尾空白、封顶），
+    // 不校验存在性 —— 创建时刻文件可能还没落盘，触发时按它匹配不上即回落。
+    const sessionFile = String(input.sessionFile ?? "")
+        .trim()
+        .slice(0, 1024);
     return {
         id,
         name,
@@ -92,6 +97,7 @@ export function normalizeSchedulerInput(input, now = Date.now()) {
         thinkingLevel,
         catchUp,
         conversationId,
+        sessionFile,
         oneShot: input.oneShot === true,
         createdAt: now,
         updatedAt: now,
@@ -152,6 +158,17 @@ function sanitizeHistory(v) {
     }
     return out.sort((a, b) => b.at - a.at).slice(0, SCHEDULER_HISTORY_MAX);
 }
+/** 落盘会话路径是否指向同一会话（纯函数，可单测）。
+ *  Windows 上 `C:\a\b` 与 `C:/a/b`、尾部分隔符差异都算同一文件；
+ *  空串永不相等（没拿到稳定键的任务不配对）。 */
+export function sameSessionFile(a, b) {
+    const x = String(a ?? "").trim();
+    const y = String(b ?? "").trim();
+    if (!x || !y)
+        return false;
+    const norm = (s) => s.replace(/\\/g, "/").replace(/\/+$/, "").toLowerCase();
+    return norm(x) === norm(y);
+}
 export class SchedulerStore {
     dataDir;
     opts;
@@ -230,6 +247,7 @@ export class SchedulerStore {
                         thinkingLevel: r.thinkingLevel,
                         catchUp: r.catchUp,
                         conversationId: r.conversationId,
+                        sessionFile: r.sessionFile,
                         oneShot: r.oneShot,
                     });
                     task.createdAt = typeof r.createdAt === "number" && Number.isFinite(r.createdAt) ? r.createdAt : Date.now();
@@ -288,6 +306,7 @@ export class SchedulerStore {
                 thinkingLevel: t.thinkingLevel,
                 catchUp: t.catchUp,
                 conversationId: t.conversationId,
+                sessionFile: t.sessionFile ?? "",
                 oneShot: t.oneShot,
                 createdAt: t.createdAt,
                 updatedAt: t.updatedAt,
@@ -299,13 +318,20 @@ export class SchedulerStore {
         })
             .sort((a, b) => a.name.localeCompare(b.name, "zh"));
     }
-    /** 新建或全量更新（同名 id 覆盖）；返回归一化后的任务。 */
+    /** 新建或全量更新（同名 id 覆盖）；返回归一化后的任务。
+     *  issue #231：面板编辑不带绑定字段（conversationId/sessionFile 缺席）时保留旧绑定 ——
+     *  否则用户在面板改个名字就会把 AI 任务的会话绑定洗掉，下次触发直接变无头。
+     *  字段显式出现（含空串）仍按全量语义覆盖。 */
     upsert(input) {
         const prev = this.tasks.get(String(input.id ?? "").trim());
         const task = normalizeSchedulerInput(input);
         if (prev) {
             task.createdAt = prev.createdAt;
             task.updatedAt = Date.now();
+            if (input.conversationId === undefined && input.sessionFile === undefined) {
+                task.conversationId = prev.conversationId;
+                task.sessionFile = prev.sessionFile ?? "";
+            }
         }
         const history = prev?.history ? sanitizeHistory(prev.history) : [];
         this.tasks.set(task.id, { ...task, history });
@@ -335,6 +361,39 @@ export class SchedulerStore {
         this.changed();
         return t;
     }
+    /** 会话重绑定（issue #231）：触发时按稳定键找到了新的对话句柄，把任务的
+     *  投递目标迁移过去（只改 conversationId/sessionFile/updatedAt，不碰下次触发
+     *  与历史）。无变化回 false（调用方免一次落盘+推送）；未知任务回 false。 */
+    rebind(id, binding) {
+        const t = this.tasks.get(id);
+        if (!t)
+            return false;
+        let dirty = false;
+        if (binding.conversationId !== undefined) {
+            const v = String(binding.conversationId ?? "")
+                .trim()
+                .slice(0, 128);
+            if (v !== t.conversationId) {
+                t.conversationId = v;
+                dirty = true;
+            }
+        }
+        if (binding.sessionFile !== undefined) {
+            const v = String(binding.sessionFile ?? "")
+                .trim()
+                .slice(0, 1024);
+            if (v !== (t.sessionFile ?? "")) {
+                t.sessionFile = v;
+                dirty = true;
+            }
+        }
+        if (!dirty)
+            return false;
+        t.updatedAt = Date.now();
+        this.save();
+        this.changed();
+        return true;
+    }
     async tick() {
         const now = Date.now();
         for (const task of this.tasks.values()) {

package/dist/server/scm-commitmsg.js

@@ -0,0 +1,140 @@
+/**
+ * AI commit-message generation — pure prompt assembly + response cleanup.
+ *
+ * The git gathering lives in scm.ts (scmCommitContext); the one-off model
+ * call lives in agent-service (ClientSession.scmGenCommitMessage, same
+ * completeSimple path as the vision bridge). This module owns everything
+ * deterministic so it stays unit-testable:
+ *
+ *   buildCommitMsgInput(ctx, fallbackLang) → user message (null = nothing
+ *     to commit — the caller turns that into a friendly error)
+ *   COMMITMSG_SYSTEM_PROMPT                   → system prompt
+ *   sanitizeCommitMessage(raw)               → the single-line subject that
+ *     ends up in the commit input (models are told to emit exactly that, but
+ *     fences/labels/quotes/newlines are stripped defensively)
+ *
+ * Language policy: the generated message follows the repository's own commit
+ * subjects (style AND language — a repo writing "feat(xxx): 描述" keeps
+ * getting that). Only a repo with no commits yet falls back to the UI
+ * language passed as fallbackLang.
+ */
+/** Hard cap for the generated subject — the commit input is single-line and
+ *  this keeps a chatty model from filling the whole header row. */
+export const MAX_COMMITMSG_LEN = 200;
+/** File list cap inside the prompt (porcelain lines); the diffs carry the
+ *  details, the list is orientation only. */
+const MAX_FILE_LINES = 200;
+export const COMMITMSG_SYSTEM_PROMPT = `You write git commit messages. You receive the pending changes of a repository and output exactly one commit message: a single subject line.
+
+Rules:
+1. Match the style, format and language of the repository's recent commit subjects when provided — conventional commits ("type(scope): summary"), prefixes, punctuation, language: copy what the repo actually does.
+2. Describe what the change does at a glance (the user-facing effect), not a file-by-file listing.
+3. The staged diff is the subject of the commit. Describe staged changes when any exist; otherwise describe the unstaged and untracked changes shown.
+4. One line. No quotes, no markdown, no code fences, no "Commit message:" label, no explanation. Under 72 characters when the repository's language allows it (CJK text may naturally be shorter).
+5. Never invent scope names, issue numbers or details not visible in the provided material.
+6. If the repository has no commits yet, write the message in the language stated in the request.
+
+Output ONLY the subject line.`;
+/**
+ * Assemble the effective system prompt from the settings-panel prefs (same
+ * contract as the vision bridge's buildVisionBridgePrompt): mode "append"
+ * puts custom text after the built-in default (empty custom = pure default);
+ * mode "replace" swaps in the custom text, but an empty custom still falls
+ * back to the default (never send an empty system prompt).
+ */
+export function buildCommitMsgPrompt(mode, custom) {
+    const text = custom?.trim() ?? "";
+    if (mode === "replace" && text)
+        return text;
+    if (text)
+        return `${COMMITMSG_SYSTEM_PROMPT}\n\n${text}`;
+    return COMMITMSG_SYSTEM_PROMPT;
+}
+/** "path → [add,del]" map → compact "+12/-3 path" lines (sorted by path). */
+function formatNumStat(stat) {
+    return Object.keys(stat)
+        .sort()
+        .map((p) => `+${stat[p][0]}/-${stat[p][1]} ${p}`);
+}
+/**
+ * Assemble the user message from the gathered context. Returns null when
+ * there is nothing to describe (no staged/unstaged diff and no untracked
+ * files) — the caller replies "no changes" instead of calling the model.
+ */
+export function buildCommitMsgInput(ctx, fallbackLang) {
+    const parts = [];
+    if (ctx.subjects.length > 0) {
+        parts.push("Recent commit subjects (newest first — style reference):");
+        parts.push(...ctx.subjects.map((s) => `- ${s}`));
+    }
+    else {
+        parts.push(fallbackLang === "zh"
+            ? "（仓库还没有任何提交；请用中文写这条提交信息）"
+            : "(The repository has no commits yet; write this commit message in English.)");
+    }
+    if (ctx.files.length > 0) {
+        const shown = ctx.files.slice(0, MAX_FILE_LINES);
+        const more = ctx.files.length - shown.length;
+        parts.push("Changed files (porcelain status):");
+        parts.push(...shown.map((f) => `${f.x}${f.y} ${f.path}`));
+        if (more > 0)
+            parts.push(`… (+${more} more files)`);
+    }
+    if (ctx.stagedPatch.trim()) {
+        parts.push("Staged diff (these changes are the commit's subject):");
+        if (Object.keys(ctx.stagedStat).length > 0) {
+            parts.push(...formatNumStat(ctx.stagedStat));
+        }
+        parts.push(ctx.stagedPatch);
+    }
+    if (ctx.worktreePatch.trim()) {
+        parts.push("Unstaged diff (worktree only):");
+        if (Object.keys(ctx.worktreeStat).length > 0) {
+            parts.push(...formatNumStat(ctx.worktreeStat));
+        }
+        parts.push(ctx.worktreePatch);
+    }
+    const untracked = ctx.files.filter((f) => f.x === "?" && f.y === "?");
+    if (untracked.length > 0 && !ctx.stagedPatch.trim()) {
+        // Untracked content never appears in `git diff` — name the files so
+        // the model knows they are part of the change set (commit-all flow).
+        parts.push(`Untracked files (new, content not shown): ${untracked
+            .map((f) => f.path)
+            .join(", ")
+            .slice(0, 2000)}`);
+    }
+    if (!ctx.stagedPatch.trim() && !ctx.worktreePatch.trim() && untracked.length === 0)
+        return null;
+    return parts.join("\n");
+}
+/**
+ * Normalize whatever the model emitted into the single-line subject that goes
+ * into the commit input: drop fences, labels and wrapping quotes, keep only
+ * the first non-empty line, collapse whitespace, cap the length.
+ */
+export function sanitizeCommitMessage(raw) {
+    let text = raw.trim();
+    // ```…``` fences wrapping the whole answer.
+    const fence = text.match(/^```[a-zA-Z]*\s*\n?([\s\S]*?)\n?```$/);
+    if (fence)
+        text = fence[1].trim();
+    // Leading labels some models add despite the instructions.
+    text = text.replace(/^(commit(\s+message)?|subject|提交信息|提交消息|提交说明)\s*[:：]\s*/i, "");
+    // First non-empty line only — the input field is single-line by design.
+    const firstLine = text
+        .split("\n")
+        .map((l) => l.trim())
+        .find((l) => l.length > 0) ?? "";
+    let out = firstLine.replace(/\s+/g, " ").trim();
+    // Matching wrapping quotes.
+    if (out.length >= 2) {
+        const a = out[0];
+        const b = out[out.length - 1];
+        if ((a === '"' && b === '"') || (a === "'" && b === "'") || (a === "`" && b === "`")) {
+            out = out.slice(1, -1).trim();
+        }
+    }
+    if (out.length > MAX_COMMITMSG_LEN)
+        out = `${out.slice(0, MAX_COMMITMSG_LEN - 1).trimEnd()}…`;
+    return out;
+}

package/dist/server/scm.js

@@ -295,3 +295,45 @@ export async function scmFileDiff(cwd, path, lang) {
 export async function scmCommitDetail(cwd, hash, lang) {
     return git(cwd, ["show", "--no-color", "--no-ext-diff", "--find-renames", "--format=fuller", "--stat", "--patch", hash], lang);
 }
+/* ------------------------------------------------------------------ */
+/* AI commit-message context                                           */
+/* ------------------------------------------------------------------ */
+/** Cap per patch (staged / worktree) fed to the commit-message prompt —
+ *  enough for the model to see what most commits are about without letting
+ *  one huge repo blow up the one-off completion request. */
+const MAX_COMMITMSG_PATCH_CHARS = 12_000;
+/** Cap one patch at MAX_COMMITMSG_PATCH_CHARS, keeping the head (early files
+ *  matter most for a commit message) and marking the cut. */
+function capPatch(text) {
+    if (text.length <= MAX_COMMITMSG_PATCH_CHARS)
+        return text;
+    return `${text.slice(0, MAX_COMMITMSG_PATCH_CHARS)}\n… (diff truncated)`;
+}
+/** Gather staged/worktree patches, numstats, status and recent subjects for
+ *  the AI commit-message generator. Throws the usual git errors (including
+ *  "not a git repository") — the caller maps them to friendly replies. */
+export async function scmCommitContext(cwd, lang) {
+    const [stagedPatch, worktreePatch, stagedStatText, worktreeStatText, statusText, subjectText] = await Promise.all([
+        git(cwd, ["diff", "--cached", "--no-color", "--no-ext-diff", "--find-renames"], lang).catch(() => ""),
+        git(cwd, ["diff", "--no-color", "--no-ext-diff", "--find-renames"], lang).catch(() => ""),
+        git(cwd, ["diff", "--cached", "--numstat"], lang).catch(() => ""),
+        git(cwd, ["diff", "--numstat"], lang).catch(() => ""),
+        git(cwd, ["status", "--porcelain=v1", "--find-renames"], lang),
+        // Empty repos (no commits yet) make `git log` fail — that's a valid
+        // "no style reference" answer, not an error worth failing the request.
+        git(cwd, ["log", "-n", "15", "--pretty=format:%s"], lang).then((s) => s, () => ""),
+    ]);
+    const subjects = subjectText
+        .split("\n")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    return {
+        subjects,
+        emptyRepo: subjects.length === 0,
+        files: parseStatusFiles(statusText),
+        stagedStat: parseNumStat(stagedStatText),
+        worktreeStat: parseNumStat(worktreeStatText),
+        stagedPatch: capPatch(stagedPatch),
+        worktreePatch: capPatch(worktreePatch),
+    };
+}

package/dist/server/serialize.js

@@ -1,6 +1,13 @@
 const TEXT_CAP = 200_000;
 const TOOL_OUTPUT_CAP = 100_000;
 const ARGS_CAP = 20_000;
+/**
+ * toolResult.details 的体积上限。details 是给 UI 用的结构化元数据（如
+ * present_files 的卡片数据、ask_user_question 的答案），快照每 60ms 推一次，
+ * 不能无节制。超过上限时**整个丢掉**（而不是截断 —— 截断后的 JSON 不可解析，
+ * 前端还得写容错）；工具作者应自己封顶（见 present-files-tool.ts 的摘录预算）。
+ */
+const TOOL_DETAILS_CAP = 64_000;
 function truncate(s, cap) {
     if (s.length <= cap)
         return { text: s, truncated: false };
@@ -106,7 +113,7 @@ export function serializeMessage(m, seq) {
         case "toolResult": {
             const raw = m.content.map((c) => (c.type === "text" ? c.text : "[image result]")).join("\n");
             const { text, truncated } = truncate(raw, TOOL_OUTPUT_CAP);
-            return {
+            const msg = {
                 id: `t-${m.toolCallId}`,
                 role: "toolResult",
                 content: [{ type: "text", text, truncated }],
@@ -115,6 +122,19 @@ export function serializeMessage(m, seq) {
                 isError: m.isError,
                 timestamp: m.timestamp,
             };
+            // 结构化元数据（tool result details）也要下发：present_files 的预览卡片
+            // 就靠它拿 kind/size/excerpt（前端不能靠再打一次 HTTP 才知类型），
+            // ask_user_question/todo_list 同理。体积封顶，超限整丢（见 TOOL_DETAILS_CAP）。
+            if (m.details !== undefined) {
+                try {
+                    if (JSON.stringify(m.details).length <= TOOL_DETAILS_CAP)
+                        msg.details = m.details;
+                }
+                catch {
+                    // 循环引用等序列化不了的值：details 是附加信息，丢掉不影响消息本体。
+                }
+            }
+            return msg;
         }
         case "bashExecution": {
             const { text, truncated } = truncate(m.output, TOOL_OUTPUT_CAP);

package/dist/server/settings-service.js

@@ -10,7 +10,9 @@ import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { basename, dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { extensionKey, normalizeDisabledPluginTools, normalizeRetryMaxAttempts, normalizeSkillList, normalizeUiLayout, } from "./client-state.js";
+import { normalizeSoftCapByModel, normalizeSoftCapTokens } from "./soft-cap.js";
 import { findVisionModels, SYSTEM_PROMPT } from "./vision-bridge.js";
+import { COMMITMSG_SYSTEM_PROMPT } from "./scm-commitmsg.js";
 import { DEFAULT_TEMPLATES } from "./subagent-templates.js";
 import { deriveLegacy, foldLegacyIntoDisabled, normalizeDisabledAgentTools } from "./tool-manager.js";
 export class SettingsService {
@@ -287,8 +289,10 @@ export class SettingsService {
                 terminalToolsEnabled: legacyTools.terminalToolsEnabled,
                 terminalBash: this.settings.terminalBash,
                 terminalBashIdleMs: this.settings.terminalBashIdleMs,
+                readDirEnabled: this.settings.readDirEnabled !== false,
                 editSoftEnabled: legacyTools.editSoftEnabled,
                 questionnaireEnabled: legacyTools.questionnaireEnabled,
+                parallelReminderEnabled: this.settings.parallelReminderEnabled ?? true,
                 goalModeEnabled: this.settings.goalModeEnabled,
                 devNoCache: this.settings.devNoCache ?? this.defaultDevNoCache(),
                 autoReload: this.settings.autoReload ?? this.defaultDevNoCache(),
@@ -298,6 +302,8 @@ export class SettingsService {
                 visionBridgeModel: this.settings.visionBridgeModel,
                 visionBridgePromptMode: this.settings.visionBridgePromptMode,
                 visionBridgePrompt: this.settings.visionBridgePrompt,
+                scmCommitMsgPromptMode: this.settings.scmCommitMsgPromptMode,
+                scmCommitMsgPrompt: this.settings.scmCommitMsgPrompt,
                 reviewPrompt: this.settings.reviewPrompt,
                 reviewDisabledSkills: [...this.settings.reviewDisabledSkills],
                 disabledPlugins: [...(this.settings.disabledPlugins ?? [])],
@@ -310,6 +316,7 @@ export class SettingsService {
                 // 发给模型的工具 schema（name/description/parameters）—— 只读预览。
                 toolsSchema: promptSnap.toolsSchema,
                 visionBridgeDefaultPrompt: SYSTEM_PROMPT,
+                scmCommitMsgDefaultPrompt: COMMITMSG_SYSTEM_PROMPT,
                 visionModels: this.collectVisionModels(),
                 disabledSkills: [...this.settings.disabledSkills],
                 disabledExtensions: [...this.settings.disabledExtensions],
@@ -328,6 +335,8 @@ export class SettingsService {
                 subagentDefaultTemplates: DEFAULT_TEMPLATES.map((t) => t.name),
                 subagentDefaultModel: this.settings.subagentDefaultModel ?? null,
                 retryMaxAttempts: this.settings.retryMaxAttempts,
+                softCapTokens: this.settings.softCapTokens,
+                softCapByModel: { ...this.settings.softCapByModel },
                 subagentModels: this.collectSubagentModels(),
                 quickPhrases: [...this.settings.quickPhrases],
                 quickPhrasesEnabled: this.settings.quickPhrasesEnabled,
@@ -450,10 +459,18 @@ export class SettingsService {
         if (partial.terminalBashIdleMs !== undefined) {
             this.settings.terminalBashIdleMs = Math.max(0, Math.floor(partial.terminalBashIdleMs) || 0);
         }
+        // read 读目录开关：覆盖定义每次调用实时读取，改动即时生效，无需 reload。
+        if (partial.readDirEnabled !== undefined) {
+            this.settings.readDirEnabled = partial.readDirEnabled;
+        }
         // 目标模式总开关：运行时无需重载（goal bar / 服务端入口实时读取）。
         if (partial.goalModeEnabled !== undefined) {
             this.settings.goalModeEnabled = partial.goalModeEnabled;
         }
+        // 同项目并行提醒开关：同上，发送入口逐轮实时读取，无需 reload。
+        if (partial.parallelReminderEnabled !== undefined) {
+            this.settings.parallelReminderEnabled = partial.parallelReminderEnabled;
+        }
         if (partial.devNoCache !== undefined) {
             this.settings.devNoCache = partial.devNoCache;
         }
@@ -483,6 +500,12 @@ export class SettingsService {
         if (partial.visionBridgePrompt !== undefined) {
             this.settings.visionBridgePrompt = partial.visionBridgePrompt;
         }
+        if (partial.scmCommitMsgPromptMode !== undefined) {
+            this.settings.scmCommitMsgPromptMode = partial.scmCommitMsgPromptMode;
+        }
+        if (partial.scmCommitMsgPrompt !== undefined) {
+            this.settings.scmCommitMsgPrompt = partial.scmCommitMsgPrompt;
+        }
         if (partial.reviewPrompt !== undefined) {
             this.settings.reviewPrompt = partial.reviewPrompt;
         }
@@ -500,6 +523,18 @@ export class SettingsService {
             this.settings.retryMaxAttempts = normalizeRetryMaxAttempts(partial.retryMaxAttempts);
             this.host.applyRetryOverrides();
         }
+        if (partial.softCapTokens !== undefined || partial.softCapByModel !== undefined) {
+            // 压缩软上限：持久化 + 即时重算各会话的 compaction reserveTokens
+            // 覆盖（SDK 每次自动压缩检查前都重读 getCompactionSettings，无需
+            // reload；见宿主 applyCompactionOverrides，issue #229）。
+            if (partial.softCapTokens !== undefined)
+                this.settings.softCapTokens = normalizeSoftCapTokens(partial.softCapTokens);
+            if (partial.softCapByModel !== undefined)
+                this.settings.softCapByModel = normalizeSoftCapByModel(partial.softCapByModel);
+            this.host.applyCompactionOverrides();
+            // 底栏标记线读快照的 contextUsage.softCap——推一次快照让在线页即时看到。
+            this.host.flushSnapshot();
+        }
         if (partial.quickPhrases !== undefined) {
             // 归一化：去空白/空项/重名，单条 ≤200 字，最多 30 条。纯 UI 偏好，不 reload。
             const seen = new Set();
@@ -546,6 +581,8 @@ export class SettingsService {
             terminalBashIdleMs: this.settings.terminalBashIdleMs,
             editSoftEnabled: this.settings.editSoftEnabled,
             retryMaxAttempts: this.settings.retryMaxAttempts,
+            softCapTokens: this.settings.softCapTokens,
+            softCapByModel: { ...this.settings.softCapByModel },
             reviewPrompt: this.settings.reviewPrompt,
             reviewDisabledSkills: [...this.settings.reviewDisabledSkills],
             skillsFullText: [...normalizeSkillList(this.settings.skillsFullText)],
@@ -591,11 +628,18 @@ export class SettingsService {
             // 终端接管偏好随预设走；旧预设缺字段时保留当前值。
             terminalBash: p.terminalBash ?? this.settings.terminalBash,
             terminalBashIdleMs: p.terminalBashIdleMs ?? this.settings.terminalBashIdleMs,
+            // read 读目录是纯运行行为开关，不进预设——保留当前值。
+            readDirEnabled: this.settings.readDirEnabled !== false,
             editSoftEnabled: presetLegacy.editSoftEnabled,
             // 重试次数随预设走；旧预设缺字段时保留当前值，应用后即时注入各会话。
             retryMaxAttempts: p.retryMaxAttempts ?? this.settings.retryMaxAttempts,
+            // 压缩软上限同样随预设走（issue #229）；旧预设缺字段时保留当前值。
+            softCapTokens: normalizeSoftCapTokens(p.softCapTokens ?? this.settings.softCapTokens),
+            softCapByModel: normalizeSoftCapByModel(p.softCapByModel ?? this.settings.softCapByModel),
             // 问卷开关不进预设——保留当前值。
             questionnaireEnabled: this.settings.questionnaireEnabled,
+            // 同项目并行提醒开关不进预设——保留当前值。
+            parallelReminderEnabled: this.settings.parallelReminderEnabled ?? true,
             // 目标模式总开关不进预设——保留当前值。
             goalModeEnabled: this.settings.goalModeEnabled,
             reviewPrompt: p.reviewPrompt ?? this.settings.reviewPrompt,
@@ -614,6 +658,9 @@ export class SettingsService {
             visionBridgeModel: this.settings.visionBridgeModel,
             visionBridgePromptMode: this.settings.visionBridgePromptMode,
             visionBridgePrompt: this.settings.visionBridgePrompt,
+            // 「AI 提交信息」提示词同样不进预设——保留当前值。
+            scmCommitMsgPromptMode: this.settings.scmCommitMsgPromptMode,
+            scmCommitMsgPrompt: this.settings.scmCommitMsgPrompt,
             // 子代理默认模型也不进预设——保留当前值。
             subagentDefaultModel: this.settings.subagentDefaultModel,
             // 快捷短语是纯 UI 偏好，不进预设——保留当前值。