dsh-vscode-mode 0.22.0 → 0.23.0

package/src/shared/quickPick.ts

@@ -0,0 +1,67 @@
+/**
+ * dsh-vscode-mode 快捷菜单共享纯函数 — 下拉选择器的状态与摘要文案。
+ *
+ * 纯函数模块：禁 node/react 导入（与 shared/quickMenu.ts 同约束）。
+ * 为什么抽：工作区/技能/规则三个下拉的「触发器上显示什么」「怎么切换一项」是同一类
+ * 纯计算，放在 shared 里可被 vitest 直接覆盖，避免只能靠肉眼在弹窗里验。
+ *
+ * 作者 ddj 2026年10月30号
+ */
+import { normalizePath } from './quickMenu.js'
+
+/** 工作区限定态：全部 / 仅当前工作区 / 自定义集合。 */
+export type WorkspacePickMode = 'all' | 'current' | 'some'
+
+/** 工作区下拉触发器的摘要。 */
+export interface WorkspacePickSummary {
+  mode: WorkspacePickMode
+  /** 触发器文案。 */
+  label: string
+  /** 归一化前的原始路径列表（空数组表示全部）。 */
+  paths: string[]
+}
+
+/**
+ * 推导工作区下拉的摘要（null / 空数组都算「全部工作区」）。
+ * @author ddj 2026年10月30号
+ * @param paths 已选路径列表（null = 全部工作区）
+ * @param cwd 当前工作区（缺失时无法判定「当前工作区」态）
+ * @returns 摘要（mode + 文案 + 原始路径）
+ */
+export function workspaceLabel(paths: string[] | null, cwd?: string): WorkspacePickSummary {
+  const list = (paths ?? []).slice()
+  if (list.length === 0) return { mode: 'all', label: '全部工作区', paths: [] }
+  if (list.length === 1 && cwd !== undefined && normalizePath(cwd) !== '' && normalizePath(list[0]) === normalizePath(cwd)) {
+    return { mode: 'current', label: '当前工作区', paths: list }
+  }
+  return { mode: 'some', label: '已选 ' + list.length + ' 个工作区', paths: list }
+}
+
+/**
+ * 多选摘要文案（0 项、1~2 项全写、更多折叠成「A、B 等 N 项」）。
+ * @author ddj 2026年10月30号
+ * @param labels 已选项文案
+ * @param unit 折叠时的单位（如「项技能」「条规则」）
+ * @returns 触发器文案
+ */
+export function selectionLabel(labels: string[], unit: string): string {
+  if (labels.length === 0) return '未绑定'
+  if (labels.length <= 2) return labels.join('、')
+  return labels.slice(0, 2).join('、') + ' 等 ' + labels.length + ' ' + unit
+}
+
+/**
+ * 工作区集合切换（归一化比较去重；清空即回到「全部工作区」的 null 语义）。
+ * @author ddj 2026年10月30号
+ * @param paths 当前列表（null = 全部）
+ * @param target 目标工作区路径
+ * @returns 新列表；空集合返回 null
+ */
+export function toggleWorkspace(paths: string[] | null, target: string): string[] | null {
+  const list = (paths ?? []).slice()
+  const key = normalizePath(target)
+  const index = list.findIndex((path) => normalizePath(path) === key)
+  if (index >= 0) list.splice(index, 1)
+  else list.push(target)
+  return list.length === 0 ? null : list
+}

package/src/shared/rpc.ts

