fix(claude-code-memory-plugin): improve Windows compatibility (#1249)

* fix(claude-code-memory-plugin): improve Windows compatibility

* docs(claude-code-memory-plugin): split marketplace link into a new paragraph

Author: Castor6

examples/claude-code-memory-plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "openviking-memory",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Long-term semantic memory for Claude Code, powered by OpenViking. Auto-recall relevant memories at session start and capture important information during conversations.",
   "author": {
     "name": "OpenViking",

examples/claude-code-memory-plugin/.mcp.json

@@ -3,7 +3,7 @@
     "command": "node",
     "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/start-memory-server.mjs"],
     "env": {
-      "OPENVIKING_CONFIG_FILE": "${OPENVIKING_CONFIG_FILE:-}"
+      "OPENVIKING_CONFIG_FILE": "${OPENVIKING_CONFIG_FILE}"
     }
   }
 }

examples/claude-code-memory-plugin/README.md

@@ -2,7 +2,9 @@
 
 Long-term semantic memory for Claude Code, powered by [OpenViking](https://github.com/volcengine/OpenViking).
 
-> Ported from the [OpenClaw context-engine plugin](../openclaw-plugin/) and adapted for Claude Code's plugin architecture (MCP + hooks).
+Provide a plugin marketplace repository for one-click installation: [openviking-plugins](https://github.com/Castor6/openviking-plugins)
+
+> Ported from the [OpenClaw context-engine plugin](https://github.com/volcengine/OpenViking/tree/main/examples/openclaw-plugin) and adapted for Claude Code's plugin architecture (MCP + hooks).
 
 ## Architecture
 
@@ -117,7 +119,7 @@ pipx install openviking
 
 ### 2. Create Config
 
-If you don't already have `~/.openviking/ov.conf`, create it:
+If you don't already have `~/.openviking/ov.conf`(Can override the default path via the environment variable `OPENVIKING_CONFIG_FILE`), create it:
 
 ```bash
 mkdir -p ~/.openviking
@@ -154,7 +156,8 @@ vim ~/.openviking/ov.conf
 }
 ```
 
-> `root_api_key`: Once set, all HTTP requests must carry the `X-API-Key` header. Defaults to `null` in local mode (authentication disabled).
+> `root_api_key`: Once set, all HTTP requests must carry the `X-API-Key` header. Defaults to `null` in local mode (authentication disabled).  
+> For Windows system paths in the workspace, use / instead of \, for example: `D:/.openviking/data`
 
 Optionally add a `claude_code` section for plugin-specific overrides:
 

examples/claude-code-memory-plugin/README_CN.md

@@ -2,7 +2,9 @@
 
 为 Claude Code 提供长期语义记忆功能，基于 [OpenViking](https://github.com/volcengine/OpenViking) 构建。
 
-> 移植自 [OpenClaw context-engine plugin](../openclaw-plugin/)，并适配 Claude Code 的插件架构（MCP + hooks）。
+提供一键安装的插件市场仓库：[openviking-plugins](https://github.com/Castor6/openviking-plugins)
+
+> 移植自 [OpenClaw context-engine plugin](https://github.com/volcengine/OpenViking/tree/main/examples/openclaw-plugin)，并适配 Claude Code 的插件架构（MCP + hooks）。
 
 ## 架构
 
@@ -114,7 +116,7 @@ pipx install openviking
 
 ### 2. 创建配置
 
-如果还没有 `~/.openviking/ov.conf`，请创建：
+如果还没有 `~/.openviking/ov.conf`（可通过环境变量 `OPENVIKING_CONFIG_FILE` 覆盖默认路径），请创建：
 
 ```bash
 mkdir -p ~/.openviking
@@ -151,7 +153,8 @@ vim ~/.openviking/ov.conf
 }
 ```
 
-> `root_api_key`：设置后，所有 HTTP 请求必须携带 `X-API-Key` 头。本地模式默认为 `null`（禁用认证）。
+> `root_api_key`：设置后，所有 HTTP 请求必须携带 `X-API-Key` 头。本地模式默认为 `null`（禁用认证）。  
+> windows 系统的 workspace 路径分隔请用 / ，不要用 \ ，如 `D:/.openviking/data`
 
 可选添加 `claude_code` 部分用于插件特定覆盖：
 

examples/claude-code-memory-plugin/scripts/runtime-common.mjs

@@ -190,6 +190,7 @@ export async function ensureRuntimeInstalled(paths, expectedState) {
       cwd: paths.runtimeRoot,
       encoding: "utf8",
       stdio: "pipe",
+      shell: process.platform === "win32",
     });
 
     if (result.error) throw result.error;