dsh-skill-picker 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 a735624258
+
+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

@@ -0,0 +1,146 @@
+# dsh-skill-picker
+
+> **技能记不住名字？官方 `/` 补全靠前缀记忆，装了几十个技能谁记得住？** 本插件让技能**看得见、翻得到、选得快**——点一下 ⚡，全部技能带描述排在你面前，搜索、点选、插入，随消息发出自动加载。
+
+DSH Web GUI 的技能选择器：在输入框（composer）工具行右侧加一个按钮，点开可以**搜索并点选已安装的技能**，选中后把官方 `/技能名` 手势插入发送框——随消息一起发出，DSH 原生机制就会自动加载该技能并执行。WorkBuddy 式"把技能写进发送框"的交互，DeepSeek Harness 复刻版。
+
+English: A skill picker for the DSH Web GUI — a button in the composer's right tool row opens a searchable list of installed skills; picking one inserts the official `/skill-name` gesture into the draft, so DSH's native user-invocation path loads the skill with your message.
+
+## 为什么用它（vs 官方 `/` 补全）
+
+官方内置了 `/` 技能补全，但它是**记忆驱动**的——你得先记得技能名，打 `/` + 前缀才能过滤出来。技能一多就抓瞎：
+
+| | 官方 `/` 补全 | dsh-skill-picker |
+|---|---|---|
+| 触发 | 输入框打 `/` | 输入框旁 ⚡ 按钮 |
+| 查找方式 | 前缀记忆驱动，**忘了名字就找不到** | 全列表浏览 + 关键字搜索，**忘了名字也能翻到** |
+| 排序 | 固定 | **最近使用置顶、常用靠前** |
+| 描述可见 | 精简 | 完整描述一眼看全 |
+
+**记得名字用官方，忘了名字用本插件——两者互补，可同时使用。**
+
+## 特性
+
+- ⚡ 一键弹出全部技能（闪电图标，人人看得懂）
+- 🔍 实时搜索（技能名 / 描述都搜）
+- 🧠 **最近使用置顶、常用靠前**的智能排序（WorkBuddy 同款）
+- 📋 直接扫描 `~/.dsh/skills`（官方技能 provider 同源目录，标准安装即用）
+- 🧩 插入官方 `/技能名` 手势，加载/执行走 DSH 原生机制，**零 agent 侧改动**
+- 🎨 跟随 Web UI 主题（CSS 变量），浅色/深色自适应
+- 📦 纯 client + host 双半插件，无第三方运行时依赖
+
+## 安装
+
+```sh
+# 方式一：GitHub 克隆 + link（推荐，无需发布 npm）
+git clone https://github.com/a735624258/dsh-skill-picker.git
+dsh plugin --profile web add link:/path/to/dsh-skill-picker
+
+# 方式二：Git 依赖直装
+dsh plugin --profile web add "github:a735624258/dsh-skill-picker"
+
+# 方式三：发布到 npm 后（预构建安装，体验最佳）
+dsh plugin --profile web add dsh-skill-picker
+```
+
+> 注：目前**尚未发布 npm**（`npm view dsh-skill-picker` 会 404），请用方式一或方式二。
+> 若 `dsh` 命令因 PowerShell 执行策略被拒（`File ... cannot be loaded`），用：
+> `powershell -ExecutionPolicy Bypass -Command "dsh plugin --profile web add link:C:\path\to\dsh-skill-picker"`
+
+重启 `dsh web`（或刷新页面加载新 bundle）后生效。
+
+## 用法
+
+1. 打开任一会话，在输入框工具行右侧找到**⚡ 按钮**
+2. 点击弹出技能列表（可输入关键字过滤）
+3. 点选技能 → 发送框自动出现 `/技能名 `
+4. 继续输入你的话并发送——DSH 会识别 `/技能名` 手势，自动加载该技能并按其指令执行
+
+示例：点选 `duo-xuan-pi-gai` 后发送框变为 `/duo-xuan-pi-gai 帮我批改多选`，发送后技能自动加载。
+
+## 原理
+
+DSH 的 [dsh-tool-skill](https://github.com/deepseek-ai/deepseek-harness) 在 `agent/pre-step` 阶段扫描用户消息中的 `/kebab-case-name` 手势（`SKILL_GESTURE` 正则），命中后把对应技能内容作为 `skill-invocation` 注入对话——即"用户消息里写 `/技能名` 就会自动加载技能"是官方既有能力，只是没有 UI。
+
+本插件只补 UI 一层：
+
+```
+[client]  ⚡ 按钮 → fetch('/dsh-skill-picker/skills')
+                    ↓
+[host]    扫描用户级 $DSH_HOME/skills + 项目级 <cwd>/.dsh/skills 等 → 技能目录（name + description）
+                    ↓
+[client]  点选 → inputActions.setDraft(draft + '/技能名 ')
+                    ↓
+[DSH]     agent/pre-step 识别手势 → 自动加载技能 → 执行
+```
+
+- client 半：注册到官方 `conversation.input.right` 插槽（composer 工具行、发送按钮左侧的控件位），**技能列表优先走官方宿主 skills API**（`connection.api.skills.list`——与 DSH 内置 `/` 补全同源，会话作用域，自动含用户级/项目级技能），失败时回退到 host 扫描路由；插入文本走框架输入机的 `inputActions.setDraft`（单一路径，撤销/草稿持久化自动处理）；最近/常用排序存 localStorage
+
+## 与官方 `/` 补全的关系
+
+DSH 官方已内置技能补全：在输入框输入 `/` 会弹出技能菜单，按前缀过滤（如输入 `/sk` 列出 skill 开头的技能）。本插件不替代它，而是补上官方方案的盲区：
+
+| | 官方 `/` 补全 | dsh-skill-picker |
+|---|---|---|
+| 触发 | 输入框打 `/` | 输入框旁 ⚡ 按钮 |
+| 查找方式 | **前缀记忆驱动**——需要先记得技能名才能打出来 | **全列表浏览 + 关键字搜索**——忘了名字也能翻到 |
+| 排序 | 固定顺序 | 最近使用置顶、常用靠前（localStorage） |
+| 适合场景 | 记得名字的老手 | 技能多、记不全名字、想翻着选的人 |
+
+一句话：**记得名字用官方，忘了名字用本插件**。两者互补，可同时使用。
+
+## 兼容性与注意事项
+
+- **技能来源**：**优先走官方宿主 skills API**（`connection.api.skills.list`——与 DSH 内置 `/` 补全**完全同一个数据源**，会话作用域，自动覆盖用户级 `~/.dsh/skills`、项目级 `<workspace>/.dsh/skills`、`<workspace>/.agents/skills` 等全部官方目录）；官方 API 不可用时**自动回退**到内置扫描（用户级 + 项目级目录）。两条路都支持 `DSH_HOME` 环境变量。
+- **暂不扫描**：`~/.agents/skills` 与自定义技能目录（`customSkillDirs` 配置）——需要的话欢迎 PR。
+- **失败保护**：client 端用 `ctx.slots.inject`（等 `conversation.input.right` 插槽声明存在才注册，插槽缺失时静默跳过，不会拖垮启动）；host 端路由 try/catch，扫描目录不存在时返回空列表而非报错。
+- **依赖版本**：按 DSH `0.1.0-rc.6` API 编写（cordis 4 / web profile 标准装配）。如遇 DSH 大版本更新导致 API 变化，插件会以启动日志的插件错误提示为准，卸载 `dsh plugin --profile web remove dsh-skill-picker` 即可回退。
+
+## 开发
+
+```sh
+# 安装依赖（提供 esbuild）
+npm install
+
+# 构建（源码 src/ → 产物 lib/；client 半自动包 __ModuleLoader__ 握手）
+npm run build
+
+# 安装到 web profile（link 模式，改源码即生效）
+dsh plugin --profile web add link:$PWD
+
+# 语法自检（产物）
+node --check lib/index.js
+node --check lib/client.js
+```
+
+> ⚠️ 改完源码**必须 `npm run build`**：`lib/client.js` 是构建产物，ESM 源码不能直接作
+> 为 client bundle 加载——DSH web shell 要求 client bundle 以
+> `window.__ModuleLoader__.load({ id, factory })` 的 CJS 握手格式注册，否则启动报
+> `loaded without registering "dsh-skill-picker" via __ModuleLoader__.load`。
+> 构建脚本（`build.mjs`）会通过 esbuild 的 banner/footer 自动注入这段握手。
+
+目录结构：
+
+```
+dsh-skill-picker/
+├── package.json        # dsh.bundle.patch + dsh.client 声明 + build script
+├── cordis.patch.yml    # bundle patch：把插件行插入 web profile
+├── build.mjs           # esbuild 构建：host ESM + client CJS(__ModuleLoader__握手)
+├── src/
+│   ├── index.js        # host 半源码：/dsh-skill-picker/skills 路由 + prompt section
+│   └── client/
+│       └── index.jsx   # client 半源码：conversation.input.right 插槽组件
+├── lib/                # 构建产物（勿手改，`npm run build` 生成）
+│   ├── index.js
+│   └── client.js
+└── README.md
+```
+
+## 依赖
+
+- host：`@deepseek-ai/cordis`、`@deepseek-ai/dsh-host-webserver`、`@deepseek-ai/dsh-skill`、`@deepseek-ai/dsh-system-prompt`
+- client：`@deepseek-ai/dsh-client-runtime`、`@deepseek-ai/dsh-client-ui-slots`、`react`
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,12 @@
+# dsh-skill-picker bundle patch: inserts the skill-picker plugin row into the
+# web profile roster. Applied as a profile bundle layer (the `dsh.bundle.patch`
+# manifest field); install with
+# `dsh plugin --profile web add <npm-or-link>`.
+#
+# The row is a bare plugin by package name: the node half (exports ".") runs
+# in the host process (skills catalog route + agent guidance section), and the
+# `dsh.client` declaration in package.json makes the browser half
+# (exports "./client") load in the web GUI.
+- insert:
+    - id: dsh-skill-picker
+      name: 'dsh-skill-picker'

package/lib/client.js

@@ -0,0 +1,331 @@
+window.__ModuleLoader__.load({ id: 'dsh-skill-picker', factory: (require) => { var module = { exports: {} }; var exports = module.exports;
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/client/index.jsx
+var index_exports = {};
+__export(index_exports, {
+  apply: () => apply,
+  inject: () => inject
+});
+module.exports = __toCommonJS(index_exports);
+var import_react = __toESM(require("react"), 1);
+var import_jsx_runtime = require("react/jsx-runtime");
+var inject = ["slots", "connection", "sessions"];
+var USAGE_KEY = "dsh-skill-picker:usage";
+function loadUsage() {
+  try {
+    const raw = localStorage.getItem(USAGE_KEY);
+    if (raw === null) return {};
+    const parsed = JSON.parse(raw);
+    return parsed !== null && typeof parsed === "object" ? parsed : {};
+  } catch {
+    return {};
+  }
+}
+function saveUsage(usage) {
+  try {
+    localStorage.setItem(USAGE_KEY, JSON.stringify(usage));
+  } catch {
+  }
+}
+var buttonStyle = {
+  display: "inline-flex",
+  alignItems: "center",
+  justifyContent: "center",
+  width: "28px",
+  height: "28px",
+  margin: "0 2px",
+  padding: "0",
+  border: "1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.25))",
+  borderRadius: "8px",
+  background: "transparent",
+  color: "var(--dsw-alias-label-secondary, #c9d2e0)",
+  cursor: "pointer",
+  fontSize: "15px",
+  lineHeight: "1",
+  flex: "none"
+};
+var popoverStyle = {
+  position: "absolute",
+  bottom: "calc(100% + 8px)",
+  right: "0",
+  width: "340px",
+  maxHeight: "320px",
+  display: "flex",
+  flexDirection: "column",
+  background: "var(--dsw-specific-tip, #1e2533)",
+  border: "1px solid var(--dsw-alias-border-l1, rgba(128,128,128,0.35))",
+  borderRadius: "12px",
+  boxShadow: "0 8px 28px rgba(0,0,0,0.35)",
+  overflow: "hidden",
+  zIndex: 1e3
+};
+var searchStyle = {
+  boxSizing: "border-box",
+  width: "calc(100% - 16px)",
+  margin: "8px",
+  padding: "6px 10px",
+  border: "1px solid var(--dsw-alias-border-l1, rgba(128,128,128,0.3))",
+  borderRadius: "8px",
+  background: "var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,0.1))",
+  color: "var(--dsw-alias-label-primary, #e6ebf2)",
+  fontSize: "13px",
+  outline: "none"
+};
+var listStyle = {
+  overflowY: "auto",
+  flex: "auto",
+  padding: "0 6px 8px"
+};
+var itemStyle = {
+  display: "flex",
+  flexDirection: "column",
+  alignItems: "flex-start",
+  gap: "2px",
+  width: "100%",
+  padding: "7px 10px",
+  border: "none",
+  borderRadius: "8px",
+  background: "transparent",
+  color: "var(--dsw-alias-label-primary, #e6ebf2)",
+  cursor: "pointer",
+  textAlign: "left"
+};
+var nameStyle = {
+  fontFamily: "var(--ds-font-family-code, ui-monospace, monospace)",
+  fontSize: "13px",
+  fontWeight: 500
+};
+var descStyle = {
+  color: "var(--dsw-alias-label-tertiary, #8a94a6)",
+  fontSize: "12px",
+  lineHeight: "16px",
+  overflow: "hidden",
+  textOverflow: "ellipsis",
+  whiteSpace: "nowrap",
+  maxWidth: "100%"
+};
+var statusStyle = {
+  padding: "12px",
+  color: "var(--dsw-alias-label-tertiary, #8a94a6)",
+  fontSize: "13px"
+};
+function BoltIcon() {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("svg", { viewBox: "0 0 24 24", width: "20", height: "20", "aria-hidden": "true", style: { display: "block" }, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("defs", { children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("linearGradient", { id: "dsh-sp-bolt-grad", x1: "0", y1: "0", x2: "0", y2: "1", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("stop", { offset: "0%", stopColor: "var(--dsw-static-deepseek-400, rgb(103, 158, 254))" }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("stop", { offset: "100%", stopColor: "var(--dsw-static-deepseek-600, rgb(72, 104, 178))" })
+    ] }) }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+      "path",
+      {
+        d: "M11 21h-1l1-7H7.5c-.58 0-.57-.32-.38-.66.19-.34.05-.08.07-.12C8.48 10.94 10.42 7.54 13 3h1l-1 7h3.5c.49 0 .56.33.47.51l-.07.15C12.96 17.55 11 21 11 21z",
+        fill: "url(#dsh-sp-bolt-grad)",
+        stroke: "var(--dsw-static-deepseek-600, rgb(72, 104, 178))",
+        strokeWidth: "0.8",
+        strokeLinejoin: "round"
+      }
+    )
+  ] });
+}
+function SkillPickerButton(props) {
+  const [open, setOpen] = (0, import_react.useState)(false);
+  const [skills, setSkills] = (0, import_react.useState)(void 0);
+  const [error, setError] = (0, import_react.useState)(void 0);
+  const [query, setQuery] = (0, import_react.useState)("");
+  const [usage, setUsage] = (0, import_react.useState)(() => loadUsage());
+  const boxRef = (0, import_react.useRef)(null);
+  const load = (0, import_react.useCallback)(async () => {
+    if (skills !== void 0 || error !== void 0) return;
+    try {
+      if (typeof props.listSkills === "function" && props.session?.sessionId !== void 0) {
+        const listed = await props.listSkills(props.session.sessionId);
+        setSkills(Array.isArray(listed) ? listed : []);
+        return;
+      }
+    } catch (cause) {
+      console.warn("[dsh-skill-picker] official skills API failed, falling back to host route:", cause);
+    }
+    try {
+      const cwd = typeof props.cwd === "string" && props.cwd !== "" ? `?cwd=${encodeURIComponent(props.cwd)}` : "";
+      const res = await fetch(`/dsh-skill-picker/skills${cwd}`, { headers: { accept: "application/json" } });
+      const json = await res.json();
+      if (!json.ok) throw new Error(json.error || "bad response");
+      setSkills(Array.isArray(json.skills) ? json.skills : []);
+    } catch (cause) {
+      setError(String(cause?.message ?? cause));
+    }
+  }, [skills, error, props.listSkills, props.session, props.cwd]);
+  const toggle = () => {
+    if (!open) void load();
+    setOpen(!open);
+  };
+  const pick = (name) => {
+    let draft = "";
+    try {
+      if (props.input !== void 0 && typeof props.input.draft === "string") {
+        draft = props.input.draft;
+      } else if (typeof props.useInput === "function") {
+        const state = props.useInput((s) => s);
+        if (state !== void 0 && typeof state.draft === "string") draft = state.draft;
+      }
+    } catch (cause) {
+      console.error("[dsh-skill-picker] reading draft failed:", cause);
+    }
+    const separator = draft === "" || draft.endsWith(" ") || draft.endsWith("\n") ? "" : " ";
+    const next = `${draft}${separator}/${name} `;
+    try {
+      if (typeof props.inputActions?.setDraft === "function") {
+        props.inputActions.setDraft(next);
+      } else {
+        console.error("[dsh-skill-picker] inputActions.setDraft unavailable; draft not written:", next);
+      }
+    } catch (cause) {
+      console.error("[dsh-skill-picker] setDraft failed:", cause);
+    }
+    const nextUsage = { ...usage, [name]: { count: (usage[name]?.count ?? 0) + 1, lastUsed: Date.now() } };
+    setUsage(nextUsage);
+    saveUsage(nextUsage);
+    setOpen(false);
+    setQuery("");
+  };
+  (0, import_react.useEffect)(() => {
+    if (!open) return;
+    const onDown = (event) => {
+      if (boxRef.current !== null && !boxRef.current.contains(event.target)) setOpen(false);
+    };
+    document.addEventListener("mousedown", onDown);
+    return () => document.removeEventListener("mousedown", onDown);
+  }, [open]);
+  const ordered = (skills ?? []).slice().sort((a, b) => {
+    const ua = usage[a.name];
+    const ub = usage[b.name];
+    const la = ua?.lastUsed ?? 0;
+    const lb = ub?.lastUsed ?? 0;
+    if (la !== lb) return lb - la;
+    const ca = ua?.count ?? 0;
+    const cb = ub?.count ?? 0;
+    if (ca !== cb) return cb - ca;
+    return a.name.localeCompare(b.name);
+  });
+  const filtered = ordered.filter((skill) => {
+    const q = query.trim().toLowerCase();
+    if (q === "") return true;
+    return skill.name.toLowerCase().includes(q) || String(skill.description ?? "").toLowerCase().includes(q);
+  }).slice(0, 60);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { ref: boxRef, style: { position: "relative", display: "inline-flex", flex: "none" }, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+      "button",
+      {
+        type: "button",
+        onClick: toggle,
+        title: "\u9009\u62E9\u6280\u80FD\uFF08\u63D2\u5165 /\u6280\u80FD\u540D \u5230\u53D1\u9001\u6846\uFF09",
+        "aria-label": "\u9009\u62E9\u6280\u80FD",
+        style: {
+          ...buttonStyle,
+          ...open ? { color: "var(--dsw-alias-label-primary-bluish, #4cc9f0)" } : {}
+        },
+        children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(BoltIcon, {})
+      }
+    ),
+    open && /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: popoverStyle, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+        "input",
+        {
+          value: query,
+          onChange: (event) => setQuery(event.target.value),
+          placeholder: "\u641C\u7D22\u6280\u80FD\u2026",
+          style: searchStyle,
+          autoFocus: true
+        }
+      ),
+      error !== void 0 ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: statusStyle, children: `\u52A0\u8F7D\u5931\u8D25\uFF1A${error}` }) : skills === void 0 ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: statusStyle, children: "\u52A0\u8F7D\u4E2D\u2026" }) : /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: listStyle, children: filtered.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: statusStyle, children: "\u6CA1\u6709\u5339\u914D\u7684\u6280\u80FD" }) : filtered.map((skill) => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+        "button",
+        {
+          type: "button",
+          onClick: () => pick(skill.name),
+          onMouseEnter: (event) => {
+            event.currentTarget.style.background = "var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,0.12))";
+          },
+          onMouseLeave: (event) => {
+            event.currentTarget.style.background = "transparent";
+          },
+          style: itemStyle,
+          children: [
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: nameStyle, children: `/${skill.name}` }),
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: descStyle, children: skill.description ?? "" })
+          ]
+        },
+        skill.name
+      )) })
+    ] })
+  ] });
+}
+function apply(ctx) {
+  const listSkills = async (sessionId) => {
+    const skills = ctx.connection?.api?.skills;
+    if (skills === void 0 || typeof skills.list !== "function") {
+      throw new Error("connection.api.skills unavailable");
+    }
+    const controller = new AbortController();
+    const { result } = await skills.list({ sessionId }, controller.signal);
+    if (!result.ok) throw new Error(`skill.list failed: ${result.error?.code}: ${result.error?.message}`);
+    const raw = result.value?.skills ?? [];
+    return raw.map((skill) => ({ name: skill.name, description: skill.description ?? "" }));
+  };
+  let currentCwd = "";
+  const syncCwd = () => {
+    try {
+      const snapshot = ctx.sessions.list.getSnapshot();
+      const sessionId = snapshot.current;
+      const cwd = sessionId === void 0 ? void 0 : snapshot.byId[sessionId]?.cwd;
+      currentCwd = typeof cwd === "string" ? cwd : "";
+    } catch {
+      currentCwd = "";
+    }
+  };
+  syncCwd();
+  const unsubscribe = ctx.sessions.list.subscribe(syncCwd);
+  ctx.effect(() => {
+    const PickerWithCwd = (props) => import_react.default.createElement(SkillPickerButton, { ...props, cwd: currentCwd, listSkills });
+    const dispose = ctx.slots.inject(
+      "conversation.input.right",
+      () => ctx.slots.register(
+        { name: "conversation.input.right", id: "skill-picker", order: 100, label: "Skill picker" },
+        PickerWithCwd
+      )
+    );
+    return () => {
+      dispose();
+      unsubscribe();
+    };
+  }, "dsh-skill-picker: composer input slot");
+}
+return module.exports; } });
+//# sourceMappingURL=client.js.map

