@dsh-external/dsh-l10n-hardpatch

Readme

# dsh-l10n-hardpatch

DeepSeek Harness (dsh) 硬编码中文化补丁插件 —— 导入即汉化，dsh 更新后自动重打。

## 解决的问题

dsh 的部分 UI 字符串（命令菜单描述、权限预设描述、plan 审查按钮、轨迹视图标签等）是**包内硬编码英文**，官方没有提供 i18n 覆盖点，只能直接修改包文件。手动打补丁在 dsh 升级后会丢失。

本插件在加载时（apply）自动扫描所有实际生效的包副本，把已知英文硬编码**幂等替换**为中文：

- ✅ **导入即汉化**：安装后重启 DSH Web 生效
- ✅ **自动重打**：dsh 升级导致英文回归时，重启自动重新汉化
- ✅ **覆盖全面**：同时扫描全局 npm 依赖树、`~/.dsh/profiles` 各级 node_modules（含 pnpm store 布局），保证命中实际加载的文件
- ✅ **安全**：行级精确替换（不误伤代码逻辑），替换后语法校验通过；任何异常只告警、绝不阻断插件加载

## 汉化范围

| 包 | 内容 |
|----|------|
| `dsh-command-compact` | 压缩对话命令描述 |
| `dsh-command-feedback` | 反馈命令描述 |
| `dsh-command-goal` | 目标命令描述 |
| `dsh-session-log-export` | 导出会话命令描述 |
| `dsh-permission-presets` | 权限预设描述 |
| `dsh-plan-mode` | 计划审查按钮（批准 / 继续规划等） |
| `dsh-client-ui-trajectory` | 轨迹视图全部 UI 标签（约 100 处） |

> 注：advisor 预设与 client-connection 的中文为官方 rc.7 自带，无需补丁。

## 安装

本插件是**本地目录型 bundle 插件**，需要先下载到本地，再让 dsh 引用该目录：

**1. 下载插件**（任选）：

```bash
# 方式 A：git 克隆
 git clone https://github.com/lingyingaojue/dsh-l10n-hardpatch

# 方式 B：GitHub 页面 Code → Download ZIP，解压到任意目录
```

**2. 安装到 dsh**（把 `<路径>` 换成你下载/解压的目录）：

```bash
dsh plugin --profile web add <路径>\dsh-l10n-hardpatch
```

**3. 重启 DSH Web**（或 Web UI 设置 → 插件 → 添加本地插件 → 选择目录），汉化即生效。

### 已知坑

`dsh plugin add` 可能因 pnpm 的 `ERR_PNPM_IGNORED_BUILDS`（如 `@jackwener/opencli`、`node-pty`）以退出码 1 中断：此时依赖已安装但 `package.json` 的 `dsh.profile.bundles` **未更新**，插件不会被加载。解决方法：手动把包名加入 `dsh.profile.bundles` 数组后重启。

## 原理

插件通过 dsh 的 bundle patch 机制注册（`cordis.patch.yml` → `insert`）。加载时读取 `patches.json`（144 组「原版英文行 → 中文行」精确替换对），对所有候选副本文件执行**整行匹配替换**：

- 文件已含中文目标行 → 跳过（幂等）
- 文件含英文原行 → 替换为中文行
- 无匹配 → 保持不动

`patches.json` 由 `extract_lines.py` 从「npm 原版包 vs 已汉化文件」的逐行 diff 自动生成，可随时重新生成以适配新版本。

## 更新维护

dsh 升级后若替换对失效（英文串变化），重新生成替换对：

```bash
# 1. 下载对应版本原版包
npm pack @deepseek-ai/dsh-client-ui-trajectory@<version>
# 2. 运行提取脚本（需配置路径）
python extract_lines.py
# 3. 替换 patches.json 后重启 DSH Web
```

## License

MIT