@mu-cabin/muc-cli 0.6.2 → 0.6.3

package/README.md

@@ -8,6 +8,34 @@
 
 图片和文件可下载到操作系统允许写入的目录，包括 macOS `/tmp`、共享目录和目录符号链接。路径无效或目标文件已存在时返回明确错误与修复提示，不再误报后台不支持操作。下载仍不覆盖已有文件。
 
+## 0.6.3 Windows 兼容修复
+
+修复 Windows 已有后台锁文件被 Unix 权限检查误判，导致 `login` 等命令无法启动后台的问题；单实例互斥继续由 Windows 命名管道保证。JSON stdin 支持 UTF-8 BOM 和 CRLF。源码清理和离线打包不再需要 Bash 或 `rm`。
+
+### Windows 安装与运行
+
+安装 Node.js 22.16 或更新版本，在 PowerShell 中运行（`npm.cmd` / `muc.cmd` 可避开 `.ps1` 执行策略限制）：
+
+```powershell
+node --version
+npm.cmd install -g @mu-cabin/muc-cli@0.6.3
+muc.cmd --version
+muc.cmd login --account YOUR_ACCOUNT --profile-id default --remember
+muc.cmd whoami --profile-id default
+```
+
+默认数据目录为 `%USERPROFILE%\.muc`。首次使用仍需管理员通过受保护 stdin 完成 `init`；升级已有配置无需重新初始化。更新前运行 `muc.cmd daemon stop`，安装后下次登录或查询会启动新版后台；使用自定义配置根时，停止和启动都指定同一 `--config-root`。
+
+PowerShell 不支持 Bash 的 `<<'JSON'`。JSON 可用单引号字符串通过管道传入；Windows PowerShell 5.1 先设置 UTF-8，防止中文被转换为问号：
+
+```powershell
+$OutputEncoding = [System.Text.UTF8Encoding]::new($false)
+'{"limit":20}' | muc.cmd exec chats.list --profile-id default
+'{"includeSelf":false}' | muc.cmd --output jsonl exec events.watch --profile-id default
+```
+
+CMD 可使用 `echo {"limit":20} | muc.cmd exec chats.list --profile-id default`。复杂 JSON 使用 UTF-8 文件重定向：`muc.cmd exec chats.list --profile-id default < request.json`。JSON 中的 Windows 路径使用 `C:/Users/NAME/Downloads/file.png` 或双反斜杠，含空格的命令行路径用双引号包围。密码仍只在用户终端的隐藏提示或受保护 stdin 输入。
+
 ## 配置和登录
 
 默认数据目录为 `~/.muc`；`MUC_CONFIG_DIR` 或全局 `--config-root` 可指定隔离目录。首次部署用 `muc init` 从受保护 stdin 接收管理员提供的租户和端点配置。
