dsh-mnemon 0.1.4 → 0.1.5

package/README.md

@@ -40,6 +40,20 @@ go install github.com/mnemon-dev/mnemon@latest
 mnemon --version
 ```
 
+On Windows, install the official v0.2.3-or-newer release ZIP. This path is auto-discovered without changing `PATH`; see [Getting Started](./docs/en/getting-started.md#2-install-mnemon) for checksum verification:
+
+```powershell
+$version = '0.2.3'
+$arch = if ([System.Runtime.InteropServices.RuntimeInformation]::OSArchitecture -eq 'Arm64') { 'arm64' } else { 'amd64' }
+$archiveName = "mnemon_${version}_windows_${arch}.zip"
+$archive = Join-Path $env:TEMP $archiveName
+Invoke-WebRequest "https://github.com/mnemon-dev/mnemon/releases/download/v${version}/${archiveName}" -OutFile $archive
+$installDir = Join-Path $env:LOCALAPPDATA 'Programs\mnemon'
+New-Item -ItemType Directory -Force -Path $installDir | Out-Null
+Expand-Archive -Path $archive -DestinationPath $installDir -Force
+& (Join-Path $installDir 'mnemon.exe') --version
+```
+
 ### 2. Install the plugin
 
 ```sh

package/README.zh-CN.md

@@ -40,6 +40,20 @@ go install github.com/mnemon-dev/mnemon@latest
 mnemon --version
 ```
 
+Windows 推荐安装 v0.2.3 或更高版本的官方 ZIP；解压到以下目录后无需修改 `PATH` 即可自动发现。checksum 校验步骤见[入门指南](./docs/zh-CN/getting-started.md#2-安装-mnemon)：
+
+```powershell
+$version = '0.2.3'
+$arch = if ([System.Runtime.InteropServices.RuntimeInformation]::OSArchitecture -eq 'Arm64') { 'arm64' } else { 'amd64' }
+$archiveName = "mnemon_${version}_windows_${arch}.zip"
+$archive = Join-Path $env:TEMP $archiveName
+Invoke-WebRequest "https://github.com/mnemon-dev/mnemon/releases/download/v${version}/${archiveName}" -OutFile $archive
+$installDir = Join-Path $env:LOCALAPPDATA 'Programs\mnemon'
+New-Item -ItemType Directory -Force -Path $installDir | Out-Null
+Expand-Archive -Path $archive -DestinationPath $installDir -Force
+& (Join-Path $installDir 'mnemon.exe') --version
+```
+
 ### 2. 安装插件
 
 ```sh

package/cordis.patch.yml

@@ -1,5 +1,6 @@
-# Mount the Mnemon bridge into a DSH profile. The profile's own final patch
-# may replace this config row to select an explicit binary or data directory.
+# Mount the Mnemon bridge into a DSH profile. A profile's final patch may
+# replace this config row as a whole; use user settings or environment
+# variables for one-field overrides such as cliPath.
 - insert:
     - id: mnemon
       name: dsh-mnemon

package/docs/en/README.md

@@ -42,7 +42,7 @@ This hub is organized by what you need to accomplish. New users should follow Ge
 
 ## Documentation boundaries
 
-- User documentation targets the v0.1.4 Sidebar-default experience while covering the compatible Buildin presentation.
+- User documentation targets the v0.1.5 Sidebar-default experience while covering the compatible Buildin presentation.
 - Architecture diagrams describe stable execution boundaries, not live monitoring. Use Status for current counts and versions.
 - RPC is an internal Host-to-client protocol, not a promised stable external API.
 - There is no formal fixed DSH / Mnemon version matrix yet. Back up and validate in an isolated root before upgrading.

package/docs/en/configuration.md

@@ -103,13 +103,17 @@ Only the Mnemon durable tier under `data/<store>/mnemon.db` has native cross-age
 config.cliPath
   -> executable MNEMON_CLI_PATH
   -> each PATH directory
