企业官网建设流程全解析

你按教程敲下npx @deepseek-ai/dsh web，浏览器打开http://127.0.0.1:3080，dsh 第一次引导就让你填 DeepSeek 开放平台 API Key。手头没有可用 Key，或者想统一模型出口，任务就卡在这一步。先去 TaoToken 官网 注册并创建 Key，再回 dsh 的模型/API 设置。整个排障目标很明确：让首次引导不再因为 Key 而停住，让 dsh 启动后的第一个标准模式任务能正常跑完。下面按“安装后卡引导、拿 Key、填通道、验证、报错、远程监工前收口”的顺序来写，每一步都落到 dsh 的 Web UI 和你自己的命令行上。

1. dsh 首次打开 Web UI 就卡在 API Key 这一步

1.1 npx @deepseek-ai/dsh web 之后发生了什么

DeepSeek Harness 目前还是预览形态，没有那种双击安装包，常见入口就是命令行。前置条件先看 Node.js：版本需要不低于 22.19，建议直接用 Node 24 一类的新版本，老版本在依赖安装阶段就可能失败。满足后执行：

npx @deepseek-ai/dsh web

首次运行会下载依赖，终端最后会输出一个本地地址，默认是http://127.0.0.1:3080。浏览器打开这个地址，你会看到 dsh 的 Web UI。真正让人停住的不是安装，而是第一次进入后的引导页：它默认让你填 DeepSeek 开放平台的 API Key。

如果你有官方 Key，填进去保存，页面通常会立即生效，不需要重启服务。但很多开发者手头没有现成 Key，或者想把 dsh、Claude Code、其他命令行工具都指到同一个模型出口，避免每个工具都去单独维护一套 Key。这时候引导页就不再是“填一下就好”，而是需要先解决 Key 来源和 Base URL 的问题。

另一个容易忽略的点是：dsh 的首次引导可能只给一个 Key 输入框。它默认代表 DeepSeek 官方通道，并不一定让你当场填自定义 Base URL。你要先判断当前页面是“默认供应商”还是“自定义模型/兼容接口”。如果只有 Key 输入框，硬填一把非官方 Key 通常不会工作，因为请求仍然会发往默认端点。先完成引导进入设置，或者切换到自定义模型入口，再填 Base URL，才是正确路径。

1.2 引导页只认 DeepSeek Key 时，先分清默认通道和自定义模型

dsh 的核心理念是“一切皆插件”，模型、工具、技能、会话都能调整。这个设计决定了它不是只能连 DeepSeek 官方通道。首次引导之所以让人卡住，是因为默认流程把“模型供应商”缩成了一个 Key 输入框。你看到的是 Key，背后其实还有端点、协议、模型 ID 三件事。

排障思路可以拆成两层。第一层，如果你只是想让 dsh 先跑起来，并且有 DeepSeek 官方 Key，那就按引导填，保存后直接进入工作区选择。第二层，如果你要用统一模型通道，就不要在“DeepSeek 官方 Key”这个框里试错。去找 dsh 的模型设置、供应商设置或自定义 API 入口，把供应商类型选成“自定义”或“OpenAI 兼容”，再填 Base URL 和 Key。

这里不要把“统一模型出口”理解成某种网络代理。它只是把你的工具请求指向一个兼容 API 地址，省去每个工具单独注册、单独换 Key 的麻烦。dsh 本身仍然是本地跑起来的 Web UI，任务、工作区、确认操作都在你自己的机器上。先把模型通道配通，再谈远程查看进度和点确认。

2. 去 TaoToken 拿 Key，再回 dsh 填模型通道

2.1 注册、创建 Key、复制模型 ID

打开 TaoToken 注册并登录，在控制台里创建 API Key。创建后把 Key 复制出来，后面统一用占位符YOUR_API_KEY表示。注意不要在截图、聊天记录或公开仓库里暴露真实 Key；如果怀疑泄露，直接回控制台删掉重建。

同一个页面里还要做一件事：看模型广场当时列出的模型 ID。dsh 的模型设置需要你填一个明确的模型 ID，不能凭记忆写一个不存在的名字，也不要随手加日期后缀。不同时间模型列表会变化，所以本文不写死某个 ID，统一以模型广场当时列表为准。你只需要把要用的那一行复制下来，等会粘进 dsh。

