@walknpm/dsh-tutor-preset

DSH 学习助手 — Agent Preset 安装包

基于「DeepSeek Harness 快速入门实战公开课」学员资料包创建的 Agent Preset，配备 8 个课程 Skill 与 20 篇概念知识库。

包内容

dsh-tutor-preset/
├── README.md                         ← 本文件
├── install.sh                        ← 自动安装脚本
├── preset/
│   └── dsh-tutor/
│       ├── agent.cordis.yml          ← Preset 组合（persona + 全工具能力）
│       └── preset.yml               ← 界面元数据
├── skills/                           ← 8 个课程 Skill（复制到 $DSH_HOME/skills/）
│   ├── adopting-modlens-dsh-bundle/SKILL.md
│   ├── authoring-dsh-skills/SKILL.md
│   ├── bootstrapping-dsh-web/SKILL.md
│   ├── building-dsh-agent-presets/SKILL.md
│   ├── controlling-dsh-sessions/SKILL.md
│   ├── developing-dsh-tool-plugins/SKILL.md
│   ├── orchestrating-dsh-subagents/SKILL.md
│   └── packaging-dsh-web-bundles/SKILL.md
└── knowledge-base/                   ← 20 篇 DSH 概念知识库
    ├── index.md                      ← 概念导航入口
    └── wiki/                         ← 20 篇概念文章

8 个课程 Skill

Skill	能力域	用途
bootstrapping-dsh-web	安装与首次运行	从零启动 DSH Web UI 并双重验收
building-dsh-agent-presets	Agent 装配	创建可复用的自定义 Agent Preset
authoring-dsh-skills	能力开发	编写可发现、可调用的文件系统 Skill
controlling-dsh-sessions	Agent 装配	斜杠命令控制当前 Session 状态
developing-dsh-tool-plugins	插件工程	开发带配置的 Cordis Tool Plugin
packaging-dsh-web-bundles	插件工程	打包图片换肤 Bundle（Light/Dark）
orchestrating-dsh-subagents	Agent 装配	编排多个 Subagent 并汇总结果
adopting-modlens-dsh-bundle	第三方生态	安装验证 ModLens 视觉桥

快速安装

# 方式一：使用安装脚本（推荐）
tar xzf dsh-tutor-preset.tar.gz
cd dsh-tutor-preset
bash install.sh

# 方式二：手动安装
DSH_HOME="${DSH_HOME:-$HOME/.dsh}"

# 1. 安装 Preset
mkdir -p "$DSH_HOME/.agent-presets/dsh-tutor"
cp preset/dsh-tutor/* "$DSH_HOME/.agent-presets/dsh-tutor/"

# 2. 安装 Skills（用户级，Rank 400）
mkdir -p "$DSH_HOME/skills"
cp -r skills/* "$DSH_HOME/skills/"

# 3. （可选）将知识库放入工作区供 Agent 读取
#    persona 中引用的路径为：
#    DeepSeek-Harness快速入门实战-学员资料包/04-Agent知识库与Skills/knowledge-base/

验证安装

• 刷新 Agent Preset 列表，确认出现 DSH 学习助手
• 在空白 Session 中选择该 Preset
• 输入 / 确认 8 个课程 Skill 出现在斜杠菜单
• 发送自然任务（如"帮我创建一个自定义 Preset"），观察 Agent 是否先读取 Skill 和知识库再回答

Preset 能力清单

该 Preset 基于内置 standard 模式，保留全部工具能力：

• 文件：read / write / edit / glob / grep
• Shell：bash（macOS/Linux）/ pwsh（Windows）
• 后台任务：job_output / job_list / job_kill
• Skill：skill-filesystem + tool-skill（发现与加载）
• 目标：tool-goal（长任务跟踪）
• 计划：plan-mode（先审方案再执行）
• 压缩：compaction-basic + command-compact
• 子代理：subagent / subagent_fork / workflow / ralph
• Web：web_search（搜索）
• 其他：ask_user_question / todo_write

知识库说明

20 篇概念文章覆盖以下主题，Agent 可通过文件工具随时读取：

• 基础认知：模型-Agent-Harness 关系、DSH 定位、Plugin/Skill/MCP/Tool 职责
• 启动与状态：首次运行、连通证据链、工作区持久化、Session 命令
• Agent 装配：Agent Presets、Skill 发现、Subagent 运行时、项目指令
• 插件运行时：Cordis 生命周期、Tool 注册、Web Client 与主题
• Bundle 交付：打包、安装回卷、第三方评估
• 生态安全：ModLens 视觉桥

注意事项

• DSH 处于 Developer Preview，版本变化时应重新验证 Skill 和 Preset 兼容性
• 知识库路径在 persona 中为相对引用，需将知识库放入工作区或调整路径
• 不要直接修改内置 Preset 安装目录；始终在 $DSH_HOME/.agent-presets/ 下编辑