@weibaohui/skills-management 0.1.4 → 0.1.6

package/README.md

@@ -5,13 +5,17 @@
 
 **技能市场插件**：一个页面管理本机所有 coding agent 的技能，还能浏览安装 6600+ 的 ntd 技能市场。
 
+![技能市场：从本机技能浏览到 ntd 市场安装](docs/demo.gif)
+
 ## 核心功能
 
 - **全来源扫描**：自动扫描本机各 coding agent 的技能目录（Claude、ZCode、Codex 等十余个执行器），统一在一个页面查看、查看详情、单文件预览
 - **一键收编**：任意执行器的技能可一键复制进 DSH 用户库，供模型的 `skill` 工具直接调用
 - **技能市场**：内置 ntd 技能合集（6600+ 条），按来源分组浏览、搜索筛选、详情预览、一键安装
 - **模型可见性治理**：每个已装技能都有「模型可调用」开关，不想暴露给模型的技能一键隐藏/恢复
+- **输入框 ＋技能**：composer 工具行新增「＋技能」按钮，弹出技能候选菜单，选中即把 `/技能名` 写入草稿，发送时技能内容注入该条消息
 - **市场自动同步**：市场仓库自动克隆与每日更新（可关），支持 GitCode 私有仓库 access token
+- **稀疏检出**：ntd-resource 仓库同时携带专家/模板等子树，市场只检出 `skills` 子目录（git partial clone + sparse-checkout），省一半以上流量与磁盘；已有全量检出会在下次同步时原地转换
 - **软链布局兼容**：各执行器目录间软链共享的技能不会重复展示
 
 ## 安装

package/client/bundle.js

