pi-zh-cn 0.2.0 → 0.2.2

package/extensions/localized-tools.ts

@@ -0,0 +1,265 @@
+/**
+ * 内置 read/bash/edit/write/grep/find/ls/powershell 工具的中文渲染。
+ * 同名重注册，执行委托原实现（createXxxTool）；
+ * 不改动发给模型的内容（工具 description 保持英文）。
+ */
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import {
+  createBashTool,
+  createEditTool,
+  createFindTool,
+  createGrepTool,
+  createLsTool,
+  createPowerShellTool,
+  createReadTool,
+  createWriteTool,
+  type BashToolDetails,
+  type EditToolDetails,
+  type ReadToolDetails,
+} from "@earendil-works/pi-coding-agent";
+import { Text } from "@earendil-works/pi-tui";
+import { zh } from "./zh.ts";
+import {
+  countResultRender,
+  errorFirstLine,
+  notePartial,
+  shellRenders,
+  withExpanded,
+} from "./tool-renders.ts";
+
+/**
+ * 重注册所有内置工具的中文渲染。
+ *
+ * 逐个用 `createXxxTool(cwd)` 重新生成内置实现并展开同名注册：执行逻辑、
+ * 参数与 description（发给模型的）保持原样，仅覆盖 `label` 与
+ * `renderCall`/`renderResult` 为中文渲染；各工具在 `zh.tools.*` 下有自己的
+ * 文案对象。grep / find / ls / powershell 仅在内置工具集存在时注册。
+ *
+ * @param pi 扩展 API 实例
+ * @param cwd 当前项目目录（透传给 createXxxTool）
+ */
+export function registerLocalizedTools(pi: ExtensionAPI, cwd: string) {
+  const activeTools = pi.getActiveTools();
+  const builtinTools = new Set(
+    pi
+      .getAllTools()
+      .filter((tool) => tool.sourceInfo.source === "builtin")
+      .map((tool) => tool.name),
+  );
+
+  // read
+  pi.registerTool({
+    ...createReadTool(cwd),
+    label: zh.tools.read.label,
+
+    renderCall(args: any, theme: any) {
+      let text = theme.fg("toolTitle", theme.bold(`${zh.tools.read.title} `));
+      text += theme.fg("accent", args.path);
+      if (args.offset || args.limit) {
+        const parts: string[] = [];
+        if (args.offset) parts.push(`offset=${args.offset}`);
+        if (args.limit) parts.push(`limit=${args.limit}`);
+        text += theme.fg("dim", ` (${parts.join(", ")})`);
+      }
+      return new Text(text, 0, 0);
+    },
+
+    renderResult(
+      result: any,
+      { expanded, isPartial }: { expanded: boolean; isPartial: boolean },
+      theme: any,
+    ) {
+      if (isPartial) return notePartial(zh.tools.read.reading, theme);
+
+      const content = result.content[0];
+      if (content?.type === "image") {
+        return new Text(theme.fg("success", zh.tools.read.imageLoaded), 0, 0);
+      }
+      if (content?.type !== "text") {
+        return new Text(theme.fg("error", zh.tools.read.noContent), 0, 0);
+      }
+
+      let text = theme.fg(
+        "success",
+        zh.tools.read.lines(content.text.split("\n").length),
+      );
+      const truncation = (result.details as ReadToolDetails | undefined)
+        ?.truncation;
+      if (truncation?.truncated) {
+        text += theme.fg(
+          "warning",
+          zh.tools.read.truncatedFrom(truncation.totalLines),
+        );
+      }
+      return new Text(
+        withExpanded(expanded ? content.text : "", text, theme),
+        0,
+        0,
+      );
+    },
+  });
+
+  // bash / powershell（渲染逻辑同构，仅文案与失败判定集合不同）
+  pi.registerTool({
+    ...createBashTool(cwd),
+    label: zh.tools.bash.label,
+    ...shellRenders(zh.tools.bash),
+  });
+
+  // edit
+  pi.registerTool({
+    ...createEditTool(cwd),
+    label: zh.tools.edit.label,
+    renderShell: "self",
+
+    renderCall(args: any, theme: any) {
+      let text = theme.fg("toolTitle", theme.bold(zh.tools.edit.title));
+      text += theme.fg("accent", args.path);
+      return new Text(text, 0, 0);
+    },
+
+    renderResult(
+      result: any,
+      { expanded, isPartial }: { expanded: boolean; isPartial: boolean },
+      theme: any,
+    ) {
+      if (isPartial) return notePartial(zh.tools.edit.editing, theme);
+
+      const err = errorFirstLine(result, theme);
+      if (err) return err;
+
+      const details = result.details as EditToolDetails | undefined;
+      if (!details?.diff) {
+        return new Text(theme.fg("success", zh.tools.edit.applied), 0, 0);
+      }
+
+      let additions = 0,
+        removals = 0;
+      for (const line of details.diff.split("\n")) {
+        if (line.startsWith("+") && !line.startsWith("+++")) additions++;
+        if (line.startsWith("-") && !line.startsWith("---")) removals++;
+      }
+
+      let text = theme.fg("success", zh.tools.edit.additions(additions));
+      text += theme.fg("dim", " / ");
+      text += theme.fg("error", zh.tools.edit.removals(removals));
+
+      return new Text(
+        withExpanded(expanded ? details.diff : "", text, theme),
+        0,
+        0,
+      );
+    },
+  });
+
+  // write
+  pi.registerTool({
+    ...createWriteTool(cwd),
+    label: zh.tools.write.label,
+
+    renderCall(args: any, theme: any) {
+      let text = theme.fg("toolTitle", theme.bold(zh.tools.write.title));
+      text += theme.fg("accent", args.path);
+      const lineCount = String(args.content).split("\n").length;
+      text += theme.fg("dim", ` (${zh.tools.write.lines(lineCount)})`);
+      return new Text(text, 0, 0);
+    },
+
+    renderResult(result: any, { isPartial }: { isPartial: boolean }, theme: any) {
+      if (isPartial) return notePartial(zh.tools.write.writing, theme);
+      const err = errorFirstLine(result, theme);
+      if (err) return err;
+      return new Text(theme.fg("success", zh.tools.write.written), 0, 0);
+    },
+  });
+
+  // grep / find / ls：调用渲染各自略有差异，结果渲染走同一个计数模板。
+  if (builtinTools.has("grep")) {
+    pi.registerTool({
+      ...createGrepTool(cwd),
+      label: zh.tools.grep.label,
+
+      renderCall(args: any, theme: any) {
+        let text = theme.fg("toolTitle", theme.bold(zh.tools.grep.title));
+        text += theme.fg("accent", args.pattern);
+        if (args.path) text += theme.fg("dim", ` · ${args.path}`);
+        if (args.glob) text += theme.fg("dim", ` (${args.glob})`);
+        return new Text(text, 0, 0);
+      },
+
+      renderResult: countResultRender(
+        {
+          searching: zh.tools.grep.searching,
+          noMatch: zh.tools.grep.noMatches,
+          found: zh.tools.grep.matches,
+          limit: zh.tools.grep.matchLimit,
+          truncated: zh.tools.grep.truncated,
+        },
+        "No matches found",
+        "matchLimitReached",
+      ),
+    });
+  }
+
+  if (builtinTools.has("find")) {
+    pi.registerTool({
+      ...createFindTool(cwd),
+      label: zh.tools.find.label,
+
+      renderCall(args: any, theme: any) {
+        let text = theme.fg("toolTitle", theme.bold(zh.tools.find.title));
+        text += theme.fg("accent", args.pattern);
+        if (args.path) text += theme.fg("dim", ` · ${args.path}`);
+        return new Text(text, 0, 0);
+      },
+
+      renderResult: countResultRender(
+        {
+          searching: zh.tools.find.searching,
+          noMatch: zh.tools.find.noFiles,
+          found: zh.tools.find.results,
+          limit: zh.tools.find.resultLimit,
+          truncated: zh.tools.grep.truncated,
+        },
+        "No files found matching pattern",
+        "resultLimitReached",
+      ),
+    });
+  }
+
+  if (builtinTools.has("ls")) {
+    pi.registerTool({
+      ...createLsTool(cwd),
+      label: zh.tools.ls.label,
+
+      renderCall(args: any, theme: any) {
+        let text = theme.fg("toolTitle", theme.bold(zh.tools.ls.title));
+        text += theme.fg("accent", args.path || ".");
+        return new Text(text, 0, 0);
+      },
+
+      renderResult: countResultRender(
+        {
+          searching: zh.tools.ls.listing,
+          noMatch: zh.tools.ls.empty,
+          found: zh.tools.ls.entries,
+          limit: zh.tools.ls.entryLimit,
+          truncated: zh.tools.grep.truncated,
+        },
+        "(empty directory)",
+        "entryLimitReached",
+      ),
+    });
+  }
+
+  if (builtinTools.has("powershell")) {
+    pi.registerTool({
+      ...createPowerShellTool(cwd),
+      label: zh.tools.powershell.label,
+      ...shellRenders(zh.tools.powershell, [/only available on windows/i]),
+    });
+  }
+
+  // 同名注册可能改变 active 集合；恢复注册前的工具启用状态。
+  pi.setActiveTools(activeTools);
+}

