pi2dsh 0.6.1 → 0.8.0

package/README.md

@@ -13,9 +13,12 @@ dsh plugin --profile headless add pi-vision-tool
 
 No conversion step, no generated bundles: the engine discovers every Pi
 package you added to the profile and mounts them all through one bridge
-instance. Remove with `dsh plugin remove <pkg>`; upgrade the engine with
-`dsh plugin add pi2dsh@latest` (your plugins are untouched), upgrade a
-plugin with `dsh plugin add <pkg>@latest` (the engine is untouched).
+instance. Mounting happens at startup — **restart `dsh` after adding or
+removing plugins**. Remove a plugin with `dsh plugin remove <pkg>` (remove
+plugins before removing the engine, or they sit unmounted); upgrade the
+engine with `dsh plugin add pi2dsh@latest` (your plugins are untouched),
+upgrade a plugin with `dsh plugin add <pkg>@latest` (the engine is
+untouched).
 
 If an add stops with `ERR_PNPM_IGNORED_BUILDS` (pnpm blocks dependency
 build scripts by default), set the listed packages to `true` under
@@ -133,7 +136,7 @@ is aspirational.
 | Example | What you get |
 |---|---|
 | [`examples/vision-bridge`](examples/vision-bridge/) | A text-only model answers questions about images: mention an image path, a configured vision model reads it, the analysis is injected into the conversation (works in CLI and the DSH web app; probe images included) |
-| [`examples/custom-models`](examples/custom-models/) | Define a provider once in Pi's standard `models.json` — it becomes a native DSH llm route: visible in the DSH web model picker, usable as the main model, and resolvable/callable by every Pi plugin through one directory |
+| [`examples/custom-gateways`](examples/custom-gateways/) | Add any OpenAI-compatible gateway the official DSH way (the `llm-pi-ai:` section of DSH settings) — it appears in the DSH model picker, works as the main model, and every Pi plugin sees it through the bridge's registry projection; the bridge owns zero model configuration |
 
 More verified capabilities (approval guardian, cross-session memory,
 interactive OAuth, MCP config conversion, host mode) get their examples as

package/README.zh.md

@@ -12,9 +12,10 @@ dsh plugin --profile headless add pi-vision-tool
 ```
 
 没有转换步骤、没有生成产物：引擎自动发现你加进 profile 的每个 Pi 包，
-全部经一份桥实例挂载。卸载用 `dsh plugin remove <包>`；升级引擎
-`dsh plugin add pi2dsh@latest`（插件不动），升级插件
-`dsh plugin add <包>@latest`（引擎不动）。
+全部经一份桥实例挂载。挂载发生在启动时——**加/卸插件后要重启 `dsh`**。
+卸插件用 `dsh plugin remove <包>`（先卸插件再卸引擎，否则插件留在依赖里
+没人挂载）；升级引擎 `dsh plugin add pi2dsh@latest`（插件不动），升级
+插件 `dsh plugin add <包>@latest`（引擎不动）。
 
 如果 add 报 `ERR_PNPM_IGNORED_BUILDS`（pnpm 默认拦依赖的构建脚本）：
 在 profile 的 `pnpm-workspace.yaml` 里把列出的包在 `allowBuilds` 下设为
@@ -123,7 +124,7 @@ npx pi2dsh mcp-config                               # Pi mcpServers → DSH patc
 | 示例 | 你得到什么 |
 |---|---|
 | [`examples/vision-bridge`](examples/vision-bridge/) | 纯文本模型回答图片问题：消息里带图片路径，配置的视觉模型识图，分析结果注入对话（CLI 与 DSH Web 都能用；附探针测试图） |
-| [`examples/custom-models`](examples/custom-models/) | 在 Pi 标准 `models.json` 里定义一次 provider——它成为原生 DSH llm 路由：出现在 DSH Web 模型选择器、可当主模型对话、所有 Pi 插件经同一个目录可见可调 |
+| [`examples/custom-gateways`](examples/custom-gateways/) | 用 DSH 官方方式（DSH settings 的 `llm-pi-ai:` 段）接入任意 OpenAI 兼容网关——出现在 DSH 模型选择器、可当主模型、所有 Pi 插件经桥的 registry 投影看到同一路由；桥自身零模型配置 |
 
 更多已验证能力（审批 guardian、跨会话记忆、交互式 OAuth、MCP 配置转换、host 模式）的示例，将按同一标准逐个重新端到端验证后补齐。