全部教程
本页目录
先理解它在哪一层#
大部分人把 AI 工具分成「聊天」和「编程」两类。DSH 属于第三类:工作台。
你说的那句话
↓
模型(决定「做什么」)
↓
DSH 的运行时(决定「能不能做」):工具、权限、会话、插件
↓
你的文件 / 终端 / 浏览器 / 外部服务模型只是其中一层。真正让它和聊天框不同的是下面这层:它有一个受控的执行环境——能读文件、能跑命令、能调外部工具,但每一步都受权限策略管着。
这也意味着:配置的重点不是「填哪个模型」,而是「给它多大权限」。
装与第一次启动#
从官网下载安装包,装好打开。第一次启动会做三件事:
- 建配置目录
~/.dsh/ - 起一个本地 Web 服务(地址形如
http://127.0.0.1:<端口>) - 让你选模型 provider、填 key
注意那个端口:它不是公网服务,只监听本机。但也别把端口往公网映射——它没有为公网设计的鉴权。
验收:界面上能发一句话并收到回复。
三个目录,认识一下就够了#
~/.dsh/
profiles/ 一个 profile = 一套配置(模型、插件、技能、权限)
sessions/ 会话历史,按项目/时间分
storages/ 附件、缓存、运行产物
credentials.yaml 凭据(权限 600,别外传)最值得理解的是 profiles。里面每个子目录都有:
profiles/<名字>/
cordis.yml 这个 profile 的插件组合
cordis.patch.yml 你的本地覆盖(升级不丢)
package.json 依赖关键规矩:改配置优先改 cordis.patch.yml,不要直接改 cordis.yml。 前者是你的,后者是模板,升级时会被覆盖。
接模型:走中转站最省事#
在设置里选 provider,填三样:接口地址、key、模型名。和 诸葛接入那篇 完全一样。
如果你用的是本机环境变量,注意 DSH 是桌面应用,它不读你 .zshrc 里的变量。要么在设置界面里填,要么用它的凭据文件——别指望 shell 环境变量能透进去。
一个常见误解
「我在终端里 export 了 key,为什么应用里还是没生效?」 因为 GUI 应用不继承终端的环境变量。这是 macOS 的常规行为,不是 bug。
验收:设置里能看到模型列表,选中后能对话;重启应用后配置还在。
Profile:一个身份一套配置#
这是 DSH 最值得学的设计。默认有一个 desktop,你还可以有 qqbot 之类。
为什么要分开:
| 场景 | 该给的权限 | 不该给的 |
|---|---|---|
| 桌面工作台 | 读写工作目录、跑命令 | 读整个硬盘 |
| QQ 群机器人 | 只读知识库、发消息 | 跑命令、删文件 |
| 定时任务 | 特定脚本 | 交互式工具 |
把「聊天用的」和「能删文件的」混在一个 profile 里,是事故的起点。
新建 profile 的方式在设置界面里,建完它就是一个独立目录。切换 profile 等于切换一整套配置——包括模型、插件、权限。
验收:建一个第二 profile,确认它的会话和第一个互不可见。
审批策略:ask 还是 never#
这是全篇最重要的一节。
DSH 在执行有副作用的操作前,会按策略决定「先问你」还是「直接做」:
| 策略 | 行为 | 什么时候用 |
|---|---|---|
ask | 每次危险操作前弹确认 | 默认。处理真实文件时用这个 |
never | 不问,直接执行 | 只在你完全信任任务范围时用 |
never 不是「更高级」,它是关掉了最后一道保险。什么时候可以开:
- 任务范围被严格限定在一个临时目录里
- 你已经跑过一遍,知道它会做什么
- 有备份,且失败了能重来
什么时候绝对不要开:
- 在存着重要资料的目录里
- 让它「整理一下硬盘」这种没边界的任务
- 连着生产环境的机器
红线
不要为了「少点几次确认」把策略设成 never,然后把整个家目录交给它。自动化省下的时间,不够恢复一次误删。
技能:装一个就多一项能力#
技能是一份写给模型的说明书:什么时候用、按什么步骤做、怎么算做完。DSH 启动时会扫描技能目录,把它们列进可用列表。
一个技能的最小结构:
my-skill/
SKILL.mdSKILL.md 头部是 YAML:
---
name: tidy-downloads
description: 把下载目录里的文件按类型归类,重复文件只留一份。
---
## 触发条件
用户说「整理下载目录」时。
## 步骤
1. 先列清单,不移动任何文件
2. 按扩展名分组,生成计划
3. 用户确认后再执行移动
4. 输出「移动了多少、跳过多少、哪些重名」
## 边界
- 不删除任何文件
- 不处理 .app 和安装包注意最后那节「边界」——好的技能有一半篇幅在写「不做什么」。
装技能的常规做法是把文件夹放进技能目录,或用技能市场/命令行安装。装完在界面的技能列表里确认它出现了。
验收:技能列表里能看到它;用一句触发词,它按你写的步骤走,而不是自由发挥。
插件与 MCP:什么时候需要#
两个概念容易混:
| 插件(Plugin) | MCP | |
|---|---|---|
| 是什么 | 扩展 DSH 本身(界面、工具、面板) | 接外部服务(数据库、浏览器、第三方 API) |
| 谁写 | 通常是你或生态作者 | 任何按 MCP 协议实现的服务 |
| 适合 | 加一个新工具、新面板 | 接已有的外部能力 |
先问自己:这个能力是「DSH 少个功能」还是「要连一个外部系统」? 前者插件,后者 MCP。
MCP 配置本质是一段 JSON,和 WorkBuddy 那篇 长得一样。一次加一个,通了再加。
验收清单#
七条都过,你才算真的把它配成了「工作台」,而不是「另一个聊天框」。
一句话总结#
DSH 的配置,八成是在划边界:能碰哪些文件、能跑哪些命令、什么时候必须问你。 边界划清楚了,剩下的才是模型的事。