@yolk_vat-y/dsh-project-memory 0.5.7 → 0.5.9

package/src/client/TaskPanel.tsx

@@ -4,18 +4,20 @@
  * Presentational 组件在 TaskComponents.tsx
  */
 import { Component, useEffect, useRef, useState, type ReactNode } from 'react'
+import { Button } from '@deepseek-ai/dsh-client-ui-primitives'
+// 图标走兼容层：0.1.5 用 IconXxx14/16，0.1.7+ 改成 IconXxxRegular + size prop
 import {
-  Button,
   IconChevronDownOutline14,
   IconCloseOutline16,
   IconFolderOpenOutline16,
   IconQuestionOutline14,
-} from '@deepseek-ai/dsh-client-ui-primitives'
+} from './icons.ts'
 import { createTranslate, zh, en } from './locales.ts'
 import { useTaskData, useTaskDataActions, taskDataStore, parseTaskPayloadText, type TaskStep } from './task-data-store.ts'
 import { useTaskUI, useTaskUIActions } from './task-ui-store.ts'
 import { MiniBar, TaskCard } from './TaskComponents.tsx'
 import { MemoryView, type InsightScope } from './MemoryView.tsx'
+import { pickSessionId } from './session-id.js'
 import css from './TaskPanel.module.css'
 
 const NS = 'dsh-project-memory'
@@ -36,11 +38,9 @@ function useSessionId(ctx: any): string | null {
     if (!list || typeof list.subscribe !== 'function') return
     return list.subscribe(() => force((n) => n + 1))
   }, [ctx])