@@ -61,3 +89,5 @@ pnpm --filter @mu-cabin/muc-cli build
 ```
 
 仓库内的 `AGENTS.md` 与 `docs/development.md` 记录开发约定和验收证据；它们不属于安装包。Skill 源码随包发布，全局安装副本需另行安装。
+
+`pnpm --filter @mu-cabin/muc-cli clean` 和 `pack:offline` 支持 Windows、macOS、Linux。MUC 的运行时依赖已内嵌，`pack:offline` 直接生成普通 npm tarball `mu-cabin-muc-cli-<version>.tgz`，目标机器可用 `npm install -g --offline <tarball>` 安装，无需另行捆绑依赖。

package/REFERENCE.md

@@ -1,11 +1,13 @@
 # MUC 命令契约
 
-本文件描述 0.6.2 的命令契约。旧的 `send/history/daemon-*` 命令已移除。
+本文件描述 0.6.3 的命令契约。旧的 `send/history/daemon-*` 命令已移除。
 
 ## 命令结构
 
 全局参数放在命令之前：`muc [--config-root <绝对路径>] [--output json|jsonl|text] <命令>`。默认 JSON。配置根也可由 `MUC_CONFIG_DIR` 提供。
 
+Windows 默认配置根为 `%USERPROFILE%\.muc`。PowerShell 若阻止 npm 生成的 `muc.ps1`，使用 `muc.cmd`；无须修改执行策略。业务 JSON 输入使用 UTF-8，允许开头的 UTF-8 BOM 与 CRLF。PowerShell 5.1 管道应先设置 `$OutputEncoding = [System.Text.UTF8Encoding]::new($false)`；不要直接复制 Bash 的 `<<'JSON'` 语法。示例见 README 的 Windows 章节。
+
 | 命令 | 用途 |
 | --- | --- |
 | `init` | 从受保护 stdin 配置租户与初始 profile |

package/dist/muc.mjs

@@ -11446,7 +11446,7 @@ async function readJsonObject(io) {
   }
   let parsed;
   try {
-    parsed = JSON.parse(text2);
+    parsed = JSON.parse(text2.replace(/^\uFEFF/u, ""));
   } catch {
     throw new CliInputError("Operation input must be one valid JSON object.");
   }
@@ -11698,7 +11698,10 @@ async function ensureSafeLockFile(path) {
       throw error;
     }
     const entry = await lstat2(path);
-    if (!entry.isFile() || entry.isSymbolicLink() || (entry.mode & 63) !== 0) {
+    if (!entry.isFile() || entry.isSymbolicLink() || // Windows exposes synthetic mode bits; chmod cannot clear group/other
+    // access there. Keep the file/type checks and let the named pipe own
+    // mutual exclusion, as with the other private Windows state files.
+    process.platform !== "win32" && (entry.mode & 63) !== 0) {
       throw new SingleInstanceError();
     }
     if (typeof process.getuid === "function" && entry.uid !== process.getuid()) {
@@ -12323,7 +12326,7 @@ async function assertLegacyStopped(root) {
 // package.json
 var package_default = {
   name: "@mu-cabin/muc-cli",
-  version: "0.6.2",
+  version: "0.6.3",
   description: "Standalone agent-first MUC CLI with an embedded background daemon",
   license: "MIT",
   type: "module",
@@ -12350,11 +12353,11 @@ var package_default = {
     dev: "tsx src/index.ts",
     test: "pnpm build && vitest run",
     typecheck: "tsc --noEmit",
-    clean: "rm -rf dist",
+    clean: `node -e "require('node:fs').rmSync('dist', { recursive: true, force: true })"`,
     build: "node scripts/build.mjs",
     prepack: "pnpm typecheck && pnpm test",
     verify: "npm pack --dry-run",
-    "pack:offline": "bash ../../scripts/pack-offline.sh"
+    "pack:offline": "npm pack"
   },
   devDependencies: {
     "@types/node": "^22.19.15",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mu-cabin/muc-cli",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "Standalone agent-first MUC CLI with an embedded background daemon",
   "license": "MIT",
   "type": "module",
@@ -27,11 +27,11 @@
     "dev": "tsx src/index.ts",
     "test": "pnpm build && vitest run",
     "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist",
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
     "build": "node scripts/build.mjs",
     "prepack": "pnpm typecheck && pnpm test",
     "verify": "npm pack --dry-run",
-    "pack:offline": "bash ../../scripts/pack-offline.sh"
+    "pack:offline": "npm pack"
   },
   "devDependencies": {
     "@types/node": "^22.19.15",

package/skills/muc/SKILL.md

@@ -23,6 +23,15 @@ muc --output json exec chats.list --profile-id profile-id <<'JSON'
 JSON
 ```
 
+On Windows PowerShell use `muc.cmd` if the npm `muc.ps1` shim is blocked; do not change execution policy. Bash heredocs are not PowerShell syntax. Set UTF-8 output in Windows PowerShell 5.1 before piping JSON, especially Chinese text:
+
+```powershell
+$OutputEncoding = [System.Text.UTF8Encoding]::new($false)
+'{"limit":20}' | muc.cmd --output json exec chats.list --profile-id profile-id
+```
+
+CMD accepts `muc.cmd exec chats.list --profile-id profile-id < request.json` with a UTF-8 JSON file. A leading UTF-8 BOM and CRLF are supported. Use forward slashes or escaped backslashes inside JSON Windows paths. Windows storage defaults to `%USERPROFILE%\.muc`; stop the daemon for the same config root before upgrading.
+
 Default storage is `~/.muc`, overridden by `MUC_CONFIG_DIR` or `--config-root`. Normal commands may start the bundled daemon for this exact root. Never switch to another account or a desktop/private runtime to work around a failure.
 
 Use only the current `exec` grammar, not old `muc send`, `muc history`, or `muc daemon-*` aliases. Listening uses `events.watch`; the daemon keeps receiving after a consumer exits. Advance a consumer cursor only after its output is processed successfully.