@yolk_vat-y/dsh-project-memory 0.4.3 → 0.5.0

package/src/auto-inject.js

@@ -0,0 +1,214 @@
+// PR 2 静默注入引擎（entry 常驻块 + relevance 门控）
+// 安全约定：
+//  - 纯函数 buildInjection 可单测；
+//  - wrapLlmStream 仅在 resolver 给出项目 root 时才会真正动 messages，
+//    任何异常/禁用/无 root → 原样透传（零副作用），绝不让宿主请求受影响。
+//  - “静默注入”文本带 [Memory Inject] 前缀，落在最后一条 user message 内容块里；
+//    指纹去重保证内容未变不重复追加（变更由宿主消息历史自然保留到压缩前）。
+import { createHash } from 'node:crypto'
+import { createUserMessage } from '@deepseek-ai/dsh-llm'
+import { ProjectMemoryStore } from './store.js'
+import { memoryRootFor } from './util/fs.js'
+import { insightMatchText } from './similarity.js'
+import { normalizedTokenOverlap } from './similarity.js'
+import { cfgInsight, GlobalStore, defaultGlobalFile } from './insight-store.js'
+import { projectTags } from './project-profile.js'
+
+export const INJECT_MARK = '[Memory Inject]'
+
+/** 注入引擎配置：insight 默认之上叠加 autoContext 预算/门控参数。 */
+export function cfgEngine(config) {
+  const c = (config && config.autoContext) || {}
+  const base = cfgInsight(config)
+  return {
+    ...base,
+    maxTokens: typeof c.maxTokens === 'number' ? c.maxTokens : 400,
+    entryMaxInsights: typeof c.entryMaxInsights === 'number' ? c.entryMaxInsights : 6,
+    relevanceMin: typeof c.relevanceMin === 'number' ? c.relevanceMin : 0.25,
+  }
+}
+
+function textOf(message) {
+  const blocks = (message && message.content) || []
+  return blocks
+    .filter((b) => b && b.type === 'text' && typeof b.text === 'string')
+    .map((b) => b.text)
+    .join('\n')
+}
+
+function lastUserText(messages) {
+  if (!Array.isArray(messages)) return ''
+  for (let i = messages.length - 1; i >= 0; i--) {
+    const m = messages[i]
+    if (m && m.role === 'user') {
+      const t = textOf(m)
+      if (t.trim()) return t.trim()
+    }
+  }
+  return ''
+}
+
+function fingerprint(text) {
+  return createHash('sha256').update(text).digest('hex').slice(0, 12)
+}
+
+function linesOf(list) {
+  const out = []
+  for (const it of list || []) {
+    if (!it || it.archived || it.draft) continue
+    const body = it.fix || it.solution || it.choice || (Array.isArray(it.steps) ? `步骤 ${it.steps.length} 条` : '')
+    out.push(`- [${it.id}] ${it.kind}: ${it.title}${body ? ` — ${String(body).slice(0, 120)}` : ''}`)
+  }
+  return out
+}
+
+/** 任务卡 + 非草稿任务级 insights 摘要（常驻块主体）。 */
+export function buildEntryContent(task, cfg) {
+  if (!task) return ''
+  const steps = (task.steps || []).map((s) => (typeof s === 'string' ? s : s.content || s.text || '').slice(0, 80))
+  const card = [`任务: ${task.title || '(untitled)'}`, `进度: ${steps.filter((s) => true).length ? `${steps.length} 步` : ''}`, ...steps.slice(0, 12).map((s, i) => `  ${i + 1}. ${s}`)]
+  const insights = linesOf(task.insights)
+  const parts = [...card]
+  if (insights.length) parts.push(`任务记忆:`, ...insights.slice(0, cfg.entryMaxInsights || 6))
+  return parts.join('\n')
+}
+
+/**
+ * 构建注入内容（不写盘、无副作用）。
+ * @param {object} opts { query, task, store, globalStore, projectTagsList, cfg }
+ * @returns {{ text: string, labels: string[] }}
+ */
+export function buildInjection(opts) {
+  const { query, task, globalStore, cfg } = opts
+  const store = opts.store || null
+  const tags = opts.projectTagsList || []
+  const labels = []
+  const parts = []
+  let budgetChars = (cfg.maxTokens || 400) * 3
+
+  // B) relevance：procedure（trigger 命中）全步骤优先
+  const gItems = globalStore ? globalStore.items() : []
+  const matched = []
+  for (const it of gItems) {
+    if (!it || it.archived || it.kind !== 'procedure' || !it.trigger) continue
+    const tr = it.trigger
+    const kwHit = (tr.keywords || []).some((k) => query.toLowerCase().includes(String(k).toLowerCase()))
+    const symHit = (tr.symbols || []).some((s) => query.includes(s))
+    if (!kwHit && !symHit) continue
+    if (Array.isArray(tr.scope) && tr.scope.length && tags.length) {
+      if (!tr.scope.some((s) => tags.includes(s))) continue // 画像过滤
+    }
+    matched.push({ it, score: 1 })
+  }
+  // procedure 之外的相关 insights（project + global 非草稿非归档），lexical top-k
+  const cands = [...(store ? store.insightItems() : []), ...gItems]
+  for (const it of cands) {
+    if (!it || it.archived || it.draft) continue
+    if (it.kind === 'procedure') continue // procedure 只经 trigger 通道注入，避免绕过 scope 过滤
+    const score = normalizedTokenOverlap(query, insightMatchText(it))
+    if (score >= (cfg.relevanceMin || 0.25)) matched.push({ it, score })
+  }
+  matched.sort((a, b) => b.score - a.score)
+  const seen = new Set()
+  for (const { it } of matched) {
+    if (seen.has(it.id)) continue
+    seen.add(it.id)
+    const label = it.kind === 'procedure' ? 'procedure' : 'insight'
+    const body =
+      it.kind === 'procedure' && Array.isArray(it.steps)
+        ? `【${it.title}】\n${it.steps.map((s, i) => `${i + 1}. ${s}`).join('\n')}`
+        : `- [${it.id}] ${it.title}${it.fix || it.solution || it.choice ? ` — ${it.fix || it.solution || it.choice}` : ''}`
+    parts.push(body)
+    labels.push(label)
+    if (parts.join('\n').length > budgetChars) break
+  }
+  // 常驻块文本（内容哈希由 wrapper 判“是否已注入过”）
+  const entry = task ? buildEntryContent(task, cfg) : ''
+  const total = [entry, ...parts].filter(Boolean)
+  if (!total.length) return { text: '', labels: [] }
+  let text = total.join('\n')
+  if (text.length > budgetChars) text = text.slice(0, budgetChars) + '\n…(截断)'
+  return { text, labels }
+}
+
+/**
+ * 包装 llm.stream。resolver(ctx, config) 返回项目 root；返回 null → 完全透传。
+ * opts.state 持有“当前注入指纹”（跨请求去重）。
+ */
+export function wrapLlmStream(streamFn, config, { resolveRoot, state, llmName = 'llm' } = {}) {
+  const auto = (config && config.autoContext) || {}
+  if (auto.enabled === false) return streamFn
+  const orig = typeof streamFn === 'function' ? streamFn : () => {}
+  const cfg = cfgEngine(config)
+  const mem = state || {}
+  return async function* wrapped(params) {
+    try {
+      const resolved = resolveRoot ? resolveRoot(config) : null
+      const root = typeof resolved === 'string' ? resolved : (resolved && resolved.root) || null
+      const sessionId = resolved && typeof resolved === 'object' ? resolved.sessionId || null : null
+      if (root) {
+        const query = lastUserText(params && params.messages)
+        const store = new ProjectMemoryStore(memoryRootFor(root, config.memoryDir)).load()
+        const globalStore = new GlobalStore(cfgInsight(config).globalFile || defaultGlobalFile()).load()
+        const sid = sessionId || null
+        const boundTaskId = sid && store.getBoundTaskId(sid) ? store.getBoundTaskId(sid) : null
+        const task = boundTaskId ? store.getTask(boundTaskId) : null
+        const built = buildInjection({ query, task, store, globalStore, projectTagsList: projectTags(root), cfg })
+        const fp = fingerprint(built.text)
+        if (built.text && fp !== mem.lastFp) {
+          const last = params.messages && params.messages[params.messages.length - 1]
+          if (last && last.role === 'user') {
+            const content = Array.isArray(last.content) ? last.content : []
+            content.push({ type: 'text', text: `\n\n${INJECT_MARK} ${llmName}\n${built.text}` })
+            last.content = content
+            mem.lastFp = fp
+            if (!mem.loggedFire) {
+              mem.loggedFire = true
+              console.log(`[dsh-project-memory] auto-context: FIRST injection fired (${built.text.length} chars, root=${root}${sessionId ? `, session=${sessionId}` : ''})`)
+            }
+          }
+        }
+      }
+    } catch (err) {
+      console.error(`[dsh-project-memory] auto-inject skipped: ${err?.message || err}`)
+    }
+    // 无论注入与否都原样走宿主 stream（异常同样原样传播）
+    yield* orig(params)
+  }
+}
+
+/** 注册 agent/pre-step 监听，向每步请求的 enter 决策追加记忆消息（默认开）。 */
+export function installAutoInject(ctx, config) {
+  const auto = (config && config.autoContext) || {}
+  if (auto.enabled === false) return
+  const cfg = cfgEngine(config)
+  const mem = {}
+  ctx.on('agent/pre-step', async (next, { agent, session }) => {
+    const decision = await next()
+    if (!decision || decision.kind !== 'enter') return decision
+    const root = session?.header?.cwd
+    const sessionId = session?.id
+    if (!root) return decision
+    try {
+      const query = lastUserText(decision.messages)
+      const store = new ProjectMemoryStore(memoryRootFor(root, config.memoryDir)).load()
+      const globalStore = new GlobalStore(cfgInsight(config).globalFile || defaultGlobalFile()).load()
+      const boundTaskId = sessionId && store.getBoundTaskId(sessionId) ? store.getBoundTaskId(sessionId) : null
+      const task = boundTaskId ? store.getTask(boundTaskId) : null
+      const built = buildInjection({ query: query || '', task, store, globalStore, projectTagsList: projectTags(root), cfg })
+      const fp = fingerprint(built.text)
+      if (built.text && fp !== mem.lastFp) {
+        const last = decision.messages && decision.messages[decision.messages.length - 1]
+        if (last && last.role === 'user') {
+          const content = Array.isArray(last.content) ? last.content : []
+          content.push({ type: 'text', text: `\n\n${INJECT_MARK} auto-context\n${built.text}` })
+          last.content = content
+          mem.lastFp = fp
+        }
+      }
+    } catch (err) {
+      console.error(`[dsh-project-memory] auto-inject skipped: ${err?.message || err}`)
+    }
+    return decision
+  })
+}

