dsh-composer-skill-picker 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mark930209
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,66 @@
-# Temporary Holding Version
+# composer-skill-picker
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+在 DSH Web 输入框的**工具行**（`+` 按钮右侧）常驻一个短按钮「技能」，点开后是一个浮层面板，
+面板顶部的两个复选框控制列表内容：
+
+| 复选框 | 内容 | 默认 |
+|---|---|---|
+| 项目技能 | `<项目根>/.agents/skills`、`<项目根>/.dsh/skills` 下的 `SKILL.md` | ✅ 勾选 |
+| 全局技能 | 用户级（`<agentsHome>/skills`、`<dshHome>/skills`）与随包内置（`app.asar`）技能 | ⬜ |
+
+选中一个技能 → 把 `/技能名 ` 插进草稿。
+
+## 解决什么问题
+
+- 内置的 `/` 菜单会同时列出内置命令、全部技能（内置 + 用户级 + 项目级），技能一多就很难找。
+- 打开会话即自动发现当前项目的技能，不用手工维护清单；需要全局技能时再勾一下复选框。
+
+## 目录与来源
+
+| SkillSource | 目录 | 归类 |
+|---|---|---|
+| `project-dsh` | `<项目根>/.dsh/skills/<名字>/SKILL.md` | 项目技能 |
+| `project-agents` | `<项目根>/.agents/skills/<名字>/SKILL.md` | 项目技能 |
+| `user-dsh` | `<dshHome>/skills` | 全局技能 |
+| `user-agents` | `<agentsHome>/skills`（如 `C:\Users\congzhisen\.agents\skills`） | 全局技能 |
+| `bundled` | 包内 `assets/**/SKILL.md`（如 `office-*`、`diagnose-windows-sandbox-acl`） | 全局技能 |
+
+项目根 = 最近的含 `.git` 的祖先目录（没有 `.git` 时用会话 cwd），由 DSH 的 skill provider 决定。
+
+## 用法
+
+1. 在项目里放技能，例如 `E:\5_8U\Cybertron\.agents\skills\ec9-architect\SKILL.md`。
+2. 打开该项目的会话，点工具行的「技能」按钮，面板默认只列该项目的技能（按名字排序）。
+3. 点一个技能 → 自动插入 `/ec9-architect `，面板关闭，焦点回到输入框。
+
+## 实现要点
+
+- 触发器：插槽 `conversation.input.left`（id `composer-skill-picker`，order 80），
+  一个紧凑按钮（`max-width:96px`，超出省略），样式对齐内置模型选择器。
+- 面板：插槽 `shell.overlay`（id `composer-skill-picker-panel`，order 900），
+  `position:fixed` 贴着触发器上方弹出，避免被输入框容器裁剪；宽度 420px（随视口收缩），
+  列表区 `overflow-y:auto` 独立滚动，长技能名横向可滚（`scrollbar-width:none`）。
+  背景用 `--dsw-alias-bg-layer-1`（浅色主题下为纯白），边框 `--dsw-alias-border-l2`。
+- 归类：`skills/list` 的条目只有 `path/name/description/whenToUse/modelInvocable`（**没有 `source`**），
+  所以取 `.agents/skills` / `.dsh/skills` 之前的目录前缀与会话 cwd 比较——前缀是 cwd 本身或
+  其祖先才算项目技能；没有 `path`（随包内置）或路径不在项目内的都归「全局技能」，每条带
+  「内置 / 用户」标签。
+- 插入：`inputActions.captureInsertion()` 取 CAS span → `insertText('/名字 ', span)`；
+  CAS 失败则退回最新光标位置；随后 `conversation.input.for(actx).focus()` 把焦点交还输入框。
+
+## 开发
+
+```powershell
+node --check client.js
+node --check index.js
+# 安装：plugin_manager install_bundle target=E:\Projects\DSH_Plugins_Dev\plugins\composer-skill-picker
+# 只改 client.js / locale → 重启 DeepSeek Harness 生效
+```
+
+## 已知限制
+
+- 不提供 Agent（agent preset）切换：DSH 的 preset 是会话级选择，且会话开始首轮后即锁死；
+  需要时在新建会话处选择。DSH 也不读取 `.github/agents/*.agent.md`（那是 Copilot 等工具的
+  约定），项目里的自定义 agent 表现为 `.agents/skills/<名字>/SKILL.md`。
+- 面板没有搜索框；列表较长时用面板内滚动（技能名过长时可横向滚动查看全文）。
+- 面板不是模态对话框，点击面板外或按 `Esc` 关闭。

