跳到主要内容

安装 Agent

Agent 就是跟你对话的那个程序，替你打字——包括安装后面所有页面要用到的工具。所以这一页是 你唯一需要自己粘贴几条命令的地方。过了这一页，你只需要粘贴提示词。

本系列中文页面使用 DeepSeek Harness（命令 dsh）；英文页面使用 OpenAI Codex CLI——工具不同，工作方式完全一样。

这一页需要打开终端

Windows 上叫 PowerShell，macOS 上叫 终端，Linux 上就是你系统里那个终端窗口。 粘贴命令，回车，就这么简单。

1. 安装 Agent​

dsh 需要 Node.js 和 pnpm 才能运行，先用 mise 装 Node——切到你自己系统的页签：

还没有 mise 的话，先装它：

curl https://mise.run | sh
mise use --global node@22

Node 就位后，下面这条命令两个系统完全一样：

corepack enable pnpm

你应该看到： 两条命令都没有报错。之后可以用 node -v 确认，版本必须是 v22.12.0 或更高。

这里必须是 22，不能用更低的：很多电脑上现成装的是 Node 20，而 dsh 在 Node 20 上直接 装不上。这是这一页最容易踩的坑。

然后安装 dsh 本体：

pnpm add -g @deepseek-ai/dsh

你应该看到： 安装结束后打印了一串东西，没有红色的错误文字。

验证一下：

dsh --version

你应该看到： 一个版本号。

开发者预览版

dsh 处于 developer preview 阶段，命令和配置未来可能变化。跟本文不一致时，以 dsh --help 和官方仓库为准。

2. 登录​

Agent 需要一把钥匙才能工作。命令行和网页版读的是两个不同的位置：

使用方式钥匙写在哪
网页界面界面里 Settings → Models，在页面上填就行
命令行在 ~/.dsh/.credentials.yaml 里

创建文件 ~/.dsh/.credentials.yaml，内容如下（把 sk-xxxxxxxxxxxxxxxx 换成你自己的密钥）：

DEEPSEEK_API_KEY: sk-xxxxxxxxxxxxxxxx

接下来收紧这个文件的权限，否则 dsh 拒绝加载：

chmod 600 ~/.dsh/.credentials.yaml

验证钥匙是否生效：

dsh --profile headless "回复 ok"

你应该看到： 终端打印了一行回复，没有报错。如果报凭据缺失，说明 dsh 没读到你刚写的那个文件。

3. 站在正确的目录里​

dsh 把启动时所在的目录当作工作区根目录——它只能看到和改动这个目录里的东西。你还没有 项目，所以要站在项目的「父目录」里启动，而不是项目本身里面。

要新建项目：站在新项目的父目录

cd ~/projects
dsh web

维护已有项目：站在项目里

cd ~/projects/admin-platform
dsh web

你应该看到： 浏览器自动打开了一个页面，地址是 http://127.0.0.1:3080；让 Agent 执行 pwd，输出必须是你以为的那个目录。以后每次用 Agent，都是先 dsh web、等浏览器打开， 再在网页里跟它对话。站错目录的典型症状是 Agent 声称创建成功了，但你在预期位置找不到 东西——它建在别处了。

下一步​

Agent 跑起来了，但它还不知道怎么装东西。下一步安装 Skill——之后剩下的 环境准备就是一句提示词的事。