十分钟讲清 dsh：讲稿与演示脚本

〇、时间轴总览The 10 Minutes

分享的成败在于听众散场时能否复述你的主线。这十分钟只押三句话：一切皆插件、能力可整体替换、日志是唯一事实源。

一、开场（0:00–1:00）Opening

二、三张图讲架构（1:00–5:00）Three Diagrams

每图约 80 秒。投屏直接开 L04、L05、L06 三页，或把图重画在白板上。

图 1 · 一切皆插件（插座板比喻）—— 回答"它的骨架长什么样"

台词："传统软件是『主机 + 外设』，核心功能焊死在主程序里；dsh 是一块插座板——你以为的『主体功能』全都以插头形式插在上面。拔掉 Web 界面插件，它就变成命令行工具；换掉模型插件，它就换了大脑。这就是『一切皆插件』。"

图 2 · turn/step 流程 —— 回答"一次干活长什么样"

台词："它不是一口气答完，而是走循环：思考 → 可能调工具 → 结果吃回来 → 再思考。一轮对话叫一个 turn，每次工具调用叫一个 step；AI 助手看似智能的多步操作，本质都是这个循环。"

图 3 · 能力缝三角色 —— 回答"为什么换实现这么容易"

台词："每项能力切成三个角色：定义契约的、提供实现的、消费使用的。契约稳定，实现随便换——今天命令在本地跑，明天换沙箱环境，换一个 Provider 插件就行，定义和工具都不用动。这就是『能力可整体替换』。"

三、演示主线（5:00–8:00）Live Demo

五步走，每步有台词。核心冲击点：给行驶中的车换零件——运行中的 dsh 加上新工具，模型立刻会用。

第 1 步 · 跑起来（约 30 秒）

pnpm dsh web

台词："这是完整的产品，Web 界面、模型、工具箱都在跑。"前提：演示前已完成 pnpm install && pnpm run build，现场不构建。

第 2 步 · 布置一个真实任务（约 60 秒）

在 Web UI 里问一个能展示多步工具调用的任务：

看一下这个仓库的 package.json，告诉我它叫什么名字、有哪些脚本命令

台词："注意左侧执行轨迹：先调工具读文件、再组织语言回答——就是图 2 的循环，每一步都看得见。"

第 3 步 · 现场写 20 行代码加一个工具（约 60 秒）

切到编辑器，在 scratch-plugin/src/my-plugin.ts 写下（或誊写备好的）工具：

import type { Context } from '@deepseek-ai/cordis'
import { defineTool } from '@deepseek-ai/dsh-tools'

export const name = 'lunch-plugin'
export const inject = ['tools']

const RESTAURANTS = ['兰州拉面', '沙县小吃', '食堂三楼', '楼下便利店']

export function apply(ctx: Context) {
  ctx.tools.register(defineTool({
    name: 'pick_lunch',
    description: '从公司楼下的餐厅列表里随机挑一家',
    parameters: {},
    output: { schema: { type: 'string' } },
    async execute() {
      return RESTAURANTS[Math.floor(Math.random() * RESTAURANTS.length)]
    },
  }))
}

台词（边写边说）："三件事：name 插件名，inject 声明用『工具注册表』服务，apply 注册 pick_lunch 工具。就这些——不改框架一行代码。"

第 4 步 · 挂载并热重载（约 30 秒）

补丁文件 scratch-plugin/cordis.yml（提前建好，现场只展示）：

- insert:
    - id: lunch
      name: '/绝对路径/scratch-plugin/src/my-plugin.ts'

pnpm dsh web --patch ./scratch-plugin/cordis.yml

台词："插件以『补丁层』叠在产品之上——产品一行没动。以后改代码保存即生效，不用重启。"

第 5 步 · 模型当场调用（约 40 秒，全场高潮）

在 Web UI 里问：

今天中午吃什么？帮我从公司楼下的餐厅里挑一家

台词："看——它自己发现并调用了新工具。这 20 行代码是五分钟前写的，模型清单里本来没有它。扩展 AI 的能力，和给浏览器装扩展一样简单。"

四、高频问题标准答案（8:00–10:00）FAQ Script

Q1："和 Claude Code / Codex 什么关系？"

Q2："能接我们公司自己的模型吗？"

Q3："稳定吗？能上生产吗？"

收尾一句话（照读）

五、演示前检查清单Pre-flight Checklist