@myassis/gateway 1.0.0

package/dist/routes/skills.js

@@ -0,0 +1,159 @@
+/**
+ * Gateway Skills 路由
+ * 用户已安装技能管理
+ */
+import express from 'express';
+import { skillsService } from '../services/index.js';
+import { persistStore } from '../stores/persistStore.js';
+import { getLogger } from '@pocketclaw/shared';
+import { requireAuth } from '../middleware/auth.js';
+const logger = getLogger('skills');
+const router = express.Router();
+router.use(requireAuth);
+/**
+ * 获取用户已安装的技能列表
+ * GET /api/v1/skills
+ */
+router.get('/', async (req, res) => {
+    try {
+        const result = await skillsService.list();
+        res.json(result);
+    }
+    catch (error) {
+        logger.error('获取技能列表失败:', error?.message);
+        res.status(500).json({ success: false, error: '获取技能列表失败' });
+    }
+});
+/**
+ * 解析技能内容（从脚本中提取技能元数据）
+ * POST /api/v1/skills/parse
+ */
+router.post('/parse', async (req, res) => {
+    try {
+        const { content } = req.body;
+        if (!content) {
+            return res.status(400).json({ success: false, error: '缺少 content 参数' });
+        }
+        const result = await skillsService.parse(content);
+        res.json(result);
+    }
+    catch (error) {
+        logger.error('解析技能内容失败:', error?.message);
+        res.status(500).json({ success: false, error: '解析技能内容失败' });
+    }
+});
+/**
+ * 获取单个技能详情
+ * GET /api/v1/skills/:id
+ */
+router.get('/:id', async (req, res) => {
+    try {
+        const skillId = req.params.id;
+        const result = await skillsService.get(skillId);
+        res.json(result);
+    }
+    catch (error) {
+        logger.error('获取技能详情失败:', error?.message);
+        res.status(500).json({ success: false, error: '获取技能详情失败' });
+    }
+});
+/**
+ * 安装技能（从技能库安装）或创建自定义技能
+ * POST /api/v1/skills
+ * - 有 skillHubId → 从技能库安装
+ * - 无 skillHubId → 创建自定义技能（需提供 name, content 等）
+ */
+router.post('/', async (req, res) => {
+    try {
+        const { skillHubId } = req.body;
+        if (skillHubId) {
+            // 从技能库安装
+            const hubId = String(skillHubId);
+            const result = await skillsService.install(hubId);
+            res.json(result);
+        }
+        else {
+            // 创建自定义技能
+            if (!req.body.name) {
+                return res.status(400).json({ success: false, error: '自定义技能必须提供 name' });
+            }
+            const result = await skillsService.create(req.body);
+            res.json(result);
+        }
+    }
+    catch (error) {
+        logger.error('安装/创建技能失败:', error?.message);
+        res.status(500).json({ success: false, error: error?.message || '操作失败' });
+    }
+});
+/**
+ * 更新技能
+ * PUT /api/v1/skills/:id
+ */
+router.put('/:id', async (req, res) => {
+    try {
+        const skillId = req.params.id;
+        const result = await skillsService.update(skillId, req.body);
+        res.json(result);
+    }
+    catch (error) {
+        logger.error('更新技能失败:', error?.message);
+        res.status(500).json({ success: false, error: '更新技能失败' });
+    }
+});
+/**
+ * 卸载技能
+ * DELETE /api/v1/skills/:id
+ */
+router.delete('/:id', async (req, res) => {
+    try {
+        const skillId = req.params.id;
+        const result = await skillsService.uninstall(skillId);
+        res.json(result);
+    }
+    catch (error) {
+        logger.error('卸载技能失败:', error?.message);
+        res.status(500).json({ success: false, error: '卸载技能失败' });
+    }
+});
+/**
+ * 设置技能 API Key（本地存储，不上传服务端）
+ * POST /api/v1/skills/:id/api-key
+ */
+router.post('/:id/api-key', async (req, res) => {
+    try {
+        const skillId = req.params.id;
+        const { apiKey, apiBaseUrl } = req.body;
+        if (!apiKey) {
+            return res.status(400).json({ success: false, error: '缺少 apiKey 参数' });
+        }
+        // 只存储到本地，不发送到服务端
+        persistStore.setSkillApiKey(skillId, apiKey);
+        logger.info(`Skill API Key stored locally for skill: ${skillId}`);
+        res.json({ success: true, message: 'API Key 已保存到本地' });
+    }
+    catch (error) {
+        logger.error('设置 API Key 失败:', error?.message);
+        res.status(500).json({ success: false, error: '设置 API Key 失败' });
+    }
+});
+/**
+ * 技能评分
+ * POST /api/v1/skills/:id/rating
+ */
+router.post('/:id/rating', async (req, res) => {
+    try {
+        const skillId = req.params.id;
+        const { score } = req.body;
+        if (!score || score < 1 || score > 5) {
+            return res.status(400).json({ success: false, error: '评分必须在 1-5 之间' });
+        }
+        const result = await skillsService.rate(skillId, score);
+        res.json(result);
+    }
+    catch (error) {
+        logger.error('评分失败:', error?.message);
+        res.status(500).json({ success: false, error: '评分失败' });
+    }
+});
+export default router;

