必须先启动deepseek harness web界面并完成api密钥认证与工作区绑定，否则无法触发工具调用；执行npx @deepseek-ai/dsh web启动服务，访问http://127.0.0.1:3080，配置api key后选择授权文件夹，再选标准模式等预设模式即可执行读文件、运行命令等真实任务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想让DeepSeek Agent在本地跑起来，完成读文件、执行命令、改代码等真实任务，必须先启动Agent Space——也就是DeepSeek Harness的Web界面，并完成API密钥认证与工作区绑定，否则所有指令都无法触发工具调用。
安装并启动Harness Web服务
打开终端（Windows按Win+R→输入cmd→回车；macOS/Linux打开Terminal），直接执行：
npx @deepseek-ai/dsh web
首次运行会自动下载依赖包，等待约40秒，看到控制台输出以“dsh web: http://127.0.0.1:3080”开头的地址即表示启动成功。这一步不能跳过npm全局安装，因为npx每次都会重新拉取，而实际使用中频繁重启会导致延迟明显升高。
复制该地址，在浏览器中手动打开（不要依赖自动跳转，某些安全软件会拦截）。
配置API Key并选择工作区
页面加载后，左下角点击⚙️设置图标 → 在“API Keys”区域点击“+ Add API Key” → 输入你在platform.deepseek.com创建的API Key → 点击Save。
【必须确认Key已生效】：保存后刷新页面，若右上角仍显示“API Key missing”，说明未正确写入或环境变量冲突，需检查是否误将Key粘贴到注释行或前后含不可见空格。
返回主界面，点击左上角“Select Workspace” → 浏览并选中一个**你明确授权给Agent操作的文件夹**（例如D:\my-project），该路径将作为Agent唯一可读写的空间范围。
切换运行模式并发出首条指令
第一步：点击界面右上角模式下拉框，从四个预设中选择一项：
① 标准模式 —— 默认启用全部工具（文件编辑、Shell、检索、子Agent等），适合日常开发任务；
② 极简模式 —— 仅保留shell和文件读写，用于测试模型基础能力，避免插件干扰；
③ PTC模式 —— 模型生成TypeScript代码来编排多步操作，适合需要强流程控制的场景；
④ 创造模式 —— 可动态加载/卸载插件，仅推荐熟悉Cordis架构的开发者使用。
第二步：在底部输入框中输入具体、可验证的任务，例如：
「列出当前工作区下的所有 .ts 文件名，并说明每个文件可能承担什么功能」
按下回车，Agent将开始推理→调用文件系统工具→解析内容→组织回复。只要API Key有效且工作区权限正常，3秒内即可看到首条响应流式输出。
