源码 / npm 通道（2026-09-09） ：本文同步官方 master 的 0.1.5-alpha.1 （ 5dda764ed3 ）；npm latest / next 为 0.1.2-rc.1 ， alpha 通道为 0.1.5-alpha.1 。默认 npx 启动的是 npm latest 版；体验本文的新接口请走源码构建，详见 现状页 。 这一篇按官方公开仓库的运行方式先把 DSH 跑起来,不深究原理(原理留给 原理课程 和 学习路径 )。 DSH 当前处于 Developer Preview ，版本迭代可能包含兼容性变更。官方源码与发布说明以 deepseek-ai/deepseek-harness 为准。 打开 Web UI 完成第一次对话,并看到"组合树"长什么样 需要 Node.js ^22.19.0 或 >=24.0.0 。零安装启动方式是： 它会启动 Web UI，默认地址为 http://127.0.0.1:3080 。如果你在官方源码仓库中开发，使用： 后文用 dsh 表示已经可用的 CLI 入口；使用零安装方式时，把 dsh ... 写成 npx @deepseek-ai/dsh ... 。 1. 配置 API Key ​ DSH 启动时按优先级读凭据:进程环境 → ~/.dsh/.credentials.yaml (托管存储)→ 工作目录 .env → ~/.dsh/.env (兜底)。 官方 provider 名是 deepseek-official ,模型如 deepseek-v4-flash (默认路由见 配置 )。 想用别的 provider / 自建网关,配 llm-pi-ai.providers (见 多模型 )。 凭据安全 :托管的 .credentials.yaml 由 DSH 原子落盘 0600(0700 目录); .env 是普通环境层,权限自负。更细的机制见 凭据管理 与 数据与隐私 。 源码版会自动打开终端给出的 http://127.0.0.1:3080/?token=… 启动链接（传 --no-open 可禁用自动打开）；根路径交换 token 后设置浏览器 cookie，并跳转回干净的 / 。保存或分享链接时先移除 token。 第一次你会依次看到版本化提示与模型凭据引导；完成后进入工作台：

左侧是可折叠的 Workbench 侧栏 (展开宽栏或 56px rail) 中间是可选的工作区:第一次会要求你选一个工作目录,DSH 的活动都发生在你选的这个目录里 Web UI 默认监听 loopback。当前源码会在启动时拒绝 --host 0.0.0.0 ；远程操作优先使用 SSH 端口转发，并使用终端给出的启动链接。 选定工作目录后,你输入的第一条消息就能触发完整链路 :agent 选模型 → 装配上下文 → 调模型 → (可能)调工具 → 回写会话。整个过程都会写进 ~/.dsh/sessions/ 的会话日志(默认 zstd 压缩)。 试一个会触发工具的提问,比如" 列出当前目录的前 10 个文件 "。你会看到消息流里: 一个 user/message (你发的) 若干 assistant/message 或工具调用( tool/call → tool/result ) 这一条消息走过了什么,是 Agent 主循环 整篇的主题。现在先不用深究,确认它能动就行。 --dump-config 按连续来源分组，每组前带 # == <label> 注释(必要时附带 patched by … )，你能看出某个配置来自 base 层、web-app 层还是你的 profile 层。 你现在能跑了。接下来按你的目标选一条路: 只是日常用 : 使用指南 → 能力要点 → 配权限 想理解原理 : DSH 是什么 → Agent 主循环 想给模型加能力 : 写你的第一个插件 2. 启动 Web UI 打不开?常见原因