dsh-skills-manager 0.1.0

package/lib/types/state.js

@@ -0,0 +1,108 @@
+import { isAbsolute, relative, sep } from 'node:path';
+export const EMPTY_STATE = {
+    version: 1,
+    skills: {},
+    globalEnabled: [],
+    projectEnabled: {},
+};
+export function normalizeState(value) {
+    if (!isRecord(value) || value.version !== 1 || !isRecord(value.skills) || !Array.isArray(value.globalEnabled) || !isRecord(value.projectEnabled)) {
+        throw new Error('skill-manager state.json has an unsupported shape');
+    }
+    const skills = {};
+    for (const [name, entry] of Object.entries(value.skills)) {
+        if (!isRecord(entry) || entry.name !== name || typeof entry.description !== 'string' || (entry.layout !== 'directory' && entry.layout !== 'file') || typeof entry.installedAt !== 'string') {
+            throw new Error(`skill-manager state.json has an invalid skill entry: ${name}`);
+        }
+        skills[name] = {
+            name,
+            description: entry.description,
+            layout: entry.layout,
+            installedAt: entry.installedAt,
+            ...(typeof entry.updatedAt === 'string' ? { updatedAt: entry.updatedAt } : {}),
+            ...(entry.sourceType === 'local' || entry.sourceType === 'git' ? { sourceType: entry.sourceType } : {}),
+            ...(typeof entry.sourcePath === 'string' && isAbsolute(entry.sourcePath) ? { sourcePath: entry.sourcePath } : {}),
+            ...(typeof entry.sourceUrl === 'string' ? { sourceUrl: entry.sourceUrl } : {}),
+            ...(typeof entry.sourceSubpath === 'string' ? { sourceSubpath: entry.sourceSubpath } : {}),
+            ...(typeof entry.contentHash === 'string' ? { contentHash: entry.contentHash } : {}),
+        };
+    }
+    return {
+        version: 1,
+        skills,
+        globalEnabled: cleanNames(value.globalEnabled, skills),
+        projectEnabled: cleanProjects(value.projectEnabled, skills),
+    };
+}
+export function setEnabled(state, name, scope, projectRoot, enabled) {
+    if (!(name in state.skills))
+        throw new Error(`skill is not installed: ${name}`);
+    if (scope === 'project' && !projectRoot)
+        throw new Error('projectRoot is required for project scope');
+    if (scope === 'global') {
+        return {
+            ...state,
+            globalEnabled: updateNames(state.globalEnabled, name, enabled),
+        };
+    }
+    const current = state.projectEnabled[projectRoot] ?? [];
+    const next = updateNames(current, name, enabled);
+    const projectEnabled = { ...state.projectEnabled };
+    if (next.length === 0)
+        delete projectEnabled[projectRoot];
+    else
+        projectEnabled[projectRoot] = next;
+    return { ...state, projectEnabled };
+}
+export function removeSkill(state, name) {
+    if (!(name in state.skills))
+        throw new Error(`skill is not installed: ${name}`);
+    const skills = { ...state.skills };
+    delete skills[name];
+    return {
+        version: 1,
+        skills,
+        globalEnabled: state.globalEnabled.filter(item => item !== name),
+        projectEnabled: Object.fromEntries(Object.entries(state.projectEnabled)
+            .map(([root, names]) => [root, names.filter(item => item !== name)])
+            .filter(([, names]) => names.length > 0)),
+    };
+}
+export function isPathWithin(root, target) {
+    if (!isAbsolute(root) || !isAbsolute(target))
+        return false;
+    const child = relative(root, target);
+    return child === '' || (child !== '..' && !child.startsWith(`..${sep}`));
+}
+export function isEnabledFor(state, name, cwd) {
+    if (state.globalEnabled.includes(name))
+        return true;
+    if (!cwd)
+        return false;
+    return Object.entries(state.projectEnabled).some(([root, names]) => names.includes(name) && isPathWithin(root, cwd));
+}
+function updateNames(names, name, enabled) {
+    const next = new Set(names);
+    if (enabled)
+        next.add(name);
+    else
+        next.delete(name);
+    return [...next].sort();
+}
+function cleanNames(value, skills) {
+    return [...new Set(value.filter((item) => typeof item === 'string' && item in skills))].sort();
+}
+function cleanProjects(value, skills) {
+    const result = {};
+    for (const [root, names] of Object.entries(value)) {
+        if (!isAbsolute(root) || !Array.isArray(names))
+            continue;
+        const clean = cleanNames(names, skills);
+        if (clean.length > 0)
+            result[root] = clean;
+    }
+    return result;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}

package/lib/types/types.d.ts

