DeepSeek Harness Python SDK 中文安装与首次验证
官方 Python 包名是 deepseek-harness-sdk，导入名是 deepseek_harness；当前发布快照记录 0.1.5rc1。先建立独立虚拟环境，再安装固定版本并检查包身份。SDK 的安装验证与真实模型请求不同：前者确认本地包可用，后者还需要端点、模型及凭据。已发布 wheel 默认使用 sdk，而更新的上游教程采用 sdk-minimal；按实际安装版本选择说明。
分享仅包含公开链接，不携带本地进度或私人配置。
使用此命令开始
使用前阅读下方检查步骤，再修改参数、凭据或配置。
python -m venv .venv
. .venv/bin/activate
python -m pip install deepseek-harness-sdk==0.1.5rc1先核对 Python、平台与包身份
发布元数据列出的 Python 条件为 >=3.10。同时对照下方官方 SDK 文档的操作系统与架构清单；Python 版本满足条件，不代表任意系统和架构都有匹配的运行时 wheel。不要安装仅名称相近的第三方包。
- 核对当前解释器与 pip 指向同一个虚拟环境。
- 包名 deepseek-harness-sdk；Python 导入名 deepseek_harness。
- 从独立环境开始，保留安装失败的具体错误而非反复覆盖系统环境。
python --version
python -m pip --version预期检查： 应看到 Python 版本以及该解释器使用的 pip 路径。将版本与官方要求对照；这两条命令不会验证 SDK 或模型访问。
在虚拟环境安装固定版本
Linux 和 macOS 使用 python -m venv .venv 后激活 .venv/bin/activate；Windows PowerShell 使用适合本机的 Python 启动器创建环境，再激活 .venv\Scripts\Activate.ps1。下面的安装命令应在已激活的环境运行。普通已发布 SDK 运行包含配套原生 runtime，不要求额外系统 Node；从源码构建是另一条流程。
python -m pip install deepseek-harness-sdk==0.1.5rc1
python -m pip show deepseek-harness-sdk预期检查： 安装成功后，pip show 应显示包名 deepseek-harness-sdk 和版本 0.1.5rc1。下载或平台 wheel 失败时，此检查不会成功；本站未将这段预期说明冒充为当前版本的本机运行记录。
为首次任务提供独立工作区与 home
按已发布 wheel 内附说明，通过 cwd 传工作区，通过 dsh_home 或非空 DSH_HOME 提供 Harness home，并为独立任务使用全新的 session_id。工作区放可丢弃的测试仓库；独立 home 隔离 profile、插件与会话。首次任务先请求指出一份文件和测试命令，人工核对后再授权需要修改文件的任务。
- 凭据在本机环境或对应官方配置中设置。
- 不要把真实密钥写入任务提示、分享链接或源码。
- 同一 session_id 用于继续同一会话，独立工作用新 ID。
区别已发布 wheel 与更新的源码教程
本站静态核对了 0.1.5rc1 wheel 的内附说明，未执行真实推理：默认启动 dsh --profile sdk，允许显式选择其他已存在且保留 SDK 服务的 Profile。最新上游教程改用 sdk-minimal，不应把源码教程的完整行为直接认作旧 wheel 的保证。
选择 minimal 前理解权限与应用树
更新的上游文档说明 sdk-minimal 固定 danger-full-access，持久 shell 可修改运行时可见路径；应放在可丢弃环境或容器。它不是 Web UI 的同一应用树。包提供 Web 资源，也不意味着 Web 服务可以直接作为 Python SDK 客户端服务。需要插件管理时，另按对应版本的 dsh plugin 流程配置 pnpm。
常见问题
Python SDK 是否还需要安装 Node.js？
官方已发布 SDK 包含匹配的原生 runtime，普通 SDK 执行不需要系统 Node。源码贡献者构建、独立 npm 启动器和插件包管理有各自要求。
pip 安装成功是否等于模型已经可用？
不等于。安装只确认包和依赖；请求还要验证凭据、端点协议与模型。先记录安装版本，再单独验证一个最小任务。
为什么 pip 的默认 Profile 与最新教程不同？
当前 PyPI wheel 与更新的源码文档是不同发布身份。已核对 wheel 内附说明默认 sdk，更新的教程采用 sdk-minimal；按实际版本读取说明，不直接混用配置。
能直接在重要项目里运行官方 minimal 示例吗？
应先放到可丢弃 checkout 或容器。更新的上游文档明确 sdk-minimal 使用 danger-full-access；设置 cwd 并不构成对所有可见路径的访问限制。
官方资料
使用新版本前，打开以下固定版本或注明核验日期的资料。