Tianyi Cui 7a11f5fde3 docs(python): define the standalone minimal profile

Record sdk-minimal as the narrow repository-owned exception to base-first profile composition: callers still launch only dsh and cannot provide an arbitrary Cordis tree, while the shipped bundle may own a complete explicit roster. Cross-link the launcher, profile-bundle, Python-runtime, minimal-agent, snapshot, and telemetry decisions; the supersession audit keeps each older note active because its remaining rationale is independent.

Update the CLI, architecture, Python tutorial/reference, example, runtime-wheel reference, and bundle documentation. The docs distinguish the full sdk profile from sdk-minimal, explain explicit-home/plugin/patch customization, state the minimal permission and persistence choices, and retain the separately packaged web profile and frontend assets for direct dsh use.

Correct dsh-base descriptions to cover base-backed profiles, make SDK startup configuration visible in the generated config catalog, add sdk-minimal to the module graph, and regenerate the base-composition graph. English and Chinese pairs are re-recorded at the exact reviewed contents.

2026-08-24 17:28:29 +08:00

2.6 KiB

Raw Blame History

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

English | 中文

供 dsh --profile sdk-minimal 使用的独立极简 SDK 应用组合包。它的单个 insert 构成完整 Cordis 树：SDK stdio 启动与 JSON-RPC 对外服务、一个由环境配置的 DeepSeek 适配器、无执行器的 agent 主干、本地子进程与不受限文件系统提供方、持久 Bash PTY、字符串替换编辑器，以及位于 $DSH_HOME/sessions 的未压缩 JSONL 会话持久化。它刻意不包含 dsh-base、Web、settings、托管凭据、遥测、压缩（compaction）、workspace 指令、skills、jobs 工具、subagent 或任何其他面向模型的工具。

该 profile 仍遵循普通 launcher 与分层模型。组合包提供完整默认树；profile patch、home patch 与有序 --patch 文件可以在其上替换配置项或插入外部组合包。dsh plugin --profile sdk-minimal 管理持久依赖。随附模板仅在启动时应用 patch，因此一个 stdio 连接不会观察到服务器或 agent 依赖在运行中被替换。

DEEPSEEK_API_KEY 提供适配器凭据。DSH_MODEL 选择唯一配置的模型，DSH_CONTEXT_WINDOW 设置其上下文窗口，DSH_SYSTEM_PROMPT 替换默认 persona。进程工作目录同时作为沙箱策略 workspace 与本地文件系统根目录。该组合包设置 danger-full-access；其持久 shell 与编辑器可以修改进程可访问的任何路径。

模型体验

极简 coding agent 组合

模型看到的内容

系统提示词取 DSH_SYSTEM_PROMPT，未设置时使用 You are a helpful software engineer assistant.。对外公布的工具只有 agent 所有的持久 bash 与 str_replace_editor；运行时上下文、workspace 指令、skills、jobs 控制、compaction 与 Harness 身份均不存在。

Token 影响

一个稳定 persona 加两个工具 schema。工具结果与普通对话历史随会话增长。

KV Cache 影响

当 persona、平台、提供方、模型与组合包 patch 栈固定时保持稳定。Profile 变更在下一个进程生效。

已知限制与待办工作

该 profile 仅支持 POSIX — 此组合使用 Bash PTY；Windows profile 必须改为选择 PowerShell 终端与工具。
该组合刻意省略共享产品服务 — 需要 settings、托管凭据、权限策略预设、遥测、Web 工具或完整默认工具清单时，请选择 dsh --profile sdk。
用户 patch 可以扩展配置树并破坏 stdout — profile 自定义属于受信任的应用组合；向 stdout 写入普通文本的插件会破坏 JSON-RPC 分帧。

2.6 KiB Raw Blame History Unescape Escape

@deepseek-ai/dsh-sdk-minimal