☰
从装进 profile 到看见横栏:技能审计面板的落地步骤
2026/10/26 12:27:22 网站建设 项目流程

从装进 profile 到看见横栏:技能审计面板的落地步骤

这篇是给已经装好 DSH Desktop Beta、想把技能调用情况看清楚的人写的操作记录。整个流程只有一条命令加一次重启,但中间有几个地方会让人以为「没装上」。下面按顺序走。

开工前先确认三件事

第一,宿主是 DSH Desktop Beta,插件形态是 cordis 插件,不是通用 Node 库,装到别的运行时里没有意义。第二,Node 版本要 ≥20,这是包里的engines.node写的。第三,@deepseek-ai/dsh-llm和@deepseek-ai/schemastery这两个 peer 依赖标了 optional,由 DSH 运行时自己提供,不用手动装。

插件本体是dsh-echocat-skill-panel,npm 上的版本是 5.1.3,MIT 许可,运行时零依赖。本站的信任档位是「已验证」,依据是它在 dsh 0.2.1-rc.2 下真实安装成功过。

装进 profile:一条命令

打开终端,把插件加到 web 这个 profile:

dsh plugin --profile web add dsh-echocat-skill-panel

命令结束不等于面板出现。这一步必须紧接着重启 DSH Desktop Beta,否则你会在下一步卡住——原因写在后面的坑一里。

如果你更习惯翻清单挑插件,完整插件清单与汉化避坑指南 里有按分类整理的中文说明,安装命令可以直接照抄。

重启后应该看到什么

界面上的落点有三个,数据是同一份。输入框正上方多出一条横栏,只有一行结论和四个计数,点开才是完整报告;横栏是唯一能一键引用某个 skill 的地方。左栏新增一个图标,作为常驻入口。中栏面板给出完整报告和技能目录,适合一次把家底看完。

横栏宽度是从宿主输入框宽度推出来的,比输入框窄一点,跟输入框同一条中轴。如果它歪在一边或者压住输入框,基本可以判断宿主的版本与新插件不匹配。

核心功能:它凭什么比问模型准

统计来源是会话事件流,不是模型的自我汇报。所以模型自动调用的、你手动敲/名字触发的、一轮下来一个都没碰的,三种情形都会被如实记下来。最后一种尤其有用,它证明的是「这一轮确实不需要」,而不是「没采到数据」。

管理侧的功能集中在四件事:一键安装(认仓库主页、仓库内文件夹链接、SKILL.md链接、zip 直链、owner/repo、SSH 地址六种输入,也能上传.md/.zip或粘贴整篇SKILL.md);同名不静默覆盖,先备份再替换;删除进备份目录,永不硬删;中文显示名写进 skill 自己的meta.yaml的display-name-zh,而/名字手势仍走 ASCII 代号,两者互不干扰。

四个容易踩的地方

坑一 · 装完只刷新页面,面板不出现

现象:命令跑完,回到窗口只按了刷新(或者重开了页面),横栏和左栏图标都没出现。

原因:插件的 host 半侧在 boot 时把能力快照进内存,客户端 bundle 则是每次开页面才重新拉取。只刷新页面,更新到的只有客户端那半边,host 还停在旧快照上。

解决:装完直接重启 DSH Desktop Beta。这一点在文档里不算显眼,但它是唯一可靠的做法。

坑二 · 停用一个技能后,以为文件被删了

现象:在面板里点了停用,回到磁盘目录一看,那个 skill 的文件夹不见了,以为误删。

原因:停用的实现是把该目录移出 DSH 监视的 skills 目录,而不是改名或者打标记。这是有意的设计——模型是真的加载不到它,而不是「加载了再过滤掉」。

解决:理解这是「移出监视」而非删除,文件一个都没少;在面板里一键启用就会移回原位。

坑三 · 想更新某个技能,却找不到它的来源

现象:别人的卡片上有「可更新」,自己手工装的那几个没有,也不显示当前版本。

原因:来源记录从 4.0 起才写,位置在该 skill 自己的.echocat.json,内容包括地址、分支、子目录、安装时的 commit 和内容指纹。用 2.x / 3.0 装的、或者当时手工拷进来的,没有这条记录,插件自然无从比对。

解决:用卡片上的「标记来源」,填一次地址即可纳入更新。此后判断有无新版只跑一次git ls-remote,不会重新下载内容;来源固定在某个 commit 上时也不会被误报成「有新版」。如果这个 skill 的某些文件被你手改过,确认更新时文案会明说「更新会覆盖它们」。

坑四 · 背景图换了机器就回到默认

现象:本机设好的背景,换一台设备登录,还是默认样式。

原因:背景图与相关设置单独存在当前客户端的数据库里,不上传、不动 skill 数据、不碰宿主配置。设计上就只影响当前客户端。

解决:按「本机个性化」来用,不要当云同步。图片支持 JPG/PNG/WebP,上限 8 MB,会先在本机缩到长边 1920 以内。四类样式(液态、柔和渐变、纯色、本地图片)配六套低饱和预设,够用就好。

装完做三件小事验证

一是随便跑一轮不涉及技能的任务,看横栏是否如实报「一个都没调」,这能验证采集真的走的会话事件流而不是兜底猜测。二是点一次「检查更新」,确认「查不到」和「已是最新」是两句不同的话——它问的是 npm 与 GitHub 谁更新,有 10 分钟缓存,只有你点击才联网。三是手改一份 skill 文件再触发更新确认,看有没有覆盖提醒。

想把这些插件的安装形态横向对一遍,可以再回 完整插件清单与汉化避坑指南 按分类翻。

总结

一条dsh plugin --profile web add加一次重启就能跑通,真正花时间的是四个坑:重启、停用的语义、来源记录、背景不跨设备;想对照同类插件的中文清单与安装形态,见 完整插件清单与汉化避坑指南。

适合与不适合

适合:刚装完 DSH Desktop Beta、想确认技能有没有被用上的人;手里攒了一堆手写 SKILL.md 需要目录化管理的重度用户;要按 commit 固定来源、不想被误报新版的谨慎派;给同事做一次安装演示,需要一个能当场跑通的例子。
不适合:想统计 token 花费或做用量计费的;不用 DSH Desktop Beta、想找通用 Node 库的;要求插件每月都有新功能的——仓库最近一次提交在 31 天前,更新确实放缓了。

标签:技能调用审计面板、DeepSeek Harness、安装教程

本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询