@weibaohui/context-razor 0.4.0 → 0.4.2

package/README.md

@@ -10,8 +10,10 @@
 ## 核心功能
 
 - **逐条列出**：当前会话模型可见的每条上下文（用户/助手/工具结果）按序排列，带预览、字符数与 ≈token 估算，点 ⋯ 查看全文与真实 usage
+- **占比标注**：每条的 token 徽章同时显示其占全部上下文的百分比（如 `≈5728 · 15%`），一眼看出谁是上下文大头
+- **类型筛选**：按类型一键过滤——用户 / 注入 / 助手，以及各工具名（bash、skill、read、edit…按会话实际出现的动态生成）。多选 toggle，与 token 量级筛选正交叠加
 - **超阈值标红**：可调阈值（默认 500 token，本地记忆），超限条目红色高亮；「只看超阈值」过滤 + 「token 高→低」排序，大头一眼可见
-- **精确裁剪**：勾选任意条目一键删除——连续段自动合并处理。删除走宿主 surface replace 协议（与官方 compaction 同款机制），**不经 LLM 总结**，删了什么、删了多少完全由你决定
+- **精确裁剪**：勾选任意条目一键删除——连续段自动合并处理。删除走宿主 surface replace 协议（与官方 compaction 同款机制），**不经 LLM 总结**，删了什么、删了多少完全由你决定。每行尾部带 ✕ 快捷按钮，**单条直接删**与勾选后**多选批量删**走同一确认弹窗
 - **不重排**：本插件不会改变上下文条目顺序，只会剔除选中条目；「token 高→低」排序仅影响页面显示，模型可见顺序始终由会话 surface 决定
 - **安全护栏**：会话运行中禁止裁剪（等当前回合结束）；每次替换附带一条 notice 标记消息，模型知道这段历史被你移除了，需要时会主动向你确认
 - **非破坏**：append-only 日志保留全部痕迹（宿主机制如此）。「删除」= 从模型视野与界面投影中移除

package/client/bundle.js

