@dreanzy/dsh-skill-pack 0.1.0

package/README.en.md

@@ -0,0 +1,75 @@
+# @dreanzy/dsh-skill-pack
+
+Per-workspace skill visibility for the DeepSeek Harness. A workspace binds exactly one pack; a pack is a named table of switches. Unbound workspaces evaluate against `default`.
+
+**English** | [简体中文](README.md)
+
+## What it solves
+
+Once you install enough skills, every request pays for the whole catalogue again: the skill directory re-enters the context, too many candidates make the model pick wrong, and one project's private capability keeps occupying space in another.
+
+This plugin turns "which skills may the model auto-invoke right now" into a set of switches, and makes each workspace choose once:
+
+```
+bound pack  ??  default pack  ??  default on
+```
+
+`??` means the first ring that has a decision wins. A pack stores explicit decisions only: a missing key means follow, and `false` is a real value, not follow.
+
+A batch of workspaces — say five art projects — shares one pack, and one edit applies everywhere.
+
+## Groups
+
+A group declares "which items belong together"; it is not a switch by itself:
+
+- A skill belongs to at most one group; anything unassigned is simply ungrouped.
+- A pack can switch a whole group, and members added later follow that decision.
+- Group definitions are shared across workspaces; renaming a group invalidates nothing.
+
+## Install
+
+```sh
+dsh plugin --profile <profile> add @dreanzy/dsh-skill-pack
+```
+
+Restart the Host and refresh the page. Two entry points: the chip at the right of the composer, and Settings → Skill Pack. The chip itself can be turned off in Settings.
+
+## Editing and saving
+
+The pack and workspace pages write immediately; there is no draft. Creating, renaming, and deleting groups, and moving a skill between groups, also write immediately.
+
+> Earlier builds had a "保存 / 撤销" draft inside the sidebar panel. It was removed together with the sidebar entry. See [docs/adr/0005-draft-and-save.md](docs/adr/0005-draft-and-save.md) (no longer applicable).
+
+## Interface
+
+- Settings → Skill Pack has three pages: `分组` / `分包` / `工作区`.
+- Groups fold by group; expand one to reassign members inline. Search matches both skill names and group names.
+- Packs edits the pack list and the switches inside a pack. On `default` there are only on and off — it is the end of the chain, with no layer above.
+- Workspaces lists directories that have sessions plus manually added paths, one pack dropdown per row.
+
+## Files
+
+| Path | Contents |
+| --- | --- |
+| `$DSH_HOME/packs/skill/packs.json` | Pack list: item- and group-level decisions per pack, plus UI switches (chip visibility, default page) |
+| `$DSH_HOME/packs/skill/groups.json` | Group definitions and membership, shared across workspaces |
+| `$DSH_HOME/packs/skill/workspaces.json` | Workspace → pack bindings, plus manually added paths |
+
+Workspace directories produce no files at all: the binding table lives in the global home, so project directories stay clean.
+
+## Write semantics
+
+Every toggle submits a set of **intents** (`{key, value|null}`); the server reads, mutates, and writes under a cross-process file lock, comparing no revisions at all. Intents are idempotent and commutative, and the last writer of one key wins, so conflicts such as `stale-revision` cannot occur. `null` deletes the key, returning to follow — writing a same value is not the same thing.
+
+See [docs/adr/0001-intent-writes.md](docs/adr/0001-intent-writes.md).
+
+## Known limits
+
+- **Skills only.** Per-workspace MCP switching is out of scope; DSH offers no clean narrowing point for MCP tools. See [docs/adr/0004-skill-only-scope.md](docs/adr/0004-skill-only-scope.md).
+- Changing the working directory mid-session does not re-evaluate; reopening the session restores the expected state.
+- Same-layer first-wins: if another plugin registered a skill of the same name into the same layer first, that skill cannot be hidden. The panel greys it out and states the reason.
+- Official `@deepseek-ai` skills are hidden from the panel by default (the rule lives in `src/inventory.ts`) but stay model-invokable; turn "显示官方技能" on to switch them individually.
+
+## Relationship to dsh-skill-scope
+
+Both plugins register shadow copies into the same Agent layer, so they **cannot coexist**. Remove dsh-skill-scope first. This plugin does not read its configuration; migration is manual.

package/README.md

