claude-session-sync-cli 0.1.2__tar.gz → 0.1.3__tar.gz

{claude_session_sync_cli-0.1.2 → claude_session_sync_cli-0.1.3}/CHANGELOG.md

@@ -4,6 +4,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+## [0.1.3] - 2026-11-11
+
+### Added
+- `--lang en|zh` to pick the output language for a single run; it overrides `CLAUDE_SESSION_SYNC_LANG` and the locale.
+- The English `--help` now shows a one-line hint in Chinese on how to switch, and the Chinese `--help` shows the English equivalent.
+
 ## [0.1.2] - 2026-11-11
 
 ### Fixed
@@ -26,7 +32,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 - `--version` and `--help` with examples.
 - English and Chinese output, chosen from the locale; override with `CLAUDE_SESSION_SYNC_LANG=en|zh`.
 
-[Unreleased]: https://github.com/xushenjie/claude-session-sync/compare/v0.1.2...HEAD
+[Unreleased]: https://github.com/xushenjie/claude-session-sync/compare/v0.1.3...HEAD
+[0.1.3]: https://github.com/xushenjie/claude-session-sync/compare/v0.1.2...v0.1.3
 [0.1.2]: https://github.com/xushenjie/claude-session-sync/compare/v0.1.1...v0.1.2
 [0.1.1]: https://github.com/xushenjie/claude-session-sync/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/xushenjie/claude-session-sync/releases/tag/v0.1.0

