@sidleo3/skill-filesystem-plus
English | 中文
A configurable skill discovery provider for DeepSeek Harness (DSH). It replaces the fixed discovery of the built-in `dsh-skill-filesystem` with editable scan layers and parent directories — but only in presets you explicitly enable in the GUI.
Renamed from `@sidleo3/skill-scan`; the GitHub repository `sidleo/skill-scan` is now `sidleo/skill-filesystem-plus`. Your old config (`~/.dsh/dsh-skill-scan.json`) is migrated automatically.
Core design
- Install = no-op: installing the plugin changes nothing — no preset is copied or modified, and the built-in `skill-filesystem` keeps working
- You decide the scope: enable takeover per preset in the Web GUI (Settings → Plugins → 技能扫描)
- Full replacement: for an enabled preset, its `skill-filesystem` row is `disabled` and a `/preset` provider row takes over; unselected presets keep built-in behavior untouched
- Removal restores: unchecking restores the original preset from a backup, and `skill-filesystem` resumes
- Card survives DSH upgrades: the host registers the `skill-filesystem-plus` settings namespace — the modern Settings "configurable plugins" page renders only cards whose namespace the host serves, which is the root cause of cards disappearing after DSH upgrades
Features
- Four scanning layers: cwd (highest) → project/parents (mutually exclusive) → global (lowest)
- scanParents mode: walk every ancestor from cwd upward — no depth limit
- Editable parent dirs: default `.dsh`, `.agents`; add/remove/rename freely, drag to reorder (top = highest priority)
- Web GUI card: Settings → Plugins → 技能扫描 — per-preset takeover + four-layer scan config + root preview
- Live invalidation: a model `write`/`edit` touching a `<…>/skills/` path invalidates the catalog immediately
Installation
```bash
From npm (recommended)
dsh plugin --profile web add @sidleo3/skill-filesystem-plus
From a local checkout (development)
dsh plugin --profile web add link:/path/to/skill-filesystem-plus
```
Restart DSH after installing. No further action needed — the plugin touches no preset and the built-in skill-filesystem keeps working.
Usage: enable per preset in the GUI
- Open Settings → Plugins → 技能扫描
- Check the presets to take over (multi-select; only presets carrying a `skill-filesystem` row are listed)
- Takes effect on newly created sessions: the preset's `skill-filesystem` row is disabled and a `@sidleo3/skill-filesystem-plus/preset` provider row is inserted (at `~/.dsh/.agent-presets//agent.cordis.yml`)
- Sessions on that preset use this plugin's four-layer discovery
- Unchecking restores the original config from `.skill-filesystem-plus-backup/` and `skill-filesystem` resumes (for new sessions)
Running sessions are unaffected (preset composition is fixed at session creation); changes apply to sessions created afterwards.
Configuration
```typescript
interface SkillScanConfig {
scanCwd: boolean // default: true
scanProject: boolean // default: true (mutually exclusive with scanParents)
scanParents: boolean // default: false (mutually exclusive with scanProject)
scanGlobal: boolean // default: true
parentDirs: { name: string }[] // default: [{name:'.dsh'},{name:'.agents'}]
}
```
Persisted at `~/.dsh/dsh-skill-filesystem-plus.json` (legacy `dsh-skill-scan.json` migrates automatically).
How it works
- Install = no-op: the host entry only registers the settings namespace + GUI RPC, and never touches a preset
- User picks presets: the GUI calls `/api/skill-filesystem-plus/presets/apply`; the host reads the preset via `ctx.agentPresets` → backs it up → disables the `skill-filesystem` row → inserts the `/preset` provider row
- Discovery: the `/preset` row's provider registers into that preset's layer of the skills registry (`skills.registerProvider` is scope-aware) and runs four-layer discovery, fully replacing built-in discovery
- Removal: the GUI calls `/api/skill-filesystem-plus/presets/remove`, restoring the original config from `.skill-filesystem-plus-backup/`
- Config live-reload: the provider re-reads the disk config through `ctx.fs` on every `list`, so a GUI save takes effect on the next catalog refresh
Why "replace" matters
DSH resolves same-named skills by layer before rank. As long as the built-in `skill-filesystem` stays mounted in the preset layer, it wins every duplicate name regardless of your rank — so to make "duplicates resolved by your priority" actually work, that preset's `skill-filesystem` row must be disabled and the provider supplied by this plugin.
Development
```bash
pnpm install
pnpm build # tsdown → lib/index.js + lib/preset.js + lib/client.js
pnpm typecheck # tsc --noEmit
```
Notes
- After a DSH upgrade overwrites a built-in preset, already-taken-over presets may be reset; uncheck and re-check in the GUI to rebuild from the new version (the backup mechanism keeps removal safe)
- `skill-scan-blueprint/` keeps the pre-rename dynamic-plugin form for reference (not part of the build)
License
MIT
