coding-tool-x 3.8.7 → 3.8.9

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/index.js

@@ -58,6 +58,30 @@ function traceStartupMemory(stage) {
   })}`);
 }
 
+async function refreshNativeCodexOAuthOnStartup({ oauthService } = {}) {
+  try {
+    const service = oauthService || require('../platforms/oauth-credentials-service');
+    if (typeof service.refreshNativeCodexOAuth !== 'function') {
+      return { available: false, refreshed: false, synchronized: false };
+    }
+    const result = await service.refreshNativeCodexOAuth();
+    if (result?.refreshed) {
+      console.log('[Codex OAuth] Native OAuth token refreshed during startup');
+    } else if (result?.refreshFailed) {
+      console.warn('[Codex OAuth] 启动刷新失败，请运行 codex login 重新登录');
+    }
+    return result;
+  } catch (error) {
+    console.warn(`[Codex OAuth] 启动同步失败，保留本地凭证: ${error.message}`);
+    return {
+      available: false,
+      refreshed: false,
+      synchronized: false,
+      error: error.message
+    };
+  }
+}
+
 function printPortConflictHelp(port) {
   console.log(chalk.yellow('\n[TIP] 解决方案:'));
   console.log(chalk.gray('   1. 运行 ctx 命令，选择"配置端口"修改端口'));
@@ -335,6 +359,7 @@ async function startServer(port, host = '127.0.0.1', options = {}) {
       console.log(chalk.yellow('   [LOCK] 已启用 LAN 安全保护：远程写操作默认关闭'));
     }
   }
+  await refreshNativeCodexOAuthOnStartup();
   // 自动恢复代理状态
   try {
     await autoRestoreProxies({ ...platformContext, config });
@@ -382,6 +407,10 @@ async function autoRestoreProxies({ registry, runtime, config, fsImpl = require(
     try {
       const result = await driver.restoreOnBoot({ config: resolvedConfig });
       if (!result || result.status === 'ok') {
+        const warnings = result?.warnings || result?.data?.warnings || result?.result?.warnings || [];
+        warnings.forEach((warning) => {
+          console.log(chalk.yellow(`[WARN]  ${platform.label || key}: ${warning}`));
+        });
         const port = result?.port;
         const suffix = port
           ? platform.proxyMode === 'managed'
@@ -464,5 +493,10 @@ async function performStartupHealthCheck({ config = loadConfig() } = {}) {
 
 module.exports = {
   startServer,
-  _test: { autoRestoreProxies, performStartupHealthCheck, traceStartupMemory }
+  _test: {
+    autoRestoreProxies,
+    performStartupHealthCheck,
+    traceStartupMemory,
+    refreshNativeCodexOAuthOnStartup
+  }
 };

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