跳到主要内容

dsh-swiss-army

已验证

dsh-swiss-army · v0.1.0 · MIT · Web 界面

DSH 开发常用功能插件(swiss-army)——宿主半侧初始化日志 + 浏览器半侧骨架(下一步向设置页注入功能标签页)

安装

dsh plugin add dsh-swiss-army

dsh --profile default --dump-config 确认 layer 已生效 —— 参见安装指南

源码

发布到 npm 但没有公开仓库。安装前请检查包内容。

标签

说明文档

dsh-swiss-army

DeepSeek Harness(DSH)开发常用功能插件 — Swiss Army Knife。官方没有的日常开发增强功能都放在这里。

安装后自动进入 profile 层栈(dsh.bundle.patch),无需手动改配置。

特性

  • 技能管理(设置 → 技能管理):官方没有 skill 管理 UI 与写接口,本插件补上完整的增删改查
    • 管理用户根$DSH_HOME/skills)与各项目工作区(官方 workspaceRegistry 列出的目录下的 .agents/skills),下拉框「全部 / 通用 / 项目…」切换
    • 编辑卡双视图:表单(description / whenToUse / 调用开关 / metadata / 正文)+ Markdown 原文(直接粘贴/导入整份 SKILL.md)
    • 删除确认弹窗、卡片内一键删除、编辑卡内联于选中卡片下方、创建时同名检测
    • 样式全程走官方主题 token(--dsw-alias-*),装任何主题插件自动跟随
  • Ctrl+Shift+S 全局快捷键:快速打开官方设置面板
  • 样式规范页(可选标签):展示官方 token 色值 / 文本层级 / 组件样张

安装

方式一:从 npm 安装(发布后)

dsh plugin --profile web add dsh-swiss-army

方式二:本地开发(link 方式)

dsh plugin --profile web add /绝对路径/to/dsh-swiss-army

安装后 重启 dsh web 生效。终端会出现初始化日志:

[dsh-swiss-army] plugin initialized — host half activated (id=swiss-army, verbose=true)

浏览器控制台:[dsh-swiss-army] client half loaded ...

使用

  1. 打开 DSH Web → 点击设置 / 快捷键 Ctrl+Shift+S
  2. 左侧导航出现 「技能管理」
  3. 下拉选「全部」跨来源看全部技能,或选「通用 / 某个项目」
  4. 点开技能 → 表单编辑;切「Markdown 原文」粘贴/导入完整 SKILL.md
  5. 卡片右侧 × 一键删除(有确认弹窗)

技能管理说明

范围 路径
通用(用户根) $DSH_HOME/skills
项目(各工作区) 官方 workspaceRegistry 的工作区目录 .agents/skills(目录白名单校验)
  • 写完后官方 skill-filesystem 的 watcher 会自动发现,无需重启
  • 新建走 lkebab-case 名校验 + 同名检测;frontmatter name 与路径不一致会拒绝
  • metadata 统一作为字符串 key-value 管理(不做数字/布尔等类型区分)

卸载

dsh plugin --profile web remove dsh-swiss-army

结构

dsh-swiss-army/
├── package.json         # dsh.bundle.patch → bundle;dsh.client → 浏览器半侧
├── cordis.patch.yml     # patch 层:把插件挂进配置树
├── lib/
│   ├── index.js         # 宿主半侧 Cordis 插件(注入 webServer / workspaceRegistry)
│   ├── skills-api.js    # 技能管理 REST API(列表/读/写/删,双来源,安全校验)
│   └── client.js        # 浏览器半侧:快捷键 + 技能管理标签页 + 样式规范页
└── README.md

开发提示

  • link: 安装时工作目录改动即时生效(刷新页面 / 重启 host)
  • 插件零外部运行依赖,registry 或 link 安装均可

License

MIT