packages/interaction/README.zh.md

# interaction/：人机协作平面

[English](README.md) | 中文

人与运行中的 agent（智能体）协作所经由的服务与插件——提问、审批、权限预设、命令。这些是**产品**包：由用户直接操作的真实接口。

| 包 | 职责 | ctx 键 |
|---|---|---|
| [`commands/`](commands/README.md) | 为交互式适配器注册并分派用户命令。 | `ctx.commands` |
| [`user-approval/`](user-approval/README.md) | 协调一次性审批决策。 | `ctx.approval` |
| [`permission/`](permission-presets/README.md) | 呈现并持久化面向用户的权限预设。 | `ctx.permissionPresets` |
| [`user-questions/`](user-questions/README.md) | 定义与提供方无关的用户问答 seam。 | `ctx.userQuestions` |
| [`tool-ask-user/`](tool-ask-user/README.md) | 向模型提供用户问题。 | （注册到 `ctx.tools`） |

这些包通过现有的 agent 和会话约定集成，而不改变循环。交互式应用提供具体的命令、审批和提问适配器；自动化使用 [`acp/`](../acp/README.md)，可运行的演示组合包位于 [`examples/`](../examples/README.md)。产品 [`dsh`](../../apps/cli/README.md) CLI（命令行界面）直接组合这些包。

子系统参考：[approval.md](../../docs/subsystems/approval.md)、[permission-presets.md](../../docs/subsystems/permission-presets.md)、[user-questions.md](../../docs/subsystems/user-questions.md)与 [commands.md](../../docs/subsystems/commands.md)。仅自动化的 ACP 传输是 [`acp/`](../acp/README.md)，SDK 的 JSON-RPC 服务器端是 [`sdk/server`](../sdk/README.md)，共享 bin 启动胶水是 [`boot/`](../boot/README.md)。
-											refactor(packages): dissolve ui/ and rename sdk/ to scaffold/
										
										
											2026-07-30 03:13:49 +08:00
+								# interaction/：人机协作平面
-											docs: translate remaining READMEs
										
										
											2026-07-26 05:03:53 +08:00
 								[English](README.md) | 中文
-											docs(i18n): include complete proofreading corpus
										
										
											2026-08-12 12:30:19 +08:00
+								人与运行中的 agent（智能体）协作所经由的服务与插件——提问、审批、权限预设、命令。这些是**产品**包：由用户直接操作的真实接口。
-											docs: translate remaining READMEs
										
										
											2026-07-26 05:03:53 +08:00
 								| 包 | 职责 | ctx 键 |
 								|---|---|---|
-											docs: rescan rebased documentation hierarchy
										
										
											2026-08-05 12:46:38 +08:00
+								| [`commands/`](commands/README.md) | 为交互式适配器注册并分派用户命令。 | `ctx.commands` |
 								| [`user-approval/`](user-approval/README.md) | 协调一次性审批决策。 | `ctx.approval` |
-											refactor: apply repository naming contract
										
										
											2026-08-13 00:36:22 +08:00
+								| [`permission/`](permission-presets/README.md) | 呈现并持久化面向用户的权限预设。 | `ctx.permissionPresets` |
 								| [`user-questions/`](user-questions/README.md) | 定义与提供方无关的用户问答 seam。 | `ctx.userQuestions` |
-											docs(i18n): include complete proofreading corpus
										
										
											2026-08-12 12:30:19 +08:00
+								| [`tool-ask-user/`](tool-ask-user/README.md) | 向模型提供用户问题。 | （注册到 `ctx.tools`） |
-											docs: translate remaining READMEs
										
										
											2026-07-26 05:03:53 +08:00
-											docs(i18n): include complete proofreading corpus
										
										
											2026-08-12 12:30:19 +08:00
+								这些包通过现有的 agent 和会话约定集成，而不改变循环。交互式应用提供具体的命令、审批和提问适配器；自动化使用 [`acp/`](../acp/README.md)，可运行的演示组合包位于 [`examples/`](../examples/README.md)。产品 [`dsh`](../../apps/cli/README.md) CLI（命令行界面）直接组合这些包。
-											docs: anchor each subsystem page to its package group; make group READMEs thin tables
										
										
											2026-08-02 05:54:15 +08:00
-											refactor: apply repository naming contract
										
										
											2026-08-13 00:36:22 +08:00
+								子系统参考：[approval.md](../../docs/subsystems/approval.md)、[permission-presets.md](../../docs/subsystems/permission-presets.md)、[user-questions.md](../../docs/subsystems/user-questions.md)与 [commands.md](../../docs/subsystems/commands.md)。仅自动化的 ACP 传输是 [`acp/`](../acp/README.md)，SDK 的 JSON-RPC 服务器端是 [`sdk/server`](../sdk/README.md)，共享 bin 启动胶水是 [`boot/`](../boot/README.md)。