@zhushanwen/pi-smart-context 0.3.1 → 0.3.2

package/README.md

@@ -8,7 +8,7 @@
 - **双模式生成接管**（`session_before_compact`，覆盖工具 / `/compact` / 内建 auto 三条路径）：
   - same-model：完整原始上下文 + 会话原 system prompt + tools + 末尾追加压缩指令——前缀缓存全命中，成本≈增量指令+输出，且模型看全量上下文（质量上限最高）
   - cross-model：调用 pi 原生 `compact()` 仅换模型与凭证——split-turn / fileOps / previousSummary 原生组装
-- **3 档阈值提醒**（默认 200K/400K/600K）：`agent_settled` 越档检查，每档一次、多档合并、压缩后重置，followUp 投递；措辞是数据投递不是指令
+- **3 档阈值提醒**（默认 400K/500K/600K）：`agent_settled` 越档检查，每档一次、多档合并、压缩后重置，followUp 投递；措辞是数据投递不是指令
 - **排除模型**（精准 `provider/modelId` 匹配）：工具拒绝 + 不提醒 + 回落 pi 原生生成；切换跨界时注入一条可用性通知，downshift（切小窗模型将触线）时建议先压缩
 - **健壮性**：摘要收缩校验、max-tokens 截断 fail-closed、接管失败 3 次熔断、transcript 回查指针、压缩后最近文件内容重注入（≤5 文件/50K）、多轮压缩降智提示
 - **subagent 进程**自动静默（`PI_SUBAGENT_ROOT_SESSION_ID` 标记）
@@ -25,8 +25,6 @@
 
 行为正确性由 execute / handler 现场校验兜底，每次事件回调重新读配置（热加载，改完下一 turn 生效，无需重启）。
 
-> 设计层 why 与业界调研记录见原设计文档（已随 2026-09 docs 清理退役，git 历史可查 `docs/extensions/smart-context/design.md`）。
-
 ## 配置
 
-`<agentDir>/config/smart-context-ext-config.json`（读时热加载）。schema 与示例见 `skills/smart-context-ext-config/SKILL.md`。xyz-agent 桌面端在设置页（系统 → 智能上下文压缩）可视化配置。
+`<agentDir>/config/smart-context-ext-config.json`（读时热加载）。schema 与示例见 `skills/smart-context-ext-config/SKILL.md`。taiji 桌面端在设置页（系统 → 智能上下文压缩）可视化配置。

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@zhushanwen/pi-smart-context",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "type": "module",
   "main": "index.ts",
