@yolk_vat-y/dsh-project-memory 0.4.0 → 0.4.2

package/src/client/client.ts

@@ -0,0 +1,53 @@
+/**
+ * dsh-project-memory Client Entry
+ *
+ * dsh web (rc.1) 的 client 插件契约为 cordis client plugin：
+ *   export const inject = [<client 服务名>...]
+ *   export function apply(ctx) { ... }
+ * 面板注册进 `shell.overlay`（Frame 级浮动层，additive 列表槽）：
+ * 该槽由 ui-layout 的 AppFrame 声明渲染（scope root，独立于滚动容器），
+ * 默认 click-through，条目自身需开启 pointer-events。
+ *
+ * 只依赖宿主 seed 提供的模块（react / dsh-client-ui-primitives），
+ * 数据经 remote.commands.execute 执行 /tasks 命令获取 JSON 快照。
+ */
+import { createElement } from 'react'
+import { TaskPanelEntry } from './TaskPanel.tsx'
+import { TaskCommandNode } from './TaskCommandNode.tsx'
+
+const NS = 'dsh-project-memory'
+
+export const name = NS
+
+/** Required client services: slots registry, session scopes, commands remote (data 通道). */
+export const inject = ['slots', 'sessions', 'remote', 'remote.commands']
+
+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 命令节点：按命令名 key 接管渲染，
+    // 替换内置大段文本卡片（文本含 JSON 载荷，只有面板需要它）。
+    const nodeKeys = ['tasks', 'task']
+    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)
+  }
+}

package/src/client/locales.ts

@@ -0,0 +1,92 @@
+/**
+ * Locale dictionaries for Task Panel
+ */
+export const zh = {
+  'panel.title': '工作流任务',
+  'panel.active': '进行中',
+  'panel.total': '总计',
+  'panel.minimize': '收起为顶部迷你条',
+  'panel.close': '关闭面板（隐藏，/task 可唤起）',
+    'panel.refresh': '同步最新任务',
+  'panel.style': '切换面板风格',
+  'style.native': '原生',
+  'style.glass': '玻璃',
+  'style.brutal': '粗野',
+  'style.mono': '终端',
+  'panel.syncing': '同步中…',
+  'panel.sync-failed': '同步失败',
+  'panel.empty': '暂无任务',
+  'panel.empty-desc': '让模型开始工作并维护 todo 清单后会自动建档',
+    'panel.no-session': '还没有会话',
+  'task.progress': '进度',
+  'task.steps': '步骤',
+  'task.files': '文件',
+    'task.current': '当前',
+  'task.title-edit': '双击修改标题',
+  'task.switch': '切换到此任务',
+  'task.unbind': '取消当前任务',
+  'task.archive': '归档',
+    'task.drag': '拖拽移动',
+  'step.completed': '已完成',
+  'step.in-progress': '进行中',
+  'step.pending': '待办',
+  'step.edit-hint': '双击编辑步骤文案；点击图标循环 待办/进行中/已完成',
+    'file.copy': '复制路径',
+  'file.copied': '已复制路径',
+  'minibar.current': '当前任务',
+  'minibar.click-expand': '点击展开并同步',
+  'minibar.tasks': '个任务',
+  'minibar.no-task': '暂无任务 · 点击查看',
+}
+
+export const en = {
+  'panel.title': 'Task Flow',
+  'panel.active': 'Active',
+  'panel.total': 'Total',
+  'panel.minimize': 'Collapse to mini bar',
+  'panel.close': 'Close panel (hidden; /task reopens)',
+    'panel.refresh': 'Sync latest tasks',
+  'panel.style': 'Panel style',
+  'style.native': 'Native',
+  'style.glass': 'Glass',
+  'style.brutal': 'Brutal',
+  'style.mono': 'Mono',
+  'panel.syncing': 'Syncing…',
+  'panel.sync-failed': 'Sync failed',
+  'panel.empty': 'No Tasks',
+  'panel.empty-desc': 'Tasks are created automatically when the model maintains a todo list',
+    'panel.no-session': 'No session yet',
+  'task.progress': 'Progress',
+  'task.steps': 'Steps',
+  'task.files': 'Files',
+    'task.current': 'Current',
+  'task.title-edit': 'Double-click to rename',
+  'task.switch': 'Switch to this task',
+  'task.unbind': 'Unbind current task',
+  'task.archive': 'Archive',
+    'task.drag': 'Drag to move',
+  'step.completed': 'Completed',
+  'step.in-progress': 'In Progress',
+  'step.pending': 'Pending',
+  'step.edit-hint': 'Double-click to edit; click the icon to cycle status',
+    'file.copy': 'Copy path',
+  'file.copied': 'Path copied',
+  'minibar.current': 'Current task',
+  'minibar.click-expand': 'Click to expand & sync',
+  'minibar.tasks': 'tasks',
+  'minibar.no-task': 'No tasks · click to view',
+}
+
+export type LocaleDict = typeof zh
+
+export function createTranslate(dict: LocaleDict) {
+  return (key: keyof LocaleDict, params?: Record<string, string | number>) => {
+    let text = dict[key] ?? key
+    if (params) {
+      for (const [k, v] of Object.entries(params)) {
+        text = text.replace(new RegExp(`\\{${k}\\}`, 'g'), String(v))
+      }
+    }
+    return text
+  }
+}

