@weibaohui/context-razor 0.2.0 → 0.3.0

package/README.md

@@ -12,6 +12,7 @@
 - **逐条列出**：当前会话模型可见的每条上下文（用户/助手/工具结果）按序排列，带预览、字符数与 ≈token 估算，点 ⋯ 查看全文与真实 usage
 - **超阈值标红**：可调阈值（默认 500 token，本地记忆），超限条目红色高亮；「只看超阈值」过滤 + 「token 高→低」排序，大头一眼可见
 - **精确裁剪**：勾选任意条目一键删除——连续段自动合并处理。删除走宿主 surface replace 协议（与官方 compaction 同款机制），**不经 LLM 总结**，删了什么、删了多少完全由你决定
+- **不重排**：本插件不会改变上下文条目顺序，只会剔除选中条目；排序下拉仅影响页面显示（上下文顺序 / 原始序号 / token 高→低），模型可见顺序始终由会话 surface 决定
 - **安全护栏**：会话运行中禁止裁剪（等当前回合结束）；每次替换附带一条 notice 标记消息，模型知道这段历史被你移除了，需要时会主动向你确认
 - **非破坏**：append-only 日志保留全部痕迹（宿主机制如此）。「删除」= 从模型视野与界面投影中移除
 

package/client/bundle.js

@@ -64,7 +64,9 @@ window.__ModuleLoader__.load({
       busyTag: '运行中',
       sortLabel: '排序',
       sortOrder: '上下文顺序',
+      sortSeq: '原始序号',
       sortTokens: 'token 高→低',
+      orderNote: '本插件不会改变上下文条目顺序，只会剔除选中条目。',
       selectVisible: '选中可见',
       selectVisibleHint: '选中当前显示的全部条目（配合色块筛选）',
       clearSelect: '清空选择',
@@ -101,7 +103,9 @@ window.__ModuleLoader__.load({
       busyTag: 'running',
       sortLabel: 'Sort',
       sortOrder: 'Context order',
+      sortSeq: 'Original seq',
       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',
@@ -137,8 +141,9 @@ window.__ModuleLoader__.load({
 
     const kindI18n = (key) => 'kind' + key[0].toUpperCase() + key.slice(1)
 
-    /** 排序：order = 投影原序；tokens = 降序（并列按 seq，缺 token 沉底）。 */
+    /** 排序：order = 投影原序（模型可见序）；seq = 原始序号升序（裁剪过的会话里与 order 不同：标记消息 seq 大但在中间）；tokens = 降序（并列按 seq，缺 token 沉底）。 */
     function sortEntries(entries, sortBy) {
+      if (sortBy === 'seq') return [...entries].sort((a, b) => a.seq - b.seq)
       if (sortBy !== 'tokens') return entries
       return [...entries].sort((a, b) => {
         const va = a.tokens, vb = b.tokens
@@ -405,6 +410,7 @@ window.__ModuleLoader__.load({
         !sessionId && h('div', { className: 'rz-empty' }, t('pickSession')),
         sessionId && ctxLoading && h('div', { className: 'rz-loading' }, t('loading')),
         sessionId && !ctxLoading && context && [
+          h('div', { key: 'note', className: 'rz-hint' }, t('orderNote')),
           h('div', { key: 'bar', className: 'rz-stats' },
             h('span', null, t('stats', { nodes: context.nodes, tokens: formatNum(context.totalTokens), mode: context.encoder === 'heuristic' ? t('modeHeuristic') : '' })),
             h('span', { className: 'rz-legend' + (tierFilter.size > 0 ? ' filtering' : ''), title: t('legendTitle') },
@@ -415,6 +421,7 @@ window.__ModuleLoader__.load({
               t('selectVisible') + (visible.length ? ` (${visible.length})` : '')),
             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: 'seq' }, t('sortSeq')),
               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' },

package/client/index.js

@@ -54,7 +54,9 @@ const ZH = {
   busyTag: '运行中',
   sortLabel: '排序',
   sortOrder: '上下文顺序',
+  sortSeq: '原始序号',
   sortTokens: 'token 高→低',
+  orderNote: '本插件不会改变上下文条目顺序，只会剔除选中条目。',
   selectVisible: '选中可见',
   selectVisibleHint: '选中当前显示的全部条目（配合色块筛选）',
   clearSelect: '清空选择',
@@ -91,7 +93,9 @@ const EN = {
   busyTag: 'running',
   sortLabel: 'Sort',
   sortOrder: 'Context order',
+  sortSeq: 'Original seq',
   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',
@@ -127,8 +131,9 @@ const PAGE_SIZE = 150
 
 const kindI18n = (key) => 'kind' + key[0].toUpperCase() + key.slice(1)
 
-/** 排序：order = 投影原序；tokens = 降序（并列按 seq，缺 token 沉底）。 */
+/** 排序：order = 投影原序（模型可见序）；seq = 原始序号升序（裁剪过的会话里与 order 不同：标记消息 seq 大但在中间）；tokens = 降序（并列按 seq，缺 token 沉底）。 */
 function sortEntries(entries, sortBy) {
+  if (sortBy === 'seq') return [...entries].sort((a, b) => a.seq - b.seq)
   if (sortBy !== 'tokens') return entries
   return [...entries].sort((a, b) => {
     const va = a.tokens, vb = b.tokens
@@ -395,6 +400,7 @@ function RazorPage({ t, fixedSessionId }) {
     !sessionId && h('div', { className: 'rz-empty' }, t('pickSession')),
     sessionId && ctxLoading && h('div', { className: 'rz-loading' }, t('loading')),
     sessionId && !ctxLoading && context && [
+      h('div', { key: 'note', className: 'rz-hint' }, t('orderNote')),
       h('div', { key: 'bar', className: 'rz-stats' },
         h('span', null, t('stats', { nodes: context.nodes, tokens: formatNum(context.totalTokens), mode: context.encoder === 'heuristic' ? t('modeHeuristic') : '' })),
         h('span', { className: 'rz-legend' + (tierFilter.size > 0 ? ' filtering' : ''), title: t('legendTitle') },
@@ -405,6 +411,7 @@ function RazorPage({ t, fixedSessionId }) {
           t('selectVisible') + (visible.length ? ` (${visible.length})` : '')),
         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: 'seq' }, t('sortSeq')),
           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' },

package/package.json

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