Documentation
¶
Overview ¶
Package skilldisclose 技能披露:**确定性**挑出该给模型看的那几个技能。
生命周期: Experimental(v0.33.0 定级)——本包仍会改、删、拆,不承诺任何 兼容,升级风险自负;定级理由见 api-lifecycle.yaml,分级规则见 docs/api-compat.md。
与 tooldisclose 的分工 ¶
@@tooldisclose@ 解决的是「工具太多,一次给全量 schema 撑爆上下文」,它的检索 键是**工具调用需求**(我要做什么)。技能不一样:技能是**带资源文件的工作流**, 触发信号有三种且强度不同——① 用户/程序**点名**了它;② 描述与当前任务相关; ③ 当前要读的文件落在它声明的资源里。把三者混成一个分数就会让「相关」压过 「点名」,而那正是用户已经明确表达过的意图。
本包只做判定,不做投递 ¶
披露的**内容**(正文注入、文件读取、渐进式加载)归宿主。本包给的是: 给定目录与查询,**挑哪几个**、**为什么挑它们**、**有没有被预算裁掉**。
三条可机械判定的判据 ¶
- **点名优先**:命中名字的分数必须高于任何「相关度」信号,且不受描述长度影响。
- **确定性**:同分按名字字典序,结果与目录的遍历顺序、map 顺序无关。
- **裁剪显式**:预算裁掉了候选时必须标出来(@@Result.Truncated@)。 静默截断会让宿主以为「就这几个技能相关」,而实际上有更多被挤掉了。
空结果不是静默 ¶
没命中时 @@Reason@ 必须写明「为什么是空的」。空结果与「目录里只有一个技能, 正好命中」在调用方看起来一样,而前者是「模型不知道有这个能力」的形态—— 与「技能不存在」不是一回事,宿主据此要不要回退到全量披露。
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func MetadataBytes ¶ added in v0.42.0
MetadataBytes 一条技能作为披露元数据实际占用的字节数:Name + Description + 全部 Tags + 全部 Resources(按 UTF-8 字节计)。
为什么不含分隔符/容器开销:这是一个**可对账的口径**——预算是宿主给的, 宿主需要能自己算一遍并与披露结果对上。计费与交付共用这一份实现,不另写一套。
Types ¶
type Budget ¶
type Budget struct {
// Max 最多披露几个(<=0 表示不限制数量)。
Max int
// MaxBytes 元数据字节上限(<=0 表示不限制)。
//
// 计量口径是**实际交付的元数据**(MetadataBytes:Name + Description +
// Tags + Resources),不是只算 name+description:宿主拿到的就是整个 Skill,
// 计费口径与交付口径必须是同一份(issue #289)。
MaxBytes int
}
Budget 披露预算。
type Catalog ¶
type Catalog struct {
// contains filtered or unexported fields
}
Catalog 已登记的技能集合。
副本口径(全覆盖) ¶
Skill.Resources 与 Skill.Tags 是引用类型。构造期从宿主入参深拷贝一次; Disclose 交出 Scored / Skills 前再深拷贝一次(cloneSkill)。调用方拿到的 都是自己的副本——构造后改写宿主原变量、或原地改写披露结果,都改不动目录 (与 tooldisclose 的副本口径同源,issue #377)。
type Query ¶
type Query struct {
// Mention 点名(用户/程序明确提到的技能名,可空)。
Mention string
// Text 当前任务的自然语言描述(相关度打分用)。
Text string
// Resources 当前上下文里涉及的文件路径(资源匹配用)。
Resources []string
// Exclude 已披露过的技能(**不重复披露**:重复注入会挤占窗口且没有新信息)。
Exclude []string
}
Query 一次披露请求。