DeepSeek Harness 插件

package

Matt Pocock 技能套件的 DSH 控制面板:右侧 details 列打开;含 wayfinder 决策地图、issue 行级 triage / 修复 / 讨论 / 执行按钮、9 项核心套件探测 + 20 个技能雷达、环境检查、跨会话 handoff 交接。

跳到安装方式

来源信息

GitHub 仓库
FeatherHunter/dsh-mattpocock-skills-deck
最近更新
2026年8月18日
分类
插件开发工具
GitHub stars
1

安装

默认先复制一段 Prompt,让 Agent 读页面和仓库;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读页面和仓库。

请先不要安装。阅读这个 DeepSeek Harness 插件,说明它解决什么问题、会访问哪些文件、网络或密钥,以及如何安装和卸载。

插件页面:https://deepseekplugins.org/zh/plugins/FeatherHunter/dsh-mattpocock-skills-deck~23package
GitHub:https://github.com/FeatherHunter/dsh-mattpocock-skills-deck/tree/main/package
插件名:dsh-mattpocock-skills-deck#package
作者:FeatherHunter
安装命令:dsh plugin --profile web add dsh-mattpocock-skills-deck

确认前不要执行安装命令。

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器2 个文件
README.md来源说明 · 只读预览

dsh-mattpocock-skills-deck

