description: "面向启动 JSON-RPC harness 运行时的用户与维护者，说明 SDK stdio 应用 profile。" kind: "package-bundle"

@deepseek-ai/dsh-sdk-app

English | 中文

概述

以 dsh-base 为基础的 SDK stdio 应用 dsh profile 组合包。它继承 base 默认禁用模块 HMR（热模块替换）的策略；其 patch 挂载应用自有的零选项命令提供方，并且只在该提供方接受调用后启动 dsh-sdk-jsonrpc-server。因此，dsh --profile sdk --help 会写出 help 并退出，不会占用 stdin 或 stdout。独立的 sdk-minimal bundle 复用同一个启动提供方，并提供自己的 profile 名称。

目录

• 使用本包
• 模型体验
• 已知限制与延期工作
• 开发备注

使用本包

启动提供方把 stdin EOF 接到启动器的有界成功关闭流程。SDK 协议 shutdown、SIGINT 与 SIGTERM 继续使用各自所属的 server 或启动器路径；dispose（资源释放）会排空根 profile 配置树与持久化。stdout 专用于按换行分隔的 JSON-RPC 帧。SDK 不提供 title 表层，因此本组合包禁用模型生成的会话标题；确定性的 fallback title 仍会持久化，但不发起辅助模型请求。继承的投影缓存会为 SDK 创建的会话写入检查点，供后续消费方使用；其持久性屏障会在发布缓存行前 flush 所覆盖的日志前缀，因此可能拆分原本会合并的 JSONL 行。部署通过 profile 组合包与 patch 文件选择另一套完整组合，而不是使用另一个应用 bin。

| 配置 | 默认值 | 行为 | |---|---|---| | profile | sdk | 命令帮助中显示的 profile 名称；挂载此提供方的 bundle 会设置自己的随附 profile 名称。 |

DSH_MAX_TOKENS_AS_SUCCESS 保留 SDK 部署映射：未设置或 JSON true 把 token 达限的 subagent 完成报告为已接受，JSON false 则报告为错误。模型提供方／模型与工作区 cwd 通过 SDK 初始化请求传入；base profile 拥有适配器、工具、持久化、策略、settings 与 credentials。

SDK 使用 base 默认提供的 read、write 和 edit。要添加 str_replace_editor，请使用 base 配置指南中的显式插入 patch。独立的 sdk-minimal profile 自行决定其工具选择。

Python 运行时向本 profile 提供显式下载的创作资源和 Office sidecar。DSH_PRIMARY_RUNTIME 覆盖创作载荷；空值禁用其查询。Office skills 可独立使用任一种资源。Profile patch 可独立于 workspace-dependencies 禁用 skill-office 或替换其 assetRoot；同名文件系统 skills 优先。下载与配置见运行时包。

模型体验

SDK 模型上下文

模型看到什么

profile 继承 base 系统提示词，包括 You are an AI agent powered by DeepSeek Harness. 身份说明，不额外添加特定任务的 persona。每个 Session 通过 dsh-working-directory 提供的必需 user-role 上下文接收当前目录。默认文件工具 schema 包含 read、write 和 edit，不包含 str_replace_editor。

Token 影响

base 提示词段落与所选工具 schema 决定 token 用量；此 profile 不额外添加 persona 文本。

KV Cache 影响

对固定 profile、提供方、模型与工具清单保持稳定。由于随附 SDK profile 使用仅启动时 patch，profile 变化会在下一个进程生效。

已知限制与延期工作

• profile 可能省略 SDK server：TypeScript client 选择的自定义 profile 必须保留本组合包或另一个 dsh-sdk-jsonrpc-server 配置项；没有 peer 响应时，client 初始化会失败。
• 用户插件可以破坏 stdout 纯净性：profile 与逐次启动 patch 属于受信任应用组合。随附组合包不会向 stdout 写入非协议内容，但无法约束任意插入插件。
• 配置变化需要重启：sdk-app 组合包在 YAML 中禁用 HMR，因此一个 stdio 连接不会观察到 server 或 agent 依赖被替换。

开发备注

无。