docs: translate remaining READMEs

packages/util/paths/README.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# side as of the last confirmed-consistent state. Both languages carry equal authority;
+# after editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write
+README.md: b28e684f3183d739c8e229a9b341801dbf345d86
+README.zh.md: 20cc033e4d0ee22d75c7ca315c462a7846146444

packages/util/paths/README.md

@@ -1,5 +1,7 @@
 # dsh-paths
 
+English | [中文](README.zh.md)
+
 Shared filesystem path helpers for DeepSeek Harness user data.
 
 ## DSH home

packages/util/paths/README.zh.md

@@ -0,0 +1,24 @@
+# dsh-paths
+
+[English](README.md) | 中文
+
+DeepSeek Harness 用户数据的共享文件系统路径辅助工具。
+
+## DSH 主目录
+
+`resolveDshHome()` 解析 DeepSeek Harness 的单根主目录。优先级从高到低为：显式配置的路径、`$DSH_HOME`、`~/.dsh`。harness 将所有用户数据保存在同一根目录下。
+
+`dshHomeDisplay()` 以符号方式表示当前根目录，用于面向用户的路径：默认主目录表示为 `~/.dsh`，任何已配置的主目录表示为 `$DSH_HOME`。它绝不会泄露机器的绝对路径。
+
+`DSH_HOME_DIR_NAME` 定义默认用户数据目录名：`.dsh`。
+
+`defaultDshHome()` 使用 Node 的平台路径规则，将操作系统主目录与 `.dsh` 拼接，并返回默认 DeepSeek Harness 主目录。
+
+`expandHomePath()` 使用操作系统主目录展开 `~`、`~/...` 和 Windows 风格的 `~\...` 前缀。它会保留非波浪号路径和 `~user/...` 原样不变。
+
+该包刻意保持规模小且不依赖 harness，以便产品包共享用户数据路径约定，而不必彼此依赖。
+
+## 已知限制与待完成工作
+
+- **展开范围刻意保持狭窄**：只有单独的 `~`、`~/...` 和 `~\...` 使用当前操作系统主目录；`~alice/...` 等指定用户的形式、环境变量和 shell 表达式保持不变。
+- **辅助工具不会操作文件系统**：调用方仍负责目录创建、存在性检查、权限，以及对结果路径应用信任策略。