@eddyskywalker/dsh-chatgpt-subscription 0.49.0 → 0.50.0

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 ## Unreleased
 
+## 0.50.0 - 2026-11-01
+
+- **[subagent] 优化子代理卡片的布局、间距与状态呈现**
+  - 调整 `SubagentCard` 的结构和样式，使子代理运行状态与结果信息在有限空间内更易读取。
+
+- **[kimi-code] 扩展缓存投影、标题请求隔离与冷启动单飞**
+  - 扩大可结构化提取的工具结果投影覆盖，支持复合 JSON 信封、spill 全文恢复和带引用的精确补读，减少大结果反复进入上下文。
+  - 标题请求不再发送主会话 cache key，也不写入主会话用量、活动时间、漂移归因或 warmup 状态。
+  - 新增按 region/model/system/tools 分组的冷启动单飞：leader 到响应头即释放 follower，2xx 才记 warm；跟随请求有界等待，失败立即放行。
+
+- **[kimi-code] 修复缓存投影与并发恢复边界**
+  - 复合信封中的源码、契约和混合证据恢复逐字保留；spill 解析支持图片省略段和未知字节数。
+  - 工具结果包含标题提示词时不再误判为标题请求；标题请求也不会清除主会话的图片 offload 归因。
+  - 悬挂 leader 超过等待预算后允许重选，旧 leader 的身份守卫避免误删新槽位。
+
+- **[kimi-code] 新增主代理缓存等待策略：工作优先、空闲计时、自然续热、冷恢复兜底**
+  - 新增宿主侧 `KimiCacheWaitController`，通过持久会话事件识别主代理回合与子代理目录，仅在主代理 idle 且仍有未完成任务时启动等待；从主代理最后一次成功模型活动计算约 25 分钟缓存窗口，不把工具运行或子代理启动时间误当作续热。
+  - 自然阶段报告和完成通知沿用现有宿主消息通道，由正常主代理模型回合完成续热；没有检查点时不催促、不打断子代理，也不要求周期报告。主代理可继续审查结果或推进不重叠的并行模块。
+  - 默认不发送主动保活请求。大上下文部署可通过 `DSH_KIMI_CODE_CACHE_WAIT_WARMUP=1` 选择启用每个委托批次最多一次轻量预热；预热消息经 `createUserMessage` 构建，失败不重试，缓存已过期时直接走普通冷恢复。
+  - `test/kimi-code-cache-wait.test.ts` 以假时钟覆盖工作/等待转换、活动时间重置、默认冷路径、单次预热、重复目录事件、完成取消、失败降级和 DSH 持久消息边界。
+
 ## 0.49.0 - 2026-10-31
 
 - **[kimi-code] 图片预算对齐原生 `kimi-cli`（20 MiB 高水位 / 10 MiB 低水位）并实现会话级粘性淘汰（Closes #79）**

package/README.md

