You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
English TL;DR:#1947 closed as COMPLETED after Phase 1 landed (the skill/<name> path syntax, PR #2285, released in v0.1.187) — but Phase 2 (model-callable skill_pin/skill_unpin with session pin state) and Phase 3 (cascade adoption, pin budget, pressure valve, web panel) never shipped, and no successor issue tracks them. This issue revives them, keyed to the same skill/<name> space, and adds one increment worked out since: with unpin as an in-conversation model tool, reclaim closes in the same turn (unpin → compress), so no nudge machinery is needed.
Activity
ranxianglei commentedon Oct 20, 2026
(ai: vllm-qwen/qwen3.8-27b)
标签:opencode / pi / claude-code / zcode(文档明确的 skill 装载客户端)、scope/wiring(宿主侧工具+会话态+配置接线,内核不动)、p3(能力增强,无数据丢失/不可用)。feature 类,不打 bug。
一、查重结论
不重复。 #3949 是 #1947 未落地 Phase 2/3 的合法承接:#1947 已于 2026-10-07 以 COMPLETED 关闭(仅 Phase 1 落地,PR #2285 → v0.1.187),仓内 open+closed 检索
skill_pin/skill_unpin/cascade-protection 全零命中,无第二条追踪项。相邻 #2446/#2736(durable/*虚拟路径)覆盖的是基础设施注入(AGENTS.md/技能目录/MCP 清单),不是 skill 保护生命周期,不重叠。二、现状核实(master @ v0.1.202,逐项对照源码)
toolPathOf/matchToolPath/latest-per-path 分组均在kernel/src/protected.ts,两旋钮路径语法生效skill_pin/skill_unpin;__bili/*路由面无会话级保护入口file:./kernel(acp-kernel 0.0.136)——#1947 原「Phase 2 前置=内核发版+升 pin」的跨仓门控已作废(owner 在 #1947 floor 14 已确认)isToolProtected和isMessageProtected都已在每请求喂进内核 Config(src/config.ts:1421、src/session.ts:627)这条最后一点是本 triage 的关键架构结论:内核今天就把完整保护面(路径空间 + 两旋钮 + 两条宿主谓词钩子)暴露出来,宿主只需把「会话内动态 pin 集」合并进每请求的有效
protectedTools/protectedLatestTools(或用isMessageProtected(msg)精确保护窗口内实例)。因此 Phase 2/3 可完全在宿主侧实现,零内核改动——比 #1947 立项时(当时还要为工具定义单独发内核版)路径更短,评审档也更轻(不触 Kernel Boundary 的人工评审线)。三、结构化八问
protectedTools) 或「仅最新实例」(protectedLatestTools) 两档,凑不出「对话中按 skill 动态装卸 + 嵌套级联收养 + 明确回收时机」;长编排会话里要么编排 skill 失保、要么 pinned 上下文无界增长。protectedTools或放任压缩),属体验/成本问题,非数据丢失、非不可用 → p3。session.metadata,持久化);每请求把静态配置 ∪ 活跃 pin ∪ 级联收养集合并成有效保护模式喂给内核;skill_pin/skill_unpin做成模型可调代理工具(acp_rule 同型);unpin 兼作关窗信号并返回可回收 token 数,让模型同 turn 接compress完成回收。详见下节。skill_unpin不可撤销静态配置(配置=用户意志,pin=流程意志)、ALWAYS_PROTECTED_TOOLS(compress/acp_rule) 永不解;既有 protected-tools / protected-latest 套件须零改动全绿。唯一高危邻域:from=声明式收养要改写转发入参,触碰 [bug] 插件透传会剥掉工具调用参数里的 render tag(arguments 流挂了 tag-echo 过滤器) #1039 不变量(tool-call arguments 字节级转发)——必须收紧为「只剥代理自己约定的专用字段/首部前缀、仅施于出站副本、绝不碰其他内容」,并在 PR 显式披露。from=约定行」——OpenCode 的 skill 工具描述本就随技能集变化而变、前缀本就要失效,append 不引入额外代价([Feature] Per-skill compression protection: static per-name config + dynamic skill_pin/skill_unpin + cascade adoption #1947 floor 3 已论证)。skill/<name>空间(owner [Feature] Per-skill compression protection: static per-name config + dynamic skill_pin/skill_unpin + cascade adoption #1947 floor 14 已定案)。投影/匹配仍在内核,运行时 pin 逻辑进宿主,边界清晰。session.metadata);仅 P3 两个护栏旋钮引入新字段(见下申报)。四、修法思路(机制层面)
session.metadata.skillPins(Map<skillName, {cascade}>,持久化跨重启)。组装每请求内核 Config 时,有效保护模式 = 静态protectedTools∪{skill/<n> : n ∈ 活跃pin}(latest 语义同理并入protectedLatestTools)。两种粒度二选一即可满足:粗粒度用模式合并(pin x ≈ 临时把skill/x加进保护集,unpin 移除、历史已折叠实例不复活);精粒度用isMessageProtected只保护 pin 窗口内实际装载的实例 id。skill_unpin(X)(代理更新 pin 集、返回可回收 token 数)→ 模型同一 turn 接compress折叠刚解除的区段。因保护判定每请求从session.metadata实时解析,unpin 落库后下一processTurn即见更新,该区段随之变为可压缩——无需 nudge 队列,也没有独立端点的会话定位问题(工具调用自带会话上下文)。web 端点保留为不经模型的确定性通道,两通道写同一份会话 pin 状态。模型自解钉的风险面可控:skill 内容可从盘上重载(折丢可恢复,区别于 feat: expose compress.protectedTools (full-history tool protection) #1109 的不可重建工具结果)、一次性语义下爆炸半径=每个名字最新一条、ALWAYS_PROTECTED仍不可解——据此不做「用户意图确认」启发式闸,与原案「不做推断式归属」同一哲学。from=声明式归属,正则+三条规则替代推断引擎;代理在观察模型 tool_use 时捕获声明、转发客户端执行器前剥离(仅出站副本),原始登记落session.metadata。PUT /__bili/config模式扩展。五、六个开放问题的明确建议(沿用 #1947 floor 2 已给结论,补 vendored-kernel 增量)
skill_pin/skill_unpin——owner floor 14 通篇即用skill_pin("x");领域动词在调用点自解释,家族命名本就不统一(compress/decompress/search_context 均无acp_前缀)。effectiveRules先例一致;常驻编排 skill 跨重启静默失保比 stale pin 代价更糟,stale pin 有界(预算上限 + web 可见性兜底)。六、配置面申报(Configuration Surface Discipline)
新增恰好两个字段,均落
compress段、随 P3 护栏入COMPRESS_SETTING_FIELDS并镜像 CONFIGURATION.md en/zh:skillPinBudgetTokens?: numberskillPinPressureDowngrade?: boolean现有面为何表达不了:
protectedTools/protectedLatestTools是「会话外的固定配置」,无法表达「流程运行中按 skill 名动态装卸 + 窗口释放 + 级联收养」——后者必须落在会话态 + 每请求合并,这正是 P2 的主体,且不需要任何新字段(复用既有路径空间)。兼容性:纯增量、默认关/缺省、对既有会话零影响、无需迁移。七、待你拍板后开工
功能类按规先讨论后实现,以下是开工前需要你定的三件事(其余六问我已给出建议,无异议即按此执行):
session.metadata,"skill" 是产品概念而非压缩原语,保持 Kernel Boundary 不动→免人工评审档;pi-subagents 的acp_delegate*已有宿主侧工具面前例)。备选是照 acp_rule/absorb 惯例放内核(家族一致性更强,但要走内核版本 bump + 人工评审)。分期确认:P2 → P3(级联收养 + 预算 + 压力阀 + web 端点)。你对上述三点(尤其第 2 点的 schema 归属)确认后我即按此开工,回归契约采纳「既有 protected 套件零改动全绿 + 新增测试落
tests/skill-pins.test.ts」。