{claude_session_sync_cli-0.1.2 → claude_session_sync_cli-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: claude-session-sync-cli
-Version: 0.1.2
+Version: 0.1.3
 Summary: Sync local Claude Code CLI sessions into the Claude desktop app sidebar (unofficial).
 Project-URL: Homepage, https://github.com/xushenjie/claude-session-sync
 Project-URL: Issues, https://github.com/xushenjie/claude-session-sync/issues
@@ -126,7 +126,7 @@ claude-session-sync --undo
 
 > If it says the desktop app is running, the app is still alive in the menu bar or system tray and **nothing was written**. Quit it fully and run again.
 
-Output is in English, or in Chinese when your locale (`LC_ALL` / `LC_MESSAGES` / `LANG`, or the Windows display language) is Chinese. Set `CLAUDE_SESSION_SYNC_LANG=en` or `zh` to override.
+Output is in English, or in Chinese when your locale (`LC_ALL` / `LC_MESSAGES` / `LANG`, or the Windows display language) is Chinese. Pass `--lang en` or `--lang zh` for a single run, or set `CLAUDE_SESSION_SYNC_LANG=en` or `zh` in your shell profile to change it for good without touching your locale.
 
 ---
 
@@ -178,6 +178,7 @@ claude-session-sync --purge-archived --apply   # do it
 |---|---|
 | `-h`, `--help` | Show help, examples, and caveats |
 | `-V`, `--version` | Show the version |
+| `--lang en\|zh` | Output language; overrides `CLAUDE_SESSION_SYNC_LANG` and the locale |
 | (no options) | Preview mode |
 | `--apply` | Actually write |
 | `--undo` | Undo the most recent write or deletion |

{claude_session_sync_cli-0.1.2 → claude_session_sync_cli-0.1.3}/README.md

@@ -97,7 +97,7 @@ claude-session-sync --undo
 
 > If it says the desktop app is running, the app is still alive in the menu bar or system tray and **nothing was written**. Quit it fully and run again.
 
-Output is in English, or in Chinese when your locale (`LC_ALL` / `LC_MESSAGES` / `LANG`, or the Windows display language) is Chinese. Set `CLAUDE_SESSION_SYNC_LANG=en` or `zh` to override.
+Output is in English, or in Chinese when your locale (`LC_ALL` / `LC_MESSAGES` / `LANG`, or the Windows display language) is Chinese. Pass `--lang en` or `--lang zh` for a single run, or set `CLAUDE_SESSION_SYNC_LANG=en` or `zh` in your shell profile to change it for good without touching your locale.
 
 ---
 
@@ -149,6 +149,7 @@ claude-session-sync --purge-archived --apply   # do it
 |---|---|
 | `-h`, `--help` | Show help, examples, and caveats |
 | `-V`, `--version` | Show the version |
+| `--lang en\|zh` | Output language; overrides `CLAUDE_SESSION_SYNC_LANG` and the locale |
 | (no options) | Preview mode |
 | `--apply` | Actually write |
 | `--undo` | Undo the most recent write or deletion |

{claude_session_sync_cli-0.1.2 → claude_session_sync_cli-0.1.3}/README.zh-CN.md

@@ -97,7 +97,7 @@ claude-session-sync --undo
 
 > 如果提示"检测到桌面端正在运行"，说明桌面端还挂在菜单栏或托盘里，**这次什么都没有写入**。彻底退出后重新运行即可。
 
-系统语言（`LC_ALL`、`LC_MESSAGES`、`LANG`，或 Windows 的显示语言）是中文时输出中文，否则输出英文。可以用 `CLAUDE_SESSION_SYNC_LANG=zh` 或 `en` 强制指定。
+系统语言（`LC_ALL`、`LC_MESSAGES`、`LANG`，或 Windows 的显示语言）是中文时输出中文，否则输出英文。临时切换加 `--lang zh` 或 `--lang en`；想长期使用中文，又不想改系统语言，在 shell 配置文件（如 `~/.zshrc`）里加上 `export CLAUDE_SESSION_SYNC_LANG=zh`。
 
 ---
 
@@ -149,6 +149,7 @@ claude-session-sync --purge-archived --apply   # 执行
 |---|---|
 | `-h`, `--help` | 显示帮助、示例和注意事项 |
 | `-V`, `--version` | 显示版本号 |
+| `--lang en\|zh` | 输出语言，优先于 `CLAUDE_SESSION_SYNC_LANG` 和系统语言 |
 | （不加参数） | 预览模式 |
 | `--apply` | 实际写入 |
 | `--undo` | 撤销最近一次写入或删除 |

{claude_session_sync_cli-0.1.2 → claude_session_sync_cli-0.1.3}/src/claude_session_sync/cli.py

@@ -40,7 +40,7 @@ import time
 import uuid
 from pathlib import Path, PurePosixPath, PureWindowsPath
 
-__version__ = "0.1.2"
+__version__ = "0.1.3"
 
 HOME = Path.home()
 JOURNAL_DIR = HOME / ".claude-desktop-sync"
@@ -581,17 +581,32 @@ def purge_archived(indexes, archived_ids, projects, apply, trash, excluded=(), p
 # ---------------------------------------------------------------- 主流程
 
 
+def apply_lang_flag(argv):
+    """在构建帮助文本之前先读取 --lang，让 --help 和后续输出都使用指定语言。
+    非法取值交给正式的解析器报错。"""
+    global _LANG_ZH
+    pre = argparse.ArgumentParser(add_help=False)
+    pre.add_argument("--lang")
+    known, _ = pre.parse_known_args(argv)
+    if known.lang in ("en", "zh"):
+        _LANG_ZH = known.lang == "zh"
+
+
 def main(argv=None):
     use_safe_stdio()
+    apply_lang_flag(argv)
     ap = argparse.ArgumentParser(
         prog="claude-session-sync",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         description=t(
             "Sync local Claude Code CLI sessions into the Claude desktop app's Code sidebar (multi-account).\n"
             "Archived sessions and sessions deleted in the desktop app are skipped. "
-            "Previews by default; pass --apply to write.",
+            "Previews by default; pass --apply to write.\n"
+            # 这一行固定用中文：给终端设成英文的中文用户看
+            "中文输出：加 --lang zh，或设置环境变量 CLAUDE_SESSION_SYNC_LANG=zh",
             "把本地 Claude Code CLI 会话同步到 Claude 桌面端 Code 标签页的侧边栏（支持多账号）。\n"
-            "自动排除已归档、桌面端已删除的会话。默认只预览，加 --apply 才写入。",
+            "自动排除已归档、桌面端已删除的会话。默认只预览，加 --apply 才写入。\n"
+            "English output: pass --lang en, or set CLAUDE_SESSION_SYNC_LANG=en",
         ),
         epilog=t(
             """\
@@ -612,7 +627,7 @@ Notes:
   * Quit the desktop app completely before writing, and reopen it afterwards.
   * Journals and backups live in ~/.claude-desktop-sync/; --undo steps back one run at a time.
   * The desktop index format is undocumented and may break with desktop updates.
-  * Output language follows LANG; set CLAUDE_SESSION_SYNC_LANG=en or zh to override.
+  * Output language: --lang, then CLAUDE_SESSION_SYNC_LANG, then LC_ALL / LC_MESSAGES / LANG.
 """,
             """\
 常用流程：
@@ -632,11 +647,19 @@ Notes:
   * 写入前请彻底退出桌面端（菜单栏 ⌘Q），写完重新打开。
   * 日志与备份在 ~/.claude-desktop-sync/，--undo 按时间倒序逐次撤销。
   * 桌面端索引格式无官方文档，桌面端更新后可能失效。
-  * 输出语言跟随 LANG，可用 CLAUDE_SESSION_SYNC_LANG=en 或 zh 强制指定。
+  * 输出语言：依次看 --lang、CLAUDE_SESSION_SYNC_LANG、LC_ALL / LC_MESSAGES / LANG。
 """,
         ),
     )
     ap.add_argument("-V", "--version", action="version", version=f"%(prog)s {__version__}")
+    ap.add_argument(
+        "--lang",
+        choices=["en", "zh"],
+        help=t(
+            "output language (default: from CLAUDE_SESSION_SYNC_LANG or the locale)",
+            "输出语言（默认：按 CLAUDE_SESSION_SYNC_LANG 或系统语言）",
+        ),
+    )
     ap.add_argument(
         "--apply", action="store_true", help=t("actually write (default: preview only)", "实际写入（默认只预览）")
     )

{claude_session_sync_cli-0.1.2 → claude_session_sync_cli-0.1.3}/tests/test_sync.py

@@ -411,3 +411,36 @@ def test_include_recent_does_not_affect_purge(env):
     jsonl = env.add_cli_session("busy", mtime=time.time())
     env.run("--purge-archived", "--apply", "--include-recent")
     assert arch.exists() and jsonl.exists()
+
+
+# ---------------------------------------------------------------- --lang
+
+
+def test_lang_flag_switches_help_to_chinese(monkeypatch, capsys):
+    monkeypatch.setenv("CLAUDE_SESSION_SYNC_LANG", "en")  # --lang 优先于环境变量
+    with pytest.raises(SystemExit):
+        cli.main(["--lang", "zh", "--help"])
+    out = capsys.readouterr().out
+    assert "实际写入" in out and "English output: pass --lang en" in out
+
+
+def test_english_help_shows_chinese_hint(capsys):
+    with pytest.raises(SystemExit):
+        cli.main(["--help"])
+    out = capsys.readouterr().out
+    assert "actually write" in out
+    assert "中文输出：加 --lang zh" in out
+
+
+def test_lang_flag_switches_run_output(env, capsys):
+    env.add_index("existing")
+    env.add_cli_session("new-1")
+    env.run("--lang=zh")
+    assert "预览模式" in capsys.readouterr().out
+
+
+def test_invalid_lang_is_rejected(capsys):
+    with pytest.raises(SystemExit) as e:
+        cli.main(["--lang", "fr"])
+    assert e.value.code == 2
+    assert "invalid choice" in capsys.readouterr().err