dsh-plugin-om 0.0.58 → 0.0.60

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (45) hide show
  1. package/README.md +40 -23
  2. package/dist/client/OmConfigCard.d.ts.map +1 -1
  3. package/dist/client/OmWarningCard.d.ts +1 -2
  4. package/dist/client/OmWarningCard.d.ts.map +1 -1
  5. package/dist/client/definition.d.ts +3 -3
  6. package/dist/client/locales.d.ts +3 -5
  7. package/dist/client/locales.d.ts.map +1 -1
  8. package/dist/client/om-config-controller.d.ts +13 -16
  9. package/dist/client/om-config-controller.d.ts.map +1 -1
  10. package/dist/client.js +41 -50
  11. package/dist/client.js.map +1 -1
  12. package/dist/compress-loop.d.ts +12 -8
  13. package/dist/compress-loop.d.ts.map +1 -1
  14. package/dist/compress-tools.d.ts +18 -2
  15. package/dist/compress-tools.d.ts.map +1 -1
  16. package/dist/compress-view.d.ts +37 -4
  17. package/dist/compress-view.d.ts.map +1 -1
  18. package/dist/compress.d.ts +46 -27
  19. package/dist/compress.d.ts.map +1 -1
  20. package/dist/config.d.ts +2 -6
  21. package/dist/config.d.ts.map +1 -1
  22. package/dist/constants.d.ts +16 -2
  23. package/dist/constants.d.ts.map +1 -1
  24. package/dist/degrade.d.ts.map +1 -1
  25. package/dist/index.d.ts.map +1 -1
  26. package/dist/index.mjs +1369 -876
  27. package/dist/om-event-append.d.ts +5 -0
  28. package/dist/om-event-append.d.ts.map +1 -0
  29. package/dist/om-event.d.ts +16 -17
  30. package/dist/om-event.d.ts.map +1 -1
  31. package/dist/precompress.d.ts +1 -1
  32. package/dist/precompress.d.ts.map +1 -1
  33. package/dist/recall.d.ts +12 -20
  34. package/dist/recall.d.ts.map +1 -1
  35. package/dist/recompress.d.ts +1 -1
  36. package/dist/reflect.d.ts +89 -0
  37. package/dist/reflect.d.ts.map +1 -0
  38. package/dist/semantic-recall.d.ts +11 -4
  39. package/dist/semantic-recall.d.ts.map +1 -1
  40. package/dist/skill/compaction-eval/scripts/compress.mjs +170 -37
  41. package/dist/skill/compaction-eval/scripts/prepare.mjs +8 -0
  42. package/dist/skill/compaction-eval/scripts/view.mjs +321 -101
  43. package/dist/types.d.ts +13 -12
  44. package/dist/types.d.ts.map +1 -1
  45. package/package.json +1 -1