-  -> ~/.local/bin/mnemon
-  -> /opt/homebrew/bin/mnemon
-  -> /usr/local/bin/mnemon
-  -> /usr/bin/mnemon
+  -> Windows: GOBIN/mnemon.exe
+              first GOPATH/bin/mnemon.exe, or ~/go/bin/mnemon.exe
+              %LOCALAPPDATA%/Programs/mnemon/mnemon.exe
+              %ProgramFiles%/mnemon/mnemon.exe
+  -> Unix: ~/.local/bin/mnemon
+           /opt/homebrew/bin/mnemon
+           /usr/local/bin/mnemon
+           /usr/bin/mnemon
 ```
 
-An explicit `cliPath` is accepted as configured; if it is not executable, actual calls return a launch error.
+An explicit `cliPath` is accepted as configured; if it is not executable, actual calls return a launch error. Automatically discovered Windows commands must be regular `.exe` files. `.cmd` and `.bat` wrappers are intentionally excluded because process execution does not use a shell.
 
 ## Compatibility Store Hint Precedence
 
@@ -188,7 +192,7 @@ routingGuidance=false
 
 ## Profile Patch Overrides
 
-The bundled `cordis.patch.yml` provides the default config row. A DSH profile configuration with the same ID may replace that row as a whole. When customizing a patch, retain every key that must remain enabled instead of assuming a deep merge.
+The bundled `cordis.patch.yml` provides the default config row. A DSH profile configuration with the same ID may replace that row as a whole. Do not add only `cliPath` to a final profile patch: use `MNEMON_CLI_PATH` or the `mnemon.cliPath` user setting instead. When a profile patch must be customized for another reason, retain every key that must remain enabled instead of assuming a deep merge.
 
 ## Common Configurations
 
@@ -199,6 +203,13 @@ mnemon:
   storageScope: workspace
 ```
 
+An explicit Windows CLI path:
+
+```yaml
+mnemon:
+  cliPath: 'C:\Users\alice\AppData\Local\Programs\mnemon\mnemon.exe'
+```
+
 A custom data volume and a longer CLI timeout:
 
 ```yaml

package/docs/en/getting-started.md

@@ -14,7 +14,7 @@ You need:
 
 Regular semantic work prefers a provider named `spawn` with `outputSchema`, `toolFilter`, `persona`, and `depthLimit`. Optional score-based background review additionally requires a provider named `fork` with `inheritsParentContext=true`. Missing `fork` does not block deterministic pages or regular manual actions.
 
-The project does not declare a fixed minimum DSH / Mnemon matrix. This guide and its screenshots target dsh-mnemon v0.1.4. Back up and repeat this verification against an isolated root before upgrading.
+The project does not declare a fixed minimum DSH / Mnemon matrix. This guide and its screenshots target dsh-mnemon v0.1.5. Back up and repeat this verification against an isolated root before upgrading.
 
 ## 2. Install Mnemon
 
@@ -24,7 +24,7 @@ Homebrew Cask is recommended on macOS:
 brew install --cask mnemon-dev/tap/mnemon
 ```
 
-On macOS or Linux, Go is another option:
+Go works on macOS and Linux:
 
 ```sh
 go install github.com/mnemon-dev/mnemon@latest
@@ -36,7 +36,51 @@ Verify the binary:
 mnemon --version
 ```
 
