@morehao/dsh-skills-console 0.5.0 → 0.5.2

package/lib/routes.js

@@ -73,6 +73,11 @@ function matchRoute(method, pathname) {
   if (segments[0] === 'skills' && segments.length === 3 && segments[2] === 'files' && method === 'GET') {
     return { name: 'skill.files', params: { name: decodeURIComponent(segments[1]) } };
   }
+  // 技能介绍（模型生成）：GET 只读缓存，POST 才真正调模型
+  if (segments[0] === 'skills' && segments.length === 3 && segments[2] === 'intro') {
+    if (method === 'GET') return { name: 'skill.intro.get', params: { name: decodeURIComponent(segments[1]) } };
+    if (method === 'POST') return { name: 'skill.intro.generate', params: { name: decodeURIComponent(segments[1]) } };
+  }
   if (segments[0] === 'skills' && segments.length === 3 && segments[2] === 'adopt' && method === 'POST') {
     return { name: 'skill.adopt', params: { name: decodeURIComponent(segments[1]) } };
   }
@@ -97,6 +102,13 @@ function matchRoute(method, pathname) {
     if (segments.length === 3 && segments[2] === 'refresh' && method === 'POST') {
       return { name: 'subscriptions.refresh', params: { id: decodeURIComponent(segments[1]) } };
     }
+    // 订阅候选的介绍：路径由服务端按快照反查，客户端只给订阅 id + 条目名
+    if (segments.length === 5 && segments[2] === 'entries' && segments[4] === 'intro') {
+      const id = decodeURIComponent(segments[1]);
+      const entryName = decodeURIComponent(segments[3]);
+      if (method === 'GET') return { name: 'subscription.intro.get', params: { id, name: entryName } };
+      if (method === 'POST') return { name: 'subscription.intro.generate', params: { id, name: entryName } };
+    }
   }
 
   if (segments[0] === 'updates') {
@@ -129,13 +141,24 @@ export function createRoutes({ service, logger }) {
       return;
     }
 
+    // 客户端断开（关抽屉 / 关页面）就取消模型调用：摘要是一次性辅助请求，没必要跑完再丢。
+    // 测试里的 fake res 没有 on/off，所以要按能力探测。
+    const abort = new AbortController();
+    const onClose = () => {
+      if (!res.writableEnded) abort.abort();
+    };
+    if (typeof res.on === 'function') res.on('close', onClose);
+
     try {
       service.reloadState();
       const body = method === 'GET' ? {} : await readBody(req);
       const query = Object.fromEntries(url.searchParams.entries());
-      const result = await dispatch(route, { body, query, service });
+      const result = await dispatch(route, { body, query, service, signal: abort.signal });
+      // 生成期间客户端可能已经走了：往已关闭的响应写会抛 ERR_STREAM_WRITE_AFTER_END
+      if (res.writableEnded || res.destroyed) return;
       sendJson(res, 200, result);
     } catch (error) {
+      if (res.writableEnded || res.destroyed) return;
       if (error instanceof StateReadOnlyError) {
         sendJson(res, 409, {
           ok: false,
@@ -152,11 +175,13 @@ export function createRoutes({ service, logger }) {
       }
       logger('route.error', { message: error?.message, stack: String(error?.stack || '').slice(0, 800) });
       sendJson(res, 500, { ok: false, code: 'error.skills.internal', message: error?.message || 'internal error' });
+    } finally {
+      if (typeof res.off === 'function') res.off('close', onClose);
     }
   };
 }
 
-async function dispatch(route, { body, query, service }) {
+async function dispatch(route, { body, query, service, signal = null }) {
   switch (route.name) {
     case 'state': {
       const state = await service.getState({ cwd: query.cwd || body.cwd, workspace: query.workspace });
@@ -180,6 +205,29 @@ async function dispatch(route, { body, query, service }) {
       return service.listSkillBody({ name: route.params.name, path: query.path });
     case 'skill.files':
       return service.listSkillFiles({ name: route.params.name });
+    case 'skill.intro.get':
+      return service.getSkillIntro({ name: route.params.name, lang: query.lang });
+    case 'subscription.intro.get':
+      return service.getRemoteIntro({
+        subscriptionId: route.params.id,
+        name: route.params.name,
+        lang: query.lang,
+      });
+    case 'subscription.intro.generate':
+      return service.generateRemoteIntro({
+        subscriptionId: route.params.id,
+        name: route.params.name,
+        lang: body.lang ?? query.lang,
+        force: body.force === true,
+        signal,
+      });
+    case 'skill.intro.generate':
+      return service.generateSkillIntro({
+        name: route.params.name,
+        lang: body.lang ?? query.lang,
+        force: body.force === true,
+        signal,
+      });
     case 'skill.adopt':
       return service.adopt({ name: route.params.name });
     case 'skill.mode':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morehao/dsh-skills-console",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "统一管理本地技能的安装、更新、删除与接入，让同一份技能在多个 Agent 间复用。A skill manager for DeepSeek Harness: install, update, remove, link and toggle agent skills.",
   "license": "MIT",
   "author": "morehao <morehao@qq.com>",