常见问题

安装、模型配置、工作区、审批、headless 与插件安装的常见问题解答

本页按主题整理 DeepSeek Harness（dsh）的常见问题。找不到答案时，请看故障排查或到社区求助。

安装

什么是 `npx`？我是不是要先手动安装什么？

npx 是 Node.js 自带的命令，含义是「临时下载并运行一个 npm 包，用完不残留安装」。npx @deepseek-ai/dsh web 会自动去 npm 仓库取来 dsh 包并运行其 web 入口，你不需要先执行 npm install。首次运行时它还会初始化 profile 并下载依赖，所以第一次启动较慢；之后会复用缓存。详见安装与启动。

不同系统怎么安装 Node.js？

Windows：到 nodejs.org 下载 LTS 版 .msi 双击安装，或 winget install OpenJS.NodeJS.LTS；
macOS：到 nodejs.org 下载 LTS 版 .pkg 双击安装，或 brew install node@24；
Linux：发行版仓库里的版本往往偏旧，推荐用 nvm 安装（nvm install 24）。

装完重开终端，用 node --version 验证版本满足 ^22.19 或 >=24。完整步骤见安装与启动。

提示「`npx` 不是内部或外部命令」怎么办？

说明 Node.js 没有安装成功，或安装后没有重开终端。先按上面的方法安装 Node.js，重开终端再试；仍不行就到故障排查看 PATH 相关条目。

Node 版本有什么要求？

推荐使用 ^22.19 或 >=24；从源码运行时这是硬性要求。先用 node --version 确认版本，再决定是否需要升级。安装方式见安装与启动。

首次 `npx` 运行很慢或卡住怎么办？

首次运行 npx @deepseek-ai/dsh web 会自动初始化 web profile 并下载依赖，因此需要网络，耗时也明显比后续启动长。确认网络可用、Node 版本正确后，耐心等待首次下载完成即可。

`npx` 与从源码运行有什么区别？

npx 直接运行已发布的版本，适合日常使用。从源码运行需要 git clone、pnpm install、pnpm run build，适合跟随最新开发或参与贡献。两种方式的启动参数一致。

模型配置

在哪里填写 API 密钥？

打开 设置 → 模型，输入 DeepSeek API 密钥并保存。模型路由立即生效，不需要重启服务器。详见配置模型。

如何接入其他提供方或自定义端点？

在模型页选择添加提供方（Anthropic、OpenAI 等目录提供方），或选择添加自定义提供方填写任意 OpenAI 兼容端点的 Base URL 与密钥。已安装目录会提供端点、协议与模型列表；自定义提供方需要自行填写 Provider ID、基础 URL、协议、凭据与至少一个模型。