-If DSH cannot find it on `PATH`, set `MNEMON_CLI_PATH` or configure an absolute `mnemon.cliPath`. `mnemon status` opens the effective Store and may initialize data or run upstream migrations, so it is not a side-effect-free installation probe.
+On Windows, the official release provides ZIP archives for AMD64 and ARM64. The following PowerShell installs v0.2.3 under the auto-discovered per-user Programs directory and verifies it against the published checksum:
+
+```powershell
+$version = '0.2.3'
+$arch = if ([System.Runtime.InteropServices.RuntimeInformation]::OSArchitecture -eq 'Arm64') { 'arm64' } else { 'amd64' }
+$archiveName = "mnemon_${version}_windows_${arch}.zip"
+$releaseBase = "https://github.com/mnemon-dev/mnemon/releases/download/v${version}"
+$archive = Join-Path $env:TEMP $archiveName
+$checksumFile = Join-Path $env:TEMP "mnemon_${version}_checksums.txt"
+Invoke-WebRequest "${releaseBase}/${archiveName}" -OutFile $archive
+Invoke-WebRequest "${releaseBase}/checksums.txt" -OutFile $checksumFile
+$line = Get-Content $checksumFile | Where-Object { $_.EndsWith("  $archiveName") } | Select-Object -First 1
+if (-not $line) { throw "Checksum entry not found for $archiveName" }
+$expected = (($line -split '\s+')[0]).ToLowerInvariant()
+$actual = (Get-FileHash -Path $archive -Algorithm SHA256).Hash.ToLowerInvariant()
+if ($actual -ne $expected) { throw "Checksum mismatch for $archiveName" }
+$installDir = Join-Path $env:LOCALAPPDATA 'Programs\mnemon'
+New-Item -ItemType Directory -Force -Path $installDir | Out-Null
+Expand-Archive -Path $archive -DestinationPath $installDir -Force
+$mnemon = Join-Path $installDir 'mnemon.exe'
+& $mnemon --version
+```
+
+Go remains an alternative when a Go toolchain is already available:
+
+```powershell
+go install github.com/mnemon-dev/mnemon@latest
+$mnemonBin = go env GOBIN
+if (-not $mnemonBin) {
+  $mnemonBin = Join-Path (((go env GOPATH) -split ';')[0]) 'bin'
+}
+$mnemon = Join-Path $mnemonBin 'mnemon.exe'
+& $mnemon --version
+```
+
+On Windows, dsh-mnemon discovers native `mnemon.exe` from `PATH`, an exported `GOBIN` or `GOPATH`, the default `%USERPROFILE%\go\bin`, `%LOCALAPPDATA%\Programs\mnemon`, and Program Files. `.cmd` and `.bat` wrappers are not accepted because CLI calls deliberately run without a shell.
+
+If DSH still cannot find the binary, set `MNEMON_CLI_PATH` or add an absolute path to the user settings file instead of replacing the plugin's profile patch:
+
+```yaml
+mnemon:
+  cliPath: 'C:\Users\alice\AppData\Local\Programs\mnemon\mnemon.exe'
+```
+
+`mnemon status` opens the effective Store and may initialize data or run upstream migrations, so it is not a side-effect-free installation probe.
 
 ## 3. Install dsh-mnemon
 
@@ -103,7 +147,7 @@ Confirm that:
 - the storage root matches your chosen scope;
 - Runtime, Memory Spaces, and Documents report no errors.
 