package/src/client/task-store.ts

@@ -0,0 +1,192 @@
+/**
+ * Task Panel Client Store（自包含：不依赖宿主 store 包）
+ * Reactive store for task list, bound task, UI state.
+ * 数据由 /tasks、/task 命令执行结果（JSON 载荷）写入，localStorage 持久化 UI 状态。
+ */
+import { useSyncExternalStore } from 'react'
+
+export interface TaskStep {
+  content: string
+  status: 'pending' | 'in_progress' | 'completed'
+}
+
+export interface TaskFile {
+  path: string
+  line?: number
+}
+
+export interface Task {
+  id: string
+  title: string
+  steps: TaskStep[]
+  files: TaskFile[]
+  lastActiveAt: string
+  updatedAt: string
+  archived?: boolean
+}
+
+export interface TaskPanelState {
+  tasks: Task[]
+  boundTaskId: string | null
+  archivedCount: number
+  // UI state
+  expandedTaskIds: string[]
+  panelPosition: { x: number; y: number }
+  /** true = 折叠成顶部迷你条（仍可见、可拖拽）。 */
+  minimized: boolean
+  /** true = 彻底隐藏（无迷你条），仅可通过 /task /tasks 或重新加载唤起。 */
+  closed: boolean
+  /** 卡片强调色主题：native 或 accent 名（azure/violet/teal/rose）。 */
+  theme: string
+  lastUpdate: number
+}
+
+/** /tasks 命令响应（text）里夹带的 JSON 载荷结构。 */
+export interface TaskPayload {
+  tasks: Task[]
+  boundId: string | null
+  archived: number
+}
+
+/** 从命令输出文本中解析任务快照 JSON（支持 fenced ```json 块或尾部对象）。 */
+export function parseTaskPayloadText(text?: string | null): TaskPayload | null {
+  if (!text) return null
+  let jsonBlock: string | null = null
+  const fenced = text.match(/```(?:json)?\s*\n([\s\S]*?)\n```/)
+  if (fenced) jsonBlock = fenced[1]
+  else {
+    const lastBrace = text.lastIndexOf('{')
+    if (lastBrace !== -1) jsonBlock = text.slice(lastBrace)
+  }
+  if (!jsonBlock) return null
+  try {
+    const data = JSON.parse(jsonBlock)
+    if (!Array.isArray(data.tasks)) return null
+    return { tasks: data.tasks, boundId: data.boundId ?? null, archived: data.archived ?? 0 }
+  } catch {
+    return null
+  }
+}
+
+const STORAGE_KEY = 'dsh-pm-task-panel-state'
+
+function defaultPosition(): { x: number; y: number } {
+  if (typeof window !== 'undefined') {
+    return { x: Math.max(16, window.innerWidth - 408), y: 72 }
+  }
+  return { x: 0, y: 0 }
+}
+
+function getDefaultState(): TaskPanelState {
+  if (typeof window !== 'undefined') {
+    try {
+      const saved = localStorage.getItem(STORAGE_KEY)
+      if (saved) {
+        const parsed = JSON.parse(saved)
+        return {
+          tasks: Array.isArray(parsed.tasks) ? parsed.tasks : [],
+          boundTaskId: parsed.boundTaskId ?? null,
+          archivedCount: parsed.archivedCount ?? 0,
+          expandedTaskIds: Array.isArray(parsed.expandedTaskIds) ? parsed.expandedTaskIds : [],
+          panelPosition: parsed.panelPosition ?? defaultPosition(),
+          minimized: parsed.minimized !== false, // 默认折叠成迷你条
+          theme: typeof parsed.theme === 'string' ? parsed.theme : 'native',
+          closed: !!parsed.closed,
+          lastUpdate: parsed.lastUpdate ?? 0,
+        }
+      }
+    } catch { /* corrupt state — fall through to defaults */ }
+  }
+  return {
+    tasks: [],
+    boundTaskId: null,
+    archivedCount: 0,
+    expandedTaskIds: [],
+    panelPosition: defaultPosition(),
+    minimized: true, // 默认折叠，不打扰
+    closed: false,
+    theme: 'native',
+    lastUpdate: 0,
+  }
+}
+
+function persist(state: TaskPanelState): void {
+  if (typeof window === 'undefined') return
+  try {
+    localStorage.setItem(STORAGE_KEY, JSON.stringify(state))
+  } catch { /* storage full/unavailable — non-fatal */ }
+}
+
+let state: TaskPanelState = getDefaultState()
+const listeners = new Set<() => void>()
+
+function setState(next: TaskPanelState): void {
+  state = next
+  persist(next)
+  for (const listener of listeners) listener()
+}
+
+export const taskStore = {
+  subscribe(listener: () => void): () => void {
+    listeners.add(listener)
+    return () => { listeners.delete(listener) }
+  },
+  getSnapshot(): TaskPanelState {
+    return state
+  },
+  actions: {
+    setTasks(payload: { tasks: Task[]; boundTaskId: string | null; archivedCount: number }): void {
+      const prev = state
+      setState({
+        ...prev,
+        tasks: payload.tasks || [],
+        boundTaskId: payload.boundTaskId ?? null,
+        archivedCount: payload.archivedCount ?? 0,
+        lastUpdate: Date.now(),
+      })
+    },
+    toggleTaskExpanded(taskId: string): void {
+      const prev = state
+      const ids = prev.expandedTaskIds.includes(taskId)
+        ? prev.expandedTaskIds.filter((id) => id !== taskId)
+        : [...prev.expandedTaskIds, taskId]
+      setState({ ...prev, expandedTaskIds: ids })
+    },
+    expandAll(): void {
+      const prev = state
+      setState({ ...prev, expandedTaskIds: prev.tasks.map((t) => t.id) })
+    },
+    setPanelPosition(pos: { x: number; y: number }): void {
+      setState({ ...state, panelPosition: pos })
+    },
+    /** 展开面板（同时解除隐藏/折叠）。 */
+    open(): void {
+      setState({ ...state, minimized: false, closed: false })
+    },
+    /** 折叠成顶部迷你条（仍可见）。 */
+    minimize(): void {
+      setState({ ...state, minimized: true, closed: false })
+    },
+    /** 彻底隐藏（无迷你条）；仅能通过 /task、/tasks 或重新加载唤起。 */
+    close(): void {
+      setState({ ...state, minimized: true, closed: true })
+    },
+    setTheme(theme: string): void {
+      setState({ ...state, theme })
+    },
+    setMinimized(minimized: boolean): void {
+      setState({ ...state, minimized, closed: minimized ? state.closed : false })
+    },
+    reset(): void {
+      setState(getDefaultState())
+    },
+  },
+}
+
+export function useTaskStore(): TaskPanelState {
+  return useSyncExternalStore(taskStore.subscribe, taskStore.getSnapshot, taskStore.getSnapshot)
+}
+
+export function useTaskActions() {
+  return taskStore.actions
+}

