ezllm 0.0.27 → 0.0.29

package/README.md

@@ -54,4 +54,24 @@ ezllm restart  # 重启
 ezllm install  # 装配/修复自带 Node 运行时的环境（幂等；自动迁移旧数据目录）
 ```
 
+环境坏掉时要「推倒重来」，加 `--force` 重装：它会先停服务、清空应用目录（清理日志与数据、
+重置运行时记录），再重新装配。**保留** `ezllm.config.json` 与 `hook.*` 用户钩子，
+故配置与自写逻辑不丢：
+
+```bash
+npx ezllm install --force   # 重装（清理应用目录后重新装配）
+```
+
+## 进阶：改写请求报文（可选）
+
+如果某个客户端每轮都在请求里塞大量固定内容（工具描述里内嵌的 API 手册、注入的记忆索引等），可以在网关侧裁掉，从根上省 token。
+
+把发布包里的 `hook.example.js` 复制到应用目录（默认 `~/.ezllm`）并改名为 **`hook.cjs`**，按注释改里面的规则，然后 `ezllm restart`。
+
+- **候选文件名**：`hook.cjs` → `hook.mjs` → `hook.js`，取第一个存在的。**推荐 `hook.cjs`**——`.js` 的解析模式（CJS 还是 ESM）取决于它祖先目录里最近的 `package.json`，不受你控制（比如家目录若有一份 `"type": "module"` 的 package.json，`hook.js` 里的 CJS 写法就会失效）；`.cjs` 强制按 CJS 解析，任何环境都稳。
+- **只有请求侧改写**一个钩子（`onModelRequest`）：在发往上游前改请求体/请求头，**改不了响应**。
+- **改完必须重启服务**：钩子在启动时加载，不支持运行期热加载。
+- **文件不存在 = 什么都不做**；文件写错也只打一条告警、服务照常启动（不会因为钩子报错而起不来）。
+- **改动的部分要保持内容稳定**（别插时间戳 / 随机 id），否则会打断上游的缓存前缀，命中率下降得不偿失。
+
 > 说明：本工具为个人本地使用设计，非高并发架构，不建议作为商业代理部署。

package/bin/ezllm.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+// ezllm CLI shim：实现由构建产物 dist/cli.js 承载（app/cli/src 源码打包）。
+import "../dist/cli.js";