文章目录
- 1 先唠唠这项目的离谱开局
- 1.1 五万星的项目,README啥也不说
- 1.2 本质是个编码AI的万能底座
- 2 安装就两条路,按需自选不踩坑
- 2.1 懒人首选:npm一键安装
- 2.2 硬核玩家选:源码编译安装
- 3 打开界面先做这几步基础配置
- 3.1 先把API Key填上
- 3.2 语言先切中文,别硬撑
- 3.3 添加你的工作区
- 3.4 四种模式怎么选,给你翻译成人话
- 4 进阶玩法:装个插件秒变精装修
- 4.1 推荐个侧边栏增强插件
- 4.2 装完记得重启刷新
- 5 换模型比换外卖商家还简单
- 5.1 官方预设了一堆厂商
- 5.2 几个国产模型配置演示
- 5.2.1 智谱GLM
- 5.2.2 阿里千问
- 5.2.3 小米大模型
- 6 自定义模型怎么玩?拿火山方舟举个例子
- 6.1 基础信息别填错
- 6.2 模型列表别全加,挑常用的
- 6.3 发句话测一下通不通
- 7 最后唠两句
P.S. 无意间发现了一个巨牛的人工智能教程,非常通俗易懂,对AI感兴趣的朋友强烈推荐去看看, 传送门https://blog.csdn.net/HHX_01
1 先唠唠这项目的离谱开局
1.1 五万星的项目,README啥也不说
最近开源圈爆了个项目,叫deepseek‑harness,一天时间冲到五万多星。
我抱着好奇心点进仓库,人直接看傻了。README总共一千七百多字,没截图,没功能列表,连“这玩意儿到底能干啥”都没讲明白。
就甩了一句英文口号:Everything is a Plugin。
合着现在开源项目都走老板画饼路线是吧,口号喊得震天响,具体内容全靠用户自己悟。开周会都没这么抽象,至少老板还会画个饼的形状,这连饼皮都不给你看。
1.2 本质是个编码AI的万能底座
我折腾了一圈才搞懂,这东西本质就是个编码智能体框架。
所有能力全做成插件化,想加什么功能装插件就行,模型能换,界面能改,工具能加。
你就理解成编程界的乐高底座,底子给你铺好了,想拼坦克拼城堡全看你自己。
2 安装就两条路,按需自选不踩坑
2.1 懒人首选:npm一键安装
普通用户直接选这个就行,终端里敲一行命令:npx @deepseek‑ai/dsh web。
中途会弹个确认,问你要不要继续安装,输个y就完事。
说实话我每次看到这种确认都想笑,就跟装软件弹用户协议一样,你除了点同意还能咋地,总不能装到一半突然放弃吧。
装完自动启动本地服务,地址是 http://127.0.0.1:3080,浏览器打开就能进界面。
2.2 硬核玩家选:源码编译安装
喜欢折腾源码的朋友,也可以拉仓库自己编译。
流程就是标准的前端项目套路:clone仓库、装依赖、打包、启动服务。
适合想改源码、研究内部逻辑的朋友,纯体验的真没必要遭这个罪,一键安装香多了。
3 打开界面先做这几步基础配置
3.1 先把API Key填上
进页面第一件事,引导你填DeepSeek的API Key。
没有的去官网生成一个就行,这东西相当于入场门票,没它AI不给你干活。
暂时不想填的也能先跳过,不过早晚都得补,躲得了初一躲不了十五。
3.2 语言先切中文,别硬撑
左下角点Settings,找到Language选项,直接切中文。
别硬扛着看英文,本来配置项就够多了,再整个英语阅读理解,纯纯给自己加戏。
3.3 添加你的工作区
工作区说白了就是你要折腾的项目文件夹,选个本地目录加进去就行。
加完再选个模型,要速度选Flash,要效果选Pro,按需来。
3.4 四种模式怎么选,给你翻译成人话
官方给了四种Agent模式,新手看着头大,我给大家翻译一下:
标准模式:全能选手,写代码、改文件、跑命令、搜网页啥都能干,新手直接选这个准没错。
PTC模式:效率狂魔专属,模型不用来回点工具,直接写一段TS把多步操作串起来,五次往返收成一次,主打省时间省token。
极简模式:极简主义狂喜,就留终端和改文件俩功能,干净利落,啥花活都没有。
创造模式:高阶玩家玩法,能自己改Agent预设、写插件、折腾运行时,属于用框架改框架,自己套自己。
说直白点,这四个模式就像奶茶点单:标准是正常杯全糖,PTC是浓缩快取,极简是纯水无糖,创造是自己DIY小料随便加。
4 进阶玩法:装个插件秒变精装修
4.1 推荐个侧边栏增强插件
原生界面用着觉得别扭的,可以装个第三方插件DSH‑better‑sidebar。
拓展了右侧栏加底部面板,双工作台用着顺手很多。
原生界面就像毛坯房,能住但是没那么舒服,装个插件直接变精装修,体验感直接上一个台阶。
4.2 装完记得重启刷新
装完别傻等着界面自己变,得先重启DSH,再给页面来个硬刷新。
Windows按Ctrl+Shift+R,Mac按Cmd+Shift+R,不然缓存卡着,你装了等于白装。
5 换模型比换外卖商家还简单
5.1 官方预设了一堆厂商
这项目最爽的一点,就是不是只能用DeepSeek自己的模型。
设置里点“模型”,再点“添加提供方”,能看到一长串预设列表,国内外主流大模型厂商基本都在里面。
以前换个模型得改半天配置文件,现在跟外卖选商家似的,点一下填个密钥就完事,方便到离谱。
5.2 几个国产模型配置演示
给大家举几个常用的国产模型例子,照着填就行:
5.2.1 智谱GLM
提供方选 zai‑coding‑cn,把你的API Key填进去保存就搞定。
5.2.2 阿里千问
提供方选 qwen‑token‑plan‑cn,填密钥保存即可。
5.2.3 小米大模型
提供方选 xiaomi,填完密钥就能用。
配完回到首页,模型列表里直接就能选,亲测都能正常跑。
说个搞笑的,小米那个我第一次选模型还报错了,说不支持,换了个版本就好了,跟开盲盒似的。
6 自定义模型怎么玩?拿火山方舟举个例子
6.1 基础信息别填错
有些厂商不在预设列表里,就得自己加自定义提供方。
拿火山方舟举例,协议选OpenAI兼容的,API地址填对应的coding接口地址,再把API Key填上。
地址千万别填错,填错了要么连不上,要么计费出问题,别给自己找不必要的麻烦。
6.2 模型列表别全加,挑常用的
点“获取可用模型”,能正常拉出来列表,就说明基础配置没问题。
火山这模型列表是真夸张,一百多个,跟逛超市货架似的,一眼望不到头。
真心建议就挑几个常用的加上就行,别手贱全选。不然下拉菜单长得能拖到屏幕底,找个模型得翻半天,纯纯给自己增加工作量。
6.3 发句话测一下通不通
选好模型保存,回到会话里挑对应的模型,随便发句话试试。
能正常回复就说明搞定了,以后想加别的自定义模型,都是这个路子。
7 最后唠两句
折腾完一圈你就懂了,为啥这项目口号叫Everything is a Plugin。
模型是插件,功能是插件,连界面都能靠插件改,灵活度直接拉满。
说白了就是给所有编码AI搭了个统一操作台,不用再来回切工具,一个页面全搞定。
感兴趣的可以自己装上去玩玩,折腾技术的快乐,不就在于瞎鼓捣嘛。
P.S. 无意间发现了一个巨牛的人工智能教程,非常通俗易懂,对AI感兴趣的朋友强烈推荐去看看,传送门https://blog.csdn.net/HHX_01