Tianyi Cui
a238c4b064
Master made bilingual pairing mandatory repo-wide; the subprocess family docs get their zh counterparts: new pairs for the core-data subprocess catalog and the three subprocess READMEs (switcher lines added on the en side), and minimal zh updates for the packages/bash/bash-local README deltas this PR made, with pairing records recorded.
1.5 KiB
1.5 KiB
bash/：bash 能力家族
English | 中文
规范的三包能力 seam（见能力 seam）：抽象执行器接口、具体实现，以及消费该接口的面向模型工具。这些全是产品 包。
| 包 | 职责 | ctx key |
|---|---|---|
bash/ |
抽象 bash 执行器 seam（接口 + 词汇；沙箱结果事实携带 sandbox/ seam 的模式／强制执行词汇，受管环境／输出词汇则从 subprocess/ seam 重导出） |
ctx.bash |
bash-local/ |
构建在 subprocess/ 服务之上的本地 BashExecutor 实现（命令默认值补全、deadline、终端环境、后台读取合并） |
（注册 ctx.bash） |
bash-sandbox/ |
消费沙箱的 BashExecutor（通过 ctx.sandbox 包装每个命令 argv，标记拒绝／强制执行事实；扩展 bash-local 的机制） |
（注册 ctx.bash） |
tool-bash/ |
面向模型的 bash schema；后台进程注册到通用 tasks/ 运行时 |
（注册到 ctx.tools） |
接口位于 bash/bash/。以 bash-sandbox 替换 bash-local，同时不改动接口或工具，正是这种拆分存在的意义：叶级 cordis.yml 选择一个执行器配置项；受限实现还需选择一个 ctx.sandbox 提供方配置项（见 acp-agent 示例的默认组合）。