package/extensions/tool-renders.ts

@@ -0,0 +1,184 @@
+/**
+ * 内置工具渲染的共享文案模板：read/bash/edit/write/grep/find/ls
+ * 的 renderResult 共用这些小工具。
+ */
+import type {
+  BashToolDetails,
+} from "@earendil-works/pi-coding-agent";
+import { Text } from "@earendil-works/pi-tui";
+import { zh } from "./zh.ts";
+
+/**
+ * 取工具结果中的首个 text 块内容；结果不含文本块（如图片）时返回空串。
+ */
+export const textOf = (result: any): string =>
+  result.content?.[0]?.type === "text" ? result.content[0].text : "";
+
+/** 统计非空行数，用于「N 行输出」类摘要。 */
+export const countNonEmpty = (s: string): number =>
+  s.split("\n").filter((l) => l.trim()).length;
+
+/** 流式部分结果的占位文案（黄色提示行）。 */
+export const notePartial = (msg: string, theme: any): Text =>
+  new Text(theme.fg("warning", msg), 0, 0);
+
+// 错误结果：内容以 "Error" 开头时只展示首行（edit/write 共用）。
+/** 展示错误首行（红色）；结果不是错误时返回 undefined。 */
+export const errorFirstLine = (result: any, theme: any): Text | undefined => {
+  const out = textOf(result);
+  return out.startsWith("Error")
+    ? new Text(theme.fg("error", out.split("\n")[0]), 0, 0)
+    : undefined;
+};
+
+// 展开态：在摘要后追加逐行弱化的原始输出。
+/**
+ * 组装展开态文本：raw 为空时返回 summary，否则在 summary 之后
+ * 追加逐行弱化（dim 色）的原始输出。
+ */
+export const withExpanded = (raw: string, summary: string, theme: any): string =>
+  raw
+    ? `${summary}\n${raw
+        .split("\n")
+        .map((l) => theme.fg("dim", l))
+        .join("\n")}`
+    : summary;
+
+/**
+ * 判定 shell 命令是否失败。
+ *
+ * 内置 bash 工具不返回结构化退出码，只能从输出文本推断：匹配
+ * 「exit code: N」/「command exited with code N」即失败；以 Error 开头、
+ * 或含超时/中止提示也视为失败。powershell 在 Windows 上额外追加平台
+ * 提示，通过 extraRe 补充识别。
+ *
+ * @param output 工具输出的完整文本
+ * @param extraRe 额外的失败特征正则（默认无）
+ * @returns exitCode 解析到的退出码（无法解析为 null）；failed 是否视为失败
+ */
+function failureState(output: string, extraRe: RegExp[] = []) {
+  const m = output.match(
+    /(?:exit code:\s*|command exited with code\s+)(\d+)/i,
+  );
+  const exitCode = m ? parseInt(m[1], 10) : null;
+  return {
+    exitCode,
+    failed:
+      exitCode !== null ||
+      /^error\b/i.test(output) ||
+      /\n\ncommand (?:timed out|was aborted|failed)/i.test(output) ||
+      extraRe.some((re) => re.test(output)),
+  };
+}
+
+// shell 类工具（bash/powershell 文案同构）的渲染对。
+type ShellCopy =
+  | typeof zh.tools.bash
+  | typeof zh.tools.powershell;
+
+/**
+ * 生成 shell 类工具（bash / powershell）共用的 renderCall + renderResult。
+ *
+ * 调用渲染显示命令（超 80 字符截断）与可选的超时参数；结果渲染根据
+ * {@link failureState} 显示完成/失败状态、非空行数与截断警告，展开态追加
+ * 逐行弱化的原始输出。
+ *
+ * @param w 该工具的文案对象（zh.tools.bash 或 zh.tools.powershell）
+ * @param extraRe 传给 {@link failureState} 的额外失败特征正则
+ */
+export function shellRenders(w: ShellCopy, extraRe: RegExp[] = []) {
+  return {
+    renderCall(args: any, theme: any): Text {
+      let text = theme.fg("toolTitle", theme.bold(w.title));
+      const cmd: string =
+        args.command.length > 80
+          ? `${args.command.slice(0, 77)}...`
+          : args.command;
+      text += theme.fg("accent", cmd);
+      if (args.timeout) text += theme.fg("dim", w.timeout(args.timeout));
+      return new Text(text, 0, 0);
+    },
+
+    renderResult(
+      result: any,
+      { expanded, isPartial }: { expanded: boolean; isPartial: boolean },
+      theme: any,
+    ): Text {
+      if (isPartial) return notePartial(w.running, theme);
+      const output = textOf(result);
+      const { exitCode, failed } = failureState(output, extraRe);
+      let text = failed
+        ? theme.fg(
+            "error",
+            exitCode !== null ? w.exit(exitCode) : w.failed,
+          )
+        : theme.fg("success", w.done);
+      text += theme.fg("dim", ` (${w.lines(countNonEmpty(output))})`);
+      if (
+        (result.details as BashToolDetails | undefined)?.truncation?.truncated
+      ) {
+        text += theme.fg("warning", ` ${w.truncated}`);
+      }
+      return new Text(withExpanded(expanded ? output : "", text, theme), 0, 0);
+    },
+  };
+}
+
+/**
+ * 生成计数类工具（grep / find / ls）共用的 renderResult 渲染器。
+ *
+ * 结果形态四处一致：流式时显示「搜索中」占位；输出等于哨兵值时显示
+ * 「无匹配」（muted 色）；否则显示「N 行/个/项」（success 色）；达到上限
+ * （由 details 中 limitField 字段标记）或发生截断时追加警告。展开态在
+ * 摘要后追加原始输出（无匹配时用 noMatch 文案替代）。
+ *
+ * @param labels 各工具对应的中文文案对象（searching 流式占位、noMatch 无
+ *   匹配文案、found 条数摘要、limit 可选的上限提示、truncated 截断警告）
+ * @param sentinel 无匹配时内置工具输出的哨兵字符串
+ * @param limitField details 中标记「已达到上限」的字段名
+ *   （matchLimitReached / resultLimitReached / entryLimitReached）
+ */
+export function countResultRender(
+  labels: {
+    searching: string;
+    noMatch: string;
+    found: (n: number) => string;
+    limit?: (n: number) => string;
+    truncated: string;
+  },
+  sentinel: string,
+  limitField: string,
+) {
+  return (
+    result: any,
+    { expanded, isPartial }: { expanded: boolean; isPartial: boolean },
+    theme: any,
+  ): Text => {
+    if (isPartial) return notePartial(labels.searching, theme);
+    const details = result.details ?? {};
+    const output = textOf(result);
+    const isEmpty = output === sentinel;
+    let text = theme.fg(
+      isEmpty ? "muted" : "success",
+      isEmpty ? labels.noMatch : labels.found(countNonEmpty(output)),
+    );
+    if (labels.limit && typeof details[limitField] === "number") {
+      text += theme.fg("warning", labels.limit(details[limitField]));
+    }
+    // 与旧实现的行为差异：grep 原本同时检查 linesTruncated，find/ls 只查
+    // truncation.truncated；这里统一为两者都检查，Find/LsToolDetails 目前无
+    // linesTruncated 字段，运行时行为等价。若上游新增该字段需复核。
+    if (details.linesTruncated || details.truncation?.truncated) {
+      text += theme.fg("warning", labels.truncated);
+    }
+    return new Text(
+      withExpanded(
+        expanded ? (isEmpty ? labels.noMatch : output) : "",
+        text,
+        theme,
+      ),
+      0,
+      0,
+    );
+  };
+}