> DSH(DeepSeek Harness)Web 界面的 Matt Skills Deck 控制面板插件(Client + Host 双端)——非官方 Matt Pocock 技能套件(mattpocock/skills)配套工具:wayfinder 地图/票务/进度、triage / grilling / handoff 动作注入。 > 设计理念:Matt 的 map 拨开迷雾看到终点;本插件再加一层游戏式任务栏——接任务、推进一步、随时存档交接,每一步都清晰可见。 > 配合 Matt Pocock skills 的 wayfinder / triage / grilling / handoff 等技能使用: > 输入区状态栏胶囊(可接/阻塞/沉淀/交接/环境/更新)+ 右侧 details 列面板(列表 / 技能 / 环境检查三视图, > 唯一打开形式)+ GitHub issue 动作注入(诊断 / 修复 / 讨论 / 执行,均带 /wayfinder /triage 技能命令) > + 交接开新会话。

  • 插件包名: dsh-mattpocock-skills-deck(可分发 npm 包,见 package/,当前 v1.0.0(品牌迁移自 dsh-waystation v1.5.0):v1.4 详情页(#441)+ v1.5 升级 map 全量落地 —— 状态栏 BUG/诊断过滤 + 设置直达 + 删 panelHeight + Matt 引导 + 新增 wayfinder + 仓库身份 + 双语 + 仓库级缓存架构(git 根检测 → 磁盘缓存秒开 → 自动探测刷新)+ 进度契约与阶段闸门 + 正文格式容错 + markdown 白名单渲染 + 3 项 bug 修复 + T10 自动刷新机制(变化行高亮/即时转圈反馈))
  • 动态版 pluginId: wfst-1(v9–v24 迭代产物)
  • 平台: Client(浏览器页面)+ Host(Node 进程,gh CLI 数据层)
  • 配套: mattpocock/skills(wayfinder / triage / grilling / handoff / ask-matt 等)
  • 两种形态: ① 正式安装(npm 一条命令,开机自启,推荐);② 动态加载(进程内,会话级)

功能

模块说明
状态栏胶囊输入区上方:可接 / 阻塞 / 沉淀(零丢失快照)/ 交接 / 环境 / 更新,点击直达对应面板视图
面板 · 列表GitHub issue 全列表(map 置顶 + 子票迷你圆环进度)、标签过滤 chips(GitHub 配置色)、阻塞筛选、已关闭折叠、行级动作按钮;行布局 = 两行结构(编号/map 竖排 + 标题占满整宽限 2 行 + 标签/按钮行)
标签贪心折叠单行不换行:宽面板显示多标签、窄面板少标签(最少 1 个),放不下的折叠为 +N 弹窗(fixed 定位 · 自适应面板左右边界 · 内容完整可见)
进度显示map 行右侧 18px 迷你圆环 + n/total(等宽数字右缘对齐,圆环零间隙)
面板 · 技能技能雷达(推荐 / 列表 / 圆环),点击注入 /skill
面板 · 环境检查8 项前置检查(仓库定位 / setup / tracker / gh CLI / 登录 / API / 技能探测),红黄绿分组 + 一键处理
tabs 行列表 / 技能 / 环境检查 + 右侧刷新按钮 + 最右侧版本号(如 v1.3.3),便于核对已更新
行级动作按 label 四选一:诊断(/triage) / 修复(/wayfinder) / 讨论(/wayfinder) / 执行(/wayfinder),按钮色 = GitHub label 配置色,点击预填输入框;执行/新会话按钮常显(复制/外链也常显)
map 详情顶部「执行」+ 任务按状态动作、可接/已认领/被阻塞/已关闭垂直走廊、Decision/Fog/Out-of-scope 折叠
交接第一击注入 /handoff 时间戳模板;第二击预填 /read + 复述确认 prompt 并开新会话
统一引导句动作注入统一带「从第一性原理出发完成任务,并对抗式审查。」

使用方式

第 0 步:安装 DSH CLI(仅首次 · 一次性)

DSH CLI 提供 dsh 命令行工具(用于安装/更新/卸载插件、查看 DSH 状态)。 本插件的安装/更新/卸载都通过 dsh 命令完成。

推荐一 · npm 全局安装(最常用)

npm install -g @deepseek-ai/dsh

验证安装成功:

dsh --version
# 期望输出类似 dsh@1.0.x 或更新版本

⚠️ 如果 dsh 命令找不到(PATH 未配置):

  • Windows:npm 会自动把全局 bin 加到 %APPDATA%\npm,重启 cmd/终端即可
  • macOS / Linux:可能需要手动加 $(npm config get prefix)/bin~/.bashrc~/.zshrc

推荐二 · 不装 CLI,用 npx 临时跑(不需要全局装)

npx --yes @deepseek-ai/dsh --version

npx --yes @deepseek-ai/dsh 等价于 dsh(每次首次会缓存包)。

方式一:正式安装(推荐 · 一条命令 · 装进整个 Harness · 开机自启)

用 DSH CLI(dsh)或 npx 临时命令(跨平台,Windows / macOS / Linux 同一句; ~/.dsh = DSH 的家,DSH_HOME 自定义过就换成它的路径):

前置推荐(可选但强烈建议 · 已装可跳过)——dsh-better-sidebar:VSCode 风右侧边栏,面板在侧边栏并排打开效果最好;不装则回退到右侧 details 列打开。

dsh plugin --profile web add dsh-better-sidebar

安装(已装过 DSH CLI)

dsh plugin --profile web add dsh-mattpocock-skills-deck

安装(未装 DSH CLI,用 npx)

npx --yes @deepseek-ai/dsh plugin --profile web add dsh-mattpocock-skills-deck

或者:把安装交给你的 AI(复制下面提示词发给 AI,它会读仓库、检查环境、按需安装,已装步骤自动跳过):

请帮我安装 DeepSeek Harness 插件 dsh-mattpocock-skills-deck(MattSkills)。
先读仓库 README:https://github.com/FeatherHunter/dsh-mattpocock-skills-deck
然后自行检查环境并按需安装(已装的跳过),完成后简要汇报结果。
  • 命令把插件装进 web profile~/.dsh/profiles/web/node_modules),同步 web/package.json

并自动 reconcile 注册(bundle 装配)。装完刷新浏览器页面(http://127.0.0.1:3080)即生效,之后每次 DSH 启动自动加载。

  • 一键装完即用(bundle 装配):本包声明 dsh.bundle.patch(包根 cordis.patch.yml),

dsh plugin add 自动把包加入 profile 的 dsh.profile.bundles,启动时 loadProfile 自动应用—— 无构建脚本(pnpm v10 不再拦截),无需手动编辑任何文件;dsh plugin remove 自动移除。

  • 千万不要用 npm install --prefix ~/.dsh/profiles 安装profiles/node_modules 是 DSH 的

扁平回退软链区(启动时 healProfilesModuleFallback 自动重建,装的是 npx 全家桶), npm --prefix 会把它当新项目,把 package.json 未声明的包(含你的插件)全部 prune 掉2026-08-14 实测事故:一次安装插件连带删掉 511 个包,DSH 插件全部加载失败。 插件正确安装位 = profiles/web/node_modules(官方命令负责),注册写 web/cordis.patch.yml

  • 为什么不用 npm install -g-g 装到 %APPDATA%\npm\node_modules,而 Node 的默认解析链

不包含该目录(本机实测 require.resolve 失败)——DSH 进程 require 不到,装了也白装。 独立 CLI 应用(如 dsh-feishu-bot)靠 bin 快捷方式运行所以能 -g插件必须被 DSH 进程 解析,所以装 Harness 自己的 profile。

升级

dsh plugin --profile web update dsh-mattpocock-skills-deck
# 或用 npx:npx --yes @deepseek-ai/dsh plugin --profile web update dsh-mattpocock-skills-deck

卸载

dsh plugin --profile web remove dsh-mattpocock-skills-deck
# 或用 npx:npx --yes @deepseek-ai/dsh plugin --profile web remove dsh-mattpocock-skills-deck
# 并手动删除 cordis.patch.yml 里的 dsh-mattpocock-skills-deck insert 块(或保留,DSH 找不到包会忽略)

> 原理:DSH 的 dsh.client 插件机制(dsh-client-modules)会扫描组合里声明了 > dsh.client: { platform: 'web' } 的包,把 exports["./client"] 指向的 bundle > 伺服为 /plugins/<id>/client.js 并注入 window.__DSH_BOOT__,浏览器内核在启动 > 时自动挂载该插件条目。宿主半 lib/index.js 通过 ctx.connection.rpc 注册 > /dsws RPC 通道(gh CLI 数据层),Client 半经同一通道取数。

方式二:动态加载(零安装 · 会话级 · 重启失效)

在 DSH 会话中由 Agent 通过 Cordis 工具链加载:

1. cordis_define —— plugin 用 kind: newidPrefix: wfst,code.host 填入 [host.js](./host.js) 的内容、code.client 填入 [client.js](./client.js) 的内容。 2. cordis_run —— 首次运行需在界面批准(安全机制,Client 代码要在页面执行)。 3. 生效后输入区出现 Matt Skills Deck 胶囊;Run 卡片内出现控制面板。

数据层说明(宿主半)

  • 依赖:gh CLI(兜底路径 DSH_GH_PATH 环境变量(未设置时走系统 gh))+ git 仓库工作目录(默认

D:\2Study\StudyNotes\SKILLS,可随会话 cwd 切换)。

  • 数据流:gh issue list 枚举全量 issues(map 列表从中过滤 wayfinder:map)→ GraphQL aliases 一次查询全部 map 详情(subIssues + labels + assignees + blockedBy)→ 组装快照(map 五区块解析 + tickets + stats)。
  • RPC 通道 /dswsstatus / snapshot / refresh / cwd / handoffLatest / claim
  • 刷新策略:纯手动(状态栏「更新」/ 列表「刷新」/ 打开面板即刷)+ 60s 快照缓存、30s 环境检查缓存。
  • 性能:v1.3.3 起快照加载 ~35s → ~12s(aliases 批量 8 次 GraphQL → 1 次)。

作者的其他作品

喜欢这个插件的话,这些可能你也用得上:

  • dsh-opencode-palette —— 喜欢 opencode 的配色?让 DSH 也穿上它 —— 34 款经典主题,眼睛舒服了,码字也开心。
  • dsh-prompt —— 写 Prompt 卡壳的时候,里面有 24 条深度模板,点一下直接进输入框。

v1.3.3 新增(2026-08-15)

  • 13 项用户 bug 修复(配置面板全展开 / textarea 自适应 / 占用→阻塞 / 按钮常显 / map 完成态 / 双 loading 修复等)
  • UI 逐版定稿:C 卡片式两行结构、编号/map 竖排、18px 迷你圆环进度、标签贪心折叠 +N 弹窗(自适应面板)、窄屏按钮正方形
  • tabs 行刷新按钮 + 最右侧版本号 v1.3.3
  • 快照性能提速 ~35s → ~12s(GraphQL aliases 批量 + 合并 fetchMaps + 缓存 60s)
  • 开发工作流文档 DEV-WORKFLOW.md(改 bug → 实时生效完整流程)

v1.5.0 新增(2026-08-16/17)

  • 状态栏「BUG / 诊断」一键过滤(带计数)+ 设置左侧直达 + 删「面板默认高度」
  • Matt 技能安装引导(设置页 + 环境检查页)+「新增 wayfinder」按钮(prompt 带仓库信息)+ 仓库身份组件
  • 全量中英双语 + 进度契约(## 进度:N%)与阶段闸门(needs-triage 前置诊断)
  • 仓库级缓存数据架构:git 根上溯检测 → 宿主磁盘缓存 → 打开/重启秒开 → 自动探测刷新(probe + 轮询 + focus + 动作后)
  • 正文格式容错自愈(字面 \n + BOM 还原)+ 正文格式契约 + issue 正文 markdown 白名单渲染
  • 3 项 bug 修复(setup 误报 / 新会话 prompt 缺 issue 标识 / 完成态按钮配色)+ 手动刷新去遮罩(按钮即时转圈反馈 · 文字恒定)+ 变化行高亮/新增绿闪/删除提示

完整变更历史见 [CHANGELOG.md](./CHANGELOG.md)。

文件

  • host.js / client.js —— 动态版源码(cordis_define 的 code.host / code.client 函数体)
  • package/ —— 可分发插件包(正式安装用,标准 npm 包结构)

- package.json —— 包声明:dsh.client(platform web / immediately)+ dsh.bundle.patch(装配) - cordis.patch.yml —— bundle 装配 patch(dsh plugin add 自动应用,无构建脚本) - lib/index.js —— 宿主半(ESM:gh 数据层 + /dsws RPC 通道注册) - lib/client.js —— 浏览器半 bundle(window.__ModuleLoader__.load 注册格式)

  • README.md —— 本说明
  • issues-checklist.html —— 迭代需求清单(v9–v24,43+ 项)
  • DESIGN.md / prototype.html —— 设计定稿与原型
  • tests/ —— host 逻辑测试(verify-status / verify-panel)

备注

  • 若动态版(方式二)与正式安装版同时生效,两套 UI 会同时出现(同名插槽注册),

建议保留正式安装版即可,动态版 cordis_stop 掉。

  • 本插件需要 GitHub 仓库工作目录(wayfinder 地图仓库)才能取到数据;

非仓库目录下环境检查会提示「仓库定位」未就绪。

  • 用户界面偏好(开始模板等)存浏览器 localStorage,与动态版共用同一 key。