package/lib/client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/client/index.jsx"],
+  "sourcesContent": ["/**\n * dsh-skill-picker \u2014 browser half: mounts a skill-picker control into the\n * composer's right tool row (`conversation.input.right` list slot, the seat\n * just before the send button). Clicking it opens a searchable list of\n * installed skills (fetched from the host route `/dsh-skill-picker/skills`),\n * ordered by usage: recently picked first, then frequently used, then the\n * untouched rest (by name). Picking one inserts the official `/skill-name`\n * gesture into the draft via the framework input machine\n * (`inputActions.setDraft`), so DSH's native user-invocation path loads the\n * skill with the message.\n *\n * All DOM/runtime wiring failures are logged, never thrown \u2014 the web shell\n * fails the whole boot when a plugin apply throws.\n *\n * @module dsh-skill-picker/client\n */\n\nimport React, { useCallback, useEffect, useRef, useState } from 'react'\n\n/** Required services: slot registry, host connection (official skills API), sessions (workspace cwd fallback). */\nexport const inject = ['slots', 'connection', 'sessions']\n\n/** localStorage key for the picker's per-browser usage history. */\nconst USAGE_KEY = 'dsh-skill-picker:usage'\n\n/** Read the usage history {name: {count, lastUsed}}; never throws. */\nfunction loadUsage() {\n  try {\n    const raw = localStorage.getItem(USAGE_KEY)\n    if (raw === null) return {}\n    const parsed = JSON.parse(raw)\n    return parsed !== null && typeof parsed === 'object' ? parsed : {}\n  } catch {\n    return {}\n  }\n}\n\n/** Persist the usage history; never throws. */\nfunction saveUsage(usage) {\n  try {\n    localStorage.setItem(USAGE_KEY, JSON.stringify(usage))\n  } catch {\n    /* storage unavailable \u2014 ordering just won't persist */\n  }\n}\n\n/** Row height matches the resident chrome (access mode, plan, attach, model). */\nconst buttonStyle = {\n  display: 'inline-flex',\n  alignItems: 'center',\n  justifyContent: 'center',\n  width: '28px',\n  height: '28px',\n  margin: '0 2px',\n  padding: '0',\n  border: '1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.25))',\n  borderRadius: '8px',\n  background: 'transparent',\n  color: 'var(--dsw-alias-label-secondary, #c9d2e0)',\n  cursor: 'pointer',\n  fontSize: '15px',\n  lineHeight: '1',\n  flex: 'none',\n}\n\nconst popoverStyle = {\n  position: 'absolute',\n  bottom: 'calc(100% + 8px)',\n  right: '0',\n  width: '340px',\n  maxHeight: '320px',\n  display: 'flex',\n  flexDirection: 'column',\n  background: 'var(--dsw-specific-tip, #1e2533)',\n  border: '1px solid var(--dsw-alias-border-l1, rgba(128,128,128,0.35))',\n  borderRadius: '12px',\n  boxShadow: '0 8px 28px rgba(0,0,0,0.35)',\n  overflow: 'hidden',\n  zIndex: 1000,\n}\n\nconst searchStyle = {\n  boxSizing: 'border-box',\n  width: 'calc(100% - 16px)',\n  margin: '8px',\n  padding: '6px 10px',\n  border: '1px solid var(--dsw-alias-border-l1, rgba(128,128,128,0.3))',\n  borderRadius: '8px',\n  background: 'var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,0.1))',\n  color: 'var(--dsw-alias-label-primary, #e6ebf2)',\n  fontSize: '13px',\n  outline: 'none',\n}\n\nconst listStyle = {\n  overflowY: 'auto',\n  flex: 'auto',\n  padding: '0 6px 8px',\n}\n\nconst itemStyle = {\n  display: 'flex',\n  flexDirection: 'column',\n  alignItems: 'flex-start',\n  gap: '2px',\n  width: '100%',\n  padding: '7px 10px',\n  border: 'none',\n  borderRadius: '8px',\n  background: 'transparent',\n  color: 'var(--dsw-alias-label-primary, #e6ebf2)',\n  cursor: 'pointer',\n  textAlign: 'left',\n}\n\nconst nameStyle = {\n  fontFamily: 'var(--ds-font-family-code, ui-monospace, monospace)',\n  fontSize: '13px',\n  fontWeight: 500,\n}\n\nconst descStyle = {\n  color: 'var(--dsw-alias-label-tertiary, #8a94a6)',\n  fontSize: '12px',\n  lineHeight: '16px',\n  overflow: 'hidden',\n  textOverflow: 'ellipsis',\n  whiteSpace: 'nowrap',\n  maxWidth: '100%',\n}\n\nconst statusStyle = {\n  padding: '12px',\n  color: 'var(--dsw-alias-label-tertiary, #8a94a6)',\n  fontSize: '13px',\n}\n\n/** The picker's bolt glyph: DeepSeek palette gradient + slim stroke. */\nfunction BoltIcon() {\n  return (\n    <svg viewBox=\"0 0 24 24\" width=\"20\" height=\"20\" aria-hidden=\"true\" style={{ display: 'block' }}>\n      <defs>\n        <linearGradient id=\"dsh-sp-bolt-grad\" x1=\"0\" y1=\"0\" x2=\"0\" y2=\"1\">\n          <stop offset=\"0%\" stopColor=\"var(--dsw-static-deepseek-400, rgb(103, 158, 254))\" />\n          <stop offset=\"100%\" stopColor=\"var(--dsw-static-deepseek-600, rgb(72, 104, 178))\" />\n        </linearGradient>\n      </defs>\n      <path\n        d=\"M11 21h-1l1-7H7.5c-.58 0-.57-.32-.38-.66.19-.34.05-.08.07-.12C8.48 10.94 10.42 7.54 13 3h1l-1 7h3.5c.49 0 .56.33.47.51l-.07.15C12.96 17.55 11 21 11 21z\"\n        fill=\"url(#dsh-sp-bolt-grad)\"\n        stroke=\"var(--dsw-static-deepseek-600, rgb(72, 104, 178))\"\n        strokeWidth=\"0.8\"\n        strokeLinejoin=\"round\"\n      />\n    </svg>\n  )\n}\n\n/**\n * The picker control for the composer's right tool row. Rendered by the slot\n * renderer with the composed props: owner InputZone (`session`, `input`) plus\n * the framework session kit (`useInput`, `inputActions`).\n */\nfunction SkillPickerButton(props) {\n  const [open, setOpen] = useState(false)\n  const [skills, setSkills] = useState(undefined)\n  const [error, setError] = useState(undefined)\n  const [query, setQuery] = useState('')\n  const [usage, setUsage] = useState(() => loadUsage())\n  const boxRef = useRef(null)\n\n  const load = useCallback(async () => {\n    if (skills !== undefined || error !== undefined) return\n    try {\n      // Primary path: the official host skills API (same source as DSH's own\n      // `/` completion \u2014 session-scoped, covers user + project level).\n      if (typeof props.listSkills === 'function' && props.session?.sessionId !== undefined) {\n        const listed = await props.listSkills(props.session.sessionId)\n        setSkills(Array.isArray(listed) ? listed : [])\n        return\n      }\n    } catch (cause) {\n      console.warn('[dsh-skill-picker] official skills API failed, falling back to host route:', cause)\n    }\n    // Fallback path: the host's own scan route (user + project level dirs).\n    try {\n      const cwd = typeof props.cwd === 'string' && props.cwd !== '' ? `?cwd=${encodeURIComponent(props.cwd)}` : ''\n      const res = await fetch(`/dsh-skill-picker/skills${cwd}`, { headers: { accept: 'application/json' } })\n      const json = await res.json()\n      if (!json.ok) throw new Error(json.error || 'bad response')\n      setSkills(Array.isArray(json.skills) ? json.skills : [])\n    } catch (cause) {\n      setError(String(cause?.message ?? cause))\n    }\n  }, [skills, error, props.listSkills, props.session, props.cwd])\n\n  const toggle = () => {\n    if (!open) void load()\n    setOpen(!open)\n  }\n\n  const pick = (name) => {\n    // Draft source: owner InputZone snapshot first, framework hook second.\n    let draft = ''\n    try {\n      if (props.input !== undefined && typeof props.input.draft === 'string') {\n        draft = props.input.draft\n      } else if (typeof props.useInput === 'function') {\n        const state = props.useInput((s) => s)\n        if (state !== undefined && typeof state.draft === 'string') draft = state.draft\n      }\n    } catch (cause) {\n      console.error('[dsh-skill-picker] reading draft failed:', cause)\n    }\n    const separator = draft === '' || draft.endsWith(' ') || draft.endsWith('\\n') ? '' : ' '\n    const next = `${draft}${separator}/${name} `\n    try {\n      if (typeof props.inputActions?.setDraft === 'function') {\n        props.inputActions.setDraft(next)\n      } else {\n        console.error('[dsh-skill-picker] inputActions.setDraft unavailable; draft not written:', next)\n      }\n    } catch (cause) {\n      console.error('[dsh-skill-picker] setDraft failed:', cause)\n    }\n\n    // Record usage for ordering (recent first, then frequent).\n    const nextUsage = { ...usage, [name]: { count: (usage[name]?.count ?? 0) + 1, lastUsed: Date.now() } }\n    setUsage(nextUsage)\n    saveUsage(nextUsage)\n\n    setOpen(false)\n    setQuery('')\n  }\n\n  // Close on outside pointer-down (the shell's menu convention).\n  useEffect(() => {\n    if (!open) return\n    const onDown = (event) => {\n      if (boxRef.current !== null && !boxRef.current.contains(event.target)) setOpen(false)\n    }\n    document.addEventListener('mousedown', onDown)\n    return () => document.removeEventListener('mousedown', onDown)\n  }, [open])\n\n  // Usage ordering: last picked first, then most frequent, then by name.\n  const ordered = (skills ?? []).slice().sort((a, b) => {\n    const ua = usage[a.name]\n    const ub = usage[b.name]\n    const la = ua?.lastUsed ?? 0\n    const lb = ub?.lastUsed ?? 0\n    if (la !== lb) return lb - la\n    const ca = ua?.count ?? 0\n    const cb = ub?.count ?? 0\n    if (ca !== cb) return cb - ca\n    return a.name.localeCompare(b.name)\n  })\n\n  const filtered = ordered\n    .filter((skill) => {\n      const q = query.trim().toLowerCase()\n      if (q === '') return true\n      return skill.name.toLowerCase().includes(q) || String(skill.description ?? '').toLowerCase().includes(q)\n    })\n    .slice(0, 60)\n\n  return (\n    <div ref={boxRef} style={{ position: 'relative', display: 'inline-flex', flex: 'none' }}>\n      <button\n        type=\"button\"\n        onClick={toggle}\n        title=\"\u9009\u62E9\u6280\u80FD\uFF08\u63D2\u5165 /\u6280\u80FD\u540D \u5230\u53D1\u9001\u6846\uFF09\"\n        aria-label=\"\u9009\u62E9\u6280\u80FD\"\n        style={{\n          ...buttonStyle,\n          ...(open ? { color: 'var(--dsw-alias-label-primary-bluish, #4cc9f0)' } : {}),\n        }}\n      >\n        <BoltIcon />\n      </button>\n      {open && (\n        <div style={popoverStyle}>\n          <input\n            value={query}\n            onChange={(event) => setQuery(event.target.value)}\n            placeholder=\"\u641C\u7D22\u6280\u80FD\u2026\"\n            style={searchStyle}\n            autoFocus\n          />\n          {error !== undefined ? (\n            <div style={statusStyle}>{`\u52A0\u8F7D\u5931\u8D25\uFF1A${error}`}</div>\n          ) : skills === undefined ? (\n            <div style={statusStyle}>\u52A0\u8F7D\u4E2D\u2026</div>\n          ) : (\n            <div style={listStyle}>\n              {filtered.length === 0 ? (\n                <div style={statusStyle}>\u6CA1\u6709\u5339\u914D\u7684\u6280\u80FD</div>\n              ) : (\n                filtered.map((skill) => (\n                  <button\n                    key={skill.name}\n                    type=\"button\"\n                    onClick={() => pick(skill.name)}\n                    onMouseEnter={(event) => {\n                      event.currentTarget.style.background = 'var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,0.12))'\n                    }}\n                    onMouseLeave={(event) => {\n                      event.currentTarget.style.background = 'transparent'\n                    }}\n                    style={itemStyle}\n                  >\n                    <span style={nameStyle}>{`/${skill.name}`}</span>\n                    <span style={descStyle}>{skill.description ?? ''}</span>\n                  </button>\n                ))\n              )}\n            </div>\n          )}\n        </div>\n      )}\n    </div>\n  )\n}\n\n/** Apply the browser half: register the picker into the composer tool row. */\nexport function apply(ctx) {\n  // Primary skill source: the official host skills API (the exact RPC ui-skill\n  // feeds DSH's own `/` completion with \u2014 session-scoped, all skill layers).\n  const listSkills = async (sessionId) => {\n    const skills = ctx.connection?.api?.skills\n    if (skills === undefined || typeof skills.list !== 'function') {\n      throw new Error('connection.api.skills unavailable')\n    }\n    const controller = new AbortController()\n    const { result } = await skills.list({ sessionId }, controller.signal)\n    if (!result.ok) throw new Error(`skill.list failed: ${result.error?.code}: ${result.error?.message}`)\n    const raw = result.value?.skills ?? []\n    return raw.map((skill) => ({ name: skill.name, description: skill.description ?? '' }))\n  }\n\n  // Track the active session's workspace cwd for the host-route fallback.\n  let currentCwd = ''\n  const syncCwd = () => {\n    try {\n      const snapshot = ctx.sessions.list.getSnapshot()\n      const sessionId = snapshot.current\n      const cwd = sessionId === undefined ? undefined : snapshot.byId[sessionId]?.cwd\n      currentCwd = typeof cwd === 'string' ? cwd : ''\n    } catch {\n      currentCwd = ''\n    }\n  }\n  syncCwd()\n  const unsubscribe = ctx.sessions.list.subscribe(syncCwd)\n  ctx.effect(() => {\n    // Wrap the component so framework props pass through untouched and the\n    // live workspace cwd + official skills fetcher are attached \u2014 never\n    // swallow the composed props.\n    const PickerWithCwd = (props) =>\n      React.createElement(SkillPickerButton, { ...props, cwd: currentCwd, listSkills })\n    const dispose = ctx.slots.inject('conversation.input.right', () =>\n      ctx.slots.register(\n        { name: 'conversation.input.right', id: 'skill-picker', order: 100, label: 'Skill picker' },\n        PickerWithCwd,\n      ),\n    )\n    return () => {\n      dispose()\n      unsubscribe()\n    }\n  }, 'dsh-skill-picker: composer input slot')\n}\n"],
+  "mappings": "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",
+  "names": ["React"]
+}