@@ -149,7 +149,8 @@
   - 真正决定命中率的是**内容稳定性**：同一会话内 `system` 或工具列表一旦变化会使整个前缀缓存失效（实测归零）。因此应保持工具集合稳定、把新增内容追加在末尾；
   - 卡片会显示滚动命中率，方便验证效果；
   - **本线路不发送任何缓存时长字段**，缓存写入与存活完全由服务端决定。这不是省略，而是唯一有依据的选择：5m / 1h 两档只写在 **Moonshot 开放平台**文档里，Kimi Code 订阅端点没有任何缓存 TTL 的文档，官方 CLI 2.0.0 的代码路径里也不存在 `prompt_cache_options`（只有 `prompt_cache_key`）；[MoonshotAI/kimi-code#3942](https://github.com/MoonshotAI/kimi-code/issues/3942) 专门请求暴露该档位并附带问了一句「如果 coding 端点不认这个字段，请明确写出来」，至今 open、零回应。此前设置页提供的 5m / 1h 选择因此已**撤除**；
-  - **缓存过期提示按 30 分钟判定**（`cache-hint.ts` 的 `CACHE_TTL_MS`）。此前该阈值取的是 `5m` 档位的**名字**（5 分钟），在实测能热 25 分钟的端点上，从第 6 分钟起就开始误报、误报窗口长达 19 分钟 —— 恰好违反本模块自己写下的「宁漏报不误报，误报会训练用户忽略提示」。现在取首个多数副本已失效的年龄，代价是真正过期后最长晚 5 分钟才提示；
+  - **缓存过期提示按 25 分钟判定**（`cache-hint.ts` 的 `CACHE_TTL_MS`）。此前该阈值取的是 `5m` 档位的**名字**（5 分钟），在实测能热 25 分钟的端点上，从第 6 分钟起就开始误报、误报窗口长达 19 分钟 —— 恰好违反本模块自己写下的「宁漏报不误报，误报会训练用户忽略提示」。现在取全部副本仍保持命中的最后一个实测年龄，尽早提示而不声称服务端保证该 TTL；
+  - **主代理缓存等待策略与子代理工作解耦**：主代理有独立工作或并行模块可推进时正常工作，只有回合结束且仍有未完成的子代理时才进入 `IDLE_WAIT`，并从主代理最后一次成功模型活动起计算等待（而不是从子代理启动起算）。自然报告和完成通知通过正常主代理回合续热；没有现成检查点时不催促、不打断子代理，默认接受之后的一次冷恢复。连续约 20 分钟没有模型活动后，大上下文部署可用 `DSH_KIMI_CODE_CACHE_WAIT_WARMUP=1` 显式允许**每个委托批次最多一次**轻量预热；小上下文、非 Kimi 会话、预热失败和 TTL 已过期都不尝试，避免形成周期性保活。子代理结果始终经宿主消息通道返回，不依赖主代理缓存是否有效；
   - 设置卡的缓存区块把**写入**单独列成一行（总量 + 5 分钟档 + 1 小时档）：写入是独立计费项，折进「新处理 tokens」会让命中率说错话；某个分档是 0 时照实显示 0——响应头缺失只表示服务端没回报该档，不等于那里确实没写。注意这两个分档响应头同样只有开放平台文档背书，订阅端点尚无实测样本，恒为 0 时不要读成「确实没写入」；
 - **视频输入可用**（`k3`、`kimi-for-coding`、`k3.1-pro`）：
   - DSH 的模态词表只有 `text`/`image`，但它是可合并扩展的接口，本插件用 TypeScript 模块增强把它扩到 `video`（**未改动 DSH 任何代码**），因此视频走 DSH 真实的能力通道，而不是只能显示在提示里；

package/lib/client.js

@@ -57420,26 +57420,10 @@ window.__ModuleLoader__.load({
 								className: "dsh-subagent-selection",
 								"data-dsh-part": "subagent-target",
 								children: [
-									/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("fieldset", {
 										className: "dsh-subagent-target-bar",
 										children: [
-											/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-												className: "dsh-subagent-target-header",
-												children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("label", {
-													className: "dsh-subagent-target-label",
-													htmlFor: mainModelId,
-													children: t("subagentMainModelLabel")
-												}), activeModelKey !== "default" && state.activeTargetOverridden ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-													type: "button",
-													className: "dsh-subagent-reset",
-													"data-dsh-part": "subagent-reset-to-global",
-													disabled,
-													onClick: () => {
-														props.resetActiveTarget();
-													},
-													children: t("subagentResetToGlobal")
-												}) : null]
-											}),
+											/* @__PURE__ */ (0, react_jsx_runtime.jsx)("legend", { children: t("subagentMainModelLabel") }),
 											/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
 												id: mainModelId,
 												className: "dsh-subagent-select",
@@ -57497,10 +57481,10 @@ window.__ModuleLoader__.load({
 													children: mainModelName(key) + " (" + String(state.overridesByMainModel[key]?.length ?? 0) + ")"
 												}, key))]
 											}),
-											/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+											/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 												className: "dsh-subagent-status",
 												"data-dsh-part": "subagent-target-status",
-												children: activeModelKey === "default" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+												children: [activeModelKey === "default" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 													className: "dsh-subagent-hint",
 													children: t("subagentTargetGlobalHint")
 												}) : state.activeTargetOverridden ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
