快速上手

装好之后，本章带你完成第一次启动 → 配置 → 发出第一条指令的完整流程，并观察 agent 是如何“动手干活”的。

1. 启动 Web UI

在你的项目目录下执行：

npx @deepseek-ai/dsh web

终端输出访问地址后，用浏览器打开 http://127.0.0.1:3080。默认地址本地回环、不对外暴露，无需担心他人连接。

2. 三步让 Agent 开工

Step 1 · 配置 API Key

进入 Settings → Models，找到 DeepSeek 卡片，填入你的 sk-... 密钥并保存。密钥是“只写”的——保存后页面只显示脱敏描述符，真实密钥永远不会明文回显。

Step 2 · 选择工作区

点击「选择工作区」，添加一个想让 Agent 操作的项目目录并选中。没选中前输入框是灰色不可用的——这是安全设计。新手建议先在桌面建一个练习文件夹，别直接指向重要项目。

Step 3 · 发出第一条指令

新建会话，直接输入自然语言。推荐用“Hello World”试试水：

Summarize this directory and tell me what this project is about.

中文也可以：

分析这个目录的结构，告诉我每个文件和文件夹是干什么的。

3. 一个真实任务示例

让 Agent 分析当前仓库并绘制架构图，可以直接派发这样的提示词：

分析当前项目的代码仓库结构，绘制一张清晰的架构图。
要求用 Mermaid 语法输出，让完全不懂代码的人也能一眼看明白各模块的关系。

你会看到 agent 自动读取文件、分析项目结构，执行速度很快，而且每一步在做什么都清晰地展示在界面上。任务结束后，还可以在下方查看：

• 任务消耗的 Tokens；
• 当前上下文占用；
• 整个对话的 Tokens 消耗信息。

4. 几个实用玩法

玩法	提示词示例
代码理解	“总结这个仓库，告诉我主要的包结构。”
Bug 修复	“定位并修复 utils.js 里的空指针问题。”
批量重构	“把 src/ 下所有函数改成 async/await 风格。”
生成测试	“为 orderService 补齐单元测试，覆盖边界情况。”
文档生成	“根据代码生成 README 和接口说明。”

建议：先在练习目录里熟悉它的行为，再逐步把真实任务交给它。超出权限策略的敏感操作（删除文件、执行危险命令等）会先征求你的审批。