概览
dsh-skill-manager
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义;完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **项目根靠猜**:DSH 的 host 插件拿不到"当前会话的工作目录",只能拿进程 cwd 和 工作区账本。项目级 skill 因此可能比你预期多列或少列几个。 - **不改 provider**:禁用是写 frontmatter 标记,不是给 skill 系统加开关;正在跑的会话里 已经加载过的 skill 不受影响(目录会在下一次 provider 失效重扫后更新)。 - **标记禁用不释放名字**:注册表是 invocation-neutral 的,被标记的 skill 仍然占着这个名字, 同名且优先级更低的 skill 依旧会被它挡住;改名才会把名字让出来。 - **标记只能写在有 frontmatter 的文件上**,且 `SKILL.md` 必须可写(bundled 一律 403)。 - **删除就是删除**:`rm -rf` 掉 skill 目录,没有回收站。 - 预览只显示 `SKILL.md` 原文(不渲染 Markdown),够用来核对内容。 - 非 Windows 平台没有"打开目录",接口会返回 `revealed: false`。 - **符号链接不跟随**:`readdir` 的 `Dirent` 对 symlink / junction 既不报目录也不报文件, 所以链接形式的 skill 条目会被跳过(provider 是否跟随未验证,故不擅自扩大范围)。 - 扫描规则(平铺 `<name>.md`、`.system` 跳过、rank 数值)是与 `@deepseek-ai/dsh-skill-filesystem` **对齐的约定**,但该 provider 不在公共契约里, 升级 DSH 后值得重新核对一次。
