@shareai-lab/kode-sdk 2.7.1 → 2.7.3

package/dist/core/skills/management-manager.d.ts

@@ -1,120 +1,144 @@
 /**
- * 技能管理器模块（路径1 - 技能管理）
+ * 技能管理器模块(路径1 - 技能管理)
  *
  * 设计原则 (UNIX哲学):
- * - 简洁: 只负责技能文件系统的CRUD操作
- * - 模块化: 协调OperationQueue、SandboxFileManager进行文件系统操作
- * - 隔离: 与Agent运行时完全隔离，不参与Agent使用
+ * - 简洁: 只负责技能文件系统的管理操作
+ * - 模块化: 单一职责,易于测试和维护
+ * - 隔离: 与Agent运行时完全隔离,不参与Agent使用
  *
  * ⚠️ 重要说明:
- * - 此模块专门用于路径1（技能管理）
- * - 与路径2（Agent运行时）完全独立
+ * - 此模块专门用于路径1(技能管理)
+ * - 与路径2(Agent运行时)完全独立
  * - 请勿与SkillsManager混淆
+ *
+ * @see docs/skills-management-implementation-plan.md
  */
-import { OperationTask } from './operation-queue';
-import type { SkillInfo, SkillDetail, SkillFileTree, CreateSkillOptions, ArchivedSkillInfo } from './types';
-import { SandboxFactory } from '../../infra/sandbox-factory';
+import type { SkillInfo, ArchivedSkillInfo } from './types';
 /**
  * 技能管理器类
  *
  * 职责:
- * - 提供所有技能管理操作的统一接口（CRUD操作）
- * - 协调OperationQueue、SandboxFileManager进行文件系统操作
+ * - 提供所有技能管理操作的统一接口(导入、复制、重命名、归档、导出)
  * - 处理业务逻辑和权限验证
+ * - 所有操作严格遵循Specification.md规范
  * - ❌ 不参与Agent运行时
  * - ❌ 不提供技能加载、扫描等Agent使用的功能
  */
 export declare class SkillsManagementManager {
-    private skillsManager;
-    private operationQueue;
-    private sandboxFileManager;
     private skillsDir;
     private archivedDir;
-    constructor(skillsDir: string, sandboxFactory?: SandboxFactory, archivedDir?: string);
+    constructor(skillsDir: string, archivedDir?: string);
     /**
-     * 获取所有在线技能列表（不包含archived技能）
+     * 1. 列出在线技能
+     * 扫描skills目录,排除.archived子目录
+     * 返回技能清单及其元数据信息
      */
     listSkills(): Promise<SkillInfo[]>;
     /**
-     * 获取单个在线技能详细信息
-     * @param skillName 技能名称
+     * 2. 安装新技能
+     * @param source 技能来源(名称/GitHub仓库/Git URL/本地路径)
+     * @param onProgress 可选的进度回调函数，用于实时传递安装日志
+     * 执行命令: npx -y ai-agent-skills install --agent project [source]
+     * 直接安装到.skills目录
      */
-    getSkillInfo(skillName: string): Promise<SkillDetail | null>;
+    installSkill(source: string, onProgress?: (data: {
+        type: 'log' | 'error';
+        message: string;
+    }) => void): Promise<void>;
     /**
-     * 获取已归档技能列表（只读，不支持修改）
+     * 3. 列出归档技能
+     * 扫描.archived目录
+     * 返回归档技能清单及其元数据信息
      */
     listArchivedSkills(): Promise<ArchivedSkillInfo[]>;
     /**
-     * 创建新技能
+     * 4. 导入技能
+     * @param zipFilePath zip文件路径
+     * @param originalFileName 原始上传文件名（可选，用于无嵌套目录时的技能命名）
+     * 验证SKILL.md格式,解压并放置在在线技能目录中
+     *
+     * 检测逻辑：
+     * - 如果解压后根目录直接包含SKILL.md，视为无嵌套目录，使用originalFileName作为技能名称
+     * - 如果根目录不包含SKILL.md但包含多个子目录，每个子目录都有SKILL.md，则批量导入
+     */
+    importSkill(zipFilePath: string, originalFileName?: string): Promise<void>;
+    /**
+     * 5. 复制技能
      * @param skillName 技能名称
-     * @param options 技能配置（名称、描述等）
+     * 新技能名称: {原技能名称}-{XXXXXXXX}
      */
-    createSkill(skillName: string, options: CreateSkillOptions): Promise<SkillDetail>;
+    copySkill(skillName: string): Promise<string>;
     /**
-     * 重命名技能
-     * @param oldName 旧技能名称
-     * @param newName 新技能名称
+     * 6. 重命名技能
+     * @param oldName 旧技能文件夹名称
+     * @param newName 新技能文件夹名称
+     * 不支持操作归档技能
      */
     renameSkill(oldName: string, newName: string): Promise<void>;
     /**
-     * 编辑技能文件
+     * 7. 在线技能转归档
      * @param skillName 技能名称
-     * @param filePath 文件路径（相对于技能根目录，如"SKILL.md"）
-     * @param content 文件内容
-     * @param useSandbox 是否使用sandbox（默认true）
+     * 归档名称: {原技能名称}-{XXXXXXXX}
+     */
+    archiveSkill(skillName: string): Promise<void>;
+    /**
+     * 8. 归档技能转在线
+     * @param archivedSkillName archived中的技能名称(含后缀)
+     * 移入前检测重名
      */
-    editSkillFile(skillName: string, filePath: string, content: string, useSandbox?: boolean): Promise<void>;
+    unarchiveSkill(archivedSkillName: string): Promise<void>;
     /**
-     * 删除技能（移动到archived）
+     * 9. 查看在线技能内容
      * @param skillName 技能名称
+     * 返回SKILL.md完整内容(包含frontmatter和正文)
      */
-    deleteSkill(skillName: string): Promise<void>;
+    getOnlineSkillContent(skillName: string): Promise<string>;
     /**
-     * 恢复已删除的技能
-     * @param archivedSkillName archived中的技能名称（含时间戳）
+     * 10. 查看归档技能内容
+     * @param archivedSkillName 归档技能名称(含8位后缀)
+     * 返回SKILL.md完整内容(包含frontmatter和正文)
      */
-    restoreSkill(archivedSkillName: string): Promise<void>;
+    getArchivedSkillContent(archivedSkillName: string): Promise<string>;
     /**
-     * 获取技能文件树（仅在线技能）
+     * 11. 查看在线技能文件目录结构
      * @param skillName 技能名称
+     * 返回JSON格式的目录树结构
      */
-    getSkillFileTree(skillName: string): Promise<SkillFileTree>;
+    getOnlineSkillStructure(skillName: string): Promise<object>;
     /**
-     * 获取队列状态
+     * 12. 查看归档技能文件目录结构
+     * @param archivedSkillName 归档技能名称(含8位后缀)
+     * 返回JSON格式的目录树结构
      */
-    getQueueStatus(): {
-        length: number;
-        processing: boolean;
-        tasks: OperationTask[];
-    };
+    getArchivedSkillStructure(archivedSkillName: string): Promise<object>;
     /**
-     * 执行创建技能
+     * 13. 导出技能
+     * @param skillName 技能名称(在线或归档)
+     * @param isArchived 是否为归档技能
+     * 使用系统zip命令打包,放入临时目录
      */
-    private doCreateSkill;
+    exportSkill(skillName: string, isArchived: boolean): Promise<string>;
     /**
-     * 执行重命名技能
+     * 递归构建目录树
      */
-    private doRenameSkill;
+    private buildDirectoryTree;
     /**
-     * 执行编辑技能文件
+     * 解析SKILL.md的YAML frontmatter
      */
-    private doEditSkillFile;
+    private parseSkillMd;
     /**
-     * 执行删除技能
+     * 验证SKILL.md格式(遵循Specification.md规范)
      */
-    private doDeleteSkill;
+    private validateSkillMd;
     /**
-     * 执行恢复技能
+     * 生成8位随机后缀
+     * 规则: uuidv4 → sha256 → 全小写 → 取前8位
      */
-    private doRestoreSkill;
+    private generateRandomSuffix;
     /**
      * 验证技能名称
      */
     private isValidSkillName;
-    /**
-     * 生成SKILL.md内容
-     */
-    private generateSkillMd;
     /**
      * 检查文件是否存在
      */
@@ -124,7 +148,16 @@ export declare class SkillsManagementManager {
      */
     private safeGetFileStat;
     /**
-     * 等待任务完成
+     * 解压zip文件
+     */
+    private extractZip;
+    /**
+     * 跨平台的安全重命名方法
+     * Windows上使用"复制-删除"方式避免EPERM错误
+     */
+    private safeRename;
+    /**
+     * 创建zip文件
      */
-    private waitForTask;
+    private createZip;
 }