dsh-plugins

English | 中文

DeepSeek Harness (DSH) 原生插件集合。每个插件是一个独立目录，通过 dsh web --patch 以 cordis 插件形式加载，不修改 DSH 本体。

插件列表

插件	功能	文档
dsh-cron-loop	项目级 cron 定时任务：/cron 命令 + cron_job 工具 + http://127.0.0.1:3080/cron 任务中心	README

新增插件时在此表格追加一行，并在插件目录内放置 README.md。

什么是 DSH 插件

DSH 插件是 cordis 插件，通过 dsh web --patch <file> 叠加到 web profile 上，不侵入 DSH 核心。插件用公开 Service（webServer/agents/commands/timer 等）+ 直接文件 IO 实现能力。

flowchart LR
  User["dsh web --patch"] --> Profile["~/.dsh/profiles/web"]
  Profile --> Bundle["base bundles"]
  Patch["插件 cordis.patch.yml"] --> Profile
  Profile --> App["DSH Web 服务 :3080"]
  App -.加载.-> Plugin["插件（insert 列表）"]

通用安装方式

1. 确保已安装 DSH（npm i -g @deepseek-ai/dsh 或 npx）与 pnpm ≥ 10、Node.js ≥ 22。
2. 克隆本仓库：git clone https://github.com/CaffeineOddity/dsh-plugins.git
3. 进入目标插件目录安装依赖：cd dsh-<name> && pnpm install
4. 编辑插件的 cordis.patch.yml，把绝对路径替换为你的实际克隆路径（patch 的相对路径相对 ~/.dsh/profiles/web 解析）。
5. 启动：dsh web --patch ./cordis.patch.yml（部分插件提供 pnpm dev 封装此命令）。

各插件的具体用法见其目录内的 README.md。

约定

• 每个插件独立目录，自含 package.json / tsconfig.json / cordis.patch.yml。
• 设计 spec 放 specs/，遵循 SDD（spec 是需求单一事实来源）。
• 主 README 只写功能简介 + 安装使用；开发细节用相对链接指向 spec/docs。
• 双语：中文 README.md 为主，英文 README.en.md 同步，顶部互链。

License

MIT