Part of #5040(E 系列文档收尾,维护者点名:「相关文档和 skills 更新了吗,包括例子」)。例子已齐(E8 回迁);本单补齐其余三层:
1. spec 内过时处方文本(源头修,经 regen 传播)
2. 手写 content/docs
3. 发布 skill
skills/objectstack-api/SKILL.md(及其 refs/evals 如有关联):按现状纳入声明式端点教学 —— 何时用 apis: vs contributes.routes、五道门与报错处方、D6(enabled: true 判据)、映射键最小语义;与 upgrade-guide 措辞对齐,不复述第二套规则(指向为主);skill 的既有 eval 若断言旧行为需同步。
约束
词表与运行时零触碰(纯文档/skill/处方文本);不动 content/docs/releases/;与 #5231(源码注释)不重叠。执行器车道程序卡,其它车道请勿认领。
Part of #5040(E 系列文档收尾,维护者点名:「相关文档和 skills 更新了吗,包括例子」)。例子已齐(E8 回迁);本单补齐其余三层:
1. spec 内过时处方文本(源头修,经 regen 传播)
App.apis的 retiredKey 墓碑文本(传播到content/docs/references/ui/app.mdx:89):仍写「stack 级 defineStack({ apis }) 在 v17 也不可执行(声明式apis:(ApiEndpoint)入站面全链路零执行:元数据装载成功、路由从未挂载、matchEndpoint全仓无实现 #4936),非空数组被拒,等执行器……先用 contributes.routes」—— 对升级者是误导性指令,执行器已落地(17.x 立项:建设声明式 ApiEndpoint 执行器(挂载 + matchEndpoint + authRequired/cacheTtl/inputMapping/outputMapping 逐键接线) #5040 E 系列,9f41ee6)。改为:v17 起defineStack({ apis })经五道 publish 门后真实服务,指向 upgrade-guide 的declarative-apis-endpoints-live条目;stack-server描述里同类 声明式apis:(ApiEndpoint)入站面全链路零执行:元数据装载成功、路由从未挂载、matchEndpoint全仓无实现 #4936 表述(传播到references/system/stack-server.mdx:68)同步修真;2. 手写 content/docs
content/docs/protocol/kernel/http-protocol.mdx:1042附近:「声明式apis:(ApiEndpoint)入站面全链路零执行:元数据装载成功、路由从未挂载、matchEndpoint全仓无实现 #4936 该面无执行器」段落改为现状(执行链:匹配 → 策略 → 委派;五道门;裸 404 恒等语义),含一个最小可跑的apis:声明示例;content/docs/getting-started/quick-reference.mdx:补声明式端点速查条目(路径 carve-out 形状、authRequired 缺省 true、D6 配对义务)。3. 发布 skill
skills/objectstack-api/SKILL.md(及其 refs/evals 如有关联):按现状纳入声明式端点教学 —— 何时用apis:vscontributes.routes、五道门与报错处方、D6(enabled: true判据)、映射键最小语义;与 upgrade-guide 措辞对齐,不复述第二套规则(指向为主);skill 的既有 eval 若断言旧行为需同步。约束
词表与运行时零触碰(纯文档/skill/处方文本);不动
content/docs/releases/;与 #5231(源码注释)不重叠。执行器车道程序卡,其它车道请勿认领。