dsh-skill-status
中文 | English
DeepSeek Harness（DSH）的会话技能状态插件。在会话标题栏显示已确认加载的技能数量，点击「技能」打开右侧面板，查看完整正文是否仍在当前主助手上下文中，以及各次加载的正文版本与来源。
功能
- 合并当前技能目录与历史正式加载记录，支持按名称或说明筛选。
- 已加载的技能排在列表前面，同组内按名称排序。
- 识别
/技能名 和 skill 工具的正式加载记录，核对主正文是否完整保留。
- 查看历史正文版本、加载次数和加载时的资源指引；同一技能的多个版本只计数一次。
- 分别展示加载时的来源与当前目录来源；源文件后续修改不会覆盖历史正文。
- 随会话事件更新状态，安静期间每五秒复查目录和文件状态。
插件只查询当前主助手的技能状态，不提供加载、重载、卸载技能或修改会话内容的操作。
安装
在 DSH 的 Web profile 中直接从 GitHub 安装：
dsh plugin --profile web add github:yuhhhong/dsh-skill-status
安装完成后重启 DSH，并刷新 DSH 页面。打开已有会话，点击会话标题栏右侧的「技能」入口，即可查看当前会话的技能状态。
如需卸载：
dsh plugin --profile web remove dsh-skill-status
当前插件版本为 0.1.3，适配 DSH 0.1.7-rc.2。
状态含义
| 状态 | 含义 |
|---|
| 已加载 | 至少一个正式加载版本的完整主正文仍在当前上下文中 |
| 未检测到加载 | 可核实历史中没有正式入口成功加载的记录 |
| 完整正文不在上下文 | 已确认曾加载，但当前所有可核实版本的主正文都不完整或已移除 |
| 无法确认 | 历史、正文或当前上下文的证据不足 |
标题中的 … 表示尚未收到结果，? 表示查询失败或仍有无法确认的范围。2 · ? 表示已确认加载两个技能，但并非全部状态都已核实。
普通文件读取不算正式加载证据。压缩摘要提到技能名字或曾经加载成功，都不能单独证明完整正文仍在上下文中。技能引用的资料是否被读取，不影响主正文的完整性判断。
加载记录中的资源指引不一定包含准确的源文件路径。只有当前技能目录提供明确路径时，插件才核查文件是否存在；该结果展示在「当前目录来源」下。
本地开发
安装依赖后可运行语法检查和测试。
pnpm run check
pnpm test
pnpm test 会先构建，再运行测试。pnpm pack 也会通过 prepack 自动构建。构建本项目不会自行更新正在运行的 DSH 页面。
lib/ 的构建产物随仓库提交，请勿删除或忽略。pnpm 安装 git 来源的依赖时，会检查 main 指向的 lib/index.js 是否存在：不存在就判定该包需要执行构建脚本，从而要求 allowBuilds 授权；存在则直接跳过构建阶段。因此保留 lib/ 是从 GitHub 安装无需构建授权的前提，prepack 仍然保留，用于发布 npm 包时重新构建。
改动 src/ 后请运行 pnpm run build 并提交更新后的 lib/。测试会比对 lib/ 与当前源码的构建结果，产物过期时会失败。
项目关闭自动补装 peer 依赖，DSH 宿主由目标运行环境提供。兼容版本以包清单中的 peerDependencies 为准。
发布
推送 v 前缀标签即触发发布工作流：核对标签与包版本、提取发布说明、检查已提交产物、运行语法检查与测试，全部通过后自动创建 GitHub Release。不附带压缩包。
发布前先在更新日志写入该版本的段落，再提交 lib/ 并推送标签。标签与 package.json 版本不一致，或更新日志缺少该版本段落时，工作流会在发布前失败。
git tag -a v0.1.3 -m "发布 v0.1.3"
git push origin v0.1.3
项目文档
许可证
本项目采用 MIT 许可证，Copyright (c) 2026 yuhong。