package/client.js

@@ -0,0 +1,496 @@
+/**
+ * 项目技能选择器（composer-skill-picker）
+ *
+ * 在输入框工具行常驻一个短按钮，点开是一个浮层面板，用 2 个复选框控制列表：
+ *   - 项目技能：`<项目根>/.agents/skills` 或 `<项目根>/.dsh/skills` 下的 SKILL.md
+ *   - 全局技能：用户级（`<agentsHome>/skills`、`<dshHome>/skills`）与随包内置（bundled）
+ *
+ * 项目根 = 最近的含 `.git` 的祖先目录（没有则用会话 cwd），由 DSH 的 skill provider
+ * 判定；这里只做路径归属判断，因为 `skills/list` 的结果条目**没有 source 字段**
+ * （只有 path / name / description / whenToUse / modelInvocable）。
+ *
+ * 选中即把 `/技能名 ` 插入草稿（与内置 ui-skill 的 onPick 一致），发送时由宿主解析。
+ */
+window.__ModuleLoader__.load({
+  id: 'dsh-composer-skill-picker',
+  factory(require) {
+    const React = require('react');
+    const h = React.createElement;
+
+    // ---------------------------------------------------------------- constants
+    /** 本插件拥有的 locale 命名空间。 */
+    const NS = 'composer-skill-picker';
+    /** 视为“项目技能”的目录标记（取标记之前的目录作为项目根）。 */
+    const PROJECT_MARKERS = ['/.agents/skills/', '/.dsh/skills/'];
+    /** 面板宽度（px）。 */
+    const PANEL_WIDTH = 420;
+    /** 下拉箭头。 */
+    const CHEVRON = 'url("data:image/svg+xml,%3Csvg xmlns=\'http://www.w3.org/2000/svg\' width=\'12\' height=\'12\' viewBox=\'0 0 12 12\' fill=\'none\'%3E%3Cpath d=\'M3 4.5L6 7.5L9 4.5\' stroke=\'%2381858C\' stroke-width=\'1.5\' stroke-linecap=\'round\' stroke-linejoin=\'round\'/%3E%3C/svg%3E")';
+
+    // ---------------------------------------------------------------- locale
+    /** 简体中文（key 集合的事实来源）。 */
+    const zh = {
+      'label': '技能',
+      'title': '选择技能（项目 / 全局）',
+      'project': '项目技能',
+      'global': '全局技能',
+      'loading': '加载中…',
+      'error': '加载失败',
+      'emptyProject': '当前项目没有技能',
+      'emptyGlobal': '没有全局技能',
+      'emptyPick': '至少勾选一类',
+      'builtin': '内置',
+      'user': '用户'
+    };
+    /** English mirror. */
+    const en = {
+      'label': 'Skills',
+      'title': 'Pick a skill (project / global)',
+      'project': 'Project',
+      'global': 'Global',
+      'loading': 'Loading…',
+      'error': 'Load failed',
+      'emptyProject': 'No skills in this project',
+      'emptyGlobal': 'No global skills',
+      'emptyPick': 'Select at least one group',
+      'builtin': 'Built-in',
+      'user': 'User'
+    };
+
+    // ---------------------------------------------------------------- styles
+    const CSS = [
+      '.cskp-trigger{display:inline-flex;align-items:center;gap:4px;height:28px;max-width:96px;',
+      'padding:0 6px;border:none;border-radius:var(--dsw-radius-sm);background:transparent;',
+      'color:var(--dsw-alias-label-secondary);font:inherit;font-size:12px;cursor:pointer;flex:none;}',
+      '.cskp-trigger:hover,.cskp-trigger[data-open="true"]{background:var(--dsw-alias-interactive-bg-hover-solid);',
+      'color:var(--dsw-alias-label-primary);}',
+      '.cskp-trigger:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:1px;}',
+      '.cskp-trigger-label{overflow:hidden;text-overflow:ellipsis;white-space:nowrap;min-width:0;}',
+      '.cskp-chevron{width:12px;height:12px;flex:none;opacity:.75;background-image:' + CHEVRON + ';',
+      'background-repeat:no-repeat;background-position:center;background-size:12px 12px;}',
+      '.cskp-panel{position:fixed;z-index:90;display:flex;flex-direction:column;overflow:hidden;',
+      'max-height:min(420px,60vh);background:var(--dsw-alias-bg-layer-1);',
+      'border:1px solid var(--dsw-alias-border-l2);border-radius:8px;',
+      'box-shadow:0 12px 32px rgba(0,0,0,.16),0 2px 8px rgba(0,0,0,.08);font-size:12px;}',
+      '.cskp-filters{display:flex;flex-wrap:wrap;gap:10px;padding:8px 10px;',
+      'border-bottom:1px solid var(--dsw-alias-border-l2);flex:none;}',
+      '.cskp-check{display:inline-flex;align-items:center;gap:4px;font-size:12px;cursor:pointer;',
+      'color:var(--dsw-alias-label-secondary);user-select:none;}',
+      '.cskp-check input{accent-color:var(--dsw-alias-brand-primary);margin:0;cursor:pointer;}',
+      '.cskp-count{color:var(--dsw-alias-state-idle-primary);font-size:11px;}',
+      '.cskp-list{overflow-y:auto;overscroll-behavior:contain;padding:4px;flex:1 1 auto;min-height:0;}',
+      '.cskp-group{font-size:11px;font-weight:600;padding:6px 8px 2px;',
+      'color:var(--dsw-alias-label-secondary);}',
+      '.cskp-row{display:flex;flex-direction:column;gap:1px;width:100%;padding:5px 8px;border:none;',
+      'border-radius:var(--dsw-radius-sm);background:transparent;text-align:left;cursor:pointer;font:inherit;}',
+      '.cskp-row:hover{background:var(--dsw-alias-interactive-bg-hover-solid);}',
+      '.cskp-row:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:-2px;}',
+      '.cskp-line{display:flex;align-items:center;gap:6px;min-width:0;}',
+      '.cskp-name{flex:0 1 auto;min-width:0;font-size:12px;color:var(--dsw-alias-label-primary);',
+      'white-space:nowrap;overflow-x:auto;overflow-y:hidden;scrollbar-width:none;}',
+      '.cskp-name::-webkit-scrollbar{height:0;}',
+      '.cskp-meta{font-size:11px;color:var(--dsw-alias-label-secondary);white-space:nowrap;',
+      'overflow:hidden;text-overflow:ellipsis;}',
+      '.cskp-badge{flex:none;font-size:10px;line-height:14px;padding:0 4px;border-radius:4px;',
+      'background:var(--dsw-alias-bg-module-platform);color:var(--dsw-alias-label-secondary);}',
+      '.cskp-empty{padding:10px;font-size:12px;color:var(--dsw-alias-label-secondary);}'
+    ].join('');
+
+    /**
+     * 插入插件样式表，优先使用 Client 的 `styles` 内建；不可用时退回 `<style>` 标签。
+     * @param {string} css - 样式文本。
+     * @returns {() => void} 清理函数。
+     */
+    function insertCss(css) {
+      if (typeof styles !== 'undefined' && styles && typeof styles.insert === 'function') {
+        return styles.insert(css);
+      }
+      const tag = document.createElement('style');
+      tag.dataset.pluginCss = NS;
+      tag.textContent = css;
+      document.head.appendChild(tag);
+      return () => tag.remove();
+    }
+
+    /** 路径规范化：正斜杠 + 小写 + 去尾斜杠。 */
+    function normalizePath(value) {
+      if (typeof value !== 'string' || value === '') return undefined;
+      return value.replace(/\\/g, '/').replace(/\/+$/, '').toLowerCase();
+    }
+
+    /** 中文排序。 */
+    function byName(left, right) {
+      return String(left.name ?? left.id ?? '').localeCompare(String(right.name ?? right.id ?? ''));
+    }
+
+    // ---------------------------------------------------------------- client body
+    /**
+     * Client 插件主体。
+     * @param {object} ctx - Client 根上下文。
+     */
+    function apply(ctx) {
+      const locale = ctx.locale;
+      const sessions = ctx.sessions;
+      const skills = ctx.remote.skills;
+      const t = locale.bind(NS);
+
+      ctx.effect(() => insertCss(CSS), 'composer-skill-picker: stylesheet');
+      ctx.effect(() => locale.register(NS, { zh, en }), 'composer-skill-picker: dictionaries');
+
+      // ------------------------------------------------------------ shared store
+      /** 模块级共享状态：触发器与浮层面板都订阅它。 */
+      const state = {
+        open: false,
+        sessionId: undefined,
+        rect: null,
+        anchorEl: null,
+        panelEl: null,
+        filters: { project: true, global: false },
+        catalog: [],
+        cwd: undefined,
+        skillsStatus: 'idle',
+        skillsError: null,
+        insertSkill: null
+      };
+      const listeners = new Set();
+      function emit() {
+        for (const listener of Array.from(listeners)) {
+          try {
+            listener();
+          } catch {
+            // 单个订阅者异常不影响其他订阅者。
+          }
+        }
+      }
+      function setState(patch) {
+        Object.assign(state, patch);
+        emit();
+      }
+      function subscribe(listener) {
+        listeners.add(listener);
+        return () => {
+          listeners.delete(listener);
+        };
+      }
+      function close() {
+        if (!state.open) return;
+        setState({ open: false, panelEl: null, anchorEl: null });
+      }
+
+      /** 会话摘要（含 cwd）。 */
+      function sessionSummary(sessionId) {
+        try {
+          return sessions.list?.getSnapshot?.()?.byId?.[sessionId];
+        } catch {
+          return undefined;
+        }
+      }
+
+      /**
+       * 判断技能是否属于当前项目：取 `.agents/skills` / `.dsh/skills` 之前的目录作为
+       * 项目根，只有它等于 cwd 或是 cwd 的祖先才算项目技能。
+       * 没有 path 的条目（bundled / runtime 提供的技能）无法证明属于项目 → 归为全局。
+       * @param {object} skill - skills/list 条目。
+       * @param {string | undefined} cwd - 规范化后的会话 cwd。
+       * @returns {boolean} 是否属于当前项目。
+       */
+      function isProjectSkill(skill, cwd) {
+        if (cwd === undefined) return false;
+        const path = normalizePath(skill?.path);
+        if (path === undefined) return false;
+        for (const marker of PROJECT_MARKERS) {
+          let at = path.indexOf(marker);
+          while (at > 0) {
+            const root = path.slice(0, at);
+            if (cwd === root || cwd.startsWith(`${root}/`)) return true;
+            at = path.indexOf(marker, at + 1);
+          }
+        }
+        return false;
+      }
+
+      /** 是否随包内置（没有 path，或路径落在 app.asar 内）。 */
+      function isBuiltinSkill(skill) {
+        const path = normalizePath(skill?.path);
+        return path === undefined || path.includes('/app.asar');
+      }
+
+      /** 拉取技能目录（不分类，分类在渲染时做）。 */
+      async function fetchSkills(sessionId, signal) {
+        if (sessions.subagentAddress(sessionId) !== undefined) {
+          return { list: [], cwd: undefined };
+        }
+        if (sessions.binding(sessionId) === undefined) {
+          throw new Error(`composer-skill-picker: session "${sessionId}" is not retained`);
+        }
+        return sessions.using(sessionId, { source: 'composerSkillPicker', signal }, async (reference) => {
+          signal.throwIfAborted();
+          const snapshot = reference.binding.session.getSnapshot();
+          if (snapshot.openState !== 'open') {
+            throw snapshot.openError ?? new Error(`composer-skill-picker: session "${sessionId}" is not open`);
+          }
+          const result = await skills.list({ sessionId }, signal);
+          signal.throwIfAborted();
+          if (!result.ok) {
+            throw new Error(`skills/list failed: ${result.error.code}: ${result.error.message}`);
+          }
+          return {
+            list: result.value.skills,
+            cwd: normalizePath(sessionSummary(sessionId)?.cwd)
+          };
+        });
+      }
+
+      let skillsAbort;
+      /** 加载会话可见的技能目录。 */
+      async function loadSkills(sessionId) {
+        if (typeof sessionId !== 'string' || sessionId === '') return;
+        if (skillsAbort !== undefined) skillsAbort.abort();
+        const abort = new AbortController();
+        skillsAbort = abort;
+        setState({ skillsStatus: 'loading', skillsError: null });
+        try {
+          const { list, cwd } = await fetchSkills(sessionId, abort.signal);
+          if (abort.signal.aborted) return;
+          setState({ catalog: list, cwd, skillsStatus: 'ready' });
+        } catch (error) {
+          if (abort.signal.aborted) return;
+          setState({
+            skillsStatus: 'error',
+            skillsError: String((error && error.message) || error)
+          });
+        }
+      }
+
+      /** 把 `/名字 ` 插入草稿并交还输入焦点。 */
+      function insertSkill(name) {
+        const actions = state.insertSkill;
+        if (actions === undefined || actions === null) return;
+        try {
+          const span = actions.captureInsertion();
+          if (span === undefined || actions.insertText(`/${name} `, span) !== true) {
+            const fresh = actions.captureInsertion();
+            if (fresh !== undefined) actions.insertText(`/${name} `, fresh);
+          }
+        } finally {
+          const sessionId = state.sessionId;
+          close();
+          try {
+            const actx = sessions.scope(sessionId);
+            if (actx !== undefined) ctx.get('conversation')?.input?.for?.(actx)?.focus?.();
+          } catch {
+            // 焦点回填是尽力而为。
+          }
+        }
+      }
+
+      /** 分组：项目 / 全局。 */
+      function classify() {
+        const project = [];
+        const global = [];
+        for (const skill of state.catalog) {
+          if (isProjectSkill(skill, state.cwd)) project.push(skill);
+          else global.push(skill);
+        }
+        project.sort(byName);
+        global.sort(byName);
+        return { project, global };
+      }
+
+      // ------------------------------------------------------------ views
+      /** 复选框。 */
+      function filterCheck(key, label, count) {
+        return h('label', { key: `f:${key}`, className: 'cskp-check' }, [
+          h('input', {
+            type: 'checkbox',
+            checked: state.filters[key] === true,
+            onChange: () => {
+              const filters = Object.assign({}, state.filters, { [key]: state.filters[key] !== true });
+              setState({ filters });
+            }
+          }),
+          h('span', null, label),
+          h('span', { className: 'cskp-count' }, String(count))
+        ]);
+      }
+
+      /** 技能行。 */
+      function skillRow(skill, withBadge) {
+        const tone = isBuiltinSkill(skill) ? t('builtin') : t('user');
+        return h('button', {
+          key: `s:${skill.name}`,
+          type: 'button',
+          className: 'cskp-row',
+          title: skill.whenToUse ?? skill.description ?? skill.name,
+          onClick: () => insertSkill(skill.name)
+        }, [
+          h('span', { key: 'line', className: 'cskp-line' }, [
+            h('span', { key: 'name', className: 'cskp-name' }, skill.name),
+            withBadge
+              ? h('span', { key: 'badge', className: 'cskp-badge' }, tone)
+              : null
+          ]),
+          skill.description !== undefined && skill.description !== ''
+            ? h('span', { key: 'meta', className: 'cskp-meta' }, skill.description)
+            : null
+        ]);
+      }
+
+      /** 浮层面板。 */
+      function SkillPanel() {
+        const [, force] = React.useState(0);
+        React.useEffect(() => subscribe(() => force((value) => value + 1)), []);
+
+        const open = state.open;
+        React.useEffect(() => {
+          if (!open) return undefined;
+          const onKeyDown = (event) => {
+            if (event.key === 'Escape') {
+              event.stopPropagation();
+              close();
+            }
+          };
+          const onPointerDown = (event) => {
+            const target = event.target;
+            if (state.panelEl !== null && state.panelEl.contains(target)) return;
+            if (state.anchorEl !== null && state.anchorEl.contains(target)) return;
+            close();
+          };
+          const onViewportChange = () => close();
+          document.addEventListener('keydown', onKeyDown, true);
+          document.addEventListener('pointerdown', onPointerDown, true);
+          window.addEventListener('resize', onViewportChange);
+          return () => {
+            document.removeEventListener('keydown', onKeyDown, true);
+            document.removeEventListener('pointerdown', onPointerDown, true);
+            window.removeEventListener('resize', onViewportChange);
+          };
+        }, [open]);
+
+        if (!open || state.rect === null) return null;
+
+        const width = Math.min(PANEL_WIDTH, window.innerWidth - 24);
+        const left = Math.max(8, Math.min(state.rect.left, window.innerWidth - width - 12));
+        const bottom = Math.max(8, window.innerHeight - state.rect.top + 8);
+        const style = { left: `${left}px`, bottom: `${bottom}px`, width: `${width}px` };
+
+        const { project, global } = classify();
+        const filters = state.filters;
+
+        const body = [];
+        if (!filters.project && !filters.global) {
+          body.push(h('div', { key: 'pick', className: 'cskp-empty' }, t('emptyPick')));
+        }
+        if (filters.project) {
+          body.push(h('div', { key: 'p:title', className: 'cskp-group' }, t('project')));
+          if (state.skillsStatus === 'loading' || state.skillsStatus === 'idle') {
+            body.push(h('div', { key: 'p:loading', className: 'cskp-empty' }, t('loading')));
+          } else if (state.skillsStatus === 'error') {
+            body.push(h('div', { key: 'p:error', className: 'cskp-empty' }, `${t('error')}: ${state.skillsError ?? ''}`));
+          } else if (project.length === 0) {
+            body.push(h('div', { key: 'p:empty', className: 'cskp-empty' }, t('emptyProject')));
+          } else {
+            body.push(...project.map((skill) => skillRow(skill, false)));
+          }
+        }
+        if (filters.global) {
+          body.push(h('div', { key: 'g:title', className: 'cskp-group' }, t('global')));
+          if (state.skillsStatus === 'loading' || state.skillsStatus === 'idle') {
+            body.push(h('div', { key: 'g:loading', className: 'cskp-empty' }, t('loading')));
+          } else if (state.skillsStatus === 'error') {
+            body.push(h('div', { key: 'g:error', className: 'cskp-empty' }, `${t('error')}: ${state.skillsError ?? ''}`));
+          } else if (global.length === 0) {
+            body.push(h('div', { key: 'g:empty', className: 'cskp-empty' }, t('emptyGlobal')));
+          } else {
+            body.push(...global.map((skill) => skillRow(skill, true)));
+          }
+        }
+
+        return h('div', {
+          className: 'cskp-panel',
+          style,
+          ref: (element) => {
+            state.panelEl = element;
+          }
+        }, [
+          h('div', { key: 'filters', className: 'cskp-filters' }, [
+            filterCheck('project', t('project'), project.length),
+            filterCheck('global', t('global'), global.length)
+          ]),
+          h('div', { key: 'list', className: 'cskp-list' }, body)
+        ]);
+      }
+
+      /** 工具行里的短按钮。 */
+      function SkillTrigger(props) {
+        const [, force] = React.useState(0);
+        React.useEffect(() => subscribe(() => force((value) => value + 1)), []);
+
+        const sessionId = props.sessionId;
+        const actions = props.inputActions;
+
+        React.useEffect(() => {
+          state.insertSkill = actions === undefined || actions === null ? null : actions;
+          return () => {
+            state.insertSkill = null;
+          };
+        }, [actions]);
+
+        React.useEffect(() => {
+          if (sessionId === state.sessionId) return;
+          close();
+          setState({
+            sessionId,
+            catalog: [],
+            cwd: undefined,
+            skillsStatus: 'idle'
+          });
+          loadSkills(sessionId);
+        }, [sessionId]);
+
+        const onClick = (event) => {
+          if (state.open) {
+            close();
+            return;
+          }
+          const rect = event.currentTarget.getBoundingClientRect();
+          setState({
+            open: true,
+            rect: { left: rect.left, top: rect.top },
+            anchorEl: event.currentTarget,
+            sessionId
+          });
+          if (state.skillsStatus === 'idle' || state.skillsStatus === 'error') loadSkills(sessionId);
+        };
+
+        return h('button', {
+          type: 'button',
+          className: 'cskp-trigger',
+          'data-open': state.open ? 'true' : 'false',
+          title: t('title'),
+          'aria-label': t('title'),
+          'aria-haspopup': 'dialog',
+          'aria-expanded': state.open ? 'true' : 'false',
+          onClick
+        }, [
+          h('span', { key: 'label', className: 'cskp-trigger-label' }, t('label')),
+          h('span', { key: 'chevron', className: 'cskp-chevron' })
+        ]);
+      }
+
+      // 触发器在工具行（`+` 之后）；面板挂在 frame 级浮层，避免被输入框容器裁剪。
+      ctx.slots.inject('conversation.input.left', () => ctx.slots.register({
+        name: 'conversation.input.left',
+        id: 'composer-skill-picker',
+        order: 80
+      }, SkillTrigger));
+      ctx.slots.inject('shell.overlay', () => ctx.slots.register({
+        name: 'shell.overlay',
+        id: 'composer-skill-picker-panel',
+        order: 900
+      }, SkillPanel));
+    }
+
+    return { inject: ['slots', 'locale', 'sessions', 'remote', 'remote.skills'], apply };
+  }
+});

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: composer-skill-picker
+      name: 'dsh-composer-skill-picker'

