Repository navigation
[PR] docs: host plugin integration contract - stable status/origin routes for third-party UI plugins (#4319) - #4447
ranxianglei wants to merge 2 commits into
Conversation
Extracted from PR #4327 per owner decision: the tab-naming/hiding side of the dsh-context coexistence work already shipped via merged PR #4238 (dsh.contextTab / dsh.contextTabLabel knobs), so only the stable-contract documentation remains from #4319. - README: new 'Host plugin integration' section — GET /bili/origin shapes (incl. the #4237 face flags, marked internal), GET /__bili/plugin/status stable field set, error shapes, loopback admin gate + trusted-Origin/CORS caveats, additive-evolution promise. - CLIENTS.md: pointer from the dsh Context-tab paragraph to that section. - PLUGIN.md: cross-ref in the status-route subsection for non-cooperative third-party readers.
ranxianglei
changed the title
📦 Built Package ArtifactBranch: Latest build — install this exact versionnpm install -g [email protected]This exact version is immutable and reproducible. The rolling Recent builds (commit → version)
Download artifact
tar xzf billion-context-pr4447.tgz
npm install -g packageInstall instructions are refreshed on each push. |
… profiles Review fix on #4447: the route registers only when a dsh web server exists (src/agent/dsh-native.ts — TUI/headless profiles never fire the callback), so 'older host build' was an incomplete account of the 404 case.
(ai: vllm-qwen/qwen3.8-27b) 查重: 不重复。这是 #4319 里 owner 拍板后从 #4327 拆出的纯文档部分(tab 命名侧已由合并的 #4238 覆盖),open/closed 里没有其他 issue 或 PR 覆盖这个文档范围。相关条目:#4319(本 PR 关闭它)、#4327(源 PR,见文末)、#4238(已合入)。 标签: dsh + scope/docs + p3(dsh 车道的第三方集成文档补齐,无运行时影响)。 已把 README、CLIENTS.md、PLUGIN.md 三处改动逐条对照 master 代码核实过:两条路由的响应形状( 八问:
review 中发现并已修(独立 commit 一个需要你决定的点:PR 正文说稳定字段集"incl. 另外:#4327(源 PR)现在被本提取 + #4238 完全取代,仍开着,建议由你关闭(agent 无权关 PR)。 CI:新 head 判定:可合(待 CI 全绿); |
|
位置不对 直接关闭 |
Extracted from PR #4327 per owner decision in #4319: the tab-naming/hiding side of the dsh-context coexistence work already shipped via merged PR #4238 (
dsh.contextTab/dsh.contextTabLabelknobs), so only the stable-contract documentation remains from #4319's accepted scope.What this adds (docs only, 3 files, +27/-2)
### Host plugin integrationsection (between "Client deep dives" and "From source"):GET /bili/origin: purpose, response shapes ({origin},{origin:null,relay:true}on relay builds,{origin:null}while still resolving; absent when the route does not exist), poll-while-unresolved caveat, plus a note that newer builds additionally carry the [Feature] DSH: The top "Context" tab shares its name with another plugin. Could it be merged into the "Memory System" pa | [Feature] DSH：顶部「上下文」标签页与另一插件重名，能否并入「记忆系统」页 #4237 face flags (contextTab, optionalcontextTabLabel) which are internal and safe to ignore.GET /__bili/plugin/status?conversationId=: the stable field set (same documented fields as PLUGIN.md section 4, incl.contextView), error shapes (400 / 404 /fallback=latestwording,phasevalues), access restrictions (loopback admin gate, trusted-Origin rules incl.dsh-app://app, CORS origin echo), and the additive-evolution promise.What is intentionally NOT here
The tab rename, banner rewording + repo link, and config-page note from original PR #4327 are dropped per owner decision (the tab side is covered by #4238). That content stays recoverable on branch
2026-10-22_dsh-coexistence-tab-docsif ever wanted back.Verification
Docs-only change: no code, no config surface, no wire/persistence impact. CI gates are the verdict.
Closes #4319