description: "独立 SDK profile，提供持久 shell、图片读取、自动上下文压缩和 Session 工作目录工具，用于不含共享 base bundle 的极简跨平台 coding agent（编程智能体）。" kind: "package-bundle"

`@deepseek-ai/dsh-sdk-minimal`

概述

当 SDK 客户端需要小型、显式的 coding agent 运行时时，请使用 dsh --profile sdk-minimal。该 profile 默认公布按平台选择的持久 shell、read_image 和 working_directory，把会话持久化为未压缩 JSONL，并从 SDK 初始化请求选择模型。它提供完整 Cordis 配置树，并排除 dsh-base、Web、settings、托管凭据、遥测、文本文件工具、workspace 指令、skill（技能）、jobs 与 subagent。其 danger-full-access 策略允许 shell 修改进程可访问的任何路径，因此只能配合隔离 workspace 使用。

使用本包

直接启动该 profile，或从 Python SDK 选择它。提供显式 DSH_HOME、使用一次性 workspace，并通过 DEEPSEEK_API_KEY 提供模型凭据。

export DSH_HOME=/absolute/path/to/example-dsh-home
dsh --profile sdk-minimal

DSH_CONTEXT_WINDOW 为不在适配器建议目录中的模型设置后备容量。DSH_SYSTEM_PROMPT 替换默认 persona。SDK 初始化请求是唯一的模型选择依据，并覆盖环境默认值。

使用 dsh plugin --profile sdk-minimal 管理持久外部依赖。Profile、home 与有序 --patch 文件可以替换完整默认配置树中的配置项，或在该配置树上方插入 bundle。随附模板只在启动时应用 patch。

该 profile 只挂载一套持久 shell：Linux 和 macOS 使用 Bash，Windows 使用 PowerShell。两套配置都使用 300 秒超时与一个 agent 自有终端；另一平台的配置项保持禁用。

与其他随附 profile 一样，它统一挂载 MCP 资源一次。只需配置 MCP 客户端条目即可添加服务器。其他提供方挂载的客户端也属于已配置状态。调用方作用域中未配置服务器时，MCP 不贡献提示词文本或工具，默认仍为 shell、read_image 与 working_directory 三个工具。

理解实现

实现细节——点击展开

该 bundle 的单个 insert 就是完整应用配置树：SDK stdio 启动与 JSON-RPC 服务、一个由环境配置的 DeepSeek 适配器、显式 agent 核心、按配置启用的 MCP 资源工具、本地文件系统、图片附件、自动上下文压缩与子进程服务、Session 工作目录状态及其工具、按平台选择的持久 shell PTY，以及位于 $DSH_HOME/sessions 的未压缩 JSONL 持久化。它不继承其他 bundle，因此每个额外配置项都是显式 profile 变更。

源码地图

文件	职责
`cordis.patch.yml`	完整独立 profile 配置树及其环境默认值
`src/index.ts`	Bundle 包入口
`tests/sdk-minimal.spec.ts`	精确组合、profile 名称与平台选择检查

进一步探索

Python SDK 示例——从 Python 启动本 profile，并使用明确指定的 Harness home。
SDK 应用 bundle——完整与极简 SDK profile 复用的 JSON-RPC 应用层。
Base bundle——本 profile 刻意省略的完整产品基础。

模型体验

极简 coding agent 组合

模型看到的内容

系统提示词取 DSH_SYSTEM_PROMPT，未设置时使用 You are a helpful software engineer assistant.。未配置 MCP 服务器时，对外公布的工具为 read_image、working_directory，以及 Linux/macOS 上 agent 所有的持久 bash 或 Windows 上的 pwsh。必需的用户上下文提供当前目录。可选运行时上下文、文本文件工具、workspace 指令、skill、jobs 控制与 Harness 身份均不存在。

Token 影响

默认是一个稳定 persona、三个工具 schema，以及初始目录与后续变更的用户上下文。已配置 MCP 服务器会添加自己的工具、共享资源工具及可用的服务器指令。图片消耗模型输入 token。图片超过路由预算时，图片省略会永久将较早的图片位置替换为包含附件与路径的占位文本，并重试请求或压缩摘要。上下文压力达到配置阈值时，自动压缩会额外发起摘要请求，并用摘要替换较早的模型可见历史；持久 JSONL 日志保留这些事件。

KV Cache 影响

当 persona、平台、提供方、模型与 bundle patch 栈固定时保持稳定。压缩会替换部分请求历史，可能降低缓存复用率。图片省略还会使缓存复用止于第一张被修改的图片。Profile 变更在下一个进程生效。

已知限制与延期工作

该组合刻意省略共享产品服务 — 需要 settings、托管凭据、策略预设、遥测、Web 工具或完整默认工具清单时，请选择 dsh --profile sdk。
图片读取需要支持图片输入的模型 — 选择适配器声明支持图片输入的路由；纯文本路由会返回工具错误。图片存储在 $DSH_HOME/attachments/v1 下。
压缩由系统自动执行 — 通过 profile patch 配置 compaction-basic。SDK 提示词文本不会执行 /compact 或其他斜杠命令。
用户 patch 可以扩展配置树并破坏 stdout — profile 自定义属于受信任的应用组合；向 stdout 写入普通文本的插件会破坏 JSON-RPC 分帧。

开发备注

维护者工作上下文——点击展开

无。

dsh-sdk-minimal

Install

Source

Readme