docs(i18n): include complete proofreading corpus

This commit is contained in:
xjt
2026-08-12 12:30:19 +08:00
parent 7b450d121e
commit 4806d94715
884 changed files with 2546 additions and 2547 deletions

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/context/README.md
README.md: 843f19b04c8dd63924a20d3ed01a5b179a731484
README.zh.md: ac3233fa8d6ffee8f80cf485eaa87289260dc0f5
README.zh.md: e4f5153d1b101773871df835ec6bc0d748d83406

View File

@@ -2,7 +2,7 @@
[English](README.md) | 中文
在不定义工具的情况下添加面向模型请求上下文的产品插件。`workspace-context` 包含在默认 `dsh-agent-spine-demo` 组合包中,可通过组合包配置禁用;`time-context``tmux-context``session-reference` 需主动启用。
在不定义工具的情况下添加模型可见的请求上下文的产品插件。`workspace-context` 包含在默认 `dsh-agent-spine-demo` 组合包中,可通过组合包配置禁用;`time-context``tmux-context``session-reference` 需主动启用。
| 包 | 职责 | ctx key |
|---|---|---|
@@ -11,4 +11,4 @@
| [`tmux-context/`](tmux-context/README.md) | tmux 位置上下文 | — |
| [`workspace-context/`](workspace-context/README.md) | 工作区指令上下文 | — |
会话引用见 [docs/subsystems/session-reference.md](../../docs/subsystems/session-reference.md)[`workspace-context` 决策记录](../../.agents/notes/implemented/feature/2026-06-24-workspace-context.md)拥有其按 agent智能体/会话隔离与生命周期拆分。
会话引用见 [docs/subsystems/session-reference.md](../../docs/subsystems/session-reference.md)[`workspace-context` 决策记录](../../.agents/notes/implemented/feature/2026-06-24-workspace-context.md)规定了其按 agent智能体/会话隔离与生命周期拆分。

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/context/tmux-context/README.md
README.md: 59c452be53b8bb7cb7244a9bb2017749750ce4bf
README.zh.md: f343c9b25c832cafcb3366209bc2ce39308ad0d5
README.zh.md: 792000403f7757b8d5e35eb6fb6f543ad044b1eb

View File

@@ -17,7 +17,7 @@
## 如何读取 tmux
插件前置注册一个 `agent/pre-step` 监听器,仅在每轮的第一个 step 运行。当需要注入时,它通过 `ctx.bash` 执行器服务运行一条只读命令:
插件前置注册一个 `agent/pre-step` 监听器,仅在每轮的第一个步骤运行。当需要注入时,它通过 `ctx.bash` 执行器服务运行一条只读命令:
```sh
[ -n "$TMUX_PANE" ] || exit 1
@@ -33,7 +33,7 @@ exec tmux display-message -t "$TMUX_PANE" -p '<format>'
## 时序语义
该插件会前置一个 `agent/pre-step` 监听器。需要注入且下游决策进入拟议步骤时,它会向返回的批次前置添加一条带来源的 `UserMessage`。AgentLoop 会在 `step/start` 之后记录该上下文,其来源为 `{ kind: 'plugin', plugin: 'tmux-context' }`。变化抑制与间隔调度会扫描原始持久会话事件中该来源的最近一次注入,因此调度可跨压缩与恢复的进程存续,无需进程内缓存状态;各会话独立调度。下游 pre-step 监听器拒绝或失败时,该读数不会被记录。
该插件会前置一个 `agent/pre-step` 监听器。需要注入且下游决策进入拟议步骤时,它会向返回的批次前置添加一条带来源的 `UserMessage`。AgentLoop 会在 `step/start` 之后记录该上下文,其来源为 `{ kind: 'plugin', plugin: 'tmux-context' }`。变化抑制与间隔调度会扫描原始持久会话事件中该来源的最近一次注入,因此调度可跨压缩compaction与恢复的进程存续,无需进程内缓存状态;各会话独立调度。下游在步骤前运行的监听器拒绝或失败时,该读数不会被记录。
## 模型体验
@@ -57,12 +57,12 @@ window active=<0|1>, pane active=<0|1>, layout <window-layout>
#### KV Cache 影响
追加;新增可见内容位于可复用的请求前缀之后,不会使已有 KV Cache 条目失效。
追加;新增可见内容位于可复用的请求前缀之后,不会使已有 KV Cache 条目失效。
## 已知限制与后续工作
- **仅第一个 step**——轮次中途移动或缩放的 pane 会在下一轮反映,而非在 step 之间。
- **仅第一个步骤**——轮次中途移动或缩放的 pane 会在下一轮反映,而非在步骤之间。
- **仅自身位置**——插件从不采集相邻 pane 的可见文本。
- **只有布局,没有尺寸**——省略 pane/window 像素尺寸;仅报告布局树与活动标志。
- **制表符分隔字段**——若 tmux window 名称包含字面两字符序列 `\t`,会使读数分割错误并作为非法读数跳过;常规名称不受影响。
- **基于 tty 的 pane 判定**——只有当进程的控制终端与 `$TMUX_PANE``#{pane_tty}` 一致时,才视为位于 tmux 中。这会有意排除从 tmux 祖先进程继承 `$TMUX``$TMUX_PANE` 的终端(如 VS Code 集成终端)。`ps -o tty=` 属于 POSIX在其或 `#{pane_tty}` 不可用的环境中,该检查即为空操作。
- **基于 tty 的 pane 判定**——只有当进程的控制终端与 `$TMUX_PANE``#{pane_tty}` 一致时,才视为位于 tmux 中。这会有意排除从 tmux 祖先进程继承 `$TMUX``$TMUX_PANE` 的终端(如 VS Code 集成终端)。`ps -o tty=` 属于 POSIX在其或 `#{pane_tty}` 不可用的环境中,该检查即为空操作。