◆ 博主名称 QuZhengRongAI俘虏样式苦手⭐️ LuckReport专栏 LuckReport⭐️ SpringBoot专栏 SpringBoot⭐️ SpringCloud专栏 SpringCloud目录一、安装 nvm 管理 Node 版本二、拉取源码三、安装依赖并启动项目四、配置 API Token五、安装插件六、LuckReport 项目推荐1、项目简介2、在线体验DeepSeek 最近开源了自己的官方 Agent 运行框架 DeepSeek Harness简称 dsh。它自带 Web 界面模型适配、文件编辑、命令执行这些能力都是插件可以自由替换。这篇文章介绍下怎么把这个 Agent 运行起来包括用 nvm 装 Node、代理拉源码、启动项目、配置 token 和安装插件。一、安装 nvm 管理 Node 版本1、Node 版本要求dsh 对 Node 版本有硬性要求package.json 里的 engines 约束是^22.19.0||24.0.0也就是 Node 22.19.0 及以上或者 24.0.0 及以上。我机器上原来装的是 Node 16启动直接报错装之前记得先看一眼版本。2、安装 nvm-windows为了不影响原有项目的 Node 版本我用 nvm 来做版本切换。Windows 上用的是 nvm-windows去发布页下载 nvm-setup.exenvm-windows releases如果 GitHub 下载慢同样可以在下载链接前面加上 gh-proxy 代理https://gh-proxy.com/https://github.com/coreybutler/nvm-windows/releases/download/v1.2.2/nvm-setup.exe安装一路下一步就行装完重开终端运行nvm -v能看到版本号就说明装好了。3、配置国内镜像可选但建议nvm 默认从 Node 官网下载安装包国内速度很慢建议先切到淘宝镜像# 配置 node 下载镜像解决 nvm install 卡住的问题nvm node_mirror https://npmmirror.com/mirrors/node/# 配置 npm 镜像nvm npm_mirror https://npmmirror.com/mirrors/npm/4、安装并切换 Node 版本# 安装 Node 22.19.0也可以直接 nvm install 24 装最新的nvminstall22.19.0# 切换到该版本会提示需要管理员权限用管理员身份打开终端即可nvm use22.19.0# 验证node-v# 输出 v22.19.0npm-v到这里 Node 环境就准备好了原来的旧版本也还在需要的时候nvm use 16就能切回去。二、拉取源码直接克隆 GitHub 仓库在国内经常卡住或者速度只有几 KB/s这里用 gh-proxy 做代理加速。用法很简单在原始 git 链接前面加上https://gh-proxy.com/就行# 原始地址https://github.com/deepseek-ai/deepseek-harness.git# 前面拼接 gh-proxy 代理地址即可加速gitclone https://gh-proxy.com/https://github.com/deepseek-ai/deepseek-harness.git实测走代理后几 MB/s很快就拉完了。进入项目目录cddeepseek-harness三、安装依赖并启动项目1、安装 pnpm源码构建需要 pnpm直接用 npm 全局安装# 全局安装 pnpmnpminstall-gpnpm# 验证能看到版本号就说明装好了pnpm-v2、安装依赖并构建# 安装依赖pnpminstall# 构建前端产物这一步不能省跳过会导致 Web 界面异常pnpmrun build3、启动项目# 源码模式启动 Web UIpnpmdsh web终端出现类似dsh web: http://127.0.0.1:3080的输出就说明启动成功了浏览器打开这个地址就能看到界面。四、配置 API Token启动 Agent 后还需要配置模型的 API Key。1、申请 Key打开 DeepSeek 开放平台登录后在 API Keys 页面创建一个密钥。注意密钥只在创建那一刻显示一次要马上复制保存下来。2、在界面里配置在 Web 界面左下角进入设置找到模型配置把 API Key 粘贴进去保存即可除了 DeepSeek 外你还可以添加其它模型如果遇到打开设置页提示 HTTP 403 的情况可能是浏览器启用了 Page Assist 插件禁用插件即可五、安装插件dsh 的设计就是万物皆插件官方只提供了一个基础界面功能扩展主要靠插件。插件安装用dsh plugin命令源码模式下在前面加pnpm就行# npm 包形式的插件源码模式下用 pnpm dshpnpmdsh plugin--profilewebaddnpm包名# 也可以直接从 GitHub 仓库安装pnpmdsh plugin--profilewebaddgithttps://github.com/作者/仓库.git# 查看已安装的插件pnpmdsh plugin--profileweb list# 添加一个皮肤插件pnpmdsh plugin--profilewebaddhttps://gh-proxy.org/https://github.com/kingOfSoySauce/dsh-liang-skin/releases/download/v0.1.4/dsh-client-liang-intensity-skin-0.1.4.tgz装完插件要重启pnpm dsh web并刷新页面才能生效然后在界面的设置里就能看到新装的插件六、LuckReport 项目推荐导航LuckReport专栏1、项目简介Luck-Report 是一款基于开源项目 UReport2 重构的 Java 高性能报表引擎通过迭代单元格可以实现任意复杂的中国式报表。相较于 UReport2Luck-Report 在技术架构上进行了全新升级后端基于 SpringBoot 框架开发、前端采用 Vue 框架构建技术选型贴合当下主流项目开发标准可精准适配各类实际开发需求。Luck-Report 提供了全新的基于网页的报表设计器可以在 Chrome、Firefox、Edge 等各种主流浏览器运行IE 浏览器除外。使用 Luck-Report打开浏览器即可完成各种复杂报表的设计制作。Luck-Report 基于 Apache-2.0 开源协议开源2、在线体验体验地址https://www.quzhe.top/luck-report/report/designer源码地址https://gitee.com/LuckyPools/luck-report文档地址https://www.quzhe.top/luck-report-blog/report