@@ -74,6 +74,37 @@ window.__ModuleLoader__.load({
     let sessionsApi = null
     const sessionsSvc = () => sessionsApi
 
+    // Composer services (inputTriggers + sessions) for the ＋技能 button: opens
+    // the `skill` source (registered by dsh-client-ui-skill) as a menu. Absence
+    // hides the button; nothing else depends on it.
+    let composerScope = null
+
+    /**
+     * Open one registered '/' source over a synthetic collapsed span appended at
+     * the draft end (host toggleCommandMenu 同款调用形状；标准 kit 不暴露光标，
+     * pick 依赖 span-CAS：点击后草稿若再变动则本次 pick 静默作废）。
+     */
+    function openTriggerSource(scope, sessionId, input, sourceName) {
+      const inputTriggers = scope && scope.inputTriggers
+      const sessions = scope && scope.sessions
+      if (!inputTriggers || !sessions) return false
+      let actx
+      try { actx = sessions.scope(sessionId) } catch { return false }
+      if (actx === undefined || actx === null) return false
+      let controller
+      try { controller = inputTriggers.sessionOf(actx) } catch { return false }
+      const draft = (input && input.draft) || ''
+      const at = draft.length
+      controller.toggleSource(sourceName, {
+        trigger: '/',
+        query: '',
+        quoted: false,
+        position: draft.trim() === '' ? 'leading' : 'inline',
+        span: { start: at, end: at, draftRev: (input && input.draftRev) || 0 },
+      })
+      return true
+    }
+
     // ── Locale ───────────────────────────────────────────────────────────────
 
     const NS = 'skillsManagement'
@@ -183,6 +214,8 @@ window.__ModuleLoader__.load({
       invocationHint: '关闭后技能保留在库里，但不再注入对话目录（skill 工具也调不到）',
       pathLabel: '路径',
       meTag: '本机',
+      pickSkill: '＋技能',
+      pickSkillTitle: '选择一个技能，其内容将注入本条消息',
     }
 
     const EN = {
@@ -290,6 +323,8 @@ window.__ModuleLoader__.load({
       invocationHint: 'When off, the skill stays in the library but is not injected into conversation catalogs',
       pathLabel: 'Path',
       meTag: 'me',
+      pickSkill: '+ Skill',
+      pickSkillTitle: 'Pick a skill; its content is injected into this message',
     }
 
     // ── Pure helpers ────────────────────────────────────────────────────────
@@ -432,6 +467,8 @@ window.__ModuleLoader__.load({
     .sk-menu-item:hover{background:var(--dsw-alias-interactive-bg-hover)}
     .sk-menu-item.on{color:var(--dsw-alias-state-business-primary);font-weight:500}
     .sk-tabpill{background:transparent;border:none;color:var(--dsw-alias-label-secondary);font-family:var(--dsw-font-family)}
+    .sk-chip{display:inline-flex;align-items:center;gap:4px;height:26px;padding:0 9px;border-radius:8px;border:1px solid var(--dsw-alias-border-l2);background:transparent;color:var(--dsw-alias-label-secondary);font-family:var(--dsw-font-family);font-size:12px;cursor:pointer;white-space:nowrap}
+    .sk-chip:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary)}
     </style>`
 
     // ── Fetch layer ─────────────────────────────────────────────────────────
@@ -1290,7 +1327,7 @@ window.__ModuleLoader__.load({
     module.exports = {
       name: CLIENT_NAME,
       inject: ['slots', 'locale'],
-      __internals: { NS, ZH, EN, matchSkill, formatSize, formatTime },
+      __internals: { NS, ZH, EN, matchSkill, formatSize, formatTime, openTriggerSource },
       /** Test/host helper: mount a standalone page into any container. */
       __boot(container, opts = {}) {
         ensureStyles()
@@ -1318,6 +1355,13 @@ window.__ModuleLoader__.load({
             })
           }
         } catch {}
+        // Composer services (inputTriggers + sessions) for the ＋技能 button;
+        // absence hides the button only.
+        try {
+          if (typeof ctx.inject === 'function') {
+            ctx.inject(['inputTriggers', 'sessions'], (scope) => { composerScope = scope })
+          }
+        } catch {}
         // Locale service is optional at boot order — degrade to EN until present
         let t = (key, vars) => {
           let out = EN[key] ?? key
@@ -1369,9 +1413,40 @@ window.__ModuleLoader__.load({
           }))
           } catch (e) { (globalThis.__skErrors = globalThis.__skErrors || []).push('settings:' + (e && e.message)); throw e }
         }, 'skills-management: settings section')
+        ctx.effect(() => {
+          try {
+          ctx.slots.inject('conversation.input.left', () => ctx.slots.register({
+            name: 'conversation.input.left',
+            id: CLIENT_NAME,
+            order: 60,
+            locale: NS,
+            label: () => t('pickSkill'),
+            inject: () => ({ t }),
+          }, function SkillButtonSlot(apiProps) {
+            return h(ComposerButtonSlot, {
+              __t: t, icon: '⚡', label: t('pickSkill'), title: t('pickSkillTitle'),
+              source: 'skill', sessionId: apiProps && apiProps.sessionId, input: apiProps && apiProps.input,
+            })
+          }))
+          } catch (e) { (globalThis.__skErrors = globalThis.__skErrors || []).push('input.left:' + (e && e.message)); throw e }
+        }, 'skills-management: input left button')
       },
     }
 
+    /** Composer tool-row button: opens a registered '/' source (ui-skill's
+     *  `skill` source) over the session's trigger controller. Hidden while the
+     *  inputTriggers/sessions services are absent. */
+    function ComposerButtonSlot(props) {
+      useEffect(ensureStyles, [])
+      const ready = !!(composerScope && composerScope.inputTriggers && composerScope.sessions && props.sessionId)
+      if (!ready) return null
+      return h('button', {
+        className: 'sk-chip',
+        title: props.title || props.label,
+        onClick: () => { openTriggerSource(composerScope, props.sessionId, props.input, props.source) },
+      }, `${props.icon || ''}${props.icon ? ' ' : ''}${props.label}`)
+    }
+
     return module.exports
   }
 })

package/client/index.js

@@ -64,6 +64,37 @@ const prim = (name) => P && P[name]
 let sessionsApi = null
 const sessionsSvc = () => sessionsApi
 
+// Composer services (inputTriggers + sessions) for the ＋技能 button: opens
+// the `skill` source (registered by dsh-client-ui-skill) as a menu. Absence
+// hides the button; nothing else depends on it.
+let composerScope = null
+
+/**
+ * Open one registered '/' source over a synthetic collapsed span appended at
+ * the draft end (host toggleCommandMenu 同款调用形状；标准 kit 不暴露光标，
+ * pick 依赖 span-CAS：点击后草稿若再变动则本次 pick 静默作废）。
+ */
+function openTriggerSource(scope, sessionId, input, sourceName) {
+  const inputTriggers = scope && scope.inputTriggers
+  const sessions = scope && scope.sessions
+  if (!inputTriggers || !sessions) return false
+  let actx
+  try { actx = sessions.scope(sessionId) } catch { return false }
+  if (actx === undefined || actx === null) return false
+  let controller
+  try { controller = inputTriggers.sessionOf(actx) } catch { return false }
+  const draft = (input && input.draft) || ''
+  const at = draft.length
+  controller.toggleSource(sourceName, {
+    trigger: '/',
+    query: '',
+    quoted: false,
+    position: draft.trim() === '' ? 'leading' : 'inline',
+    span: { start: at, end: at, draftRev: (input && input.draftRev) || 0 },
+  })
+  return true
+}
+
 // ── Locale ───────────────────────────────────────────────────────────────
 
 const NS = 'skillsManagement'
@@ -173,6 +204,8 @@ const ZH = {
   invocationHint: '关闭后技能保留在库里，但不再注入对话目录（skill 工具也调不到）',
   pathLabel: '路径',
   meTag: '本机',
+  pickSkill: '＋技能',
+  pickSkillTitle: '选择一个技能，其内容将注入本条消息',
 }
 
 const EN = {
@@ -280,6 +313,8 @@ const EN = {
   invocationHint: 'When off, the skill stays in the library but is not injected into conversation catalogs',
   pathLabel: 'Path',
   meTag: 'me',
+  pickSkill: '+ Skill',
+  pickSkillTitle: 'Pick a skill; its content is injected into this message',
 }
 
 // ── Pure helpers ────────────────────────────────────────────────────────
@@ -422,6 +457,8 @@ const STYLE = `<style>
 .sk-menu-item:hover{background:var(--dsw-alias-interactive-bg-hover)}
 .sk-menu-item.on{color:var(--dsw-alias-state-business-primary);font-weight:500}
 .sk-tabpill{background:transparent;border:none;color:var(--dsw-alias-label-secondary);font-family:var(--dsw-font-family)}
+.sk-chip{display:inline-flex;align-items:center;gap:4px;height:26px;padding:0 9px;border-radius:8px;border:1px solid var(--dsw-alias-border-l2);background:transparent;color:var(--dsw-alias-label-secondary);font-family:var(--dsw-font-family);font-size:12px;cursor:pointer;white-space:nowrap}
+.sk-chip:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary)}
 </style>`
 
 // ── Fetch layer ─────────────────────────────────────────────────────────
@@ -1280,7 +1317,7 @@ const CLIENT_NAME = '@weibaohui/skills-management'
 module.exports = {
   name: CLIENT_NAME,
   inject: ['slots', 'locale'],
-  __internals: { NS, ZH, EN, matchSkill, formatSize, formatTime },
+  __internals: { NS, ZH, EN, matchSkill, formatSize, formatTime, openTriggerSource },
   /** Test/host helper: mount a standalone page into any container. */
   __boot(container, opts = {}) {
     ensureStyles()
@@ -1308,6 +1345,13 @@ module.exports = {
         })
       }
     } catch {}
+    // Composer services (inputTriggers + sessions) for the ＋技能 button;
+    // absence hides the button only.
+    try {
+      if (typeof ctx.inject === 'function') {
+        ctx.inject(['inputTriggers', 'sessions'], (scope) => { composerScope = scope })
+      }
+    } catch {}
     // Locale service is optional at boot order — degrade to EN until present
     let t = (key, vars) => {
       let out = EN[key] ?? key
@@ -1359,5 +1403,36 @@ module.exports = {
       }))
       } catch (e) { (globalThis.__skErrors = globalThis.__skErrors || []).push('settings:' + (e && e.message)); throw e }
     }, 'skills-management: settings section')
+    ctx.effect(() => {
+      try {
+      ctx.slots.inject('conversation.input.left', () => ctx.slots.register({
+        name: 'conversation.input.left',
+        id: CLIENT_NAME,
+        order: 60,
+        locale: NS,
+        label: () => t('pickSkill'),
+        inject: () => ({ t }),
+      }, function SkillButtonSlot(apiProps) {
+        return h(ComposerButtonSlot, {
+          __t: t, icon: '⚡', label: t('pickSkill'), title: t('pickSkillTitle'),
+          source: 'skill', sessionId: apiProps && apiProps.sessionId, input: apiProps && apiProps.input,
+        })
+      }))
+      } catch (e) { (globalThis.__skErrors = globalThis.__skErrors || []).push('input.left:' + (e && e.message)); throw e }
+    }, 'skills-management: input left button')
   },
 }
+
+/** Composer tool-row button: opens a registered '/' source (ui-skill's
+ *  `skill` source) over the session's trigger controller. Hidden while the
+ *  inputTriggers/sessions services are absent. */
+function ComposerButtonSlot(props) {
+  useEffect(ensureStyles, [])
+  const ready = !!(composerScope && composerScope.inputTriggers && composerScope.sessions && props.sessionId)
+  if (!ready) return null
+  return h('button', {
+    className: 'sk-chip',
+    title: props.title || props.label,
+    onClick: () => { openTriggerSource(composerScope, props.sessionId, props.input, props.source) },
+  }, `${props.icon || ''}${props.icon ? ' ' : ''}${props.label}`)
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weibaohui/skills-management",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "dsh 插件 · 技能市场：一个页面管理本机所有 coding agent 的技能（Claude、ZCode、Codex 等十余个执行器），一键收编进 DSH 用户库供 skill 工具调用；内置 6600+ ntd 技能市场可浏览搜索安装，支持模型可见性治理与市场每日自动同步。",
   "license": "MIT",
   "keywords": [
@@ -30,6 +30,7 @@
   "files": [
     "src",
     "client",
+    "docs",
     "cordis.patch.yml"
   ],
   "scripts": {

package/src/index.js

@@ -36,7 +36,6 @@ function loadSchemastery() {
 }
 const Schema = loadSchemastery()
 
-const DEFAULT_MARKET_DIRS = [join(homedir(), '.ntd', 'bundled', 'skills')]
 const MARKET_SCAN_SKIP = new Set(['.git', 'node_modules'])
 const RANK_INSTALLED = 100
 const RANK_MARKET = 500
@@ -312,6 +311,11 @@ function expandTilde(p) {
   return p === '~' || p.startsWith('~/') || p.startsWith('~\\') ? join(homedir(), p.slice(2)) : p
 }
 
+/** dsh 数据根（与宿主一致：$DSH_HOME，缺省 ~/.dsh）。 */
+function dshHome() {
+  return process.env.DSH_HOME ? resolve(process.env.DSH_HOME) : join(homedir(), '.dsh')
+}
+
 /**
  * 切换 dsh 原生治理键 `disable-model-invocation`（docs/subsystems/skills.md）。
  * modelInvocable=true 时移除该键；false 时写入 true。其余 frontmatter 键与正文原样保留。
@@ -377,17 +381,35 @@ function authedUrl(url, token) {
   return String(url).replace(/^(https?:\/\/)([^@/]+@)?/, `$1oauth2:${encodeURIComponent(token)}@`)
 }
 
-/** Clone (first time) or fetch+reset (update); remote branch is truth. */
-async function gitSyncRepo(binary, url, branch, repoDir, token) {
+/** Clone (first time) or fetch+reset (update); remote branch is truth.
+ *  `sparsePaths` (e.g. ['skills']) switches the checkout to sparse mode: fresh
+ *  clones pass --filter=blob:none --sparse so only those subtrees download
+ *  (the ntd-resource monorepo also carries experts/ + templates/, ~2x the
+ *  skills payload); servers without filter support just warn and fall back to
+ *  a full clone, which sparse-checkout still prunes. An existing full checkout
+ *  is converted in place — the worktree prunes immediately, already-packed
+ *  blobs stay (reachable from HEAD), so the big win is on fresh clones. */
+async function gitSyncRepo(binary, url, branch, repoDir, token, sparsePaths) {
   const remote = authedUrl(url, token)
+  const sparse = Array.isArray(sparsePaths) && sparsePaths.length > 0 ? sparsePaths : undefined
   let repoExists = false
   try { await fsP.access(join(repoDir, '.git')); repoExists = true } catch { repoExists = false }
   if (!repoExists) {
     await fsP.rm(repoDir, { recursive: true, force: true })
     await fsP.mkdir(join(repoDir, '..'), { recursive: true })
-    await gitExec(binary, ['clone', '-b', branch, '--depth', '1', remote, repoDir])
+    if (sparse) {
+      await gitExec(binary, ['clone', '-b', branch, '--depth', '1', '--filter=blob:none', '--sparse', remote, repoDir])
+      await gitExec(binary, ['sparse-checkout', 'set', '--cone', ...sparse], repoDir)
+    } else {
+      await gitExec(binary, ['clone', '-b', branch, '--depth', '1', remote, repoDir])
+    }
     return { isFirstClone: true, hasUpdates: true, before: undefined, after: await gitCurrentCommit(binary, repoDir) }
   }
+  // Migrate a pre-sparse full checkout in place (idempotent no-op once sparse).
+  if (sparse) {
+    try { await gitExec(binary, ['sparse-checkout', 'set', '--cone', ...sparse], repoDir) }
+    catch (e) { console.warn(`skills-management: sparse-checkout conversion failed, continuing full: ${e && e.message}`) }
+  }
   const before = await gitCurrentCommit(binary, repoDir)
   await gitExec(binary, ['fetch', remote, branch], repoDir)
   await gitExec(binary, ['reset', '--hard', 'FETCH_HEAD'], repoDir)
@@ -547,10 +569,15 @@ module.exports = {
       return resolve(expandTilde(
         typeof eff.repoDir === 'string' && eff.repoDir !== '' ? eff.repoDir
           : config.marketRepoDir !== undefined ? config.marketRepoDir
-          : join(homedir(), '.ntd', 'bundled')))
+          : join(dshHome(), 'skills-management', 'market')))
     }
     const marketRoots = () => configMarketDirs !== undefined ? configMarketDirs : [join(effectiveRepoDir(), 'skills')]
     const marketDirs = marketRoots  // scan/install/locate call sites read through this
+    // 稀疏检出子树：ntd-resource 仓库同时携带 experts/templates，只检 skills 一份省一半以上
+    // 流量与磁盘。config.marketSparsePaths: null 关闭；自定义数组换目标子树。
+    const marketSparsePaths = () => config.marketSparsePaths === null
+      ? undefined
+      : (Array.isArray(config.marketSparsePaths) && config.marketSparsePaths.length > 0 ? config.marketSparsePaths.map(String) : ['skills'])
     const installedDir = resolve(expandTilde(config.installedDir !== undefined ? config.installedDir : process.env.DSH_HOME ? join(process.env.DSH_HOME, 'skills') : join(homedir(), '.dsh', 'skills')))
     const providerName = config.providerName !== undefined ? config.providerName : 'ntd-skills'
     // 市场库存（数几千条）默认不进模型目录 available_skills —— 只作为可浏览/可安装的货架。
@@ -771,7 +798,7 @@ module.exports = {
         if (!ok) throw new Error('git is not available on PATH')
         const started = Date.now()
         const repoDir = effectiveRepoDir()
-        const result = await gitSyncRepo(eff.gitBinary, eff.url, eff.branch, repoDir, eff.token)
+        const result = await gitSyncRepo(eff.gitBinary, eff.url, eff.branch, repoDir, eff.token, marketSparsePaths())
         marketState.lastSyncAt = new Date().toISOString()
         marketState.lastResult = { ...result, at: marketState.lastSyncAt, durationMs: Date.now() - started }
         await saveMarketState()
@@ -898,6 +925,7 @@ module.exports = {
               autoSync: eff.autoSync, syncOnStartup: eff.syncOnStartup,
               hasToken: typeof eff.token === 'string' && eff.token !== '',
               syncing: marketSyncRun !== null,
+              sparsePaths: marketSparsePaths() ?? null,
             })
             return
           }