package/extensions/trust.ts

@@ -0,0 +1,144 @@
+/**
+ * 项目信任弹窗：中文选择器代替内置英文界面。
+ *
+ * 复刻 ~/「agent dir」/trust.json 的读写逻辑（与内置 ProjectTrustStore
+ * 同格式：键为 realpath 归一化路径，null 表示删除该键）；已有决定的目录
+ * 不再弹窗。选项与内置一一对应，含「信任父文件夹」变体——扩展 API 表达
+ * 不了父目录决定，这里按内置 setMany 语义直接写 trust.json 实现。
+ */
+import {
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  realpathSync,
+  writeFileSync,
+} from "node:fs";
+import { dirname, join } from "node:path";
+import {
+  getAgentDir,
+  type ExtensionAPI,
+} from "@earendil-works/pi-coding-agent";
+import { zh } from "./zh.ts";
+
+/** realpath 归一化（与 core 的 normalizeCwd 等价）；目录不存在时原样返回。 */
+const normalizeDir = (dir: string): string => {
+  try {
+    return realpathSync(dir);
+  } catch {
+    return dir;
+  }
+};
+
+/** trust.json 路径。 */
+const trustFile = (): string => join(getAgentDir(), "trust.json");
+
+/**
+ * 查询某个目录已保存的项目信任决定。
+ *
+ * 查找规则与内置逻辑一致：先对目录做 realpath 归一化，然后沿祖先链在
+ * `~/<agentDir>/trust.json` 中查找该目录（或其任一祖先）的记录——子目录
+ * 继承最近的祖先决定；到达根目录仍无记录则视为未决定。
+ *
+ * @param dir 要查询的项目目录（绝对路径）
+ * @returns 已保存的信任（`true`）/ 不信任（`false`）决定；
+ *          目录未被记录、trust.json 缺失或内容无效时返回 `null`
+ */
+const savedTrustDecision = (dir: string): boolean | null => {
+  let current = normalizeDir(dir);
+  try {
+    const store = JSON.parse(readFileSync(trustFile(), "utf8"));
+    for (;;) {
+      const decision = store[current];
+      if (typeof decision === "boolean") return decision;
+      const parent = dirname(current);
+      if (parent === current) return null;
+      current = parent;
+    }
+  } catch {
+    return null; // 无 trust.json 或内容无效 → 视作没有已存决定
+  }
+};
+
+/**
+ * 写入信任决定，语义与内置 ProjectTrustStore.setMany / writeTrustFile
+ * 一致：`decision` 为 `null` 删除该键；输出按键排序、2 空格缩进、结尾
+ * 换行。文件缺失时从空表开始；内容无效时抛出（与内置一致，此时事件
+ * 处理器报错，core 回退到内置英文弹窗）。
+ *
+ * # ponytail: 无文件锁（内置用 withTrustFileLock）；只在启动信任弹窗
+ * 时写入，并发窗口极小，出现实害再补锁文件。
+ *
+ * @param decisions 要写入的决定列表
+ * @param file trust.json 路径（默认 agentDir 下；测试可覆盖）
+ */
+export const saveTrustDecisions = (
+  decisions: Array<{ path: string; decision: boolean | null }>,
+  file: string = trustFile(),
+): void => {
+  let store: Record<string, boolean | null> = {};
+  if (existsSync(file)) {
+    store = JSON.parse(readFileSync(file, "utf8"));
+  }
+  for (const { path, decision } of decisions) {
+    const key = normalizeDir(path);
+    if (decision === null) delete store[key];
+    else store[key] = decision;
+  }
+  const sorted: Record<string, boolean | null> = {};
+  for (const key of Object.keys(store).sort()) {
+    const value = store[key];
+    if (value === true || value === false || value === null) sorted[key] = value;
+  }
+  mkdirSync(dirname(file), { recursive: true });
+  writeFileSync(file, `${JSON.stringify(sorted, null, 2)}\n`, "utf8");
+};
+
+/**
+ * 注册 `project_trust` 事件处理器：用中文选择弹窗代替内置英文信任界面。
+ *
+ * 选「信任父文件夹」时按内置语义写 trust.json（父目录 = 信任、清除本目
+ * 录记录），并返回不带 `remember` 的结果——core 只在 `remember` 时写
+ * cwd，这样文件里只留下与内置选项完全相同的两条记录。
+ *
+ * 无 UI 的运行模式（rpc/print 等）或目录已有保存决定时不弹窗，返回
+ * `undecided` 让 core 走默认流程。
+ *
+ * @param pi 扩展 API 实例
+ */
+export function registerProjectTrustDialog(pi: ExtensionAPI) {
+  pi.on("project_trust", async (event, ctx) => {
+    // 无 UI（rpc/print 等模式）或已有保存的决定时返回 undecided，让 core 走默认流程。
+    if (!ctx.hasUI || savedTrustDecision(event.cwd) !== null) return { trusted: "undecided" };
+
+    const trustPath = normalizeDir(event.cwd);
+    const parentPath = dirname(trustPath);
+    const parentOption =
+      parentPath === trustPath ? undefined : zh.trust.trustParent(parentPath);
+
+    const options = [
+      zh.trust.options.trustAndRemember,
+      ...(parentOption ? [parentOption] : []),
+      zh.trust.options.trustSessionOnly,
+      zh.trust.options.distrustAndRemember,
+      zh.trust.options.distrustSessionOnly,
+    ];
+    const selected = await ctx.ui.select(zh.trust.title(event.cwd), options);
+    if (parentOption !== undefined && selected === parentOption) {
+      saveTrustDecisions([
+        { path: parentPath, decision: true },
+        { path: trustPath, decision: null },
+      ]);
+      return { trusted: "yes" }; // 不带 remember：core 不写本目录，只留上面两条记录
+    }
+    switch (selected ?? zh.trust.options.distrustSessionOnly) {
+      case zh.trust.options.trustAndRemember:
+        return { trusted: "yes", remember: true };
+      case zh.trust.options.trustSessionOnly:
+        return { trusted: "yes" };
+      case zh.trust.options.distrustAndRemember:
+        return { trusted: "no", remember: true };
+      default:
+        return { trusted: "no" }; // 取消 = 本次不信任（与内置行为一致）
+    }
+  });
+}

