@dofe/infra-clients 0.1.1

package/dist/internal/openclaw/openclaw-skill-sync.client.js

@@ -0,0 +1,720 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenClawSkillSyncClient = void 0;
+/**
+ * OpenClaw Skill Sync Client
+ *
+ * 职责：
+ * - 从 GitHub 仓库同步 OpenClaw 技能库
+ * - 解析 README.md 提取技能信息
+ * - 支持增量同步和全量同步
+ * - 支持本地文件缓存（GitHub 不可用时的降级方案）
+ */
+const common_1 = require("@nestjs/common");
+const axios_1 = require("@nestjs/axios");
+const config_1 = require("@nestjs/config");
+const nest_winston_1 = require("nest-winston");
+const winston_1 = require("winston");
+const rxjs_1 = require("rxjs");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("js-yaml"));
+const infra_contracts_1 = require("@dofe/infra-contracts");
+/**
+ * 分类映射（将 README 中的分类名转换为 slug）
+ */
+const CATEGORY_MAP = {
+    'Coding Agents & IDEs': 'coding-agents',
+    'Git & GitHub': 'git-github',
+    Moltbook: 'moltbook',
+    'Web & Frontend Development': 'web-frontend',
+    'DevOps & Cloud': 'devops-cloud',
+    'Browser & Automation': 'browser-automation',
+    'Image & Video Generation': 'image-video-gen',
+    'Apple Apps & Services': 'apple-apps',
+    'Search & Research': 'search-research',
+    'Clawdbot Tools': 'clawdbot-tools',
+    'CLI Utilities': 'cli-utilities',
+    'Marketing & Sales': 'marketing-sales',
+    'Productivity & Tasks': 'productivity-tasks',
+    'AI & LLMs': 'ai-llms',
+    'Data & Analytics': 'data-analytics',
+    Finance: 'finance',
+    'Media & Streaming': 'media-streaming',
+    'Notes & PKM': 'notes-pkm',
+    'iOS & macOS Development': 'ios-macos-dev',
+    Transportation: 'transportation',
+    'Personal Development': 'personal-dev',
+    'Health & Fitness': 'health-fitness',
+    Communication: 'communication',
+    'Speech & Transcription': 'speech-transcription',
+    'Smart Home & IoT': 'smart-home-iot',
+    'Shopping & E-commerce': 'shopping-ecommerce',
+    'Calendar & Scheduling': 'calendar-scheduling',
+    'PDF & Documents': 'pdf-documents',
+    'Self-Hosted & Automation': 'self-hosted',
+    'Security & Passwords': 'security-passwords',
+    Gaming: 'gaming',
+    'Agent-to-Agent Protocols': 'agent-protocols',
+};
+/**
+ * 分类中文名称映射
+ */
+const CATEGORY_ZH_MAP = {
+    'coding-agents': '编程代理与IDE',
+    'git-github': 'Git与GitHub',
+    moltbook: 'Moltbook',
+    'web-frontend': 'Web与前端开发',
+    'devops-cloud': 'DevOps与云服务',
+    'browser-automation': '浏览器与自动化',
+    'image-video-gen': '图像与视频生成',
+    'apple-apps': 'Apple应用与服务',
+    'search-research': '搜索与研究',
+    'clawdbot-tools': 'Clawdbot工具',
+    'cli-utilities': '命令行工具',
+    'marketing-sales': '营销与销售',
+    'productivity-tasks': '生产力与任务',
+    'ai-llms': 'AI与大语言模型',
+    'data-analytics': '数据与分析',
+    finance: '金融',
+    'media-streaming': '媒体与流媒体',
+    'notes-pkm': '笔记与知识管理',
+    'ios-macos-dev': 'iOS与macOS开发',
+    transportation: '交通出行',
+    'personal-dev': '个人发展',
+    'health-fitness': '健康与健身',
+    communication: '通讯',
+    'speech-transcription': '语音与转录',
+    'smart-home-iot': '智能家居与物联网',
+    'shopping-ecommerce': '购物与电商',
+    'calendar-scheduling': '日历与日程',
+    'pdf-documents': 'PDF与文档',
+    'self-hosted': '自托管与自动化',
+    'security-passwords': '安全与密码',
+    gaming: '游戏',
+    'agent-protocols': '代理间协议',
+};
+/**
+ * 分类图标映射
+ */
+const CATEGORY_ICON_MAP = {
+    'coding-agents': '💻',
+    'git-github': '🔀',
+    moltbook: '📓',
+    'web-frontend': '🌐',
+    'devops-cloud': '☁️',
+    'browser-automation': '🤖',
+    'image-video-gen': '🎨',
+    'apple-apps': '🍎',
+    'search-research': '🔍',
+    'clawdbot-tools': '🔧',
+    'cli-utilities': '⌨️',
+    'marketing-sales': '📈',
+    'productivity-tasks': '✅',
+    'ai-llms': '🧠',
+    'data-analytics': '📊',
+    finance: '💰',
+    'media-streaming': '🎬',
+    'notes-pkm': '📝',
+    'ios-macos-dev': '📱',
+    transportation: '🚗',
+    'personal-dev': '🌱',
+    'health-fitness': '💪',
+    communication: '💬',
+    'speech-transcription': '🎤',
+    'smart-home-iot': '🏠',
+    'shopping-ecommerce': '🛒',
+    'calendar-scheduling': '📅',
+    'pdf-documents': '📄',
+    'self-hosted': '🖥️',
+    'security-passwords': '🔐',
+    gaming: '🎮',
+    'agent-protocols': '🔗',
+};
+let OpenClawSkillSyncClient = class OpenClawSkillSyncClient {
+    logger;
+    httpService;
+    configService;
+    repoUrl = 'https://raw.githubusercontent.com/VoltAgent/awesome-openclaw-skills/main/README.md';
+    tosSkillsUrl = process.env.SKILLS_URL ||
+        'https://pardx.tos-cn-shanghai.volces.com/clawskills/skills.json';
+    requestTimeout = 60000; // 60 秒超时
+    localCachePath;
+    githubToken;
+    githubProxyUrl;
+    constructor(logger, httpService, configService) {
+        this.logger = logger;
+        this.httpService = httpService;
+        this.configService = configService;
+        // 本地缓存文件路径：apps/api/openclaw-skills/README.md
+        this.localCachePath = path.resolve(__dirname, '../../../../../openclaw-skills/README.md');
+        // GitHub Token 和代理 URL（可选）
+        this.githubToken = this.configService.get('GITHUB_TOKEN');
+        this.githubProxyUrl = this.configService.get('GITHUB_PROXY_URL');
+    }
+    /**
+     * 从 GitHub 获取 README 内容，失败时从本地缓存读取
+     */
+    async fetchReadme() {
+        this.logger.info('OpenClawSkillSyncClient: 开始获取 README');
+        try {
+            // 尝试从 GitHub 获取
+            const content = await this.fetchFromGitHub();
+            // 成功获取后，保存到本地缓存
+            await this.saveToLocalCache(content);
+            return content;
+        }
+        catch (error) {
+            this.logger.warn('OpenClawSkillSyncClient: GitHub 获取失败，尝试从本地缓存读取', {
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            // 从本地缓存读取
+            return this.readFromLocalCache();
+        }
+    }
+    /**
+     * 构建 GitHub 请求的 headers 和 URL
+     */
+    getGitHubRequestConfig(url) {
+        const headers = {};
+        if (this.githubToken) {
+            headers['Authorization'] = `token ${this.githubToken}`;
+        }
+        // 如果配置了代理 URL，替换 GitHub 域名
+        let finalUrl = url;
+        if (this.githubProxyUrl) {
+            finalUrl = url.replace('https://raw.githubusercontent.com', this.githubProxyUrl);
+        }
+        return { url: finalUrl, headers };
+    }
+    /**
+     * 检查 GitHub API Rate Limit 响应头
+     * remaining < 10 时告警，429 时抛出友好错误
+     */
+    checkRateLimit(headers) {
+        const remaining = Number(headers['x-ratelimit-remaining']);
+        const reset = Number(headers['x-ratelimit-reset']);
+        if (isNaN(remaining))
+            return;
+        if (remaining === 0) {
+            const resetTime = reset
+                ? new Date(reset * 1000).toLocaleTimeString()
+                : 'unknown';
+            throw new Error(`GitHub API 请求频率超限，请配置 GITHUB_TOKEN 环境变量以提高限额（60→5000次/小时）。重置时间：${resetTime}`);
+        }
+        if (remaining < 10) {
+            this.logger.warn('OpenClawSkillSyncClient: GitHub API Rate Limit 即将耗尽', {
+                remaining,
+                resetAt: reset ? new Date(reset * 1000).toISOString() : 'unknown',
+                hasToken: !!this.githubToken,
+            });
+        }
+    }
+    /**
+     * 从 AxiosError 中检测 429 状态码并抛出友好错误
+     */
+    handleGitHubError(error) {
+        const axiosError = error;
+        if (axiosError?.response?.status === 429) {
+            const reset = Number(axiosError.response.headers?.['x-ratelimit-reset']);
+            const resetTime = reset
+                ? new Date(reset * 1000).toLocaleTimeString()
+                : 'unknown';
+            throw new Error(`GitHub API 请求频率超限（429），请配置 GITHUB_TOKEN 环境变量以提高限额（60→5000次/小时）。重置时间：${resetTime}`);
+        }
+        throw error;
+    }
+    /**
+     * 从 GitHub 获取 README 内容
+     */
+    async fetchFromGitHub() {
+        const { url, headers } = this.getGitHubRequestConfig(this.repoUrl);
+        const response = await (0, rxjs_1.firstValueFrom)(this.httpService.get(url, { headers }).pipe((0, rxjs_1.timeout)(this.requestTimeout), (0, rxjs_1.catchError)((error) => {
+            this.logger.error('OpenClawSkillSyncClient: GitHub 请求失败', {
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            throw error;
+        })));
+        this.logger.info('OpenClawSkillSyncClient: GitHub README 获取成功', {
+            contentLength: response.data.length,
+        });
+        return response.data;
+    }
+    /**
+     * 保存内容到本地缓存
+     */
+    async saveToLocalCache(content) {
+        try {
+            // 确保目录存在
+            const dir = path.dirname(this.localCachePath);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            fs.writeFileSync(this.localCachePath, content, 'utf-8');
+            this.logger.info('OpenClawSkillSyncClient: 已保存到本地缓存', {
+                path: this.localCachePath,
+            });
+        }
+        catch (error) {
+            this.logger.warn('OpenClawSkillSyncClient: 保存本地缓存失败', {
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            // 保存失败不影响主流程
+        }
+    }
+    /**
+     * 从本地缓存读取 README 内容
+     */
+    readFromLocalCache() {
+        if (!fs.existsSync(this.localCachePath)) {
+            this.logger.error('OpenClawSkillSyncClient: 本地缓存文件不存在', {
+                path: this.localCachePath,
+            });
+            throw new Error(`本地缓存文件不存在: ${this.localCachePath}`);
+        }
+        const content = fs.readFileSync(this.localCachePath, 'utf-8');
+        this.logger.info('OpenClawSkillSyncClient: 从本地缓存读取成功', {
+            path: this.localCachePath,
+            contentLength: content.length,
+        });
+        return content;
+    }
+    /**
+     * 解析 README 内容，提取技能信息
+     * 只处理 URL 以 SKILL.md 结尾的技能
+     * 自动去重：相同 slug 只保留第一个
+     */
+    parseReadme(content) {
+        const skillsMap = new Map();
+        let currentCategory = '';
+        let skippedCount = 0;
+        let duplicateCount = 0;
+        // 按行解析
+        const lines = content.split('\n');
+        for (const line of lines) {
+            // 检测分类标题（<summary><h3>...）
+            const categoryMatch = line.match(/<summary><h3[^>]*>([^<]+)<\/h3><\/summary>/);
+            if (categoryMatch) {
+                currentCategory = categoryMatch[1].trim();
+                continue;
+            }
+            // 检测技能条目（- [slug](url) - description）
+            const skillMatch = line.match(/^- \[([^\]]+)\]\(([^)]+)\)\s*-\s*(.+)$/);
+            if (skillMatch && currentCategory) {
+                const [, slug, sourceUrl, description] = skillMatch;
+                // 只处理以 SKILL.md 结尾的 URL
+                if (!sourceUrl.trim().endsWith('SKILL.md')) {
+                    skippedCount++;
+                    continue;
+                }
+                const trimmedSlug = slug.trim();
+                // 检查是否已存在相同 slug（去重）
+                if (skillsMap.has(trimmedSlug)) {
+                    duplicateCount++;
+                    this.logger.debug('OpenClawSkillSyncClient: 跳过重复 slug', {
+                        slug: trimmedSlug,
+                        sourceUrl: sourceUrl.trim(),
+                    });
+                    continue;
+                }
+                // 从 URL 提取作者
+                // URL 格式: https://github.com/openclaw/skills/tree/main/skills/{author}/{slug}/SKILL.md
+                const authorMatch = sourceUrl.match(/\/skills\/([^/]+)\/[^/]+\/SKILL\.md/);
+                const author = authorMatch ? authorMatch[1] : 'unknown';
+                skillsMap.set(trimmedSlug, {
+                    slug: trimmedSlug,
+                    name: this.slugToName(trimmedSlug),
+                    description: description.trim(),
+                    category: CATEGORY_MAP[currentCategory] || this.slugify(currentCategory),
+                    author,
+                    sourceUrl: sourceUrl.trim(),
+                });
+            }
+        }
+        const skills = Array.from(skillsMap.values());
+        this.logger.info('OpenClawSkillSyncClient: README 解析完成', {
+            totalSkills: skills.length,
+            skippedSkills: skippedCount,
+            duplicateSkills: duplicateCount,
+            categories: [...new Set(skills.map((s) => s.category))].length,
+        });
+        return skills;
+    }
+    /**
+     * 将 slug 转换为可读名称
+     */
+    slugToName(slug) {
+        return slug
+            .split('-')
+            .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+            .join(' ');
+    }
+    /**
+     * 将字符串转换为 slug
+     */
+    slugify(text) {
+        return text
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, '-')
+            .replace(/^-|-$/g, '');
+    }
+    /**
+     * 获取所有分类（包含中英文名称和图标）
+     */
+    getCategories() {
+        return Object.entries(CATEGORY_MAP).map(([name, slug], index) => ({
+            slug,
+            name,
+            nameZh: CATEGORY_ZH_MAP[slug] || name,
+            icon: CATEGORY_ICON_MAP[slug] || '📦',
+            sortOrder: index + 1,
+        }));
+    }
+    /**
+     * 获取单个技能的 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)
+     */
+    async fetchSkillDefinition(sourceUrl) {
+        this.logger.info('OpenClawSkillSyncClient: 获取 SKILL.md 内容', {
+            sourceUrl,
+        });
+        // 优先尝试 raw URL
+        const rawUrl = this.convertToRawUrl(sourceUrl);
+        const { url, headers } = this.getGitHubRequestConfig(rawUrl);
+        try {
+            const response = await (0, rxjs_1.firstValueFrom)(this.httpService.get(url, { headers }).pipe((0, rxjs_1.timeout)(this.requestTimeout), (0, rxjs_1.catchError)((error) => {
+                throw error;
+            })));
+            const content = response.data;
+            this.logger.info('OpenClawSkillSyncClient: SKILL.md 获取成功 (raw)', {
+                contentLength: content.length,
+            });
+            return this.parseSkillMd(content, sourceUrl);
+        }
+        catch (rawError) {
+            this.logger.warn('OpenClawSkillSyncClient: raw URL 获取失败，尝试 GitHub API', {
+                rawUrl,
+                error: rawError instanceof Error ? rawError.message : 'Unknown error',
+            });
+        }
+        // Fallback: 使用 GitHub API（api.github.com 通常不被屏蔽）
+        const apiUrl = this.convertToApiUrl(sourceUrl);
+        if (!apiUrl) {
+            throw new Error(`无法将 sourceUrl 转换为 GitHub API URL: ${sourceUrl}`);
+        }
+        const apiHeaders = {
+            Accept: 'application/vnd.github.v3+json',
+        };
+        if (this.githubToken) {
+            apiHeaders['Authorization'] = `token ${this.githubToken}`;
+        }
+        try {
+            const response = await (0, rxjs_1.firstValueFrom)(this.httpService
+                .get(apiUrl, {
+                headers: apiHeaders,
+            })
+                .pipe((0, rxjs_1.timeout)(this.requestTimeout), (0, rxjs_1.catchError)((error) => {
+                this.handleGitHubError(error);
+            })));
+            this.checkRateLimit(response.headers);
+            const content = Buffer.from(response.data.content, 'base64').toString('utf-8');
+            this.logger.info('OpenClawSkillSyncClient: SKILL.md 获取成功 (GitHub API)', { contentLength: content.length });
+            return this.parseSkillMd(content, sourceUrl);
+        }
+        catch (error) {
+            this.logger.error('OpenClawSkillSyncClient: 获取 SKILL.md 全部失败', {
+                sourceUrl,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            throw error;
+        }
+    }
+    /**
+     * 将 GitHub tree URL 转换为 raw URL
+     */
+    convertToRawUrl(treeUrl) {
+        // https://github.com/openclaw/skills/tree/main/skills/author/slug/SKILL.md
+        // -> https://raw.githubusercontent.com/openclaw/skills/main/skills/author/slug/SKILL.md
+        return treeUrl
+            .replace('github.com', 'raw.githubusercontent.com')
+            .replace('/tree/', '/');
+    }
+    /**
+     * 将 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}
+     */
+    convertToApiUrl(treeUrl) {
+        const match = treeUrl.match(/github\.com\/([^/]+)\/([^/]+)\/tree\/([^/]+)\/(.+)/);
+        if (!match)
+            return null;
+        const [, owner, repo, ref, filePath] = match;
+        return `https://api.github.com/repos/${owner}/${repo}/contents/${filePath}?ref=${ref}`;
+    }
+    /**
+     * 将 SKILL.md 的 GitHub tree URL 转换为其所在目录的 API URL
+     */
+    convertToDirApiUrl(sourceUrl) {
+        const dirUrl = sourceUrl.replace(/\/SKILL\.md$/, '');
+        return this.convertToApiUrl(dirUrl);
+    }
+    /**
+     * 解析 SKILL.md 内容
+     * 提取 YAML frontmatter 和 Markdown 内容
+     */
+    parseSkillMd(content, sourceUrl) {
+        // 匹配 YAML frontmatter (--- ... ---)
+        const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+        if (!frontmatterMatch) {
+            // 没有 frontmatter，整个内容作为 Markdown
+            return {
+                name: '',
+                version: '1.0.0',
+                description: '',
+                content: content,
+                frontmatter: {},
+                sourceUrl,
+            };
+        }
+        const [, yamlContent, markdownContent] = frontmatterMatch;
+        // 使用 js-yaml 解析 YAML frontmatter
+        let frontmatter = {};
+        try {
+            const parsed = yaml.load(yamlContent);
+            frontmatter =
+                parsed && typeof parsed === 'object'
+                    ? parsed
+                    : {};
+        }
+        catch (error) {
+            this.logger.warn('OpenClawSkillSyncClient: YAML 解析失败，使用空对象', {
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+        }
+        return {
+            name: frontmatter.name || '',
+            version: String(frontmatter.version || '1.0.0'),
+            description: frontmatter.description || '',
+            homepage: frontmatter.homepage,
+            repository: frontmatter.repository,
+            userInvocable: frontmatter['user-invocable'],
+            tags: frontmatter.tags,
+            metadata: frontmatter.metadata,
+            content: markdownContent.trim(),
+            frontmatter,
+            sourceUrl,
+        };
+    }
+    /**
+     * 获取技能的完整目录内容
+     * 使用 GitHub Contents API 递归获取目录下所有文件
+     */
+    async fetchSkillDirectory(sourceUrl) {
+        const apiUrl = this.convertToDirApiUrl(sourceUrl);
+        if (!apiUrl) {
+            throw new Error(`无法解析目录 URL: ${sourceUrl}`);
+        }
+        const files = [];
+        const state = { totalSize: 0 };
+        await this.fetchDirectoryRecursive(apiUrl, '', files, state);
+        this.logger.info('OpenClawSkillSyncClient: 目录获取完成', {
+            sourceUrl,
+            fileCount: files.length,
+            totalSize: state.totalSize,
+        });
+        return files;
+    }
+    /**
+     * 递归获取 GitHub 目录内容
+     */
+    async fetchDirectoryRecursive(apiUrl, basePath, files, state) {
+        const apiHeaders = {
+            Accept: 'application/vnd.github.v3+json',
+        };
+        if (this.githubToken) {
+            apiHeaders['Authorization'] = `token ${this.githubToken}`;
+        }
+        const response = await (0, rxjs_1.firstValueFrom)(this.httpService
+            .get(apiUrl, { headers: apiHeaders })
+            .pipe((0, rxjs_1.timeout)(this.requestTimeout), (0, rxjs_1.catchError)((e) => {
+            this.handleGitHubError(e);
+        })));
+        this.checkRateLimit(response.headers);
+        for (const item of response.data) {
+            if (infra_contracts_1.SKILL_LIMITS.EXCLUDED_FILES.includes(item.name))
+                continue;
+            if (item.type === 'file') {
+                if (files.length >= infra_contracts_1.SKILL_LIMITS.MAX_FILE_COUNT) {
+                    throw new Error(`文件数量超过限制: ${infra_contracts_1.SKILL_LIMITS.MAX_FILE_COUNT}`);
+                }
+                state.totalSize += item.size;
+                if (state.totalSize > infra_contracts_1.SKILL_LIMITS.MAX_DIR_SIZE) {
+                    throw new Error(`目录总大小超过限制: ${infra_contracts_1.SKILL_LIMITS.MAX_DIR_SIZE} bytes`);
+                }
+                const relativePath = basePath ? `${basePath}/${item.name}` : item.name;
+                let content;
+                if (item.content && item.encoding === 'base64') {
+                    content = Buffer.from(item.content, 'base64').toString('utf-8');
+                }
+                else if (item.download_url) {
+                    const { url, headers } = this.getGitHubRequestConfig(item.download_url);
+                    const fileResponse = await (0, rxjs_1.firstValueFrom)(this.httpService
+                        .get(url, { headers, responseType: 'text' })
+                        .pipe((0, rxjs_1.timeout)(15000), (0, rxjs_1.catchError)((e) => {
+                        throw e;
+                    })));
+                    content =
+                        typeof fileResponse.data === 'string'
+                            ? fileResponse.data
+                            : JSON.stringify(fileResponse.data);
+                }
+                else {
+                    continue;
+                }
+                files.push({ relativePath, content, size: item.size });
+            }
+            else if (item.type === 'dir') {
+                const subDirUrl = apiUrl.replace(/\/contents\/[^?]+/, `/contents/${item.path}`);
+                await this.fetchDirectoryRecursive(subDirUrl, basePath ? `${basePath}/${item.name}` : item.name, files, state);
+            }
+        }
+    }
+    /**
+     * 获取 Skill 的 _meta.json 版本信息
+     * @param sourceUrl GitHub tree URL for SKILL.md
+     * @returns SkillMetaInfo or null if not found
+     */
+    async fetchSkillMeta(sourceUrl) {
+        const metaUrl = sourceUrl.replace(/SKILL\.md$/, '_meta.json');
+        // 尝试 raw URL
+        const rawUrl = this.convertToRawUrl(metaUrl);
+        const { url, headers } = this.getGitHubRequestConfig(rawUrl);
+        try {
+            const response = await (0, rxjs_1.firstValueFrom)(this.httpService.get(url, { headers }).pipe((0, rxjs_1.timeout)(15000), (0, rxjs_1.catchError)((e) => {
+                throw e;
+            })));
+            const data = typeof response.data === 'string'
+                ? JSON.parse(response.data)
+                : response.data;
+            return data;
+        }
+        catch {
+            // Fallback: GitHub API
+        }
+        const apiUrl = this.convertToApiUrl(metaUrl);
+        if (!apiUrl)
+            return null;
+        const apiHeaders = {
+            Accept: 'application/vnd.github.v3+json',
+        };
+        if (this.githubToken) {
+            apiHeaders['Authorization'] = `token ${this.githubToken}`;
+        }
+        try {
+            const response = await (0, rxjs_1.firstValueFrom)(this.httpService
+                .get(apiUrl, {
+                headers: apiHeaders,
+            })
+                .pipe((0, rxjs_1.timeout)(15000), (0, rxjs_1.catchError)((e) => {
+                this.handleGitHubError(e);
+            })));
+            this.checkRateLimit(response.headers);
+            const content = Buffer.from(response.data.content, 'base64').toString('utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * 从 TOS 获取技能列表
+     * 数据源: https://pardx.tos-cn-shanghai.volces.com/clawskills/skills.json
+     */
+    async fetchTosSkills() {
+        this.logger.info('OpenClawSkillSyncClient: 开始从 TOS 获取技能列表');
+        try {
+            const response = await (0, rxjs_1.firstValueFrom)(this.httpService.get(this.tosSkillsUrl).pipe((0, rxjs_1.timeout)(this.requestTimeout), (0, rxjs_1.catchError)((error) => {
+                this.logger.error('OpenClawSkillSyncClient: TOS 请求失败', {
+                    url: this.tosSkillsUrl,
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                });
+                throw error;
+            })));
+            // 防御性检查：确保 response.data.skills 存在
+            if (!response.data || !Array.isArray(response.data.skills)) {
+                this.logger.error('OpenClawSkillSyncClient: TOS 响应格式无效', {
+                    receivedData: response.data,
+                    expectedStructure: '{ skills: [], updatedAt, total, baseUrl }',
+                });
+                throw new Error('Invalid TOS response structure: skills array is missing');
+            }
+            this.logger.info('OpenClawSkillSyncClient: TOS 技能列表获取成功', {
+                total: response.data.total,
+                skillsCount: response.data.skills.length,
+                updatedAt: response.data.updatedAt,
+            });
+            return response.data;
+        }
+        catch (error) {
+            this.logger.error('OpenClawSkillSyncClient: 从 TOS 获取技能列表失败', {
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            throw error;
+        }
+    }
+};
+exports.OpenClawSkillSyncClient = OpenClawSkillSyncClient;
+exports.OpenClawSkillSyncClient = OpenClawSkillSyncClient = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(nest_winston_1.WINSTON_MODULE_PROVIDER)),
+    __metadata("design:paramtypes", [winston_1.Logger,
+        axios_1.HttpService,
+        config_1.ConfigService])
+], OpenClawSkillSyncClient);
+//# sourceMappingURL=openclaw-skill-sync.client.js.map