先理解它在哪一层#

大部分人把 AI 工具分成「聊天」和「编程」两类。DSH 属于第三类:工作台。

text
你说的那句话
   ↓
模型(决定「做什么」)
   ↓
DSH 的运行时(决定「能不能做」):工具、权限、会话、插件
   ↓
你的文件 / 终端 / 浏览器 / 外部服务

模型只是其中一层。真正让它和聊天框不同的是下面这层:它有一个受控的执行环境——能读文件、能跑命令、能调外部工具,但每一步都受权限策略管着。

这也意味着:配置的重点不是「填哪个模型」,而是「给它多大权限」。

装与第一次启动#

从官网下载安装包,装好打开。第一次启动会做三件事:

  1. 建配置目录 ~/.dsh/
  2. 起一个本地 Web 服务(地址形如 http://127.0.0.1:<端口>)
  3. 让你选模型 provider、填 key

注意那个端口:它不是公网服务,只监听本机。但也别把端口往公网映射——它没有为公网设计的鉴权。

验收:界面上能发一句话并收到回复。

三个目录,认识一下就够了#

text
~/.dsh/
  profiles/      一个 profile = 一套配置(模型、插件、技能、权限)
  sessions/      会话历史,按项目/时间分
  storages/      附件、缓存、运行产物
  credentials.yaml   凭据(权限 600,别外传)

最值得理解的是 profiles。里面每个子目录都有:

text
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 启动时会扫描技能目录,把它们列进可用列表。

一个技能的最小结构:

text
my-skill/
  SKILL.md

SKILL.md 头部是 YAML:

markdown
---
name: tidy-downloads
description: 把下载目录里的文件按类型归类,重复文件只留一份。
---

## 触发条件
用户说「整理下载目录」时。

## 步骤
1. 先列清单,不移动任何文件
2. 按扩展名分组,生成计划
3. 用户确认后再执行移动
4. 输出「移动了多少、跳过多少、哪些重名」

## 边界
- 不删除任何文件
- 不处理 .app 和安装包

注意最后那节「边界」——好的技能有一半篇幅在写「不做什么」。

装技能的常规做法是把文件夹放进技能目录,或用技能市场/命令行安装。装完在界面的技能列表里确认它出现了。

验收:技能列表里能看到它;用一句触发词,它按你写的步骤走,而不是自由发挥。

插件与 MCP:什么时候需要#

两个概念容易混:

插件(Plugin)MCP
是什么扩展 DSH 本身(界面、工具、面板)接外部服务(数据库、浏览器、第三方 API)
谁写通常是你或生态作者任何按 MCP 协议实现的服务
适合加一个新工具、新面板接已有的外部能力

先问自己:这个能力是「DSH 少个功能」还是「要连一个外部系统」? 前者插件,后者 MCP。

MCP 配置本质是一段 JSON,和 WorkBuddy 那篇 长得一样。一次加一个,通了再加。

验收清单#

七条都过,你才算真的把它配成了「工作台」,而不是「另一个聊天框」。

一句话总结#

DSH 的配置,八成是在划边界:能碰哪些文件、能跑哪些命令、什么时候必须问你。 边界划清楚了,剩下的才是模型的事。