@@ -6706,10 +6706,16 @@ function omSource(compactionId) {
6706
6706
  const HISTORY_TAG = "history";
6707
6707
  /** 压缩日志块开标签的 tip 属性(对 AI 的提醒:本块是历史压缩产物,不要复述)。 */
6708
6708
  const HISTORY_TIP = "当前块是历史消息的压缩产物,不要复述";
6709
+ /** 归档块标签名:反思把较早的 <history> 块深度压缩为 <archived-history>。 */
6710
+ const ARCHIVED_HISTORY_TAG = "archived-history";
6711
+ /** 归档块开标签的 tip 属性。 */
6712
+ const ARCHIVED_HISTORY_TIP = "此块已被深度压缩,如需原文细节请用 recall 查看";
6709
6713
  /**
6710
6714
  * 「完整消息」定义(压缩提示词、recall 工具描述与 <history> 块顶注释共用)。
6711
6715
  * 完整消息是摘要日志与 recall 共用的定位单位;首条 index 为 0,按会话顺序递增、全局稳定。
6712
6716
  */
6717
+ /** 压缩会话首条消息中预注入区间条目的标题行,评估脚本据此提取原文视图。 */
6718
+ const INITIAL_HISTORY_HEADER = "区间当前条目(等同 getHistory 全区间返回):";
6713
6719
  const COMPLETE_MESSAGE_DEFINITION = "`完整消息`指一条`用户消息`、`模型输出文本`、`具有result的toolcall`或`手动加载的skill`;首条 index 为 0,按会话顺序递增。";
6714
6720
  /**
6715
6721
  * 最终 <history> 块内文块首的格式说明注释(XML 注释)。通用部分(条目标签语义 +
@@ -6725,6 +6731,7 @@ function historyFormatNote(sections = {}) {
6725
6731
  if (sections.user) parts.push("<user_message index=\"N\"> 表示用户消息原文");
6726
6732
  if (sections.skill) parts.push("<skill_content name=\"S\" index=\"N\"> 表示未压缩的原始 skill");
6727
6733
  if (sections.askUserQuestion) parts.push("<ask-user-question index=\"N\"> 表示向用户提问,CDATA 内为逐题成对的 q:(提问)与 a:(用户回答)行,未作答的题记为 a:(未回答)");
6734
+ if (sections.keyWord) parts.push("<assistant start=\"A\" end=\"B\" key-word=\"K\"> 的正文是该区间的一句话摘要,K 为供 recall 检索原文的关键词");
6728
6735
  return `<!-- ${parts.join(";")} -->`;
6729
6736
  }
6730
6737
  /**
@@ -14345,6 +14352,7 @@ function entryToElement(doc, entry) {
14345
14352
  el.setAttribute("start", String(entry.lo));
14346
14353
  el.setAttribute("end", String(entry.hi));
14347
14354
  }
14355
+ if (entry.keyWord !== void 0) el.setAttribute("key-word", entry.keyWord);
14348
14356
  appendCdataText(doc, el, entry.text);
14349
14357
  return el;
14350
14358
  }
@@ -14569,6 +14577,11 @@ var CompressionState = class CompressionState {
14569
14577
  text: `${CompressionState.spanLabel(lo, hi)} 超出要求的压缩区间 [${minIndex}..${maxIndex}]`,
14570
14578
  isError: true
14571
14579
  };
14580
+ const archive = this.archiveCheck(lo, hi, content, args.keywords);
14581
+ if (typeof archive === "string") return {
14582
+ text: archive,
14583
+ isError: true
14584
+ };
14572
14585
  let insideCount = 0;
14573
14586
  for (const entry of this.view.entries) {
14574
14587
  if (entry.lo === void 0 || entry.hi === void 0) continue;
@@ -14624,13 +14637,32 @@ var CompressionState = class CompressionState {
14624
14637
  this.replacements.push({
14625
14638
  lo,
14626
14639
  hi,
14627
- content
14640
+ content,
14641
+ ...archive === void 0 ? {} : { keywords: archive }
14628
14642
  });
14629
14643
  return {
14630
14644
  text: `已压缩${CompressionState.spanLabel(lo, hi)}(${insideCount} 条 assistant 条目)`,
14631
14645
  isError: false
14632
14646
  };
14633
14647
  }
14648
+ /**
14649
+ * 归档模式校验:区间须恰为一个归档段,content 为不超过 ARCHIVE_SUMMARY_MAX_CHARS 的单行,
14650
+ * keywords 为 1..ARCHIVE_MAX_KEYWORDS 个非空单行词。非归档模式返回 undefined;
14651
+ * 校验失败返回错误文本,通过返回规整后的关键词。
14652
+ */
14653
+ archiveCheck(lo, hi, content, keywords) {
14654
+ const segments = this.view.segments;
14655
+ if (segments === void 0) return void 0;
14656
+ if (!segments.some((seg) => seg.lo === lo && seg.hi === hi)) return `${CompressionState.spanLabel(lo, hi)} 不是归档段;区间必须恰为一个段:${segments.map((seg) => `[${seg.lo}..${seg.hi}]`).join("、")}`;
14657
+ if (/[\r\n]/.test(content)) return "content 必须是一句话,不能换行";
14658
+ if (content.length > 300) return `content ${content.length} 字符,超过 300 字符上限,请压成一句话`;
14659
+ if (!Array.isArray(keywords) || keywords.length === 0 || keywords.length > 8 || keywords.some((k) => typeof k !== "string" || k.trim() === "" || /[\r\n]/.test(k))) return `keywords 必须是 1..8 个非空单行关键词`;
14660
+ return keywords.map((k) => String(k).trim());
14661
+ }
14662
+ /** 归档模式下尚未被摘要覆盖的段。 */
14663
+ uncoveredSegments() {
14664
+ return (this.view.segments ?? []).filter((seg) => !this.replacements.some((rep) => rep.lo === seg.lo && rep.hi === seg.hi));
14665
+ }
14634
14666
  /** 完全包含该条目的替换记录;替换区间两两不相交,至多一条。 */
14635
14667
  replacementFor(entry) {
14636
14668
  const { lo, hi } = entry;
@@ -14674,7 +14706,8 @@ var CompressionState = class CompressionState {
14674
14706
  kind: "assistant",
14675
14707
  lo: rep.lo,
14676
14708
  hi: rep.hi,
14677
- text: rep.content
14709
+ text: rep.content,
14710
+ ...rep.keywords === void 0 ? {} : { keyWord: rep.keywords.join(", ") }
14678
14711
  },
14679
14712
  blocks: [],
14680
14713
  replacement: rep
@@ -14767,6 +14800,11 @@ var CompressionState = class CompressionState {
14767
14800
  text: `尚未处理原始 ask(index ${pending.join("、")}):请直接压缩,或先查看再调用 rewriteAskUserQuestion 重写后保留`,
14768
14801
  isError: true
14769
14802
  };
14803
+ const uncovered = this.uncoveredSegments();
14804
+ if (uncovered.length > 0) return {
14805
+ text: `尚有归档段未压缩:${uncovered.map((seg) => `[${seg.lo}..${seg.hi}]`).join("、")}。每个段都要用 compressHistory 压成一句话后再完成`,
14806
+ isError: true
14807
+ };
14770
14808
  this._completed = true;
14771
14809
  return {
14772
14810
  text: this.buildFinalBlock(),
@@ -14796,15 +14834,17 @@ var CompressionState = class CompressionState {
14796
14834
  const note = historyFormatNote({
14797
14835
  user: entries.some((e) => e.kind === "user"),
14798
14836
  skill: entries.some((e) => e.kind === "assistant" && e.toolName === "skill"),
14799
- askUserQuestion: entries.some(isAskEntry)
14837
+ askUserQuestion: entries.some(isAskEntry),
14838
+ keyWord: entries.some((e) => e.keyWord !== void 0)
14800
14839
  });
14840
+ if (this.view.segments !== void 0) return `<${ARCHIVED_HISTORY_TAG} tip="${ARCHIVED_HISTORY_TIP}">\n${note}\n${renderEntriesXml(entries)}\n</${ARCHIVED_HISTORY_TAG}>`;
14801
14841
  return `<${HISTORY_TAG} tip="${HISTORY_TIP}">\n${note}\n${renderEntriesXml(entries)}\n</${HISTORY_TAG}>`;
14802
14842
  }
14803
14843
  };
14804
14844
  /** 仅含原始合法 ask 的压缩会话使用的重写工具。 */
14805
14845
  const REWRITE_ASK_TOOL_SCHEMA = {
14806
14846
  name: "rewriteAskUserQuestion",
14807
- description: "重写已用 getHistory 查看且未被 compressHistory 覆盖的原始 ask。按原题序提交全部 q/a,忠实精炼问题与回答,展开选项引用,未回答的题明确写 (未回答)。保留 ask 的产物只含 q/a,不提交 options 或 CDATA 包裹。",
14847
+ description: "重写未被 compressHistory 覆盖的原始 ask。按原题序提交全部 q/a,忠实精炼问题与回答,展开选项引用,未回答的题明确写 (未回答)。保留 ask 的产物只含 q/a,不提交 options 或 CDATA 包裹。",
14808
14848
  parameters: {
14809
14849
  type: "object",
14810
14850
  properties: {
@@ -14888,7 +14928,13 @@ const COMPRESSION_TOOL_SCHEMAS = [
14888
14928
  },
14889
14929
  content: {
14890
14930
  type: "string",
14891
- description: "替换后的摘要文本(纯文本,不要包含 CDATA 包裹,插件自动包裹)"
14931
+ description: [
14932
+ "替换后的摘要文本(纯文本,不要包含 CDATA 包裹,插件自动包裹)。忠实性要求:",
14933
+ "1. 只写本次 index 或 start..end 区间内的条目,区间之后的内容不提前写入。",
14934
+ "2. 数字、错误码、退出码、行号、版本号、事件类型名与文件路径从原文逐字照抄;原文没有或不确定时不写具体值,不推测补全。",
14935
+ "3. 变更日志、文档与注释的表述方向照原文(新增/移除、引入/废弃),不反转;旧记录与现状矛盾时写明出处与矛盾点。",
14936
+ "4. 工具结果为空或仅返回成功时,结合前序条目写明动作对象(哪个文件、哪条命令、哪个会话)。"
14937
+ ].join("\n")
14892
14938
  }
14893
14939
  },
14894
14940
  required: ["content"]
@@ -14903,6 +14949,48 @@ const COMPRESSION_TOOL_SCHEMAS = [
14903
14949
  }
14904
14950
  }
14905
14951
  ];
14952
+ /** 归档模式的工具定义:compressHistory 区间限定为一个归档段并要求 keywords。 */
14953
+ const ARCHIVE_TOOL_SCHEMAS = COMPRESSION_TOOL_SCHEMAS.map((schema) => {
14954
+ if (schema.name === "completeCompression") return {
14955
+ ...schema,
14956
+ description: "全部归档段都已压缩后调用,成功时立即结束压缩会话。"
14957
+ };
14958
+ if (schema.name !== "compressHistory") return schema;
14959
+ return {
14960
+ name: "compressHistory",
14961
+ description: `把一个归档段(start..end 恰为首条消息列出的某个段)压成一句话摘要。content 不换行、不超过 300 字符,写清结论、决策与涉及的文件;keywords 为供 recall 检索原文的关键词。返回成功即已生效;修改时用同一区间重新提交。`,
14962
+ parameters: {
14963
+ type: "object",
14964
+ properties: {
14965
+ start: {
14966
+ type: "number",
14967
+ description: "归档段起始完整消息 index"
14968
+ },
14969
+ end: {
14970
+ type: "number",
14971
+ description: "归档段结束完整消息 index"
14972
+ },
14973
+ content: {
14974
+ type: "string",
14975
+ description: "一句话摘要(纯文本,不换行,不要包含 CDATA 包裹)。数字、路径、版本号与错误码从原文逐字照抄,不推测补全。"
14976
+ },
14977
+ keywords: {
14978
+ type: "array",
14979
+ minItems: 1,
14980
+ maxItems: 8,
14981
+ items: { type: "string" },
14982
+ description: "1.." + String(8) + " 个关键词:文件名、函数名、命令、主题词等原文中出现的词"
14983
+ }
14984
+ },
14985
+ required: [
14986
+ "start",
14987
+ "end",
14988
+ "content",
14989
+ "keywords"
14990
+ ]
14991
+ }
14992
+ };
14993
+ });
14906
14994
  //#endregion
14907
14995
  //#region src/rate-limit.ts
14908
14996
  /**
@@ -14963,14 +15051,16 @@ async function gateRateLimit(waitMs, signal) {
14963
15051
  * 工具驱动的压缩循环:以新会话方式直连 ctx.llm.stream(),模型通过 getHistory /
14964
15052
  * compressHistory / completeCompression 完成压缩,存在原始合法提问时加入重写工具。
14965
15053
  * 导出 runCompressionLoop / buildCompressionPrompt / buildCompressionTaskText /
14966
- * REFLECT_COMPRESSION_PROMPT / ASK_COMPRESSION_PROMPT / CompressionLoopOptions / CompressionOutcome / CompressionStats / COMPRESSION_NUDGE_TEXT / TRUNCATION_NUDGE_TEXT。
15054
+ * REFLECT_COMPRESSION_PROMPT / ASK_COMPRESSION_PROMPT / CompressionLoopOptions / CompressionOutcome / CompressionStats / COMPRESSION_NUDGE_TEXT / TRUNCATION_NUDGE_TEXT / COMPLETION_BLOCKED_TEXT。
14967
15055
  *
14968
- * - 首条 user 消息仅含压缩指令与 start/end 区间(buildCompressionTaskText),不含
14969
- * 历史消息内容;共享压缩提示词作为 system,反思 pass 追加反思合并约束
15056
+ * - 首条 user 消息为压缩指令与 start/end 区间(buildCompressionTaskText),循环附上
15057
+ * 全区间 getHistory 结果,原始提问随之视为已查看;共享压缩提示词作为 system,归档
15058
+ * 视图追加归档深度压缩约束并改用归档工具定义
14970
15059
  * - 每轮请求携带压缩工具 schemas(purpose='compaction',maxTokens 沿用配置);流经
14971
15060
  * BlockAssembler 组装为 assistant 消息,工具执行结果以 tool-result 消息回填
14972
15061
  * - completeCompression 校验通过后立即停止(同轮后续工具调用不再执行),最终 <history>
14973
- * 块由 CompressionState 构建,全程无需整块校验
15062
+ * 块由 CompressionState 构建,全程无需整块校验;同轮有未解决的写入失败时 completeCompression
15063
+ * 不执行并返回 COMPLETION_BLOCKED_TEXT
14974
15064
  * - 模型输出纯文本(无工具调用)时追加提醒消息继续,连续 3 轮仍无工具调用判失败
14975
15065
  * - 输出被 max-tokens 截断且无工具调用时单独计数:该轮 assistant 消息仅落盘、不进入后续
14976
15066
  * 请求,追加截断专用提醒,连续 3 轮截断判失败;任一轮有工具调用则两个计数清零
@@ -14993,17 +15083,12 @@ function buildCompressionPrompt(skipReasoning) {
14993
15083
  "",
14994
15084
  `【完整消息定义】${COMPLETE_MESSAGE_DEFINITION}`,
14995
15085
  "",
14996
- "【工具】",
14997
- "- getHistory(option?: {start?, end?}):查看压缩区间内的历史条目。start/end 缺省为要求区间的第一个/最后一个完整消息 index,必须在要求区间内。返回当前状态,不带 <history> 包裹:本次已压缩的区间显示为摘要条目;区间切入已有 <history> 块时返回整块。",
14998
- "- compressHistory(option?: {index?, start?, end?, content}):把 index 单条或 start..end 连续区间的 assistant 类条目替换为 content 摘要(纯文本,不要包含 CDATA 包裹,插件自动包裹)。index 与 start/end 二选一,start==end 等同 index。区间不得覆盖用户消息;与已有替换区间部分重叠会被拒绝,完全包含则覆盖。返回成功即已生效,无需查看验证,不要用单条 index 试探;修改已提交的摘要时用相同或更大的区间重新提交。",
14999
- "- completeCompression():全部压缩完成后调用,立即结束。",
15000
- "",
15001
15086
  "【压缩要求】",
15002
- "- 先用 getHistory 查看区间内容,再划分模块分批压缩;用户消息不可压缩、保持原样,无需处理。",
15087
+ "- 区间条目已附在首条消息中,直接划分模块压缩;只在需要查看本次已压缩结果时调用 getHistory。用户消息不可压缩、保持原样,无需处理。",
15003
15088
  ...skipReasoning ? [] : ["- <reasoning> 仅作压缩参考,不进产物。"],
15004
- "- 将具有关联性的 assistant 消息按内在逻辑连贯性划分为连续模块,聚合为区间压缩(start..end)",
15005
- "- 单条重要的完整消息以 index 单独压缩",
15006
- "- 压缩后的 assistant 消息内,应当描述**行为逻辑**,强调关键的**结论、产出和任务**;涉及到的具体文件保留完整路径",
15089
+ "- 将关联的 assistant 消息按内在逻辑划分为连续模块,用 start..end 聚合压缩;单条重要的完整消息以 index 单独压缩。",
15090
+ "- content 的忠实性要求见 compressHistory 参数说明,提交前逐条核对。",
15091
+ "- 摘要描述**行为逻辑**,强调关键的**结论、产出和任务**;涉及的文件保留完整路径。",
15007
15092
  "- 摘要粒度按后续用途分配,与消息位置无关:",
15008
15093
  " - 未完成的任务、当前状态、待办与未解决的问题保留细节;涉及的文件写明最新状态。",
15009
15094
  " - 已完成的子任务只保留结果、决策及理由、排除的方案及原因。",
@@ -15011,28 +15096,42 @@ function buildCompressionPrompt(skipReasoning) {
15011
15096
  " - 可以低成本重新获取的内容(文件内容、命令输出、搜索结果)只记来源与要点。",
15012
15097
  "- <history> 条目正文以 CDATA 包裹,CDATA 内为逐字原样内容。",
15013
15098
  "- 工具调用条目为 <assistant index=\"N\" type=\"toolcall\" tool-name=\"…\">,内含 <tool-args>(调用参数 JSON)与 <tool-result>(工具返回内容)两个 CDATA 子元素。",
15014
- "- 加载的 skill 以 <skill_content name=\"…\" index=\"N\"> 条目呈现,内含 <skill_resources> 与 <skill_instructions> 两段,内文为加载的 skill 内容,属于关键信息。仅在你明确判断该 skill 与后续任务无关时,压缩它;如果该 skill 与后续任务相关,或者你无法判断,不要压缩,**保持原文**。",
15099
+ "- 加载的 skill 以 <skill_content name=\"…\" index=\"N\"> 条目呈现,内含 <skill_resources> 与 <skill_instructions> 两段,属于关键信息。仅在明确判断与后续任务无关时压缩;相关或无法判断时**保持原文**。",
15015
15100
  "- 已有 <history> 块中的 ask_user_question 以 <ask-user-question index=\"N\"> 呈现,CDATA 内为逐题成对的 q:(问题文本)与 a:(用户回答)行,未作答的题记为 a:(未回答)。这些提问已经处理;仅在明确判断与后续任务无关时压缩,否则保持原样。原始提问按本会话的专用处理规则执行。",
15016
15101
  "- 除原始提问外,未压缩的条目将原样保留;宁可保留也不要强行压缩不确定的内容。",
15017
- "- 全部完成后调用 completeCompression 结束;不要输出与工具调用无关的文本。"
15102
+ "",
15103
+ "【提交】",
15104
+ "- 首轮即在同一轮内调用全部 compressHistory,并在该轮最后调用 completeCompression;compressHistory 返回成功即已生效,无需查看验证。",
15105
+ "- 思考只做模块划分与取舍判断,摘要正文直接写进工具参数,不要在思考中起草。",
15106
+ "- 不要输出与工具调用无关的文本。"
15018
15107
  ].join("\n");
15019
15108
  }
15020
15109
  /**
15021
- * 构建压缩会话首条 user 消息文本(压缩指令 + start/end 区间,不含历史消息内容)。
15110
+ * 构建压缩会话首条 user 消息的指令部分(压缩指令 + start/end 区间);区间条目由循环附加。
15022
15111
  */
15023
- function buildCompressionTaskText(phase, start, end) {
15024
- if (phase === "reflect") return `合并压缩全部 <history> 块,完整消息区间 [${start}..${end}]:用 getHistory 查看已有块条目,用 compressHistory 重新压缩合并 assistant 条目,完成后调用 completeCompression。`;
15025
- return `压缩完整消息区间 [${start}..${end}]:用 getHistory 查看条目,用 compressHistory 分批压缩 assistant 条目,完成后调用 completeCompression。`;
15112
+ function buildCompressionTaskText(phase, start, end, segments = []) {
15113
+ if (phase === "reflect") {
15114
+ const list = segments.map((seg) => `[${seg.lo}..${seg.hi}]`).join("、");
15115
+ return `归档深度压缩 <history> 块,完整消息区间 [${start}..${end}]:区间条目附在下方。归档段共 ${segments.length} 个:${list}。每个段用一次 compressHistory 压成一句话并给出 keywords,全部完成后调用 completeCompression。`;
15116
+ }
15117
+ return `压缩完整消息区间 [${start}..${end}]:区间条目附在下方,用 compressHistory 压缩 assistant 条目,完成后调用 completeCompression。`;
15026
15118
  }
15027
- /** 反思合并的额外约束,只在反思 pass 注入。 */
15028
- const REFLECT_COMPRESSION_PROMPT = ["【反思合并】", "- 重新压缩已有摘要条目时,保留其中的不可再生信息,不要逐轮缩减。"].join("\n");
15119
+ /** 归档深度压缩的额外约束,只在归档视图注入。 */
15120
+ const REFLECT_COMPRESSION_PROMPT = [
15121
+ "【归档深度压缩】",
15122
+ "- 本次产物是归档块,原文可由主模型通过 recall 按 index 找回;此规则优先于上方的粒度要求。",
15123
+ "- 用户消息与已处理的提问原样保留,无需处理。",
15124
+ "- 相邻两条用户消息之间的全部 assistant 条目构成一个归档段,每段压成一句话:写清结论、决策与涉及的文件,不写过程。",
15125
+ "- 一句话不超过 300 字符、不换行;已被段内后续进展取代的信息直接舍弃。",
15126
+ "- keywords 选原文中出现、便于检索的词:文件名、函数名、命令、错误码、主题词。"
15127
+ ].join("\n");
15029
15128
  /** 原始合法 ask 的处理约束,只在视图含待处理原始提问时注入。 */
15030
15129
  const ASK_COMPRESSION_PROMPT = [
15031
15130
  "【原始提问处理】",
15032
- "- 原始合法 ask_user_question 在 getHistory 中以 <ask-user-question index=\"N\"> 展示,每题为 q:问题、o1:选项一、o2:选项二等及 a:回答;选项包含 label 与 description,无选项题省略 oN 行。",
15131
+ "- 原始合法 ask_user_question 以 <ask-user-question index=\"N\"> 展示,每题为 q:问题、o1:选项一、o2:选项二等及 a:回答;选项包含 label 与 description,无选项题省略 oN 行。",
15033
15132
  "- 每个原始提问必须二选一:直接用 compressHistory 压成普通 assistant 摘要;或者保留 ask 标签并用 rewriteAskUserQuestion 重写 q/a。不能原样跳过。",
15034
15133
  "- 直接压缩:仅在明确判断该提问与后续任务无关时执行;首次覆盖会被阻止一次,重新思考后再次调用才执行。不确定或相关时走保留重写路径。",
15035
- "- 保留重写:先用 getHistory 查看该提问及全部选项,收到返回结果后的下一轮再调用 rewriteAskUserQuestion({index, qa:[{ordinal:1,q:\"问题\",a:\"回答\"},...]}),不要与查看同轮提交;ordinal 从 1 开始,按原题序提交全部题,不增删、不重复。",
15134
+ "- 保留重写:首条消息已含该提问及全部选项,直接调用 rewriteAskUserQuestion({index, qa:[{ordinal:1,q:\"问题\",a:\"回答\"},...]});ordinal 从 1 开始,按原题序提交全部题,不增删、不重复。",
15036
15135
  "- q/a 均可忠实精炼,保留语境与用户真实意图。将回答中对选项的编号、标签等引用展开为自足表述;产物仅有 q:/a:,不能保留 oN 选项列表或 options 字段。",
15037
15136
  "- 空答案明确为 (未回答),不得补造用户决定。仅提交纯文本 q/a,不自行拼接 XML 或 CDATA 包裹。",
15038
15137
  "- 允许切换路径;最终成功的直接压缩覆盖优先,已覆盖的 ask 不能再次重写。history 块中的 ask 已处理,不需重写。",
@@ -15042,6 +15141,22 @@ const ASK_COMPRESSION_PROMPT = [
15042
15141
  const COMPRESSION_NUDGE_TEXT = "请通过工具执行压缩:用 getHistory 查看区间条目,用 compressHistory 压缩 assistant 条目,完成后调用 completeCompression。不要输出与工具调用无关的文本。";
15043
15142
  /** 输出被 max-tokens 截断且无工具调用时追加的提醒消息文本。 */
15044
15143
  const TRUNCATION_NUDGE_TEXT = "上一轮输出因长度上限被截断,其中的工具调用未被接收。请缩短思考,直接分批调用 compressHistory(每次覆盖较小区间),最后调用 completeCompression。";
15144
+ /** 同轮有未解决的写入失败时 completeCompression 返回的错误文本。 */
15145
+ const COMPLETION_BLOCKED_TEXT = "本轮有失败的 compressHistory 或 rewriteAskUserQuestion 未在同轮重新提交成功,未执行 completeCompression。请按错误修正后重新提交,再调用 completeCompression。";
15146
+ /** 写入类调用的目标键(压缩区间或重写的 ask index);非写入调用或参数无法解析返回 undefined。 */
15147
+ function writeTargetOf(name, rawArgs) {
15148
+ if (name !== "compressHistory" && name !== "rewriteAskUserQuestion") return void 0;
15149
+ let args;
15150
+ try {
15151
+ args = JSON.parse(rawArgs);
15152
+ } catch {
15153
+ return `${name}:invalid`;
15154
+ }
15155
+ if (name === "rewriteAskUserQuestion") return `ask:${String(args.index)}`;
15156
+ const lo = args.start ?? args.index;
15157
+ const hi = args.end ?? args.index;
15158
+ return `range:${String(lo)}..${String(hi)}`;
15159
+ }
15045
15160
  /** 连续无工具调用、连续截断各自允许的最大轮数。 */
15046
15161
  const MAX_CONSECUTIVE_FAILURES = 3;
15047
15162
  /** 瞬时请求错误的连续最大重试次数。 */
@@ -15109,6 +15224,15 @@ function isTransientFailure(message, status) {
15109
15224
  if (status !== void 0) return status >= 500 && status <= 599;
15110
15225
  return /\b5\d{2}\b|econnreset|etimedout|econnrefused|epipe|socket hang up|fetch failed|network|overloaded|timed? ?out/i.test(message);
15111
15226
  }
15227
+ /**
15228
+ * 首条 user 消息:指令后附全区间 getHistory 结果,原始提问在首轮请求前标记为已查看。
15229
+ * 视图无可定位条目时只返回指令。
15230
+ */
15231
+ function withInitialHistory(taskText, state) {
15232
+ const history = state.getHistory({});
15233
+ if (history.isError) return taskText;
15234
+ return `${taskText}\n\n${INITIAL_HISTORY_HEADER}\n${history.text}`;
15235
+ }
15112
15236
  /** skipReasoning=true 时去掉视图中的 reasoning 条目(兑现 getHistory 不输出 reasoning 的契约);否则原样返回。 */
15113
15237
  function withoutReasoning(view, skipReasoning) {
15114
15238
  if (!skipReasoning) return view;
@@ -15125,13 +15249,14 @@ async function runCompressionLoop(ctx, session, options) {
15125
15249
  const logger = makeLogger(ctx, options.debug);
15126
15250
  const view = withoutReasoning(options.view, options.skipReasoning);
15127
15251
  const state = new CompressionState(view);
15128
- const tools = state.hasPendingAsks ? [...COMPRESSION_TOOL_SCHEMAS, REWRITE_ASK_TOOL_SCHEMA] : COMPRESSION_TOOL_SCHEMAS;
15252
+ const baseTools = view.segments === void 0 ? COMPRESSION_TOOL_SCHEMAS : ARCHIVE_TOOL_SCHEMAS;
15253
+ const tools = state.hasPendingAsks ? [...baseTools, REWRITE_ASK_TOOL_SCHEMA] : baseTools;
15129
15254
  const system = [
15130
15255
  buildCompressionPrompt(options.skipReasoning),
15131
- ...options.phase === "reflect" ? [REFLECT_COMPRESSION_PROMPT] : [],
15256
+ ...view.segments === void 0 ? [] : [REFLECT_COMPRESSION_PROMPT],
15132
15257
  ...state.hasPendingAsks ? [ASK_COMPRESSION_PROMPT] : []
15133
15258
  ].join("\n\n");
15134
- const messages = [makePluginUserMessage(options.taskText)];
15259
+ const messages = [makePluginUserMessage(withInitialHistory(options.taskText, state))];
15135
15260
  let rounds = 0;
15136
15261
  let nudges = 0;
15137
15262
  let truncations = 0;
@@ -15295,8 +15420,19 @@ async function runCompressionLoop(ctx, session, options) {
15295
15420
  }
15296
15421
  nudges = 0;
15297
15422
  truncations = 0;
15423
+ /** 本轮失败且未被同轮后续成功提交解决的写入目标。 */
15424
+ const unresolved = /* @__PURE__ */ new Set();
15298
15425
  for (const call of calls) {
15299
- messages.push(toolResultOf(call, state.executeCall(call.name, call.arguments)));
15426
+ const result = call.name === "completeCompression" && unresolved.size > 0 ? {
15427
+ text: COMPLETION_BLOCKED_TEXT,
15428
+ isError: true
15429
+ } : state.executeCall(call.name, call.arguments);
15430
+ const target = writeTargetOf(call.name, call.arguments);
15431
+ if (target !== void 0) {
15432
+ if (result.isError) unresolved.add(target);
15433
+ else unresolved.delete(target);
15434
+ }
15435
+ messages.push(toolResultOf(call, result));
15300
15436
  if (state.completed) break;
15301
15437
  }
15302
15438
  if (state.completed) {
@@ -15346,7 +15482,7 @@ function sharedModelDir() {
15346
15482
  /** 默认配置(冻结对象,resolveConfig 合并的基底;debug 缺省值在解析时按 NODE_ENV 判定)。 */
15347
15483
  const DEFAULT_CONFIG = Object.freeze({
15348
15484
  observeThresholdTokens: 35e3,
15349
- reflectThresholdTokens: 4e4,
15485
+ reflectThresholdTokens: 8e4,
15350
15486
  compressMaxTokens: void 0,
15351
15487
  rateLimitWaitMs: 6e4,
15352
15488
  recompressConcurrency: 2,
@@ -15358,7 +15494,6 @@ const DEFAULT_CONFIG = Object.freeze({
15358
15494
  progressReminderIdleSteps: 4,
15359
15495
  progressReminderIdleToolCalls: 10,
15360
15496
  debug: false,
15361
- recallEnabled: true,
15362
15497
  semanticRecallEnabled: true,
15363
15498
  modelDir: sharedModelDir(),
15364
15499
  compressProvider: void 0,
@@ -15379,7 +15514,6 @@ Schema.object({
15379
15514
  progressReminderIdleSteps: Schema.number().step(1).min(1).default(DEFAULT_CONFIG.progressReminderIdleSteps).volatile(),
15380
15515
  progressReminderIdleToolCalls: Schema.number().step(1).min(0).default(DEFAULT_CONFIG.progressReminderIdleToolCalls).volatile(),
15381
15516
  debug: Schema.boolean().default(process.env.NODE_ENV !== "production").volatile(),
15382
- recallEnabled: Schema.boolean().default(DEFAULT_CONFIG.recallEnabled).volatile(),
15383
15517
  semanticRecallEnabled: Schema.boolean().default(DEFAULT_CONFIG.semanticRecallEnabled).volatile(),
15384
15518
  modelDir: Schema.string().default(DEFAULT_CONFIG.modelDir).volatile(),
15385
15519
  compressProvider: Schema.string().volatile(),
@@ -15445,8 +15579,7 @@ function resolveConfig(raw) {
15445
15579
  config.progressReminderEnabled = resolveBoolean(input.progressReminderEnabled, true);
15446
15580
  config.progressReminderIdleEnabled = resolveBoolean(input.progressReminderIdleEnabled, DEFAULT_CONFIG.progressReminderIdleEnabled);
15447
15581
  config.debug = resolveBoolean(input.debug, process.env.NODE_ENV !== "production");
15448
- config.recallEnabled = resolveBoolean(input.recallEnabled, true);
15449
- config.semanticRecallEnabled = config.recallEnabled && resolveBoolean(input.semanticRecallEnabled, true);
15582
+ config.semanticRecallEnabled = resolveBoolean(input.semanticRecallEnabled, true);
15450
15583
  const modelDir = input.modelDir;
15451
15584
  if (typeof modelDir === "string" && modelDir.trim() !== "") config.modelDir = modelDir;
15452
15585
  config.compressProvider = resolveOptionalString(input.compressProvider);
@@ -6,6 +6,12 @@ import { homedir, tmpdir } from "node:os";
6
6
  import { Session, SessionId } from "@deepseek-ai/dsh-session";
7
7
  import { createRequire } from "module";
8
8
  /**
9
+ * 「完整消息」定义(压缩提示词、recall 工具描述与 <history> 块顶注释共用)。
10
+ * 完整消息是摘要日志与 recall 共用的定位单位;首条 index 为 0,按会话顺序递增、全局稳定。
11
+ */
12
+ /** 压缩会话首条消息中预注入区间条目的标题行,评估脚本据此提取原文视图。 */
13
+ const INITIAL_HISTORY_HEADER = "区间当前条目(等同 getHistory 全区间返回):";
14
+ /**
9
15
  * 判定 user/message 的 source 是否为本插件自产或宿主压缩 checkpoint(压缩日志消息与
10
16
  * 宿主压缩替换消息)。这类消息不占完整消息 index。宿主迁移前的 v3 信封形态
11
17
  * (kind 'plugin' + plugin 字段)仅作读取防御保留。
@@ -1297,6 +1303,8 @@ function parseLog(events) {
1297
1303
  const ccRes = cc?.data?.callId ? res.get(cc.data.callId) : void 0;
1298
1304
  const product = ccRes && !ccRes.message?.isError ? textOf(ccRes.message?.content) : "";
1299
1305
  const views = [];
1306
+ const injected = firstUser.indexOf(INITIAL_HISTORY_HEADER);
1307
+ if (injected >= 0) views.push([{}, firstUser.slice(injected + 28).replace(/^\n/, "")]);
1300
1308
  for (const e of body) {
1301
1309
  if (e.type !== "tool/call" || !e.data?.callId) continue;
1302
1310
  const r = res.get(e.data.callId);