本站的预设就是仓库里的 YAML 文件夹,位于 site repository. 没有账号系统、没有上传表单——提交即 Pull Request,像代码一样评审。
每个预设一个文件夹,放在 src/content/presets/ 下,以安装 slug 命名(小写、连字符、无空格):
src/content/presets/my-great-preset/
├── meta.yaml # site metadata (card, category, verification)
├── preset.yml # dsh display metadata (name + description)
└── agent.cordis.yml # the actual plugin wiring & persona meta.yamlname: My Great Preset
description: One crisp sentence — shown on cards and in the dsh picker.
order: 10 # picker sort; built-ins take 1–4
category: Coding # Coding | Review & Quality | Writing | Research | Data | Ops | Learning
tags: [python, cli] # lowercase, 2–4 of them
author: your-github-handle
mountedTools: [tool-fs, tool-bash] # row ids you actually mount in agent.cordis.yml
useCases: # 2–4 bullets: when should someone reach for this?
- Refactoring legacy Python CLIs
- Writing regression tests before touching code
highlights: # 1–3 things that make this preset different
- Refuses to edit files without a failing test first
verifiedVersion: 0.1.0-rc.7 # the dsh release you actually tested on
verifiedDate: "2026-08-18"
license: MIT preset.ymlname: My Great Preset
description: One crisp sentence for the dsh preset picker.
order: 10 agent.cordis.yml从内置预设复制一份起步(千万别直接改 standard——升级会覆盖),然后调整: Rows are id (local) + name (the real @deepseek-ai/dsh-* package) + optional config:
# My Great Preset — https://dshpresets.com/presets/my-great-preset
# Format matched to the built-in presets: apps/cli/config/agent-presets
# Rows your build actually boots: dsh --profile web --dump-config
- id: persona
name: '@deepseek-ai/dsh-persona'
config:
text: |-
You are a … (specific role, operating rules, refusals)
- id: tool-fs
name: '@deepseek-ai/dsh-tool-fs'
- id: tool-bash
name: '@deepseek-ai/dsh-tool-bash'
disabled: true # hard-disable: the tool is not mounted at all 预设拿到 verified 徽章之前,维护者会检查:
Fork 仓库,添加你的文件夹,跑 pnpm build 确认站点能构建,然后提交 PR 并附一段话:它做什么、你测试的 dsh 版本、以及一小段会话记录摘录。
dsh 处于开发者预览版,版本间会破坏插件 id。新版本发布后,维护者会重跑全部预设;未通过的会摘下 verified 徽章,直至修复。这份诚实正是本站存在的意义。