@@ -0,0 +1,91 @@
+# @dreanzy/dsh-skill-pack
+
+按工作区控制 skill 可见性的 DSH 插件。工作区只绑一个 pack，pack 是一张具名的开关表；未绑定按 `default` 求值。
+
+[English](README.en.md) | **简体中文**
+
+## 它解决什么问题
+
+装得多之后，每一轮请求都要重新付一遍清单成本：skill 目录进上下文、候选太多让模型选错、A 项目的专用能力在 B 项目里一直占位。
+
+本插件把「模型此刻能自动调用哪些 skill」变成一组开关，并让工作区只做一次选择：
+
+```
+工作区绑定的 pack  ??  default pack  ??  默认开
+```
+
+`??` 表示「前一环有记录就不读后面的」。pack 里只存**显式决定**：键不存在就是跟随，`false` 是有效取值，不是跟随。
+
+同一批工作区（比如五个美术项目）共用一张 pack，改一次全部生效。
+
+## 分组
+
+分组只说明「哪些项是一类」，本身不是开关：
+
+- 一个 skill 最多属于一个分组，未归属的就是未分组。
+- pack 可以按分组设开关，组内后加入的成员自动跟随这条决定。
+- 组定义跨工作区共享，改组名不影响任何 pack 里的组级决定。
+
+## 安装
+
+需要 DSH `0.2.x`（`0.2.0-rc.2` 及以上）。
+
+**在 Web 界面安装**：设置 → 插件 → 添加插件 → 安装第三方插件，输入包名：
+
+```
+@dreanzy/dsh-skill-pack
+```
+
+**命令行安装**：
+
+```sh
+dsh plugin --profile <profile> add @dreanzy/dsh-skill-pack
+```
+
+装完重启 Host、刷新页面。两个入口：输入框右侧的 chip，和 设置 → Skill Pack。chip 的显示可以在设置里关掉。
+
+从源码安装（需要 pnpm 允许该包执行构建）：
+
+```sh
+dsh plugin --profile <profile> add "github:dreanzy/dsh-plg#<sha>&path:/packages/dsh-skill-pack"
+```
+
+## 编辑与保存
+
+分包页与工作区页的每次改动即时写入，没有草稿；分组的新建、改名、删除与归属调整同样是即时写入。
+
+> 早期版本侧栏面板有「保存 / 撤销」草稿，随侧栏入口一并移除。见 [docs/adr/0005-draft-and-save.md](docs/adr/0005-draft-and-save.md)（已不适用）。
+
+## 界面
+
+- 设置 → Skill Pack 分三页：`分组` / `分包` / `工作区`。
+- 「分组」按组折叠展示成员，展开后在行内改归属；搜索同时匹配技能名与分组名。
+- 「分包」编辑 pack 名册与包内开关。选中「默认」时开关只有开与关——它是求值链的终点，没有上一层。
+- 「工作区」列出开过会话的目录与手动添加的路径，每行一个 pack 下拉。
+
+## 文件
+
+| 路径 | 内容 |
+| --- | --- |
+| `$DSH_HOME/packs/skill/packs.json` | pack 名册：每张 pack 的项级与组级决定，加上界面开关（是否显示 chip、默认分页） |
+| `$DSH_HOME/packs/skill/groups.json` | 分组定义与成员归属，跨工作区共享 |
+| `$DSH_HOME/packs/skill/workspaces.json` | 工作区 → pack 的绑定，以及手动添加的路径 |
+
+工作区目录不再产生任何文件：绑定表放在全局，工程目录保持干净。
+
+## 写入语义
+
+每一次开关提交的是一组**意图**（`{键, 值|null}`），服务端在文件锁内读—改—写，不比对任何版本。命令幂等、可交换，写同一键即后点者赢，因此不存在 `stale-revision` 这类冲突。`null` 表示删掉这条键、回到跟随——写一个同值不等于跟随。
+
+详见 [docs/adr/0001-intent-writes.md](docs/adr/0001-intent-writes.md)。
+
+## 已知边界
+
+- **只管 skill**。MCP 的按工作区开关不在本包范围（MCP 一侧在 DSH 里没有干净的收窄点）。见 [docs/adr/0004-skill-only-scope.md](docs/adr/0004-skill-only-scope.md)。
+- 会话中途切换工作目录不会重算策略，重开会话即恢复。
+- 同层 first-wins：若别的插件先把同名 skill 注册进同一层，那条关不掉，面板会在该行标出「关不掉」。
+- 官方 `@deepseek-ai` 技能默认不在面板出现（判定见 `src/inventory.ts`），但模型仍可调用；打开「显示官方技能」后可逐项关闭。
+
+## 与 dsh-skill-scope 的关系
+
+两者都往 Agent 同层注册遮蔽副本，**不能共存**，装本插件前请卸载它。本插件不读它的配置，迁移需要手动重配。