Coder/deepseek-harness
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(i18n): standardize contract terminology

Browse Source
This commit is contained in:
xjt
2026-08-09 11:33:14 +08:00
parent 5d46c11784
commit a7af54a8d3
848 changed files with 1506 additions and 1506 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
packages/util/README.i18n.yaml
View File

@@ -3,4 +3,4 @@
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write packages/util/README.md
README.md: b84f2cbb88981aa2edbde65d8a711b28cc5b48e9
README.zh.md: b1d7ccf14059892d57fb01502f177e0e618058b1
README.zh.md: 3814dffe1eb8c68f6d38d39aa750c80ce325f9af

2
packages/util/README.zh.md
View File

@@ -7,7 +7,7 @@
| 包 | 职责 |
|---|---|
| [`brand/`](brand/README.md) | 提供带名义品牌的类型 |
| [`paths/`](paths/README.md) | 解析 harness（智能体框架）数据根目录和共享路径 |
| [`paths/`](paths/README.md) | 解析 Harness 数据根目录和共享路径 |
| [`timeout/`](timeout/README.md) | 提供截止时间和超时分类原语 |
| [`retention/`](retention/README.md) | 限制保留文本和项集合的大小 |
| [`atomic-write/`](atomic-write/README.md) | 以原子方式替换文件 |

2
packages/util/atomic-write/README.i18n.yaml
View File

@@ -3,4 +3,4 @@
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write packages/util/atomic-write/README.md
README.md: 2ff4abb6ac10d8b592ccd2056b4f1f92cc8518b0
README.zh.md: 4284d06422564268bb9e31d1a1ed06ab5271e562
README.zh.md: 570a5243aefbe6870c1991786f711adc77faacae

2
packages/util/atomic-write/README.zh.md
View File

@@ -20,7 +20,7 @@ await withFileLock('/home/u/.dsh/settings.yaml', async () => {
})
```
`writeFileAtomic` 提交一份已经渲染好的字符串。契约按故障利用它的先后顺序列出：
`writeFileAtomic` 提交一份已经渲染好的字符串。约定按故障利用它的先后顺序列出：
- **独占创建临时文件**（`wx` + 随机后缀）：open 拒绝跟随预先埋在可猜测临时路径上的符号链接。
- **全新 inode 携带 `mode` 走完 rename**：替换权限过宽的旧文件时直接收窄，不存在 chmod 竞态。`mode` 为必填，让权限决策始终可见于每个调用点（与所有新建 inode 一样受进程 umask 影响）。

2
packages/util/environment/README.i18n.yaml
View File

@@ -3,4 +3,4 @@
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write packages/util/environment/README.md
README.md: 599a9ba747905b66452b57717dabcc6f4678a3dd
README.zh.md: 69f9c670bbb3ea1b2fbddaa7508a19dfb47fad12
README.zh.md: ca1da309fda28913ee7b90953d50fc0a7172ca87

2
packages/util/environment/README.zh.md
View File

@@ -32,5 +32,5 @@ const endpoint = environmentOf(ctx).get('DEEPSEEK_BASE_URL')?.value
## Known Limitations and Deferred Work
- **快照不是子进程边界**：每一层同样会被物化进 `process.env`，因此项目里的普通变量会按 [`dsh-subprocess`](../../subprocess/subprocess/README.md) 的清洗规则抵达子进程。产品启动器的 [`.env` 契约](../../boot/app-boot/README.md#profiles) 会在物化之前拒绝 bootstrap 变量。
- **快照不是子进程边界**：每一层同样会被物化进 `process.env`，因此项目里的普通变量会按 [`dsh-subprocess`](../../subprocess/subprocess/README.md) 的清洗规则抵达子进程。产品启动器的 [`.env` 约定](../../boot/app-boot/README.md#profiles) 会在物化之前拒绝 bootstrap 变量。
- **没有按工作区划分的层**：项目层是*调用*目录，在启动时固定。之后在 Web UI 中选择的工作区不贡献任何内容，这是刻意的：跟随它等于让模型自己的工作区在会话中途改变 harness 的环境。

2
packages/util/native-command/README.i18n.yaml
View File

@@ -3,4 +3,4 @@
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write packages/util/native-command/README.md
README.md: dd9d1ddaf817b2ff77ec0cd01710053e918b4296
README.zh.md: 339db7f3adb402193ef14247413b02f80b6f728d
README.zh.md: 3ff8a392f2c511295adb0bf5f62b6e0527cbaea6

2
packages/util/native-command/README.zh.md
View File

@@ -8,7 +8,7 @@
它是**库，不是服务或插件**：没有 `ctx`、不注册任何东西、不持有状态、不发事件。
## Surface
## 接口面
```ts
import { runNativeCommand, type NativeCommandRunner } from '@deepseek-ai/dsh-native-command'