Deepseek Harness初体验

服务的开启

是的,每次都要开启服务 。因为你用的是官方网页版,它的本质是一个运行在你电脑上的"本地网站服务器",终端窗口 = 服务器的"生命线",关了服务就停了。

不过别觉得麻烦,标准步骤非常简单,熟练后 10 秒钟就能搞定:

📝 标准使用步骤(每次照做)

  1. 打开终端 :按 Win + R,输入 cmd,回车。(或者右键开始菜单选"终端")

  2. 输入启动命令(二选一):

    • 如果你之前用的是 npx @deepseek-ai/dsh web,就原样输入这个。

    • 更推荐 :先执行一次全局安装(npm install -g @deepseek-ai/dsh),以后每次只需输入 dsh web,更简短。

  3. 等待启动 :看到终端出现 dsh web: http://127.0.0.1:3080,启动完成。

  4. 保持终端运行最小化窗口 (千万别点✕),打开浏览器访问 http://127.0.0.1:3080 开始使用。

  5. 用完关闭 :关掉浏览器,回到终端按 Ctrl+C 停止服务,然后关闭终端。


🚀 省力小妙招:创建"一键启动"快捷方式

如果你觉得每次都要打开终端输命令太麻烦,可以创建一个 启动DSH.bat 批处理文件,以后双击图标就能自动开启服务,省去敲命令的步骤。

制作方法(照着做):

  1. 在桌面上右键 → 新建文本文档

  2. 打开这个记事本,把下面这行代码原样复制进去:

    batch

    复制代码
    @echo off
    dsh web
    pause

    (如果你只能用 npx @deepseek-ai/dsh web,就把 dsh web 替换成它)

  3. 点击 文件另存为

  4. 文件名输入 启动DSH.bat (注意后缀是 .bat,不是 .txt),保存类型选 "所有文件",然后保存到桌面。

  5. 以后要用时,双击 这个 启动DSH.bat 文件,黑窗口会自动弹出来运行服务。

注意 :双击启动后,这个黑窗口依然不能关 ,用完后在里面按 Ctrl+C 结束就行。


⚠️ 终极提醒

如果你想彻底摆脱每次手动启动终端 ,只有一条路:去下载第三方社区封装的桌面版(.exe 安装包)。但那个不是官方出品,版本可能滞后,而且同样需要在后台跑服务,只是把黑窗口隐藏了而已。

我个人建议你先用上面教的 .bat 快捷方式,方便又可靠,等用熟练了再考虑要不要换桌面版。有问题随时问我!😊

插件体验

安装:

基于你之前的实战经验,我为你整理了在 DeepSeek Harness (DSH) 中从 GitHub 安装插件的标准流程。

核心操作是通过 DSH 自带的 dsh plugin 命令,直接从 GitHub 仓库拉取并安装插件。

📝 标准安装流程

  1. 准备环境

    首先,确保你的电脑上已经安装了 Node.js (推荐 v20 或更高版本) 和 pnpm 。同时,确保 dsh 命令可以正常使用。如果不确定,可以全局安装 DSH 来获得这个命令:

    bash

    复制代码
    npm install -g @deepseek-ai/dsh
  2. 找到插件地址

    在 GitHub 上找到你想要的插件仓库,复制它的完整地址。例如:https://github.com/用户名/插件名 或简写为 用户名/插件名

  3. 执行安装命令

    打开终端(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.git

    bash

    复制代码
    # 使用简写格式 (用户名/仓库名)
    dsh plugin --profile web add github:Noob-stupid/dsh-plugin-hub

    bash

    复制代码
    # 指定特定分支 (main)
    dsh plugin --profile web add "github:dsh-external/dsh-agent-teams#main"
  4. 重启 DSH 服务

    安装完成后,必须重启 DSH 服务 才能生效。在运行 dsh web 的终端里按 Ctrl+C 停止,然后重新运行 dsh web 启动。

  5. 验证与使用

    服务重启后,刷新浏览器页面 (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:3080Ctrl + 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 :必须会 clonebranchcommitpushPR(Pull Request)。这是开源世界的"普通话"。

  • 看懂项目结构 :把你之前下载的 dsh-web-ui 源码文件夹拖进 VS Code 。看看 packages 目录下有哪些子包(比如 pet 宠物包、task-board 看板包)。

  • 改一行代码试试 :比如找到鲸鱼娘说话的文案(通常在 .vue.ts 文件里),把"你好"改成"大佬好",然后在本地上跑 pnpm builddsh plugin 重新加载。能改文案了,就离改逻辑不远了。

🔧 第 3 步:解决一个"新手友好"的 Issue(大二下学期)
  • 在 GitHub 上找带有 good first issue (好上手)或 help wanted(需要帮助)标签的问题。

  • 不看代码量,先看能不能读懂报错在哪里。比如插件里的"实时令牌统计"如果数字显示不对,你顺着 API 接口去查,可能就是改一行 toString() 的事。

  • 提交 PR:哪怕只是修了一个错别字,或者补充了 README 文档(英文/中文翻译),也算开源贡献。

🧠 第 4 步:成为"子包"维护者(大二升大三)
  • 当你能熟练改 Bug 后,可以尝试给 dsh-web-ui 写一个新的"皮肤"或小工具。

  • 利用 AI(比如 DeepSeek)帮你生成 Vue 组件的框架,你来调整布局和接口数据。写完挂在自己的 GitHub 上,给原作者提 PR 请求合并。

相关推荐
还不秃顶的计科生7 小时前
具身智能论文学习8:Octo: An Open-Source Generalist Robot Policy
人工智能·深度学习·学习·机器学习·语言模型·vla·vlm
武雄(小星Ai)7 小时前
Agent记忆系统工程排坑:从Prompt Cache被打碎到Embedding迁移数据税
ai·系统架构·agent·智能体·深度评测
woshihuanglaoshi7 小时前
事务加持防超卖:ArkTS 在鸿蒙里玩转 TRANSACTION 出入库
学习·华为·harmonyos
世人万千丶7 小时前
去重插入与超限淘汰:ArkTS 实现鸿蒙搜索历史的 LIMIT 艺术
运维·服务器·学习·华为·harmonyos·鸿蒙
燐妤8 小时前
梦绘片场 ProjectDream总览篇:从项目到成片的 AI 漫剧工作台
人工智能·ai·项目开发
2601_949950638 小时前
在线练题更方便,用练题簿打造属于自己的移动题库
学习·考研·刷题·小程序推荐
茫茫人海一粒沙9 小时前
Browser Automation for Coding Agents:六种架构方案深度对比
ai·架构
woshihuanglaoshi9 小时前
十二商品二十流水:鸿蒙进销存种子数据装满预警看板
学习·华为·harmonyos
MartinYeung510 小时前
[论文学习]ProAct:针对LLM越狱的主动防禦框架
网络·学习·安全
fthux10 小时前
装闭 RenoPit 源码解析(10):AI如何审查装修合同与报价单
人工智能·ai·开源·github·open source·renopit