第 9 章：上下文与人类协作

这一章讲两个相邻面：请求上下文（给模型可见上下文但不定义工具）与人类协作平面（人类与运行中的 agent 协作——问题、审批、权限预设、命令、反馈）。

9.1 请求上下文（context）

packages/context/ 的产品插件给模型可见请求上下文，但不定义工具。

包	职责	ctx key
`dsh-session-reference`	其它会话的有界快照	`ctx.sessionReferenceResolver`
`dsh-time-context`	当前时间与已用时间上下文	—
`dsh-tmux-context`	tmux 位置上下文	—
`dsh-agent-instructions`	workspace 指令上下文	—

agent-instructions 被默认 dsh-agent-spine-demo bundle 包含（可通过 bundle 配置禁用）；time-context、tmux-context、session-reference 是 opt-in。

共同机制：上下文插件统一经 agent/pre-step 注入带 source 的 user/message——它们是模型可见的，因此也遵循「模型可见 ⟺ 已入日志」不变式，必须能从会话日志重建。这正是第 1 章「加模型可见上下文 → 调用 agent.inject()」的落地。

9.2 人类协作平面（interaction）

packages/interaction/ 的服务与插件让人与运行中的 agent 协作。它们通过既有 agent/session 契约集成，而不是改循环。

包	职责	ctx key
`dsh-commands`	为交互式适配器注册并派发人类命令	`ctx.commands`
`dsh-user-approval`	协调一次性审批决定	`ctx.approval`
`dsh-permission-presets`	呈现并持久化面向用户的权限预设	`ctx.permissionPresets`
`dsh-user-questions`	provider 无关的人类问答接缝	`ctx.userQuestions`
`dsh-tool-ask-user`	向模型暴露人类问题	（注册 `ctx.tools`）

交互式应用提供具体的命令、审批、问答适配器；自动化走 acp/。

9.3 审批（approval）

ctx.approval 是一次性权限决定：经 approval/request waterfall 派发。回答者是监听器（ACP 桥为自己 agent 作答）；缺席时 fail closed 到 unavailable——这正是「无人能回答 = 拒绝」的安全默认。

审批在工具执行流水线里的位置：tools/pre-execute 之后、单调守卫之前；ctx.approval 在守卫前解析 ask。细节见审批子系统与工具执行流水线。

9.4 权限预设（permission-presets）

ctx.permissionPresets 是面向用户的预设表（workspace-write / danger-full-access），把沙箱模式与审批策略两个旋钮捆绑。一个开关写一条 permission/preset 事件，贯穿到两个旋钮事件。

源码核对：该事件是 permission/preset（部分 README 旧写为 permissionPresets/preset，以源码为准）。

9.5 人类命令（commands）

人类命令是以斜杠开头的指令，由面向人类的适配器通过 ctx.commands 解释执行，不成为模型消息。它既区别于模型面工具，也区别于经 ctx.shell 的 shell 命令执行。命令输出是 UI 状态，除非处理器另行变更持久领域。典型例子：/goal（dsh-command-goal）、/compact（dsh-command-compact）、/feedback（dsh-command-feedback）、/plan（dsh-plan-mode）。

9.6 问答（user-questions / ask-user）

ctx.userQuestions 是 UI 支撑的人类问答接缝（AskUserQuestionRequest、answer/options 词汇、provider API、错误分类）。tool-ask-user 在 provider 无关的 ask() promise 上暂停一个工具调用——模型用 ask_user_question 工具向人提问，答案回来后才继续。细节见问答子系统。

9.7 反馈（feedback）

packages/feedback/ 暴露两个刻意分离的契约，都不进入模型对话：

包	职责	ctx key
`dsh-command-feedback`	触发无关的 `feedback/record` 事件 + 人类面 `/feedback` 生产者	—
`dsh-message-feedback`	生命周期绑定的每条消息评分/备注 sidecar + Host `messageFeedback.list/put/delete` Remote 契约	`ctx.messageFeedback`

命令反馈是 log-only（永不进模型上下文或派生历史）。消息反馈不是 Session 事件或投影，留在 storage-domain sidecar 里，不触发遥测交接。

下一步

协作状态是「活的」，但 dsh 的价值在于它把一切都落在持久日志上。下一章第 10 章：持久化与数据平面看会话如何落盘、查询、投影，以及设置、凭据如何分层解析。