@yolk_vat-y/dsh-project-memory 0.5.4 → 0.5.6

package/src/client/TaskPanel.tsx

@@ -75,7 +75,8 @@ function TaskPanelView({ ctx }: { ctx: any }) {
   const [syncing, setSyncing] = useState(false)
   const [syncedAt, setSyncedAt] = useState(0)
   const [syncError, setSyncError] = useState<string | null>(null)
-  const [showHints, setShowHints] = useState(true)
+  // 提示信息开关落在 UI store（持久化）：关掉后面板内所有悬停 title 气泡都不再弹出。
+  const showHints = ui.showHints
   const [view, setView] = useState<PanelView>('task')
   const cycleView = () => {
     const i = VIEW_CYCLE.indexOf(view)
@@ -288,6 +289,7 @@ function TaskPanelView({ ctx }: { ctx: any }) {
       <MiniBar
         label={label}
         hint={t('minibar.click-expand')}
+        showHints={showHints}
         position={ui.panelPosition}
         theme={style}
         onMove={uiActions.setPanelPosition}
@@ -308,7 +310,7 @@ function TaskPanelView({ ctx }: { ctx: any }) {
       style={{ left: ui.panelPosition.x, top: ui.panelPosition.y }}
       data-theme={style === 'native' ? undefined : style}
     >
-      <div className={css.dragHandle} onMouseDown={handleDragStart} title={t('task.drag')}>
+      <div className={css.dragHandle} onMouseDown={handleDragStart} title={showHints ? t('task.drag') : undefined}>
         <div className={css.handleGrip} />
       </div>
       <header className={css.header}>
@@ -317,7 +319,7 @@ function TaskPanelView({ ctx }: { ctx: any }) {
             type="button"
             className={css.headerIconBtn}
             onClick={cycleTheme}
-            title={styleLabel}
+            title={showHints ? styleLabel : undefined}
             aria-label={styleLabel}
           >
             <IconFolderOpenOutline16 className={css.headerIcon} />
@@ -330,7 +332,7 @@ function TaskPanelView({ ctx }: { ctx: any }) {
             size="sm"
             onClick={cycleView}
             aria-label={t('view.cycle')}
-            title={`${t('view.cycle')}（${view} → ${VIEW_CYCLE[(VIEW_CYCLE.indexOf(view) + 1) % VIEW_CYCLE.length]}）`}
+            title={showHints ? `${t('view.cycle')}（${view} → ${VIEW_CYCLE[(VIEW_CYCLE.indexOf(view) + 1) % VIEW_CYCLE.length]}）` : undefined}
           >
             {/* lucide notebook-tabs（视图循环图标） */}
             <svg
@@ -365,7 +367,9 @@ function TaskPanelView({ ctx }: { ctx: any }) {
           <Button
             variant="ghost"
             size="sm"
-            onClick={() => setShowHints(!showHints)}
+            className={showHints ? undefined : css.hintsOff}
+            onClick={() => uiActions.toggleHints()}
+            aria-pressed={!showHints}
             aria-label={showHints ? t('panel.hints-off') : t('panel.hints-on')}
             title={showHints ? t('panel.hints-off') : t('panel.hints-on')}
           >
@@ -376,7 +380,7 @@ function TaskPanelView({ ctx }: { ctx: any }) {
             size="sm"
             onClick={() => uiActions.minimize()}
             aria-label={t('panel.minimize')}
-            title={t('panel.minimize')}
+            title={showHints ? t('panel.minimize') : undefined}
           >
             <IconChevronDownOutline14 />
           </Button>
@@ -385,7 +389,7 @@ function TaskPanelView({ ctx }: { ctx: any }) {
             size="sm"
             onClick={() => uiActions.close()}
             aria-label={t('panel.close')}
-            title={t('panel.close')}
+            title={showHints ? t('panel.close') : undefined}
           >
             <IconCloseOutline16 />
           </Button>
@@ -396,7 +400,7 @@ function TaskPanelView({ ctx }: { ctx: any }) {
       {syncError && <div className={css.notice}>{t('panel.sync-failed')}: {syncError}</div>}
 
       {view !== 'task' ? (
-        <MemoryView ctx={ctx} sessionId={sessionId} scope={view as InsightScope} boundTaskId={data.boundTaskId} t={t} />
+        <MemoryView ctx={ctx} sessionId={sessionId} scope={view as InsightScope} boundTaskId={data.boundTaskId} showHints={showHints} t={t} />
       ) : activeTasks.length === 0 ? (
         <div className={css.emptyState}>
           <p className={css.emptyTitle}>{t('panel.empty')}</p>

package/src/client/task-ui-store.ts

@@ -1,5 +1,5 @@
 /**
- * Task UI Store — 仅管本地 UI 状态（closed、minimized、position、expandedIds、theme）
+ * Task UI Store — 仅管本地 UI 状态（closed、minimized、position、expandedIds、theme、showHints）
  * - 持久化到 localStorage（key: dsh-pm-task-panel-ui）
  * - 不跨标签页同步（每个标签页独立）
  * - 启动/刷新强制 closed: true，面板默认不显示
@@ -14,6 +14,8 @@ interface TaskUIState {
   minimized: boolean
   closed: boolean
   theme: string
+  /** 是否显示悬停提示信息（title 气泡）；false 时面板内所有功能提示都不弹出。 */
+  showHints: boolean
 }
 
 function defaultPosition(): { x: number; y: number } {
@@ -40,6 +42,7 @@ function getDefaultUIState(): TaskUIState {
           minimized: parsed.minimized !== false,
           closed: true,
           theme: typeof parsed.theme === 'string' ? parsed.theme : 'native',
+          showHints: parsed.showHints !== false,
         }
       }
     } catch { /* corrupt state — fall through to defaults */ }
@@ -50,6 +53,7 @@ function getDefaultUIState(): TaskUIState {
     minimized: true,
     closed: true,
     theme: 'native',
+    showHints: true,
   }
 }
 
@@ -103,6 +107,12 @@ export const taskUIStore = {
     setTheme(theme: string): void {
       setUIState({ ...uiState, theme })
     },
+    toggleHints(): void {
+      setUIState({ ...uiState, showHints: !uiState.showHints })
+    },
+    setShowHints(showHints: boolean): void {
+      setUIState({ ...uiState, showHints })
+    },
     reset(): void {
       setUIState(getDefaultUIState())
     },

package/src/index.js

@@ -49,7 +49,7 @@ export const Config = Schema.object({
     // 任务成为会话绑定（select_task / /task switch）时，把任务步骤推成宿主 todo/write 快照
     syncHostOnAdopt: Schema.boolean().default(true),
   }).default({}),
-  // v0.5 单一 insight 实体：分层去重/强化/提升/容量/归档（详见 PLAN-v0.5.0.md）
+  // v0.5 单一 insight 实体：分层去重/强化/提升/容量/归档
   insight: Schema.object({
     dedupOverlap: Schema.number().default(0.7),
     reinforceBand: Schema.number().default(0.65),
@@ -72,7 +72,24 @@ export const Config = Schema.object({
     enabled: Schema.boolean().default(true),
     entryOn: Schema.boolean().default(true),
     maxTokens: Schema.number().default(400),
-    relevanceMin: Schema.number().default(0.25),
+    entryMaxInsights: Schema.number().default(6),
+    // 提示通道的相对阈值（层内最高分的比例）——出厂判据
+    signalMinRatio: Schema.number().default(0.5),
+    // resident 任务卡最多显示几个「编辑中」文件
+    editedMax: Schema.number().default(3),
+    // 模型自己维护清单且之后没有新人类消息时，不把任务卡回声给模型
+    skipEchoSelfTodo: Schema.boolean().default(true),
+    // ⚠️ 旧兼容闸门，**刻意不给默认值**：cfgEngine 以「relevanceMin 是否为 number」选分支，
+    // 一旦有默认值就会永远走旧的绝对 overlap 判据——而它对长消息实测只有 0.014~0.057，
+    // 必然过不了，相对阈值 signalMinRatio 就变成死代码。只有用户显式配置才保留旧行为。
+    relevanceMin: Schema.number(),
+    // 预算审计日志（stderr）**默认 off**：终端是用户可见面，而"预算挤掉低优先级条目"是
+    // 正常降级、不是故障——默认打印会让一次 dsh web 启动刷出多行，用户的第一反应是卸载插件。
+    // off（默认，永不打印）/ once（每个会话最多一行，首次出现丢弃时）/ all（丢弃组合每变化一次一行，作者排查）
+    budgetLog: Schema.union(['off', 'once', 'all']).default('off'),
+    // 同一条 insight 在本会话里重复注入的冷却（pre-step 步数）。0（默认）= 正文没变就不再注入：
+    // 注入消息留在会话历史里（宿主只追加不压缩），整块重发只是重复占位。>0 用于外部裁剪历史的场景。
+    reinjectItemsAfter: Schema.number().default(0),
   }).default({}),
 })
 

package/src/insight-store.js

@@ -98,10 +98,32 @@ export function normalizeInsight(raw, extra = {}) {
     if (Array.isArray(raw[f]) && raw[f].length) ins[f] = [...new Set(raw[f].map((x) => String(x)))]
   }
   if (raw.trigger && typeof raw.trigger === 'object') {
-    const tr = { keywords: Array.isArray(raw.trigger.keywords) ? raw.trigger.keywords.map(String) : [] }
-    if (Array.isArray(raw.trigger.symbols)) tr.symbols = raw.trigger.symbols.map(String)
-    if (Array.isArray(raw.trigger.scope)) tr.scope = raw.trigger.scope.map(String)
-    if (tr.keywords.length) ins.trigger = tr
+    // 所有 kind 通用。准入化 schema：when（唯一触发面）/ guard（只收窄）/ prevents（准入条件）；
+    // 旧字段 keywords / symbols / actions / paths / scope 继续接受（readiness 会内存内迁移）。
+    const tr = {}
+    for (const f of ['keywords', 'symbols', 'actions', 'paths', 'scope']) {
+      if (Array.isArray(raw.trigger[f]) && raw.trigger[f].length) tr[f] = raw.trigger[f].map(String)
+    }
+    const when = raw.trigger.when
+    if (when && typeof when === 'object') {
+      const w = {}
+      for (const f of ['ops', 'writes', 'intents']) {
+        if (Array.isArray(when[f]) && when[f].length) w[f] = when[f].map(String)
+      }
+      if (Object.keys(w).length) tr.when = w
+    }
+    const guard = raw.trigger.guard
+    if (guard && typeof guard === 'object') {
+      const g = {}
+      for (const f of ['paths', 'not_paths', 'hosts', 'tags']) {
+        if (Array.isArray(guard[f]) && guard[f].length) g[f] = guard[f].map(String)
+      }
+      if (Object.keys(g).length) tr.guard = g
+    }
+    if (typeof raw.trigger.prevents === 'string' && raw.trigger.prevents.trim()) {
+      tr.prevents = raw.trigger.prevents.trim()
+    }
+    if (Object.keys(tr).length) ins.trigger = tr
   }
   return ins
 }

package/src/ops.js

@@ -0,0 +1,210 @@
+// 动作平面（PLAN S1）：把"这一步在做什么"从工具调用解析成有限的 op + 写目标 + 主机环境。
+//
+// 为什么不能继续用文本匹配：语料（路径、命令、被读文件正文）里的字符串可以冒充动作。
+// 实测病征是 `keyword:rm` 命中 `dcterms`、`keyword:pptx` 命中一个文件扩展名。
+// op 与 target 是低维、可枚举、可审计的：不随文本长度变化，也不会被正文污染。
+//
+// 分工：ops.js 只负责"把调用读成什么动作"，不负责决定注入什么（那是 readiness/auto-inject）。
+// 刻意不 import readiness：readiness 要 import 本模块的 op 闭集，反向依赖会造成循环。
+
+/** 带扩展名的路径 token（与 readiness.extractPaths 同规则；这里就地实现以免循环依赖）。 */
+const PATH_TOKEN = /(?:[A-Za-z0-9_.@-]+\/)*[A-Za-z0-9_.@-]+\.[A-Za-z][A-Za-z0-9]{0,7}\b/g
+
+function extractPaths(text) {
+  const s = String(text || '')
+  if (!s) return []
+  return [...new Set([...s.matchAll(PATH_TOKEN)].map((m) => m[0]))]
+}
+
+/** op 闭集。新增一个 op 必须同时想清楚：它是动作，不是话题。 */
+export const OP_IDS = [
+  'file-write',
+  'file-delete',
+  'shell-run',
+  'git-commit',
+  'git-push',
+  'release',
+  'npm-publish',
+  'deploy',
+  'migrate',
+  'go-public',
+  'render-doc',
+  'index-doc',
+  'read-image',
+  'fetch-web',
+  'run-bench',
+  'query-memory',
+]
+
+/**
+ * 兜底 op：它们描述的是"发生了某类操作"，信息量低、假阳性高。
+ * 允许写进 `when.ops`，但自检会 warn——兜底 op 只该命中兜底级记忆。
+ */
+export const FALLBACK_OPS = new Set(['shell-run', 'file-write', 'query-memory'])
+
+/**
+ * 弱 op：日常动作。它本身不构成边界（每天都在提交），所以当条目**已经有更精确的 writes**
+ * 时，迁移会把弱 op 丢掉——留着它只会把"改这个文件时"扩大成"任何一次提交时"。
+ * 实测：`git-commit` 让一条"别删内部文档"的教训在发版场景里被注入。
+ */
+export const WEAK_OPS = new Set([...FALLBACK_OPS, 'git-commit', 'git-push'])
+
+/** 旧 action id → op。旧值里有一批从来没进过 ACTION_LEXICON 的死值，这里给它们一个归宿。 */
+export const LEGACY_ACTION_ALIAS = {
+  'git-add': 'git-commit',
+  'npm-pack': 'npm-publish',
+  'release': 'release',
+  'generate-pptx': 'render-doc',
+  'render': 'render-doc',
+  'read-image': 'read-image',
+  'web-fetch': 'fetch-web',
+  'benchmark': 'run-bench',
+  'cleanup': 'file-delete',
+  'delete': 'file-delete',
+  'recover': null, // 没有对应动作：恢复是意图，不是工具动作
+  'research': null,
+  'survey': null,
+  'interview-prep': null,
+  'write-resume': null,
+  'report-metrics': null,
+  'write-docs': null,
+}
+
+const WRITE_TOOLS = new Set(['write', 'edit', 'multi_edit', 'apply_patch', 'str_replace', 'create_file', 'notebook_edit'])
+const READ_IMAGE_TOOLS = new Set(['read_image'])
+const INDEX_TOOLS = new Set(['index_doc', 'index_repo', 'watch_repo'])
+const FETCH_TOOLS = new Set(['web_fetch', 'web_search'])
+const SHELL_TOOLS = new Set(['bash', 'shell', 'pwsh', 'powershell', 'run', 'exec', 'job_run'])
+const QUERY_TOOLS = new Set(['query_memory', 'recall'])
+
+/** bash 命令 → op。顺序有意义：先具体后兜底。 */
+const SHELL_OP_RULES = [
+  [/\bnpm\s+(publish|pack)\b/, 'npm-publish'],
+  [/\bnpm\s+version\b/, 'release'],
+  [/\bgit\s+tag\b/, 'release'],
+  [/\bgit\s+push\b/, 'git-push'],
+  [/\bgit\s+(commit|add)\b/, 'git-commit'],
+  [/\bgit\s+(checkout|restore|reset)\b/, 'file-write'],
+  // `\brm\b` 而不是 `rm\s+-[rf]`：后者被 `\b` 卡在 'rm -rf' 的 r 后面（f 还是词字符），永远匹配不上。
+  [/\b(rm|git\s+rm|unlink|rmdir|shred)\b/, 'file-delete'],
+  [/\b(kubectl|docker\s+push|systemctl\s+restart|pm2\s+(deploy|restart)|vercel|netlify\s+deploy)\b/, 'deploy'],
+  [/\b(migrate|alembic|prisma\s+migrate|db:migrate)\b/, 'migrate'],
+  // 注意：只认"渲染器"，不认 .pptx 扩展名——否则给 pptx 改个时间戳也会命中"做 PPT"
+  [/(pptxgenjs|soffice|libreoffice|render\.sh|marp|pandoc|slidev)/, 'render-doc'],
+  [/(bench\.mjs|\bbench(mark)?\b)/, 'run-bench'],
+  [/\b(curl|wget|web_fetch)\b/, 'fetch-web'],
+]
+
+/** 会改动文件系统的 shell 动作前缀：只有这些命令的路径才算"写目标"。 */
+const SHELL_WRITE_RE = /\b(rm|rmdir|unlink|shred|mv|cp|touch|tee|truncate|mkdir)\b|>>?\s*\S|\bsed\s+-i\b/
+
+const WSL_HINT_RE = /\/mnt\/[a-z]\//i
+
+function safeJson(text) {
+  if (typeof text !== 'string' || !text.trim()) return null
+  try {
+    const v = JSON.parse(text)
+    return v && typeof v === 'object' ? v : null
+  } catch {
+    return null
+  }
+}
+
+function argsFields(argsText) {
+  const obj = safeJson(argsText)
+  if (!obj) return {}
+  const pick = (...keys) => keys
+    .map((k) => obj[k])
+    .filter((v) => typeof v === 'string' && v)
+    .join(' ')
+  return {
+    command: pick('command', 'cmd', 'script', 'code'),
+    path: pick('file_path', 'path', 'file', 'target', 'notebook_path'),
+  }
+}
+
+/** bash 命令 → { ops, targets, hosts }。 */
+export function classifyShellCommand(command) {
+  const cmd = String(command || '')
+  const ops = []
+  if (cmd) {
+    for (const [re, op] of SHELL_OP_RULES) {
+      if (re.test(cmd) && !ops.includes(op)) ops.push(op)
+    }
+  }
+  if (!ops.length) ops.push('shell-run')
+  const targets = SHELL_WRITE_RE.test(cmd) ? extractPaths(cmd) : []
+  const hosts = WSL_HINT_RE.test(cmd) || /\b(powershell|pwsh|cmd)\.exe\b/i.test(cmd) ? ['wsl'] : []
+  return { ops, targets, hosts }
+}
+
+/**
+ * 一次工具调用 → { ops, targets, hosts }。
+ * @param {string} name 工具名
+ * @param {string} argsText 工具参数（JSON 字符串或裸文本）
+ */
+export function classifyToolCall(name, argsText) {
+  const tool = String(name || '').toLowerCase()
+  const { command, path } = argsFields(argsText)
+  if (SHELL_TOOLS.has(tool)) return classifyShellCommand(command || String(argsText || ''))
+  if (READ_IMAGE_TOOLS.has(tool)) return { ops: ['read-image'], targets: [], hosts: [] }
+  if (INDEX_TOOLS.has(tool)) return { ops: ['index-doc'], targets: [], hosts: [] }
+  if (FETCH_TOOLS.has(tool)) return { ops: ['fetch-web'], targets: [], hosts: [] }
+  if (QUERY_TOOLS.has(tool)) return { ops: ['query-memory'], targets: [], hosts: [] }
+  if (WRITE_TOOLS.has(tool)) {
+    const targets = path ? [path, ...extractPaths(path)] : []
+    const hosts = targets.some((t) => WSL_HINT_RE.test(t)) ? ['wsl'] : []
+    return { ops: ['file-write'], targets: [...new Set(targets)], hosts }
+  }
+  return { ops: [], targets: [], hosts: [] }
+}
+
+/**
+ * 把一组已观察到的工具调用合成这一个线程的动态面。
+ * @param {{name?: string, arguments?: string}[]} calls
+ */
+export function activityFromCalls(calls) {
+  const ops = new Set()
+  const targets = new Set()
+  const hosts = new Set()
+  for (const call of calls || []) {
+    const r = classifyToolCall(call?.name, call?.arguments)
+    for (const op of r.ops) ops.add(op)
+    for (const t of r.targets) targets.add(t)
+    for (const h of r.hosts) hosts.add(h)
+  }
+  return { ops: [...ops], targets: [...targets], hosts: [...hosts] }
+}
+
+/**
+ * 没拿到结构化调用时的兜底：直接对一段文本跑 shell 规则。
+ * 用于 `actionText` 形式的就绪上下文（测试与老宿主），以及人类消息里的动作词。
+ */
+export function activityFromText(text) {
+  const s = String(text || '')
+  if (!s) return { ops: [], targets: [], hosts: [] }
+  const lines = s.split('\n').filter(Boolean)
+  const ops = new Set()
+  const targets = new Set()
+  const hosts = new Set()
+  for (const line of lines) {
+    // 先按"工具调用"解析（`edit {"file_path":"..."}`）：结构化参数比正则猜命令可靠得多。
+    const call = /^\s*([A-Za-z_][\w-]*)\s+(\{[\s\S]*\})\s*$/.exec(line)
+    const r = call ? classifyToolCall(call[1], call[2]) : classifyShellCommand(line)
+    // 纯文本行里没有 shell 动作时不要退化成 shell-run（那是噪音源）
+    if (r.ops.length === 1 && r.ops[0] === 'shell-run' && !/\b\w+\s+-/.test(line)) continue
+    for (const op of r.ops) ops.add(op)
+    for (const t of r.targets) targets.add(t)
+    for (const h of r.hosts) hosts.add(h)
+  }
+  return { ops: [...ops], targets: [...targets], hosts: [...hosts] }
+}
+
+/** 旧 action id（含死值）→ op；无法映射返回 null。 */
+export function opForLegacyAction(action) {
+  const a = String(action || '')
+  if (!a) return null
+  if (OP_IDS.includes(a)) return a
+  if (a in LEGACY_ACTION_ALIAS) return LEGACY_ACTION_ALIAS[a]
+  return null
+}

package/src/parsers/pdfjs-parser.js

@@ -25,6 +25,9 @@ const PDFJS_OPTIONS = {
   isEvalSupported: false,
   useWorkerFetch: false,
   useWorker: false,
+  // 0 = ERRORS。损坏/线性化缺失的 PDF 会让 pdf.js 打 "Warning: Indexing all PDF objects"
+  // 之类的告警——那是它自己的恢复路径，对使用者没有可操作性，静音。
+  verbosity: 0,
 }
 
 function buildMarkdown(pages) {