@weibaohui/context-razor 0.2.0 → 0.4.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

@@ -65,6 +65,7 @@ window.__ModuleLoader__.load({
       sortLabel: '排序',
       sortOrder: '上下文顺序',
       sortTokens: 'token 高→低',
+      orderNote: '本插件不会改变上下文条目顺序，只会剔除选中条目。',
       selectVisible: '选中可见',
       selectVisibleHint: '选中当前显示的全部条目（配合色块筛选）',
       clearSelect: '清空选择',
@@ -102,6 +103,7 @@ window.__ModuleLoader__.load({
       sortLabel: 'Sort',
       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',
@@ -137,7 +139,9 @@ window.__ModuleLoader__.load({
 
     const kindI18n = (key) => 'kind' + key[0].toUpperCase() + key.slice(1)
 
-    /** 排序：order = 投影原序；tokens = 降序（并列按 seq，缺 token 沉底）。 */
+    /** 排序：order = 投影原序（模型可见序）；tokens = 降序（并列按 seq，缺 token 沉底）。
+     *  只有两档且都是显示层——裁剪过的会话里 seq 升序 ≠ 模型可见序（replace 标记 seq 大但位置在中间），
+     *  与「本页展示模型可见上下文」相悖，故不提供 seq 档。 */
     function sortEntries(entries, sortBy) {
       if (sortBy !== 'tokens') return entries
       return [...entries].sort((a, b) => {
@@ -405,6 +409,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') },

package/client/index.js

@@ -55,6 +55,7 @@ const ZH = {
   sortLabel: '排序',
   sortOrder: '上下文顺序',
   sortTokens: 'token 高→低',
+  orderNote: '本插件不会改变上下文条目顺序，只会剔除选中条目。',
   selectVisible: '选中可见',
   selectVisibleHint: '选中当前显示的全部条目（配合色块筛选）',
   clearSelect: '清空选择',
@@ -92,6 +93,7 @@ const EN = {
   sortLabel: 'Sort',
   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',
@@ -127,7 +129,9 @@ const PAGE_SIZE = 150
 
 const kindI18n = (key) => 'kind' + key[0].toUpperCase() + key.slice(1)
 
-/** 排序：order = 投影原序；tokens = 降序（并列按 seq，缺 token 沉底）。 */
+/** 排序：order = 投影原序（模型可见序）；tokens = 降序（并列按 seq，缺 token 沉底）。
+ *  只有两档且都是显示层——裁剪过的会话里 seq 升序 ≠ 模型可见序（replace 标记 seq 大但位置在中间），
+ *  与「本页展示模型可见上下文」相悖，故不提供 seq 档。 */
 function sortEntries(entries, sortBy) {
   if (sortBy !== 'tokens') return entries
   return [...entries].sort((a, b) => {
@@ -395,6 +399,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') },

package/package.json

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