@dreanzy/dsh-skill-pack 0.1.0

package/lib/types.d.ts

@@ -0,0 +1,120 @@
+/**
+ * 一张具名策略表：项级与组级两条决定。
+ *
+ * 只含覆盖决定、不含成员清单。键不存在即跟随下一层，`false` 是有效取值，
+ * 不是「跟随」——这与旧的 `LayerPolicy` 语义完全一致。
+ */
+export interface Pack {
+    readonly name: string;
+    readonly items: Readonly<Record<string, boolean>>;
+    readonly groups: Readonly<Record<string, boolean>>;
+}
+/** `packs.json` 里的 pack 名册。`default` 是内置项，永远存在。 */
+export interface PackBook {
+    readonly packs: Readonly<Record<string, Pack>>;
+}
+/** 工作区绑定表。`bindings` 的键是 `normalizeCwd` 之后的 cwd。 */
+export interface Bindings {
+    readonly bindings: Readonly<Record<string, string>>;
+    readonly extra: readonly string[];
+}
+/**
+ * 单机 UI 开关，落在 `packs.json` 的 `ui` 段。
+ *
+ * `defaultTab` 是「打开设置时默认显示」的那一页，与「当前正在看哪一页」是两件事：
+ * 临时切页不写盘，只有设置页顶部那组单选才改这个值。
+ */
+export interface UiState {
+    showOfficialSkills: boolean;
+    showChip: boolean;
+    defaultTab: SettingsTab;
+}
+/** 设置页的三页，顺序固定。 */
+export type SettingsTab = 'groups' | 'packs' | 'workspace';
+/** 分组身份。id 稳定，name 可改。 */
+export interface GroupDef {
+    readonly id: string;
+    readonly name: string;
+}
+/** 组定义：跨工作区共享，不含任何开关决定。 */
+export interface GroupRegistry {
+    readonly groups: readonly GroupDef[];
+    /** 能力项名 → 分组 id。没有条目的项即未分组。 */
+    readonly assignments: Readonly<Record<string, string>>;
+}
+/**
+ * 一次策略变更的意图。
+ *
+ * `null` 一律表示「删掉这条键，回到跟随」，而不是「设成某个值」——
+ * 写同值不等于跟随（见 ADR 0001）。
+ *
+ * `bind` 的 `cwd` 由调用方给出并在此处规范化；`packId: null` 表示解除绑定。
+ */
+export type Command = {
+    readonly op: 'packItem';
+    readonly packId: string;
+    readonly name: string;
+    readonly value: boolean | null;
+} | {
+    readonly op: 'packGroup';
+    readonly packId: string;
+    readonly groupId: string;
+    readonly value: boolean | null;
+} | {
+    readonly op: 'createPack';
+    readonly name: string;
+} | {
+    readonly op: 'renamePack';
+    readonly packId: string;
+    readonly name: string;
+} | {
+    readonly op: 'deletePack';
+    readonly packId: string;
+} | {
+    readonly op: 'bind';
+    readonly cwd: string;
+    readonly packId: string | null;
+} | {
+    readonly op: 'addExtra';
+    readonly cwd: string;
+} | {
+    readonly op: 'removeExtra';
+    readonly cwd: string;
+} | {
+    readonly op: 'assign';
+    readonly name: string;
+    readonly groupId: string | null;
+} | {
+    readonly op: 'createGroup';
+    readonly name: string;
+} | {
+    readonly op: 'renameGroup';
+    readonly groupId: string;
+    readonly name: string;
+} | {
+    readonly op: 'deleteGroup';
+    readonly groupId: string;
+} | {
+    readonly op: 'showOfficialSkills';
+    readonly value: boolean;
+} | {
+    readonly op: 'showChip';
+    readonly value: boolean;
+} | {
+    readonly op: 'defaultTab';
+    readonly value: SettingsTab;
+};
+/** 解析结果：坏数据永不抛错，降级成空策略并附一条可读的说明。 */
+export interface ParseResult<T> {
+    readonly value: T;
+    readonly warnings: readonly string[];
+}
+/** 内置 pack 的 id。它同时是求值链的终点，也是未绑定工作区的取值来源。 */
+export declare const DEFAULT_PACK_ID = "default";
+/** 内置 pack 的固定显示名：界面与落盘都只用这一个，旧名在读写两侧都会归一。 */
+export declare const DEFAULT_PACK_NAME = "\u9ED8\u8BA4";
+export declare const EMPTY_PACK: Pack;
+export declare const EMPTY_PACK_BOOK: PackBook;
+export declare const EMPTY_BINDINGS: Bindings;
+export declare const EMPTY_UI: UiState;
+export declare const EMPTY_GROUPS: GroupRegistry;

package/lib/types.js