package/src/client/MemoryView.tsx

@@ -0,0 +1,349 @@
+/**
+ * Memory View — 记忆三作用域列表（Task 草稿 / Project / Global）
+ * 数据通道与任务面板一致：remote.commands.execute 执行 /insight 命令，取 JSON 载荷。
+ * 动作：confirm(草稿审核) / promote(向上提升) / demote(向下降级，需绑定任务) / archive / restore / delete
+ */
+import { useEffect, useCallback, useRef, useState } from 'react'
+import { Button } from '@deepseek-ai/dsh-client-ui-primitives'
+import css from './TaskPanel.module.css'
+
+export type InsightScope = 'task' | 'project' | 'global'
+
+export interface InsightRow {
+  id: string
+  kind: string
+  scope: InsightScope
+  title: string
+  body?: string
+  fix?: string
+  solution?: string
+  reason?: string
+  pattern?: string
+  problem?: string
+  choice?: string
+  draft?: boolean
+  archived?: boolean
+  confidence?: number | null
+  hitCount?: number
+  members?: number
+  files?: number
+  symbols?: number
+  trigger?: { keywords: string[]; scope: string[] } | null
+  steps?: string[]
+  taskId?: string
+  taskTitle?: string
+  updatedAt?: string
+}
+
+interface ListPayload {
+  scope: InsightScope
+  count: number
+  items: InsightRow[]
+}
+
+export function parseInsightPayloadText(text?: string | null): ListPayload | 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.items)) return null
+    return { scope: data.scope ?? 'project', count: data.count ?? data.items.length, items: data.items }
+  } catch {
+    return null
+  }
+}
+
+function kindText(kind: string, t: any): string {
+  const map: Record<string, string> = {
+    lesson: t('mem.kind.lesson'),
+    decision: t('mem.kind.decision'),
+    procedure: t('mem.kind.procedure'),
+    experience: t('mem.kind.experience'),
+  }
+  return map[kind] ?? kind
+}
+
+export function MemoryView({
+  ctx,
+  sessionId,
+  scope,
+  boundTaskId,
+  t,
+}: {
+  ctx: any
+  sessionId: string | null
+  scope: InsightScope
+  boundTaskId: string | null
+  t: any
+}) {
+  const [payload, setPayload] = useState<ListPayload | null>(null)
+  const [error, setError] = useState<string | null>(null)
+  const [loading, setLoading] = useState(false)
+  const [busy, setBusy] = useState(false)
+  const [showNew, setShowNew] = useState(false)
+  const [editingId, setEditingId] = useState<string | null>(null)
+  const [form, setForm] = useState({ title: '', kind: 'lesson', body: '', steps: '', trigger: '' })
+  const [savedTip, setSavedTip] = useState<string | null>(null)
+
+  const runLine = useCallback(
+    async (line: string): Promise<{ ok: boolean; text: string }> => {
+      const commands = ctx?.remote?.commands
+      if (!sessionId || !commands || typeof commands.execute !== 'function') {
+        return { ok: false, text: 'no session / commands service' }
+      }
+      try {
+        const response = await commands.execute(sessionId, line, [])
+        const envelope = response as { ok?: boolean; value?: any } | null | undefined
+        const execution = envelope && typeof envelope === 'object' && 'value' in envelope ? envelope.value : envelope
+        const result = execution?.result ?? execution
+        if (result?.kind === 'error') return { ok: false, text: result.text ?? 'command error' }
+        return { ok: true, text: result?.text ?? '' }
+      } catch (err) {
+        return { ok: false, text: String((err as Error)?.message ?? err) }
+      }
+    },
+    [ctx, sessionId],
+  )
+
+  // 用 ref 做并发/频控守卫：loading 状态不能进 refresh 的依赖数组，
+  // 否则 loading 每次翻转都会重建 refresh → effect 重跑 → 无限循环刷 /insight 命令。
+  const inflightRef = useRef(false)
+  const lastRunRef = useRef(0)
+
+  const refresh = useCallback(async (force = false): Promise<void> => {
+    if (inflightRef.current) return
+    const now = Date.now()
+    if (!force && now - lastRunRef.current < 800) return
+    inflightRef.current = true
+    lastRunRef.current = now
+    setLoading(true)
+    setError(null)
+    try {
+      const res = await runLine(`/insight list ${scope}`)
+      if (!res.ok) {
+        setError(res.text)
+        setPayload(null)
+        return
+      }
+      const parsed = parseInsightPayloadText(res.text)
+      setPayload(parsed)
+      if (!parsed) setError('unparsable payload')
+    } finally {
+      inflightRef.current = false
+      setLoading(false)
+    }
+  }, [runLine, scope])
+
+  useEffect(() => {
+    void refresh()
+  }, [refresh])
+
+  const act = async (action: string, id: string): Promise<void> => {
+    if (busy) return
+    setBusy(true)
+    setError(null)
+    try {
+      const line = `/insight ${action} ${scope} ${id}${action === 'demote' && scope === 'project' && boundTaskId ? ` ${boundTaskId}` : ''}`
+      const res = await runLine(line)
+      if (!res.ok) setError(res.text)
+      else void refresh(true)
+    } finally {
+      setBusy(false)
+    }
+  }
+
+  const rowToForm = (row: InsightRow) => {
+    // 正文按 kind 取专属字段（fix/solution/reason），避免把与标题相同的 pattern/problem 当正文
+    const main =
+      row.kind === 'lesson' ? row.fix
+        : row.kind === 'experience' ? row.solution
+          : row.kind === 'decision' ? row.reason
+            : row.body
+    const body = main && main !== row.title ? main : ''
+    return {
+      title: row.title || '',
+      kind: row.kind || 'lesson',
+      body,
+      steps: Array.isArray((row as InsightRow & { steps?: string[] }).steps) ? ((row as InsightRow & { steps?: string[] }).steps as string[]).join('\n') : '',
+      trigger: (row.trigger?.keywords || []).join(','),
+    }
+  }
+
+  const startEdit = (row: InsightRow) => {
+    setEditingId(row.id)
+    setForm(rowToForm(row))
+    setShowNew(true)
+    setError(null)
+  }
+
+  const closeForm = () => {
+    setShowNew(false)
+    setEditingId(null)
+    setForm({ title: '', kind: 'lesson', body: '', steps: '', trigger: '' })
+  }
+
+  // 切换类型时把当前输入迁移到目标类型的主内容区，避免换类型后“刚写的东西消失”
+  const changeKind = (next: string) => {
+    setForm(prev => {
+      if (prev.kind === next) return prev
+      const fromProc = prev.kind === 'procedure'
+      const toProc = next === 'procedure'
+      let body = prev.body
+      let steps = prev.steps
+      if (fromProc && !toProc && !body && steps.trim()) body = steps.trim() // procedure → 正文
+      if (toProc && !fromProc && !steps.trim() && body.trim()) steps = body.trim() // 正文 → 步骤
+      return { ...prev, kind: next, body, steps }
+    })
+  }
+
+  const submitNew = async (): Promise<void> => {
+    if (scope === 'task' && !editingId) return
+    if (busy) return
+    const title = form.title.trim()
+    if (!title) return
+    setBusy(true)
+    setError(null)
+    try {
+      const fields: Record<string, unknown> = { title, kind: form.kind }
+      if (form.kind === 'lesson') fields.pattern = title
+      if (form.kind === 'decision') fields.choice = title
+      if (form.kind === 'experience') fields.problem = title
+      if (form.body.trim()) {
+        if (form.kind === 'lesson') fields.fix = form.body.trim()
+        else if (form.kind === 'decision') fields.reason = form.body.trim()
+        else if (form.kind === 'experience') fields.solution = form.body.trim()
+        else fields.body = form.body.trim()
+      }
+      if (form.kind === 'procedure' && form.steps.trim()) {
+        fields.steps = form.steps.split('\n').map((s) => s.trim()).filter(Boolean)
+      }
+      if (form.kind === 'procedure' && form.trigger.trim()) {
+        fields.trigger = { keywords: form.trigger.split(/[,，]/).map((s) => s.trim()).filter(Boolean) }
+      }
+      const line = editingId
+        ? `/insight edit ${scope} ${editingId} ${JSON.stringify(fields)}`
+        : `/insight save ${scope} ${JSON.stringify(fields)}`
+      const res = await runLine(line)
+      if (!res.ok) {
+        setError(res.text)
+      } else {
+        setSavedTip(t('mem.saved'))
+        closeForm()
+        window.setTimeout(() => setSavedTip(null), 2500)
+        void refresh(true)
+      }
+    } finally {
+      setBusy(false)
+    }
+  }
+
+  const items = payload?.items ?? []
+
+  return (
+    <div className={css.memoryPane}>
+      <div className={css.memToolbar}>
+        <span className={css.memCount}>
+          {scope === 'task' ? t('mem.scope.task') : scope === 'global' ? t('mem.scope.global') : t('mem.scope.project')}
+          {payload ? ` · ${payload.count}` : ''}
+        </span>
+        <span className={css.memToolbarActs}>
+          {savedTip && <span className={css.badge}>{savedTip}</span>}
+          {scope !== 'task' && !showNew && (
+            <Button variant="outline" size="sm" disabled={busy} onClick={() => { setShowNew(true); setEditingId(null); setError(null) }}>{t('mem.new')}</Button>
+          )}
+          <Button variant="outline" size="sm" onClick={() => void refresh(true)} disabled={loading} title={t('panel.refresh')} aria-label={t('panel.refresh')}>
+            ↻
+          </Button>
+        </span>
+      </div>
+      {showNew && scope !== 'task' && (
+        <div className={css.memNew}>
+          <input className={css.stepInput} placeholder={t('mem.f.title')} value={form.title}
+            onChange={(e) => setForm({ ...form, title: e.target.value })} autoFocus />
+          <div className={css.memNewRow}>
+            <label className={css.memLabel}>{t('mem.f.kind')}
+              <select className={css.stepInput} value={form.kind} onChange={(e) => changeKind(e.target.value)}>
+                <option value="lesson">lesson</option>
+                <option value="decision">decision</option>
+                <option value="procedure">procedure</option>
+                <option value="experience">experience</option>
+              </select>
+            </label>
+          </div>
+          {form.kind !== 'procedure' && (
+            <textarea className={css.stepInput} placeholder={t('mem.f.body')} rows={2} value={form.body}
+              onChange={(e) => setForm({ ...form, body: e.target.value })} />
+          )}
+          {form.kind === 'procedure' && (
+            <>
+              <textarea className={css.stepInput} placeholder={t('mem.f.steps')} rows={3} value={form.steps}
+                onChange={(e) => setForm({ ...form, steps: e.target.value })} />
+              <input className={css.stepInput} placeholder={t('mem.f.trigger')} value={form.trigger}
+                onChange={(e) => setForm({ ...form, trigger: e.target.value })} />
+            </>
+          )}
+          <div className={css.memActs}>
+            <Button variant="outline" size="sm" disabled={busy || !form.title.trim()} onClick={() => void submitNew()}>{t('mem.save')}</Button>
+            <Button variant="outline" size="sm" onClick={closeForm}>{t('mem.cancel')}</Button>
+          </div>
+        </div>
+      )}
+      {error && <div className={css.notice}>{t('mem.error')}: {error}</div>}
+      {loading && !items.length && <div className={css.muted}>{t('mem.loading')}</div>}
+      {!loading && !error && items.length === 0 && <div className={css.muted}>{t('mem.empty')}</div>}
+      <div className={css.memList}>
+        {items.map((row) => {
+          const canDemoteToTask = scope === 'project' && !!boundTaskId
+          return (
+            <div key={row.id} className={`${css.memRow}${row.archived ? ` ${css.memRowArchived}` : ''}`}>
+              <div className={css.memRowMain}>
+                <span className={css.memTitle}>
+                  <span className={css.kindBadge}>{kindText(row.kind, t)}</span>
+                  {row.title || row.body}
+                </span>
+                <span className={css.memMeta}>
+                  {row.draft && <span className={`${css.badge} ${css.badgeDraft}`}>{t('mem.draft')}</span>}
+                  {row.archived && <span className={`${css.badge} ${css.badgeArchived}`}>{t('mem.archived')}</span>}
+                  {row.taskTitle && <span className={css.badge}>@{row.taskTitle}</span>}
+                  {row.members !== undefined && row.members > 0 && <span className={css.badge}>×{row.members}</span>}
+                  {row.confidence != null && <span className={css.badge}>{Math.round(row.confidence * 100)}%</span>}
+                  {row.trigger && row.trigger.keywords.length > 0 && <span className={css.badge}>⚡{row.trigger.keywords.slice(0, 2).join(',')}</span>}
+                </span>
+              </div>
+              {row.body && row.body !== row.title && <div className={css.memBody}>{String(row.body).slice(0, 160)}</div>}
+              <div className={css.memActs}>
+                <Button variant="outline" size="sm" disabled={busy} onClick={() => startEdit(row)}>{t('mem.edit')}</Button>
+                {scope === 'task' && !row.archived && (
+                  <>
+                    {row.draft && <Button variant="outline" size="sm" disabled={busy} onClick={() => void act('confirm', row.id)}>{t('mem.confirm')}</Button>}
+                    <Button variant="outline" size="sm" disabled={busy} onClick={() => void act('promote', row.id)}>{t('mem.promote')}</Button>
+                  </>
+                )}
+                {scope === 'project' && (
+                  <>
+                    <Button variant="outline" size="sm" disabled={busy} onClick={() => void act('promote', row.id)}>{t('mem.promote')}</Button>
+                    <Button variant="outline" size="sm" disabled={busy || !canDemoteToTask} title={!canDemoteToTask ? t('mem.needs-bound') : undefined} onClick={() => void act('demote', row.id)}>{t('mem.demote')}</Button>
+                  </>
+                )}
+                {scope === 'global' && (
+                  <Button variant="outline" size="sm" disabled={busy} onClick={() => void act('demote', row.id)}>{t('mem.demote')}</Button>
+                )}
+                {row.archived
+                  ? <Button variant="outline" size="sm" disabled={busy} onClick={() => void act('restore', row.id)}>{t('mem.restore')}</Button>
+                  : <Button variant="outline" size="sm" disabled={busy} onClick={() => void act('archive', row.id)}>{t('mem.archive')}</Button>}
+                <Button variant="outline" size="sm" disabled={busy} onClick={() => void act('delete', row.id)}>{t('mem.delete')}</Button>
+              </div>
+            </div>
+          )
+        })}
+      </div>
+    </div>
+  )
+}

