diff --git a/docs/context-runtime-local-dev.md b/docs/context-runtime-local-dev.md
index 0c103a9..8ad2884 100644
--- a/docs/context-runtime-local-dev.md
+++ b/docs/context-runtime-local-dev.md
@@ -24,6 +24,21 @@ MEMIND_ZVEC_WORKSPACE_MODE=shadow
 HEADROOM_OUTPUT_SHAPER=0
 ```
 
+**混合晋升（逐项 active）**：shadow 证据足够后，每次只改一个开关，例如：
+
+```bash
+MEMIND_MCP_COMPACT_MODE=active   # 其余保持 shadow
+```
+
+验证：
+
+```bash
+node scripts/check-mcp-compactor-local.mjs
+node scripts/check-mcp-compact-active-local.mjs
+```
+
+active 时 `tkmind-search` / `tkmind-excel` MCP 会暴露 `ctx_fetch`，大 payload 会被压缩为 handle。
+
 Bundle 常量见 `context-runtime-profile.mjs` → `CONTEXT_RUNTIME_SHADOW_ENV`。
 
 ## 离线事件形状预览
@@ -56,6 +71,7 @@ node scripts/check-zvec-workspace-local.mjs
 
 # MCP compactor shadow/active 逻辑
 node scripts/check-mcp-compactor-local.mjs
+node scripts/check-mcp-compact-active-local.mjs
 
 # codebase-memory-mcp CLI + Memind 索引（见 docs/codebase-memory-mcp-local.md）
 node scripts/check-codebase-memory-mcp-local.mjs
diff --git a/scripts/check-mcp-compact-active-local.mjs b/scripts/check-mcp-compact-active-local.mjs
new file mode 100644
index 0000000..0b46b0a
--- /dev/null
+++ b/scripts/check-mcp-compact-active-local.mjs
@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * Verify MCP compactor active promotion on this machine.
+ * Requires MEMIND_MCP_COMPACT_MODE=active in the environment (e.g. .env.local).
+ */
+import {
+  isMcpCompactActive,
+  resolveMcpCompactMode,
+} from '../mcp-result-compactor.mjs';
+
+const mode = resolveMcpCompactMode(process.env);
+console.log('MCP_COMPACT_ACTIVE_PROBE:');
+console.log(`  mode=${mode}`);
+console.log(`  active=${isMcpCompactActive(process.env)}`);
+
+if (mode !== 'active' || !isMcpCompactActive(process.env)) {
+  console.error('MCP_COMPACT_ACTIVE_FAIL: set MEMIND_MCP_COMPACT_MODE=active and restart Portal/MCP');
+  process.exit(1);
+}
+
+console.log('MCP_COMPACT_ACTIVE_OK');