-  "xyz-agent": {
+  "taiji": {
     "role": "universal",
     "startupConfig": [
       {
@@ -15,8 +15,8 @@
             "ref": ""
           },
           "reminderThresholds": [
-            200000,
             400000,
+            500000,
             600000
           ],
           "excludedModels": []
@@ -36,9 +36,9 @@
     "pi-package"
   ],
   "dependencies": {
-    "@zhushanwen/pi-ext-guards": "0.4.0",
-    "@zhushanwen/pi-extension-logger": "0.6.0",
-    "@zhushanwen/pi-llm-shared": "0.8.0"
+    "@zhushanwen/pi-ext-guards": "0.4.1",
+    "@zhushanwen/pi-extension-logger": "0.6.1",
+    "@zhushanwen/pi-llm-shared": "0.8.1"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.1.9",

package/skills/smart-context-ext-config/SKILL.md

@@ -15,7 +15,7 @@ description: "配置 @zhushanwen/pi-smart-context（智能上下文压缩：agen
 
 ## 配置文件
 
-路径：`<agentDir>/config/smart-context-ext-config.json`（`<agentDir>` = `getAgentDir()`，默认 `~/.pi/agent`，xyz-agent 环境 `~/.xyz-agent/pi/agent`；`PI_CODING_AGENT_DIR` 可覆盖）。
+路径：`<agentDir>/config/smart-context-ext-config.json`（`<agentDir>` = `getAgentDir()`，默认 `~/.pi/agent`，taiji 环境 `~/.taiji/agent`；`PI_CODING_AGENT_DIR` 可覆盖）。
 
 ### Schema
 
@@ -23,7 +23,7 @@ description: "配置 @zhushanwen/pi-smart-context（智能上下文压缩：agen
 |---|---|---|---|
 | `enabled` | boolean | `true` | 总开关 |
 | `compactModel` | `{type:"ref", ref:string}` | `{type:"ref", ref:""}` | 压缩模型（完整 `provider/modelId`）。`ref` 为空 = 跟随当前会话模型（same-model 模式）；等于当前模型同样进 same-model 模式 |
-| `reminderThresholds` | `number[]` | `[200000, 400000, 600000]` | 3 档提醒阈值（token 绝对数，升序） |
+| `reminderThresholds` | `number[]` | `[400000, 500000, 600000]` | 3 档提醒阈值（token 绝对数，升序） |
 | `excludedModels` | `string[]` | `[]` | 排除模型列表，完整 `provider/modelId` 精准等值匹配（如 `"deepseek/deepseek-chat"`），不做前缀匹配 |
 
 ### 配置示例
@@ -32,7 +32,7 @@ description: "配置 @zhushanwen/pi-smart-context（智能上下文压缩：agen
 {
   "enabled": true,
   "compactModel": { "type": "ref", "ref": "xiaomi-token-plan-cn/mimo-v2.5" },
-  "reminderThresholds": [200000, 400000, 600000],
+  "reminderThresholds": [400000, 500000, 600000],
   "excludedModels": ["deepseek/deepseek-chat"]
 }
 ```
@@ -52,5 +52,5 @@ description: "配置 @zhushanwen/pi-smart-context（智能上下文压缩：agen
 - 压缩回退当前模型：`compactModel.ref` 指向的模型不可用（无凭证/已删）——换可用模型或留空
 - 工具调用被拒「已禁用」/「已排除」：检查 `enabled` 与 `excludedModels`
 - 提醒未出现：`getContextUsage().tokens` 在压缩后首个响应前为 null，属正常（下轮恢复）
-- 连续接管失败 3 次后不再接管：本会话熔断保护，查看 `XYZ_AGENT_DEBUG=1` 日志定位失败原因
-- 调试：`XYZ_AGENT_DEBUG=1` 后看 `[smart-context]` 前缀日志（`~/.pi/agent/logs/`）
+- 连续接管失败 3 次后不再接管：本会话熔断保护，查看 `TAIJI_AGENT_DEBUG=1` 日志定位失败原因
+- 调试：`TAIJI_AGENT_DEBUG=1` 后看 `[smart-context]` 前缀日志（`~/.pi/agent/logs/`）

package/src/__tests__/pure.test.ts

@@ -22,7 +22,7 @@ describe("normalizeSmartContextConfig", () => {
 	it("非对象输入回退默认值", () => {
 		const c = normalizeSmartContextConfig(null);
 		expect(c).toEqual(DEFAULT_SMART_CONTEXT_CONFIG);
-		expect(c.reminderThresholds).toEqual([200_000, 400_000, 600_000]);
+		expect(c.reminderThresholds).toEqual([400_000, 500_000, 600_000]);
 	});
 
 	it("阈值过滤非正数并升序、截 3 档；空数组回退默认", () => {
@@ -30,7 +30,7 @@ describe("normalizeSmartContextConfig", () => {
 		expect(c.reminderThresholds).toEqual([100_000, 200_000, 300_000]);
 
 		const c2 = normalizeSmartContextConfig({ reminderThresholds: [] });
-		expect(c2.reminderThresholds).toEqual([200_000, 400_000, 600_000]);
+		expect(c2.reminderThresholds).toEqual([400_000, 500_000, 600_000]);
 	});
 
 	it("excludedModels 只留含 / 的字符串条目并去重（精准匹配要求完整 provider/modelId）", () => {

package/src/__tests__/startup-config-declaration.test.ts

@@ -1,5 +1,5 @@
 /**
- * startupConfig 声明守护测试：断言 package.json `xyz-agent.startupConfig` 声明的
+ * startupConfig 声明守护测试：断言 package.json `taiji.startupConfig` 声明的
  * content 与代码 DEFAULT_SMART_CONTEXT_CONFIG 常量深相等，防止两侧任一改动未同步（漂移）。
  * 机制：runtime 启动序列统一 ensure（extension-startup-config.ts），声明即首建内容。
  *
@@ -13,7 +13,7 @@ import { describe, expect, it } from "vitest";
 
 import { DEFAULT_SMART_CONTEXT_CONFIG } from "../pure.js";
 
-/** package.json `xyz-agent.startupConfig` 声明条目的最小形状（守护断言用）。 */
+/** package.json `taiji.startupConfig` 声明条目的最小形状（守护断言用）。 */
 interface StartupConfigEntry {
 	path: string;
 	content: unknown;
@@ -21,11 +21,11 @@ interface StartupConfigEntry {
 
 const pkg = JSON.parse(
 	readFileSync(join(fileURLToPath(import.meta.url), "../../../package.json"), "utf-8"),
-) as { "xyz-agent"?: { startupConfig?: StartupConfigEntry[] } };
+) as { "taiji"?: { startupConfig?: StartupConfigEntry[] } };
 
 describe("startupConfig 声明守护", () => {
 	it("声明 content 与代码 DEFAULT_SMART_CONTEXT_CONFIG 深相等", () => {
-		const entry = pkg["xyz-agent"]?.startupConfig?.find(
+		const entry = pkg["taiji"]?.startupConfig?.find(
 			(e: StartupConfigEntry) => e.path === "config/smart-context-ext-config.json",
 		);
 		expect(entry).toBeDefined();

package/src/__tests__/tool.test.ts

@@ -38,7 +38,7 @@ function makePi(): { pi: ExtensionAPI & { sendUserMessage: ReturnType<typeof vi.
 function makeCtx(compactImpl?: (options: CompactOpts) => void): ExtensionContext {
 	return {
 		model: { provider: "zai", id: "glm" },
-		getContextUsage: () => ({ tokens: 250_000, contextWindow: 1_000_000 }),
+		getContextUsage: () => ({ tokens: 450_000, contextWindow: 1_000_000 }),
 		sessionManager: { getEntries: () => [] },
 		compact: compactImpl ?? ((options: CompactOpts) => {
 			options.onComplete({

package/src/compact-handler.ts

@@ -58,7 +58,7 @@ export function createTakeoverState(): TakeoverState {
 /** 统一 logger（@zhushanwen/pi-extension-logger：debug 文件日志 / warn 走 appendEntry 持久化）。 */
 const logger = createLogger("smart-context");
 
-/** 开发调试日志（XYZ_AGENT_DEBUG=1 时写文件，默认 no-op；logging-conventions 统一通道）。 */
+/** 开发调试日志（TAIJI_AGENT_DEBUG=1 时写文件，默认 no-op；logging-conventions 统一通道）。 */
 export function debugLog(message: string): void {
 	logger.debug(message);
 }

package/src/index.ts

@@ -1,7 +1,6 @@
 /**
  * @zhushanwen/pi-smart-context 入口：事件接线 + 门控。
  *
- * 设计文档：docs/extensions/smart-context/design.md
  * - session_start：session 级闭包状态重建（规范 Session 隔离：fired 档位/熔断计数不跨 session）
  * - subagent 进程（R6）：不注册工具、不提醒（宁缺勿污）
  * - session_before_compact：双模式接管（compact-handler）
@@ -62,7 +61,7 @@ export default function smartContextExtension(pi: ExtensionAPI): void {
 	// 日志通道注入（extension-logger 两阶段初始化：工厂拿 pi → setPiHandle）
 	setPiHandle(pi);
 
-	// R6：subagent 子进程不注册工具、不提醒（宁缺勿污；XYZ_AGENT_SUBAGENT 标记——
+	// R6：subagent 子进程不注册工具、不提醒（宁缺勿污；TAIJI_AGENT_SUBAGENT 标记——
 	// ext-guards isSubagentProcess，ext-simplify-17 D4 重锚）
 	if (isSubagentProcess()) {
 		debugLog("subagent process detected, staying inert");

package/src/pure.ts

@@ -2,7 +2,6 @@
  * 纯函数层：配置 schema / 加载 / 门控判定 / 阈值检查 / 摘要后处理。
  *
  * 无副作用（fs 读取经 llm-shared loadConfig 的缓存封装），全部可单测。
- * 设计文档：docs/extensions/smart-context/design.md（D5 门控矩阵 / D6 阈值保护 / D8 配置 schema）。
  */
 
 import { estimateTokens } from "@earendil-works/pi-coding-agent";
@@ -19,9 +18,9 @@ export const CHARS_PER_TOKEN_ESTIMATE = 4;
 /** 提醒阈值最大档数（3 档）。 */
 const MAX_THRESHOLD_TIERS = 3;
 
-/** 3 档提醒阈值默认值（token 绝对数）：200K / 400K / 600K。 */
-const DEFAULT_REMINDER_THRESHOLD_TIER_1_TOKENS = 200_000;
-const DEFAULT_REMINDER_THRESHOLD_TIER_2_TOKENS = 400_000;
+/** 3 档提醒阈值默认值（token 绝对数）：400K / 500K / 600K。 */
+const DEFAULT_REMINDER_THRESHOLD_TIER_1_TOKENS = 400_000;
+const DEFAULT_REMINDER_THRESHOLD_TIER_2_TOKENS = 500_000;
 const DEFAULT_REMINDER_THRESHOLD_TIER_3_TOKENS = 600_000;
 const DEFAULT_REMINDER_THRESHOLDS: readonly number[] = [
 	DEFAULT_REMINDER_THRESHOLD_TIER_1_TOKENS,

package/src/tool.ts

@@ -145,8 +145,8 @@ export function registerCompactContextTool(
 			const config = loadSmartContextConfig();
 			if (!gating.active) {
 				const reason = config.enabled
-					? `当前模型 ${gating.modelId} 已配置为排除（smart-context excludedModels），压缩工具不可用。可在 xyz-agent 设置页或 smart-context-ext-config skill 中调整。`
-					: `smart-context 已禁用。可在 xyz-agent 设置页开启，或经 smart-context-ext-config skill 修改配置。`;
+					? `当前模型 ${gating.modelId} 已配置为排除（smart-context excludedModels），压缩工具不可用。可在 taiji 设置页或 smart-context-ext-config skill 中调整。`
+					: `smart-context 已禁用。可在 taiji 设置页开启，或经 smart-context-ext-config skill 修改配置。`;
 				throw new Error(reason);
 			}
 
@@ -185,7 +185,7 @@ export function registerCompactContextTool(
 							: "未知";
 						const showHint = compactionCount + 1 >= DEGRADATION_HINT_MIN_COMPACTIONS;
 						const lines = [
-							`[smart-context] 压缩完成。模式：${resultMode}${fellBack ? "（压缩模型不可用，已回退当前模型——请检查配置：xyz-agent 设置页或 smart-context-ext-config skill）" : ""}。`,
+							`[smart-context] 压缩完成。模式：${resultMode}${fellBack ? "（压缩模型不可用，已回退当前模型——请检查配置：taiji 设置页或 smart-context-ext-config skill）" : ""}。`,
 							`压缩前 ${formatK(result.tokensBefore ?? 0)} tokens → 压缩后约 ${formatK(result.estimatedTokensAfter ?? 0)} tokens；摘要生成成本：${cost}。`,
 							showHint ? buildDegradationHintLine() : "",
 						].filter((l) => l !== "");

package/vitest.config.ts

@@ -1,9 +1,7 @@
-import { defineConfig } from "vitest/config";
+import { taijiTestConfig } from "../../../test-guard/factory.ts"
 
-export default defineConfig({
+export default taijiTestConfig({
   test: {
-    reporters: ["default", "junit"],
-    outputFile: { junit: "./test-results/vitest-junit.xml" },
     include: ["src/__tests__/**/*.test.ts"],
   },
 });