multi-claude-cli 0.13.0__tar.gz → 0.15.0__tar.gz

{multi_claude_cli-0.13.0 → multi_claude_cli-0.15.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: multi-claude-cli
-Version: 0.13.0
+Version: 0.15.0
 Summary: Run several Claude Code accounts side by side: separate CLAUDE_CONFIG_DIR directories, launchers, proxies, environment variables and arguments.
 License: MIT
 Project-URL: Homepage, https://github.com/jakoes-wu/multi-claude
@@ -11,6 +11,7 @@ Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.8
@@ -27,13 +28,14 @@ Dynamic: license-file
 
 # multi-claude
 
-**English** | [简体中文](README.zh-CN.md)
+**English** | [简体中文](https://github.com/jakoes-wu/multi-claude/blob/main/README.zh-CN.md)
 
 [![Release](https://img.shields.io/github/v/release/jakoes-wu/multi-claude)](https://github.com/jakoes-wu/multi-claude/releases)
 [![CI](https://github.com/jakoes-wu/multi-claude/actions/workflows/ci.yml/badge.svg)](https://github.com/jakoes-wu/multi-claude/actions/workflows/ci.yml)
 [![PyPI](https://img.shields.io/pypi/v/multi-claude-cli)](https://pypi.org/project/multi-claude-cli/)
 ![Python](https://img.shields.io/badge/python-3.8%2B-blue)
-[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](https://github.com/jakoes-wu/multi-claude/blob/main/LICENSE)
+![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey)
 
 Use several [Claude Code](https://code.claude.com/docs) accounts on one machine, at the same time. Each account keeps its own login, settings and history and, if you like, its own proxy. No more logging out and in again.
 
@@ -84,7 +86,7 @@ The launchers are plain shell scripts. They keep working even if you uninstall m
 
 | | Needed | Optional |
 | ---- | ---- | ---- |
-| Operating system | macOS or Linux (WSL counts as Linux) | — |
+| Operating system | macOS, Linux (WSL counts as Linux) or Windows | — |
 | Tools | Python 3.8+ (`python3`, standard library only); Claude Code (`claude`); `curl` or `wget`, and `tar`, for the installer | `pipx` or Homebrew, to install from PyPI or the tap; `lsof`, so that `migrate-default` and `restore` can find processes using `~/.claude` (Linux falls back to `/proc`); VS Code's `code` command, for `multi-claude code` |
 
 Install what is missing:
@@ -100,7 +102,16 @@ sudo apt install -y python3 curl tar lsof
 curl -fsSL https://claude.ai/install.sh | bash    # Claude Code, if you do not have it yet
 ```
 
-Windows itself is not supported yet; use WSL. Other ways to install Claude Code: https://code.claude.com/docs/en/setup
+On Windows, install Python 3.8+ from https://www.python.org/downloads/windows/ or the Microsoft Store, then in
+PowerShell:
+
+```powershell
+irm https://claude.ai/install.ps1 | iex    # Claude Code, if you do not have it yet
+python -m pip install --user pipx
+python -m pipx ensurepath                  # then open a new terminal
+```
+
+Other ways to install Claude Code: https://code.claude.com/docs/en/setup
 
 ## Installation
 
@@ -130,6 +141,38 @@ With Homebrew: `brew install jakoes-wu/tap/multi-claude` (upgrade with `brew upg
 
 Run `./install.sh --help` for all options.
 
+### Windows
+
+Windows support is new. Install with `pipx install multi-claude-cli`; the installer script is for macOS and Linux
+only. Everything above works the same way, with these differences:
+
+- Launchers are `claude-<name>.cmd` and `claude-auto.cmd` in `%USERPROFILE%\.local\bin` (the directory
+  `pipx ensurepath` adds to `PATH`), so they run from PowerShell and cmd alike. They read the proxy, variables
+  and arguments from the configuration each time they start, so a change takes effect without `apply`.
+- Account directories are in `%USERPROFILE%\.cc` and the configuration in `%APPDATA%\multi-claude`.
+- Shared directories are linked with directory junctions, which need no special rights. Sharing a single file
+  (such as `CLAUDE.md`) needs a file symbolic link, which needs Developer Mode (Settings > System > For
+  developers) or an administrator terminal; without it, `add` and `apply` stop and say so. Exclude the file
+  with `--shared-exclude` to share the rest.
+- `migrate-default` refuses while any Claude process is running: Windows does not let it see which account
+  another process uses. Close every Claude window, terminal and IDE first.
+- `statusline` needs Git for Windows, whose Git Bash is what Claude Code uses to run the status line. A
+  `statusLine` setting with `"shell": "powershell"` cannot be wrapped.
+- Paths containing `"`, `%` or `!` cannot be written into a `.cmd` launcher; `apply` reports such an account as
+  a conflict.
+- cmd reads a `.cmd` file in the console code page, so a launcher never contains non-ASCII characters. When the
+  Python or package path has them (for example a Chinese user name), the launcher writes it as
+  `%USERPROFILE%\...` (or `%LOCALAPPDATA%`, `%APPDATA%`), or else as its 8.3 short name. A non-ASCII path
+  that cannot be written with a variable and has no short name is reported as a conflict.
+- When Claude exits (Ctrl+C or `/exit`), cmd may flash "Terminate batch job (Y/N)?" for a moment: the launcher is
+  a batch file. It closes by itself; Claude has already exited and nothing is lost.
+- `multi-claude completion powershell | Add-Content $PROFILE` adds tab completion to PowerShell. Do not use `>>`:
+  Windows PowerShell 5.1 writes it as UTF-16 and breaks an existing profile. If the profile's directory does not
+  exist yet, create it first with `New-Item -ItemType Directory -Force (Split-Path $PROFILE)`.
+
+Continuous integration runs the Windows-specific tests on Windows (`tests/test_windows.py`); the rest of the test
+suite runs on macOS and Linux only.
+
 ## Quick start
 
 ### 1. Create one account per login
@@ -456,6 +499,7 @@ Notes:
 multi-claude completion bash > ~/.local/share/bash-completion/completions/multi-claude
 multi-claude completion zsh > "${fpath[1]}/_multi-claude"   # or any directory on your fpath
 multi-claude completion fish > ~/.config/fish/completions/multi-claude.fish
+multi-claude completion powershell | Add-Content $PROFILE         # Windows PowerShell
 ```
 
 ## Migrating `~/.claude`
@@ -535,6 +579,8 @@ It never copies, exports, uploads or backs up a login. One command touches one:
 
 ### Commands
 
+Every command's `--help` ends with examples you can copy, covering its options, e.g. `multi-claude route --help`.
+
 | Command | What it does |
 | ---- | ---- |
 | `multi-claude init [--root DIR] [--bin-dir DIR] [--shared-dir DIR] [--shared-items A,B]` | Create or change global settings. |
@@ -575,13 +621,13 @@ Every write command accepts `--dry-run`, and prints only what changes; add `--ve
 | ---- | ---- |
 | Account directories | `~/.cc/<name>` |
 | Launchers | `~/.local/bin/claude-<name>` |
-| Configuration | `~/.config/multi-claude/config.json` (honours `XDG_CONFIG_HOME`) |
+| Configuration | `~/.config/multi-claude/config.json` (honours `XDG_CONFIG_HOME`); on Windows `%APPDATA%\multi-claude\config.json` |
 
 Account names may contain letters, digits and `._@+-`, must start with a letter or digit, and are case-insensitive (`Work` and `work` are the same account). An email address works as a name. Entries starting with `.` in the root directory are never treated as accounts.
 
 ### Declarative setup with `apply`
 
-See [`examples/config.example.json`](examples/config.example.json):
+See [`examples/config.example.json`](https://github.com/jakoes-wu/multi-claude/blob/main/examples/config.example.json):
 
 ```json
 {
@@ -642,7 +688,7 @@ This removes the tool only. Your configuration, account directories (including t
 
 ## Contributing
 
-See [CONTRIBUTING.md](CONTRIBUTING.md). Run the tests with:
+See [CONTRIBUTING.md](https://github.com/jakoes-wu/multi-claude/blob/main/CONTRIBUTING.md). Run the tests with:
 
 ```sh
 python3 -m unittest discover -s tests -t tests
@@ -650,4 +696,4 @@ python3 -m unittest discover -s tests -t tests
 
 ## License
 
-[MIT](LICENSE)
+[MIT](https://github.com/jakoes-wu/multi-claude/blob/main/LICENSE)

{multi_claude_cli-0.13.0 → multi_claude_cli-0.15.0}/README.md

@@ -1,12 +1,13 @@
 # multi-claude
 
-**English** | [简体中文](README.zh-CN.md)
+**English** | [简体中文](https://github.com/jakoes-wu/multi-claude/blob/main/README.zh-CN.md)
 
 [![Release](https://img.shields.io/github/v/release/jakoes-wu/multi-claude)](https://github.com/jakoes-wu/multi-claude/releases)
 [![CI](https://github.com/jakoes-wu/multi-claude/actions/workflows/ci.yml/badge.svg)](https://github.com/jakoes-wu/multi-claude/actions/workflows/ci.yml)
 [![PyPI](https://img.shields.io/pypi/v/multi-claude-cli)](https://pypi.org/project/multi-claude-cli/)
 ![Python](https://img.shields.io/badge/python-3.8%2B-blue)
-[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](https://github.com/jakoes-wu/multi-claude/blob/main/LICENSE)
+![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey)
 
 Use several [Claude Code](https://code.claude.com/docs) accounts on one machine, at the same time. Each account keeps its own login, settings and history and, if you like, its own proxy. No more logging out and in again.
 
@@ -57,7 +58,7 @@ The launchers are plain shell scripts. They keep working even if you uninstall m
 
 | | Needed | Optional |
 | ---- | ---- | ---- |
-| Operating system | macOS or Linux (WSL counts as Linux) | — |
+| Operating system | macOS, Linux (WSL counts as Linux) or Windows | — |
 | Tools | Python 3.8+ (`python3`, standard library only); Claude Code (`claude`); `curl` or `wget`, and `tar`, for the installer | `pipx` or Homebrew, to install from PyPI or the tap; `lsof`, so that `migrate-default` and `restore` can find processes using `~/.claude` (Linux falls back to `/proc`); VS Code's `code` command, for `multi-claude code` |
 
 Install what is missing:
@@ -73,7 +74,16 @@ sudo apt install -y python3 curl tar lsof
 curl -fsSL https://claude.ai/install.sh | bash    # Claude Code, if you do not have it yet
 ```
 
-Windows itself is not supported yet; use WSL. Other ways to install Claude Code: https://code.claude.com/docs/en/setup
+On Windows, install Python 3.8+ from https://www.python.org/downloads/windows/ or the Microsoft Store, then in
+PowerShell:
+
+```powershell
+irm https://claude.ai/install.ps1 | iex    # Claude Code, if you do not have it yet
+python -m pip install --user pipx
+python -m pipx ensurepath                  # then open a new terminal
+```
+
+Other ways to install Claude Code: https://code.claude.com/docs/en/setup
 
 ## Installation
 
@@ -103,6 +113,38 @@ With Homebrew: `brew install jakoes-wu/tap/multi-claude` (upgrade with `brew upg
 
 Run `./install.sh --help` for all options.
 
+### Windows
+
+Windows support is new. Install with `pipx install multi-claude-cli`; the installer script is for macOS and Linux
+only. Everything above works the same way, with these differences:
+
+- Launchers are `claude-<name>.cmd` and `claude-auto.cmd` in `%USERPROFILE%\.local\bin` (the directory
+  `pipx ensurepath` adds to `PATH`), so they run from PowerShell and cmd alike. They read the proxy, variables
+  and arguments from the configuration each time they start, so a change takes effect without `apply`.
+- Account directories are in `%USERPROFILE%\.cc` and the configuration in `%APPDATA%\multi-claude`.
+- Shared directories are linked with directory junctions, which need no special rights. Sharing a single file
+  (such as `CLAUDE.md`) needs a file symbolic link, which needs Developer Mode (Settings > System > For
+  developers) or an administrator terminal; without it, `add` and `apply` stop and say so. Exclude the file
+  with `--shared-exclude` to share the rest.
+- `migrate-default` refuses while any Claude process is running: Windows does not let it see which account
+  another process uses. Close every Claude window, terminal and IDE first.
+- `statusline` needs Git for Windows, whose Git Bash is what Claude Code uses to run the status line. A
+  `statusLine` setting with `"shell": "powershell"` cannot be wrapped.
+- Paths containing `"`, `%` or `!` cannot be written into a `.cmd` launcher; `apply` reports such an account as
+  a conflict.
+- cmd reads a `.cmd` file in the console code page, so a launcher never contains non-ASCII characters. When the
+  Python or package path has them (for example a Chinese user name), the launcher writes it as
+  `%USERPROFILE%\...` (or `%LOCALAPPDATA%`, `%APPDATA%`), or else as its 8.3 short name. A non-ASCII path
+  that cannot be written with a variable and has no short name is reported as a conflict.
+- When Claude exits (Ctrl+C or `/exit`), cmd may flash "Terminate batch job (Y/N)?" for a moment: the launcher is
+  a batch file. It closes by itself; Claude has already exited and nothing is lost.
+- `multi-claude completion powershell | Add-Content $PROFILE` adds tab completion to PowerShell. Do not use `>>`:
+  Windows PowerShell 5.1 writes it as UTF-16 and breaks an existing profile. If the profile's directory does not
+  exist yet, create it first with `New-Item -ItemType Directory -Force (Split-Path $PROFILE)`.
+
+Continuous integration runs the Windows-specific tests on Windows (`tests/test_windows.py`); the rest of the test
+suite runs on macOS and Linux only.
+
 ## Quick start
 
 ### 1. Create one account per login
@@ -429,6 +471,7 @@ Notes:
 multi-claude completion bash > ~/.local/share/bash-completion/completions/multi-claude
 multi-claude completion zsh > "${fpath[1]}/_multi-claude"   # or any directory on your fpath
 multi-claude completion fish > ~/.config/fish/completions/multi-claude.fish
+multi-claude completion powershell | Add-Content $PROFILE         # Windows PowerShell
 ```
 
 ## Migrating `~/.claude`
@@ -508,6 +551,8 @@ It never copies, exports, uploads or backs up a login. One command touches one:
 
 ### Commands
 
+Every command's `--help` ends with examples you can copy, covering its options, e.g. `multi-claude route --help`.
+
 | Command | What it does |
 | ---- | ---- |
 | `multi-claude init [--root DIR] [--bin-dir DIR] [--shared-dir DIR] [--shared-items A,B]` | Create or change global settings. |
@@ -548,13 +593,13 @@ Every write command accepts `--dry-run`, and prints only what changes; add `--ve
 | ---- | ---- |
 | Account directories | `~/.cc/<name>` |
 | Launchers | `~/.local/bin/claude-<name>` |
-| Configuration | `~/.config/multi-claude/config.json` (honours `XDG_CONFIG_HOME`) |
+| Configuration | `~/.config/multi-claude/config.json` (honours `XDG_CONFIG_HOME`); on Windows `%APPDATA%\multi-claude\config.json` |
 
 Account names may contain letters, digits and `._@+-`, must start with a letter or digit, and are case-insensitive (`Work` and `work` are the same account). An email address works as a name. Entries starting with `.` in the root directory are never treated as accounts.
 
 ### Declarative setup with `apply`
 
-See [`examples/config.example.json`](examples/config.example.json):
+See [`examples/config.example.json`](https://github.com/jakoes-wu/multi-claude/blob/main/examples/config.example.json):
 
 ```json
 {
@@ -615,7 +660,7 @@ This removes the tool only. Your configuration, account directories (including t
 
 ## Contributing
 
-See [CONTRIBUTING.md](CONTRIBUTING.md). Run the tests with:
+See [CONTRIBUTING.md](https://github.com/jakoes-wu/multi-claude/blob/main/CONTRIBUTING.md). Run the tests with:
 
 ```sh
 python3 -m unittest discover -s tests -t tests
@@ -623,4 +668,4 @@ python3 -m unittest discover -s tests -t tests
 
 ## License
 
-[MIT](LICENSE)
+[MIT](https://github.com/jakoes-wu/multi-claude/blob/main/LICENSE)

{multi_claude_cli-0.13.0 → multi_claude_cli-0.15.0}/pyproject.toml

@@ -16,6 +16,7 @@ classifiers = [
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
     "Operating System :: MacOS",
+    "Operating System :: Microsoft :: Windows",
     "Operating System :: POSIX :: Linux",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.8",

{multi_claude_cli-0.13.0 → multi_claude_cli-0.15.0}/src/multi_claude/__init__.py

@@ -1,3 +1,3 @@
 """multi-claude：管理多个 Claude Code 账号的配置目录、启动命令、代理与启动参数。"""
 
-__version__ = "0.13.0"
+__version__ = "0.15.0"

{multi_claude_cli-0.13.0 → multi_claude_cli-0.15.0}/src/multi_claude/__main__.py

@@ -7,6 +7,13 @@ if sys.argv[1:2] == ["statusline-hook"]:
     from .hook import main as hook_main
     sys.exit(hook_main(sys.argv[2:]))
 
+from . import platform  # noqa: E402
+
+# 闸门放在导入 cli 之前：不支持的平台上 cli 依赖的模块可能根本加载不了，要先给出一句能看懂的报错
+if not platform.is_supported():
+    sys.stderr.write("multi-claude: unsupported platform {}\n".format(sys.platform))
+    sys.exit(1)
+
 from .cli import main  # noqa: E402
 
 sys.exit(main())

multi_claude_cli-0.15.0/src/multi_claude/_entry.py

@@ -0,0 +1,43 @@
+"""Windows 启动命令（claude-<名称>.cmd、claude-auto.cmd）与状态栏后台进程的入口脚本。
+
+调用方式固定为 `"<python>" -I "<包目录>\\_entry.py" ...`（方案 feature-windows-support §5.1 D2）：
+- 用 `-I` 而不用 `-m`：`-m` 会把当前目录放进模块搜索路径，用户项目里的 json.py 之类文件会顶替标准库；
+  `-I` 也让脚本所在的包目录不进搜索路径，包里的 platform.py 等就不会顶替同名标准库模块。
+- `-I` 同时忽略 PYTHONPATH，源码检出里运行时解释器找不到本包，所以这里把包的上一级目录追加到搜索路径末尾。
+
+本文件只能用标准库，且必须在导入本包之前完成搜索路径的设置。
+"""
+
+import os
+import runpy
+import sys
+
+
+def _same_dir(a: str, b: str) -> bool:
+    # 启动命令里的路径可能是 8.3 短名（MULTI_~1），而包从解释器原有的长路径加载：
+    # 只比 normcase 会把同一目录判成两个。realpath 在 Windows 上会展开短名与链接。
+    if os.path.normcase(os.path.realpath(a)) == os.path.normcase(os.path.realpath(b)):
+        return True
+    try:
+        return os.path.samefile(a, b)
+    except OSError:
+        return False
+
+
+def _main() -> None:
+    package_dir = os.path.dirname(os.path.abspath(__file__))
+    parent = os.path.dirname(package_dir)
+    # 追加到末尾而不是插到最前：已安装的同名标准库模块仍优先于包目录之外的任何东西
+    if parent not in sys.path:
+        sys.path.append(parent)
+    import multi_claude
+    loaded = os.path.dirname(os.path.abspath(multi_claude.__file__))
+    if not _same_dir(loaded, package_dir):
+        # 解释器的 site-packages 里另装了一份 multi_claude：继续运行就是在用另一个版本
+        sys.stderr.write("multi-claude: loaded the package from {} instead of {}; reinstall multi-claude\n".format(
+            loaded, package_dir))
+        sys.exit(1)
+    runpy.run_module("multi_claude", run_name="__main__", alter_sys=True)
+
+
+_main()

{multi_claude_cli-0.13.0 → multi_claude_cli-0.15.0}/src/multi_claude/accounts.py

@@ -53,6 +53,9 @@ def default_dir() -> str:
 
 
 def render_launcher(config: Config, account: Account) -> str:
+    if platform.IS_WINDOWS:
+        python, entry = launcher.windows_command_paths()
+        return launcher.render_windows(account.name, account_dir(config, account.name), python, entry)
     return launcher.render(account.name, account.identity, account_dir(config, account.name), default_dir(),
                            account.proxy, config.effective_env(account), config.effective_args(account))
 
@@ -169,6 +172,11 @@ def _plan_router(old: Config, new: Config) -> List[Action]:
         actions.append(Action(CONFLICT, "router", new_path, "claude-auto is the directory router; an account "
                                                              "named 'auto' cannot coexist with routes"))
 
+    if platform.IS_WINDOWS:
+        unsafe = launcher.cmd_unsafe_reason([], launcher.windows_command_paths())
+        if unsafe is not None:
+            actions.append(Action(CONFLICT, "router", new_path, unsafe))
+            return actions
     content = routes.render_router(new)
     kind = entry_kind(new_path)
     if kind == KIND_MISSING:
@@ -230,12 +238,18 @@ def _make_private_dir(directory: str) -> None:
     if not os.path.isdir(parent):
         os.makedirs(parent, mode=0o700)
     os.mkdir(directory, 0o700)
-    os.chmod(directory, 0o700)
+    # Windows 上 chmod 只能改只读属性，访问控制靠用户目录的 ACL
+    if not platform.IS_WINDOWS:
+        os.chmod(directory, 0o700)
 
 
 def _plan_launcher(bin_dir: str, config: Config, account: Account) -> List[Action]:
     name = account.name
     path = launcher.launcher_path(bin_dir, name)
+    if platform.IS_WINDOWS:
+        unsafe = launcher.cmd_unsafe_reason([account_dir(config, name)], launcher.windows_command_paths())
+        if unsafe is not None:
+            return [Action(CONFLICT, "launcher", path, unsafe)]
     content = render_launcher(config, account)
     kind = entry_kind(path)
     if kind == KIND_MISSING:
@@ -296,6 +310,12 @@ def execute(old: Config, new: Config, actions: List[Action], *, dry_run: bool, v
         return EXIT_CONFLICT
     if dry_run:
         return EXIT_OK
+    # Windows 上没有权限建文件链接时，在写配置之前就停下，免得配置已写、链接只建了一半（方案 C4）
+    file_links = shared.file_links_needed(actions) if platform.IS_WINDOWS else []
+    if file_links and not platform.can_create_file_link():
+        error(shared.file_link_message("the file links " + ", ".join(file_links),
+                                       sorted({os.path.basename(path) for path in file_links})), phase="shared-link")
+        return EXIT_ERROR
     config_action = actions[0]
     if config_action.changes:
         try:

{multi_claude_cli-0.13.0 → multi_claude_cli-0.15.0}/src/multi_claude/artifacts.py

@@ -10,7 +10,6 @@ assistant 记录，结果写一行带 `tool_result` 块的 user 记录，发布
 这段字节的 SHA-256），查询时据此把副本里交接前的记录归回来源账号（§5.1.3）。
 """
 
-import fcntl
 import hashlib
 import json
 import os
@@ -244,13 +243,13 @@ def record_handoff(handoff: "sessions.Plan", source_account_dir: str, target_acc
     data = (json.dumps(entry, ensure_ascii=False, sort_keys=True) + "\n").encode("utf-8")
     path = log_path()
     os.makedirs(os.path.dirname(path), exist_ok=True)
-    fd = os.open(path, os.O_RDWR | os.O_APPEND | os.O_CREAT, 0o600)
+    fd = os.open(path, os.O_RDWR | os.O_APPEND | os.O_CREAT | getattr(os, "O_BINARY", 0), 0o600)
     try:
         # 阻塞等待：两个 handoff 同时追加时排队，不交错。锁的是本文件，不是工具的写锁（handoff 不拿写锁）
-        fcntl.flock(fd, fcntl.LOCK_EX)
+        platform.lock_fd(fd, blocking=True)
         # 只写描述符读不了末字节，所以上面用 O_RDWR 打开
         size = os.fstat(fd).st_size
-        if size and os.pread(fd, 1, size - 1) != b"\n":
+        if size and platform.read_at(fd, 1, size - 1) != b"\n":
             data = b"\n" + data
         view = memoryview(data)
         while view:
@@ -258,7 +257,7 @@ def record_handoff(handoff: "sessions.Plan", source_account_dir: str, target_acc
             view = view[written:]
         os.fsync(fd)
     finally:
-        # 关闭即释放 flock
+        # 关闭即释放锁（flock 与 msvcrt 字节锁都如此）
         os.close(fd)
 
 

{multi_claude_cli-0.13.0 → multi_claude_cli-0.15.0}/src/multi_claude/bundle.py

@@ -22,7 +22,7 @@ import time
 from datetime import datetime, timezone
 from typing import Dict, List, Optional, Tuple
 
-from . import __version__, accounts, usage
+from . import __version__, accounts, platform, usage
 from .actions import error, info, warn
 from .config import Account, Config
 from .fsutil import KIND_DIR, KIND_FILE, KIND_LINK, KIND_MISSING, atomic_write, entry_kind
@@ -114,10 +114,12 @@ def _create_temp(parent: str):
     for _attempt in range(100):
         path = os.path.join(parent, ".multi-claude-export.{}.tar.gz".format(os.urandom(6).hex()))
         try:
-            fd = os.open(path, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o600)
+            fd = os.open(path, os.O_WRONLY | os.O_CREAT | os.O_EXCL | getattr(os, "O_BINARY", 0), 0o600)
         except FileExistsError:
             continue
-        os.fchmod(fd, 0o600)  # 不受 umask 影响：包里可能有密钥，只给本人读
+        # 不受 umask 影响：包里可能有密钥，只给本人读。Windows 没有 fchmod，权限由用户目录的 ACL 保证
+        if hasattr(os, "fchmod"):
+            os.fchmod(fd, 0o600)
         return path, fd
     raise OSError("cannot create a temporary file in {}".format(parent))
 
@@ -132,7 +134,7 @@ def _publish(tmp_path: str, out_path: str) -> None:
         # 不支持硬链接的文件系统（如 exFAT）：再检查一次后改名
         if os.path.lexists(out_path):
             raise OSError("{} appeared while exporting; nothing was written".format(out_path))
-        os.replace(tmp_path, out_path)
+        platform.retry_on_sharing_violation(os.replace, tmp_path, out_path)
         return
     os.unlink(tmp_path)
 
@@ -350,7 +352,9 @@ def _check_item_types(members: List[tarfile.TarInfo]) -> None:
 def _check_member(member: tarfile.TarInfo) -> None:
     name = member.name
     parts = name.split("/")
-    if name.startswith("/") or "\\" in name or "\x00" in name or any(part in ("", ".", "..") for part in parts):
+    # Windows 上成员名里的冒号会被解析成盘符（C:x）或 NTFS 备用数据流（a:b），一律拒绝；POSIX 上冒号是普通字符
+    if (name.startswith("/") or "\\" in name or "\x00" in name or (platform.IS_WINDOWS and ":" in name)
+            or any(part in ("", ".", "..") for part in parts)):
         raise BundleError("unsafe path in bundle: {!r}".format(name))
     if not (member.isfile() or member.isdir()):
         raise BundleError("unsupported entry in bundle (only files and directories): {!r}".format(name))
@@ -453,9 +457,9 @@ def _apply(plan: _Plan, directory: str, staging: str, state_path: str) -> None:
         target = os.path.join(directory, item)
         if action == "replace":
             backup = _backup_name(target, stamp)
-            os.rename(target, backup)
+            platform.retry_on_sharing_violation(os.rename, target, backup)
             info("backup: {}".format(backup))
-        os.replace(os.path.join(staging, ITEMS_DIR, item), target)
+        platform.retry_on_sharing_violation(os.replace, os.path.join(staging, ITEMS_DIR, item), target)
     if data is None:
         return
     warn("Claude sessions of this account that are running keep their own copy of {} and may overwrite "