-  const snap = ctx?.sessions?.list?.getSnapshot?.()
-  if (!snap) return null
-  if (snap.current) return snap.current
-  const first = Array.isArray(snap.items) ? snap.items.find((s: any) => !s.blank) ?? snap.items[0] : undefined
-  return first?.sessionId ?? null
+  // 快照结构在 dsh 0.1.7 变过（current/items → ids/byId）：解析与兼容都在 session-id.js，
+  // 那里有单测；这里只负责订阅与取值。
+  return pickSessionId(ctx?.sessions?.list?.getSnapshot?.())
 }
 
 class PanelErrorBoundary extends Component<{ children: ReactNode }, { failed: boolean }> {
@@ -113,7 +113,7 @@ function TaskPanelView({ ctx }: { ctx: any }) {
     try {
       response = await commands.execute(sessionId, line, [])
     } catch (err) {
-      setSyncError(String(err?.message ?? err))
+      setSyncError(String((err as { message?: unknown } | null | undefined)?.message ?? err))
       return false
     }
     const envelope = response as { ok?: boolean; value?: any } | null | undefined
@@ -134,7 +134,7 @@ function TaskPanelView({ ctx }: { ctx: any }) {
       await runLine('/tasks')
       const newBoundId = taskDataStore.getSnapshot().boundTaskId
       if (newBoundId && newBoundId !== prevBoundId) {
-        await runLine(`/task switch ${newBoundId}`)
+        await runLine(`/tasks switch ${newBoundId}`)
       }
     } finally {
       setSyncing(false)
@@ -145,7 +145,7 @@ function TaskPanelView({ ctx }: { ctx: any }) {
     if (syncing) return
     setSyncing(true)
     try {
-      await runLine(`/task ${verb} ${taskId}`)
+      await runLine(`/tasks ${verb} ${taskId}`)
     } finally {
       setSyncing(false)
     }
@@ -156,7 +156,7 @@ function TaskPanelView({ ctx }: { ctx: any }) {
     if (syncing) return
     setSyncing(true)
     try {
-      await runLine(`/insight ${action} task ${id}`)
+      await runLine(`/tasks insight ${action} task ${id}`)
       await refresh()
     } finally {
       setSyncing(false)
@@ -164,7 +164,7 @@ function TaskPanelView({ ctx }: { ctx: any }) {
   }
 
   const pushSteps = (taskId: string, steps: TaskStep[]): void => {
-    void runLine(`/task todos ${JSON.stringify(steps.map((s) => ({ content: s.content, status: s.status })))}`)
+    void runLine(`/tasks todos ${JSON.stringify(steps.map((s) => ({ content: s.content, status: s.status })))}`)
   }
 
   const cycleStatus = (taskId: string, index: number) => {
@@ -206,7 +206,7 @@ function TaskPanelView({ ctx }: { ctx: any }) {
     if (!task) return
     const same = task.title === trimmed
     if (same || !trimmed) return
-    void runLine(`/task rename ${taskId} ${JSON.stringify(trimmed)}`)
+    void runLine(`/tasks rename ${taskId} ${JSON.stringify(trimmed)}`)
   }
 
   const expand = () => {
@@ -421,7 +421,7 @@ function TaskPanelView({ ctx }: { ctx: any }) {
                 expanded={expanded}
                 onToggleExpand={() => uiActions.toggleTaskExpanded(task.id)}
                 onSwitch={() => handleAction('switch', task.id)}
-                onUnbind={() => runLine('/task unbind')}
+                onUnbind={() => runLine('/tasks unbind')}
                 onArchive={() => handleAction('archive', task.id)}
                 onRename={(value) => commitTitle(task.id, value)}
                 onEditStep={(index, value) => commitStepText(task.id, index, value)}

package/src/client/client.ts

@@ -10,10 +10,14 @@
  *
  * 只依赖宿主 seed 提供的模块（react / dsh-client-ui-primitives），
  * 数据经 remote.commands.execute 执行 /tasks 命令获取 JSON 快照。
+ *
+ * 另有一个可选增强：自建的 `/` 菜单源（slash.ts），把三条命令收进一个带图标和
+ * 小节标题的「工作流」组。它**整体是可选的**——宿主没有 slash 触发器服务时静默跳过。
  */
 import { createElement } from 'react'
 import { TaskPanelEntry } from './TaskPanel.tsx'
 import { TaskCommandNode } from './TaskCommandNode.tsx'
+import { createSlashSource } from './slash.ts'
 
 const NS = 'dsh-project-memory'
 
@@ -22,32 +26,100 @@ export const name = NS
 /** Required client services: slots registry, session scopes, commands remote (data 通道). */
 export const inject = ['slots', 'sessions', 'remote', 'remote.commands', 'locale']
 
+/**
+ * 执行一条命令行，映射成 composer 的 SubmitOutcome。
+ * 与 TaskPanel 走同一个 remote.commands.execute 通道（同样的返回信封）。
+ * @param commands - ctx.remote.commands
+ * @param session - 会话投影（只读 sessionId）
+ * @param line - 完整命令行（含前导斜杠）
+ * @param attachments - 提交附件（菜单路径恒为空）
+ * @returns {kind:'success'|'error', text?}
+ */
+async function runCommand(
+  commands: any,
+  session: any,
+  line: string,
+  attachments: readonly unknown[] = [],
+): Promise<{ kind: 'success' | 'error'; text?: string }> {
+  const sessionId = session?.sessionId
+  if (typeof sessionId !== 'string' || !commands || typeof commands.execute !== 'function') {
+    return { kind: 'error', text: `no session / commands service for ${line}` }
+  }
+  const response: any = await commands.execute(sessionId, line, [...attachments])
+  const envelope = response as { ok?: boolean; error?: any; value?: any } | null | undefined
+  if (envelope && typeof envelope === 'object' && envelope.ok === false) {
+    return { kind: 'error', text: `command.execute failed: ${envelope.error?.code ?? 'unknown'}` }
+  }
+  const execution = envelope && typeof envelope === 'object' && 'value' in envelope ? envelope.value : envelope
+  const result = execution?.result ?? execution
+  if (result?.kind === 'error') return { kind: 'error', text: result.text ?? `${line} failed` }
+  return { kind: 'success' }
+}
+
+/**
+ * 注册自建的 `/` 菜单源（见 slash.ts）。
+ *
+ * 整段都是**可选增强**：宿主没有 `inputTriggers` 服务、或该服务换了契约时，绝不能因此
+ * 让整个 client 插件挂掉——那会连任务面板一起消失。`inputTriggers` 因此不进顶层 `inject`
+ * （顶层 inject 未满足时 cordis 根本不会调用 apply），而是走嵌套 inject + 两层 try/catch。
+ * @param ctx - client 根上下文
+ */
+function registerSlashSource(ctx: any): void {
+  if (typeof ctx?.inject !== 'function') {
+    console.warn(`[${NS}] host has no ctx.inject — slash menu group disabled`)
+    return
+  }
+  try {
+    ctx.inject(['inputTriggers', 'sessions', 'remote.commands'], (scope: any) => {
+      try {
+        const inputTriggers = scope?.inputTriggers
+        if (!inputTriggers || typeof inputTriggers.registerSource !== 'function') {
+          console.warn(`[${NS}] host has no inputTriggers.registerSource — slash menu group disabled`)
+          return
+        }
+        const source = createSlashSource(scope, {
+          sessions: scope.sessions,
+          run: (session, line, attachments) => runCommand(scope?.remote?.commands, session, line, attachments),
+        })
+        scope.effect(() => inputTriggers.registerSource(source), 'dsh-project-memory: slash source')
+      } catch (err) {
+        console.warn(`[${NS}] slash source registration failed:`, err)
+      }
+    })
+  } catch (err) {
+    console.warn(`[${NS}] slash source injection failed:`, err)
+  }
+}
+
 export function apply(ctx: any): void {
   const slots = ctx?.slots
   if (!slots || typeof slots.inject !== 'function') {
     console.warn(`[${NS}] host has no slots service — task panel disabled`)
-    return
-  }
-  try {
-    slots.inject('shell.overlay', () => slots.register(
-      {
-        name: 'shell.overlay',
-        id: 'dsh-project-memory-task-panel',
-        order: 100, // 浮层顺序：低于 toast/弹窗即可，越高越靠后渲染
-      },
-      () => createElement(TaskPanelEntry, { ctx })
-    ))
-
-    // 会话内 /tasks、/task、/insight 命令节点：按命令名 key 接管渲染，
-    // 替换内置大段文本卡片（文本含 JSON 载荷，只有面板需要它），避免载荷刷屏对话。
-    const nodeKeys = ['tasks', 'task', 'insight']
-    for (const key of nodeKeys) {
-      slots.inject('conversation.chat.commandview', () => slots.register(
-        { name: 'conversation.chat.commandview', key },
-        TaskCommandNode
+  } else {
+    try {
+      slots.inject('shell.overlay', () => slots.register(
+        {
+          name: 'shell.overlay',
+          id: 'dsh-project-memory-task-panel',
+          order: 100, // 浮层顺序：低于 toast/弹窗即可，越高越靠后渲染
+        },
+        () => createElement(TaskPanelEntry, { ctx })
       ))
+
+      // 会话内命令节点：按命令名 key 接管渲染，替换内置大段文本卡片
+      // （文本含 JSON 载荷，只有面板需要它），避免载荷刷屏对话。
+      // 合并后只剩一条用户命令 /tasks（子动词都记在同一个命令名下）。
+      const nodeKeys = ['tasks']
+      for (const key of nodeKeys) {
+        slots.inject('conversation.chat.commandview', () => slots.register(
+          { name: 'conversation.chat.commandview', key },
+          TaskCommandNode
+        ))
+      }
+    } catch (err) {
+      console.warn(`[${NS}] task panel registration failed:`, err)
     }
-  } catch (err) {
-    console.warn(`[${NS}] task panel registration failed:`, err)
   }
+
+  registerSlashSource(ctx)
 }

package/src/client/css-modules.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CSS Modules 的类型声明（仅服务 tsc 类型检查）。
+ *
+ * 客户端样式由 tsdown 的 `dsh-css-modules-inline` 插件在构建期内联：
+ * `.module.css` 被编译成 `{ <local>: '<hash>_<local>', ... }` 映射，
+ * 因此运行时拿到的是一个「类名 → 混淆后类名」的普通对象。
+ * 这里给 tsc 一个等价形状，避免 `import css from './x.module.css'` 报 TS2307。
+ */
+declare module '*.module.css' {
+  const classes: Readonly<Record<string, string>>
+  export default classes
+}

package/src/client/icons.ts

@@ -0,0 +1,63 @@
+/**
+ * 宿主图标兼容层（dsh 0.1.5 ↔ 0.1.7+）。
+ *
+ * 命名契约变过一次：
+ *   - dsh 0.1.5（含 0.1.5-rc.x）：尺寸写进名字，如 `IconFolderOpenOutline16`；
+ *   - dsh 0.1.7+：去掉尺寸后缀、改为字重后缀，如 `IconFolderOpenOutlineRegular` /
+ *     `IconFolderOpenOutlineMedium`，尺寸改由 `size` prop 传入。
+ * ui-primitives 是 web shell 的冻结 seed 模块（不是插件行），插件无法固定它，
+ * 同一份产物会拿到宿主那一版的导出；直接按某一版的名字解构会在另一版上得到
+ * `undefined`，React 渲染时抛 "Element type is invalid" 把面板整个打崩。
+ *
+ * 因此这里按旧名导出同名组件，运行时在两个名字里取存在的那个，并把旧名里的
+ * 尺寸作为默认 `size`（两版的图标都接受 `size` prop，0.1.5 的默认值正是旧名后缀）。
+ * 两版都没有该名字时降级为空组件并告警，而不是让面板崩溃。
+ */
+import { createElement, type ComponentType } from 'react'
+import * as primitives from '@deepseek-ai/dsh-client-ui-primitives'
+
+type IconProps = { size?: number; className?: string }
+type IconComponent = ComponentType<IconProps>
+
+const table = primitives as unknown as Record<string, unknown>
+
+function resolveIcon(names: readonly string[]): IconComponent | null {
+  for (const name of names) {
+    const candidate = table[name]
+    if (typeof candidate === 'function' || (typeof candidate === 'object' && candidate !== null)) {
+      return candidate as IconComponent
+    }
+  }
+  return null
+}
+
+function icon(legacyName: string, currentName: string, defaultSize: number): IconComponent {
+  const impl = resolveIcon([legacyName, currentName])
+  if (impl === null) {
+    console.warn(
+      `[dsh-project-memory] host ui-primitives exports neither ${legacyName} nor ${currentName}; that icon renders nothing`,
+    )
+    return function MissingIcon() {
+      return null
+    }
+  }
+  function CompatIcon({ size = defaultSize, ...rest }: IconProps) {
+    return createElement(impl as IconComponent, { size, ...rest })
+  }
+  CompatIcon.displayName = legacyName
+  return CompatIcon
+}
+
+export const IconChevronDownOutline14 = icon('IconChevronDownOutline14', 'IconChevronDownOutlineRegular', 14)
+export const IconChevronUpOutline14 = icon('IconChevronUpOutline14', 'IconChevronUpOutlineRegular', 14)
+export const IconQuestionOutline14 = icon('IconQuestionOutline14', 'IconQuestionOutlineRegular', 14)
+export const IconCloseOutline16 = icon('IconCloseOutline16', 'IconCloseOutlineRegular', 16)
+export const IconFolderOpenOutline16 = icon('IconFolderOpenOutline16', 'IconFolderOpenOutlineRegular', 16)
+export const IconCheckOutline16 = icon('IconCheckOutline16', 'IconCheckOutlineRegular', 16)
+export const IconPlayOutline16 = icon('IconPlayOutline16', 'IconPlayOutlineRegular', 16)
+
+// `/` 菜单行图标。旧名的尺寸后缀两版并不一致（有的是 14 有的是 16），
+// 所以这里的默认 size 只影响"宿主两版都没有该名字"的降级路径——正常路径由宿主自己决定。
+export const IconChecklistOutline16 = icon('IconChecklistOutline14', 'IconChecklistOutlineRegular', 14)
+export const IconLightOutline16 = icon('IconLightOutline16', 'IconLightOutlineRegular', 16)
+export const IconGlobeOutline16 = icon('IconGlobeOutline14', 'IconGlobeOutlineRegular', 14)

package/src/client/locales.ts

@@ -74,6 +74,13 @@ export const zh = {
   'mem.saved': '已保存',
   'mem.edit': '编辑',
   'mem.section-label': '任务记忆',
+  // `/` 菜单：自建 slash 源的行文案。分组标题走候选的 section（见 slash.ts），
+  // 不走 slash.menu 词典——那个 namespace 由宿主的 ui-input-trigger 独占，重复注册会抛错。
+  // 三个行标题直接复用上面面板的 view.* 文案，保证菜单与面板叫同一个名字。
+  'slash.group': '工作流',
+  'slash.tasks-desc': '任务清单：步骤进度、涉及文件、当前会话绑定',
+  'slash.project-desc': '项目记忆：本项目的教训 / 决策 / 流程',
+  'slash.global-desc': '全局记忆：跨项目的经验条目',
 }
 
 export const en = {
@@ -149,6 +156,10 @@ export const en = {
   'mem.saved': 'Saved',
   'mem.edit': 'Edit',
   'mem.section-label': 'Task memory',
+  'slash.group': 'Workflow',
+  'slash.tasks-desc': 'Task list: progress, involved files, current session binding',
+  'slash.project-desc': 'Project memory: this project’s lessons / decisions / procedures',
+  'slash.global-desc': 'Global memory: experience entries shared across projects',
 }
 
 export type LocaleDict = typeof zh

package/src/client/session-id.js

@@ -0,0 +1,88 @@
+/**
+ * 会话列表快照 → 当前会话 id（宿主版本兼容层）。
+ *
+ * 快照结构被宿主改过一次，旧写法只认第一种：
+ *   - dsh ≤0.1.6：`{ current?: id, items: [{ sessionId, blank }] }`
+ *   - dsh 0.1.7+：`{ ids: id[], byId: Record<id, SessionSummary>, phase, projectionsBySession }`
+ *     —— `current` 与 `items` **都不存在了**。
+ *
+ * 后果一（永远 null）：0.1.7 上 `snap.current` 和 `snap.items` 都是 undefined → 旧代码永远
+ * 返回 null → 面板显示「还没有会话」、记忆视图报 `同步失败: no session / commands service`。
+ * 而**任务视图渲染的是 task-data-store 里的缓存快照**，看起来还正常，所以这个故障很容易被
+ * 误读成"数据格式/旧版本兼容"问题。
+ *
+ * 后果二（不跟随切换）：光"取一个非 null 的 id"不够 —— 兜底取的是宿主列表里第一个非 blank 的
+ * 会话，它**不随用户切换对话而变化**，面板会一直停在同一个会话（从而显示错项目的任务）。
+ * 0.1.7 判断"当前会话"的正式依据是 `SessionSummary.retainedBy.mainView > 0`：
+ * 主视图正在 retain 的那个就是用户正在看的那个（第一方同款判据，见 ui-layout/DocumentTitle.tsx
+ * 与 ui-session）。它就在**列表快照的 byId 行上**，而 retain 计数变化会 `list.set(...)` 重新发布
+ * 快照（session-controller/.../sessions/service.ts 的 publishRetention），所以订阅
+ * `ctx.sessions.list` 的组件会在切换会话时自动重渲染 —— 这条必须走快照内字段，不能另开
+ * `retainInfo()` 订阅，否则切换不会触发重渲染。
+ *
+ * 实测形状见 `packages/api/session-controller/src/client/sessions/service.ts` 的
+ * `SessionListState` / `SessionSummary`。
+ */
+
+/** 正数才算持有（retain 计数缺失/0/负数一律当没有）。 */
+function heldCount(value) {
+  return typeof value === 'number' && value > 0 ? value : 0
+}
+
+/** 从一行 summary 抽出本模块关心的三个事实。 */
+function rowFacts(row) {
+  return {
+    blank: row?.blank === true,
+    /** 主视图对这条会话的 retain 计数；> 0 即"用户正在看它"。 */
+    mainView: heldCount(row?.retainedBy?.mainView),
+  }
+}
+
+/**
+ * 把两种快照形状统一成 `{ id, blank, mainView }` 列表，顺序保持宿主给的顺序。
+ * @param {object|undefined|null} snap - `ctx.sessions.list.getSnapshot()`
+ * @returns {Array<{id: string, blank: boolean, mainView: number}>} 认不出的形状返回空数组
+ */
+export function sessionRows(snap) {
+  if (!snap || typeof snap !== 'object') return []
+  // 旧形状：items 里每行自带 sessionId / blank / retainedBy
+  if (Array.isArray(snap.items)) {
+    return snap.items
+      .map((row) => ({ id: row?.sessionId, ...rowFacts(row) }))
+      .filter((row) => typeof row.id === 'string' && row.id !== '')
+  }
+  const byId = snap.byId && typeof snap.byId === 'object' ? snap.byId : null
+  // 0.1.7 形状：ids 表达宿主列表成员（顺序权威），行数据在 byId 里
+  if (Array.isArray(snap.ids)) {
+    return snap.ids
+      .map((id) => ({ id, ...rowFacts(byId?.[id]) }))
+      .filter((row) => typeof row.id === 'string' && row.id !== '')
+  }
+  // 只有 byId 的半成品形状：仍然可用，只是丢了宿主顺序
+  if (byId) {
+    return Object.keys(byId)
+      .map((id) => ({ id, ...rowFacts(byId[id]) }))
+      .filter((row) => typeof row.id === 'string' && row.id !== '')
+  }
+  return []
+}
+
+/**
+ * 选出一个可用于执行命令的会话 id（即"用户正在看的那个"）。
+ *
+ * 优先级：
+ *  1. 旧形状的显式 `current`（≤0.1.6 的权威字段，保持原语义）；
+ *  2. `retainedBy.mainView > 0` 的会话（0.1.7 的权威判据，**跟随会话切换**）；
+ *  3. 第一个非 blank → 第一个（对两种形状都适用的兜底）。
+ * @param {object|undefined|null} snap - `ctx.sessions.list.getSnapshot()`
+ * @returns {string|null} 会话 id；拿不到返回 null（调用方据此显示「还没有会话」）
+ */
+export function pickSessionId(snap) {
+  if (!snap || typeof snap !== 'object') return null
+  if (typeof snap.current === 'string' && snap.current !== '') return snap.current
+  const rows = sessionRows(snap)
+  const live = rows.find((row) => row.mainView > 0)
+  if (live) return live.id
+  const chosen = rows.find((row) => !row.blank) ?? rows[0]
+  return chosen ? chosen.id : null
+}

package/src/client/slash.ts

@@ -0,0 +1,184 @@
+/**
+ * 自建 `/` 触发器源：把工作流的三个视图入口收进一个带图标和小节标题的「工作流」组。
+ *
+ * 为什么必须自建源：`/` 菜单里的「分组」就是触发器源（ui-input-trigger 的 roster），
+ * 而宿主 ui-commands 给目录行装配外观时只认第一方 definitionId 白名单
+ * （presentation.ts 的 HOST_FACES / SECTION_ROWS），且宿主 CommandDescriptor 只有
+ * name/description/input —— 没有 icon、没有分组、没有隐藏开关。第三方宿主命令因此
+ * 永远只是「指令」小节末尾一行纯文字。
+ *
+ * 两个宿主约束决定了这里的写法：
+ *  1. **分组标题走候选的 `section`，不走 `slash.menu` 词典。** 组标题查的是 `slash.menu`
+ *     namespace，而它由 ui-input-trigger 独占：`register('slash.menu','zh')` 会抛
+ *     "already has locale"，未知 key 则原样回显源名。MenuView 在「组内任一行带 section」时
+ *     干脆不渲染组标题行，只渲染 section 标题 —— 于是标题文案回到我们手里，还能按语言切换。
+ *  2. **只做增量，不抢宿主的分发。** 这里不实现 matchSpace / matchEnter，所以手敲 `/tasks`、
+ *     面板调 remote.commands.execute 全部走宿主原有路径。本源只是往菜单里多添一组行。
+ *
+ * 与「指令」组的重复：合并前插件注册了 /tasks、/task、/insight 三条宿主命令，菜单里就是三行
+ * 去不掉的原始行 —— 宿主命令只要注册就会出现在目录里，`commands.list()` 与
+ * `commands.execute()` 读同一个视图，`CommandDefinition` 也没有 hidden 字段，插件无法隐藏。
+ * 现在宿主只剩一条 /tasks（见 src/commands/workflow.js），重复降到一行；那一行也是插件
+ * 执行宿主侧工作的唯一通道（插件没有自己的 client→host RPC）。
+ */
+import type { ComponentType } from 'react'
+import { createTranslate, en, zh } from './locales.ts'
+import { IconChecklistOutline16, IconGlobeOutline16, IconLightOutline16 } from './icons.ts'
+
+/** 源的稳定标识：同一 trigger 内唯一，重复注册会抛错。 */
+export const SLASH_SOURCE_NAME = 'project-memory'
+
+/**
+ * 组的排序权重（越小越靠前，未设时默认 0）。
+ * 宿主内置源都取默认 0，所以 1 = 一定排在「指令 / 技能 / 子智能体」之后。
+ * 没有能同时满足「在宿主之后」与「在所有其他插件之前」的取值：其他插件若也留默认 0
+ * 就会排在我们前面。1 是最接近的折中，且不会去抢宿主主位置。
+ */
+export const SLASH_SOURCE_ORDER = 1
+
+/** 一行候选：候选 name 与标题同源（本地化文本），名称即身份、即标题。 */
+interface SlashRow {
+  /** 词典 key：既作候选 name（组内唯一身份）也作行标题。 */
+  readonly labelKey: string
+  /** 行描述词典 key。 */
+  readonly descriptionKey: string
+  /** 行图标；图标名按宿主版本自适应，见 icons.ts。 */
+  readonly icon: ComponentType<{ size?: number; className?: string }>
+  /** 额外搜索词：候选 name 是中文，拉丁输入（task / memory…）靠这些命中。 */
+  readonly match: readonly string[]
+  /** 点击后经 remote.commands.execute 执行的完整命令行。 */
+  readonly line: string
+}
+
+/** 菜单三行。顺序即渲染顺序；标题复用面板已有的 view.* 文案，保证与面板视图名一致。 */
+const ROWS: readonly SlashRow[] = [
+  {
+    labelKey: 'view.task',
+    descriptionKey: 'slash.tasks-desc',
+    icon: IconChecklistOutline16,
+    match: ['tasks', 'task'],
+    line: '/tasks',
+  },
+  {
+    labelKey: 'view.project',
+    descriptionKey: 'slash.project-desc',
+    icon: IconLightOutline16,
+    match: ['memory', 'project', 'insight'],
+    line: '/tasks insight list project',
+  },
+  {
+    labelKey: 'view.global',
+    descriptionKey: 'slash.global-desc',
+    icon: IconGlobeOutline16,
+    match: ['memory', 'global', 'insight'],
+    line: '/tasks insight list global',
+  },
+]
+
+/** 本插件的 client 上下文投影：只看得到这几个能力，避免把整个 cordis ctx 传进来。 */
+export interface SlashSourceDeps {
+  /** 会话服务（`sessions`）：把 sessionId 换回会话 scope，用于消费触发 token。 */
+  readonly sessions: any
+  /** 执行一条完整命令行；返回 composer 认得的 SubmitOutcome 形状。 */
+  run(session: any, line: string, attachments?: readonly unknown[]): Promise<{ kind: 'success' | 'error'; text?: string }>
+}
+
+/** 翻译函数签名（key 来自 ROWS，不是字面量，故不做类型约束）。 */
+type Translate = (key: string, params?: Record<string, string | number>) => string
+
+/** 按当前语言取翻译函数。 */
+function translator(ctx: any): Translate {
+  const dict = ctx?.locale?.getSnapshot?.()?.active === 'zh' ? zh : en
+  return createTranslate(dict) as unknown as Translate
+}
+
+/**
+ * 一轮候选：把三行装配成菜单行，再按查询与位置过滤。
+ *
+ * 三行都不接参数（动作全在面板卡片里），所以位置过滤只做一件事：行内出现的 `/` 多半是路径，
+ * 不弹这一整组（宿主对无 input 命令在前导/行内都放行，这里更保守）。
+ * @param t - 翻译函数。
+ * @param req - 宿主给的候选请求（query / position）。
+ * @returns 菜单行；永不抛出。
+ */
+export function buildSlashCandidates(t: Translate, req: any): readonly Record<string, unknown>[] {
+  if (req?.position !== undefined && req.position !== 'leading') return []
+  const query = typeof req?.query === 'string' ? req.query.trim().toLowerCase() : ''
+  const rows = ROWS.map((row) => {
+    const title = t(row.labelKey)
+    return {
+      name: title,
+      // label 与 name 相同 → MenuView 不渲染尾随别名（这些是视图入口，不是命令名）
+      label: title,
+      description: t(row.descriptionKey),
+      icon: row.icon,
+      // 每一行都带 section → MenuView 不渲染组标题行，只渲染这个标题。
+      section: t('slash.group'),
+      line: row.line,
+      terms: [title, ...row.match].map((term) => term.toLowerCase()),
+    }
+  })
+  return rows
+    .filter((row) => query === '' || row.terms.some((term) => term.startsWith(query)))
+    .map(({ terms: _terms, ...candidate }) => candidate)
+}
+
+/**
+ * 把触发 token 从草稿里删掉（span 做 CAS：草稿被改过就拒绝，什么都不动）。
+ * 这是宿主 command 源消费菜单点击的同一条契约事件。
+ * @returns true 表示确实消费掉了。
+ */
+function consumeSpan(deps: SlashSourceDeps, pick: any): boolean {
+  try {
+    const scope = deps.sessions?.scope?.(pick?.session?.sessionId)
+    if (!scope || typeof scope.bail !== 'function') return false
+    return scope.bail(scope, 'slash/input-consume-token', {
+      guard: { kind: 'span', span: pick.span },
+    }) === true
+  } catch (err) {
+    console.warn('[dsh-project-memory] slash token consume failed:', err)
+    return false
+  }
+}
+
+/**
+ * 一次菜单点击：消费掉触发 token 后立刻执行该行对应的命令行。
+ *
+ * 不返回 claim（回填 `/xxx ` 再等回车）：这三行都是「打开某个视图」，claim 会多要一次回车，
+ * 而且子动词（`insight list project`）也没法由一个 claim token 表达。消费失败时仍然执行，
+ * 只是草稿里残留的触发文本要用户自己清掉 —— 比回填一个会执行错命令的 claim 安全。
+ * @param t - 翻译函数（按当前语言把候选 name 映射回 ROWS）。
+ * @param deps - 会话服务与命令执行通道。
+ * @param pick - 宿主给的点击载荷。
+ * @returns PickOutcome；拿不到可用形状时返回 undefined（菜单照常关闭，草稿不动）。
+ */
+export function dispatchSlashPick(t: Translate, deps: SlashSourceDeps, pick: any): unknown {
+  const title = pick?.candidate?.name
+  if (typeof title !== 'string' || title === '') return undefined
+  const row = ROWS.find((candidate) => t(candidate.labelKey) === title)
+  if (row === undefined) return undefined
+  consumeSpan(deps, pick)
+  void deps.run(pick.session, row.line, []).catch((err: unknown) => {
+    console.warn(`[dsh-project-memory] ${row.line} failed:`, err)
+  })
+  return 'handled'
+}
+
+/**
+ * 造出注册给 `ctx.inputTriggers.registerSource` 的源对象。
+ * @param ctx - client 根上下文（只读 locale）。
+ * @param deps - 会话服务与命令执行通道。
+ * @returns 触发器源；只依赖宿主的公开契约字段。
+ */
+export function createSlashSource(ctx: any, deps: SlashSourceDeps): Record<string, unknown> {
+  const t = translator(ctx)
+  return {
+    trigger: '/',
+    name: SLASH_SOURCE_NAME,
+    order: SLASH_SOURCE_ORDER,
+    // 组标题不渲染：行上都有 section，MenuView 会用 section 标题取代它。
+    showGroupTitle: false,
+    candidates: async (_session: unknown, req: any) => buildSlashCandidates(t, req),
+    onPick: (pick: any) => dispatchSlashPick(t, deps, pick),
+  }
+}

package/src/commands/insight-actions.js

@@ -5,7 +5,7 @@
 import { ProjectMemoryStore } from '../store.js'
 import { memoryRootFor } from '../util/fs.js'
 import { cfgInsight, GlobalStore, normalizeInsight, defaultGlobalFile, saveInsight, INSIGHT_KINDS } from '../insight-store.js'
-import { projectRootFor } from '../setup/taskbridge.js'
+import { NO_PROJECT_ROOT_NOTE, projectRootFor } from '../setup/taskbridge.js'
 import { fencedJson, invocationContext } from './invocation.js'
 
 function insSummary(ins, extra = {}) {
@@ -311,11 +311,22 @@ export function editMemoryItem({ store, gs, scope, id, fields }) {
   return { ok: true, text: '已更新记忆条目' }
 }
 
-/** /insight <verb> <args…>：list [task|project|global] | confirm/promote/demote/archive/restore/delete <id> [taskId] */
+/**
+ * 记忆动作处理器：`list [task|project|global]` | `confirm/promote/demote/archive/restore/delete <scope> <id> [taskId]`
+ * 等。
+ *
+ * ⚠️ 这里返回的定义**不再作为宿主命令注册**：合并后唯一的用户命令是 `/tasks`（见 workflow.js），
+ * 本处理器是它的 `insight` 子动词分支（`/tasks insight <动作> …`），由工作流卡片按钮经
+ * remote.commands.execute 驱动。`name` / `description` / `input` 只剩说明意义，真正被使用的是
+ * `handler`——它读 `invocation.rawInput` 自行分词，合并前后一字未变。
+ * @param {object} config - 插件配置
+ * @param {object} ctx - 宿主上下文
+ * @returns {{name: string, description: string, input: object, handler: Function}}
+ */
 export function insightCommandDefinition(config, ctx) {
   return {
     name: 'insight',
-    description: '记忆视图动作（面板按钮调用）：/insight list project|global|task；/insight <confirm|promote|demote|archive|restore|delete> <scope> <id> [taskId]',
+    description: '记忆视图动作（面板按钮调用）：/tasks insight list project|global|task；/tasks insight <confirm|promote|demote|archive|restore|delete> <scope> <id> [taskId]',
     input: { hint: 'list [scope] | <动作> <scope> <id> [taskId]' },
     handler: (invocation) => {
       try {
@@ -323,6 +334,7 @@ export function insightCommandDefinition(config, ctx) {
         const lineRaw = (invocation?.rawInput || '').trim()
         const raw = lineRaw.split(/\s+/).filter(Boolean)
         const root = projectRootFor(cwd)
+        if (!root) return { kind: 'error', text: NO_PROJECT_ROOT_NOTE }
         if (!raw[0]) return { kind: 'error', text: '[insight] 用法见面板' }
         const verb = raw[0]
         if (verb === 'list') {