mirror of
https://github.com/deepseek-ai/deepseek-harness.git
synced 2026-08-29 04:26:38 +00:00
Tianyi Cui
7a11f5fde3
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.2 KiB
1.2 KiB
DeepSeek Harness Python SDK
English | 中文
用于以子进程方式驱动 DeepSeek Harness 的 Python 包。客户端 SDK 通过 stdio 使用按行分隔的 JSON-RPC 与内置运行时通信。
包
| 目录 | 分发名／模块 | 职责 |
|---|---|---|
| sdk | deepseek-harness-sdk / deepseek_harness |
高层轮次 API 与低层 JSON-RPC 客户端 |
| sdk-runtime | deepseek-harness-runtime-bin / deepseek_harness_runtime |
内置 dsh CLI 可执行程序与原生伴随文件 |
行为
除非调用方选择另一个 dsh 可执行程序或 profile，否则 SDK 会启动匹配的内置 dsh --profile sdk 运行时。可运行极简示例选择随附的独立 sdk-minimal profile；同一运行时还会为独立 CLI 使用打包 dsh web 及其前端产物。每次启动都要求显式选择 Harness home；Python 绝不会静默读取 ~/.dsh。SDK 参考和运行时载体参考定义运行时选择、profile、patch 与外部插件管理约定。
贡献者工作流
Python 贡献者工作流介绍运行时产物构建、包验证、源码模式开发和分发。