DeepSeek Harness 启动命令是什么？dsh 常用命令速查手册
DeepSeek Harness（简称 dsh）是 DeepSeek AI 开源的一款 Agent 运行框架，核心设计是"一切皆插件"：模型、工具、Agent 循环都能自由组合。它的使用方式以命令为主，本文整理一份 dsh 启动与常用命令速查，覆盖最常用的启动、任务、配置检查场景，命令可直接复制使用。
一、最核心的启动命令
1. 启动 Web UI（最常用）
npx @deepseek-ai/dsh web执行后浏览器打开本地界面，默认地址 http://127.0.0.1:3080。首次使用会自动初始化配置目录。
2. 指定 profile 启动
dsh --profile <名称>比如启动名为 my-agent 的 profile：dsh --profile my-agent。内置的两个 profile 是 web 和 headless。
二、一次性任务命令（headless）
不想开界面，直接跑一个任务拿结果：
dsh --profile headless "你的任务描述"例如：
dsh --profile headless "把当前目录的测试跑一遍并汇总结果"运行完会打印 agent 的最终回答并退出，适合脚本化、批处理场景。
三、查看帮助与配置
查看启动器帮助：
dsh --help查看应用参数帮助（比如 web 界面的参数）：
dsh --profile web --help检查配置（排查问题很有用）：
dsh --dump-default-config # 查看内置默认配置
dsh --dump-config # 查看叠加后的最终配置四、管理插件的命令
dsh plugin --profile <名称> <pnpm 参数>这个命令把 pnpm 操作转发到指定 profile 目录，用来给 profile 安装、移除插件。
五、参数顺序的讲究
dsh 启动器的参数有固定顺序要求：
- 启动器自己的参数（--profile、--patch 等）必须写在最前面
- 应用参数写在启动器参数之后，属于被启动的 profile
示例：
dsh --profile web --port 8080 # --port 是 web 应用的参数
dsh --profile headless "任务" # 任务文本是应用参数注意：启动器不认识的第一串内容起，都属于应用参数，所以别把应用参数写在启动器参数前面。
六、从源码启动
如果你是克隆源码构建的方式：
cd deepseek-harness
pnpm dsh web构建完成后用 pnpm dsh 代替 dsh 命令即可，参数用法一致。
七、常见问题速查
Q：npx 和 dsh 命令有什么区别？
npx @deepseek-ai/dsh 是首次安装/临时调用；装好后可以直接用 dsh 命令。两者后续参数一致。
Q：提示找不到 dsh 命令？
确认是否已安装，或改用 npx @deepseek-ai/dsh 前缀。
Q：启动后浏览器没自动打开？
手动访问 http://127.0.0.1:3080，确认端口没被占用。
总结
DeepSeek Harness 的命令体系很简洁：日常用 npx @deepseek-ai/dsh web 启动 Web UI（http://127.0.0.1:3080），批处理用 dsh --profile headless "任务"，排查用 dsh --dump-config，管理插件用 dsh plugin。记住"启动器参数在前、应用参数在后"这条规则，基本就能顺畅使用了。
