mirror of
https://github.com/deepseek-ai/deepseek-harness.git
synced 2026-08-29 04:26:38 +00:00
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.
1.5 KiB
1.5 KiB
bundle/ — profile 插件组合包
English | 中文
Profile 组合包:在 manifest(元数据清单)中声明 "dsh": { "bundle": { "patch": "./cordis.patch.yml" } } 的 npm 包,因此可作为 patch 层安装进 dsh --profile 组合(profile 约定)。组合包的实体是它的 patch 列表;有些组合包还附带由其 patch 挂载的运行时粘合插件。
Bundle 身份由 manifest 声明决定,而不是由本目录决定。领域包可以携带自己的可选 Profile 层;Codex 与 Claude Code subagent 包就是可直接安装的例子。
| 包 | 职责 | ctx key |
|---|---|---|
base/ |
基于 base 的 profile 最先应用的共享 dsh 核心 | —(仅 patch) |
acp-app/ |
运行在 base 之上的 automation-only ACP stdio 应用 | 挂载 ACP bridge |
web-app/ |
浏览器表层:web patch 层 + 运行时粘合插件 | 挂载多条配置行 |
headless/ |
直接运行在 base 之上的一次性任务模式,不含 Host 或 Web 层 | 挂载 headless-runner |
sdk-app/ |
运行在 base 之上的 SDK stdio JSON-RPC 应用 | 挂载 SDK server |
sdk-minimal/ |
不含 base 或 Web 的独立极简 SDK 应用 | 无(完整 patch 树) |
内置组合包从 dsh 安装目录解析;树外(out-of-tree)组合包通过 dsh plugin --profile <name> add <package> 安装进 profile。