从启动到安装第一个插件
依据 DeepSeek Harness 官方文档重新整理的一条最短上手路径。先运行 Web UI，再配置模型和工作区，最后把社区插件安装到独立 profile。
DeepSeek Harness 目前处于开发者预览阶段，接口和插件格式仍可能发生不兼容变化。下面保留官方流程中的关键步骤，并补充插件目录用户最需要的安装与安全说明。
01启动 Web UI
先安装 Node.js，然后在准备作为工作区的项目目录中运行：
npx @deepseek-ai/dsh web命令默认在 http://127.0.0.1:3080 启动 Web UI，并在本机打开浏览器。远程或不希望自动打开浏览器时，可在末尾加 --no-open。
02配置模型
打开“设置 → 模型”，在 DeepSeek 卡片中输入 API 密钥并保存。模型路由会立即生效，不需要重启服务。密钥保存后，页面只显示脱敏信息。
如果使用 OpenAI、Anthropic、企业网关或其他兼容端点，可从“添加提供方”或“添加自定义提供方”进入。自定义地址需要同时填写 Provider ID、基础 URL、协议、凭据和至少一个模型。
查看官方模型配置03选择工作区
点击“选择工作区”，添加启动命令所在的项目目录并选中它。工作区决定 Agent 可以读取和修改的默认文件范围；未选择工作区时，会话输入框不可用。
04运行第一个任务
新建会话后，可以先发送一个只读、容易核对的任务，确认模型与工作区都已连接：
概括这个仓库，并说明主要目录分别负责什么。
Agent 可以读取和编辑工作区文件、运行命令、维护计划。当前权限策略要求确认的操作，Web UI 会在执行前询问。
05安装插件
Harness 使用 profile 隔离不同的插件组合。以下命令沿用官方文档中的 dsh；如果本机没有全局 dsh 命令，可将开头的 dsh 替换为 npx @deepseek-ai/dsh。
从 GitHub 安装时，建议把仓库地址固定到明确的 commit SHA，避免仓库后续更新悄悄改变实际运行的代码：
dsh plugin --profile demo add github:owner/repository#<commit-sha>把 demo 换成你的 profile 名，把 owner/repository 和 commit-sha 换成插件详情页提供的信息。首次使用该 profile 时，Harness 会自动初始化它。
06验证与启动
先输出最终配置，确认插件层已经出现，再启动这个 profile：
dsh --profile demo --dump-config
dsh --profile demo组合包按照加入 profile 的顺序加载；profile 自己的 cordis.patch.yml 会在组合包之后应用，因此可以覆盖插件默认配置。
07移除插件
不再使用某个插件时，通过同一个 profile 移除。命令会同时删除依赖和对应配置层：
dsh plugin --profile demo remove <plugin-package-name>08安装前须知
Git 安装拿到的通常是源码。TypeScript 插件可能通过 prepare 脚本构建，而 pnpm 10 及以上默认要求显式授权。只有在审阅源码并确认可信后，才按命令行提示把准确的包键加入 allowBuilds；随后重新安装。优先选择已发布到 npm 或提供预构建 tarball 的插件，它们通常不需要构建授权。
- 先阅读仓库源码与安装脚本
- 固定 commit SHA，不直接追踪浮动分支
- 为不同用途使用独立 profile
- 只授权命令行明确指出且你已核验的构建脚本
本页根据官方文档重新编排与概括。DeepSeek Harness 更新较快，命令或配置发生冲突时请以官方文档为准。