package/dist/routes/tasks.js

@@ -0,0 +1,149 @@
+/**
+ * Gateway Tasks 路由
+ * 任务管理
+ */
+import express from 'express';
+import { tasksService } from '../services/index.js';
+import { getLogger } from '@pocketclaw/shared';
+import { requireAuth } from '../middleware/auth.js';
+const logger = getLogger('tasks');
+const router = express.Router();
+router.use(requireAuth);
+/**
+ * 获取任务列表
+ * GET /api/v1/tasks
+ */
+router.get('/', async (req, res) => {
+    try {
+        const { status, page, pageSize } = req.query;
+        const userId = req.userId;
+        const result = await tasksService.list({ status, page, pageSize }, userId);
+        res.json(result);
+    }
+    catch (error) {
+        logger.error('获取任务列表失败:', error?.message);
+        res.status(500).json({ success: false, error: '获取任务列表失败' });
+    }
+});
+/**
+ * 获取单个任务详情
+ * GET /api/v1/tasks/:id
+ */
+router.get('/:id', async (req, res) => {
+    try {
+        const taskId = req.params.id;
+        const result = await tasksService.get(taskId);
+        res.json(result);
+    }
+    catch (error) {
+        logger.error('获取任务详情失败:', error?.message);
+        res.status(500).json({ success: false, error: '获取任务详情失败' });
+    }
+});
+/**
+ * 创建任务
+ * POST /api/v1/tasks
+ */
+router.post('/', async (req, res) => {
+    try {
+        const userId = req.userId;
+        const result = await tasksService.create(req.body, String(userId));
+        res.json(result);
+    }
+    catch (error) {
+        logger.error('创建任务失败:', error?.message);
+        res.status(500).json({ success: false, error: '创建任务失败' });
+    }
+});
+/**
+ * 更新任务
+ * PUT /api/v1/tasks/:id
+ */
+router.put('/:id', async (req, res) => {
+    try {
+        const taskId = req.params.id;
+        const result = await tasksService.update(taskId, req.body);
+        res.json(result);
+    }
+    catch (error) {
+        logger.error('更新任务失败:', error?.message);
+        res.status(500).json({ success: false, error: '更新任务失败' });
+    }
+});
+/**
+ * 删除任务
+ * DELETE /api/v1/tasks/:id
+ */
+router.delete('/:id', async (req, res) => {
+    try {
+        const taskId = req.params.id;
+        const result = await tasksService.delete(taskId);
+        res.json(result);
+    }
+    catch (error) {
+        logger.error('删除任务失败:', error?.message);
+        res.status(500).json({ success: false, error: '删除任务失败' });
+    }
+});
+/**
+ * 开始任务
+ * POST /api/v1/tasks/:id/start
+ */
+router.post('/:id/start', async (req, res) => {
+    try {
+        const taskId = req.params.id;
+        const result = await tasksService.updateStatus(taskId, 'running');
+        res.json(result);
+    }
+    catch (error) {
+        logger.error('开始任务失败:', error?.message);
+        res.status(500).json({ success: false, error: '开始任务失败' });
+    }
+});
+/**
+ * 完成任务
+ * POST /api/v1/tasks/:id/complete
+ */
+router.post('/:id/complete', async (req, res) => {
+    try {
+        const taskId = req.params.id;
+        const result = await tasksService.updateStatus(taskId, 'completed');
+        res.json(result);
+    }
+    catch (error) {
+        logger.error('完成任务失败:', error?.message);
+        res.status(500).json({ success: false, error: '完成任务失败' });
+    }
+});
+/**
+ * 取消任务
+ * POST /api/v1/tasks/:id/cancel
+ */
+router.post('/:id/cancel', async (req, res) => {
+    try {
+        const taskId = req.params.id;
+        const result = await tasksService.cancel(taskId);
+        res.json(result);
+    }
+    catch (error) {
+        logger.error('取消任务失败:', error?.message);
+        res.status(500).json({ success: false, error: '取消任务失败' });
+    }
+});
+/**
+ * 更新任务状态
+ * POST /api/v1/tasks/:id/status
+ */
+router.post('/:id/status', async (req, res) => {
+    try {
+        const taskId = req.params.id;
+        const { status } = req.body;
+        const result = await tasksService.updateStatus(taskId, status);
+        res.json(result);
+    }
+    catch (error) {
+        logger.error('更新任务状态失败:', error?.message);
+        res.status(500).json({ success: false, error: '更新任务状态失败' });
+    }
+});
+export default router;