package/src/commands/task-actions.js

@@ -0,0 +1,188 @@
+// /task <verb> <taskId> 用户命令：Task Panel 卡片动作（不经模型）。
+//   switch  <taskId>  — 绑定当前会话到该任务（自动解归档），等价 select_task(taskId)
+//   archive <taskId>  — 归档该任务
+// 返回值与 /tasks 同一快照文本（含 JSON 载荷），面板解析后即时刷新，无需再跑一次 /tasks。
+import { memoryRootFor } from '../util/fs.js'
+import { ProjectMemoryStore } from '../store.js'
+import { projectRootFor, adoptStepsToSession, shouldAdoptToHost } from '../setup/taskbridge.js'
+import { renderTaskSnapshot, buildTaskPayload } from './tasks.js'
+
+const VERBS = { switch: 'switch', archive: 'archive' }
+
+function describeTask(t) {
+  const done = (t.steps || []).filter((s) => s.status === 'completed').length
+  const total = (t.steps || []).length
+  return `「${t.title}」（步骤 ${done}/${total}）`
+}
+
+function withTaskSnapshot(config, cwd, sid, store, note) {
+  const tasks = store.getTasks()
+  const active = tasks.filter((t) => !t.archived)
+  const archived = tasks.length - active.length
+  const boundId = sid ? store.getBoundTaskId(sid) : null
+  const human = `项目 ${projectRootFor(cwd)}\n${note}\n任务: ${active.length} 套${archived ? `（归档 ${archived}）` : ''}`
+  const payload = buildTaskPayload(active, boundId, archived)
+  return { kind: 'success', text: `${human}\n\n\`\`\`json\n${payload}\n\`\`\`` }
+}
+
+export function taskCommandDefinition(config) {
+  return {
+    name: 'task',
+    description: '任务面板动作：/task switch <任务id> 切换绑定，/task archive <任务id> 归档，/task unbind 取消当前任务绑定',
+    input: { hint: 'switch|archive <任务id> | unbind' },
+    handler: (invocation) => {
+      try {
+        const cwd = invocation?.agent?.session?.header?.cwd
+        const sid = invocation?.agent?.session?.id
+        const raw = (invocation?.rawInput || '').trim()
+        const [verb, taskId, ...rest] = raw.split(/\s+/)
+
+        // 无参数：等同 /tasks（不报错、不强制输入任务 id）——
+        // switch/archive/unbind 由卡片按钮自动调用，用户无需手敲。
+        if (!verb) {
+          const snap = renderTaskSnapshot(config, cwd, sid)
+          if (snap.kind === 'success') {
+            snap.text = `[任务] 用法: /task switch|archive <任务id> | unbind（卡片按钮会自动调用；不带参数等同 /tasks）\n\n${snap.text}`
+          }
+          return snap
+        }
+        if (!['unbind', 'todos', 'rename'].includes(verb) && (!taskId || rest.length)) {
+          return { kind: 'error', text: '[task] 用法: /task switch|archive <任务id> | unbind' }
+        }
+        const root = projectRootFor(cwd)
+        const store = new ProjectMemoryStore(memoryRootFor(root, config.memoryDir)).load()
+
+        if (verb === 'unbind') {
+          if (sid) store.removeBinding(sid)
+          store.save()
+          // 推空 todo/write 清掉输入框上方的宿主任务清单（TaskBridge 空写=清空，不再自动建档）
+          if (invocation?.agent?.session && typeof invocation.agent.session.append === 'function') {
+            invocation.agent.session.append('todo/write', { todos: [] })
+          }
+          const note = '已取消当前任务绑定并清空会话任务清单（需要时可让模型重新规划）'
+          return withTaskSnapshot(config, cwd, sid, store, note)
+        }
+
+        // /task rename <任务id> <json标题> —— 双击任务标题改名
+        if (verb === 'rename') {
+          if (!taskId) return { kind: 'error', text: '[task] rename 需要任务 id（由卡片双击调用）' }
+          const payload = raw.split(/\s+/).slice(2).join(' ').trim()
+          let title = payload
+          try {
+            const parsed = JSON.parse(payload)
+            if (typeof parsed === 'string') title = parsed
+          } catch { /* 非 JSON 时按原样取 payload */ }
+          title = title.trim()
+          if (!title) return { kind: 'error', text: '[task] 标题不能为空' }
+          const task = store.getTask(taskId)
+          if (!task) return { kind: 'error', text: `[task] 找不到任务: ${taskId}` }
+          const oldTitle = task.title
+          task.title = title
+          task.updatedAt = new Date().toISOString()
+          task.lastActiveAt = task.updatedAt
+          store.save()
+          const note = `已改名「${oldTitle}」→「${title}」`
+          return withTaskSnapshot(config, cwd, sid, store, note)
+        }
+
+        // /task todos <json> —— 卡片双击编辑步骤后，把整份新清单写回绑定任务并推宿主
+        // （与模型 todo_write 同一套数据，只是发起方是用户面板）
+        if (verb === 'todos') {
+          const rawJson = raw.split(/\s+/).slice(1).join(' ').trim()
+          let todos
+          try {
+            todos = JSON.parse(rawJson)
+          } catch {
+            return { kind: 'error', text: '[task] todos 需要 JSON 数组参数（由面板自动生成）' }
+          }
+          if (!Array.isArray(todos)) {
+            return { kind: 'error', text: '[task] todos 需要 JSON 数组参数（由面板自动生成）' }
+          }
+          const norm = todos
+            .map((s) => {
+              const content = String(s?.content ?? s?.text ?? '').trim()
+              const status = ['pending', 'in_progress', 'completed'].includes(s?.status) ? s.status : 'pending'
+              return { content, status }
+            })
+            .filter((s) => s.content.length > 0)
+          const boundId = sid ? store.getBoundTaskId(sid) : null
+          if (!boundId) {
+            return { kind: 'error', text: '[task] 未绑定任务，无法编辑步骤；先在卡片上“切换到此任务”' }
+          }
+          const task = store.getTask(boundId)
+          if (!task) return { kind: 'error', text: '[task] 绑定任务不存在' }
+          task.steps = norm
+          task.updatedAt = new Date().toISOString()
+          task.lastActiveAt = task.updatedAt
+          store.save()
+          if (shouldAdoptToHost(config)) {
+            adoptStepsToSession(invocation?.agent?.session, task)
+          }
+          const note = `已更新「${task.title}」步骤（${norm.length} 条）`
+          return withTaskSnapshot(config, cwd, sid, store, note)
+        }
+
+        if (verb === VERBS.switch) {
+          const task = store.getTask(taskId)
+          if (!task) return { kind: 'error', text: `[task] 找不到任务: ${taskId}（/tasks 查看）` }
+          if (task.archived) task.archived = false
+          if (sid) {
+            store.setBinding(sid, task.id)
+          }
+          task.updatedAt = new Date().toISOString()
+          task.lastActiveAt = task.updatedAt
+          store.save()
+          // 反向接管：切换成功后把任务步骤推成宿主 todo/write（dsh 清单跟随）
+          if (shouldAdoptToHost(config)) {
+            adoptStepsToSession(invocation?.agent?.session, task)
+          }
+          const note = `已切换绑定: ${describeTask(task)}${sid ? '' : '（拿不到会话 id，未持久绑定）'}`
+          return withTaskSnapshot(config, cwd, sid, store, note)
+        }
+
+        if (verb === VERBS.archive) {
+          const task = store.getTask(taskId)
+          if (!task) return { kind: 'error', text: `[task] 找不到任务: ${taskId}（/tasks 查看）` }
+          if (task.archived) return { kind: 'error', text: `[task] 已归档: ${task.title}` }
+          task.archived = true
+          task.updatedAt = new Date().toISOString()
+          store.save()
+          const note = `已归档: ${describeTask(task)}（select_task 可恢复）`
+          return withTaskSnapshot(config, cwd, sid, store, note)
+        }
+
+        return { kind: 'error', text: `[task] 未知动作: ${verb}（switch|archive）` }
+      } catch (err) {
+        return { kind: 'error', text: `[task] ${err?.message || err}` }
+      }
+    },
+  }
+}
+
+// 保留语义别名：/task-switch、/task-archive（仅当前端/旧入口用）
+export function taskSwitchCommandDefinition(config) {
+  const base = taskCommandDefinition(config)
+  return {
+    ...base,
+    name: 'task-switch',
+    handler: (invocation) => {
+      const id = (invocation?.rawInput || '').trim().split(/\s+/)[0]
+      return base.handler({ ...invocation, rawInput: id ? `switch ${id}` : '' })
+    },
+  }
+}
+
+export function taskArchiveCommandDefinition(config) {
+  const base = taskCommandDefinition(config)
+  return {
+    ...base,
+    name: 'task-archive',
+    handler: (invocation) => {
+      const id = (invocation?.rawInput || '').trim().split(/\s+/)[0]
+      return base.handler({ ...invocation, rawInput: id ? `archive ${id}` : '' })
+    },
+  }
+}
+
+// renderTaskSnapshot 引用保留，供外部（测试/工具）使用
+export { renderTaskSnapshot }