package/lib/index.js

@@ -0,0 +1,83 @@
+// src/index.js
+import { readFile, readdir } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+var inject = ["webServer", "systemPrompt"];
+var SECTION_ORDER = 215;
+var SKILL_PICKER_GUIDANCE = "\u672C\u673A\u5DF2\u5B89\u88C5 dsh-skill-picker \u63D2\u4EF6\uFF08Web GUI \u7684\u6280\u80FD\u9009\u62E9\u5668\uFF09\uFF1A\u8F93\u5165\u6846\u65C1\u6709\u6280\u80FD\u6309\u94AE\uFF0C\u7528\u6237\u70B9\u9009\u6280\u80FD\u540E\u4F1A\u628A `/\u6280\u80FD\u540D`\uFF08\u5982 /duo-xuan-pi-gai\uFF09\u63D2\u5165\u53D1\u9001\u6846\u5E76\u968F\u6D88\u606F\u53D1\u51FA\u3002DSH \u5B98\u65B9\u673A\u5236\u4F1A\u628A\u7528\u6237\u6D88\u606F\u91CC\u7684 `/\u6280\u80FD\u540D` \u624B\u52BF\u5F53\u4F5C\u6280\u80FD\u76F4\u63A5\u8C03\u7528\u5E76\u81EA\u52A8\u52A0\u8F7D\u6280\u80FD\u5185\u5BB9\u2014\u2014\u4F60\u7167\u5E38\u6309\u52A0\u8F7D\u540E\u7684\u6280\u80FD\u6307\u4EE4\u6267\u884C\u5373\u53EF\uFF0C\u65E0\u9700\u989D\u5916\u64CD\u4F5C\u3002\u7528\u6237\u8BF4\u300C\u6280\u80FD\u9009\u62E9\u5668 / \u9009\u4E2A\u6280\u80FD / \u6280\u80FD\u5217\u8868\u300D\u65F6\u5373\u6307\u672C\u63D2\u4EF6\u3002";
+function userSkillsDir() {
+  const home = process.env.DSH_HOME ?? path.join(os.homedir(), ".dsh");
+  return path.join(home, "skills");
+}
+function parseFrontmatter(content) {
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!match) return {};
+  const out = {};
+  for (const line of match[1].split(/\r?\n/)) {
+    const kv = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+    if (!kv) continue;
+    const value = kv[2].trim().replace(/^["']|["']$/g, "");
+    if (value !== "") out[kv[1]] = value;
+  }
+  return out;
+}
+async function scanSkillsDirInto(map, dir) {
+  let entries;
+  try {
+    entries = await readdir(dir, { withFileTypes: true });
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const skillDir = path.join(dir, entry.name);
+    let content;
+    try {
+      content = await readFile(path.join(skillDir, "SKILL.md"), "utf8");
+    } catch {
+      continue;
+    }
+    const meta = parseFrontmatter(content);
+    map.set(meta.name ?? entry.name, {
+      name: meta.name ?? entry.name,
+      description: meta.description ?? "",
+      path: skillDir
+    });
+  }
+}
+async function scanSkills(cwd) {
+  const map = /* @__PURE__ */ new Map();
+  await scanSkillsDirInto(map, userSkillsDir());
+  if (typeof cwd === "string" && cwd !== "") {
+    await scanSkillsDirInto(map, path.join(cwd, ".dsh", "skills"));
+    await scanSkillsDirInto(map, path.join(cwd, ".agents", "skills"));
+  }
+  return [...map.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+function apply(ctx) {
+  ctx.effect(() => {
+    const handler = async (req, res) => {
+      try {
+        const cwd = req.url !== void 0 ? new URL(req.url, "http://dsh").searchParams.get("cwd") ?? void 0 : void 0;
+        const skills = await scanSkills(cwd);
+        res.writeHead(200, { "content-type": "application/json; charset=utf-8" });
+        res.end(JSON.stringify({ ok: true, complete: true, skills }));
+      } catch (error) {
+        res.writeHead(500, { "content-type": "application/json; charset=utf-8" });
+        res.end(JSON.stringify({ ok: false, error: String(error?.message ?? error) }));
+      }
+    };
+    return ctx.webServer.register({ kind: "prefix", path: "/dsh-skill-picker", handler });
+  }, "dsh-skill-picker: routes");
+  ctx.effect(() => ctx.systemPrompt.section({
+    name: "plugin:skill-picker",
+    order: SECTION_ORDER,
+    text: SKILL_PICKER_GUIDANCE
+  }), "dsh-skill-picker: prompt section");
+}
+export {
+  SKILL_PICKER_GUIDANCE,
+  apply,
+  inject
+};
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.js"],
+  "sourcesContent": ["/**\n * dsh-skill-picker \u2014 host half: exposes the installed-skill catalog to the\n * browser half through a small JSON route (`/dsh-skill-picker/skills`) and\n * announces the picker to every agent through the system-prompt section\n * mechanism.\n *\n * The catalog is scanned directly from the DSH user skills directory\n * (`$DSH_HOME/skills`, default `~/.dsh/skills`) by reading each skill's\n * `SKILL.md` frontmatter. Why not `ctx.skills`? The filesystem skill provider\n * is mounted in agent scope (the standard preset's standing mount), so a\n * host-context `ctx.skills.snapshot({})` sees only the global layer \u2014 which\n * is empty for user skills. Scanning the same roots the provider uses keeps\n * the picker's list in sync with what agents actually load.\n *\n * The browser half (exports \"./client\") is served by client-modules from the\n * same package's dsh.client declaration.\n *\n * @module dsh-skill-picker\n */\n\nimport { readFile, readdir } from 'node:fs/promises'\nimport os from 'node:os'\nimport path from 'node:path'\n\n/** Required services: the route registry and the prompt band. */\nexport const inject = ['webServer', 'systemPrompt']\n\n/** Order of the announcement section within the tool-guidance band. */\nconst SECTION_ORDER = 215\n\n/** Model-facing announcement: picker presence and the user-visible gesture. */\nexport const SKILL_PICKER_GUIDANCE =\n  '\u672C\u673A\u5DF2\u5B89\u88C5 dsh-skill-picker \u63D2\u4EF6\uFF08Web GUI \u7684\u6280\u80FD\u9009\u62E9\u5668\uFF09\uFF1A\u8F93\u5165\u6846\u65C1\u6709\u6280\u80FD\u6309\u94AE\uFF0C\u7528\u6237\u70B9\u9009\u6280\u80FD\u540E\u4F1A\u628A `/\u6280\u80FD\u540D`\uFF08\u5982 /duo-xuan-pi-gai\uFF09\u63D2\u5165\u53D1\u9001\u6846\u5E76\u968F\u6D88\u606F\u53D1\u51FA\u3002DSH \u5B98\u65B9\u673A\u5236\u4F1A\u628A\u7528\u6237\u6D88\u606F\u91CC\u7684 `/\u6280\u80FD\u540D` \u624B\u52BF\u5F53\u4F5C\u6280\u80FD\u76F4\u63A5\u8C03\u7528\u5E76\u81EA\u52A8\u52A0\u8F7D\u6280\u80FD\u5185\u5BB9\u2014\u2014\u4F60\u7167\u5E38\u6309\u52A0\u8F7D\u540E\u7684\u6280\u80FD\u6307\u4EE4\u6267\u884C\u5373\u53EF\uFF0C\u65E0\u9700\u989D\u5916\u64CD\u4F5C\u3002\u7528\u6237\u8BF4\u300C\u6280\u80FD\u9009\u62E9\u5668 / \u9009\u4E2A\u6280\u80FD / \u6280\u80FD\u5217\u8868\u300D\u65F6\u5373\u6307\u672C\u63D2\u4EF6\u3002'\n\n/** Resolve the user skills directory, mirroring the official provider's default. */\nfunction userSkillsDir() {\n  const home = process.env.DSH_HOME ?? path.join(os.homedir(), '.dsh')\n  return path.join(home, 'skills')\n}\n\n/** Parse a SKILL.md frontmatter block into a key/value map (flat YAML subset). */\nfunction parseFrontmatter(content) {\n  const match = content.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---/)\n  if (!match) return {}\n  const out = {}\n  for (const line of match[1].split(/\\r?\\n/)) {\n    const kv = line.match(/^([A-Za-z0-9_-]+):\\s*(.*)$/)\n    if (!kv) continue\n    const value = kv[2].trim().replace(/^[\"']|[\"']$/g, '')\n    if (value !== '') out[kv[1]] = value\n  }\n  return out\n}\n\n/** Scan one skill directory into the map; never throws (missing dir is a no-op). */\nasync function scanSkillsDirInto(map, dir) {\n  let entries\n  try {\n    entries = await readdir(dir, { withFileTypes: true })\n  } catch {\n    return\n  }\n  for (const entry of entries) {\n    if (!entry.isDirectory()) continue\n    const skillDir = path.join(dir, entry.name)\n    let content\n    try {\n      content = await readFile(path.join(skillDir, 'SKILL.md'), 'utf8')\n    } catch {\n      continue\n    }\n    const meta = parseFrontmatter(content)\n    // Later writes win, so project-level skills override same-named user skills.\n    map.set(meta.name ?? entry.name, {\n      name: meta.name ?? entry.name,\n      description: meta.description ?? '',\n      path: skillDir,\n    })\n  }\n}\n\n/**\n * Scan user-level plus (when a workspace cwd is known) project-level skill\n * directories, mirroring the official provider's roots. Never throws (a\n * missing user dir yields []).\n * @param cwd - the active session's workspace root (undefined = user level only).\n */\nasync function scanSkills(cwd) {\n  const map = new Map()\n  await scanSkillsDirInto(map, userSkillsDir())\n  if (typeof cwd === 'string' && cwd !== '') {\n    await scanSkillsDirInto(map, path.join(cwd, '.dsh', 'skills'))\n    await scanSkillsDirInto(map, path.join(cwd, '.agents', 'skills'))\n  }\n  return [...map.values()].sort((a, b) => a.name.localeCompare(b.name))\n}\n\n/**\n * Mount the skills route and the prompt section.\n * @param ctx - context carrying webServer and systemPrompt.\n */\nexport function apply(ctx) {\n  ctx.effect(() => {\n    const handler = async (req, res) => {\n      try {\n        // cwd query carries the active session's workspace root from the client.\n        const cwd = req.url !== undefined ? new URL(req.url, 'http://dsh').searchParams.get('cwd') ?? undefined : undefined\n        const skills = await scanSkills(cwd)\n        res.writeHead(200, { 'content-type': 'application/json; charset=utf-8' })\n        res.end(JSON.stringify({ ok: true, complete: true, skills }))\n      } catch (error) {\n        res.writeHead(500, { 'content-type': 'application/json; charset=utf-8' })\n        res.end(JSON.stringify({ ok: false, error: String(error?.message ?? error) }))\n      }\n    }\n    return ctx.webServer.register({ kind: 'prefix', path: '/dsh-skill-picker', handler })\n  }, 'dsh-skill-picker: routes')\n\n  ctx.effect(() => ctx.systemPrompt.section({\n    name: 'plugin:skill-picker',\n    order: SECTION_ORDER,\n    text: SKILL_PICKER_GUIDANCE,\n  }), 'dsh-skill-picker: prompt section')\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "dsh-skill-picker",
+  "description": "DSH Web GUI skill picker: a button beside the composer opens a searchable list of installed skills; picking one inserts the official `/skill-name` gesture into the input box, so the skill loads with your message (WorkBuddy-style skill invocation for DeepSeek Harness).",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "node build.mjs"
+  },
+  "devDependencies": {
+    "esbuild": "^0.25.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-locale"
+      ],
+      "platform": "web"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-skill": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
+    "react": "^18.2.0"
+  },
+  "files": [
+    "lib",
+    "src",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/a735624258/dsh-skill-picker.git"
+  }
+}

package/src/client/index.jsx

@@ -0,0 +1,372 @@
+/**
+ * dsh-skill-picker — browser half: mounts a skill-picker control into the
+ * composer's right tool row (`conversation.input.right` list slot, the seat
+ * just before the send button). Clicking it opens a searchable list of
+ * installed skills (fetched from the host route `/dsh-skill-picker/skills`),
+ * ordered by usage: recently picked first, then frequently used, then the
+ * untouched rest (by name). Picking one inserts the official `/skill-name`
+ * gesture into the draft via the framework input machine
+ * (`inputActions.setDraft`), so DSH's native user-invocation path loads the
+ * skill with the message.
+ *
+ * All DOM/runtime wiring failures are logged, never thrown — the web shell
+ * fails the whole boot when a plugin apply throws.
+ *
+ * @module dsh-skill-picker/client
+ */
+
+import React, { useCallback, useEffect, useRef, useState } from 'react'
+
+/** Required services: slot registry, host connection (official skills API), sessions (workspace cwd fallback). */
+export const inject = ['slots', 'connection', 'sessions']
+
+/** localStorage key for the picker's per-browser usage history. */
+const USAGE_KEY = 'dsh-skill-picker:usage'
+
+/** Read the usage history {name: {count, lastUsed}}; never throws. */
+function loadUsage() {
+  try {
+    const raw = localStorage.getItem(USAGE_KEY)
+    if (raw === null) return {}
+    const parsed = JSON.parse(raw)
+    return parsed !== null && typeof parsed === 'object' ? parsed : {}
+  } catch {
+    return {}
+  }
+}
+
+/** Persist the usage history; never throws. */
+function saveUsage(usage) {
+  try {
+    localStorage.setItem(USAGE_KEY, JSON.stringify(usage))
+  } catch {
+    /* storage unavailable — ordering just won't persist */
+  }
+}
+
+/** Row height matches the resident chrome (access mode, plan, attach, model). */
+const buttonStyle = {
+  display: 'inline-flex',
+  alignItems: 'center',
+  justifyContent: 'center',
+  width: '28px',
+  height: '28px',
+  margin: '0 2px',
+  padding: '0',
+  border: '1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.25))',
+  borderRadius: '8px',
+  background: 'transparent',
+  color: 'var(--dsw-alias-label-secondary, #c9d2e0)',
+  cursor: 'pointer',
+  fontSize: '15px',
+  lineHeight: '1',
+  flex: 'none',
+}
+
+const popoverStyle = {
+  position: 'absolute',
+  bottom: 'calc(100% + 8px)',
+  right: '0',
+  width: '340px',
+  maxHeight: '320px',
+  display: 'flex',
+  flexDirection: 'column',
+  background: 'var(--dsw-specific-tip, #1e2533)',
+  border: '1px solid var(--dsw-alias-border-l1, rgba(128,128,128,0.35))',
+  borderRadius: '12px',
+  boxShadow: '0 8px 28px rgba(0,0,0,0.35)',
+  overflow: 'hidden',
+  zIndex: 1000,
+}
+
+const searchStyle = {
+  boxSizing: 'border-box',
+  width: 'calc(100% - 16px)',
+  margin: '8px',
+  padding: '6px 10px',
+  border: '1px solid var(--dsw-alias-border-l1, rgba(128,128,128,0.3))',
+  borderRadius: '8px',
+  background: 'var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,0.1))',
+  color: 'var(--dsw-alias-label-primary, #e6ebf2)',
+  fontSize: '13px',
+  outline: 'none',
+}
+
+const listStyle = {
+  overflowY: 'auto',
+  flex: 'auto',
+  padding: '0 6px 8px',
+}
+
+const itemStyle = {
+  display: 'flex',
+  flexDirection: 'column',
+  alignItems: 'flex-start',
+  gap: '2px',
+  width: '100%',
+  padding: '7px 10px',
+  border: 'none',
+  borderRadius: '8px',
+  background: 'transparent',
+  color: 'var(--dsw-alias-label-primary, #e6ebf2)',
+  cursor: 'pointer',
+  textAlign: 'left',
+}
+
+const nameStyle = {
+  fontFamily: 'var(--ds-font-family-code, ui-monospace, monospace)',
+  fontSize: '13px',
+  fontWeight: 500,
+}
+
+const descStyle = {
+  color: 'var(--dsw-alias-label-tertiary, #8a94a6)',
+  fontSize: '12px',
+  lineHeight: '16px',
+  overflow: 'hidden',
+  textOverflow: 'ellipsis',
+  whiteSpace: 'nowrap',
+  maxWidth: '100%',
+}
+
+const statusStyle = {
+  padding: '12px',
+  color: 'var(--dsw-alias-label-tertiary, #8a94a6)',
+  fontSize: '13px',
+}
+
+/** The picker's bolt glyph: DeepSeek palette gradient + slim stroke. */
+function BoltIcon() {
+  return (
+    <svg viewBox="0 0 24 24" width="20" height="20" aria-hidden="true" style={{ display: 'block' }}>
+      <defs>
+        <linearGradient id="dsh-sp-bolt-grad" x1="0" y1="0" x2="0" y2="1">
+          <stop offset="0%" stopColor="var(--dsw-static-deepseek-400, rgb(103, 158, 254))" />
+          <stop offset="100%" stopColor="var(--dsw-static-deepseek-600, rgb(72, 104, 178))" />
+        </linearGradient>
+      </defs>
+      <path
+        d="M11 21h-1l1-7H7.5c-.58 0-.57-.32-.38-.66.19-.34.05-.08.07-.12C8.48 10.94 10.42 7.54 13 3h1l-1 7h3.5c.49 0 .56.33.47.51l-.07.15C12.96 17.55 11 21 11 21z"
+        fill="url(#dsh-sp-bolt-grad)"
+        stroke="var(--dsw-static-deepseek-600, rgb(72, 104, 178))"
+        strokeWidth="0.8"
+        strokeLinejoin="round"
+      />
+    </svg>
+  )
+}
+
+/**
+ * The picker control for the composer's right tool row. Rendered by the slot
+ * renderer with the composed props: owner InputZone (`session`, `input`) plus
+ * the framework session kit (`useInput`, `inputActions`).
+ */
+function SkillPickerButton(props) {
+  const [open, setOpen] = useState(false)
+  const [skills, setSkills] = useState(undefined)
+  const [error, setError] = useState(undefined)
+  const [query, setQuery] = useState('')
+  const [usage, setUsage] = useState(() => loadUsage())
+  const boxRef = useRef(null)
+
+  const load = useCallback(async () => {
+    if (skills !== undefined || error !== undefined) return
+    try {
+      // Primary path: the official host skills API (same source as DSH's own
+      // `/` completion — session-scoped, covers user + project level).
+      if (typeof props.listSkills === 'function' && props.session?.sessionId !== undefined) {
+        const listed = await props.listSkills(props.session.sessionId)
+        setSkills(Array.isArray(listed) ? listed : [])
+        return
+      }
+    } catch (cause) {
+      console.warn('[dsh-skill-picker] official skills API failed, falling back to host route:', cause)
+    }
+    // Fallback path: the host's own scan route (user + project level dirs).
+    try {
+      const cwd = typeof props.cwd === 'string' && props.cwd !== '' ? `?cwd=${encodeURIComponent(props.cwd)}` : ''
+      const res = await fetch(`/dsh-skill-picker/skills${cwd}`, { headers: { accept: 'application/json' } })
+      const json = await res.json()
+      if (!json.ok) throw new Error(json.error || 'bad response')
+      setSkills(Array.isArray(json.skills) ? json.skills : [])
+    } catch (cause) {
+      setError(String(cause?.message ?? cause))
+    }
+  }, [skills, error, props.listSkills, props.session, props.cwd])
+
+  const toggle = () => {
+    if (!open) void load()
+    setOpen(!open)
+  }
+
+  const pick = (name) => {
+    // Draft source: owner InputZone snapshot first, framework hook second.
+    let draft = ''
+    try {
+      if (props.input !== undefined && typeof props.input.draft === 'string') {
+        draft = props.input.draft
+      } else if (typeof props.useInput === 'function') {
+        const state = props.useInput((s) => s)
+        if (state !== undefined && typeof state.draft === 'string') draft = state.draft
+      }
+    } catch (cause) {
+      console.error('[dsh-skill-picker] reading draft failed:', cause)
+    }
+    const separator = draft === '' || draft.endsWith(' ') || draft.endsWith('\n') ? '' : ' '
+    const next = `${draft}${separator}/${name} `
+    try {
+      if (typeof props.inputActions?.setDraft === 'function') {
+        props.inputActions.setDraft(next)
+      } else {
+        console.error('[dsh-skill-picker] inputActions.setDraft unavailable; draft not written:', next)
+      }
+    } catch (cause) {
+      console.error('[dsh-skill-picker] setDraft failed:', cause)
+    }
+
+    // Record usage for ordering (recent first, then frequent).
+    const nextUsage = { ...usage, [name]: { count: (usage[name]?.count ?? 0) + 1, lastUsed: Date.now() } }
+    setUsage(nextUsage)
+    saveUsage(nextUsage)
+
+    setOpen(false)
+    setQuery('')
+  }
+
+  // Close on outside pointer-down (the shell's menu convention).
+  useEffect(() => {
+    if (!open) return
+    const onDown = (event) => {
+      if (boxRef.current !== null && !boxRef.current.contains(event.target)) setOpen(false)
+    }
+    document.addEventListener('mousedown', onDown)
+    return () => document.removeEventListener('mousedown', onDown)
+  }, [open])
+
+  // Usage ordering: last picked first, then most frequent, then by name.
+  const ordered = (skills ?? []).slice().sort((a, b) => {
+    const ua = usage[a.name]
+    const ub = usage[b.name]
+    const la = ua?.lastUsed ?? 0
+    const lb = ub?.lastUsed ?? 0
+    if (la !== lb) return lb - la
+    const ca = ua?.count ?? 0
+    const cb = ub?.count ?? 0
+    if (ca !== cb) return cb - ca
+    return a.name.localeCompare(b.name)
+  })
+
+  const filtered = ordered
+    .filter((skill) => {
+      const q = query.trim().toLowerCase()
+      if (q === '') return true
+      return skill.name.toLowerCase().includes(q) || String(skill.description ?? '').toLowerCase().includes(q)
+    })
+    .slice(0, 60)
+
+  return (
+    <div ref={boxRef} style={{ position: 'relative', display: 'inline-flex', flex: 'none' }}>
+      <button
+        type="button"
+        onClick={toggle}
+        title="选择技能（插入 /技能名 到发送框）"
+        aria-label="选择技能"
+        style={{
+          ...buttonStyle,
+          ...(open ? { color: 'var(--dsw-alias-label-primary-bluish, #4cc9f0)' } : {}),
+        }}
+      >
+        <BoltIcon />
+      </button>
+      {open && (
+        <div style={popoverStyle}>
+          <input
+            value={query}
+            onChange={(event) => setQuery(event.target.value)}
+            placeholder="搜索技能…"
+            style={searchStyle}
+            autoFocus
+          />
+          {error !== undefined ? (
+            <div style={statusStyle}>{`加载失败：${error}`}</div>
+          ) : skills === undefined ? (
+            <div style={statusStyle}>加载中…</div>
+          ) : (
+            <div style={listStyle}>
+              {filtered.length === 0 ? (
+                <div style={statusStyle}>没有匹配的技能</div>
+              ) : (
+                filtered.map((skill) => (
+                  <button
+                    key={skill.name}
+                    type="button"
+                    onClick={() => pick(skill.name)}
+                    onMouseEnter={(event) => {
+                      event.currentTarget.style.background = 'var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,0.12))'
+                    }}
+                    onMouseLeave={(event) => {
+                      event.currentTarget.style.background = 'transparent'
+                    }}
+                    style={itemStyle}
+                  >
+                    <span style={nameStyle}>{`/${skill.name}`}</span>
+                    <span style={descStyle}>{skill.description ?? ''}</span>
+                  </button>
+                ))
+              )}
+            </div>
+          )}
+        </div>
+      )}
+    </div>
+  )
+}
+
+/** Apply the browser half: register the picker into the composer tool row. */
+export function apply(ctx) {
+  // Primary skill source: the official host skills API (the exact RPC ui-skill
+  // feeds DSH's own `/` completion with — session-scoped, all skill layers).
+  const listSkills = async (sessionId) => {
+    const skills = ctx.connection?.api?.skills
+    if (skills === undefined || typeof skills.list !== 'function') {
+      throw new Error('connection.api.skills unavailable')
+    }
+    const controller = new AbortController()
+    const { result } = await skills.list({ sessionId }, controller.signal)
+    if (!result.ok) throw new Error(`skill.list failed: ${result.error?.code}: ${result.error?.message}`)
+    const raw = result.value?.skills ?? []
+    return raw.map((skill) => ({ name: skill.name, description: skill.description ?? '' }))
+  }
+
+  // Track the active session's workspace cwd for the host-route fallback.
+  let currentCwd = ''
+  const syncCwd = () => {
+    try {
+      const snapshot = ctx.sessions.list.getSnapshot()
+      const sessionId = snapshot.current
+      const cwd = sessionId === undefined ? undefined : snapshot.byId[sessionId]?.cwd
+      currentCwd = typeof cwd === 'string' ? cwd : ''
+    } catch {
+      currentCwd = ''
+    }
+  }
+  syncCwd()
+  const unsubscribe = ctx.sessions.list.subscribe(syncCwd)
+  ctx.effect(() => {
+    // Wrap the component so framework props pass through untouched and the
+    // live workspace cwd + official skills fetcher are attached — never
+    // swallow the composed props.
+    const PickerWithCwd = (props) =>
+      React.createElement(SkillPickerButton, { ...props, cwd: currentCwd, listSkills })
+    const dispose = ctx.slots.inject('conversation.input.right', () =>
+      ctx.slots.register(
+        { name: 'conversation.input.right', id: 'skill-picker', order: 100, label: 'Skill picker' },
+        PickerWithCwd,
+      ),
+    )
+    return () => {
+      dispose()
+      unsubscribe()
+    }
+  }, 'dsh-skill-picker: composer input slot')
+}

package/src/index.js

@@ -0,0 +1,124 @@
+/**
+ * dsh-skill-picker — host half: exposes the installed-skill catalog to the
+ * browser half through a small JSON route (`/dsh-skill-picker/skills`) and
+ * announces the picker to every agent through the system-prompt section
+ * mechanism.
+ *
+ * The catalog is scanned directly from the DSH user skills directory
+ * (`$DSH_HOME/skills`, default `~/.dsh/skills`) by reading each skill's
+ * `SKILL.md` frontmatter. Why not `ctx.skills`? The filesystem skill provider
+ * is mounted in agent scope (the standard preset's standing mount), so a
+ * host-context `ctx.skills.snapshot({})` sees only the global layer — which
+ * is empty for user skills. Scanning the same roots the provider uses keeps
+ * the picker's list in sync with what agents actually load.
+ *
+ * The browser half (exports "./client") is served by client-modules from the
+ * same package's dsh.client declaration.
+ *
+ * @module dsh-skill-picker
+ */
+
+import { readFile, readdir } from 'node:fs/promises'
+import os from 'node:os'
+import path from 'node:path'
+
+/** Required services: the route registry and the prompt band. */
+export const inject = ['webServer', 'systemPrompt']
+
+/** Order of the announcement section within the tool-guidance band. */
+const SECTION_ORDER = 215
+
+/** Model-facing announcement: picker presence and the user-visible gesture. */
+export const SKILL_PICKER_GUIDANCE =
+  '本机已安装 dsh-skill-picker 插件（Web GUI 的技能选择器）：输入框旁有技能按钮，用户点选技能后会把 `/技能名`（如 /duo-xuan-pi-gai）插入发送框并随消息发出。DSH 官方机制会把用户消息里的 `/技能名` 手势当作技能直接调用并自动加载技能内容——你照常按加载后的技能指令执行即可，无需额外操作。用户说「技能选择器 / 选个技能 / 技能列表」时即指本插件。'
+
+/** Resolve the user skills directory, mirroring the official provider's default. */
+function userSkillsDir() {
+  const home = process.env.DSH_HOME ?? path.join(os.homedir(), '.dsh')
+  return path.join(home, 'skills')
+}
+
+/** Parse a SKILL.md frontmatter block into a key/value map (flat YAML subset). */
+function parseFrontmatter(content) {
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/)
+  if (!match) return {}
+  const out = {}
+  for (const line of match[1].split(/\r?\n/)) {
+    const kv = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/)
+    if (!kv) continue
+    const value = kv[2].trim().replace(/^["']|["']$/g, '')
+    if (value !== '') out[kv[1]] = value
+  }
+  return out
+}
+
+/** Scan one skill directory into the map; never throws (missing dir is a no-op). */
+async function scanSkillsDirInto(map, dir) {
+  let entries
+  try {
+    entries = await readdir(dir, { withFileTypes: true })
+  } catch {
+    return
+  }
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue
+    const skillDir = path.join(dir, entry.name)
+    let content
+    try {
+      content = await readFile(path.join(skillDir, 'SKILL.md'), 'utf8')
+    } catch {
+      continue
+    }
+    const meta = parseFrontmatter(content)
+    // Later writes win, so project-level skills override same-named user skills.
+    map.set(meta.name ?? entry.name, {
+      name: meta.name ?? entry.name,
+      description: meta.description ?? '',
+      path: skillDir,
+    })
+  }
+}
+
+/**
+ * Scan user-level plus (when a workspace cwd is known) project-level skill
+ * directories, mirroring the official provider's roots. Never throws (a
+ * missing user dir yields []).
+ * @param cwd - the active session's workspace root (undefined = user level only).
+ */
+async function scanSkills(cwd) {
+  const map = new Map()
+  await scanSkillsDirInto(map, userSkillsDir())
+  if (typeof cwd === 'string' && cwd !== '') {
+    await scanSkillsDirInto(map, path.join(cwd, '.dsh', 'skills'))
+    await scanSkillsDirInto(map, path.join(cwd, '.agents', 'skills'))
+  }
+  return [...map.values()].sort((a, b) => a.name.localeCompare(b.name))
+}
+
+/**
+ * Mount the skills route and the prompt section.
+ * @param ctx - context carrying webServer and systemPrompt.
+ */
+export function apply(ctx) {
+  ctx.effect(() => {
+    const handler = async (req, res) => {
+      try {
+        // cwd query carries the active session's workspace root from the client.
+        const cwd = req.url !== undefined ? new URL(req.url, 'http://dsh').searchParams.get('cwd') ?? undefined : undefined
+        const skills = await scanSkills(cwd)
+        res.writeHead(200, { 'content-type': 'application/json; charset=utf-8' })
+        res.end(JSON.stringify({ ok: true, complete: true, skills }))
+      } catch (error) {
+        res.writeHead(500, { 'content-type': 'application/json; charset=utf-8' })
+        res.end(JSON.stringify({ ok: false, error: String(error?.message ?? error) }))
+      }
+    }
+    return ctx.webServer.register({ kind: 'prefix', path: '/dsh-skill-picker', handler })
+  }, 'dsh-skill-picker: routes')
+
+  ctx.effect(() => ctx.systemPrompt.section({
+    name: 'plugin:skill-picker',
+    order: SECTION_ORDER,
+    text: SKILL_PICKER_GUIDANCE,
+  }), 'dsh-skill-picker: prompt section')
+}