package/dist/routes/upload.js

@@ -0,0 +1,129 @@
+import { Router } from 'express';
+import multer from 'multer';
+import { appConfig } from '@/config/index.js';
+import { requireAuth } from '@/middleware/auth.js';
+import { getLogger } from '@pocketclaw/shared';
+const logger = getLogger('UploadRoutes');
+const router = Router();
+router.use(requireAuth);
+// 配置 multer 用于解析 multipart/form-data
+const upload = multer({
+    storage: multer.memoryStorage(),
+    limits: {
+        fileSize: 50 * 1024 * 1024, // 50MB
+    },
+});
+/**
+ * Allowed file extensions for upload
+ */
+const ALLOWED_UPLOAD_EXTS = new Set([
+    // Images
+    '.jpg', '.jpeg', '.png', '.gif', '.webp', '.svg', '.bmp', '.ico',
+    // Documents
+    '.pdf', '.doc', '.docx', '.xls', '.xlsx', '.ppt', '.pptx', '.txt', '.csv', '.md',
+    // Audio
+    '.mp3', '.wav', '.ogg', '.flac', '.aac', '.m4a',
+    // Video
+    '.mp4', '.webm', '.avi', '.mov', '.mkv',
+    // Archives
+    '.zip', '.rar', '.7z', '.tar', '.gz',
+    // Code
+    '.js', '.ts', '.jsx', '.tsx', '.py', '.go', '.rs', '.java', '.json', '.yaml', '.yml', '.toml', '.xml', '.html', '.css', '.sh', '.bat', '.ps1',
+]);
+function getFileExt(filename) {
+    const idx = filename.lastIndexOf('.');
+    return idx >= 0 ? filename.substring(idx).toLowerCase() : '';
+}
+/**
+ * POST /api/v1/upload
+ * 上传文件到 OSS（代理到 Server）
+ */
+router.post('/', upload.single('file'), async (req, res) => {
+    try {
+        if (!req.file) {
+            res.status(400).json({ success: false, error: '没有上传文件' });
+            return;
+        }
+        // File type validation
+        const ext = getFileExt(req.file.originalname);
+        if (!ALLOWED_UPLOAD_EXTS.has(ext)) {
+            res.status(400).json({ success: false, error: `不支持的文件类型: ${ext}` });
+            return;
+        }
+        // 创建 FormData 并转发到 Server
+        const formData = new FormData();
+        formData.append('file', new Blob([req.file.buffer], { type: req.file.mimetype }), req.file.originalname);
+        const response = await fetch(`${appConfig.serverBaseUrl}/api/v1/upload`, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${req.token}`,
+            },
+            body: formData,
+        });
+        const text = await response.text();
+        let result;
+        try {
+            result = JSON.parse(text);
+        }
+        catch {
+            logger.error('Invalid JSON from server:', text.substring(0, 200));
+            res.status(500).json({ success: false, error: 'Upload server error' });
+            return;
+        }
+        res.status(response.status).json(result);
+    }
+    catch (error) {
+        logger.error('Proxy upload error:', error);
+        res.status(500).json({ success: false, error: 'Upload failed' });
+    }
+});
+/**
+ * DELETE /api/v1/upload
+ * 从 OSS 删除文件（代理到 Server）
+ */
+router.delete('/', async (req, res) => {
+    try {
+        // 从 query 参数获取文件 keys（逗号分隔）
+        const keysParam = req.query.keys;
+        if (!keysParam) {
+            res.status(400).json({ success: false, error: '缺少文件 keys 参数' });
+            return;
+        }
+        // 转发到 Server
+        const response = await fetch(`${appConfig.serverBaseUrl}/api/v1/upload?keys=${encodeURIComponent(keysParam)}`, {
+            method: 'DELETE',
+            headers: {
+                'Authorization': `Bearer ${req.token}`,
+            },
+        });
+        const text = await response.text();
+        let result;
+        try {
+            result = JSON.parse(text);
+        }
+        catch {
+            logger.error('Invalid JSON from server:', text.substring(0, 200));
+            res.status(500).json({ success: false, error: 'Delete server error' });
+            return;
+        }
+        res.status(response.status).json(result);
+    }
+    catch (error) {
+        logger.error('Proxy delete error:', error);
+        res.status(500).json({ success: false, error: 'Delete failed' });
+    }
+});
+export async function deleteFile(url, token) {
+    const response = await fetch(`${appConfig.serverBaseUrl}/api/v1/upload`, {
+        method: 'DELETE',
+        headers: {
+            'Content-Type': 'application/json',
+            'Authorization': token ? `Bearer ${token}` : '',
+        },
+        body: JSON.stringify({ url }),
+    });
+    if (!response.ok) {
+        throw new Error(`Delete failed: ${response.status}`);
+    }
+}
+export default router;

package/dist/routes/version.js

@@ -0,0 +1,66 @@
+import express from 'express';
+import axios from 'axios';
+import { appConfig } from '../config/index.js';
+import { optionalAuth } from '../middleware/auth.js';
+import { readFileSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { getLogger } from '@pocketclaw/shared';
+const logger = getLogger('VersionRoutes');
+const router = express.Router();
+// ESM 兼容的 __dirname
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * 获取 Gateway 本地版本及运行方式
+ * GET /api/v1/version/local
+ */
+router.get('/local', async (req, res) => {
+    try {
+        // 读取 package.json 获取版本
+        const packageJsonPath = resolve(__dirname, '../../package.json');
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+        // 判断运行方式：pkg 打包的 exe 会有 (process as any).pkg
+        const runMode = process.pkg ? 'exe' : 'node';
+        res.json({
+            success: true,
+            data: {
+                version: packageJson.version,
+                runMode,
+                execPath: process.execPath,
+            },
+        });
+    }
+    catch (error) {
+        logger.error('获取本地版本失败:', error);
+        res.status(500).json({
+            success: false,
+            error: error instanceof Error ? error.message : '获取本地版本失败',
+        });
+    }
+});
+/**
+ * 转发到服务端接口
+ */
+router.get('/latest', optionalAuth, async (req, res) => {
+    try {
+        const serverBaseUrl = appConfig.serverBaseUrl || 'https://api.pocketclaw.ai';
+        const response = await axios.get(`${serverBaseUrl}/api/v1/version/latest`, {
+            timeout: 10000,
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: req.token ? `Bearer ${req.token}` : '',
+            },
+            params: req.query, // 转发所有查询参数，包括lang
+        });
+        res.json(response.data);
+    }
+    catch (error) {
+        logger.error('获取版本信息失败:', error);
+        res.status(500).json({
+            success: false,
+            error: error instanceof Error ? error.message : '获取版本信息失败',
+        });
+    }
+});
+export default router;

package/dist/services/HMSPushService.js

@@ -0,0 +1,24 @@
+/**
+ * HMS Push 服务（华为设备专用）
+ */
+class HMSPushService {
+    /**
+     * 检查服务是否可用
+     */
+    isAvailable() {
+        return false;
+    }
+    /**
+     * 发送推送消息
+     */
+    async send(token, payload, options) {
+        return { success: false };
+    }
+    /**
+     * 批量发送
+     */
+    async sendToMany(tokens, payload, options) {
+        return { success: false, sent: 0, failed: tokens.length };
+    }
+}
+export const hmsPushService = new HMSPushService();