韩语外壳补丁 Petenka315/dsh-shell-ko

dsh-shell-ko

DSH 桌面外壳（Electron）的韩语补丁。填补网页 UI 语言包覆盖不到的区域。

- 顶部菜单 Application / Edit
- 右键菜单 Undo / Redo / Cut / Copy / Paste / Select All / Delete
- 退出确认、更新、启动/登录窗口、托盘菜单、dsh 命令管理对话框

为什么语言包做不到

这些字符串不是网页应用绘制的，而是由 Electron 外壳进程绘制。

| 位置 | 作用 |
| lib/preload-app.cjs | 用 DOM 创建标题栏的 Application/Edit 按钮，读取 决定标签文字 |
| lib/main.js | 点击按钮时通过 IPC（dsh-desktop:windows-menu）弹出原生菜单，并决定托盘、对话框、更新器的文案 |

两个文件自带的文案表只有英语（en）和中文（zh）。

function resolveDesktopLocale(locale) {
return locale.toLowerCase().startsWith("zh") ? { id: "zh-CN", messages: zh } : { id: "en", messages: en };
}

文案表共 165 条字符串，两个文件各自复制了一份相同内容。加一个 ko 字典和一行分支就够了，但这些文件在 app.asar 里，插件加载器碰不到。

安装（新电脑 · 重装）

git clone https://github.com/Petenka315/dsh-shell-ko.git
cd dsh-shell-ko
powershell -ExecutionPolicy Bypass -File .\setup.ps1

setup.ps1 会创建桌面和启动项快捷方式，并引导后续步骤。
需要 Node.js 18+（补丁工具用到 fs.statfsSync、Atomics.wait）。

然后双击桌面上的 DSH 한국어 패치。应用开着时会等它退出，再应用补丁并重新启动。

应用补丁

补丁要替换 app.asar，所以只能在 DSH 关闭的那一刻应用。为此预先挂了一个「关闭后自动应用」的等待进程。

手动重新应用时： 双击桌面上的 DSH 한국어 패치 快捷方式。应用开着就等它退出，再应用补丁并重新启动。

在命令行做同样的事
cd dsh-shell-ko
node tools/patch-shell.cjs status # 当前状态
node tools/patch-shell.cjs apply --wait 600 --relaunch # 等待后应用 + 重新启动
node tools/patch-shell.cjs revert # 还原为原版（应用退出后）

版本升级后自动重新应用

DSH 更新会整个替换 app.asar，补丁随之消失。为此准备了两条路。

1. 登录时自动 —— 启动项里注册了 DSH 한국어 패치 자동 快捷方式。
登录时以隐藏窗口运行 apply --wait 120（已打过补丁就立即退出）。
不想用的话，只删掉这个快捷方式即可。
2. 手动 —— 双击桌面上的 DSH 한국어 패치。

apply 是幂等的。已经打过补丁就什么都不做，直接结束。备份按构建版本管理：更新后把旧构建的备份挪到 .ko-backup.prev，再备份新构建的原版。这样 revert 不会退回旧版本把应用搞坏。

语言联动

打完补丁后，外壳跟随网页 UI 的 。DSH 语言设为 한국어 时菜单也是韩语，切回英语菜单也回到英语。无需额外设置。

改了什么

- 在两个文件的文案表后面加 const ko = { ...165개... };
- 在 resolveDesktopLocale 里加 ko 分支
- （main.js）修改 resolveDesktopStartupLocale，让它识别保存的语言设置 ko 和系统语言 ko-KR

除这两个文件外，asar 里任何条目都不变。应用前会对全部条目做哈希比对。

验证

node tools/extract-shell.cjs # 从应用 asar 中提取原版
node tools/test-patch.cjs .cache/shell/main.js .cache/shell/preload-app.cjs
node tools/patch-shell.cjs build --out .cache/app-ko.asar # 整体重新打包比对

最近的结果：

entries : 18188 -> 18188
compared : 16605 packed entries
differences : 2
lib/main.js (516716 -> 529087)
lib/preload-app.cjs (41075 -> 53356)

风险与限制

- 应用更新会替换 app.asar → 需要重新应用（见上面的自动/手动路径）。
- 备份约 182MB（app.asar.ko-backup）。
- 补丁出错时，应用可能无法启动。这时退出应用，执行 revert（或把备份文件复制为 app.asar）即可。
- 这种改法修改的是已签名的包，macOS 上签名会失效。本补丁以 Windows 路径为准。
- 界面文案每个版本都可能增加。届时 test-patch 的「every shell string translated」会失败，往 shell-ko.json 里补上即可。

文件

setup.ps1 安装/卸载快捷方式（-Uninstall） shell-ko.json 165 条界面文案的韩语翻译 한국어 패치 적용.cmd 桌面快捷方式目标（等待后应用并重启） 패치 상태.cmd / 패치 되돌리기.cmd tools/patch-shell.cjs status / build / apply / revert tools/patch-source.cjs 修改 main/preload 源码 tools/asar-write.cjs 重新打包 asar（只替换变更的条目，重新计算哈希） tools/test-patch.cjs 检查目录、占位符、路由、语法 tools/extract-shell.cjs 从应用 asar 中提取用于检查的原始文件 tools/apply-if-needed.cmd 登录/等待用的包装脚本（写日志） tools/apply-if-needed.vbs 登录时静默运行

许可证

MIT。Electron 界面代码不包含在本仓库中（从已安装应用的 app.asar 读取并修改）。