插件脚手架模板 WODE25500/dsh-plugin-starter-zh

dsh-plugin-starter-zh

DeepSeek Harness 插件脚手架（中文注释版）—— 独立项目，非官方。
用于快速起步：一个可加载进 Web UI 的最小插件 + 一个带 schema 的工具示例。

快速开始

1. 在仓库检出根目录创建 scratch 项目（或复制本目录到 scratch-plugin）
mkdir -p scratch-plugin/src
cp -r src scratch-plugin/

2. 在 cordis.yml / profile 中注册插件（见下）
3. 启动 Web UI
npx @deepseek-ai/dsh web

注册插件

在 profile 的 cordis.yml 或 dsh.profile 引用的配置中加入：

plugins:
./src/my-plugin: {}

加载成功后控制台会打印 [my-plugin] 插件已加载。

目录结构

src/
my-plugin.ts # 最小插件：apply 函数 + 生命周期 hello-tool.ts # 工具示例：JSON Schema + 注册 settings-card.ts # 设置卡片示例（可选的 UI 能力）

说明

- 插件 = 导出 apply(ctx) 的 TS 模块；ctx 是 Cordis 上下文。
- 依赖在 apply 运行前就已就绪（如 ctx.model、ctx.sandbox）。
- 注册都是"可逆效果"：插件卸载时自动撤销。
- 更多内容见官方文档 Build a tool 与 Cordis 教程。

MIT License（示例代码，可自由使用）。