package/extensions/ui-copy.ts

@@ -0,0 +1,53 @@
+/**
+ * UI 文案模块：流式加载提示、thinking 折叠块标签，
+ * 以及 TUI 模式下中文化内置斜杠命令描述。
+ */
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { zh } from "./zh.ts";
+
+// 替换是幂等的，跨 session 只包一次。
+let autocompleteTranslated = false;
+
+/**
+ * 中文化内置斜杠命令的补全描述（仅 TUI 模式）。
+ *
+ * 做法：在现有 autocomplete provider 外再包一层——`getSuggestions` 只把
+ * 命令项的 `description` 换成中文（zh.builtinCommands 按命令名查找，无对应
+ * 条目的项原样透传），文件路径等其他建议不改动；`applyCompletion` 直接
+ * 委托原实现。
+ *
+ * 整个进程只包装一次（跨 session 幂等），避免重复叠加翻译层。
+ */
+function translateBuiltinCommands(ctx: ExtensionContext) {
+  if (ctx.mode !== "tui" || autocompleteTranslated) return;
+  autocompleteTranslated = true;
+  ctx.ui.addAutocompleteProvider((current) => ({
+    ...(current.triggerCharacters ? { triggerCharacters: current.triggerCharacters } : {}),
+    getSuggestions: async (lines, cursorLine, cursorCol, options) => {
+      const suggestions = await current.getSuggestions(lines, cursorLine, cursorCol, options);
+      if (!suggestions) return null;
+      return {
+        ...suggestions,
+        items: suggestions.items.map((item) => {
+          const key = item.value.replace(/^\//, "") as keyof typeof zh.builtinCommands;
+          const zhDesc = zh.builtinCommands[key];
+          return zhDesc ? { ...item, description: zhDesc } : item;
+        }),
+      };
+    },
+    applyCompletion: (lines, cursorLine, cursorCol, item, prefix) =>
+      current.applyCompletion(lines, cursorLine, cursorCol, item, prefix),
+  }));
+}
+
+/**
+ * 应用所有会话启动时的 UI 文案：流式加载提示、折叠 thinking 标签，
+ * 以及（TUI 模式下）内置斜杠命令的中文描述。
+ *
+ * @param ctx 当前会话上下文（要求 hasUI 为 true，由调用方保证）
+ */
+export function applyUiCopy(ctx: ExtensionContext) {
+  ctx.ui.setWorkingMessage(zh.workingMessage);
+  ctx.ui.setHiddenThinkingLabel(zh.hiddenThinkingLabel);
+  translateBuiltinCommands(ctx);
+}

package/extensions/zh.ts

@@ -5,6 +5,15 @@
  * 工具 description（发给模型的）保持英文原文，避免影响模型行为。
  */
 
+/**
+ * 汉化文案表（全部界面文案的单一来源）。
+ *
+ * 只包含通过扩展 API 能覆盖的界面文案；工具 description（发给模型的）
+ * 保持英文原文，避免影响模型行为。各文件按需取用：
+ * - `footer.*` → footer.ts　`header.*` → header.ts
+ * - `tools.*` → localized-tools.ts / tool-renders.ts
+ * - `trust.*` → trust.ts　`builtinCommands` → ui-copy.ts
+ */
 export const zh = {
   // 流式加载提示（默认 "Working..."，工具执行时也会显示）
   workingMessage: "正在处理…",
@@ -125,10 +134,11 @@ export const zh = {
     },
   },
 
-  // 项目信任弹窗（复刻内置“信任/不信任”选项；“信任父文件夹”变体不支持）
+  // 项目信任弹窗（复刻内置全部选项；「信任父文件夹」由扩展直接写 trust.json）
   trust: {
     title: (cwd: string) =>
-      `是否信任项目目录：${cwd}？将允许 pi 加载项目配置并执行项目扩展`,
+      `是否信任项目目录：${cwd}？\n将允许 pi 加载 .pi 配置与资源、安装项目缺失的包、执行项目扩展`,
+    trustParent: (parent: string) => `信任父文件夹（${parent}）`,
     options: {
       trustAndRemember: "信任并记住此决定",
       trustSessionOnly: "仅本次会话信任",

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "pi-zh-cn",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "pi 编码代理的简体中文界面汉化插件",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GoetheDady/pi-zh-cn.git"
+  },
   "type": "module",
   "keywords": [
     "pi-package",