package/icon.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="Project Skill Picker">
+  <rect x="4" y="4" width="56" height="56" rx="14" fill="#2563EB"/>
+  <path d="M30.4 11.6 34.9 24.1 47.4 28.6 34.9 33.1 30.4 45.6 25.9 33.1 13.4 28.6 25.9 24.1 30.4 11.6Z" fill="#FFFFFF"/>
+  <circle cx="47.6" cy="47.6" r="6.2" fill="#FFFFFF" opacity="0.7"/>
+</svg>

package/index.js

@@ -0,0 +1,2 @@
+/** Host 半部：不写 Host 逻辑时保持空 apply 即可。 */
+export function apply() {}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Project Skill Picker",
+    "description": "Adds a compact button to the composer tool row whose popup panel filters between project and global skills: project skills are discovered from the current project's .agents/skills and .dsh/skills by path, and a pick inserts /name."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "项目技能选择器",
+    "description": "在输入框工具行常驻一个短按钮，点开浮层面板后用复选框切换「项目技能 / 全局技能」：项目技能按路径自动发现当前项目的 .agents/skills 与 .dsh/skills，选中即插入 /技能名。"
+  }
+}

package/package.json

@@ -1,6 +1,56 @@
 {
   "name": "dsh-composer-skill-picker",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "description": "Pick a skill of the current project ( .dsh/skills, .agents/skills ) directly from the composer tool row and insert its /name token, instead of scrolling the global slash menu.",
+  "type": "module",
+  "author": "Mark930209 <guimaxingtian@163.com>",
+  "license": "MIT",
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "plugin",
+    "bundle",
+    "skill",
+    "composer",
+    "picker",
+    "project",
+    "popup-select"
+  ],
+  "homepage": "https://github.com/Mark930209/GoDSH/tree/main/plugins/composer-skill-picker",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Mark930209/GoDSH.git",
+    "directory": "plugins/composer-skill-picker"
+  },
+  "scripts": {
+    "check": "node --check client.js && node --check index.js"
+  },
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "icon.svg"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": [
+        "@deepseek-ai/dsh-api-session-controller",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-commands",
+        "@deepseek-ai/dsh-client-locale"
+      ]
+    }
+  }
+}