@@ -57509,7 +57493,16 @@ window.__ModuleLoader__.load({
 												}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 													className: "dsh-subagent-hint",
 													children: t("subagentTargetFollowGlobalStatus")
-												})
+												}), activeModelKey !== "default" && state.activeTargetOverridden ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+													type: "button",
+													className: "dsh-subagent-reset",
+													"data-dsh-part": "subagent-reset-to-global",
+													disabled,
+													onClick: () => {
+														props.resetActiveTarget();
+													},
+													children: t("subagentResetToGlobal")
+												}) : null]
 											})
 										]
 									}),
@@ -58177,26 +58170,19 @@ window.__ModuleLoader__.load({
 
 .dsh-subagent-target-bar {
   display: grid;
+  align-content: start;
   gap: 8px;
-  padding: 12px;
+  min-width: 0;
+  margin: 0;
+  padding: 10px;
   border: 0.5px solid var(--dsw-alias-border-l4);
   border-radius: var(--dsw-radius-lg, 10px);
-  background: var(--dsw-alias-bg-layer-2, transparent);
-  min-width: 0;
-}
-
-.dsh-subagent-target-header {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: 8px;
-  min-width: 0;
+  background: transparent;
 }
 
-.dsh-subagent-target-label {
+.dsh-subagent-target-bar > legend {
+  padding: 0 4px;
   font-size: 12px;
-  font-weight: 500;
-  line-height: 1.5;
   color: var(--dsw-alias-label-secondary);
 }
 
@@ -58204,9 +58190,9 @@ window.__ModuleLoader__.load({
   height: 34px;
   width: 100%;
   padding: 0 10px;
-  border: 0.5px solid var(--dsw-alias-border-l4);
+  border: 0.5px solid var(--dsw-alias-border-l3);
   border-radius: var(--dsw-radius-md, 8px);
-  background: var(--dsw-alias-bg-layer-3);
+  background: var(--dsw-alias-bg-layer-1, transparent);
   color: var(--dsw-alias-label-primary);
   font: inherit;
   font-size: 13px;
@@ -58215,9 +58201,16 @@ window.__ModuleLoader__.load({
   cursor: pointer;
 }
 
+@media (hover: hover) {
+  .dsh-subagent-select:hover:not(:disabled) {
+    border-color: var(--dsw-alias-border-l4);
+    background: var(--dsw-alias-bg-layer-2);
+  }
+}
+
 .dsh-subagent-select option,
 .dsh-subagent-select optgroup {
-  background: var(--dsw-alias-bg-layer-3, #1e1e1e);
+  background: var(--dsw-alias-bg-layer-2, #1e1e1e);
   color: var(--dsw-alias-label-primary, #e5e5e5);
 }
 
@@ -58243,7 +58236,7 @@ window.__ModuleLoader__.load({
   padding: 3px 10px;
   border: 0.5px solid var(--dsw-alias-border-l3);
   border-radius: 999px;
-  background: var(--dsw-alias-bg-layer-3);
+  background: transparent;
   color: var(--dsw-alias-label-secondary);
   font: inherit;
   font-size: 12px;
@@ -58251,6 +58244,13 @@ window.__ModuleLoader__.load({
   cursor: pointer;
 }
 
+@media (hover: hover) {
+  .dsh-subagent-chip:hover:not(:disabled):not([aria-pressed='true']) {
+    background: var(--dsw-alias-bg-layer-4);
+    color: var(--dsw-alias-label-primary);
+  }
+}
+
 .dsh-subagent-chip[aria-pressed='true'] {
   border-color: var(--dsw-alias-brand-primary, #e06c3b);
   background: color-mix(in srgb, var(--dsw-alias-brand-primary, #e06c3b) 15%, transparent);
@@ -58270,13 +58270,15 @@ window.__ModuleLoader__.load({
   justify-content: space-between;
   gap: 8px;
   min-width: 0;
+  padding-top: 6px;
+  border-top: 0.5px solid var(--dsw-alias-border-l3);
 }
 
 .dsh-subagent-reset {
-  padding: 3px 10px;
-  border: 0.5px solid var(--dsw-alias-border-l4);
-  border-radius: var(--dsw-radius-md, 8px);
-  background: var(--dsw-alias-bg-layer-3);
+  padding: 2px 8px;
+  border: 0.5px solid var(--dsw-alias-border-l3);
+  border-radius: var(--dsw-radius-sm, 6px);
+  background: transparent;
   color: var(--dsw-alias-label-secondary);
   font: inherit;
   font-size: 12px;