pi2dsh 0.6.0 → 0.7.0

package/README.md

@@ -13,9 +13,17 @@ 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
+`allowBuilds` in the profile's `pnpm-workspace.yaml` (or run
+`pnpm approve-builds` there), then re-run the add.
 
 ## Architecture
 

package/README.zh.md

@@ -12,9 +12,14 @@ 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` 下设为
+`true`（或在该目录跑 `pnpm approve-builds`），然后重跑 add。
 
 ## 架构