@@ -16,7 +16,9 @@ import type { McpSessionStatus, MpcConfig, MpcProject, MpcProjectSaveInput, MpcS
 import type { CompatReport, DevFormInfo } from './compat.js'
 import type { ShellIntegrationStatus, UnityListPayload, UnityProjectEntry } from './integration.js'
 import type { RuleInfo, RuleProject, RuleRefInput, RuleSaveInput } from './rules.js'
+import type { SkillCatalog } from './skillCatalog.js'
 import type { SnippetEntry, SnippetInfo, SnippetProject, SnippetRefInput, SnippetSaveInput } from './snippets.js'
+import type { QuickMenuDoc } from './quickMenu.js'
 import type { LspCompletionItem, LspCompletionList, LspEnvInstallState, LspExtInfo, LspExtUpdate, LspHover, LspLocation, LspMarketItem, LspPosition, LspSemanticTokens, LspServerStatus, LspSignatureHelp, LspSymbol } from './lsp.js'
 import type { AiConfigPatch, AiConfigView, AiDirectoryView, AiInlineRequest, AiInlineResult } from './ai.js'
 import type { SvnAction, SvnAiPlan, SvnChangeEntry, SvnConflictArtifact, SvnDiffRevResult, SvnIgnoreItem, SvnLogEntry, SvnRemoteOutdatedEntry, SvnStatusPayload, SvnSumEntry, SvnUpdatePoll, SvnUpdateResult, SvnUpdateState } from './svn.js'
@@ -491,11 +493,15 @@ export interface RpcRequestMap {
   'rules.save': RuleSaveInput
   'rules.remove': RuleRefInput
   'rules.toggle': RuleRefInput & { enabled: boolean }
+  'skills.list': { cwd?: string }
   'snippets.list': {}
   'snippets.read': SnippetRefInput
   'snippets.save': SnippetSaveInput
   'snippets.remove': SnippetRefInput
   'snippets.entries': { sessionId?: string }
+  'quickMenu.get': {}
+  'quickMenu.save': { doc: QuickMenuDoc; baseRevision: number }
+  'quickMenu.launcher': { x: number | null; y: number | null }
   'svn.status': { sessionId?: string; force?: boolean }
   'svn.changes': { sessionId?: string; force?: boolean }
   'svn.explorerStatus': { sessionId?: string; force?: boolean }
@@ -672,11 +678,15 @@ export interface RpcOkMap {
   'rules.save': { rule: RuleInfo }
   'rules.remove': object
   'rules.toggle': { rule: RuleInfo }
+  'skills.list': SkillCatalog
   'snippets.list': { user: SnippetInfo[]; projects: SnippetProject[] }
   'snippets.read': { content: string }
   'snippets.save': { file: SnippetInfo }
   'snippets.remove': object
   'snippets.entries': { entries: SnippetEntry[] }
+  'quickMenu.get': { doc: QuickMenuDoc; warning?: string }
+  'quickMenu.save': { doc: QuickMenuDoc }
+  'quickMenu.launcher': { doc: QuickMenuDoc }
   'svn.status': SvnStatusPayload
   'svn.changes': { wcRoot: string; entries: SvnChangeEntry[]; truncated: boolean }
   'svn.explorerStatus': { entries: SvnChangeEntry[]; truncated: boolean; prefix: string }

package/src/shared/skillCatalog.ts

@@ -0,0 +1,60 @@
+/**
+ * dsh-vscode-mode 快捷菜单共享契约 — 技能候选（全局技能 + 当前工作区技能）。
+ *
+ * 纯类型模块：禁 node/react 导入（与 shared/rules.ts、shared/quickMenu.ts 同约束）。
+ * 为什么需要它：快捷菜单的「绑定技能」下拉要按来源分组展示候选，而会话可见技能名
+ * （remote.skills）只给名字、不给来源，且无活跃会话时不可用；这里定义 host 扫描
+ * 磁盘技能目录后的只读快照，供 UI 分组与摘要使用。
+ *
+ * 作者 ddj 2026年10月30号
+ */
+
+/** 技能来源：用户全局技能（DSH_HOME/skills）或当前工作区技能（<projectRoot>/.dsh/skills）。 */
+export type SkillSource = 'user' | 'project'
+
+/** 一条可绑定技能的元信息（下拉选项展示所需的最小集）。 */
+export interface SkillInfo {
+  /** kebab-case 技能名（与提示词里 /技能名 token 一致）。 */
+  name: string
+  /** frontmatter description（必填字段的最小摘要，缺失时为空串）。 */
+  description: string
+  /** SKILL.md 或 <名>.md 的绝对路径（排障与 title 提示用）。 */
+  path: string
+  source: SkillSource
+}
+
+/** 技能候选快照（skills.list 的返回，只读、不落缓存、不写盘）。 */
+export interface SkillCatalog {
+  user: SkillInfo[]
+  /** 未识别到工作区根或工作区无技能目录时为空数组（非错误）。 */
+  project: SkillInfo[]
+  /** 解析出的工作区根目录（向上找到的含 .git 祖先）；缺失表示按 cwd 兜底。 */
+  projectRoot?: string
+}
+
+/** 下拉面板的来源分组（按 key 顺序渲染）。 */
+export interface SkillGroup {
+  key: SkillSource
+  label: string
+  skills: SkillInfo[]
+}
+
+/** 来源分组标题文案。 */
+export const SKILL_SOURCE_LABEL: Record<SkillSource, string> = {
+  user: '全局技能',
+  project: '当前工作区技能',
+}
+
+/**
+ * 按来源分组（空组不出现；面板全空时由 UI 统一渲染空态）。
+ * @author ddj 2026年10月30号
+ * @param input 技能候选快照
+ * @returns 非空分组（全局在前、工作区在后）
+ */
+export function groupSkills(input: SkillCatalog | null | undefined): SkillGroup[] {
+  if (!input) return []
+  const groups: SkillGroup[] = []
+  if (input.user.length > 0) groups.push({ key: 'user', label: SKILL_SOURCE_LABEL.user, skills: input.user })
+  if (input.project.length > 0) groups.push({ key: 'project', label: SKILL_SOURCE_LABEL.project, skills: input.project })
+  return groups
+}

package/src/skillCatalog.ts

@@ -0,0 +1,138 @@
+/**
+ * dsh-vscode-mode host — 技能候选枚举（全局技能 + 当前工作区技能）。
+ *
+ * 为什么要另起一条通道：本插件原有的 `skills.ts` 只管「随包分发的技能组」
+ * （<包根>/skills，按 SKILL_PREFIXES 前缀白名单过滤）；而快捷菜单「绑定技能」需要的是
+ * 用户能自由增删的两类技能目录，与 DSH 文件系统 skill provider 的两个根一致：
+ * - 全局技能：`$DSH_HOME/skills`（provider rank 400 / user-dsh）
+ * - 工作区技能：`<projectRoot>/.dsh/skills`（provider rank 100 / project-dsh）
+ * 只读、不写盘、不缓存：每次打开配置弹窗重扫一遍（目录数量级很小）。
+ *
+ * 作者 ddj 2026年10月30号
+ */
+import { statSync } from 'node:fs'
+import { readdir, readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+import { dshHome } from './paths.js'
+import { isParsedSkill, parseSkillMd } from './skills.js'
+import type { SkillCatalog, SkillInfo, SkillSource } from './shared/skillCatalog.js'
+
+/** 单个根目录最多枚举的技能数（防失控目录拖垮弹窗）。 */
+const SKILL_CATALOG_CAP = 200
+/** 向上找项目根的层数上限（防异常路径下的长链遍历）。 */
+const ROOT_DEPTH_CAP = 8
+/** 目录式技能的清单文件名。 */
+const SKILL_FILE = 'SKILL.md'
+
+/** 技能根目录集合（绝对路径）。 */
+export interface SkillRoots {
+  /** 全局技能根：<DSH_HOME>/skills。 */
+  user: string
+  /** 工作区技能根：<projectRoot>/.dsh/skills。 */
+  project: string
+  /** 解析出的工作区根（含 .git 的最近祖先；找不到时回落 cwd）。 */
+  projectRoot?: string
+}
+
+/**
+ * 从 cwd 向上找项目根（含 .git 的最近祖先；找不到回落 cwd）。
+ * @author ddj 2026年10月30号
+ * @param cwd 起始目录
+ * @returns 项目根绝对路径；cwd 缺失时 undefined
+ */
+export function projectRootOf(cwd?: string): string | undefined {
+  if (cwd === undefined || cwd === '') return undefined
+  let current = cwd
+  for (let depth = 0; depth < ROOT_DEPTH_CAP; depth += 1) {
+    const parent = join(current, '..')
+    // 用目录列举探测 .git：目录式与 worktree 的文件式 .git 都算命中
+    const entry = join(current, '.git')
+    if (entryExists(entry)) return current
+    if (parent === current) break
+    current = parent
+  }
+  return cwd
+}
+
+/**
+ * 探测路径是否存在（同步存在性判断，避免为一次 up-walk 引入异步瀑布）。
+ * @author ddj 2026年10月30号
+ * @param path 绝对路径
+ * @returns 存在为 true
+ */
+function entryExists(path: string): boolean {
+  try {
+    // 只做存在性探测：statSync 对文件/目录/符号链接（跟随）都成立
+    statSync(path)
+    return true
+  } catch {
+    return false
+  }
+}
+
+/**
+ * 技能根目录（全局 + 当前工作区）。
+ * @author ddj 2026年10月30号
+ * @param cwd 当前工作区
+ * @returns 两个根的绝对路径
+ */
+export function skillRootsOf(cwd?: string): SkillRoots {
+  const projectRoot = projectRootOf(cwd)
+  const project = projectRoot === undefined ? '' : join(projectRoot, '.dsh', 'skills')
+  return { user: join(dshHome(), 'skills'), project, projectRoot }
+}
+
+/**
+ * 扫描单个技能根（深度 1：<root>/<名>/SKILL.md 或 <root>/<名>.md）。
+ * 目录缺失/读失败/frontmatter 非法 → 跳过该条（不抛、不返回半成品）。
+ * @author ddj 2026年10月30号
+ * @param dir 技能根目录
+ * @param source 来源标记
+ * @returns 通过校验的技能（按名字排序，受 SKILL_CATALOG_CAP 约束）
+ */
+async function listRootSkills(dir: string, source: SkillSource): Promise<SkillInfo[]> {
+  if (dir === '') return []
+  const entries = await readdir(dir, { withFileTypes: true }).catch(() => [])
+  const ordered = [...entries].sort((left, right) => left.name.localeCompare(right.name)).slice(0, SKILL_CATALOG_CAP)
+  const found: SkillInfo[] = []
+  const seen = new Set<string>()
+  for (const entry of ordered) {
+    // 扁平式（<名>.md，含符号链接）优先按后缀判定，其余一律当目录式技能
+    const file = entry.name.endsWith('.md') ? join(dir, entry.name) : join(dir, entry.name, SKILL_FILE)
+    const info = await readSkillInfo(file, source).catch(() => undefined)
+    if (info === undefined || seen.has(info.name)) continue
+    seen.add(info.name)
+    found.push(info)
+  }
+  return found.sort((left, right) => left.name.localeCompare(right.name))
+}
+
+/**
+ * 读取并解析单个技能文件。
+ * @author ddj 2026年10月30号
+ * @param file 技能文件绝对路径
+ * @param source 来源标记
+ * @returns 技能元信息；文件缺失/不可读/frontmatter 非法时 undefined
+ */
+async function readSkillInfo(file: string, source: SkillSource): Promise<SkillInfo | undefined> {
+  const text = await readFile(file, 'utf8').catch(() => undefined)
+  if (text === undefined) return undefined
+  const parsed = parseSkillMd(text)
+  if (!isParsedSkill(parsed)) return undefined
+  return { name: parsed.name, description: parsed.description, path: file, source }
+}
+
+/**
+ * 枚举技能候选（全局 + 当前工作区；只读，永不抛）。
+ * @author ddj 2026年10月30号
+ * @param cwd 当前工作区（缺失时只枚举全局根）
+ * @returns 技能候选快照
+ */
+export async function listSkillCatalog(cwd?: string): Promise<SkillCatalog> {
+  const roots = skillRootsOf(cwd)
+  const user = await listRootSkills(roots.user, 'user')
+  const project = await listRootSkills(roots.project, 'project')
+  return roots.projectRoot === undefined
+    ? { user, project }
+    : { user, project, projectRoot: roots.projectRoot }
+}