coding-tool-x 3.8.6 → 3.8.8

package/src/server/api/platform-api-config.js

@@ -33,20 +33,41 @@ function requestContext(request, manifest, route, config) {
 
 function projectPayload(data, context) {
   if (Array.isArray(data)) {
-    return { projects: data, currentProject: null, meta: {} };
+    return {
+      projects: data,
+      currentProject: null,
+      pagination: { page: 1, limit: data.length || 20, total: data.length, hasMore: false },
+      meta: {}
+    };
   }
   const payload = cloneObject(data);
   if (!Array.isArray(payload.projects)) payload.projects = [];
   if (!Object.prototype.hasOwnProperty.call(payload, 'currentProject')) payload.currentProject = null;
   if (!payload.meta || typeof payload.meta !== 'object' || Array.isArray(payload.meta)) payload.meta = {};
+  if (!payload.pagination || typeof payload.pagination !== 'object') {
+    payload.pagination = { page: 1, limit: payload.projects.length || 20, total: payload.projects.length, hasMore: false };
+  }
   return payload;
 }
 
 function sessionPayload(data) {
-  if (Array.isArray(data)) return { sessions: data, meta: {} };
+  if (Array.isArray(data)) {
+    return {
+      sessions: data,
+      totalSize: data.reduce((sum, session) => sum + (Number(session?.size) || 0), 0),
+      pagination: { page: 1, limit: data.length || 20, total: data.length, hasMore: false },
+      meta: {}
+    };
+  }
   const payload = cloneObject(data);
   if (!Array.isArray(payload.sessions)) payload.sessions = [];
   if (!payload.meta || typeof payload.meta !== 'object' || Array.isArray(payload.meta)) payload.meta = {};
+  if (!payload.pagination || typeof payload.pagination !== 'object') {
+    payload.pagination = { page: 1, limit: payload.sessions.length || 20, total: payload.sessions.length, hasMore: false };
+  }
+  if (!Object.prototype.hasOwnProperty.call(payload, 'totalSize')) {
+    payload.totalSize = payload.sessions.reduce((sum, session) => sum + (Number(session?.size) || 0), 0);
+  }
   return payload;
 }
 

package/src/server/api/platform-route-factory.js

@@ -63,9 +63,16 @@ function makeUnsupported(context) {
   };
 }
 function legacyArguments(route, request) {
-  if (route.capability === 'projects' && route.operation === 'listProjects') return [{ force: request.query?.fresh === '1' }];
+  const listOptions = () => {
+    const options = { force: request.query?.fresh === '1' };
+    if (request.query?.page != null) options.page = request.query.page;
+    if (request.query?.limit != null) options.limit = request.query.limit;
+    if (request.query?.q || request.query?.search) options.q = request.query.q || request.query.search;
+    return options;
+  };
+  if (route.capability === 'projects' && route.operation === 'listProjects') return [listOptions()];
   if (route.capability === 'sessions' && route.operation === 'listSessions') {
-    return [request.params.projectName, { force: request.query?.fresh === '1' }];
+    return [request.params.projectName, listOptions()];
   }
   if (route.capability === 'channels') {
     if (route.method === 'POST') return [request.body || {}];

package/src/server/api/platforms.js

@@ -19,7 +19,8 @@ const PUBLIC_FIELDS = Object.freeze([
   'apiPrefix',
   'modelCatalogKey',
   'promptLabel',
-  'resourceTypes'
+  'resourceTypes',
+  'resourceActions'
 ]);
 
 function publicCapabilities(capabilities) {
@@ -41,6 +42,18 @@ function publicResourceTypes(resourceTypes) {
   );
 }
 
+function publicResourceActions(resourceActions) {
+  if (!resourceActions || typeof resourceActions !== 'object' || Array.isArray(resourceActions)) {
+    return null;
+  }
+  return Object.fromEntries(Object.entries(resourceActions).map(([resourceType, actions]) => [
+    resourceType,
+    actions && typeof actions === 'object' && !Array.isArray(actions)
+      ? Object.fromEntries(Object.entries(actions).filter(([, value]) => typeof value === 'boolean'))
+      : {}
+  ]));
+}
+
 function toPublicDefinition(definition) {
   if (!definition || typeof definition !== 'object') return null;
   const result = {};
@@ -50,6 +63,11 @@ function toPublicDefinition(definition) {
       if (resourceTypes) result.resourceTypes = resourceTypes;
       continue;
     }
+    if (field === 'resourceActions') {
+      const resourceActions = publicResourceActions(definition.resourceActions);
+      if (resourceActions) result.resourceActions = resourceActions;
+      continue;
+    }
     if (field === 'apiPrefix') {
       const apiPrefix = definition.apiPrefix ?? definition.api?.prefix;
       if (apiPrefix !== undefined) result.apiPrefix = apiPrefix || null;

package/src/server/api/plugins.js

@@ -5,7 +5,10 @@
  */
 
 const express = require('express');
+const path = require('path');
 const { PluginsService } = require('../services/plugins-service');
+const { SkillRefreshTaskService } = require('../services/skill-refresh-task-service');
+const { PATHS } = require('../../config/paths');
 const { maskToken } = require('../services/oauth-utils');
 const { sendApiError } = require('./validation-errors');
 const { resolveManagedPlatform } = require('../services/platform-resolution');
@@ -13,6 +16,13 @@ const { validateKnownProjectCwd } = require('../services/project-path-validation
 
 const router = express.Router();
 const pluginServices = new Map();
+let routerOptions = {};
+let defaultRefreshTasks;
+
+router.createRouter = (options = {}) => {
+  routerOptions = options;
+  return router;
+};
 
 function resolvePlatform(rawPlatform) {
   return resolveManagedPlatform(rawPlatform);
@@ -35,6 +45,26 @@ function getPluginsService(req) {
   };
 }
 
+function getPluginServiceForPlatform(platform) {
+  if (!pluginServices.has(platform)) {
+    pluginServices.set(platform, new PluginsService(platform));
+  }
+  return pluginServices.get(platform);
+}
+
+function getRefreshTasks() {
+  if (routerOptions.refreshTasks) return routerOptions.refreshTasks;
+  if (!defaultRefreshTasks) {
+    const persistencePath = PATHS.pluginRefreshTasks
+      || path.join(PATHS.storage || process.cwd(), 'runtime', 'plugin-refresh-tasks.json');
+    defaultRefreshTasks = new SkillRefreshTaskService({
+      persistencePath,
+      worker: context => getPluginServiceForPlatform(context.platform).refreshRemotePlugins(context)
+    });
+  }
+  return defaultRefreshTasks;
+}
+
 async function getRequestOptions(req, service) {
   const scope = String(req.query?.scope || req.body?.scope || '').trim();
   if (scope && scope !== 'user' && scope !== 'project') {
@@ -147,11 +177,15 @@ router.get('/', async (req, res) => {
     const { platform, service, warning } = getPluginsService(req);
     const options = await getRequestOptions(req, service);
     const result = invokeWithOptions(service.listPlugins.bind(service), [], options);
+    const plugins = typeof service.sanitizePluginList === 'function'
+      ? service.sanitizePluginList(result.plugins)
+      : result.plugins;
 
     res.json({
       success: true,
       platform,
       ...result,
+      plugins,
       ...(warning ? { warnings: [warning] } : {})
     });
   } catch (err) {
@@ -168,12 +202,11 @@ router.get('/market', async (req, res) => {
   try {
     const { platform, service, warning } = getPluginsService(req);
     const options = await getRequestOptions(req, service);
-    const forceRefresh = req.query.refresh === '1';
-    if (forceRefresh) {
-      console.log(`[Plugins API] Refreshing market plugins for ${platform}...`);
-    }
-    const plugins = await invokeWithOptions(service.getMarketPlugins.bind(service), [forceRefresh], options);
-    console.log(`[Plugins API] ${platform}: ${plugins.length} market plugins loaded (refresh=${forceRefresh})`);
+    const marketPlugins = await invokeWithOptions(service.getMarketPlugins.bind(service), [false], options);
+    const plugins = typeof service.sanitizePluginList === 'function'
+      ? service.sanitizePluginList(marketPlugins)
+      : marketPlugins;
+    console.log(`[Plugins API] ${platform}: ${plugins.length} cached market plugins loaded`);
 
     res.json({
       success: true,
@@ -187,6 +220,53 @@ router.get('/market', async (req, res) => {
   }
 });
 
+/**
+ * 启动插件远端全量缓存任务
+ * POST /api/plugins/refresh
+ */
+router.post('/refresh', async (req, res) => {
+  try {
+    const { platform, service } = getPluginsService(req);
+    const options = await getRequestOptions(req, service);
+    const refreshTasks = getRefreshTasks();
+    if (!refreshTasks) throw new Error('Plugin refresh task service is unavailable');
+    const task = refreshTasks.enqueue({
+      platform,
+      scope: options.scope || 'user',
+      projectPath: options.scope === 'project' ? options.cwd : null,
+      reason: 'manual'
+    });
+    res.status(202).json({ success: true, platform, task });
+  } catch (err) {
+    console.error('[Plugins API] Refresh plugins error:', err);
+    sendApiError(res, err);
+  }
+});
+
+router.get('/refresh/:taskId', async (req, res) => {
+  try {
+    const { platform, service } = getPluginsService(req);
+    const options = await getRequestOptions({ query: req.query }, service);
+    const refreshTasks = getRefreshTasks();
+    const task = refreshTasks?.get(req.params.taskId);
+    if (!task) return res.status(404).json({ success: false, message: 'Refresh task not found' });
+    const taskScope = task.scope || 'user';
+    const taskProjectPath = taskScope === 'project' ? (task.projectPath || null) : null;
+    const requestedProjectPath = options.scope === 'project' ? (options.cwd || null) : null;
+    if (
+      task.platform !== platform
+      || taskScope !== (options.scope || 'user')
+      || taskProjectPath !== requestedProjectPath
+    ) {
+      return res.status(404).json({ success: false, message: 'Refresh task not found' });
+    }
+    return res.json({ success: true, task });
+  } catch (err) {
+    console.error('[Plugins API] Get refresh task error:', err);
+    return sendApiError(res, err);
+  }
+});
+
 /**
  * 安装插件
  * POST /api/plugins/install
@@ -435,20 +515,26 @@ router.put('/repos/auth', (req, res) => {
 });
 
 /**
- * 同步仓库到 Claude Code marketplace
+ * Legacy alias for the explicit plugin refresh task.
  * POST /api/plugins/repos/sync
  */
 router.post('/repos/sync', async (req, res) => {
   try {
     const { platform, service } = getPluginsService(req);
     const options = await getRequestOptions(req, service);
-    const result = await service.syncRepos(options);
+    const refreshTasks = getRefreshTasks();
+    const task = refreshTasks.enqueue({
+      platform,
+      scope: options.scope || 'user',
+      projectPath: options.scope === 'project' ? options.cwd : null,
+      reason: 'manual'
+    });
 
-    res.json({
+    res.status(202).json({
       success: true,
       platform,
-      ...result,
-      message: 'Repositories synced successfully'
+      task,
+      message: 'Plugin refresh task started'
     });
   } catch (err) {
     console.error('[Plugins API] Sync repos error:', err);
@@ -487,6 +573,7 @@ router.get('/:name/readme', async (req, res) => {
   try {
     const { platform, service } = getPluginsService(req);
     const { name } = req.params;
+    const options = await getRequestOptions(req, service);
     const {
       repoId,
       repoProvider,
@@ -499,7 +586,9 @@ router.get('/:name/readme', async (req, res) => {
       repoUrl,
       repoProjectPath,
       repoLocalPath,
-      installPath
+      installPath,
+      scope: queryScope,
+      cwd: queryCwd
     } = req.query;
 
     const pluginInfo = {
@@ -518,7 +607,13 @@ router.get('/:name/readme', async (req, res) => {
       installPath
     };
 
-    const readme = await service.getPluginReadme(pluginInfo);
+    const readmeOptions = {
+      ...(options.scope || queryScope ? { scope: options.scope || queryScope } : {}),
+      ...(options.cwd || queryCwd ? { cwd: options.cwd || queryCwd } : {})
+    };
+    const readme = Object.keys(readmeOptions).length > 0
+      ? await service.getPluginReadme(pluginInfo, readmeOptions)
+      : await service.getPluginReadme(pluginInfo);
 
     res.json({
       success: true,

package/src/server/services/config-registry-service.js

@@ -32,9 +32,18 @@ const CLAUDE_DIRS = {
 // Valid config types
 const CONFIG_TYPES = ['skills', 'commands', 'agents', 'plugins'];
 
+function supportsManagedResources(platform) {
+  const resourceTypes = platform?.resourceTypes;
+  if (!resourceTypes || typeof resourceTypes !== 'object' || Array.isArray(resourceTypes)) {
+    return true;
+  }
+  return CONFIG_TYPES.some(type => resourceTypes[type] !== false);
+}
+
 function getSupportedPlatforms(registry = getPlatformContext().registry) {
   if (!registry || typeof registry.list !== 'function') return [];
   return registry.list()
+    .filter(supportsManagedResources)
     .map(platform => platform && platform.key)
     .filter(Boolean);
 }
@@ -43,7 +52,7 @@ function buildPlatformSupport(registry = getPlatformContext().registry) {
   const support = Object.fromEntries(CONFIG_TYPES.map(type => [type, {}]));
   for (const platform of (registry?.list?.() || [])) {
     const key = platform && platform.key;
-    if (!key) continue;
+    if (!key || !supportsManagedResources(platform)) continue;
     const resourceDriver = platform.capabilities?.resourceSync;
     for (const type of CONFIG_TYPES) {
       const typeCapability = platform.capabilities && Object.prototype.hasOwnProperty.call(platform.capabilities, type)

package/src/server/services/config-templates-service.js

@@ -26,6 +26,7 @@ function getAiConfigMap(registry = getPlatformContext().registry) {
   return Object.fromEntries(
     registry.list({ enabledOnly: true })
       .filter(platform => platform && platform.key)
+      .filter(platform => platform.resourceTypes?.commands !== false)
       .map(platform => [platform.key, {
         fileName: platform.promptFile || null,
         name: platform.promptLabel