token-tracker 0.4.8__tar.gz → 0.4.9__tar.gz

{token_tracker-0.4.8/src/token_tracker.egg-info → token_tracker-0.4.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: token-tracker
-Version: 0.4.8
+Version: 0.4.9
 Summary: Track token usage across local AI agents (Claude Code, Codex)
 Author-email: stormzhang <stormzhang.dev@gmail.com>
 License: MIT License
@@ -44,6 +44,7 @@ License-File: LICENSE
 Requires-Dist: rich>=13.7
 Requires-Dist: questionary<3,>=2.0
 Requires-Dist: textual>=1.0
+Requires-Dist: iterm2>=2.9; sys_platform == "darwin"
 Provides-Extra: test
 Requires-Dist: pytest>=8.0; extra == "test"
 Requires-Dist: pytest-asyncio>=0.24; extra == "test"
@@ -71,6 +72,7 @@ Dynamic: license-file
 - **多 Agent 统一追踪** — Claude Code + Codex 统一读取，多 Agent 按来源分组
 - **状态栏集成** — Claude Code 用官方 StatusLine 接口；**Codex 业界首创伪 statusline 方案**（hook 注入两行真彩色状态栏，把官方未开放的能力在 Codex 里做了出来）
 - **实时侧边栏** — `tt sidebar` 窄窗格常驻面板：全部活跃会话一屏总览（状态灯 + 最近提示词 + 「下一步」建议），点击会话直达对应 iTerm2 / tmux 窗格
+- **当前会话自动分屏** — Codex 中显式执行 `$tt-sidebar`，在原会话右侧自动打开 1/3 宽度的独立提示词侧边栏
 - **限额监控** — 实时 5h / 7d 配额百分比 + 重置倒计时
 - **多维成本分析** — 会话 / 日 / 周 / 月多维报表，等效成本统计
 - **定价识别** — litellm 在线定价 + 内置官方价双层兜底，覆盖 Claude / OpenAI / Gemini / Grok 及国产主流（Kimi / GLM / Qwen / 豆包 / DeepSeek / MiniMax / MiMo）；新模型自动套用同系列定价、不静默归零
@@ -157,6 +159,21 @@ Codex 官方暂不支持自定义 StatusLine。Token Tracker 通过 hook 注入
 
 操作：鼠标拖拽选择文字，松开后自动复制；滚轮 / 方向键 / PgUp/PgDn 滚动，`q` / `Esc` / `Ctrl+C` 退出；`tt sidebar --once` 打印一帧快照即退。数据每 5s 刷新，只读本地会话记录、不写任何产物；加 `--claude` / `--codex` 可只看单个 agent。
 
+### Codex 当前会话自动 1/3 分屏（`$tt-sidebar`）
+
+`tt setup` 会把 `$tt-sidebar` 安装为用户级 Codex Skill。它与普通 `tt sidebar` 相互独立：普通命令继续显示全部活跃会话；Skill 只显示发起命令的当前 Codex 会话，右侧自动占 1/3 宽度，完整提示词按时间倒序展示，最新永远置顶。
+
+在 Codex 输入：
+
+```text
+$tt-sidebar
+```
+
+- 支持 iTerm2（需在 iTerm2 设置中启用 Python API）与 tmux；原会话窗格保持焦点。
+- `tt setup` 把 Codex 的伪 statusline `Stop` 与 sidebar `UserPromptSubmit` 统一安装到用户级 `hooks.json`；后者用本地 FIFO 把新提示词推给已打开的分屏，无 sidebar 时立即返回，不轮询 transcript、不上传或持久化提示词。
+- Codex 会要求审查非托管 Hook：安装后运行 `/hooks`，信任 Token Tracker 对应项。Skill 未立即出现时重启 Codex。
+- `tt unsetup` 会一并移除 Token Tracker 管理的 Skill 与 Hook；若 `~/.agents/skills/tt-sidebar` 已是用户自己的同名 Skill，安装与卸载都不会覆盖它。
+
 ## 安装
 
 ```bash
@@ -165,7 +182,7 @@ curl -sSL https://raw.githubusercontent.com/stormzhang/token-tracker/main/instal
 
 脚本自动选最优安装方式（uv / pipx / 私有 venv），绕开 PEP 668、不污染系统 Python。
 
-> **升级**：重跑上面的命令即可（脚本幂等、自动升到最新）。
+> **升级**：重跑上面的命令即可（脚本幂等、自动升到最新）。包含新 Agent 集成的版本升级后，再运行一次 `tt setup`；例如 `$tt-sidebar` 需要由 setup 安装到 Codex 用户级 Skill 目录。
 > **卸载**：`tt unsetup`
 
 **升级后 `tt --version` 还是旧版？** 多半是旧版装在别的 Python 环境里遮蔽了新版（常见于 Windows、或早期用 `pip install` 装过）。卸载旧版后重装一次即可：
@@ -178,7 +195,7 @@ curl -sSL https://raw.githubusercontent.com/stormzhang/token-tracker/main/instal
 ## 使用
 
 ```bash
-tt setup          # 交互配置向导（终端：上下键选语言 / 主题 / 各组件）；非 tty 环境按推荐默认自动配置
+tt setup          # 配置状态栏，并安装 Codex $tt-sidebar Skill / 提示词 Hook
 tt                # 过去一年 token 热力图 + 顶部三段概览（= tt daily）
 tt daily          # 同上（tt 无参即进 daily）
 tt status         # 今日消耗、5h/7d 额度与今日会话

{token_tracker-0.4.8 → token_tracker-0.4.9}/README.md

@@ -15,6 +15,7 @@
 - **多 Agent 统一追踪** — Claude Code + Codex 统一读取，多 Agent 按来源分组
 - **状态栏集成** — Claude Code 用官方 StatusLine 接口；**Codex 业界首创伪 statusline 方案**（hook 注入两行真彩色状态栏，把官方未开放的能力在 Codex 里做了出来）
 - **实时侧边栏** — `tt sidebar` 窄窗格常驻面板：全部活跃会话一屏总览（状态灯 + 最近提示词 + 「下一步」建议），点击会话直达对应 iTerm2 / tmux 窗格
+- **当前会话自动分屏** — Codex 中显式执行 `$tt-sidebar`，在原会话右侧自动打开 1/3 宽度的独立提示词侧边栏
 - **限额监控** — 实时 5h / 7d 配额百分比 + 重置倒计时
 - **多维成本分析** — 会话 / 日 / 周 / 月多维报表，等效成本统计
 - **定价识别** — litellm 在线定价 + 内置官方价双层兜底，覆盖 Claude / OpenAI / Gemini / Grok 及国产主流（Kimi / GLM / Qwen / 豆包 / DeepSeek / MiniMax / MiMo）；新模型自动套用同系列定价、不静默归零
@@ -101,6 +102,21 @@ Codex 官方暂不支持自定义 StatusLine。Token Tracker 通过 hook 注入
 
 操作：鼠标拖拽选择文字，松开后自动复制；滚轮 / 方向键 / PgUp/PgDn 滚动，`q` / `Esc` / `Ctrl+C` 退出；`tt sidebar --once` 打印一帧快照即退。数据每 5s 刷新，只读本地会话记录、不写任何产物；加 `--claude` / `--codex` 可只看单个 agent。
 
+### Codex 当前会话自动 1/3 分屏（`$tt-sidebar`）
+
+`tt setup` 会把 `$tt-sidebar` 安装为用户级 Codex Skill。它与普通 `tt sidebar` 相互独立：普通命令继续显示全部活跃会话；Skill 只显示发起命令的当前 Codex 会话，右侧自动占 1/3 宽度，完整提示词按时间倒序展示，最新永远置顶。
+
+在 Codex 输入：
+
+```text
+$tt-sidebar
+```
+
+- 支持 iTerm2（需在 iTerm2 设置中启用 Python API）与 tmux；原会话窗格保持焦点。
+- `tt setup` 把 Codex 的伪 statusline `Stop` 与 sidebar `UserPromptSubmit` 统一安装到用户级 `hooks.json`；后者用本地 FIFO 把新提示词推给已打开的分屏，无 sidebar 时立即返回，不轮询 transcript、不上传或持久化提示词。
+- Codex 会要求审查非托管 Hook：安装后运行 `/hooks`，信任 Token Tracker 对应项。Skill 未立即出现时重启 Codex。
+- `tt unsetup` 会一并移除 Token Tracker 管理的 Skill 与 Hook；若 `~/.agents/skills/tt-sidebar` 已是用户自己的同名 Skill，安装与卸载都不会覆盖它。
+
 ## 安装
 
 ```bash
@@ -109,7 +125,7 @@ curl -sSL https://raw.githubusercontent.com/stormzhang/token-tracker/main/instal
 
 脚本自动选最优安装方式（uv / pipx / 私有 venv），绕开 PEP 668、不污染系统 Python。
 
-> **升级**：重跑上面的命令即可（脚本幂等、自动升到最新）。
+> **升级**：重跑上面的命令即可（脚本幂等、自动升到最新）。包含新 Agent 集成的版本升级后，再运行一次 `tt setup`；例如 `$tt-sidebar` 需要由 setup 安装到 Codex 用户级 Skill 目录。
 > **卸载**：`tt unsetup`
 
 **升级后 `tt --version` 还是旧版？** 多半是旧版装在别的 Python 环境里遮蔽了新版（常见于 Windows、或早期用 `pip install` 装过）。卸载旧版后重装一次即可：
@@ -122,7 +138,7 @@ curl -sSL https://raw.githubusercontent.com/stormzhang/token-tracker/main/instal
 ## 使用
 
 ```bash
-tt setup          # 交互配置向导（终端：上下键选语言 / 主题 / 各组件）；非 tty 环境按推荐默认自动配置
+tt setup          # 配置状态栏，并安装 Codex $tt-sidebar Skill / 提示词 Hook
 tt                # 过去一年 token 热力图 + 顶部三段概览（= tt daily）
 tt daily          # 同上（tt 无参即进 daily）
 tt status         # 今日消耗、5h/7d 额度与今日会话

{token_tracker-0.4.8 → token_tracker-0.4.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "token-tracker"
-version = "0.4.8"
+version = "0.4.9"
 description = "Track token usage across local AI agents (Claude Code, Codex)"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -30,6 +30,8 @@ dependencies = [
     "questionary>=2.0,<3",
     # 仅 tt sidebar live 模式用（cli 延迟 import，日常 tt 启动不加载）；与 rich 同门，渲染对象直接复用
     "textual>=1.0",
+    # 仅 macOS 的 $tt-sidebar 自动 iTerm2 分屏 worker 加载；其它平台走 tmux、不安装
+    "iterm2>=2.9; sys_platform == 'darwin'",
 ]
 
 [project.optional-dependencies]
@@ -55,6 +57,9 @@ tt = "token_tracker.cli:main"
 [tool.setuptools.packages.find]
 where = ["src"]
 
+[tool.setuptools.package-data]
+"token_tracker.skills.tt_sidebar" = ["SKILL.md", "agents/*.yaml"]
+
 [tool.ruff]
 line-length = 120
 target-version = "py311"

{token_tracker-0.4.8 → token_tracker-0.4.9}/src/token_tracker/config.py

@@ -29,9 +29,10 @@ SCHEMA_VERSION = 1
 # 老用户 config 里没这字段 / 旧版本号 < 当前 → 触发重新引导（真终端弹 wizard、非 tty 静默 _auto_setup）。
 # 跟 SCHEMA_VERSION 解耦：那是数据格式版本，这是用户引导版本，bump 节奏完全不同。
 # 2（0.4.2）：强制所有现存用户（0.3.8/0.4.0=无字段=0、0.4.1=1，全 < 2）升级后重走一遍 setup。
+# 3：安装随包分发的用户级 Codex $tt-sidebar Skill + UserPromptSubmit hook。
 # 注：CC statusLine 变可选组件（issue #16/#17）时决定**不 bump**——小众需求不打断存量用户，
 # 存量 tt 用户 intent 缺失时由 is_setup 按「statusLine 已是 tt 的」推断为已配，想改的手动 tt setup。
-SETUP_VERSION = 2
+SETUP_VERSION = 3
 
 # 旧位置（独立 theme.json / lang.json），老用户首次读 config.json 不存在时自动合并迁移
 _LEGACY_THEME_PATH = os.path.join(CONFIG_DIR, "theme.json")

{token_tracker-0.4.8 → token_tracker-0.4.9}/src/token_tracker/hooks.py

@@ -7,7 +7,7 @@ import tomllib
 from dataclasses import dataclass
 from importlib import resources
 
-from . import config
+from . import config, sidebar_install
 from .adapters.util import claude_home, codex_home
 from .i18n import t
 from .ui import themes
@@ -35,7 +35,7 @@ _TT = config.CONFIG_DIR  # ~/.config/token-tracker
 CLAUDE_SETTINGS = os.path.join(_CLAUDE, "settings.json")  # 改 Claude Code 配置，留 agent 目录
 HOOK_SCRIPT_PATH = os.path.join(_TT, "claude-statusline.py")
 CODEX_DIR = _CODEX
-CODEX_CONFIG = os.path.join(CODEX_DIR, "config.toml")     # 改 Codex 配置，留 agent 目录
+CODEX_CONFIG = os.path.join(CODEX_DIR, "config.toml")     # 仅迁移旧内联 Stop；新 Hook 统一写 hooks.json
 CODEX_STATUSLINE_HOOK_PATH = os.path.join(_TT, "codex-statusline.py")
 STATUS_FILE = config.STATUS_FILE                          # CC statusline 缓存（单一权威定义在 config）
 TERMINAL_MAP_FILE = config.TERMINAL_MAP_FILE              # Codex Stop hook 采集的终端定位映射
@@ -61,7 +61,6 @@ def _load_template(name: str) -> str:
     return (resources.files("token_tracker.templates") / name).read_text(encoding="utf-8")
 
 
-
 # --- helpers ---
 
 def _render_hook_script() -> str:
@@ -106,7 +105,8 @@ def _installed_codex_statusline_version() -> str | None:
     return None
 
 
-# 卸载时定位 tt 追加的整段 [[hooks.Stop]]——同时认新（codex-statusline）/ 旧（tt-statusline）两种特征码。
+# 迁移 / 卸载时定位 tt 旧版追加的整段 [[hooks.Stop]]——
+# 同时认新（codex-statusline）/ 旧（tt-statusline）两种特征码。
 # command 值兼容三代形态：双引号 basic string（最老）、单引号 literal 裸拼接（0.4.x）、
 # 单引号 literal 内含双引号包裹（现行，防路径空格断词，与 CC 侧 #13/#14 同一治法）
 _CODEX_STATUSLINE_REGEX = re.compile(
@@ -118,54 +118,23 @@ _CODEX_STATUSLINE_REGEX = re.compile(
     r'timeout = \d+\s*'
 )
 
-# tt Stop hook 的 command 值（去掉外层 TOML 引号）；与删除正则同一套三代形态
-_CODEX_COMMAND_REGEX = re.compile(
-    r'command = ("[^"\n]*(?:codex-statusline|tt-statusline)[^"\n]*"'
-    r"|'[^'\n]*(?:codex-statusline|tt-statusline)[^'\n]*')"
-)
-
 
 def _has_tt_codex_statusline(content: str) -> bool:
-    return "codex-statusline" in content or "tt-statusline" in content
-
-
-def _codex_hook_command(content: str) -> str | None:
-    """从 config.toml 内容提取 tt Stop hook 的 command 值（含内层引号、不含外层 TOML 引号）。"""
-    m = _CODEX_COMMAND_REGEX.search(content)
-    return m.group(1)[1:-1] if m else None
-
-
-def _install_codex_statusline(content: str, python: str) -> str:
-    """落盘 Codex statusline 脚本 + 在 config.toml 末尾追加 Stop hook 段。
-    command 与 CC 侧同一拼法（_build_cc_command：双引号包路径 + Windows 正斜杠，#13/#14 同治）。
-    - 已有段的 command 与本次要写的完全一致 → 幂等返回；
-    - 不一致（python 升级/换环境、老名 tt-statusline、旧裸拼接格式）→ 删旧段装新段，
-      避免 command 指向已死 python 或在含空格路径上断词（症状：状态栏静默半残）。"""
-    _write_codex_statusline_script()
-    cmd = _build_cc_command(python, CODEX_STATUSLINE_HOOK_PATH)
-    if _has_tt_codex_statusline(content):
-        if _codex_hook_command(content) == cmd:
-            return content  # 新格式 + python/脚本路径一致 → 幂等
-        content = _CODEX_STATUSLINE_REGEX.sub("\n", content)  # 其余一律删旧装新
-    return content.rstrip() + (
-        "\n\n[[hooks.Stop]]\n\n"
-        "[[hooks.Stop.hooks]]\n"
-        'type = "command"\n'
-        # 用 TOML literal string（单引号）包裹 command，避免 Windows 反斜杠路径被当转义符
-        # 解析失败（如 `C:\Users\...` 里的 `\U` 被识别为 unicode 转义起始）；
-        # 值内的双引号来自 _build_cc_command 的路径包裹，literal string 内原样合法
-        f"command = '{cmd}'\n"
-        "timeout = 10\n"
-    )
+    return _CODEX_STATUSLINE_REGEX.search(content) is not None
+
+
+def _migrate_codex_statusline_config(content: str) -> str:
+    """只移除 Token Tracker 的旧内联 Stop 段；[hooks.state] 与用户其它 TOML 原样保留。"""
+    return _CODEX_STATUSLINE_REGEX.sub("\n", content)
 
 
 def _uninstall_codex_statusline(content: str) -> str:
-    """删 Codex statusline 脚本 + 从 content 移除 tt 追加的 Stop hook 段（不动用户其它）。"""
+    """删 Codex statusline 运行产物 + 旧内联 Stop 段（hooks.json 由统一 installer 管理）。"""
     if os.path.exists(CODEX_STATUSLINE_HOOK_PATH):
         os.remove(CODEX_STATUSLINE_HOOK_PATH)
     if os.path.exists(TERMINAL_MAP_FILE):
         os.remove(TERMINAL_MAP_FILE)
-    return _CODEX_STATUSLINE_REGEX.sub("\n", content)
+    return _migrate_codex_statusline_config(content)
 
 
 def _read_codex_config() -> tuple[str, dict] | None:
@@ -177,17 +146,26 @@ def _read_codex_config() -> tuple[str, dict] | None:
         return None
 
 
+def _codex_statusline_command(python: str | None = None) -> str:
+    return _build_cc_command(python or sys.executable or "python3", CODEX_STATUSLINE_HOOK_PATH)
+
+
+def _inline_codex_statusline_present() -> bool:
+    result = _read_codex_config()
+    return bool(result and _has_tt_codex_statusline(result[0]))
+
+
 def codex_statusline_active() -> bool:
-    """双因素：用户意图（config）AND 实际装好（脚本文件 + config.toml 含特征码）。任一不满足 → False。"""
+    """双因素：用户意图 AND 实际装好。
+
+    迁移期兼容旧 config.toml 内联 Stop，让 needs_update() 能无打扰搬到 hooks.json；
+    新安装只认 hooks.json。
+    """
     if config.codex_faux_statusline_intent() is not True:
         return False
     if not os.path.exists(CODEX_STATUSLINE_HOOK_PATH):
         return False
-    try:
-        with open(CODEX_CONFIG, encoding="utf-8") as f:
-            return _has_tt_codex_statusline(f.read())
-    except OSError:
-        return False
+    return sidebar_install.statusline_hook_present() or _inline_codex_statusline_present()
 
 
 def _settings_has_tt_statusline() -> bool:
@@ -355,26 +333,37 @@ def _sync_cc_command() -> None:
         json.dump(settings, f, indent=2, ensure_ascii=False)
 
 
-def _codex_command_needs_sync() -> bool:
-    """config.toml 里 tt Stop hook 的 command 是否还是旧格式（裸拼接 / 反斜杠）——
-    与 CC 侧 #13/#14 同类问题，格式规则复用 _cc_command_outdated。没装 / 没段 → False。"""
-    result = _read_codex_config()
-    if not result:
-        return False
-    cmd = _codex_hook_command(result[0])
-    return cmd is not None and _cc_command_outdated(cmd)
+def _sync_codex_managed_hooks(quiet: bool = False) -> bool:
+    """把 Stop + UserPromptSubmit 统一同步到 hooks.json，再迁移旧内联 Stop。
 
+    先写 hooks.json、成功后才移除 config.toml 旧段，避免迁移中断导致伪 statusline 失效。
+    """
+    p = (lambda *a, **k: None) if quiet else get_console().print
+    statusline_command = (
+        _codex_statusline_command()
+        if config.codex_faux_statusline_intent() is True
+        else None
+    )
+    try:
+        changed = sidebar_install.install_managed_hooks(statusline_command)
+    except ValueError:
+        get_console().print(
+            f"[red]{t('codex_hooks_corrupt', path=sidebar_install.CODEX_HOOKS)}[/red]"
+        )
+        return False
 
-def _sync_codex_command() -> None:
-    """把 config.toml 里 tt Stop hook 的 command 重写为新格式（删旧段装新段，其余内容不动）。"""
     result = _read_codex_config()
-    if not result:
-        return
-    content = result[0]
-    new_content = _install_codex_statusline(content, sys.executable or "python3")
-    if new_content != content:
-        with open(CODEX_CONFIG, "w", encoding="utf-8") as f:
-            f.write(new_content)
+    if result:
+        content, _parsed = result
+        migrated = _migrate_codex_statusline_config(content)
+        if migrated != content:
+            with open(CODEX_CONFIG, "w", encoding="utf-8") as f:
+                f.write(migrated)
+            changed = True
+    if changed:
+        p(f"[green]✓[/green] {t('codex_hooks_synced')}")
+        p(f"[dim]{t('sidebar_hook_trust')}[/dim]")
+    return True
 
 
 def needs_update() -> bool:
@@ -384,8 +373,20 @@ def needs_update() -> bool:
     sv = _installed_codex_statusline_version()
     if sv is not None and sv != STATUSLINE_HOOK_VERSION:
         return True
-    if _codex_command_needs_sync():  # config.toml 里 Stop hook command 旧格式（同 #13/#14）
-        return True
+    # setup_version 3 起，用户级 $tt-sidebar Skill 与 UserPromptSubmit hook 也属于 setup 产物。
+    # 老用户（setup_version < 3）由 cli 的升级引导统一安装，不在这里抢跑。
+    if os.path.isdir(CODEX_DIR) and config.setup_version() >= 3:
+        statusline_command = (
+            _codex_statusline_command()
+            if config.codex_faux_statusline_intent() is True
+            else None
+        )
+        if (
+            sidebar_install.skill_needs_sync()
+            or sidebar_install.managed_hooks_need_sync(statusline_command)
+            or _inline_codex_statusline_present()
+        ):
+            return True
     return _cc_command_needs_sync()  # settings.json 里 command 格式过时也算待更新（issue #13/#14）
 
 
@@ -396,8 +397,9 @@ def update_hook() -> None:
         _write_codex_statusline_script()
     if _cc_command_needs_sync():
         _sync_cc_command()
-    if _codex_command_needs_sync():
-        _sync_codex_command()
+    if os.path.isdir(CODEX_DIR) and config.setup_version() >= 3:
+        _sync_codex_managed_hooks(quiet=True)
+        _setup_codex_sidebar(quiet=True)
 
 
 # --- setup ---
@@ -431,6 +433,7 @@ def setup(auto: bool = False, components: SetupComponents | None = None, quiet:
 
     if has_codex:
         _setup_codex(components, quiet)
+        _setup_codex_sidebar(quiet)
     else:
         if not auto:
             p(f"[dim]{t('codex_not_found')}[/dim]")
@@ -541,34 +544,46 @@ def _setup_claude(components: SetupComponents, quiet: bool = False) -> None:
 
 
 def _setup_codex(components: SetupComponents, quiet: bool = False) -> None:
-    """Codex 端只装/卸伪 statusline hook，**不再动 [tui].status_line**——伪 statusline 比官方更全。
-    用户意图（components.codex_faux_statusline）也写入 config.json，给 wizard 总结 / is_setup 用。"""
+    """Codex 端同步用户级 hooks.json，**不再动 [tui].status_line**。
+
+    Stop（可选伪 statusline）与 UserPromptSubmit（sidebar）由同一个 installer 原子合并；
+    旧 config.toml 内联 Stop 在 JSON 成功落盘后迁移，[hooks.state] 原样保留。
+    """
     p = (lambda *a, **k: None) if quiet else get_console().print
-    result = _read_codex_config()
-    if result:
-        content, _parsed = result
-    elif os.path.isdir(CODEX_DIR):
-        content = ""  # 装了 Codex 但还没 config.toml → 新建
-    else:
+    if not os.path.isdir(CODEX_DIR):
         return
 
     config.save_codex_faux_statusline(components.codex_faux_statusline)  # 写入意图
 
-    python = sys.executable or "python3"
     if components.codex_faux_statusline:
-        content = _install_codex_statusline(content, python)
+        _write_codex_statusline_script()
     else:
-        content = _uninstall_codex_statusline(content)
-
-    with open(CODEX_CONFIG, "w", encoding="utf-8") as f:
-        f.write(content)
+        _uninstall_codex_statusline("")
 
+    _sync_codex_managed_hooks(quiet=quiet)
     p(f"[green]✓[/green] {t('codex_configured')}")
     if components.codex_faux_statusline:
         p(f"[dim]{t('codex_statusline_hint')}[/dim]")
     p(f"[dim]{t('restart_codex')}[/dim]")
 
 
+def _setup_codex_sidebar(quiet: bool = False) -> None:
+    """安装用户级 $tt-sidebar Skill；两个 Codex Hook 已由 _setup_codex 统一同步。"""
+    p = (lambda *a, **k: None) if quiet else get_console().print
+    try:
+        skill_changed = sidebar_install.install_skill()
+    except FileExistsError:
+        get_console().print(
+            f"[yellow]{t('sidebar_skill_conflict', path=sidebar_install.SIDEBAR_SKILL_DIR)}[/yellow]"
+        )
+        skill_changed = False
+    if skill_changed:
+        p(
+            f"[green]✓[/green] "
+            f"{t('sidebar_skill_installed', path=sidebar_install.SIDEBAR_SKILL_DIR)}"
+        )
+
+
 # --- unsetup ---
 
 def unsetup() -> None:
@@ -579,6 +594,7 @@ def unsetup() -> None:
         _unsetup_claude()
     if has_codex:
         _unsetup_codex()
+        _unsetup_codex_sidebar()
     if not has_cc and not has_codex:
         get_console().print(f"[dim]{t('no_agent_detected')}[/dim]")
 
@@ -610,12 +626,12 @@ def _unsetup_codex() -> None:
     """卸载 Codex 端：移除伪 statusline hook + 脚本。
     老用户残留：如有 codex-backup.json（旧版我们改过 status_line），恢复原值；新版不再动 status_line。"""
     result = _read_codex_config()
-    if not result:
-        return
-    content, _parsed = result
+    content = result[0] if result else ""
 
-    # 清伪 statusline（脚本 + hook 段）
+    # config.toml 不存在 / 损坏也必须先清运行产物；hooks.json 由 _unsetup_codex_sidebar 统一清。
     content = _uninstall_codex_statusline(content)
+    if not result:
+        return
 
     # 兼容老用户：旧版我们曾接管 status_line + 写 codex-backup.json。这里恢复 + 删 backup。
     if os.path.exists(CODEX_BACKUP_LEGACY):
@@ -635,3 +651,19 @@ def _unsetup_codex() -> None:
 
     with open(CODEX_CONFIG, "w", encoding="utf-8") as f:
         f.write(content)
+
+
+def _unsetup_codex_sidebar() -> None:
+    if sidebar_install.uninstall_skill():
+        get_console().print(
+            f"[green]✓[/green] {t('deleted_file', path=sidebar_install.SIDEBAR_SKILL_DIR)}"
+        )
+    try:
+        hook_removed = sidebar_install.uninstall_managed_hooks()
+    except ValueError:
+        get_console().print(
+            f"[red]{t('codex_hooks_corrupt_unsetup', path=sidebar_install.CODEX_HOOKS)}[/red]"
+        )
+        return
+    if hook_removed:
+        get_console().print(f"[green]✓[/green] {t('codex_hooks_removed')}")

{token_tracker-0.4.8 → token_tracker-0.4.9}/src/token_tracker/i18n.py

@@ -86,6 +86,13 @@ _STRINGS = {
         "codex_configured": "Codex 已配置",
         "codex_statusline_hint": "已启用伪 statusline（每次回答后追加一行 5h/7d/Ctx）",
         "restart_codex": "重启 Codex 后生效",
+        "sidebar_skill_installed": "已安装 Codex $tt-sidebar Skill：{path}",
+        "sidebar_skill_conflict": "{path} 已存在非 Token Tracker 管理的同名 Skill，已保留且未覆盖",
+        "codex_hooks_synced": "已统一更新 Codex 用户级 Hooks 配置",
+        "sidebar_hook_trust": "在 Codex 中运行 /hooks 检查并信任新增或变更的 Hook；新 Skill 未出现时重启 Codex",
+        "codex_hooks_removed": "已移除 Token Tracker 的 Codex Hooks",
+        "codex_hooks_corrupt": "无法解析 {path}（JSON 损坏），Token Tracker Hooks 未改动；请修复后重跑 tt setup",
+        "codex_hooks_corrupt_unsetup": "无法解析 {path}（JSON 损坏），Token Tracker Hooks 未改动；请手动检查该文件",
         "no_agent_detected": "未检测到 Claude Code 或 Codex",
         "deleted_file": "已删除: {path}",
         "cc_restored": "Claude Code statusLine 已恢复原配置",
@@ -178,6 +185,13 @@ _STRINGS = {
         "codex_configured": "Codex configured",
         "codex_statusline_hint": "Faux statusline enabled (appends 5h/7d/Ctx line after each turn)",
         "restart_codex": "Restart Codex to take effect",
+        "sidebar_skill_installed": "Codex $tt-sidebar Skill installed: {path}",
+        "sidebar_skill_conflict": "A non-Token Tracker skill already exists at {path}; kept without changes",
+        "codex_hooks_synced": "Codex user-level Hooks configuration unified and updated",
+        "sidebar_hook_trust": "Run /hooks in Codex to review and trust new or changed hooks; restart Codex if the new Skill is not visible",
+        "codex_hooks_removed": "Token Tracker Codex hooks removed",
+        "codex_hooks_corrupt": "Cannot parse {path} (invalid JSON); Token Tracker hooks untouched — fix it and re-run tt setup",
+        "codex_hooks_corrupt_unsetup": "Cannot parse {path} (invalid JSON); Token Tracker hooks untouched — check it manually",
         "no_agent_detected": "Claude Code or Codex not detected",
         "deleted_file": "Deleted: {path}",
         "cc_restored": "Claude Code statusLine restored",