@cup319/mmpl 2.7.0 → 2.7.1

package/README.md

@@ -181,6 +181,29 @@ HTTP server 启动后不自我守护，靠外部保活：
 
 > server 默认只绑 `127.0.0.1`（本机访问）。多 client 共享时**不要**起第二个 server 进程——DuckDB 文件是单进程独占的，第二个进程会启动失败；多个 client 都连同一个 HTTP URL 即可。
 
+### ZCode 集成：常驻 + 无弹窗（开箱即用）
+
+如果你在 ZCode 里用 mmpl，推荐用仓库自带的部署示例 [`examples/zcode-deploy/`](./examples/zcode-deploy/)。它通过 SessionStart/Stop hook 实现：
+
+- **常驻运行**：server 启动一次后一直留在后台，切换 ZCode session 不重启（避免每次等 5–10s ONNX 加载）
+- **无 node.exe 黑窗**：所有 `spawn` 配 `windowsHide: true`（修复了 Windows 上启动时弹 `C:\...\node.exe` 窗口的问题）
+- **日志落盘**：server 的 stdout/stderr 重定向到 `.mmpl-server.log`，排查启动失败有据可查
+
+一键安装：
+
+```bash
+# 1. 准备部署目录
+mkdir D:\mmpl-deploy && cd D:\mmpl-deploy
+npm init -y && npm install @cup319/mmpl
+# 2. 复制示例脚本
+cp /path/to/examples/zcode-deploy/*.mjs .
+# 3. 按示例 README 配置 ~/.zcode/cli/config.json 的 hook
+```
+
+完整步骤、配置示例、运行机制、弹窗 bug 修复历史详见 [`examples/zcode-deploy/README.md`](./examples/zcode-deploy/README.md)。
+
+> **澄清**：`@cup319/mmpl` npm 包本身不 spawn 子进程，**不存在弹窗问题**。弹窗只发生在用 `start-mmpl.mjs` 包装启动时（该脚本 spawn 子进程的方式在 Windows 上需要 `windowsHide`），示例脚本已修复。
+
 ### 遗留：stdio 模式
 
 v2.5.1 之前默认走 stdio，每个 client 各 spawn 一个进程。该模式已在 v2.5.1 移除（多 client 场景下 DuckDB 文件锁无法解决）。如确需单 client stdio，可 git checkout v2.4.4 标签。

package/dist/index.js

@@ -21748,7 +21748,7 @@ async function main() {
   const createMcpServer = () => {
     const server = new McpServer({
       name: "MMPL",
-      version: "2.7.0"
+      version: "2.7.1"
     });
     registerMemoryWrite(server, deps);
     registerMemorySearch(server, deps);
@@ -21771,7 +21771,7 @@ async function main() {
   void embeddingService.ready().catch((err) => {
     console.error("[startup] embedding service init failed:", err);
   });
-  console.error(`MMPL (Memory Palace) MCP Server v2.7.0 listening on http://${httpHost}:${httpPort}${httpPath}`);
+  console.error(`MMPL (Memory Palace) MCP Server v2.7.1 listening on http://${httpHost}:${httpPort}${httpPath}`);
   const gracefulShutdown = async (signal) => {
     console.error(`
 [shutdown] Received ${signal}, gracefully shutting down...`);