@@ -0,0 +1,33 @@
+export type SkillScope = 'global' | 'project';
+export type SkillLayout = 'directory' | 'file';
+export type SkillSourceType = 'local' | 'git';
+export interface InstalledSkill {
+    readonly name: string;
+    readonly description: string;
+    readonly layout: SkillLayout;
+    readonly installedAt: string;
+    readonly updatedAt?: string;
+    readonly sourceType?: SkillSourceType;
+    readonly sourcePath?: string;
+    readonly sourceUrl?: string;
+    readonly sourceSubpath?: string;
+    readonly contentHash?: string;
+}
+export interface ManagerState {
+    readonly version: 1;
+    readonly skills: Readonly<Record<string, InstalledSkill>>;
+    readonly globalEnabled: readonly string[];
+    readonly projectEnabled: Readonly<Record<string, readonly string[]>>;
+}
+export interface SkillCatalogEntry extends InstalledSkill {
+    readonly globalEnabled: boolean;
+    readonly projectEnabled: boolean;
+    readonly effectiveEnabled: boolean;
+    readonly updateSupported: boolean;
+    readonly updateAvailable: boolean;
+    readonly updateError?: string;
+}
+export interface SkillCatalog {
+    readonly entries: readonly SkillCatalogEntry[];
+    readonly projectRoot?: string;
+}

package/lib/types/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "dsh-skills-manager",
+  "version": "0.1.0",
+  "description": "A DeepSeek Harness plugin for installing and managing skills by global or workspace scope.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Xichun123/dsh-skills-manager.git"
+  },
+  "homepage": "https://github.com/Xichun123/dsh-skills-manager#readme",
+  "bugs": "https://github.com/Xichun123/dsh-skills-manager/issues",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "plugin-design.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsdown",
+    "prepare": "npm run build",
+    "test": "npm run build && node --test test/*.test.mjs",
+    "validate": "python3 .agents/skills/dsh-plugin-builder/scripts/validate_dsh_plugin.py ."
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-settings"
+      ],
+      "platform": "web"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-home-paths": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-skill": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-skill-filesystem": "^0.1.0-rc.6",
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "react": "^18.2.0"
+  },
+  "dependencies": {
+    "lucide-react": "^1.31.0",
+    "yaml": "^2.4.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-home-paths": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-skill": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-skill-filesystem": "^0.1.0-rc.6",
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "@types/node": "^22.0.0",
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "tsdown": "^0.15.0",
+    "typescript": "^5.9.0"
+  },
+  "keywords": [
+    "dsh-plugin",
+    "deepseek-harness",
+    "skill-manager",
+    "skills"
+  ],
+  "license": "UNLICENSED"
+}

package/plugin-design.md

@@ -0,0 +1,22 @@
+# Plugin Design
+
+## 形态决策
+
+- 目标：在 DeepSeek Harness 中统一管理可安装 skill，并按全局或工作区启用。
+- 做插件：是。
+- 树外 / first-party：树外独立 npm 包 `dsh-skills-manager`。
+- 形态：Host skill provider + Host RPC + Client Settings UI。
+- 挂载点：`ctx.skills.registerProvider()`、`ctx.connection.rpc.handle('/skill-manager', ...)`、`settings.section`、`conversation.input.left`。
+- 不选其他形态的原因：不是 Agent Skill 文件本身，也不需要改 agent-loop、注册新工具或替代 MCP；只需要改变 skill 的发现范围并提供管理界面。
+- 拆 seam：否。管理状态、provider 和 RPC 是同一产品能力，暂不拆成多个包。
+
+## 行为
+
+- 安装库位于 `$DSH_HOME/skill-manager/library`，状态位于 `$DSH_HOME/skill-manager/state.json`。
+- 导入 skill 时复制完整目录，因此 `references/`、`scripts/`、`assets/` 等伴随资源保留。
+- 安装状态记录本机来源路径，或 Git 仓库 URL 与仓库内 skill 子路径，并保存完整内容哈希；检查更新时重新读取本机来源或浅克隆仓库比较哈希，更新通过临时副本和备份原子替换，并保留启用范围。
+- Git 支持 GitHub `owner/repo`、HTTPS、SSH、Git 与 file URL；私有仓库复用本机 Git credential helper 或 SSH，拒绝 URL 内嵌凭据且不保存 token。
+- 新导入 skill 默认关闭；全局启用会对所有 cwd 生效，项目启用会对所选工作区及其子目录生效。
+- Provider 复用 `@deepseek-ai/dsh-skill-filesystem` 的解析、资源和 watcher 能力，只过滤由本插件管理的库条目。
+- 设置页使用 `settings.section` 作为左侧一级入口；输入框 `+` 右边的扳手图标控件打开当前会话 cwd 的项目级开关。
+- RPC 仅注册 loopback authority，因为导入和持久化操作会触碰本机文件系统。