@mu-cabin/muc-cli 0.6.2 → 0.6.4

package/README.md

@@ -4,10 +4,42 @@
 
 0.6.0 迁入新版命令契约。要求 **Node.js ≥ 22.16**，使用内置 SQLite，无需独立 Supervisor、Launcher、Keychain、TUI 或客户端。运行时依赖已打包进单个 `dist/muc.mjs`。
 
+## 0.6.4 大群 @ 名单接收修复
+
+移除接收、读取和发送链路对 @ 人员列表的 100 人限制，完整保留名单，避免大群消息导致整批入站校验失败、无法确认接收和后续消息积压。账号格式与报文大小校验保持不变。升级后需重启 daemon，新代码才会生效。
+
 ## 0.6.2 附件下载修复
 
 图片和文件可下载到操作系统允许写入的目录，包括 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.4
+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 +93,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.4 的命令契约。旧的 `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 |
@@ -48,3 +50,5 @@
 普通文件发送默认不带尾注（包括带说明的文件消息）；明确 `--tail` 才添加。文件上传须完成服务端扫描并取得未来有效期，才会进入消息发送；扫描失败不会降级发送过期文件。
 
 附件下载按操作系统权限处理输出目录，支持 `/tmp`、共享目录和目录符号链接；仍不覆盖已有文件。`OUTPUT_PATH_INVALID` 表示路径无效或不可用，`OUTPUT_EXISTS` 表示目标文件已存在。省略 `outputPath` 使用账号私有下载目录。
+
+@ 人员列表不设固定人数上限，不截断接收或发送的名单；账号格式、正文及传输报文大小校验仍适用。

package/dist/muc.mjs

@@ -9425,7 +9425,7 @@ var V2StoredContentBlockSchema = external_exports.lazy(() => external_exports.di
   external_exports.object({
     type: external_exports.literal("text"),
     text: external_exports.string().min(1).max(32200),
-    mentions: external_exports.array(V2MentionSchema).max(100).optional()
+    mentions: external_exports.array(V2MentionSchema).optional()
   }).strict(),
   external_exports.object({
     type: external_exports.enum(["image", "file", "voice"]),
@@ -9495,7 +9495,7 @@ var V2MessageSchema = external_exports.object({
   createdAtMs: V2EpochMsSchema,
   readByPeer: external_exports.boolean().optional(),
   readByPeerIds: external_exports.array(V2SafeIdSchema).max(100).optional(),
-  mentionUserIds: external_exports.array(V2SafeIdSchema).max(100).optional(),
+  mentionUserIds: external_exports.array(V2SafeIdSchema).optional(),
   mentionsSelf: external_exports.boolean().optional(),
   countsAsUnread: external_exports.boolean().optional(),
   kind: V2MessageKindSchema,
@@ -10033,7 +10033,7 @@ var OutgoingContentBlockSchema = external_exports.discriminatedUnion("type", [
   external_exports.object({
     type: external_exports.literal("text"),
     text: external_exports.string().min(1).max(32e3),
-    mentions: external_exports.array(OutgoingMentionSchema).max(100).optional()
+    mentions: external_exports.array(OutgoingMentionSchema).optional()
   }).strict(),
   external_exports.object({
     type: external_exports.enum(["image", "file", "voice"]),
@@ -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.4",
   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",
@@ -14128,7 +14131,7 @@ var NativeStoredContentBlockSchema = external_exports.lazy(() => external_export
   external_exports.object({
     type: external_exports.literal("text"),
     text: external_exports.string().min(1).max(32e3),
-    mentions: external_exports.array(NativeMentionSchema).max(100).optional()
+    mentions: external_exports.array(NativeMentionSchema).optional()
   }).strict(),
   external_exports.object({
     type: external_exports.enum(["image", "file", "voice"]),
@@ -14179,7 +14182,7 @@ var NativeMessageSchema = external_exports.object({
   /** Stable peer ids from roaming payloads and realtime read receipts. */
   readByPeerIds: external_exports.array(SafeIdSchema).max(100).optional(),
   /** App-key-qualified protocol mention targets carried by this message. */
-  mentionUserIds: external_exports.array(SafeIdSchema).max(100).optional(),
+  mentionUserIds: external_exports.array(SafeIdSchema).optional(),
   /** Authoritative normalization result for an unread @me badge. */
   mentionsSelf: external_exports.boolean().optional(),
   /** Overrides direction-based unread semantics for visible system messages. */
@@ -14369,7 +14372,7 @@ var NativeOutgoingContentBlockSchema = external_exports.discriminatedUnion("type
   external_exports.object({
     type: external_exports.literal("text"),
     text: external_exports.string().min(1).max(32e3),
-    mentions: external_exports.array(NativeOutgoingMentionSchema).max(100).optional()
+    mentions: external_exports.array(NativeOutgoingMentionSchema).optional()
   }).strict(),
   external_exports.object({
     type: external_exports.enum(["image", "file", "voice"]),
@@ -14404,7 +14407,7 @@ var NativePlannedContentBlockSchema = external_exports.discriminatedUnion("type"
   external_exports.object({
     type: external_exports.literal("text"),
     text: external_exports.string().min(1).max(32200),
-    mentions: external_exports.array(NativeOutgoingMentionSchema).max(100).optional()
+    mentions: external_exports.array(NativeOutgoingMentionSchema).optional()
   }).strict(),
   external_exports.object({
     type: external_exports.enum(["image", "file", "voice"]),
@@ -14428,7 +14431,7 @@ var NativePersistedContentBlockSchema = external_exports.discriminatedUnion("typ
   external_exports.object({
     type: external_exports.literal("text"),
     text: external_exports.string().min(1).max(32200),
-    mentions: external_exports.array(NativeOutgoingMentionSchema).max(100).optional()
+    mentions: external_exports.array(NativeOutgoingMentionSchema).optional()
   }).strict(),
   external_exports.object({
     type: external_exports.enum(["image", "file", "voice"]),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mu-cabin/muc-cli",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "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.