dsh-skill-manager

LIMITATIONS

Known limitations

- **项目根靠猜**：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 后值得重新核对一次。