my-dsh-plugins

August 28, 2026 · View on GitHub

插件生态

个人 DSH(DeepSeek Harness)插件集合仓库:轻量多插件目录,每个插件位于 plugins/<name>/,自包含、可独立安装与发布。

dsh-file-activity 文件活动侧边栏 dsh-think-zh-expand 思考块渲染 dsh-mermaid-render 图表卡片 dsh-my-notify 通知提醒 toast dsh-task-reliability 任务可靠性面板
dsh-file-activity dsh-think-zh-expand dsh-mermaid-render dsh-my-notify dsh-task-reliability

插件列表

插件版本简介
dsh-file-activity0.5.1侧边栏文件活动页签:记录文件读取 / 新增 / 修改历史与统计,按文件夹树形展示,点击文件即浮窗预览(复用侧边栏内置渲染);按会话隔离、重启后恢复
dsh-think-zh-expand0.4.3思考增强:通过 system-prompt 注入让思考与回复强制使用中文;对话中思考内容默认展开显示(替代内置单行折叠),可点击收起、流式中保持展开;文本块与思考块都支持 Markdown 渲染(含表格 / Mermaid 图表);界面英文标签中文化
dsh-mermaid-render0.1.3对话 mermaid/mmd 代码块自动渲染为图表卡片(预览/代码切换),mermaid 引擎内联打包、零 CDN 依赖、完全离线可用;流式渲染稳健(等流式结束渲染,避免残缺态)
dsh-md-render0.1.1非思考模式 markdown 表格渲染增强:模型输出的表格(含无首尾管道符、分隔行变体等不标准格式)自动识别并渲染为表格(表头/边框/对齐),宽表格横向滚动;兼容 dsh-think-zh-expand(tzx-md 容器)与内置 MarkdownText(md-table-wide 容器),思考模式表格渲染不受影响
dsh-my-notify0.3.1通知提醒:会话结束 / agent 询问(ask)/ 等待审批时弹浏览器通知 + 滴声提示,点击通知跳转对应会话;预留远程 hook 触发接口(POST /notify/api/trigger,支持可选 token),SSE 实时通道
dsh-my-guardian0.3.1插件治理:新装/更新插件先进候选区(cordis.staged.json),启动完成后由守护插件逐个热挂载——成功自动转正,失败自动隔离记录,连续失败冻结,一键安全模式,侧边栏诊断面板;守护插件自身永不拖垮进程(看门狗自保)
dsh-task-reliability0.4.0任务可靠性保障:模型超时/请求失败自动重试、任务未完成自动继续(turn-stopping 注入)、独立完成度校验 agent(会话结束后判断,未完成唤醒继续)、思考重复检测与打断、休眠/重启后任务自动恢复、锁屏/休眠唤醒自动恢复(停滞看门狗)、ask 超时自动继续(问题记录待确认)、自主决策模式(出行防 ask 中断)、远程触发接口
dsh-my-skill-manager0.1.1Skill 管理:分「全局 / 项目」查看 skill 列表(名称/描述/来源/状态),按项目启用/禁用——禁用的 skill 不再注入该项目会话(模型不可见、不可加载);全局配置 $DSH_HOME,项目配置随仓库版本化;设置页面板(官方扩展点,纯官方依赖)
dsh-my-memory0.1.1记忆:全局/项目两级记忆持久化(全局 $DSH_HOME/memory.json + 项目 <项目根>/.dsh/memory.json),会话开始时全局记忆注入系统提示词(agent 始终携带关键偏好,条数/长度上限防膨胀);设置页面板(全局/项目分区 + 自定义确认 UI:删除红色、保存绿色,写操作必须用户确认);memory_query 只读查询工具
dsh-my-plugin-manager0.1.1公共插件管理面板:市场浏览/搜索(npm registry)、一键安装/卸载(dsh plugin CLI 同一数据源)、更新检查(pnpm outdated)、已安装插件清单(官方 pluginInventory + 版本);设置页面板(官方扩展点,纯官方依赖)
dsh-my-observability0.1.0可观测性 + Git 工程工具:事件审计(监听 agent/status、llm/stream、tools/*,agent 行为可追溯,按会话隔离、重启后恢复)、侧边栏轨迹回放时间轴面板、结构化 Git 类型化提交(Conventional Commits)、提交前增量 diff 审查(规则引擎 + 可选 AI 审查)
dsh-my-guard0.1.0安全护栏:执行前护栏(破坏性命令 rm -rf / 等执行前拦截/确认,observe/ask/deny 三模式)、安装前投毒扫描(dsh plugin add 自动扫描包内容:可疑脚本/密钥/恶意依赖告警)、提示注入检测(规则 + 启发式检测 prompt injection / jailbreak,命中告警);告警持久化 + 侧边栏安全护栏面板(确认机制)
dsh-my-context0.1.0上下文透镜 + 成本治理:token 用量可视化(每次请求的上下文构成、KV 缓存命中率,按会话隔离、重启后恢复)、每轮/每会话预算控制(token 上限,超限提醒/拦截,可配置)
dsh-plugin-dev-mode0.1.0插件开发模式 agent preset(非运行时插件):唯一启用 Cordis 工具集(cordis_inspect_*/define/run/stop/undefine)的 Agent 预设,精简工具组合 + 随包技能,一键安装到 $DSH_HOME/.agent-presets/
dsh-ts-example0.1.0TypeScript 插件开发示例(issue #47):server 端 TS 源码 + tsc 编译(lib/index.js 产物)、client 端 TS 源码 + 构建时编译(__ModuleLoader__ bundle)、CI 强制 tsc --noEmit 类型检查——编译期发现模块不存在(TS2307)/类型不匹配/未定义变量;新 TS 插件照抄本插件结构
dsh-shared0.1.0共享工具包(issue #45):多插件共用的 server 端工具——Host-header 信任围栏、HTTP JSON 读写、配置持久化(cordis.patch.yml)、项目根解析、异步与消息工具、原子写;依赖方在 peerDependencies 声明(依赖先发版)

目录结构

├── plugins/          # 所有插件(每目录一个自包含插件)
│   ├── dsh-file-activity/
│   ├── dsh-think-zh-expand/
│   ├── dsh-mermaid-render/
│   ├── dsh-md-render/
│   ├── dsh-my-notify/
│   ├── dsh-my-guardian/
│   ├── dsh-task-reliability/
│   ├── dsh-my-skill-manager/
│   ├── dsh-my-memory/
│   ├── dsh-my-plugin-manager/
│   ├── dsh-my-observability/
│   ├── dsh-my-guard/
│   ├── dsh-my-context/
│   ├── dsh-plugin-dev-mode/   # agent preset 资产包(非运行时插件)
│   └── dsh-ts-example/        # TypeScript 插件开发示例(issue #47)
├── skills/           # 本仓库的开发技能(SKILL.md 格式,可安装到 ~/.dsh/skills/)
│   └── dsh-plugin-development/
├── docs/             # 通用文档与设计文档
└── .github/workflows/  # CI(遍历插件测试)与 Release(tag 触发)

开发新插件

仓库内自带开发技能(SKILL.md 格式,安装方式见下):

# 将技能安装到个人技能目录(可选,便于 DSH 会话自动加载)
cp -r skills/dsh-plugin-development ~/.dsh/skills/
cp -r skills/dsh-issue-request ~/.dsh/skills/

新插件骨架:

  1. 按技能指引在 plugins/<新插件名>/ 下创建自包含插件包(package.json + cordis.patch.yml + lib/ + README + CHANGELOG + LICENSE)。
  2. 本地安装验证:dsh plugin --profile web add link:<本仓库绝对路径>/plugins/<新插件名>(对普通用户的安装方式见各插件 README「安装」章节:先 clone 仓库再 link)。
  3. 更新本 README 插件列表与 plugins/<新插件名>/README.md(中文 + 截图 + 生态 badge)。
  4. 发版:更新版本号与 CHANGELOG → 推送 tag <包名>@v<版本> → GitHub Actions 自动创建 Release。

发布约定

  • 双通道发布:GitHub Release(tag 触发自动打包)+ npm 官方 registryrelease.yml 读取仓库 NPM_TOKEN secret 自动 npm publish;未配置时仅警告跳过)。
  • 自动发版:仓库 Actions → Release (auto) workflow(选择插件 + bump 类型)→ 自动 bump 版本、生成 CHANGELOG(git log 提取)、打 tag → 触发自动发布 GitHub Release + npm。手动发版:node scripts/release.mjs <插件名> --bump patch --push
  • tag 格式:<包名>@v<版本>(如 dsh-file-activity@v0.1.0)。
  • 每个插件独立版本号(semver)、独立 CHANGELOG(Keep a Changelog 格式)。

许可

每个插件各自携带 MIT LICENSE;仓库级文档默认 MIT。