-If Mnemon is unavailable, run `command -v mnemon` and `mnemon --version`. See [Troubleshooting](./operations.md#troubleshooting) for other symptoms.
+If Mnemon is unavailable, run `command -v mnemon` and `mnemon --version` on macOS/Linux, or `Get-Command mnemon` and `Test-Path "$env:LOCALAPPDATA\Programs\mnemon\mnemon.exe"` on Windows PowerShell. See [Troubleshooting](./operations.md#troubleshooting) for other symptoms.
 
 ## 6. Complete first verification
 

package/docs/en/operations.md

@@ -11,6 +11,13 @@ command -v mnemon
 mnemon --version
 ```
 
+Windows PowerShell:
+
+```powershell
+Get-Command mnemon -ErrorAction SilentlyContinue
+Test-Path "$env:LOCALAPPDATA\Programs\mnemon\mnemon.exe"
+```
+
 ```text
 /mnemon status
 ```
@@ -125,7 +132,7 @@ Report vulnerabilities privately through [SECURITY.md](../../SECURITY.md), not a
 
 | Symptom | Check and resolution |
 |---|---|
-| Mnemon unavailable | Run `command -v mnemon`, `mnemon --version`; set `MNEMON_CLI_PATH` or `cliPath`, then restart |
+| Mnemon unavailable | macOS/Linux: run `command -v mnemon`, `mnemon --version`. Windows PowerShell: run `Get-Command mnemon`, `Test-Path "$env:LOCALAPPDATA\Programs\mnemon\mnemon.exe"`. Set `MNEMON_CLI_PATH` or `mnemon.cliPath`, then restart |
 | Memory System missing from sidebar | Check `tabEnabled=true`, `displayMode=sidebar`; Buildin is in the conversation area; for a local link run `pnpm run build`, then restart |
 | Status healthy but recall empty | Check active spaces, storage scope, inspected root, effective session root, and query focus |
 | Header reports misalignment | The workbench is inspecting another workspace; align or keep deliberate read-only inspection; Agent-backed actions are rejected |

package/docs/en/ui-guide.md

@@ -2,7 +2,7 @@
 
 [简体中文](../zh-CN/ui-guide.md) | **English** | [Documentation hub](./README.md)
 
-This guide follows the default `sidebar` presentation and a real user path through Memory System. Screenshots come from the v0.1.4 interface and use the Chinese locale; names, counts, and content vary with your data.
+This guide follows the default `sidebar` presentation and a real user path through Memory System. Screenshots come from the v0.1.5 interface and use the Chinese locale; names, counts, and content vary with your data.
 
 ## Start with the two display modes
 

package/docs/zh-CN/README.md

@@ -42,7 +42,7 @@
 
 ## 文档边界
 
-- 用户文档以 v0.1.4 的 Sidebar 默认体验为主，同时说明 Buildin 兼容形态。
+- 用户文档以 v0.1.5 的 Sidebar 默认体验为主，同时说明 Buildin 兼容形态。
 - 架构图表达稳定执行边界，不是实时监控面板；实时数量与版本以“状态”页为准。
 - RPC 是 Host 与插件客户端之间的内部协议，不承诺稳定外部 API。
 - 当前没有正式固定的 DSH / Mnemon 版本矩阵；升级前应备份并在隔离目录验证。

package/docs/zh-CN/configuration.md

@@ -103,13 +103,17 @@ mnemon:
 config.cliPath
   -> executable MNEMON_CLI_PATH
   -> each PATH directory
-  -> ~/.local/bin/mnemon
-  -> /opt/homebrew/bin/mnemon
-  -> /usr/local/bin/mnemon
-  -> /usr/bin/mnemon
+  -> Windows: GOBIN/mnemon.exe
+              first GOPATH/bin/mnemon.exe, or ~/go/bin/mnemon.exe
+              %LOCALAPPDATA%/Programs/mnemon/mnemon.exe
+              %ProgramFiles%/mnemon/mnemon.exe
+  -> Unix: ~/.local/bin/mnemon
+           /opt/homebrew/bin/mnemon
+           /usr/local/bin/mnemon
+           /usr/bin/mnemon
 ```
 
-显式 `cliPath` 会被采用；若它不可执行，实际调用会返回启动错误。
+显式 `cliPath` 会被采用；若它不可执行，实际调用会返回启动错误。Windows 自动发现只接受普通 `.exe` 文件；进程执行不使用 shell，因此有意排除 `.cmd` 与 `.bat` wrapper。
 
 ## 兼容 Store 提示优先级
 
@@ -188,7 +192,7 @@ routingGuidance=false
 
 ## Profile patch 覆盖
 
-包内 `cordis.patch.yml` 提供默认 config 行。DSH profile 的同 ID 配置可能整体覆盖这行；自定义 patch 时应保留仍需启用的键，而不是假设深合并。
+包内 `cordis.patch.yml` 提供默认 config 行。DSH profile 的同 ID 配置可能整体覆盖这行。不要在 profile 的最终 patch 中只增加 `cliPath`；请改用 `MNEMON_CLI_PATH` 或用户设置 `mnemon.cliPath`。确因其他原因需要自定义 profile patch 时，应保留仍需启用的全部键，而不是假设深合并。
 
 ## 常见配置
 
@@ -199,6 +203,13 @@ mnemon:
   storageScope: workspace
 ```
 
+显式指定 Windows CLI 路径：
+
+```yaml
+mnemon:
+  cliPath: 'C:\Users\alice\AppData\Local\Programs\mnemon\mnemon.exe'
+```
+
 自定义数据盘和较长 CLI 超时：
 
 ```yaml

package/docs/zh-CN/getting-started.md

@@ -14,7 +14,7 @@
 
 普通语义任务优先使用名为 `spawn` 的 Provider，并要求 `outputSchema`、`toolFilter`、`persona` 与 `depthLimit`。可选的评分后台审查还要求名为 `fork`、且 `inheritsParentContext=true` 的 Provider。缺少 `fork` 不影响确定性页面读取和普通手动操作。
 
-项目当前不声明固定的 DSH / Mnemon 最低版本矩阵。本文与截图以 dsh-mnemon v0.1.4 为基线；升级前先备份，并在隔离目录重复本页验证。
+项目当前不声明固定的 DSH / Mnemon 最低版本矩阵。本文与截图以 dsh-mnemon v0.1.5 为基线；升级前先备份，并在隔离目录重复本页验证。
 
 ## 2. 安装 Mnemon
 
@@ -24,7 +24,7 @@ macOS 推荐 Homebrew Cask：
 brew install --cask mnemon-dev/tap/mnemon
 ```
 
-macOS 或 Linux 也可通过 Go 安装：
+macOS 和 Linux 可通过 Go 安装：
 
 ```sh
 go install github.com/mnemon-dev/mnemon@latest
@@ -36,7 +36,51 @@ go install github.com/mnemon-dev/mnemon@latest
 mnemon --version
 ```
 
-如果 DSH 无法从 `PATH` 找到它，可设置 `MNEMON_CLI_PATH`，或把绝对路径写入 `mnemon.cliPath`。`mnemon status` 会打开有效 Store，可能初始化数据或执行上游迁移，不要把它当作完全无副作用的安装探测。
+Windows 官方发行包同时提供 AMD64 与 ARM64 ZIP。下面的 PowerShell 会把 v0.2.3 安装到可自动发现的用户 Programs 目录，并使用官方 checksum 校验下载内容：
+
+```powershell
+$version = '0.2.3'
+$arch = if ([System.Runtime.InteropServices.RuntimeInformation]::OSArchitecture -eq 'Arm64') { 'arm64' } else { 'amd64' }
+$archiveName = "mnemon_${version}_windows_${arch}.zip"
+$releaseBase = "https://github.com/mnemon-dev/mnemon/releases/download/v${version}"
+$archive = Join-Path $env:TEMP $archiveName
+$checksumFile = Join-Path $env:TEMP "mnemon_${version}_checksums.txt"
+Invoke-WebRequest "${releaseBase}/${archiveName}" -OutFile $archive
+Invoke-WebRequest "${releaseBase}/checksums.txt" -OutFile $checksumFile
+$line = Get-Content $checksumFile | Where-Object { $_.EndsWith("  $archiveName") } | Select-Object -First 1
+if (-not $line) { throw "Checksum entry not found for $archiveName" }
+$expected = (($line -split '\s+')[0]).ToLowerInvariant()
+$actual = (Get-FileHash -Path $archive -Algorithm SHA256).Hash.ToLowerInvariant()
+if ($actual -ne $expected) { throw "Checksum mismatch for $archiveName" }
+$installDir = Join-Path $env:LOCALAPPDATA 'Programs\mnemon'
+New-Item -ItemType Directory -Force -Path $installDir | Out-Null
+Expand-Archive -Path $archive -DestinationPath $installDir -Force
+$mnemon = Join-Path $installDir 'mnemon.exe'
+& $mnemon --version
+```
+
+如果已经安装 Go 工具链，也可以继续使用 Go：
+
+```powershell
+go install github.com/mnemon-dev/mnemon@latest
+$mnemonBin = go env GOBIN
+if (-not $mnemonBin) {
+  $mnemonBin = Join-Path (((go env GOPATH) -split ';')[0]) 'bin'
+}
+$mnemon = Join-Path $mnemonBin 'mnemon.exe'
+& $mnemon --version
+```
+
+Windows 上，dsh-mnemon 会从 `PATH`、导出的 `GOBIN` 或 `GOPATH`、默认 `%USERPROFILE%\go\bin`、`%LOCALAPPDATA%\Programs\mnemon` 和 Program Files 中发现原生 `mnemon.exe`。CLI 调用刻意禁用 shell，因此不接受 `.cmd` 与 `.bat` wrapper。
+
+如果 DSH 仍无法找到二进制，请设置 `MNEMON_CLI_PATH`，或在用户 settings 中写入绝对路径；不要为此整体替换插件的 profile patch：
+
+```yaml
+mnemon:
+  cliPath: 'C:\Users\alice\AppData\Local\Programs\mnemon\mnemon.exe'
+```
+
+`mnemon status` 会打开有效 Store，可能初始化数据或执行上游迁移，不要把它当作完全无副作用的安装探测。
 
 ## 3. 安装 dsh-mnemon
 
@@ -103,7 +147,7 @@ dsh plugin --profile web remove dsh-mnemon
 - 存储根与刚才选择的范围一致；
 - Runtime、Memory Spaces 和 Documents 没有错误提示。
 
-如果 Mnemon 不可用，先运行 `command -v mnemon` 与 `mnemon --version`。更多症状见[故障排查](./operations.md#故障排查)。
+如果 Mnemon 不可用，macOS/Linux 先运行 `command -v mnemon` 与 `mnemon --version`；Windows PowerShell 运行 `Get-Command mnemon` 与 `Test-Path "$env:LOCALAPPDATA\Programs\mnemon\mnemon.exe"`。更多症状见[故障排查](./operations.md#故障排查)。
 
 ## 6. 完成第一次验证
 

package/docs/zh-CN/operations.md

@@ -11,6 +11,13 @@ command -v mnemon
 mnemon --version
 ```
 
+Windows PowerShell：
+
+```powershell
+Get-Command mnemon -ErrorAction SilentlyContinue
+Test-Path "$env:LOCALAPPDATA\Programs\mnemon\mnemon.exe"
+```
+
 ```text
 /mnemon status
 ```
@@ -125,7 +132,7 @@ mnemon --version
 
 | 现象 | 检查与处理 |
 |---|---|
-| Mnemon 不可用 | 运行 `command -v mnemon`、`mnemon --version`；设置 `MNEMON_CLI_PATH` 或 `cliPath` 后重启 |
+| Mnemon 不可用 | macOS/Linux 运行 `command -v mnemon`、`mnemon --version`；Windows PowerShell 运行 `Get-Command mnemon`、`Test-Path "$env:LOCALAPPDATA\Programs\mnemon\mnemon.exe"`。设置 `MNEMON_CLI_PATH` 或 `mnemon.cliPath` 后重启 |
 | 左侧栏没有“记忆系统” | 检查 `tabEnabled=true`、`displayMode=sidebar`；Buildin 位于对话区；本地 link 先 `pnpm run build` 再重启 profile |
 | 状态正常但召回为空 | 检查 active 记忆体、存储范围、查看目录、会话实际目录和查询是否足够聚焦 |
 | 顶部提示目录未对齐 | 工作台正在查看另一个工作区；点击一键对齐，或有意保留只读查看；Agent-backed 操作在未对齐时拒绝 |

package/docs/zh-CN/ui-guide.md

@@ -2,7 +2,7 @@
 
 **简体中文** | [English](../en/ui-guide.md) | [文档中心](./README.md)
 
-本指南以默认的 `sidebar` 形态为主，按真实使用路径介绍记忆系统。截图来自 v0.1.4 实机界面；数量、名称和内容会随你的数据变化。
+本指南以默认的 `sidebar` 形态为主，按真实使用路径介绍记忆系统。截图来自 v0.1.5 实机界面；数量、名称和内容会随你的数据变化。
 
 ## 先认识两种展示形态