@dofe/infra-clients 0.1.38 → 0.1.40

package/dist/internal/openclaw/openclaw-skill-sync.client.d.ts

@@ -0,0 +1,222 @@
+import { HttpService } from '@nestjs/axios';
+import { ConfigService } from '@nestjs/config';
+import { Logger } from 'winston';
+/**
+ * _meta.json 版本信息
+ */
+export interface SkillMetaInfo {
+    latest: {
+        version: string;
+        publishedAt?: number;
+    };
+    history?: Array<{
+        version: string;
+        publishedAt?: number;
+    }>;
+}
+/**
+ * 技能目录中的单个文件
+ */
+export interface SkillFile {
+    /** 相对于技能根目录的路径，如 "references/api.md" */
+    relativePath: string;
+    /** 文件内容（文本） */
+    content: string;
+    /** 文件大小（字节） */
+    size: number;
+}
+/**
+ * 解析后的技能信息
+ */
+export interface ParsedSkill {
+    /** 技能 slug（唯一标识） */
+    slug: string;
+    /** 技能名称 */
+    name: string;
+    /** 技能描述 */
+    description: string;
+    /** 技能分类 */
+    category: string;
+    /** 技能作者 */
+    author: string;
+    /** GitHub 源 URL */
+    sourceUrl: string;
+}
+/**
+ * SKILL.md 解析后的内容
+ */
+export interface SkillDefinition {
+    /** 技能名称 */
+    name: string;
+    /** 版本号 */
+    version: string;
+    /** 描述 */
+    description: string;
+    /** 主页 URL */
+    homepage?: string;
+    /** 仓库 URL */
+    repository?: string;
+    /** 是否用户可调用 */
+    userInvocable?: boolean;
+    /** 标签列表 */
+    tags?: string[];
+    /** 元数据 */
+    metadata?: Record<string, unknown>;
+    /** 完整的 Markdown 内容 */
+    content: string;
+    /** 原始 YAML frontmatter */
+    frontmatter: Record<string, unknown>;
+    /** GitHub 源 URL */
+    sourceUrl: string;
+}
+/**
+ * 同步结果
+ */
+export interface SyncResult {
+    /** 总技能数 */
+    total: number;
+    /** 新增数量 */
+    added: number;
+    /** 更新数量 */
+    updated: number;
+    /** 跳过数量 */
+    skipped: number;
+    /** 错误数量 */
+    errors: number;
+    /** 同步时间 */
+    syncedAt: Date;
+}
+/**
+ * TOS 技能数据结构
+ */
+export interface TosSkillItem {
+    author: string;
+    slug: string;
+    displayName: string;
+    summary: string;
+    downloads: number;
+    stars: number;
+    version: string;
+    url: string;
+    versions: string[];
+    typeId?: string;
+}
+/**
+ * TOS skills.json 响应结构
+ */
+export interface TosSkillsResponse {
+    skills: TosSkillItem[];
+    updatedAt: string;
+    total: number;
+    baseUrl: string;
+}
+export declare class OpenClawSkillSyncClient {
+    private readonly logger;
+    private readonly httpService;
+    private readonly configService;
+    private readonly repoUrl;
+    private readonly tosSkillsUrl;
+    private readonly requestTimeout;
+    private readonly localCachePath;
+    private readonly githubToken?;
+    private readonly githubProxyUrl?;
+    constructor(logger: Logger, httpService: HttpService, configService: ConfigService);
+    /**
+     * 从 GitHub 获取 README 内容，失败时从本地缓存读取
+     */
+    fetchReadme(): Promise<string>;
+    /**
+     * 构建 GitHub 请求的 headers 和 URL
+     */
+    private getGitHubRequestConfig;
+    /**
+     * 检查 GitHub API Rate Limit 响应头
+     * remaining < 10 时告警，429 时抛出友好错误
+     */
+    private checkRateLimit;
+    /**
+     * 从 AxiosError 中检测 429 状态码并抛出友好错误
+     */
+    private handleGitHubError;
+    /**
+     * 从 GitHub 获取 README 内容
+     */
+    private fetchFromGitHub;
+    /**
+     * 保存内容到本地缓存
+     */
+    private saveToLocalCache;
+    /**
+     * 从本地缓存读取 README 内容
+     */
+    private readFromLocalCache;
+    /**
+     * 解析 README 内容，提取技能信息
+     * 只处理 URL 以 SKILL.md 结尾的技能
+     * 自动去重：相同 slug 只保留第一个
+     */
+    parseReadme(content: string): ParsedSkill[];
+    /**
+     * 将 slug 转换为可读名称
+     */
+    private slugToName;
+    /**
+     * 将字符串转换为 slug
+     */
+    private slugify;
+    /**
+     * 获取所有分类（包含中英文名称和图标）
+     */
+    getCategories(): Array<{
+        slug: string;
+        name: string;
+        nameZh: string;
+        icon: string;
+    }>;
+    /**
+     * 获取单个技能的 SKILL.md 内容
+     * 优先使用 raw URL，失败时 fallback 到 GitHub API（适用于 raw.githubusercontent.com 被屏蔽的环境）
+     * @param sourceUrl GitHub tree URL (如 https://github.com/openclaw/skills/tree/main/skills/author/slug/SKILL.md)
+     */
+    fetchSkillDefinition(sourceUrl: string): Promise<SkillDefinition>;
+    /**
+     * 将 GitHub tree URL 转换为 raw URL
+     */
+    private convertToRawUrl;
+    /**
+     * 将 GitHub tree URL 转换为 GitHub API URL
+     * https://github.com/{owner}/{repo}/tree/{ref}/{path}
+     * -> https://api.github.com/repos/{owner}/{repo}/contents/{path}?ref={ref}
+     */
+    private convertToApiUrl;
+    /**
+     * 将 SKILL.md 的 GitHub tree URL 转换为其所在目录的 API URL
+     */
+    private convertToDirApiUrl;
+    /**
+     * 解析 SKILL.md 内容
+     * 提取 YAML frontmatter 和 Markdown 内容
+     */
+    private parseSkillMd;
+    /**
+     * 获取技能的完整目录内容
+     * 使用 GitHub Contents API 递归获取目录下所有文件
+     */
+    fetchSkillDirectory(sourceUrl: string): Promise<SkillFile[]>;
+    /**
+     * 递归获取 GitHub 目录内容
+     */
+    private fetchDirectoryRecursive;
+    /**
+     * 获取 Skill 的 _meta.json 版本信息
+     * @param sourceUrl GitHub tree URL for SKILL.md
+     * @returns SkillMetaInfo or null if not found
+     */
+    fetchSkillMeta(sourceUrl: string): Promise<SkillMetaInfo | null>;
+    /**
+     * 从 TOS 获取技能列表
+     * 数据源: https://pardx.tos-cn-shanghai.volces.com/clawskills/skills.json
+     */
+    fetchTosSkills(): Promise<TosSkillsResponse>;
+}
+//# sourceMappingURL=openclaw-skill-sync.client.d.ts.map

package/dist/internal/openclaw/openclaw-skill-sync.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-skill-sync.client.d.ts","sourceRoot":"","sources":["../../../../../packages/clients/src/internal/openclaw/openclaw-skill-sync.client.ts"],"names":[],"mappings":"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"}