服务的开启
是的,每次都要开启服务 。因为你用的是官方网页版,它的本质是一个运行在你电脑上的"本地网站服务器",终端窗口 = 服务器的"生命线",关了服务就停了。
不过别觉得麻烦,标准步骤非常简单,熟练后 10 秒钟就能搞定:
📝 标准使用步骤(每次照做)
-
打开终端 :按
Win + R,输入cmd,回车。(或者右键开始菜单选"终端") -
输入启动命令(二选一):
-
如果你之前用的是
npx @deepseek-ai/dsh web,就原样输入这个。 -
更推荐 :先执行一次全局安装(
npm install -g @deepseek-ai/dsh),以后每次只需输入dsh web,更简短。
-
-
等待启动 :看到终端出现
dsh web: http://127.0.0.1:3080,启动完成。 -
保持终端运行 :最小化窗口 (千万别点✕),打开浏览器访问
http://127.0.0.1:3080开始使用。 -
用完关闭 :关掉浏览器,回到终端按
Ctrl+C停止服务,然后关闭终端。
🚀 省力小妙招:创建"一键启动"快捷方式
如果你觉得每次都要打开终端输命令太麻烦,可以创建一个 启动DSH.bat 批处理文件,以后双击图标就能自动开启服务,省去敲命令的步骤。
制作方法(照着做):
-
在桌面上右键 → 新建 → 文本文档。
-
打开这个记事本,把下面这行代码原样复制进去:
batch
@echo off dsh web pause(如果你只能用
npx @deepseek-ai/dsh web,就把dsh web替换成它) -
点击 文件 → 另存为。
-
文件名输入
启动DSH.bat(注意后缀是.bat,不是.txt),保存类型选 "所有文件",然后保存到桌面。 -
以后要用时,双击 这个
启动DSH.bat文件,黑窗口会自动弹出来运行服务。
注意 :双击启动后,这个黑窗口依然不能关 ,用完后在里面按 Ctrl+C 结束就行。
⚠️ 终极提醒
如果你想彻底摆脱每次手动启动终端 ,只有一条路:去下载第三方社区封装的桌面版(.exe 安装包)。但那个不是官方出品,版本可能滞后,而且同样需要在后台跑服务,只是把黑窗口隐藏了而已。
我个人建议你先用上面教的 .bat 快捷方式,方便又可靠,等用熟练了再考虑要不要换桌面版。有问题随时问我!😊
插件体验
安装:
基于你之前的实战经验,我为你整理了在 DeepSeek Harness (DSH) 中从 GitHub 安装插件的标准流程。
核心操作是通过 DSH 自带的 dsh plugin 命令,直接从 GitHub 仓库拉取并安装插件。
📝 标准安装流程
-
准备环境
首先,确保你的电脑上已经安装了 Node.js (推荐 v20 或更高版本) 和 pnpm 。同时,确保
dsh命令可以正常使用。如果不确定,可以全局安装 DSH 来获得这个命令:bash
npm install -g @deepseek-ai/dsh -
找到插件地址
在 GitHub 上找到你想要的插件仓库,复制它的完整地址。例如:
https://github.com/用户名/插件名或简写为用户名/插件名。 -
执行安装命令
打开终端(cmd 或 PowerShell),输入以下命令并回车:
bash
dsh plugin --profile web add <GitHub插件地址>-
--profile web:指定将插件安装到web这个配置文件中,也就是你平时通过dsh web启动的那个。 -
<GitHub插件地址>:替换成你找到的插件地址。
命令示例:
bash
# 使用完整 GitHub 地址 dsh plugin --profile web add https://github.com/LayneChai/superpowers-dsh.gitbash
# 使用简写格式 (用户名/仓库名) dsh plugin --profile web add github:Noob-stupid/dsh-plugin-hubbash
# 指定特定分支 (main) dsh plugin --profile web add "github:dsh-external/dsh-agent-teams#main" -
-
重启 DSH 服务
安装完成后,必须重启 DSH 服务 才能生效。在运行
dsh web的终端里按Ctrl+C停止,然后重新运行dsh web启动。 -
验证与使用
服务重启后,刷新浏览器页面 (
Ctrl + F5强制刷新)。新安装的插件功能应该就会出现。如果插件提供了管理界面,可以在网页的 设置 → 插件 中找到并进行管理。
🎯 常用插件地址参考
为了方便你查找,这里有几个不同类型的插件地址:
| 插件名称 | 功能简介 | 安装命令示例 |
|---|---|---|
| dsh-web-ui-all | UI增强聚合包,包含任务看板、鲸鱼娘宠物等 | dsh plugin --profile web add @linxin666/dsh-web-ui-all |
| dsh-plugin-hub | 在DSH界面内提供插件管理面板 | dsh plugin --profile web add github:Noob-stupid/dsh-plugin-hub |
| superpowers-dsh | 提供TDD、调试、规划等技能 | dsh plugin --profile web add github:LayneChai/superpowers-dsh |
| dsh-agent-teams | 让AI以多智能体团队方式协作 | dsh plugin --profile web add github:dsh-external/dsh-agent-teams |
💡 其他便捷安装方式
除了直接从 GitHub 安装,还有两种更便捷的方法:
-
从 npm 安装:如果插件已发布到 npm,可以直接用包名安装,通常更稳定、速度更快。
bash
dsh plugin --profile web add <npm包名> -
通过插件市场安装:一些插件市场(如 WhaleHub 或 dsh-plugin-hub)允许你在 DSH 的 Web 界面里浏览和点击安装,完全不用敲命令。
⚠️ 注意事项
-
必须通过
dsh plugin安装 :不要用npm install直接安装插件,这样插件不会被注册到 DSH 的配置中,导致无法加载。 -
注意 Node.js 版本 :部分插件可能对 Node.js 版本有特定要求,比如要求
^22.19或>=24。 -
网络问题:如果从 GitHub 安装速度慢或失败,可以尝试使用代理,或优先选择从 npm 安装的方式。
-
安装后无反应 :尝试在浏览器中强制刷新 (
Ctrl + F5)清除缓存。如果还不行,可以去 DSH 的 设置 → 插件 中检查插件是否被启用。
希望这份指南能帮你顺利安装各种插件!
开启:
安装完成后:
bash
dsh web
然后打开浏览器访问 http://127.0.0.1:3080,按 Ctrl + F5 强制刷新(不是普通的 F5,是强制清缓存刷新)。
未来学习:
如何成为开源贡献者(实战路线图)
你特别提到"像这个插件的开发者一样",那我们就以 dsh-web-ui 这个插件生态 为切入点。这个插件是用 TypeScript + Vue(或 React)+ Node.js 写的。
🚀 第 1 步:从一个"高级用户"变成"问题反馈者"(现在就能做)
-
你现在已经装好了插件,用的时候肯定会遇到 Bug(比如鲸鱼娘卡顿、任务看板不刷新)。
-
去 GitHub 仓库(
zhu1090093659/dsh-web-ui)的 Issues 区,看看有没有人提过类似问题。如果没人提,你就提一个! -
提 Issue 的模板:
"我使用的是 Node.js v24,DSH v0.1.0,插件版本 x.x,点击任务看板时控制台报错 xxx。复现步骤:1... 2... 3..."
能提交高质量的 Bug 报告,就已经是开源贡献的第一步了。
🛠 第 2 步:看懂"说明书"(大二上学期)
-
学 Git :必须会
clone、branch、commit、push、PR(Pull Request)。这是开源世界的"普通话"。 -
看懂项目结构 :把你之前下载的
dsh-web-ui源码文件夹拖进 VS Code 。看看packages目录下有哪些子包(比如pet宠物包、task-board看板包)。 -
改一行代码试试 :比如找到鲸鱼娘说话的文案(通常在
.vue或.ts文件里),把"你好"改成"大佬好",然后在本地上跑pnpm build和dsh plugin重新加载。能改文案了,就离改逻辑不远了。
🔧 第 3 步:解决一个"新手友好"的 Issue(大二下学期)
-
在 GitHub 上找带有
good first issue(好上手)或help wanted(需要帮助)标签的问题。 -
不看代码量,先看能不能读懂报错在哪里。比如插件里的"实时令牌统计"如果数字显示不对,你顺着 API 接口去查,可能就是改一行
toString()的事。 -
提交 PR:哪怕只是修了一个错别字,或者补充了 README 文档(英文/中文翻译),也算开源贡献。
🧠 第 4 步:成为"子包"维护者(大二升大三)
-
当你能熟练改 Bug 后,可以尝试给
dsh-web-ui写一个新的"皮肤"或小工具。 -
利用 AI(比如 DeepSeek)帮你生成 Vue 组件的框架,你来调整布局和接口数据。写完挂在自己的 GitHub 上,给原作者提 PR 请求合并。