@@ -66,9 +66,11 @@ window.__ModuleLoader__.load({
       sortOrder: '上下文顺序',
       sortTokens: 'token 高→低',
       orderNote: '本插件不会改变上下文条目顺序，只会剔除选中条目。',
-      selectVisible: '选中可见',
-      selectVisibleHint: '选中当前显示的全部条目（配合色块筛选）',
-      clearSelect: '清空选择',
+      legendTitle: '按 token 量级筛选（点选高亮某一档）',
+      kindFilterLabel: '类型',
+      selectVisible: '全选',
+      selectVisibleHint: '全选当前可见条目（配合类型/量级筛选）',
+      clearSelect: '取消全选',
       deleteSelected: '删除选中',
       selectedStats: '已选 {n} 条 / ≈{tokens} token',
       stats: '{nodes} 条 · 合计 ≈{tokens} token{mode}',
@@ -87,6 +89,8 @@ window.__ModuleLoader__.load({
       deleteTitle: '确认裁剪',
       deleteConfirm: '即将把 {n} 条消息（约 {tokens} token）从模型视野中移除，替换为一条标记消息。日志中保留痕迹，此操作不可恢复。继续？',
       deleteBusyHint: '会话正在运行，等当前回合结束后再裁剪',
+      deleteOne: '删除此条',
+      deleteOneHint: '删除此条（约 {tokens} token）',
       deleteOk: '执行',
       cancel: '取消',
       deletedToast: '已删除 {n} 条（约 {tokens} token）',
@@ -104,9 +108,11 @@ window.__ModuleLoader__.load({
       sortOrder: 'Context order',
       sortTokens: 'tokens high→low',
       orderNote: 'This plugin never reorders context entries; it only removes the selected ones.',
-      selectVisible: 'Select shown',
-      selectVisibleHint: 'Select every currently shown entry (pairs with tier filters)',
-      clearSelect: 'Clear selection',
+      legendTitle: 'Filter by token tier (click to isolate a band)',
+      kindFilterLabel: 'Type',
+      selectVisible: 'All',
+      selectVisibleHint: 'Select all currently visible entries (pairs with type/tier filters)',
+      clearSelect: 'Clear all',
       deleteSelected: 'Delete selected',
       selectedStats: '{n} selected / ≈{tokens} tokens',
       stats: '{nodes} entries · total ≈{tokens} tokens{mode}',
@@ -125,6 +131,8 @@ window.__ModuleLoader__.load({
       deleteTitle: 'Confirm trim',
       deleteConfirm: 'About to remove {n} messages (≈{tokens} tokens) from the model view, replaced by one marker message. Traces stay in the log; this cannot be undone. Continue?',
       deleteBusyHint: 'Session is running — trim after the current turn finishes',
+      deleteOne: 'Delete this entry',
+      deleteOneHint: 'Delete this entry (≈{tokens} tokens)',
       deleteOk: 'Delete',
       cancel: 'Cancel',
       deletedToast: 'Deleted {n} entries (≈{tokens} tokens)',
@@ -174,6 +182,38 @@ window.__ModuleLoader__.load({
       return { kind: entry.kind, label: t(kindI18n(entry.kind)) }
     }
 
+    /**
+     * 筛选用稳定分类键，与 entryChip 的可见口径一致：
+     *   tool  → 'tool:<工具名>'（无工具名则 'tool:'，按钮文案退回「工具」）
+     *   user 注入 → 'injected'（sourceKind !== 'user' 的 user 消息，统一一档；
+     *     细分来源在 chip 的 title 与详情里已可见，筛选层不再切分，避免按钮爆炸）
+     *   user / assistant → 自身
+     * 「按钮文案」与 chip 同源（categoryLabel），用户在两处看到的是同一个词。
+     */
+    function entryCategory(entry) {
+      if (entry.kind === 'tool') return 'tool:' + (typeof entry.tool === 'string' ? entry.tool : '')
+      if (entry.kind === 'user' && entry.sourceKind && entry.sourceKind !== 'user') return 'injected'
+      return entry.kind
+    }
+    function categoryLabel(cat, t) {
+      if (cat === 'user') return t('kindUser')
+      if (cat === 'assistant') return t('kindAssistant')
+      if (cat === 'injected') return t('kindInjected')
+      if (cat.lastIndexOf('tool:', 0) === 0) {
+        const name = cat.slice(5)
+        return name || t('kindTool')
+      }
+      return cat
+    }
+
+    /** 该条 token 占全部上下文的百分比文案；total 非正或 part 为 0 返回 null（不显示）。 */
+    function pctOf(part, total) {
+      if (!total || !part) return null
+      const p = part / total * 100
+      if (p < 0.1) return '<0.1%'
+      return (p >= 10 ? p.toFixed(0) : p.toFixed(1)) + '%'
+    }
+
     // ── 彩虹分级：颜色越暖 = 占用越多 ────────────────────────────────────────
     // 固定对数档位（相邻约 ×2.5），跨会话语义稳定：绿→黄绿→黄→橙→红→品红。
     // 档位是「这条消息吃掉多少典型上下文预算」的粗标尺，不随会话内最大值缩放。
@@ -224,6 +264,18 @@ window.__ModuleLoader__.load({
     .rz-swatch.tier-3{background:hsl(32,80%,45%)}
     .rz-swatch.tier-4{background:hsl(8,75%,48%)}
     .rz-swatch.tier-5{background:hsl(320,65%,50%)}
+    .rz-kindsbar{display:flex;gap:8px;align-items:center;flex-wrap:wrap}
+    .rz-kinds{display:inline-flex;gap:4px;align-items:center;flex-wrap:wrap}
+    .rz-kinds.filtering .rz-kindbtn:not(.on){opacity:.45}
+    .rz-kindbtn{display:inline-flex;align-items:center;gap:5px;padding:2px 10px;border-radius:999px;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-secondary);font-size:11.5px;cursor:pointer;font-family:var(--dsw-font-family);white-space:nowrap}
+    .rz-kindbtn:hover{border-color:var(--dsw-alias-border-l3);background:var(--dsw-alias-interactive-bg-hover)}
+    .rz-kindbtn.on{color:var(--dsw-alias-state-business-primary);border-color:var(--dsw-alias-state-business-primary);font-weight:600}
+    .rz-kindcount{font-size:10px;opacity:.7}
+    .rz-thead{display:flex;gap:8px;align-items:center;flex-wrap:wrap;padding:6px 12px;border:1px solid var(--dsw-alias-border-l1);border-radius:10px;background:var(--dsw-alias-bg-layer-1)}
+    .rz-thead-l{display:inline-flex;gap:8px;align-items:center;flex-wrap:wrap}
+    .rz-sel-stats{color:var(--dsw-alias-label-secondary);font-size:12px;white-space:nowrap}
+    .rz-col-tok{flex:0 0 62px;display:flex;justify-content:flex-end}
+    .rz-col-pct{flex:0 0 44px;text-align:right;color:var(--dsw-alias-label-tertiary);font-size:11px;white-space:nowrap}
     .rz-list{display:flex;flex-direction:column;gap:6px}
     .rz-row{display:flex;gap:10px;align-items:center;padding:8px 12px;border-radius:10px;border:1px solid var(--dsw-alias-border-l1);border-left:3px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-layer-1);cursor:pointer;text-align:left;width:100%}
     .rz-row:hover{background:var(--dsw-alias-interactive-bg-hover)}
@@ -231,6 +283,9 @@ window.__ModuleLoader__.load({
     .rz-row-preview{flex:0 1 340px;min-width:100px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:var(--dsw-alias-label-primary);font-size:13px;text-decoration:none}
     .rz-row-preview:hover{text-decoration:underline;text-underline-offset:3px}
     .rz-row-meta{color:var(--dsw-alias-label-tertiary);font-size:11px;flex:none}
+    .rz-row-del{display:inline-flex;align-items:center;justify-content:center;width:22px;height:22px;margin-left:4px;border-radius:6px;border:1px solid transparent;background:transparent;color:var(--dsw-alias-label-tertiary);font-size:13px;line-height:1;cursor:pointer;flex:none}
+    .rz-row-del:hover:not(:disabled){color:var(--dsw-alias-state-error-primary);border-color:var(--dsw-alias-state-error-primary);background:hsla(0,75%,50%,.08)}
+    .rz-row-del:disabled{opacity:.35;cursor:not-allowed}
     .rz-badge.tier-0{color:hsl(120,55%,40%);border-color:hsla(120,55%,40%,.45);background:hsla(120,55%,40%,.10)}
     .rz-badge.tier-1{color:hsl(90,60%,38%);border-color:hsla(90,60%,38%,.45);background:hsla(90,60%,38%,.10)}
     .rz-badge.tier-2{color:hsl(60,70%,36%);border-color:hsla(60,70%,36%,.45);background:hsla(60,70%,36%,.12)}
@@ -281,14 +336,16 @@ window.__ModuleLoader__.load({
     }
 
     /** 单条全文弹窗（正文经 /entry 异步补全）。 */
-    function DetailModal({ detail, t, onClose }) {
+    function DetailModal({ detail, t, total, onClose }) {
       if (!detail) return null
+      const pct = pctOf(detail.tokens, total)
       return h('div', { className: 'rz-dlg-backdrop', onClick: onClose },
         h('div', { className: 'rz-dlg', onClick: e => e.stopPropagation() },
           h('h3', null, t('detailTitle') + ' · ' + t('seqLabel', { seq: detail.seq })),
           h('div', { className: 'rz-stats', style: { marginBottom: 10 } },
             h(Chip, { ...entryChip(detail, t) }),
             h(TokenBadge, { entry: detail }),
+            pct && h('span', { className: 'rz-label', title: pct + ' of ≈' + formatNum(total) + ' token' }, pct),
             h('span', { className: 'rz-label', title: 'seq ' + detail.seq }, formatDateTime(detail.time)),
             h('span', { className: 'rz-label' }, t('detailChars', { chars: formatNum(detail.chars) })),
             detail.usage && h('span', { className: 'rz-label' }, t('detailUsage', {
@@ -319,10 +376,11 @@ window.__ModuleLoader__.load({
       const [ctxLoading, setCtxLoading] = useState(false)
       const [error, setError] = useState(null)
       const [tierFilter, setTierFilter] = useState(() => new Set())
+      const [kindFilter, setKindFilter] = useState(() => new Set())
       const [sortBy, setSortBy] = useState('order')
       const [selected, setSelected] = useState(() => new Set())
       const [detail, setDetail] = useState(null)
-      const [confirming, setConfirming] = useState(false)
+      const [confirming, setConfirming] = useState(null) // null | number[] 待裁剪 seqs（单条/多选同源）
       const [deleting, setDeleting] = useState(false)
       const [toast, setToast] = useState(null)
       const sessionRef = useRef('')
@@ -353,16 +411,34 @@ window.__ModuleLoader__.load({
         if (!context) return []
         let rows = context.entries
         if (tierFilter.size > 0) rows = rows.filter(e => tierFilter.has(tierOf(e)))
+        if (kindFilter.size > 0) rows = rows.filter(e => kindFilter.has(entryCategory(e)))
         return sortEntries(rows, sortBy)
-      }, [context, tierFilter, sortBy])
+      }, [context, tierFilter, kindFilter, sortBy])
 
-      const selectedTokens = useMemo(() => {
-        if (!context) return 0
-        const bySeq = new Map(context.entries.map(e => [e.seq, e]))
+      // 当前上下文里实际出现的分类（cat/count/tokens），按条数降序——决定渲染哪些按钮。
+      const categories = useMemo(() => {
+        if (!context) return []
+        const seen = new Map()
+        for (const e of context.entries) {
+          const c = entryCategory(e)
+          const prev = seen.get(c) || { count: 0, tokens: 0 }
+          prev.count += 1
+          prev.tokens += (e.tokens || 0)
+          seen.set(c, prev)
+        }
+        return [...seen.entries()]
+          .map(([cat, v]) => ({ cat, count: v.count, tokens: v.tokens }))
+          .sort((a, b) => b.count - a.count || b.tokens - a.tokens)
+      }, [context])
+
+      const entriesBySeq = useMemo(() => context ? new Map(context.entries.map(e => [e.seq, e])) : null, [context])
+      const sumSeqs = (seqs) => {
         let sum = 0
-        for (const seq of selected) { const e = bySeq.get(seq); if (e) sum += e.tokens }
+        if (entriesBySeq) for (const seq of seqs) { const e = entriesBySeq.get(seq); if (e) sum += e.tokens || 0 }
         return sum
-      }, [context, selected])
+      }
+      const selectedTokens = useMemo(() => sumSeqs(selected), [selected, entriesBySeq])
+      const confirmTokens = useMemo(() => confirming ? sumSeqs(confirming) : 0, [confirming, entriesBySeq])
 
       const toggleRow = (seq) => setSelected(prev => {
         const next = new Set(prev)
@@ -376,6 +452,12 @@ window.__ModuleLoader__.load({
         else next.add(i)
         return next
       })
+      const toggleKind = (cat) => setKindFilter(prev => {
+        const next = new Set(prev)
+        if (next.has(cat)) next.delete(cat)
+        else next.add(cat)
+        return next
+      })
       const selectVisible = () => setSelected(new Set(visible.map(e => e.seq)))
 
       const openDetail = (entry) => {
@@ -386,17 +468,18 @@ window.__ModuleLoader__.load({
       }
 
       const doDelete = async () => {
+        if (!confirming || confirming.length === 0) return
         setDeleting(true)
         try {
-          const r = await fetch(API + '/delete', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ session: sessionId, seqs: [...selected] }) })
+          const r = await fetch(API + '/delete', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ session: sessionId, seqs: confirming }) })
           const d = await r.json().catch(() => ({}))
           if (!r.ok) throw new Error(d.error || 'HTTP ' + r.status)
-          setConfirming(false)
+          setConfirming(null)
           setSelected(new Set())
           showToast(t('deletedToast', { n: d.removed, tokens: formatNum(d.tokensRemoved) }))
           refreshAll()
         } catch (e) {
-          setConfirming(false)
+          setConfirming(null)
           setError(e.message)
         } finally { setDeleting(false) }
       }
@@ -415,40 +498,59 @@ window.__ModuleLoader__.load({
             h('span', { className: 'rz-legend' + (tierFilter.size > 0 ? ' filtering' : ''), title: t('legendTitle') },
               RAZOR_TIERS.map((tr, i) => h('button', { key: i, className: 'rz-swatch tier-' + i + (tierFilter.has(i) ? ' on' : ''), title: tr.label + ' token', onClick: () => toggleTier(i) }, tr.label))),
             h('span', { className: 'rz-spacer' }),
-            busy && h('span', { className: 'rz-badge' }, t('busyTag')),
-            h('button', { className: 'rz-btn', onClick: selectVisible, disabled: visible.length === 0 || busy, title: t('selectVisibleHint') },
-              t('selectVisible') + (visible.length ? ` (${visible.length})` : '')),
+            busy && h('span', { className: 'rz-badge' }, t('busyTag'))),
+          // 类型筛选：与 chip 同口径的可点选按钮（user/injected/assistant/tool:<名>），
+          // 多选 toggle，与 tier 量级筛选正交叠加。按钮带条数；hover 看 token 占比。
+          categories.length > 0 && h('div', { key: 'kinds', className: 'rz-kindsbar' },
+            h('span', { className: 'rz-label' }, t('kindFilterLabel')),
+            h('span', { className: 'rz-kinds' + (kindFilter.size > 0 ? ' filtering' : '') },
+              categories.map(({ cat, count, tokens }) =>
+                h('button', { key: cat,
+                  className: 'rz-kindbtn' + (kindFilter.has(cat) ? ' on' : ''),
+                  title: categoryLabel(cat, t) + ' · ' + count + ' 条 · ≈' + formatNum(tokens) + ' token'
+                    + (context.totalTokens ? '（' + (pctOf(tokens, context.totalTokens) || '0%') + '）' : ''),
+                  onClick: () => toggleKind(cat) },
+                  categoryLabel(cat, t),
+                  h('span', { className: 'rz-kindcount' }, count))))),
+          // 表头（在类型筛选下方）：左 刷新/全选，选中后追加 删除·取消全选；右 排序。
+          h('div', { key: 'thead', className: 'rz-thead' },
+            h('div', { className: 'rz-thead-l' },
+              h('button', { className: 'rz-btn', onClick: refreshAll, title: t('refresh') }, t('refresh')),
+              h('button', { className: 'rz-btn', onClick: selectVisible, disabled: visible.length === 0 || busy, title: t('selectVisibleHint') },
+                t('selectVisible') + (visible.length ? ` (${visible.length})` : '')),
+              selected.size > 0 && h('button', { className: 'rz-btn rz-btn-danger', disabled: !canDelete,
+                title: busy ? t('deleteBusyHint') : undefined,
+                onClick: () => setConfirming([...selected]) },
+                t('deleteSelected') + ` (${selected.size})`),
+              selected.size > 0 && h('button', { className: 'rz-btn', onClick: () => setSelected(new Set()) }, t('clearSelect'))),
+            h('span', { className: 'rz-spacer' }),
             h('select', { className: 'rz-select', value: sortBy, onChange: e => setSortBy(e.target.value), title: t('sortLabel'), 'aria-label': t('sortLabel') },
               h('option', { value: 'order' }, t('sortOrder')),
-              h('option', { value: 'tokens' }, t('sortTokens'))),
-            h('button', { className: 'rz-btn', onClick: refreshAll, title: t('refresh') }, t('refresh'))),
-          selected.size > 0 && h('div', { key: 'sel', className: 'rz-stats' },
-            h('span', null, t('selectedStats', { n: selected.size, tokens: formatNum(selectedTokens) })),
-            h('span', { className: 'rz-spacer' }),
-            h('div', { className: 'rz-footbtns' },
-              h('button', { className: 'rz-btn', onClick: () => setSelected(new Set()) }, t('clearSelect')),
-              h('button', { className: 'rz-btn rz-btn-danger', disabled: !canDelete,
-                title: busy ? t('deleteBusyHint') : undefined,
-                onClick: () => setConfirming(true) },
-                t('deleteSelected') + ` (${selected.size})`))),
+              h('option', { value: 'tokens' }, t('sortTokens')))),
           visible.length === 0
             ? h('div', { key: 'empty', className: 'rz-empty' }, t('emptyContext'))
             : h('div', { key: 'list', className: 'rz-list' },
                 h(PagedList, { items: visible, t, render: entry => {
                   const tier = tierOf(entry)
+                  const pct = pctOf(entry.tokens, context.totalTokens)
                   return h('div', { key: entry.seq, className: 'rz-row tier-' + tier + (selected.has(entry.seq) ? ' checked' : ''),
                       role: 'button', tabIndex: 0, onClick: () => toggleRow(entry.seq),
                       onKeyDown: e => e.key === 'Enter' && toggleRow(entry.seq) },
                     h('input', { type: 'checkbox', checked: selected.has(entry.seq), onClick: e => e.stopPropagation(), onChange: () => toggleRow(entry.seq) }),
-                    h(TokenBadge, { entry }),
+                    h('span', { className: 'rz-col-tok' }, h(TokenBadge, { entry })),
+                    h('span', { className: 'rz-col-pct', title: pct ? pct + ' of ≈' + formatNum(context.totalTokens) + ' token' : '' }, pct || ''),
                     h(Chip, { ...entryChip(entry, t) }),
                     h('span', { className: 'rz-row-preview', title: entry.preview,
                         onClick: e => { e.stopPropagation(); openDetail(entry) } }, entry.preview || ' '),
-                    h('span', { className: 'rz-row-meta', title: 'seq ' + entry.seq }, formatDateTime(entry.time)))
+                    h('span', { className: 'rz-row-meta', title: 'seq ' + entry.seq }, formatDateTime(entry.time)),
+                    h('button', { className: 'rz-row-del', type: 'button', disabled: busy,
+                        title: busy ? t('deleteBusyHint') : t('deleteOneHint', { tokens: formatNum(entry.tokens) }),
+                        'aria-label': t('deleteOne'),
+                        onClick: e => { e.stopPropagation(); if (!busy) setConfirming([entry.seq]) } }, '✕'))
                 } })),
-          detail && h(DetailModal, { detail, t, onClose: () => setDetail(null) }),
-          confirming && h(ConfirmDialog, { n: selected.size, tokens: formatNum(selectedTokens), deleting, t,
-            onCancel: () => setConfirming(false), onOk: doDelete }),
+          detail && h(DetailModal, { detail, t, total: context.totalTokens, onClose: () => setDetail(null) }),
+          confirming && confirming.length > 0 && h(ConfirmDialog, { n: confirming.length, tokens: formatNum(confirmTokens), deleting, t,
+            onCancel: () => setConfirming(null), onOk: doDelete }),
         ],
         toast && h('div', { className: 'rz-toast' }, toast))
     }
@@ -460,7 +562,7 @@ window.__ModuleLoader__.load({
     module.exports = {
       name: CLIENT_NAME,
       inject: ['slots', 'locale'],
-      __internals: { NS, ZH, EN, sortEntries, tierOf, RAZOR_TIERS, formatDateTime, entryChip },
+      __internals: { NS, ZH, EN, sortEntries, tierOf, RAZOR_TIERS, formatDateTime, entryChip, entryCategory, categoryLabel, pctOf },
       __boot(container, opts = {}) {
         ensureStyles()
         const t = opts.t || ((key, vars) => {

package/client/index.js

@@ -56,9 +56,11 @@ const ZH = {
   sortOrder: '上下文顺序',
   sortTokens: 'token 高→低',
   orderNote: '本插件不会改变上下文条目顺序，只会剔除选中条目。',
-  selectVisible: '选中可见',
-  selectVisibleHint: '选中当前显示的全部条目（配合色块筛选）',
-  clearSelect: '清空选择',
+  legendTitle: '按 token 量级筛选（点选高亮某一档）',
+  kindFilterLabel: '类型',
+  selectVisible: '全选',
+  selectVisibleHint: '全选当前可见条目（配合类型/量级筛选）',
+  clearSelect: '取消全选',
   deleteSelected: '删除选中',
   selectedStats: '已选 {n} 条 / ≈{tokens} token',
   stats: '{nodes} 条 · 合计 ≈{tokens} token{mode}',
@@ -77,6 +79,8 @@ const ZH = {
   deleteTitle: '确认裁剪',
   deleteConfirm: '即将把 {n} 条消息（约 {tokens} token）从模型视野中移除，替换为一条标记消息。日志中保留痕迹，此操作不可恢复。继续？',
   deleteBusyHint: '会话正在运行，等当前回合结束后再裁剪',
+  deleteOne: '删除此条',
+  deleteOneHint: '删除此条（约 {tokens} token）',
   deleteOk: '执行',
   cancel: '取消',
   deletedToast: '已删除 {n} 条（约 {tokens} token）',
@@ -94,9 +98,11 @@ const EN = {
   sortOrder: 'Context order',
   sortTokens: 'tokens high→low',
   orderNote: 'This plugin never reorders context entries; it only removes the selected ones.',
-  selectVisible: 'Select shown',
-  selectVisibleHint: 'Select every currently shown entry (pairs with tier filters)',
-  clearSelect: 'Clear selection',
+  legendTitle: 'Filter by token tier (click to isolate a band)',
+  kindFilterLabel: 'Type',
+  selectVisible: 'All',
+  selectVisibleHint: 'Select all currently visible entries (pairs with type/tier filters)',
+  clearSelect: 'Clear all',
   deleteSelected: 'Delete selected',
   selectedStats: '{n} selected / ≈{tokens} tokens',
   stats: '{nodes} entries · total ≈{tokens} tokens{mode}',
@@ -115,6 +121,8 @@ const EN = {
   deleteTitle: 'Confirm trim',
   deleteConfirm: 'About to remove {n} messages (≈{tokens} tokens) from the model view, replaced by one marker message. Traces stay in the log; this cannot be undone. Continue?',
   deleteBusyHint: 'Session is running — trim after the current turn finishes',
+  deleteOne: 'Delete this entry',
+  deleteOneHint: 'Delete this entry (≈{tokens} tokens)',
   deleteOk: 'Delete',
   cancel: 'Cancel',
   deletedToast: 'Deleted {n} entries (≈{tokens} tokens)',
@@ -164,6 +172,38 @@ function entryChip(entry, t) {
   return { kind: entry.kind, label: t(kindI18n(entry.kind)) }
 }
 
+/**
+ * 筛选用稳定分类键，与 entryChip 的可见口径一致：
+ *   tool  → 'tool:<工具名>'（无工具名则 'tool:'，按钮文案退回「工具」）
+ *   user 注入 → 'injected'（sourceKind !== 'user' 的 user 消息，统一一档；
+ *     细分来源在 chip 的 title 与详情里已可见，筛选层不再切分，避免按钮爆炸）
+ *   user / assistant → 自身
+ * 「按钮文案」与 chip 同源（categoryLabel），用户在两处看到的是同一个词。
+ */
+function entryCategory(entry) {
+  if (entry.kind === 'tool') return 'tool:' + (typeof entry.tool === 'string' ? entry.tool : '')
+  if (entry.kind === 'user' && entry.sourceKind && entry.sourceKind !== 'user') return 'injected'
+  return entry.kind
+}
+function categoryLabel(cat, t) {
+  if (cat === 'user') return t('kindUser')
+  if (cat === 'assistant') return t('kindAssistant')
+  if (cat === 'injected') return t('kindInjected')
+  if (cat.lastIndexOf('tool:', 0) === 0) {
+    const name = cat.slice(5)
+    return name || t('kindTool')
+  }
+  return cat
+}
+
+/** 该条 token 占全部上下文的百分比文案；total 非正或 part 为 0 返回 null（不显示）。 */
+function pctOf(part, total) {
+  if (!total || !part) return null
+  const p = part / total * 100
+  if (p < 0.1) return '<0.1%'
+  return (p >= 10 ? p.toFixed(0) : p.toFixed(1)) + '%'
+}
+
 // ── 彩虹分级：颜色越暖 = 占用越多 ────────────────────────────────────────
 // 固定对数档位（相邻约 ×2.5），跨会话语义稳定：绿→黄绿→黄→橙→红→品红。
 // 档位是「这条消息吃掉多少典型上下文预算」的粗标尺，不随会话内最大值缩放。
@@ -214,6 +254,18 @@ const STYLE = `<style>
 .rz-swatch.tier-3{background:hsl(32,80%,45%)}
 .rz-swatch.tier-4{background:hsl(8,75%,48%)}
 .rz-swatch.tier-5{background:hsl(320,65%,50%)}
+.rz-kindsbar{display:flex;gap:8px;align-items:center;flex-wrap:wrap}
+.rz-kinds{display:inline-flex;gap:4px;align-items:center;flex-wrap:wrap}
+.rz-kinds.filtering .rz-kindbtn:not(.on){opacity:.45}
+.rz-kindbtn{display:inline-flex;align-items:center;gap:5px;padding:2px 10px;border-radius:999px;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-secondary);font-size:11.5px;cursor:pointer;font-family:var(--dsw-font-family);white-space:nowrap}
+.rz-kindbtn:hover{border-color:var(--dsw-alias-border-l3);background:var(--dsw-alias-interactive-bg-hover)}
+.rz-kindbtn.on{color:var(--dsw-alias-state-business-primary);border-color:var(--dsw-alias-state-business-primary);font-weight:600}
+.rz-kindcount{font-size:10px;opacity:.7}
+.rz-thead{display:flex;gap:8px;align-items:center;flex-wrap:wrap;padding:6px 12px;border:1px solid var(--dsw-alias-border-l1);border-radius:10px;background:var(--dsw-alias-bg-layer-1)}
+.rz-thead-l{display:inline-flex;gap:8px;align-items:center;flex-wrap:wrap}
+.rz-sel-stats{color:var(--dsw-alias-label-secondary);font-size:12px;white-space:nowrap}
+.rz-col-tok{flex:0 0 62px;display:flex;justify-content:flex-end}
+.rz-col-pct{flex:0 0 44px;text-align:right;color:var(--dsw-alias-label-tertiary);font-size:11px;white-space:nowrap}
 .rz-list{display:flex;flex-direction:column;gap:6px}
 .rz-row{display:flex;gap:10px;align-items:center;padding:8px 12px;border-radius:10px;border:1px solid var(--dsw-alias-border-l1);border-left:3px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-layer-1);cursor:pointer;text-align:left;width:100%}
 .rz-row:hover{background:var(--dsw-alias-interactive-bg-hover)}
@@ -221,6 +273,9 @@ const STYLE = `<style>
 .rz-row-preview{flex:0 1 340px;min-width:100px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:var(--dsw-alias-label-primary);font-size:13px;text-decoration:none}
 .rz-row-preview:hover{text-decoration:underline;text-underline-offset:3px}
 .rz-row-meta{color:var(--dsw-alias-label-tertiary);font-size:11px;flex:none}
+.rz-row-del{display:inline-flex;align-items:center;justify-content:center;width:22px;height:22px;margin-left:4px;border-radius:6px;border:1px solid transparent;background:transparent;color:var(--dsw-alias-label-tertiary);font-size:13px;line-height:1;cursor:pointer;flex:none}
+.rz-row-del:hover:not(:disabled){color:var(--dsw-alias-state-error-primary);border-color:var(--dsw-alias-state-error-primary);background:hsla(0,75%,50%,.08)}
+.rz-row-del:disabled{opacity:.35;cursor:not-allowed}
 .rz-badge.tier-0{color:hsl(120,55%,40%);border-color:hsla(120,55%,40%,.45);background:hsla(120,55%,40%,.10)}
 .rz-badge.tier-1{color:hsl(90,60%,38%);border-color:hsla(90,60%,38%,.45);background:hsla(90,60%,38%,.10)}
 .rz-badge.tier-2{color:hsl(60,70%,36%);border-color:hsla(60,70%,36%,.45);background:hsla(60,70%,36%,.12)}
@@ -271,14 +326,16 @@ function PagedList({ items, render, t }) {
 }
 
 /** 单条全文弹窗（正文经 /entry 异步补全）。 */
-function DetailModal({ detail, t, onClose }) {
+function DetailModal({ detail, t, total, onClose }) {
   if (!detail) return null
+  const pct = pctOf(detail.tokens, total)
   return h('div', { className: 'rz-dlg-backdrop', onClick: onClose },
     h('div', { className: 'rz-dlg', onClick: e => e.stopPropagation() },
       h('h3', null, t('detailTitle') + ' · ' + t('seqLabel', { seq: detail.seq })),
       h('div', { className: 'rz-stats', style: { marginBottom: 10 } },
         h(Chip, { ...entryChip(detail, t) }),
         h(TokenBadge, { entry: detail }),
+        pct && h('span', { className: 'rz-label', title: pct + ' of ≈' + formatNum(total) + ' token' }, pct),
         h('span', { className: 'rz-label', title: 'seq ' + detail.seq }, formatDateTime(detail.time)),
         h('span', { className: 'rz-label' }, t('detailChars', { chars: formatNum(detail.chars) })),
         detail.usage && h('span', { className: 'rz-label' }, t('detailUsage', {
@@ -309,10 +366,11 @@ function RazorPage({ t, fixedSessionId }) {
   const [ctxLoading, setCtxLoading] = useState(false)
   const [error, setError] = useState(null)
   const [tierFilter, setTierFilter] = useState(() => new Set())
+  const [kindFilter, setKindFilter] = useState(() => new Set())
   const [sortBy, setSortBy] = useState('order')
   const [selected, setSelected] = useState(() => new Set())
   const [detail, setDetail] = useState(null)
-  const [confirming, setConfirming] = useState(false)
+  const [confirming, setConfirming] = useState(null) // null | number[] 待裁剪 seqs（单条/多选同源）
   const [deleting, setDeleting] = useState(false)
   const [toast, setToast] = useState(null)
   const sessionRef = useRef('')
@@ -343,16 +401,34 @@ function RazorPage({ t, fixedSessionId }) {
     if (!context) return []
     let rows = context.entries
     if (tierFilter.size > 0) rows = rows.filter(e => tierFilter.has(tierOf(e)))
+    if (kindFilter.size > 0) rows = rows.filter(e => kindFilter.has(entryCategory(e)))
     return sortEntries(rows, sortBy)
-  }, [context, tierFilter, sortBy])
+  }, [context, tierFilter, kindFilter, sortBy])
 
-  const selectedTokens = useMemo(() => {
-    if (!context) return 0
-    const bySeq = new Map(context.entries.map(e => [e.seq, e]))
+  // 当前上下文里实际出现的分类（cat/count/tokens），按条数降序——决定渲染哪些按钮。
+  const categories = useMemo(() => {
+    if (!context) return []
+    const seen = new Map()
+    for (const e of context.entries) {
+      const c = entryCategory(e)
+      const prev = seen.get(c) || { count: 0, tokens: 0 }
+      prev.count += 1
+      prev.tokens += (e.tokens || 0)
+      seen.set(c, prev)
+    }
+    return [...seen.entries()]
+      .map(([cat, v]) => ({ cat, count: v.count, tokens: v.tokens }))
+      .sort((a, b) => b.count - a.count || b.tokens - a.tokens)
+  }, [context])
+
+  const entriesBySeq = useMemo(() => context ? new Map(context.entries.map(e => [e.seq, e])) : null, [context])
+  const sumSeqs = (seqs) => {
     let sum = 0
-    for (const seq of selected) { const e = bySeq.get(seq); if (e) sum += e.tokens }
+    if (entriesBySeq) for (const seq of seqs) { const e = entriesBySeq.get(seq); if (e) sum += e.tokens || 0 }
     return sum
-  }, [context, selected])
+  }
+  const selectedTokens = useMemo(() => sumSeqs(selected), [selected, entriesBySeq])
+  const confirmTokens = useMemo(() => confirming ? sumSeqs(confirming) : 0, [confirming, entriesBySeq])
 
   const toggleRow = (seq) => setSelected(prev => {
     const next = new Set(prev)
@@ -366,6 +442,12 @@ function RazorPage({ t, fixedSessionId }) {
     else next.add(i)
     return next
   })
+  const toggleKind = (cat) => setKindFilter(prev => {
+    const next = new Set(prev)
+    if (next.has(cat)) next.delete(cat)
+    else next.add(cat)
+    return next
+  })
   const selectVisible = () => setSelected(new Set(visible.map(e => e.seq)))
 
   const openDetail = (entry) => {
@@ -376,17 +458,18 @@ function RazorPage({ t, fixedSessionId }) {
   }
 
   const doDelete = async () => {
+    if (!confirming || confirming.length === 0) return
     setDeleting(true)
     try {
-      const r = await fetch(API + '/delete', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ session: sessionId, seqs: [...selected] }) })
+      const r = await fetch(API + '/delete', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ session: sessionId, seqs: confirming }) })
       const d = await r.json().catch(() => ({}))
       if (!r.ok) throw new Error(d.error || 'HTTP ' + r.status)
-      setConfirming(false)
+      setConfirming(null)
       setSelected(new Set())
       showToast(t('deletedToast', { n: d.removed, tokens: formatNum(d.tokensRemoved) }))
       refreshAll()
     } catch (e) {
-      setConfirming(false)
+      setConfirming(null)
       setError(e.message)
     } finally { setDeleting(false) }
   }
@@ -405,40 +488,59 @@ function RazorPage({ t, fixedSessionId }) {
         h('span', { className: 'rz-legend' + (tierFilter.size > 0 ? ' filtering' : ''), title: t('legendTitle') },
           RAZOR_TIERS.map((tr, i) => h('button', { key: i, className: 'rz-swatch tier-' + i + (tierFilter.has(i) ? ' on' : ''), title: tr.label + ' token', onClick: () => toggleTier(i) }, tr.label))),
         h('span', { className: 'rz-spacer' }),
-        busy && h('span', { className: 'rz-badge' }, t('busyTag')),
-        h('button', { className: 'rz-btn', onClick: selectVisible, disabled: visible.length === 0 || busy, title: t('selectVisibleHint') },
-          t('selectVisible') + (visible.length ? ` (${visible.length})` : '')),
+        busy && h('span', { className: 'rz-badge' }, t('busyTag'))),
+      // 类型筛选：与 chip 同口径的可点选按钮（user/injected/assistant/tool:<名>），
+      // 多选 toggle，与 tier 量级筛选正交叠加。按钮带条数；hover 看 token 占比。
+      categories.length > 0 && h('div', { key: 'kinds', className: 'rz-kindsbar' },
+        h('span', { className: 'rz-label' }, t('kindFilterLabel')),
+        h('span', { className: 'rz-kinds' + (kindFilter.size > 0 ? ' filtering' : '') },
+          categories.map(({ cat, count, tokens }) =>
+            h('button', { key: cat,
+              className: 'rz-kindbtn' + (kindFilter.has(cat) ? ' on' : ''),
+              title: categoryLabel(cat, t) + ' · ' + count + ' 条 · ≈' + formatNum(tokens) + ' token'
+                + (context.totalTokens ? '（' + (pctOf(tokens, context.totalTokens) || '0%') + '）' : ''),
+              onClick: () => toggleKind(cat) },
+              categoryLabel(cat, t),
+              h('span', { className: 'rz-kindcount' }, count))))),
+      // 表头（在类型筛选下方）：左 刷新/全选，选中后追加 删除·取消全选；右 排序。
+      h('div', { key: 'thead', className: 'rz-thead' },
+        h('div', { className: 'rz-thead-l' },
+          h('button', { className: 'rz-btn', onClick: refreshAll, title: t('refresh') }, t('refresh')),
+          h('button', { className: 'rz-btn', onClick: selectVisible, disabled: visible.length === 0 || busy, title: t('selectVisibleHint') },
+            t('selectVisible') + (visible.length ? ` (${visible.length})` : '')),
+          selected.size > 0 && h('button', { className: 'rz-btn rz-btn-danger', disabled: !canDelete,
+            title: busy ? t('deleteBusyHint') : undefined,
+            onClick: () => setConfirming([...selected]) },
+            t('deleteSelected') + ` (${selected.size})`),
+          selected.size > 0 && h('button', { className: 'rz-btn', onClick: () => setSelected(new Set()) }, t('clearSelect'))),
+        h('span', { className: 'rz-spacer' }),
         h('select', { className: 'rz-select', value: sortBy, onChange: e => setSortBy(e.target.value), title: t('sortLabel'), 'aria-label': t('sortLabel') },
           h('option', { value: 'order' }, t('sortOrder')),
-          h('option', { value: 'tokens' }, t('sortTokens'))),
-        h('button', { className: 'rz-btn', onClick: refreshAll, title: t('refresh') }, t('refresh'))),
-      selected.size > 0 && h('div', { key: 'sel', className: 'rz-stats' },
-        h('span', null, t('selectedStats', { n: selected.size, tokens: formatNum(selectedTokens) })),
-        h('span', { className: 'rz-spacer' }),
-        h('div', { className: 'rz-footbtns' },
-          h('button', { className: 'rz-btn', onClick: () => setSelected(new Set()) }, t('clearSelect')),
-          h('button', { className: 'rz-btn rz-btn-danger', disabled: !canDelete,
-            title: busy ? t('deleteBusyHint') : undefined,
-            onClick: () => setConfirming(true) },
-            t('deleteSelected') + ` (${selected.size})`))),
+          h('option', { value: 'tokens' }, t('sortTokens')))),
       visible.length === 0
         ? h('div', { key: 'empty', className: 'rz-empty' }, t('emptyContext'))
         : h('div', { key: 'list', className: 'rz-list' },
             h(PagedList, { items: visible, t, render: entry => {
               const tier = tierOf(entry)
+              const pct = pctOf(entry.tokens, context.totalTokens)
               return h('div', { key: entry.seq, className: 'rz-row tier-' + tier + (selected.has(entry.seq) ? ' checked' : ''),
                   role: 'button', tabIndex: 0, onClick: () => toggleRow(entry.seq),
                   onKeyDown: e => e.key === 'Enter' && toggleRow(entry.seq) },
                 h('input', { type: 'checkbox', checked: selected.has(entry.seq), onClick: e => e.stopPropagation(), onChange: () => toggleRow(entry.seq) }),
-                h(TokenBadge, { entry }),
+                h('span', { className: 'rz-col-tok' }, h(TokenBadge, { entry })),
+                h('span', { className: 'rz-col-pct', title: pct ? pct + ' of ≈' + formatNum(context.totalTokens) + ' token' : '' }, pct || ''),
                 h(Chip, { ...entryChip(entry, t) }),
                 h('span', { className: 'rz-row-preview', title: entry.preview,
                     onClick: e => { e.stopPropagation(); openDetail(entry) } }, entry.preview || ' '),
-                h('span', { className: 'rz-row-meta', title: 'seq ' + entry.seq }, formatDateTime(entry.time)))
+                h('span', { className: 'rz-row-meta', title: 'seq ' + entry.seq }, formatDateTime(entry.time)),
+                h('button', { className: 'rz-row-del', type: 'button', disabled: busy,
+                    title: busy ? t('deleteBusyHint') : t('deleteOneHint', { tokens: formatNum(entry.tokens) }),
+                    'aria-label': t('deleteOne'),
+                    onClick: e => { e.stopPropagation(); if (!busy) setConfirming([entry.seq]) } }, '✕'))
             } })),
-      detail && h(DetailModal, { detail, t, onClose: () => setDetail(null) }),
-      confirming && h(ConfirmDialog, { n: selected.size, tokens: formatNum(selectedTokens), deleting, t,
-        onCancel: () => setConfirming(false), onOk: doDelete }),
+      detail && h(DetailModal, { detail, t, total: context.totalTokens, onClose: () => setDetail(null) }),
+      confirming && confirming.length > 0 && h(ConfirmDialog, { n: confirming.length, tokens: formatNum(confirmTokens), deleting, t,
+        onCancel: () => setConfirming(null), onOk: doDelete }),
     ],
     toast && h('div', { className: 'rz-toast' }, toast))
 }
@@ -450,7 +552,7 @@ const CLIENT_NAME = '@weibaohui/context-razor'
 module.exports = {
   name: CLIENT_NAME,
   inject: ['slots', 'locale'],
-  __internals: { NS, ZH, EN, sortEntries, tierOf, RAZOR_TIERS, formatDateTime, entryChip },
+  __internals: { NS, ZH, EN, sortEntries, tierOf, RAZOR_TIERS, formatDateTime, entryChip, entryCategory, categoryLabel, pctOf },
   __boot(container, opts = {}) {
     ensureStyles()
     const t = opts.t || ((key, vars) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weibaohui/context-razor",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "dsh 插件 · 上下文剃刀：把当前会话上下文逐条列出（角色/预览/≈token，cl100k 估算），超阈值标红，勾选后精确裁剪——不经 LLM 总结，删了什么一目了然。",
   "license": "MIT",
   "keywords": [