package/src/client/TaskCommandNode.tsx

@@ -1,19 +1,15 @@
 /**
- * /tasks、/task 命令在会话中的节点渲染器（conversation.chat.commandview，按命令名 key）。
- *
- * 目标：不再让大段文本+JSON 出现在会话里——
- *  - 列表型（/tasks、无动词的 /task）：只渲染一行极简“已同步 N 套”状态；
- *    同时把节点文本里的 JSON 载荷解析进浮动面板（侧边卡片由它驱动），
- *    面板若被收起则自动展开（等价“输入 /task 就看到卡片”）。
- *  - 动作型（/task switch|archive）：渲染一行操作结果（切换/归档反馈）。
- *  - 错误/执行中：一行极简状态，不倾倒原文。
+ * /tasks、/task、/insight 命令在会话中的节点渲染器（conversation.chat.commandview，按命令名 key）。
+ * 列表型命令（/tasks、无动词 /task、/insight list）只显示一行摘要；/insight 的动作类只显示一句结果——
+ * 目的：大 JSON 载荷绝不整段渲染进对话（否则切视图会刷屏）。
  */
-import { useEffect } from 'react'
+import { useEffect, useRef } from 'react'
 import { IconFolderOpenOutline16 } from '@deepseek-ai/dsh-client-ui-primitives'
