@kenz1117/dsh-engram 0.7.15 → 0.7.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.en.md CHANGED
@@ -206,12 +206,17 @@ v0.7.13 fixes the every-turn failure on DSH 0.1.7 (native session format v4) ([#
206
206
  ## Development
207
207
 
208
208
  ```sh
209
- pnpm install # postinstall symlinks @deepseek-ai/* peers from ../deepseek-harness (run pnpm install && pnpm run build in the harness repo first)
209
+ pnpm install # prepare symlinks @deepseek-ai/* peers from ../deepseek-harness (run pnpm install && pnpm run build in the harness repo first); runs pnpm bundle automatically when lib/ is missing
210
210
  pnpm test # unit + composition tests; real-embedding e2e runs when ENGRAM_E2E=1 (HF_ENDPOINT configurable) and the network allows
211
211
  pnpm typecheck
212
212
  pnpm bundle
213
213
  ```
214
214
 
215
+ Two notes on install and build scripts:
216
+
217
+ - **GitHub source quick-install** (`dsh plugin add github:kenz1117/dsh-engram`) fetches sources; `prepare` runs `pnpm bundle` on the spot when `lib/` is missing. If that build fails, read the bundle section of the prepare log — not the host's misleading "no entry point".
218
+ - **Native build permission**: the native packages pulled in transitively by `@huggingface/transformers` (`onnxruntime-node`, `sharp`, `protobufjs`) need pnpm's permission to run their build scripts. pnpm 11 ignores the in-package `pnpm.onlyBuiltDependencies` field; the permission must live on the **consumer** side (profile / workspace) — pnpm 11 uses `allowBuilds` in `pnpm-workspace.yaml`, pnpm 10 uses `onlyBuiltDependencies` in the same file. Without it pnpm skips those builds and reports the skips as errors, leaving the embedder unusable; grant the permission and reinstall.
219
+
215
220
  ## Model Experience
216
221
 
217
222
  ### Request context and condition
package/README.md CHANGED
@@ -207,12 +207,17 @@ v0.7.13 修复 DSH 0.1.7(原生会话格式 v4)下的每回合失败([#5](
207
207
  ## 开发
208
208
 
209
209
  ```sh
210
- pnpm install # postinstall 会把 @deepseek-ai/* peer 从 ../deepseek-harness symlink 进来(需先在 harness 仓库 pnpm install && pnpm run build)
210
+ pnpm install # prepare 会把 @deepseek-ai/* peer 从 ../deepseek-harness symlink 进来(需先在 harness 仓库 pnpm install && pnpm run build);lib/ 缺失时自动执行 pnpm bundle
211
211
  pnpm test # 单测 + 组合测试;真实嵌入 e2e:ENGRAM_E2E=1(可配 HF_ENDPOINT)且网络可达时执行
212
212
  pnpm typecheck
213
213
  pnpm bundle
214
214
  ```
215
215
 
216
+ 安装与构建脚本的两点说明:
217
+
218
+ - **GitHub 源码快捷安装**(`dsh plugin add github:kenz1117/dsh-engram`)拿的是源码,`prepare` 会在 `lib/` 缺失时自动执行 `pnpm bundle` 现场构建——失败时看 prepare 日志的 bundle 段,而不是宿主报的 "no entry point"。
219
+ - **原生依赖构建许可**:`@huggingface/transformers` 传递的原生包(`onnxruntime-node`、`sharp`、`protobufjs`)需要 pnpm 允许运行构建脚本。pnpm 11 已忽略包内 `pnpm.onlyBuiltDependencies` 声明,许可必须写在**使用方**(profile / workspace)侧——pnpm 11 用 `pnpm-workspace.yaml` 的 `allowBuilds`,pnpm 10 用同文件的 `onlyBuiltDependencies`。未许可时 pnpm 会跳过这些构建并把跳过列为错误,嵌入功能不可用;许可后重装即可。
220
+
216
221
  ## Model Experience
217
222
 
218
223
  ### Request context and condition