dsh-ptc-plus 0.2.2 → 0.2.4

package/README.md

@@ -1,17 +1,34 @@
-# dsh-ptc-plus
+<p align="center">
+  <img src="assets/dsh-ptc-plus-banner-en.webp" width="100%" alt="dsh-ptc-plus banner">
+</p>
 
-English | [简体中文](README.zh.md)
+<p align="center">
+  <strong>English</strong> ·
+  <a href="README.zh.md">简体中文</a>
+</p>
 
-[![Node.js ^22.19.0 || >=24.0.0](https://img.shields.io/badge/Node.js-%5E22.19.0%20%7C%7C%20%3E%3D24.0.0-5fa04e?logo=nodedotjs&logoColor=white)](package.json)
-[![npm version](https://img.shields.io/npm/v/dsh-ptc-plus?logo=npm)](https://www.npmjs.com/package/dsh-ptc-plus)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-PTC%20mode-4b6bfb)](https://github.com/deepseek-ai/deepseek-harness)
-[![Status: community plugin](https://img.shields.io/badge/Status-community%20plugin-lightgrey)](docs/publishing.md)
+<p align="center">
+  <a href="#what-default-ptc-mode-gets-wrong">Problems</a> ·
+  <a href="#three-scenes-that-matter-most">Scenes</a> ·
+  <a href="#settings">Settings</a> ·
+  <a href="#scope">Scope</a> ·
+  <a href="#install">Install</a> ·
+  <a href="#documentation">Docs</a>
+</p>
 
 <p align="center">
-  <img src="assets/dsh-ptc-plus-banner.webp" alt="dsh-ptc-plus banner">
+  <a href="https://github.com/deepseek-ai/deepseek-harness"><img alt="DeepSeek Harness PTC mode" src="https://img.shields.io/badge/DeepSeek%20Harness-PTC%20mode-4b6bfb"></a>
+  <a href="package.json"><img alt="Node.js ^22.19.0 || >=24.0.0" src="https://img.shields.io/badge/Node.js-%5E22.19.0%20%7C%7C%20%3E%3D24.0.0-5fa04e?logo=nodedotjs&logoColor=white"></a>
+  <a href="https://www.npmjs.com/package/dsh-ptc-plus"><img alt="npm version" src="https://img.shields.io/npm/v/dsh-ptc-plus?logo=npm"></a>
+  <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg"></a>
 </p>
 
+<p align="center">
+  <a href="https://awesome-dsh-plugin.com/"><img alt="Awesome DSH Plugin" src="https://awesome-dsh-plugin.com/badge.svg"></a>
+</p>
+
+---
+
 **PTC Plus gives DSH PTC mode a session-bound persistent TypeScript REPL.** Every `run_code` continues in the same session. Variables, imports, and results from one `run_code` are still available in the next one.
 
 > [!NOTE]
@@ -20,7 +37,7 @@ English | [简体中文](README.zh.md)
 > [!IMPORTANT]
 > Built for `danger-full-access`: direct Node.js and OS access with no extra sandbox. Use it only where that permission scope is acceptable.
 
-![PTC Plus settings card](assets/ptc-plus-settings.png)
+![PTC Plus settings card](assets/ptc-plus-settings-en.png)
 
 *The settings card exposes live configuration and the `enabled` kill switch.*
 
@@ -73,6 +90,8 @@ edit_run_code({ edits: [{ old_string: 'deps.length', new_string: 'deps' }] })
 
 Only the diff goes in. The full source stays out of the conversation. Exact replacements and regular expressions both have limits, so a bad pattern cannot hang.
 
+When a rejected cell has exactly one validated missing closing token at the end, its diagnostic includes the complete `edit_run_code(...)` call needed to apply that correction and rerun the cell. That generated call carries an `expected_target_call_seq` precondition, so it is rejected without execution if another cell becomes the edit target first. PTC Plus never applies the suggestion automatically; ambiguous repairs or repairs without a persistent target identity still require corrected source.
+
 ### Module syntax
 
 DSH PTC mode executes each `run_code` as an async function body, where static `import` and `export` declarations are invalid. PTC Plus adapts those forms before execution with AST analysis.
@@ -106,7 +125,7 @@ This is one stochastic paired observation, not a performance guarantee. Machine
 
 ## Settings
 
-Open **Settings → Plugin configuration** to use the card shown above. The `enabled` switch is live: turning it off leaves only the card and that switch, while turning it on restores the session runtime and `run_code`/`edit_run_code`.
+Open **Settings → Plugin configuration** to use the card shown above. The card follows the DSH UI language: it renders in English when the harness is set to English, and in 中文 when set to Chinese. The `enabled` switch is live: turning it off leaves only the card and that switch, while turning it on restores the session runtime and `run_code`/`edit_run_code`.
 
 Every setting applies live and keeps existing bindings. A submitted cell uses one configuration for its complete execution; changes made while it runs apply to cells submitted afterward. A failed change rolls back. Node fixes a worker's V8 old-generation limit when the worker starts, so that one setting is rejected while a session worker is active and can be changed after the session is disposed. A failed enable is rolled back and persisted as disabled.
 
@@ -137,6 +156,6 @@ Restart that DSH profile after installation. Version-pinned npm, GitHub, local-c
 
 ## Documentation
 
-[Installation](docs/installation.md) · [Runtime reference](docs/runtime-reference.md) · [Architecture](docs/architecture.md) · [All docs](docs/README.md)
+[Installation](docs/installation.md) · [Runtime reference](docs/runtime-reference.md) · [Architecture](docs/architecture.md) · [Publishing](docs/publishing.md) · [All docs](docs/README.md)
 
 MIT licensed. See [LICENSE](LICENSE).

package/README.zh.md

@@ -1,17 +1,34 @@
-# dsh-ptc-plus
+<p align="center">
+  <img src="assets/dsh-ptc-plus-banner-zh.webp" width="100%" alt="dsh-ptc-plus 横幅">
+</p>
 
-[English](README.md) | 简体中文
+<p align="center">
+  <a href="README.md">English</a> ·
+  <strong>简体中文</strong>
+</p>
 
-[![Node.js ^22.19.0 || >=24.0.0](https://img.shields.io/badge/Node.js-%5E22.19.0%20%7C%7C%20%3E%3D24.0.0-5fa04e?logo=nodedotjs&logoColor=white)](package.json)
-[![npm version](https://img.shields.io/npm/v/dsh-ptc-plus?logo=npm)](https://www.npmjs.com/package/dsh-ptc-plus)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-PTC%20mode-4b6bfb)](https://github.com/deepseek-ai/deepseek-harness)
-[![Status: community plugin](https://img.shields.io/badge/Status-community%20plugin-lightgrey)](docs/publishing.md)
+<p align="center">
+  <a href="#%E9%BB%98%E8%AE%A4-ptc-%E6%A8%A1%E5%BC%8F%E7%9A%84%E9%97%AE%E9%A2%98">问题</a> ·
+  <a href="#%E4%B8%89%E4%B8%AA%E6%9C%80%E7%9B%B4%E6%8E%A5%E7%9A%84%E5%9C%BA%E6%99%AF">场景</a> ·
+  <a href="#%E8%AE%BE%E7%BD%AE">设置</a> ·
+  <a href="#%E8%8C%83%E5%9B%B4">范围</a> ·
+  <a href="#%E5%AE%89%E8%A3%85">安装</a> ·
+  <a href="#%E6%96%87%E6%A1%A3">文档</a>
+</p>
 
 <p align="center">
-  <img src="assets/dsh-ptc-plus-banner.webp" alt="dsh-ptc-plus 横幅">
+  <a href="https://github.com/deepseek-ai/deepseek-harness"><img alt="DeepSeek Harness PTC mode" src="https://img.shields.io/badge/DeepSeek%20Harness-PTC%20mode-4b6bfb"></a>
+  <a href="package.json"><img alt="Node.js ^22.19.0 || >=24.0.0" src="https://img.shields.io/badge/Node.js-%5E22.19.0%20%7C%7C%20%3E%3D24.0.0-5fa04e?logo=nodedotjs&logoColor=white"></a>
+  <a href="https://www.npmjs.com/package/dsh-ptc-plus"><img alt="npm version" src="https://img.shields.io/npm/v/dsh-ptc-plus?logo=npm"></a>
+  <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg"></a>
 </p>
 
+<p align="center">
+  <a href="https://awesome-dsh-plugin.com/zh/"><img alt="Awesome DSH Plugin" src="https://awesome-dsh-plugin.com/badge.svg"></a>
+</p>
+
+---
+
 **PTC Plus 给 DSH 的 PTC 模式一个会话绑定的持久 TypeScript REPL。** 每次 `run_code` 都在同一个会话里继续。上一次 `run_code` 的变量、导入和结果，下一次还能直接用。
 
 > [!NOTE]
@@ -20,7 +37,7 @@
 > [!IMPORTANT]
 > 面向 `danger-full-access` 设计：可直接访问 Node.js 与操作系统，不另加沙箱。仅在可接受此权限的环境使用。
 
-![PTC Plus 设置卡片](assets/ptc-plus-settings.png)
+![PTC Plus 设置卡片](assets/ptc-plus-settings-zh.png)
 
 *设置卡片展示即时配置和 `enabled` 开关。*
 
@@ -73,6 +90,8 @@ edit_run_code({ edits: [{ old_string: 'deps.length', new_string: 'deps' }] })
 
 模型只发改动，完整源码留在对话之外。精确文本替换和正则替换都有限制，坏的正则不会卡住。
 
+当被拒 cell 的末尾可唯一验证为缺少一个闭合符时，诊断会直接给出应用该修正并重运行所需的完整 `edit_run_code(...)` 调用。生成的调用带有 `expected_target_call_seq` 前置条件；如果另一个 cell 已先成为 edit 目标，它会拒绝且不执行。PTC Plus 不会自动应用这项建议；有歧义或没有持久目标身份的修复仍需提交修正后的源码。
+
 ### 模块语法
 
 DSH 的 PTC 模式把每个 `run_code` 当作 async function body 执行，静态 `import` 和 `export` 声明在这个函数体里无效。PTC Plus 会在执行前用 AST 分析适配这些形式。
@@ -106,7 +125,7 @@ import { readFile } from 'node:fs/promises'
 
 ## 设置
 
-打开 **设置 → 插件配置** 使用上面的设置卡片。`enabled` 是即时生效的总开关：关闭后只保留卡片和这个开关，开启后恢复 session runtime 以及 `run_code`/`edit_run_code`。
+打开 **设置 → 插件配置** 使用上面的设置卡片。卡片跟随 DSH 界面语言：界面设为 English 时显示英文，设为中文时显示中文。`enabled` 是即时生效的总开关：关闭后只保留卡片和这个开关，开启后恢复 session runtime 以及 `run_code`/`edit_run_code`。
 
 所有设置都会实时应用，并保留已有 binding。已提交的 cell 在完整执行期间使用同一份配置；执行期间发生的更新用于随后提交的 cell。更新失败会回滚。Node 在 worker 创建时固定 V8 old-generation 上限，因此活动 session worker 存在时修改这一项会被拒绝，释放 session 后才能修改。启用失败时，运行时会回滚并把设置保持为停用。
 
@@ -137,6 +156,6 @@ dsh --profile <profile> --dump-config
 
 ## 文档
 
-[安装指南](docs/installation.md) · [运行时参考](docs/runtime-reference.md) · [架构](docs/architecture.md) · [全部文档](docs/README.md)
+[安装指南](docs/installation.md) · [运行时参考](docs/runtime-reference.md) · [架构](docs/architecture.md) · [发布](docs/publishing.md) · [全部文档](docs/README.md)
 
 使用 [MIT License](LICENSE)。

package/client.js

@@ -8,14 +8,18 @@
       type: "boolean",
       default: true,
       label: "\u542F\u7528 PTC Plus",
-      description: ""
+      labelEn: "Enable PTC Plus",
+      description: "",
+      descriptionEn: ""
     },
     {
       key: "cordisToolsEnabled",
       type: "boolean",
       default: false,
       label: "\u5728 PTC \u6A21\u5F0F\u4E2D\u542F\u7528 Cordis \u5DE5\u5177",
-      description: "\u5373\u65F6\u4E3A PTC agent \u52A0\u5165\u6216\u79FB\u9664\u5B98\u65B9 Cordis \u5DE5\u5177\u3002"
+      labelEn: "Enable Cordis tools in PTC mode",
+      description: "\u5373\u65F6\u4E3A PTC agent \u52A0\u5165\u6216\u79FB\u9664\u5B98\u65B9 Cordis \u5DE5\u5177\u3002",
+      descriptionEn: "Adds or removes the official Cordis tools for the PTC agent immediately."
     },
     {
       key: "computeMs",
@@ -24,7 +28,9 @@
       min: 1,
       max: Number.MAX_SAFE_INTEGER,
       label: "\u5355 cell \u6700\u5927 CPU \u65F6\u95F4 (ms)",
-      description: "\u540C\u6B65\u8BA1\u7B97\u8D85\u8FC7\u8BE5\u9884\u7B97\u7684 cell \u4F1A\u88AB\u4E2D\u65AD\u3002"
+      labelEn: "Max CPU time per cell (ms)",
+      description: "\u540C\u6B65\u8BA1\u7B97\u8D85\u8FC7\u8BE5\u9884\u7B97\u7684 cell \u4F1A\u88AB\u4E2D\u65AD\u3002",
+      descriptionEn: "Cells whose synchronous computation exceeds this budget are interrupted."
     },
     {
       key: "maxWallMs",
@@ -33,7 +39,9 @@
       min: 1,
       max: MAX_TIMER_DELAY_MS,
       label: "\u5355 cell \u6700\u5927\u5899\u949F\u65F6\u95F4 (ms)",
-      description: "\u5B8C\u6574 cell \u6267\u884C\uFF08\u542B\u5F02\u6B65\u7B49\u5F85\uFF09\u7684\u6700\u957F\u8017\u65F6\u3002"
+      labelEn: "Max wall-clock time per cell (ms)",
+      description: "\u5B8C\u6574 cell \u6267\u884C\uFF08\u542B\u5F02\u6B65\u7B49\u5F85\uFF09\u7684\u6700\u957F\u8017\u65F6\u3002",
+      descriptionEn: "The longest a full cell execution may take, including async waits."
     },
     {
       key: "maxOutputBytes",
@@ -42,7 +50,9 @@
       min: 1,
       max: Number.MAX_SAFE_INTEGER,
       label: "\u6700\u5927\u8F93\u51FA\u5B57\u8282",
-      description: "\u9650\u5236\u5355\u4E2A cell \u7684\u8F93\u51FA\u548C\u7ED3\u679C\u6570\u636E\u603B\u5927\u5C0F\u3002"
+      labelEn: "Max output bytes",
+      description: "\u9650\u5236\u5355\u4E2A cell \u7684\u8F93\u51FA\u548C\u7ED3\u679C\u6570\u636E\u603B\u5927\u5C0F\u3002",
+      descriptionEn: "Caps the combined size of one cell output and result data."
     },
     {
       key: "maxOldGenerationSizeMb",
@@ -51,7 +61,9 @@
       min: 1,
       max: Number.MAX_SAFE_INTEGER,
       label: "worker \u65E7\u751F\u4EE3\u5185\u5B58\u4E0A\u9650 (MiB)",
-      description: "\u6BCF\u4E2A worker \u7684 V8 \u65E7\u751F\u4EE3\u4E0A\u9650\uFF1B\u6D3B\u52A8 worker \u5B58\u5728\u65F6\u4FEE\u6539\u4F1A\u88AB\u62D2\u7EDD\u3002"
+      labelEn: "Worker old-generation memory cap (MiB)",
+      description: "\u6BCF\u4E2A worker \u7684 V8 \u65E7\u751F\u4EE3\u4E0A\u9650\uFF1B\u6D3B\u52A8 worker \u5B58\u5728\u65F6\u4FEE\u6539\u4F1A\u88AB\u62D2\u7EDD\u3002",
+      descriptionEn: "Per-worker V8 old-generation limit; changes are rejected while an active worker exists."
     },
     {
       key: "maxValueNodes",
@@ -60,7 +72,9 @@
       min: 1,
       max: Number.MAX_SAFE_INTEGER,
       label: "Value Graph \u6700\u5927\u8282\u70B9\u6570",
-      description: "\u9650\u5236\u5355\u6B21\u8FD4\u56DE\u503C\u7684\u8282\u70B9\u6570\u3002"
+      labelEn: "Max Value Graph nodes",
+      description: "\u9650\u5236\u5355\u6B21\u8FD4\u56DE\u503C\u7684\u8282\u70B9\u6570\u3002",
+      descriptionEn: "Caps the node count of a single returned value."
     },
     {
       key: "maxValueEdges",
@@ -69,7 +83,9 @@
       min: 1,
       max: Number.MAX_SAFE_INTEGER,
       label: "Value Graph \u6700\u5927\u8FB9\u6570",
-      description: "\u9650\u5236\u5355\u6B21\u8FD4\u56DE\u503C\u7684\u5F15\u7528\u5173\u7CFB\u6570\u3002"
+      labelEn: "Max Value Graph edges",
+      description: "\u9650\u5236\u5355\u6B21\u8FD4\u56DE\u503C\u7684\u5F15\u7528\u5173\u7CFB\u6570\u3002",
+      descriptionEn: "Caps the reference-edge count of a single returned value."
     },
     {
       key: "maxValueArrayLength",
@@ -78,7 +94,9 @@
       min: 1,
       max: Number.MAX_SAFE_INTEGER,
       label: "\u6570\u7EC4\u6700\u5927\u58F0\u660E\u957F\u5EA6",
-      description: "\u9650\u5236\u8FD4\u56DE\u6570\u7EC4\u7684\u6700\u5927\u957F\u5EA6\u3002"
+      labelEn: "Max declared array length",
+      description: "\u9650\u5236\u8FD4\u56DE\u6570\u7EC4\u7684\u6700\u5927\u957F\u5EA6\u3002",
+      descriptionEn: "Caps the maximum length of a returned array."
     },
     {
       key: "maxValueBigIntDigits",
@@ -87,7 +105,9 @@
       min: 1,
       max: Number.MAX_SAFE_INTEGER,
       label: "BigInt \u6700\u5927\u5341\u8FDB\u5236\u4F4D\u6570",
-      description: "\u9650\u5236\u8FD4\u56DE\u503C\u4E2D BigInt \u7684\u5341\u8FDB\u5236\u4F4D\u6570\u3002"
+      labelEn: "Max BigInt decimal digits",
+      description: "\u9650\u5236\u8FD4\u56DE\u503C\u4E2D BigInt \u7684\u5341\u8FDB\u5236\u4F4D\u6570\u3002",
+      descriptionEn: "Caps the decimal digits of BigInt values in a returned value."
     },
     {
       key: "maxNestedRunCodeDepth",
@@ -96,56 +116,72 @@
       min: 1,
       max: Number.MAX_SAFE_INTEGER,
       label: "code.run \u6700\u5927\u9012\u5F52\u6DF1\u5EA6",
-      description: "\u9650\u5236 code.run \u7684\u5D4C\u5957\u5C42\u6570\u3002"
+      labelEn: "Max code.run recursion depth",
+      description: "\u9650\u5236 code.run \u7684\u5D4C\u5957\u5C42\u6570\u3002",
+      descriptionEn: "Caps how deeply code.run may nest."
     },
     {
       key: "canonicalizeToolCalls",
       type: "boolean",
       default: true,
       label: "\u89C4\u8303\u9876\u5C42 native \u8BEF\u8C03",
-      description: "\u4FEE\u6B63\u53EF\u4EE5\u660E\u786E\u8BC6\u522B\u7684\u9876\u5C42 native \u8BEF\u8C03\u3002"
+      labelEn: "Canonicalize top-level native mis-calls",
+      description: "\u4FEE\u6B63\u53EF\u4EE5\u660E\u786E\u8BC6\u522B\u7684\u9876\u5C42 native \u8BEF\u8C03\u3002",
+      descriptionEn: "Repairs top-level native mis-calls that can be identified unambiguously."
     },
     {
       key: "looseTopLevelRedeclarations",
       type: "boolean",
       default: true,
       label: "\u5BBD\u677E\u9876\u5C42\u91CD\u58F0\u660E",
-      description: "\u5141\u8BB8\u9876\u5C42 const/let \u91CD\u58F0\u660E\u5DF2\u6709\u53D8\u91CF\u3002"
+      labelEn: "Loose top-level redeclarations",
+      description: "\u5141\u8BB8\u9876\u5C42 const/let \u91CD\u58F0\u660E\u5DF2\u6709\u53D8\u91CF\u3002",
+      descriptionEn: "Allows top-level const/let to redeclare existing variables."
     },
     {
       key: "durableReplay",
       type: "boolean",
       default: true,
       label: "\u6301\u4E45\u91CD\u653E",
-      description: "worker \u91CD\u542F\u540E\u6062\u590D\u53EF\u4EE5\u91CD\u5EFA\u7684 REPL \u72B6\u6001\u3002"
+      labelEn: "Durable replay",
+      description: "worker \u91CD\u542F\u540E\u6062\u590D\u53EF\u4EE5\u91CD\u5EFA\u7684 REPL \u72B6\u6001\u3002",
+      descriptionEn: "Rebuilds recoverable REPL state after a worker restart."
     },
     {
       key: "autoRewriteImports",
       type: "boolean",
       default: true,
       label: "\u81EA\u52A8\u6539\u5199 import",
-      description: "\u5141\u8BB8\u5728 run_code \u4E2D\u4F7F\u7528\u9759\u6001 import\u3002"
+      labelEn: "Auto-rewrite import",
+      description: "\u5141\u8BB8\u5728 run_code \u4E2D\u4F7F\u7528\u9759\u6001 import\u3002",
+      descriptionEn: "Allows static import declarations inside run_code."
     },
     {
       key: "autoStripExports",
       type: "boolean",
       default: true,
       label: "\u81EA\u52A8\u5265\u79BB export",
-      description: "\u5141\u8BB8\u5728 run_code \u4E2D\u4F7F\u7528\u9876\u5C42 export\u3002"
+      labelEn: "Auto-strip export",
+      description: "\u5141\u8BB8\u5728 run_code \u4E2D\u4F7F\u7528\u9876\u5C42 export\u3002",
+      descriptionEn: "Allows top-level export modifiers inside run_code."
     },
     {
       key: "autoSplitRedeclarations",
       type: "boolean",
       default: true,
       label: "\u81EA\u52A8\u62C6\u5206\u6DF7\u5408\u91CD\u58F0\u660E",
-      description: "\u5141\u8BB8\u9876\u5C42\u89E3\u6784\u58F0\u660E\u540C\u65F6\u5305\u542B\u65B0\u65E7\u53D8\u91CF\u3002"
+      labelEn: "Auto-split mixed redeclarations",
+      description: "\u5141\u8BB8\u9876\u5C42\u89E3\u6784\u58F0\u660E\u540C\u65F6\u5305\u542B\u65B0\u65E7\u53D8\u91CF\u3002",
+      descriptionEn: "Allows top-level destructuring declarations that mix new and existing variables."
     },
     {
       key: "tipsEnabled",
       type: "boolean",
       default: true,
       label: "\u542F\u7528\u6062\u590D\u63D0\u793A",
-      description: "\u5728\u7B26\u5408\u6761\u4EF6\u7684\u5931\u8D25\u540E\u663E\u793A\u6062\u590D\u63D0\u793A\u3002"
+      labelEn: "Enable recovery tips",
+      description: "\u5728\u7B26\u5408\u6761\u4EF6\u7684\u5931\u8D25\u540E\u663E\u793A\u6062\u590D\u63D0\u793A\u3002",
+      descriptionEn: "Shows recovery tips after qualifying failures."
     },
     {
       key: "tipCooldownMessages",
@@ -154,7 +190,9 @@
       min: 1,
       max: Number.MAX_SAFE_INTEGER,
       label: "\u6062\u590D\u63D0\u793A\u51B7\u5374\u6B65\u6570",
-      description: "\u540C\u7C7B\u6062\u590D\u63D0\u793A\u4E4B\u95F4\u7684\u6700\u5C0F\u95F4\u9694\u3002"
+      labelEn: "Recovery tip cooldown (messages)",
+      description: "\u540C\u7C7B\u6062\u590D\u63D0\u793A\u4E4B\u95F4\u7684\u6700\u5C0F\u95F4\u9694\u3002",
+      descriptionEn: "The minimum gap between recovery tips of the same kind."
     },
     {
       key: "tipEscalationFailures",
@@ -163,7 +201,9 @@
       min: 1,
       max: Number.MAX_SAFE_INTEGER,
       label: "\u6062\u590D\u63D0\u793A\u5347\u7EA7\u5931\u8D25\u6B21\u6570",
-      description: "\u8FDE\u7EED\u5931\u8D25\u8FBE\u5230\u6B64\u6B21\u6570\u540E\u663E\u793A\u66F4\u8BE6\u7EC6\u7684\u6062\u590D\u63D0\u793A\u3002"
+      labelEn: "Recovery tip escalation failures",
+      description: "\u8FDE\u7EED\u5931\u8D25\u8FBE\u5230\u6B64\u6B21\u6570\u540E\u663E\u793A\u66F4\u8BE6\u7EC6\u7684\u6062\u590D\u63D0\u793A\u3002",
+      descriptionEn: "After this many consecutive failures, a more detailed recovery tip is shown."
     }
   ]);
   var CONFIG_DEFAULTS = Object.freeze(
@@ -183,6 +223,55 @@
 @media(max-width:560px){.ptcPlusHeader{padding:12px}.ptcPlusFields{margin:0 12px}.ptcPlusRow{align-items:flex-start;flex-direction:column;gap:6px;padding:10px 0}.ptcPlusInput{width:100%}.ptcPlusFooter{align-items:stretch;flex-direction:column}.ptcPlusButton{width:100%}}
 @media(prefers-reduced-motion:reduce){.ptcPlusHeader,.ptcPlusChevron,.ptcPlusBody,.ptcPlusButton{transition:none}}
 `;
+  var LOCALE_NS = "settings.ptcPlus";
+  var CHROME_COPY = Object.freeze({
+    zh: Object.freeze({
+      "card.description": "PTC \u6A21\u5F0F\u7684\u4F1A\u8BDD\u7EA7 TypeScript REPL\u3002",
+      "status.enabled": "\u5DF2\u542F\u7528",
+      "status.disabled": "\u5DF2\u505C\u7528",
+      "action.expand": "\u5C55\u5F00 PTC Plus \u8BBE\u7F6E",
+      "action.collapse": "\u6536\u8D77 PTC Plus \u8BBE\u7F6E",
+      "state.syncing": "\u6B63\u5728\u540C\u6B65\u8BBE\u7F6E...",
+      "state.unavailable": "\u5F53\u524D DSH \u5B9E\u4F8B\u672A\u63D0\u4F9B\u8BBE\u7F6E\u670D\u52A1",
+      "footer.live": "\u8BBE\u7F6E\u4F1A\u5728\u4FEE\u6539\u540E\u7ACB\u5373\u751F\u6548",
+      "footer.readOnly": "\u5F53\u524D\u8BBE\u7F6E\u4E3A\u53EA\u8BFB",
+      "status.applied": "\u8BBE\u7F6E\u5DF2\u7ACB\u5373\u751F\u6548",
+      "status.conflict": "\u8BBE\u7F6E\u672A\u751F\u6548\uFF0C\u8BF7\u68C0\u67E5\u8BBE\u7F6E\u51B2\u7A81",
+      "status.failed": "\u8BBE\u7F6E\u5931\u8D25\uFF1A{error}",
+      "indicator.title": "PTC Plus \u5DF2\u542F\u7528"
+    }),
+    en: Object.freeze({
+      "card.description": "The session-bound TypeScript REPL for PTC mode.",
+      "status.enabled": "Enabled",
+      "status.disabled": "Disabled",
+      "action.expand": "Expand PTC Plus settings",
+      "action.collapse": "Collapse PTC Plus settings",
+      "state.syncing": "Syncing settings...",
+      "state.unavailable": "This DSH instance does not provide a settings service",
+      "footer.live": "Changes take effect immediately.",
+      "footer.readOnly": "These settings are read-only.",
+      "status.applied": "Setting applied immediately.",
+      "status.conflict": "The setting did not take effect; check for conflicting settings.",
+      "status.failed": "Could not save: {error}",
+      "indicator.title": "PTC Plus is active"
+    })
+  });
+  function fieldCopy(field, locale) {
+    const copy = { [`${field.key}.label`]: locale === "en" ? field.labelEn : field.label };
+    const description = locale === "en" ? field.descriptionEn : field.description;
+    if (description !== "") copy[`${field.key}.description`] = description;
+    return copy;
+  }
+  var SETTINGS_COPY = Object.freeze(Object.fromEntries(
+    ["zh", "en"].map((locale) => [locale, Object.freeze({
+      ...CHROME_COPY[locale],
+      ...Object.assign({}, ...CONFIG_FIELDS.map((field) => fieldCopy(field, locale)))
+    })])
+  ));
+  function sessionUsesPtcPreset(session) {
+    const preset = session?.projectionValues?.agentPreset ?? session?.agentPreset;
+    return preset === "ptc" || preset === "code";
+  }
   window.__ModuleLoader__.load({
     // Replaced by the bundle entry with the package name from package.json.
     id: "dsh-ptc-plus",
@@ -190,8 +279,7 @@
       const React = require2("react");
       const {
         IconCheckOutline14,
-        IconChevronDownOutline14,
-        IconSettingsOutline16
+        IconChevronDownOutline14
       } = require2("@deepseek-ai/dsh-client-ui-primitives");
       const module = { exports: {} };
       const h = React.createElement;
@@ -204,7 +292,7 @@
         document.head.append(style);
         return () => style.remove();
       }
-      function fieldInput(field, value, disabled, onChange) {
+      function fieldInput(field, value, disabled, onChange, label) {
         if (field.type === "boolean") {
           return h("input", {
             type: "checkbox",
@@ -212,7 +300,7 @@
             className: "ptcPlusCheck",
             checked: value === true,
             disabled,
-            "aria-label": field.label,
+            "aria-label": label,
             onChange: (event) => onChange(field, event.target.checked)
           });
         }
@@ -224,7 +312,7 @@
           max: field.max,
           step: 1,
           disabled,
-          "aria-label": field.label,
+          "aria-label": label,
           onChange: (event) => {
             const input = event.target.value;
             const parsed = input === "" ? "" : Number(input);
@@ -234,10 +322,11 @@
       }
       function apply(ctx) {
         const preferenceScope = ctx.settingsScope.bind({ namespace: SETTINGS_NAMESPACE });
+        ctx.effect(() => ctx.locale.register(LOCALE_NS, SETTINGS_COPY), "ptc-plus: settings dictionaries");
         ctx.effect(installStyles, "ptc-plus: client styles");
-        function PTCPlusSettingsCard() {
+        function PTCPlusSettingsCard({ t }) {
           const [open, setOpen] = React.useState(false);
-          const [status, setStatus] = React.useState("");
+          const [status, setStatus] = React.useState(null);
           const [pending, setPending] = React.useState(() => /* @__PURE__ */ new Set());
           const writeTail = React.useRef(Promise.resolve());
           const subscribe = React.useCallback((listener) => preferenceScope.subscribe(listener), []);
@@ -254,17 +343,20 @@
               if (field.key !== "enabled" && before.value?.enabled !== true) return;
               if (before.value?.[field.key] === nextValue) return;
               setPending((current) => new Set(current).add(field.key));
-              setStatus("");
+              setStatus(null);
               try {
                 await preferenceScope.set(field.key, nextValue);
                 const after = preferenceScope.getSnapshot();
                 if (after.status !== "ready" || after.value?.[field.key] !== nextValue) {
-                  setStatus("\u8BBE\u7F6E\u672A\u751F\u6548\uFF0C\u8BF7\u68C0\u67E5\u8BBE\u7F6E\u51B2\u7A81");
+                  setStatus({ key: "status.conflict" });
                 } else {
-                  setStatus("\u8BBE\u7F6E\u5DF2\u7ACB\u5373\u751F\u6548");
+                  setStatus({ key: "status.applied" });
                 }
               } catch (error) {
-                setStatus("\u8BBE\u7F6E\u5931\u8D25\uFF1A" + (error instanceof Error ? error.message : String(error)));
+                setStatus({
+                  key: "status.failed",
+                  params: { error: error instanceof Error ? error.message : String(error) }
+                });
               } finally {
                 setPending((current) => {
                   const next = new Set(current);
@@ -286,18 +378,17 @@
                 type: "button",
                 className: "ptcPlusHeader",
                 "aria-expanded": open,
-                "aria-label": open ? "\u6536\u8D77 PTC Plus \u8BBE\u7F6E" : "\u5C55\u5F00 PTC Plus \u8BBE\u7F6E",
+                "aria-label": t(open ? "action.collapse" : "action.expand"),
                 "aria-controls": "ptc-plus-settings-body",
                 onClick: () => setOpen((current) => !current)
               },
-              h(IconSettingsOutline16, { size: 16 }),
               h(
                 "span",
                 { className: "ptcPlusHeadText" },
                 h("span", { className: "ptcPlusName" }, "PTC Plus"),
-                h("span", { className: "ptcPlusDescription" }, "PTC \u6A21\u5F0F\u7684\u4F1A\u8BDD\u7EA7 TypeScript REPL\u3002")
+                h("span", { className: "ptcPlusDescription" }, t("card.description"))
               ),
-              h("span", { className: "ptcPlusStatus", "data-enabled": enabled }, enabled ? "\u5DF2\u542F\u7528" : "\u5DF2\u505C\u7528"),
+              h("span", { className: "ptcPlusStatus", "data-enabled": enabled }, t(enabled ? "status.enabled" : "status.disabled")),
               h("span", { className: "ptcPlusChevron", "data-open": open, "aria-hidden": true }, h(IconChevronDownOutline14, { size: 14 }))
             ),
             h(
@@ -306,22 +397,22 @@
               h("div", { className: "ptcPlusBodyInner" }, h(
                 "div",
                 { className: "ptcPlusFields" },
-                snapshot.status === "loading" ? h("p", { className: "ptcPlusMessage" }, "\u6B63\u5728\u540C\u6B65\u8BBE\u7F6E...") : snapshot.status === "unavailable" ? h("p", { className: "ptcPlusMessage" }, "\u5F53\u524D DSH \u5B9E\u4F8B\u672A\u63D0\u4F9B\u8BBE\u7F6E\u670D\u52A1") : [
+                snapshot.status === "loading" ? h("p", { className: "ptcPlusMessage" }, t("state.syncing")) : snapshot.status === "unavailable" ? h("p", { className: "ptcPlusMessage" }, t("state.unavailable")) : [
                   ...CONFIG_FIELDS.map((field) => h(
                     "div",
                     { key: field.key, className: "ptcPlusRow" },
                     h(
                       "div",
                       { className: "ptcPlusMain" },
-                      h("div", { className: "ptcPlusLabel" }, field.label),
-                      field.description === "" ? null : h("div", { className: "ptcPlusDetail" }, field.description)
+                      h("div", { className: "ptcPlusLabel" }, t(`${field.key}.label`)),
+                      field.description === "" ? null : h("div", { className: "ptcPlusDetail" }, t(`${field.key}.description`))
                     ),
-                    fieldInput(field, value[field.key], fieldDisabled(field), persist)
+                    fieldInput(field, value[field.key], fieldDisabled(field), persist, t(`${field.key}.label`))
                   )),
                   h(
                     "div",
                     { key: "footer", className: "ptcPlusFooter" },
-                    h("span", { className: "ptcPlusMessage", role: "status" }, status || (snapshot.writable ? "\u8BBE\u7F6E\u4F1A\u5728\u4FEE\u6539\u540E\u7ACB\u5373\u751F\u6548" : "\u5F53\u524D\u8BBE\u7F6E\u4E3A\u53EA\u8BFB"))
+                    h("span", { className: "ptcPlusMessage", role: "status" }, status === null ? t(snapshot.writable ? "footer.live" : "footer.readOnly") : t(status.key, status.params))
                   )
                 ]
               ))
@@ -330,10 +421,11 @@
         }
         ctx.slots.inject("settings.plugin.item", () => ctx.slots.register({
           name: "settings.plugin.item",
-          key: SETTINGS_NAMESPACE
+          key: SETTINGS_NAMESPACE,
+          locale: LOCALE_NS
         }, PTCPlusSettingsCard));
         ctx.inject(["slots", "sessions"], (scope) => {
-          function PTCPlusSessionIndicator({ sessionId }) {
+          function PTCPlusSessionIndicator({ sessionId, t }) {
             const sessions = React.useSyncExternalStore(
               (listener) => scope.sessions.list.subscribe(listener),
               () => scope.sessions.list.getSnapshot(),
@@ -344,10 +436,10 @@
               () => preferenceScope.getSnapshot(),
               () => preferenceScope.getSnapshot()
             );
-            if (sessions.byId?.[sessionId]?.agentPreset !== "code" || settings.status !== "ready" || settings.value?.enabled !== true) return null;
+            if (!sessionUsesPtcPreset(sessions.byId?.[sessionId]) || settings.status !== "ready" || settings.value?.enabled !== true) return null;
             return h(
               "span",
-              { className: "ptcPlusActive", title: "PTC Plus \u5DF2\u542F\u7528" },
+              { className: "ptcPlusActive", title: t("indicator.title") },
               h(IconCheckOutline14, { size: 14 }),
               "PTC Plus"
             );
@@ -355,11 +447,12 @@
           scope.slots.inject("conversation.session.header.actions", () => scope.slots.register({
             name: "conversation.session.header.actions",
             id: "ptc-plus-active",
-            order: -9
+            order: -9,
+            locale: LOCALE_NS
           }, PTCPlusSessionIndicator));
         });
       }
-      module.exports = { apply, inject: ["settingsScope", "slots", "sessions"] };
+      module.exports = { apply, inject: ["settingsScope", "slots", "sessions", "locale"] };
       return module.exports;
     }
   });