-import { parseTaskPayloadText, taskStore } from './task-store.ts'
+import { parseTaskPayloadText, taskDataStore } from './task-data-store.ts'
+import { parseInsightPayloadText } from './MemoryView.tsx'
+import { taskUIStore } from './task-ui-store.ts'
 import css from './TaskCommandNode.module.css'
 
-/** node = CommandRowOwnerProps.node（CommandNode: name / args / outcome{kind,text}） */
 export function TaskCommandNode({ node }: { node?: any }) {
   const name = node?.name ?? 'task'
   const outcome = node?.outcome ?? null
@@ -22,34 +18,50 @@ export function TaskCommandNode({ node }: { node?: any }) {
   const isList = name === 'tasks' || !verb
   const text = outcome?.text ?? ''
 
-  const parsed = parseTaskPayloadText(text)
+  const parsedTasks = name !== 'insight' ? parseTaskPayloadText(text) : null
+  const parsedInsights = name === 'insight' ? parseInsightPayloadText(text) : null
 
-  // 载荷进面板 + 列表型自动展开面板。
-  // 注意：命令节点先以“执行中”创建、完成后原地更新（同一组件实例），
-  // 所以 effect 必须在结果文本变化时重跑，而不是只在挂载时跑一次。
+  // 该节点是否“现场执行”（挂载时处于执行中）：为 true 说明是用户当场输入的命令，
+  // 完成后同步数据并打开面板。刷新/切换会话后历史节点以完成态重挂载，
+  // 此时只做展示、不再写数据/开面板（面板保持关闭，与“刷新后不显示”一致）。
+  const live = useRef(outcome === null)
+
+  // 载荷进数据 store；列表型任务命令（/tasks、无动词 /task）同步数据并打开面板
   useEffect(() => {
-    if (!parsed) return
-    taskStore.actions.setTasks({
-      tasks: parsed.tasks,
-      boundTaskId: parsed.boundId,
-      archivedCount: parsed.archived,
+    if (!parsedTasks || !live.current) return
+    taskDataStore.actions.setTasks({
+      tasks: parsedTasks.tasks,
+      boundTaskId: parsedTasks.boundId,
+      archivedCount: parsedTasks.archived,
     })
-    if (isList) taskStore.actions.open()
-    // eslint-disable-next-line react-hooks/exhaustive-deps
+    if (isList) taskUIStore.actions.open()
   }, [text])
 
-  // 执行中
   if (outcome === null) {
     return <div className={css.row} data-variant="running">/{name} 执行中…</div>
   }
 
-  // 失败：一行极简，不含大段原文
   if (outcome.kind === 'error') {
     const brief = String(text ?? '').split('\n')[0].slice(0, 120)
     return <div className={css.row} data-variant="error">/{name} 失败{brief ? `：${brief}` : ''}</div>
   }
 
-  // 动作型：取第一段（操作反馈），不带 JSON
+  // /insight：列表只显示一行摘要，动作类只显示一句结果（永不整段渲染）
+  if (name === 'insight') {
+    if (verb === 'list' && parsedInsights) {
+      const scope = parsedInsights.scope
+      const count = parsedInsights.count ?? parsedInsights.items.length
+      return (
+        <div className={css.row} data-variant="ok">
+          <IconFolderOpenOutline16 className={css.icon} />
+          <span>记忆 {scope} · {count} 条 · 已同步到记忆视图</span>
+        </div>
+      )
+    }
+    const note = String(text ?? '').split('\n')[0].slice(0, 120)
+    return <div className={css.row} data-variant="ok">/insight {verb} {note || '已完成'}</div>
+  }
+
   if (!isList) {
     const note = String(text ?? '')
       .split(/\n{2,}/)[0]
@@ -59,10 +71,9 @@ export function TaskCommandNode({ node }: { node?: any }) {
     return <div className={css.row} data-variant="ok">/{name} {note || '已完成'}</div>
   }
 
-  // 列表型：一行极简状态
-  const count = parsed ? parsed.tasks.length : 0
-  const archived = parsed ? parsed.archived : 0
-  const label = parsed
+  const count = parsedTasks ? parsedTasks.tasks.length : 0
+  const archived = parsedTasks ? parsedTasks.archived : 0
+  const label = parsedTasks
     ? `任务 ${count} 套${archived ? `（归档 ${archived}）` : ''} · 已同步到任务面板`
     : `/${name} 已执行`
   return (
@@ -71,4 +82,4 @@ export function TaskCommandNode({ node }: { node?: any }) {
       <span>{label}</span>
     </div>
   )
-}
+}