准备材料可以固定成三样：

• TaoToken 控制台里创建好的 API Key，占位为YOUR_API_KEY。
• 填进 dsh 的 Base URL：https://taotoken.net/api。
• 从模型广场复制的模型 ID。

注意 Base URL 和官网落地页不是一回事。官网地址用于注册、创建 Key、看模型广场、看用量；填进 dsh 的 Base URL 是https://taotoken.net/api，末尾不要加/v1。把这两个地址混用，是后面 404 或连接失败的常见来源。

2.2 dsh 模型设置里的 Base URL、Key、模型 ID 怎么对

回到 dsh Web UI。如果首次引导页已经出现“自定义模型”或“其他供应商”选项，直接在那里填。如果首次引导只有 DeepSeek 官方 Key 输入框，就先按页面提示进入主界面，再打开模型设置或供应商设置，新增一个自定义通道。字段对应关系可以照下面这张表抄：

供应商/通道：自定义（或 OpenAI 兼容） Base URL：https://taotoken.net/api API Key：YOUR_API_KEY 模型 ID：从 TaoToken 模型广场复制的那一行

保存后 dsh 通常会立即生效，不需要重启命令。若界面提示需要刷新配置，就刷新一次浏览器页面，再回到模型选择处确认新通道已经出现。这里要再强调一次：Base URL 末尾不要写/v1，也不要带任何查询参数。dsh 内部如果会拼接路径，它自己会处理；你在输入框里多写一层，反而会让请求落到错误路径。

模型 ID 要和你复制的完全一致。有些工具会在下拉框里让你选模型，有些则要求手动输入。手动输入时，前后空格、大小写、连字符都可能导致模型不存在。配完后先不要急着跑长任务，先进入下一步的首次标准模式验证。

3. 首次标准模式任务的配置清单与保存后验证

3.1 工作区、标准模式、模型 ID 三项别填错

dsh 启动后，除了模型通道，还会让你选择工作区和运行模式。第一次使用建议直接选标准模式，不要一上来就上复杂模式或长任务。工作区选一个干净的测试目录，里面放一两个文本文件即可，目的是验证模型能不能被调用、dsh 能不能读取工作区、回复能不能回到会话里。

三项检查清单可以这样过：

1. 模型通道是否指向https://taotoken.net/api，Key 是否为YOUR_API_KEY对应的真实值。
2. 模型 ID 是否与模型广场当时列表一致，没有凭空写一个名字。
3. 工作区是否选对，标准模式是否已选中。

如果 dsh 的界面把模型和供应商分开显示，确认当前任务使用的就是刚新增的自定义通道，而不是默认的 DeepSeek 官方通道。很多“我明明填了 Key 还是报错”的情况，实际上是会话仍然挂在旧通道上。

3.2 发一条测试消息，看 dsh 是否真的走通

配置保存后，在 dsh 会话里发一条低风险测试消息，例如：

请用三点说明当前工作区里有哪些文件，并给出一句下一步建议。

这条消息不涉及写文件、执行命令，适合第一次验证。观察 dsh 的回复是否正常返回。如果界面里有轨迹、日志或请求详情，点开看一眼实际使用的模型 ID 和请求地址。然后打开 TaoToken 控制台 看这次调用有没有记上账。能在这里看到对应请求，说明 Key、Base URL、模型 ID 这条链路基本是通的。

如果 dsh 返回了内容，但控制台没有记录，优先检查是不是浏览器里还留着旧配置，或者 dsh 实际调用的是另一个供应商。如果 dsh 直接报错，先不要改工作区，也不要换模型，按下一节的报错对照处理。验证通过后，再让 dsh 做更长的任务，比如读文件、生成修改建议、让你确认后写回。敏感操作仍然由 dsh 弹确认，你点放行才继续。

4. dsh 首次引导常见报错：401、模型不存在、地址带 /v1

4.1 Key 无效与 Base URL 写错的区别

