docs: reserve seam for complete capabilities
This commit is contained in:
+4
-4
@@ -1,12 +1,12 @@
|
||||
# Agent Note: 将唯一的压缩后端并入服务包
|
||||
|
||||
Status: rejected — 计划增加更多压缩后端,因此接口包与 basic 实现包继续分离。
|
||||
Status: rejected — 计划增加更多压缩后端,因此 Service Definition 包与 basic 提供方包继续分离。
|
||||
|
||||
[English](2026-07-19-fold-compaction-package-split.md) | 中文
|
||||
|
||||
## 问题
|
||||
|
||||
压缩(compaction)目前拆分在两个包中:`@deepseek-ai/dsh-compact` 拥有一个含两个方法的抽象服务和共享类型,`@deepseek-ai/dsh-compact-basic` 拥有唯一的完整实现。交付配置只加载 basic 包,除了该实现外,没有生产包独立消费接口包。
|
||||
压缩(compaction)目前拆分在两个包中:`@deepseek-ai/dsh-compact` 拥有一个含两个方法的抽象服务和共享类型,`@deepseek-ai/dsh-compact-basic` 拥有唯一的完整提供方。交付配置只加载 basic 包,除了该提供方外,没有生产包独立消费 Service Definition 包。
|
||||
|
||||
该拆分增加了一份包 manifest(元数据清单)、README、项目边界、依赖边、抽象转发类、生成目录项和组合接线,却没有实际的后端替换用例。[能力 seam 决策](../../implemented/architecture/2026-06-13-capability-seams.md)要求接口、实现和消费方都必须真实存在,而不能预先拆分;[压缩决策](../../implemented/feature/2026-06-18-compaction-capability-seam.md)也记录了独立消费方仍被推迟。
|
||||
|
||||
@@ -14,7 +14,7 @@ Status: rejected — 计划增加更多压缩后端,因此接口包与 basic
|
||||
|
||||
把 basic 实现移入 `@deepseek-ai/dsh-compact`,并删除 `@deepseek-ai/dsh-compact-basic`。`ctx.compact`、`CompactionResult`、共享 transcript(文本记录)和工具配对辅助方法、现有配置以及具体压缩算法都由一个包负责。
|
||||
|
||||
保留 `summarize()` 作为受保护的自定义钩子。部署专用的摘要器可以通过继承或拦截现有 LLM(大语言模型)调用完成定制,无需第二个能力包。只有在第二个完整后端与独立消费方确实需要替换实现时,才重新提取接口包。
|
||||
保留 `summarize()` 作为受保护的自定义钩子。部署专用的摘要器可以通过继承或拦截现有 LLM(大语言模型)调用完成定制,无需第二个能力包。只有在第二个完整后端与独立 Consumer 确实需要替换实现时,才重新引入独立的 Service Definition 包。
|
||||
|
||||
如果本提案获准,应同步修订已实现的压缩决策与[可回忆压缩提案](../../proposed/feature/2026-07-06-recallable-compaction.md),使包所有权只有一处持久说明。
|
||||
|
||||
@@ -22,7 +22,7 @@ Status: rejected — 计划增加更多压缩后端,因此接口包与 basic
|
||||
|
||||
**为可能出现的远程或回忆后端保留拆分。** 一种可能的未来实现不足以支撑当前包边界。回忆功能会增加压缩结果的消费方,但不一定增加另一种实现;远程摘要器也可以使用受保护钩子。
|
||||
|
||||
**将实现包名用于接口包。** 如果保留 `compact-basic` 作为最终名称,产品服务会看起来像一个可选后端。`compact` 已经是 `ctx.compact` 使用的稳定服务标识,更适合作为单包所有者。
|
||||
**将提供方包名用于 Service Definition 包。** 如果保留 `compact-basic` 作为最终名称,产品服务会看起来像一个可选后端。`compact` 已经是 `ctx.compact` 使用的稳定服务标识,更适合作为单包所有者。
|
||||
|
||||
## 验收标准
|
||||
|
||||
|
||||
Reference in New Issue
Block a user