目录:ACP 协议API 网关与控制器附件启动与插件管理客户端运行时客户端 UI 包上下文压缩上下文注入核心运行时凭据与授权交付物文档处理实验特性宿主扩展反馈通道文件系统目标与计划工具守卫Hooks 扩展宿主服务交互命令作业调度LLM 适配LSP 集成MCP 协议规划模式Agent 预设代码执行运行时运行时诊断沙箱定时调度SDK 与协议会话核心会话检索设置Shell 执行技能溢出存储SSH 远程执行存储子代理子进程终端待办类型契约框架 vendorWeb 访问Webhook工作流工作区
依赖链 · 上游（该插件依赖的前驱）：
依赖链 · 下游（依赖该插件的节点）：
同一拓扑层（Layer 5，层次遍历层序）：
dsh-agent-default-modeldsh-agent-instructionsdsh-agent-loopdsh-agent-preset-registrydsh-agent-tool-presentationdsh-api-account-controllerdsh-api-settings-controllerdsh-api-terminal-controllerdsh-api-workspace-filesdsh-bash-sandboxdsh-client-file-uploaddsh-compaction-image-offloaddsh-compaction-tool-result-prunerdsh-cordis-host-runnerdsh-experimental-browser-use-chrome-devtools-mcpdsh-experimental-browser-use-playwright-mcpdsh-experimental-tool-agent-teamdsh-file-reference-localdsh-fs-sandboxdsh-fs-sshdsh-goaldsh-hooks-codexdsh-jobs-localdsh-llm-retrydsh-mcp-resourcesdsh-message-feedbackdsh-permission-presetsdsh-ptc-runtime-nodedsh-pwsh-sandboxdsh-repeat-tool-reminderdsh-sdk-jsonrpc-serverdsh-session-checkpoint-policydsh-session-referencedsh-session-title-all-prompts-llmdsh-session-title-first-prompt-llmdsh-spill-policydsh-terminaldsh-time-contextdsh-tmux-contextdsh-tool-bashdsh-tool-call-timeout-policydsh-tool-fsdsh-tool-fs-searchdsh-tool-jobsdsh-tool-lspdsh-tool-presentdsh-tool-pwshdsh-tool-session-querydsh-tool-skilldsh-tool-str-replace-editordsh-tool-tododsh-tool-webdsh-tool-workspace-dependenciesdsh-user-questionsdsh-web-search-deepseek
插件信息
| 包名 | @deepseek-ai/dsh-agent-instructions |
|---|---|
| 分组 | G08 · 上下文注入 |
| 拓扑层 | Layer 5（层次遍历：被依赖方先于依赖方） |
| 源码路径 | packages/context/agent-instructions |
① 实现逻辑
AGENTS.md 兼容的工作区指令加载器：启动/恢复基线在首个请求前进入持久上下文，成功触及文件的 fs 工具会把嵌套/变更/移除的指令合入 inbox（src/index.ts:84-225）。通过 ctx.fs 逐目录探测候选指令文件、按字节预算渲染、按 trimmed-content 摘要去重，并把变更状态协商进 sessionProjections 的 turnBoundary 判定（src/index.ts:286-294、src/state.ts:247-433）。监听 session/event(step/end)、agent/pre-step、tools/result 以在正确提交边界刷新指令上下文（src/index.ts:307、src/index.ts:315、src/index.ts:343）。仅在 ctx.fs 存在时生效，无 provider 时退化为 no-op（src/index.ts:119-120）。
内部结构动态 DAG（深色主题：橙色=上游依赖 · 绿色=下游依赖 · 棕色=外部seam · 蓝=本插件）
本插件
上游依赖
下游依赖
外部 seam
② 注册/提供（provides）
③ 依赖（depends_on · 上游前驱）
dsh-agentE1+E2
在 agent 步前把工作区指令上下文拼入请求消息序列，并读取 agent.session 的可见表面状态
src/index.ts:14 import type Agent/PreStepDecision + src/index.ts:315 ctx.on('agent/pre-step') + src/state.ts:7 import type Agent
dsh-llmE1
把渲染后的指令文本构造成带 source 标记的 user 消息注入上下文
src/index.ts:15 import createUserMessage + src/state.ts:8 createUserMessage + src/state.ts:9 import type Message
dsh-sessionE1+E2
读写会话表面历史以判定指令是否已注入，并在 step/end 边界触发刷新
src/index.ts:16 import type Session/UserMessage + src/index.ts:184 type import + src/index.ts:307 ctx.on('session/event') + src/state.ts:10 import type Session/UserMessage
dsh-session-projectionE1+E2
依赖 turnBoundary 投影判断当前步是否开放，决定指令刷新是立即排队还是延迟到步结束
src/index.ts:17 type-only import + src/index.ts:34 inject ['sessionProjections'] + src/index.ts:287 ctx.sessionProjections.stateOf(session, 'turnBoundary')
dsh-toolsE1+E2
从成功的 read/write/edit 工具结果中提取 file_path，把被触及路径转成指令刷新线索
src/index.ts:18 import type ToolExecution/ToolExecutionResult/ToolExecutionToken + src/index.ts:343 ctx.on('tools/result')
④ 被依赖（dependents · 下游消费者）
dsh-experimental-auto-review
识别项目指令来源并归入 constraint 角色
src/index.ts:13 import type {} from '@deepseek-ai/dsh-agent-instructions'