@@ -0,0 +1,13 @@
+/** 内置 pack 的 id。它同时是求值链的终点，也是未绑定工作区的取值来源。 */
+export const DEFAULT_PACK_ID = 'default';
+/** 内置 pack 的固定显示名：界面与落盘都只用这一个，旧名在读写两侧都会归一。 */
+export const DEFAULT_PACK_NAME = '默认';
+export const EMPTY_PACK = { name: DEFAULT_PACK_NAME, items: {}, groups: {} };
+export const EMPTY_PACK_BOOK = { packs: { [DEFAULT_PACK_ID]: EMPTY_PACK } };
+export const EMPTY_BINDINGS = { bindings: {}, extra: [] };
+export const EMPTY_UI = {
+    showOfficialSkills: false,
+    showChip: true,
+    defaultTab: 'groups',
+};
+export const EMPTY_GROUPS = { groups: [], assignments: {} };

package/locale/en.json

@@ -0,0 +1,47 @@
+{
+  "meta": {
+    "title": "Skill Pack",
+    "description": "Control which skills the model may auto-invoke with packs: a workspace binds one pack, and unbound workspaces follow default."
+  },
+  "ui": {
+    "tabs": {
+      "groups": "Groups",
+      "packs": "Packs"
+    },
+    "packs": {
+      "title": "Packs",
+      "newPlaceholder": "New pack name",
+      "create": "Create pack",
+      "rename": "Rename pack",
+      "delete": "Delete pack",
+      "builtin": "Default",
+      "overrides": "{count} overrides",
+      "editing": "Editing"
+    },
+    "switches": {
+      "title": "Switches in this pack",
+      "on": "On",
+      "off": "Off",
+      "follow": "Follow",
+      "followOn": "Follow (on)",
+      "followOff": "Follow (off)",
+      "hint": "Each switch has three states: on, off and follow. Follow means this pack records no decision."
+    },
+    "workspaces": {
+      "title": "Workspace bindings",
+      "followDefault": "Follow default",
+      "addPlaceholder": "Add a path, e.g. D:/work/repo",
+      "add": "Add",
+      "fromSession": "From sessions",
+      "manual": "Added manually",
+      "remove": "Remove from the manual list"
+    },
+    "chip": {
+      "label": "Skills",
+      "unbound": "Default",
+      "goSettings": "Open settings",
+      "goSettingsHint": "Open settings switches the settings default tab to Packs; open the settings dialog itself from the sidebar gear.",
+      "close": "Close"
+    }
+  }
+}

package/locale/zh.json

@@ -0,0 +1,47 @@
+{
+  "meta": {
+    "title": "Skill Pack",
+    "description": "用 pack 控制模型可以自动调用哪些 skill：工作区只绑一个 pack，未绑定按默认求值。"
+  },
+  "ui": {
+    "tabs": {
+      "groups": "分组",
+      "packs": "分包"
+    },
+    "packs": {
+      "title": "pack",
+      "newPlaceholder": "新 pack 名",
+      "create": "新建 pack",
+      "rename": "重命名 pack",
+      "delete": "删除 pack",
+      "builtin": "默认",
+      "overrides": "{count} 条覆盖",
+      "editing": "正在编辑"
+    },
+    "switches": {
+      "title": "包内开关",
+      "on": "开",
+      "off": "关",
+      "follow": "跟随",
+      "followOn": "跟随（开）",
+      "followOff": "跟随（关）",
+      "hint": "每个开关三态：开 / 关 / 跟随。「跟随」表示该 pack 不记录这条决定。"
+    },
+    "workspaces": {
+      "title": "工作区绑定",
+      "followDefault": "默认",
+      "addPlaceholder": "手动添加路径，例如 D:/work/repo",
+      "add": "添加",
+      "fromSession": "来自会话",
+      "manual": "手动添加",
+      "remove": "从手动清单移除"
+    },
+    "chip": {
+      "label": "Skills",
+      "unbound": "Default",
+      "goSettings": "去设置",
+      "goSettingsHint": "「去设置」会把设置页的默认分页切到「分包」；设置弹层本身请点侧栏的 ⚙ 打开。",
+      "close": "关闭"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@dreanzy/dsh-skill-pack",
+  "version": "0.1.0",
+  "description": "按工作区控制 DSH skill 的可见性：工作区绑定一个 pack，pack 是具名的开关表。",
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "skill",
+    "skill-manager",
+    "pack",
+    "workspace"
+  ],
+  "license": "MIT",
+  "author": "dreanzy <dreanzy@outlook.com>",
+  "homepage": "https://github.com/dreanzy/dsh-plg/tree/main/packages/dsh-skill-pack#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dreanzy/dsh-plg.git",
+    "directory": "packages/dsh-skill-pack"
+  },
+  "bugs": {
+    "url": "https://github.com/dreanzy/dsh-plg/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./lib/index.js",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js"
+    },
+    "./client": "./client/client.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "client",
+    "locale/*.json",
+    "icon.svg",
+    "cordis.patch.yml"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-locale"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "tsc -p tsconfig.json && node --test --test-isolation=none test/",
+    "prepare": "tsc -p tsconfig.json",
+    "prepublishOnly": "tsc -p tsconfig.json && node --test --test-isolation=none test/"
+  },
+  "dependencies": {
+    "@deepseek-ai/dsh-atomic-write": "^0.2.0-rc.2 || ^0.2.1-0 || ^0.2.2-rc.0",
+    "@deepseek-ai/dsh-home-paths": "^0.2.0-rc.2 || ^0.2.1-0 || ^0.2.2-rc.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.0.0"
+  }
+}