package/src/commands/tasks.js

@@ -1,4 +1,6 @@
 // /tasks 用户命令：不经模型，直接展示本项目任务总览（非归档 + 归档计数 + 当前会话绑定）。
+// 同时嵌入结构化 JSON 供 Client 端 Task Panel 解析渲染交互式面板。
+// renderTaskSnapshot / buildTaskPayload 导出供 task-actions.js 复用（面板动作后返回同一快照）。
 import { memoryRootFor } from '../util/fs.js'
 import { ProjectMemoryStore } from '../store.js'
 import { projectRootFor } from '../setup/taskbridge.js'
@@ -13,6 +15,60 @@ function timeAgo(iso) {
   return `${Math.floor(h / 24)}天前`
 }
 
+export function buildTaskPayload(tasks, boundId, archived) {
+  return JSON.stringify({
+    tasks: tasks.map((t) => ({
+      id: t.id,
+      title: t.title,
+      steps: (t.steps || []).map((s) => ({ content: s.content || s.text, status: s.status })),
+      files: (t.files || []).map((f) => ({ path: f, line: undefined })),
+      lastActiveAt: t.lastActiveAt,
+      updatedAt: t.updatedAt,
+      archived: t.archived || false,
+    })),
+    boundId: boundId || null,
+    archived,
+  })
+}
+
+/**
+ * 生成 /tasks 类快照的完整输出文本（人类可读总览 + JSON 载荷）。
+ * 任务动作命令复用同一函数，面板只需解析尾部 JSON 即可刷新。
+ */
+export function renderTaskSnapshot(config, cwd, sid) {
+  const root = projectRootFor(cwd)
+  const store = new ProjectMemoryStore(memoryRootFor(root, config.memoryDir)).load()
+  const tasks = store.getTasks()
+  const active = tasks.filter((t) => !t.archived)
+  const archived = tasks.length - active.length
+  const boundId = sid ? store.getBoundTaskId(sid) : null
+  const bound = boundId ? tasks.find((t) => t.id === boundId) : null
+
+  if (!active.length) {
+    const payload = buildTaskPayload([], boundId, archived)
+    return {
+      kind: 'success',
+      text: `项目 ${root}\n任务记录: 0 套${archived ? `（归档 ${archived}）` : ''}。让模型开始干活并维护 todo 清单后会自动建档。\n\n\`\`\`json\n${payload}\n\`\`\``,
+    }
+  }
+  const lines = [`项目 ${root}`, `任务: ${active.length} 套${archived ? `（归档 ${archived}）` : ''}`, '']
+  for (const t of active) {
+    const done = (t.steps || []).filter((s) => s.status === 'completed').length
+    const total = (t.steps || []).length
+    const progress = total ? `${done}/${total}` : '无步骤'
+    const inProgress = (t.steps || []).find((s) => s.status === 'in_progress')
+    const step = inProgress ? ` · 当前: ${inProgress.content}` : ''
+    const marker = bound && bound.id === t.id ? '（本会话绑定）' : ''
+    const files = (t.files || []).slice(0, 8)
+    const fileLine = files.length ? `\n  文件: ${files.join(', ')}${t.files.length > 8 ? ' …' : ''}` : ''
+    lines.push(`● ${t.title}${marker}  步骤 ${progress}${step} · ${timeAgo(t.lastActiveAt || t.updatedAt)}${fileLine}`)
+  }
+  lines.push('', '续接/改名/归档：直接告诉模型（list_tasks / select_task / archive_task）。')
+  const humanText = lines.join('\n')
+  const payload = buildTaskPayload(active, boundId, archived)
+  return { kind: 'success', text: `${humanText}\n\n\`\`\`json\n${payload}\n\`\`\`` }
+}
+
 export function tasksCommandDefinition(config) {
   return {
     name: 'tasks',
@@ -20,32 +76,8 @@ export function tasksCommandDefinition(config) {
     handler: (invocation) => {
       try {
         const cwd = invocation?.agent?.session?.header?.cwd
-        const root = projectRootFor(cwd)
-        const store = new ProjectMemoryStore(memoryRootFor(root, config.memoryDir)).load()
-        const tasks = store.getTasks()
-        const active = tasks.filter((t) => !t.archived)
-        const archived = tasks.length - active.length
         const sid = invocation?.agent?.session?.id
-        const boundId = sid ? store.getBoundTaskId(sid) : null
-        const bound = boundId ? tasks.find((t) => t.id === boundId) : null
-
-        if (!active.length) {
-          return { kind: 'success', text: `项目 ${root}\n任务记录: 0 套${archived ? `（归档 ${archived}）` : ''}。让模型开始干活并维护 todo 清单后会自动建档。` }
-        }
-        const lines = [`项目 ${root}`, `任务: ${active.length} 套${archived ? `（归档 ${archived}）` : ''}`, '']
-        for (const t of active) {
-          const done = (t.steps || []).filter((s) => s.status === 'completed').length
-          const total = (t.steps || []).length
-          const progress = total ? `${done}/${total}` : '无步骤'
-          const inProgress = (t.steps || []).find((s) => s.status === 'in_progress')
-          const step = inProgress ? ` · 当前: ${inProgress.content}` : ''
-          const marker = bound && bound.id === t.id ? '（本会话绑定）' : ''
-          const files = (t.files || []).slice(0, 8)
-          const fileLine = files.length ? `\n  文件: ${files.join(', ')}${t.files.length > 8 ? ' …' : ''}` : ''
-          lines.push(`● ${t.title}${marker}  步骤 ${progress}${step} · ${timeAgo(t.lastActiveAt || t.updatedAt)}${fileLine}`)
-        }
-        lines.push('', '续接/改名/归档：直接告诉模型（list_tasks / select_task / archive_task）。')
-        return { kind: 'success', text: lines.join('\n') }
+        return renderTaskSnapshot(config, cwd, sid)
       } catch (err) {
         return { kind: 'error', text: `[tasks] ${err?.message || err}` }
       }

package/src/enhancer.js

@@ -11,8 +11,8 @@ let tsPath = null
 let tsVersion = null
 
 function acceptTsVersion(mod) {
-  if (mod && mod.version && (mod.version.startsWith('6.') || mod.version.startsWith('7.'))) {
-    console.warn(`[dsh-project-memory] TypeScript ${mod.version} 不受支持，回退到 L1 正则。请使用 TS 5.x 获得增强类型。`)
+  if (mod && mod.version && mod.version.startsWith('7.')) {
+    console.warn(`[dsh-project-memory] TypeScript ${mod.version} 不受支持，回退到 L1 正则。请使用 TS 5.x/6.x 获得增强类型。`)
     return null
   }
   return mod

package/src/index.js

@@ -12,6 +12,7 @@ import { initTypeScript } from './enhancer.js'
 import { setupTaskbridge } from './setup/taskbridge.js'
 import { listTasksTool, selectTaskTool, archiveTaskTool } from './tools/task-tools.js'
 import { tasksCommandDefinition } from './commands/tasks.js'
+import { taskCommandDefinition } from './commands/task-actions.js'
 
 export const name = 'dsh-project-memory'
 export const inject = ['llm', 'tools']
@@ -33,6 +34,8 @@ export const Config = Schema.object({
   enableTypeScript: Schema.boolean().default(true),
   tasklist: Schema.object({
     enabled: Schema.boolean().default(true),
+    // 任务成为会话绑定（select_task / /task switch）时，把任务步骤推成宿主 todo/write 快照
+    syncHostOnAdopt: Schema.boolean().default(true),
   }).default({}),
 })
 
@@ -61,13 +64,14 @@ export function apply(ctx, config) {
   ctx.tools.register(selectTaskTool(config))
   ctx.tools.register(archiveTaskTool(config))
 
-  // /tasks 用户命令（宿主 commands 服务存在时注册，feature-detect 降级）
+  // /tasks、/task 用户命令（宿主 commands 服务存在时注册，feature-detect 降级）
   try {
     ctx.inject(['commands'], (commandsCtx) => {
       commandsCtx.commands.register(tasksCommandDefinition(config))
+      commandsCtx.commands.register(taskCommandDefinition(config))
     })
   } catch (err) {
-    console.error(`[dsh-project-memory] /tasks registration skipped: ${err.message}`)
+    console.error(`[dsh-project-memory] /tasks,/task registration skipped: ${err.message}`)
   }
 
   ctx.tools.register(indexDocTool(ctx, config))