首次引导配置后最常见的两类报错，一类是鉴权失败，一类是找不到模型。鉴权失败通常表现为 401 或“invalid API key”。先检查 Key 是不是从 TaoToken 控制台创建的那一把，复制时有没有带上空格，是否在创建后又被删除。如果 Key 里包含特殊字符，确认粘贴时没有被编辑器自动换行。

模型不存在或 404，则更常和 Base URL、模型 ID 有关。Base URL 填https://taotoken.net/api，不要写成https://taotoken.net/api/v1，也不要把官网落地页的查询参数带进去。模型 ID 必须从模型广场复制，不要自己拼一个带日期后缀的名字。若 dsh 报“model not found”，先回去核对模型 ID，再检查 Base URL 末尾有没有多余路径。

还有一种情况是请求超时或连接失败。先确认 dsh 所在机器能正常访问https://taotoken.net/api，再确认没有在 Base URL 前后加空格。不要把 UTM 参数加到 API 地址上；UTM 只用于官网落地页，不用于填进工具的 Base URL。

4.2 保存没生效、余额、模型广场对不上

dsh 保存配置后通常会立即生效，但浏览器缓存或旧会话可能还拿着上一份配置。改完模型通道后，刷新页面，新建一个会话再测。如果仍然报错，回到模型设置里确认当前通道没有被切回默认供应商。

余额或额度问题也会表现成调用失败。去控制台看用量和剩余情况，不要靠猜。若模型广场列表更新，原先复制的模型 ID 可能已经下架或改名，这时重新复制当前可用 ID，再填回 dsh。本文不写具体价格、评测分数或加速倍数，这类信息以模型广场和控制台当时显示为准。

最后一个容易忽略的点：首次引导如果只让你填了 Key，没有地方填 Base URL，那么你填的 Key 可能仍然被发往默认端点。先找到自定义供应商入口，或者进入设置后新增通道。不要在默认 DeepSeek 官方 Key 输入框里硬塞 TaoToken Key，那只会让你误以为 Key 有问题。

5. 远程监工前，先把 dsh 的模型出口固定下来

5.1 向日葵远程查看的是 Web UI，不是让 AI 直连你的机器

dsh 跑长任务时，人不在电脑前确实难受。原文提到用向日葵远程控制，思路是异地设备登录同一个账号，远程连回主机，在浏览器里打开 dsh 的 Web UI。你能看到任务执行到哪一步、轨迹里哪一步卡住、消耗了多少 Token；发现跑偏了，还能在会话里补提示词纠偏。

这里要划清边界：这是人通过远程桌面查看和操作 Web UI，不是让 dsh 通过某个插件直接去连你的生产机器执行命令。dsh 对写文件、执行命令等敏感操作会弹人工确认，远程场景下也是你点放行。不要把“远程监工”写成让 AI 自动接管远程设备、自动执行诊断命令。模型通道解决的是 dsh 能不能调用模型，远程工具解决的是你能不能看到页面，两者不要混在一起。

先把模型出口固定好，再去配远程查看。否则你远程连回去，看到的还是首次引导报错，等于白连。模型通道验证通过后，再让 dsh 跑需要人工确认的长任务，远程查看才有意义。

5.2 长任务确认项和下一步入口

首次标准模式任务跑通后，你可以让 dsh 做更长的文件整理、代码解释或方案生成。遇到需要写文件、执行命令的确认项，远程连回主机点一下放行即可。若任务中途报错，把报错原文和 dsh 当时使用的模型 ID 一起记录，回模型设置里核对 Base URL 和 Key。

下一步建议按这个顺序走：先用同一把 Key 去 TaoToken 模型对话 发一条测试消息，确认 Key 和模型 ID 没有配错；如果 dsh 长任务消耗较大，去 Coding Plan 看套餐是否够用；需要新 Key 时，在 控制台 API Keys 创建。回到 dsh 后，新建会话再跑一次首次标准模式任务，确认这次调用能在控制台看到记录。

整个排障最关键的还是那两行：Base URL 填https://taotoken.net/api，Key 用从官网创建的那把。把默认通道和自定义通道分清楚，首次引导就不会再卡在 API Key 上。