myccusage 1.2.2__tar.gz → 1.4.0__tar.gz

{myccusage-1.2.2 → myccusage-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: myccusage
-Version: 1.2.2
+Version: 1.4.0
 Summary: Multi-Agent session usage analytics and DeepSeek-V4.1-Flash cost estimator
 Author-email: Richard Huang <RichardHuang0001@users.noreply.github.com>
 License: MIT License
@@ -67,7 +67,7 @@ Dynamic: license-file
 
 ## 主要功能
 
-- **支持多种编程 Agent**：统一查看 Google Antigravity、Claude Code、Hermes Agent、OpenAI Codex、Grok、Pi Agent、OpenCode 的使用记录。
+- **支持多种编程 Agent**：统一查看 Google Antigravity、Claude Code、Hermes Agent、OpenAI Codex、Grok、Pi Agent、OpenCode、WorkBuddy 的使用记录。
 - **Token 消耗与费用参考**：统计 Input、Cache 与 Output 构成，支持按 DeepSeek-V4.1-Flash、Gemini 3.8 Flash 等模型单价换算参考费用。
 - **缓存命中率统计**：直观查看每次会话与整体的 KV Cache 命中比例，了解缓存节省情况。
 - **自动读取会话标题**：解析本地 SQLite / JSONL / Protobuf 文件还原会话标题，避免面对难以辨识的 UUID。
@@ -83,18 +83,9 @@ Dynamic: license-file
 
 ## 安装说明
 
-### 1. 安装底层依赖 `ccusage`
+### 直接使用 pip 安装（无需 Node.js / ccusage）
 
-`myccusage` 依赖开源工具 [ccusage](https://github.com/ryoppippi/ccusage) 收集底层数据，需先全局安装：
-
-```bash
-npm install -g ccusage
-# 或使用 bun / pnpm:
-# bun add -g ccusage
-# pnpm add -g ccusage
-```
-
-### 2. 安装 `myccusage`
+`myccusage` 现已内置各大 Agent 的原生 Python 高性能解析内核，**完全不依赖 Node.js 或外部 ccusage 工具**，直接 pip 即可安装并使用：
 
 ```bash
 pip install myccusage
@@ -131,10 +122,11 @@ myccusage --agy
 # 查看 Claude Code 每日账本
 myccusage --claude
 
-# 查看 Codex / Hermes / OpenCode
+# 查看 Codex / Hermes / OpenCode / WorkBuddy
 myccusage --codex
 myccusage --hermes
 myccusage --opencode
+myccusage --workbuddy
 
 # 查看某 Agent 各项目生命周期总消耗
 myccusage --agy -s
@@ -148,6 +140,8 @@ myccusage --agy -s -t
 | 参数 | 说明 |
 | :--- | :--- |
 | `ui` / `--web` | 启动本地 Web 仪表盘并打开浏览器 |
+| `--daemon` | 常驻后台服务模式（关闭页面不退出，供 Dock 宿主消费） |
+| `--no-open`, `-n` | 启动 Web 服务时不自动弹出浏览器 |
 | `--agy` / `--claude` / `--hermes` / ... | 指定要查看的 Agent |
 | `-d`, `--daily` | 每日账本模式（默认），按自然日切片并带有周小计 |
 | `-s`, `--session` | 项目总览模式，按会话累计生命周期总消耗 |
@@ -155,6 +149,27 @@ myccusage --agy -s -t
 
 ---
 
+### macOS 原生程序坞常驻微型看板 (可选)
+
+本项目支持一键运行原生 macOS 程序坞应用（`myccusage.app`）：
+- **Dock 动态微型看板**：每 60 秒极低能耗自动刷新（基于 `mtime` 单 Agent 指纹嗅探与今日热文件剪枝，刷新仅耗时 5ms，CPU 占用趋近 0%），大字清晰展示今日 Token 吞吐、今日 100M 进度条与最新活跃 Session 的 KV Cache 命中率圆环。
+- **原生磨砂悬浮卡片**：点击 Dock 图标即可在上方升起半透明磨砂气泡卡片，智能跟随 Dock 位置并带有指示呼应箭头，展示今日各活跃 Agent 的细分用量，并附带“一键打开完整 Web 看板”入口。
+- **一键运行与构建**：
+  ```bash
+  # 终端直接运行（首次会自动构建，约需 2 秒）
+  myccusage dock
+  ```
+  或者通过脚本手动构建：
+  ```bash
+  bash macos/build_app.sh
+  open dist/myccusage.app
+  ```
+  构建产物仅数百 KB，常驻内存仅数十 MB，离电续航完全无感。
+
+---
+
+---
+
 ## 二次开发与底层文档
 
 如果需要了解数据缓存切片机制、计价规则配置或扩展新的 Agent 适配，请参阅：

{myccusage-1.2.2 → myccusage-1.4.0}/README.md

@@ -30,7 +30,7 @@
 
 ## 主要功能
 
-- **支持多种编程 Agent**：统一查看 Google Antigravity、Claude Code、Hermes Agent、OpenAI Codex、Grok、Pi Agent、OpenCode 的使用记录。
+- **支持多种编程 Agent**：统一查看 Google Antigravity、Claude Code、Hermes Agent、OpenAI Codex、Grok、Pi Agent、OpenCode、WorkBuddy 的使用记录。
 - **Token 消耗与费用参考**：统计 Input、Cache 与 Output 构成，支持按 DeepSeek-V4.1-Flash、Gemini 3.8 Flash 等模型单价换算参考费用。
 - **缓存命中率统计**：直观查看每次会话与整体的 KV Cache 命中比例，了解缓存节省情况。
 - **自动读取会话标题**：解析本地 SQLite / JSONL / Protobuf 文件还原会话标题，避免面对难以辨识的 UUID。
@@ -46,18 +46,9 @@
 
 ## 安装说明
 
-### 1. 安装底层依赖 `ccusage`
+### 直接使用 pip 安装（无需 Node.js / ccusage）
 
-`myccusage` 依赖开源工具 [ccusage](https://github.com/ryoppippi/ccusage) 收集底层数据，需先全局安装：
-
-```bash
-npm install -g ccusage
-# 或使用 bun / pnpm:
-# bun add -g ccusage
-# pnpm add -g ccusage
-```
-
-### 2. 安装 `myccusage`
+`myccusage` 现已内置各大 Agent 的原生 Python 高性能解析内核，**完全不依赖 Node.js 或外部 ccusage 工具**，直接 pip 即可安装并使用：
 
 ```bash
 pip install myccusage
@@ -94,10 +85,11 @@ myccusage --agy
 # 查看 Claude Code 每日账本
 myccusage --claude
 
-# 查看 Codex / Hermes / OpenCode
+# 查看 Codex / Hermes / OpenCode / WorkBuddy
 myccusage --codex
 myccusage --hermes
 myccusage --opencode
+myccusage --workbuddy
 
 # 查看某 Agent 各项目生命周期总消耗
 myccusage --agy -s
@@ -111,6 +103,8 @@ myccusage --agy -s -t
 | 参数 | 说明 |
 | :--- | :--- |
 | `ui` / `--web` | 启动本地 Web 仪表盘并打开浏览器 |
+| `--daemon` | 常驻后台服务模式（关闭页面不退出，供 Dock 宿主消费） |
+| `--no-open`, `-n` | 启动 Web 服务时不自动弹出浏览器 |
 | `--agy` / `--claude` / `--hermes` / ... | 指定要查看的 Agent |
 | `-d`, `--daily` | 每日账本模式（默认），按自然日切片并带有周小计 |
 | `-s`, `--session` | 项目总览模式，按会话累计生命周期总消耗 |
@@ -118,6 +112,27 @@ myccusage --agy -s -t
 
 ---
 
+### macOS 原生程序坞常驻微型看板 (可选)
+
+本项目支持一键运行原生 macOS 程序坞应用（`myccusage.app`）：
+- **Dock 动态微型看板**：每 60 秒极低能耗自动刷新（基于 `mtime` 单 Agent 指纹嗅探与今日热文件剪枝，刷新仅耗时 5ms，CPU 占用趋近 0%），大字清晰展示今日 Token 吞吐、今日 100M 进度条与最新活跃 Session 的 KV Cache 命中率圆环。
+- **原生磨砂悬浮卡片**：点击 Dock 图标即可在上方升起半透明磨砂气泡卡片，智能跟随 Dock 位置并带有指示呼应箭头，展示今日各活跃 Agent 的细分用量，并附带“一键打开完整 Web 看板”入口。
+- **一键运行与构建**：
+  ```bash
+  # 终端直接运行（首次会自动构建，约需 2 秒）
+  myccusage dock
+  ```
+  或者通过脚本手动构建：
+  ```bash
+  bash macos/build_app.sh
+  open dist/myccusage.app
+  ```
+  构建产物仅数百 KB，常驻内存仅数十 MB，离电续航完全无感。
+
+---
+
+---
+
 ## 二次开发与底层文档
 
 如果需要了解数据缓存切片机制、计价规则配置或扩展新的 Agent 适配，请参阅：

{myccusage-1.2.2 → myccusage-1.4.0}/myccusage.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: myccusage
-Version: 1.2.2
+Version: 1.4.0
 Summary: Multi-Agent session usage analytics and DeepSeek-V4.1-Flash cost estimator
 Author-email: Richard Huang <RichardHuang0001@users.noreply.github.com>
 License: MIT License
@@ -67,7 +67,7 @@ Dynamic: license-file
 
 ## 主要功能
 
-- **支持多种编程 Agent**：统一查看 Google Antigravity、Claude Code、Hermes Agent、OpenAI Codex、Grok、Pi Agent、OpenCode 的使用记录。
+- **支持多种编程 Agent**：统一查看 Google Antigravity、Claude Code、Hermes Agent、OpenAI Codex、Grok、Pi Agent、OpenCode、WorkBuddy 的使用记录。
 - **Token 消耗与费用参考**：统计 Input、Cache 与 Output 构成，支持按 DeepSeek-V4.1-Flash、Gemini 3.8 Flash 等模型单价换算参考费用。
 - **缓存命中率统计**：直观查看每次会话与整体的 KV Cache 命中比例，了解缓存节省情况。
 - **自动读取会话标题**：解析本地 SQLite / JSONL / Protobuf 文件还原会话标题，避免面对难以辨识的 UUID。
@@ -83,18 +83,9 @@ Dynamic: license-file
 
 ## 安装说明
 
-### 1. 安装底层依赖 `ccusage`
+### 直接使用 pip 安装（无需 Node.js / ccusage）
 
-`myccusage` 依赖开源工具 [ccusage](https://github.com/ryoppippi/ccusage) 收集底层数据，需先全局安装：
-
-```bash
-npm install -g ccusage
-# 或使用 bun / pnpm:
-# bun add -g ccusage
-# pnpm add -g ccusage
-```
-
-### 2. 安装 `myccusage`
+`myccusage` 现已内置各大 Agent 的原生 Python 高性能解析内核，**完全不依赖 Node.js 或外部 ccusage 工具**，直接 pip 即可安装并使用：
 
 ```bash
 pip install myccusage
@@ -131,10 +122,11 @@ myccusage --agy
 # 查看 Claude Code 每日账本
 myccusage --claude
 
-# 查看 Codex / Hermes / OpenCode
+# 查看 Codex / Hermes / OpenCode / WorkBuddy
 myccusage --codex
 myccusage --hermes
 myccusage --opencode
+myccusage --workbuddy
 
 # 查看某 Agent 各项目生命周期总消耗
 myccusage --agy -s
@@ -148,6 +140,8 @@ myccusage --agy -s -t
 | 参数 | 说明 |
 | :--- | :--- |
 | `ui` / `--web` | 启动本地 Web 仪表盘并打开浏览器 |
+| `--daemon` | 常驻后台服务模式（关闭页面不退出，供 Dock 宿主消费） |
+| `--no-open`, `-n` | 启动 Web 服务时不自动弹出浏览器 |
 | `--agy` / `--claude` / `--hermes` / ... | 指定要查看的 Agent |
 | `-d`, `--daily` | 每日账本模式（默认），按自然日切片并带有周小计 |
 | `-s`, `--session` | 项目总览模式，按会话累计生命周期总消耗 |
@@ -155,6 +149,27 @@ myccusage --agy -s -t
 
 ---
 
+### macOS 原生程序坞常驻微型看板 (可选)
+
+本项目支持一键运行原生 macOS 程序坞应用（`myccusage.app`）：
+- **Dock 动态微型看板**：每 60 秒极低能耗自动刷新（基于 `mtime` 单 Agent 指纹嗅探与今日热文件剪枝，刷新仅耗时 5ms，CPU 占用趋近 0%），大字清晰展示今日 Token 吞吐、今日 100M 进度条与最新活跃 Session 的 KV Cache 命中率圆环。
+- **原生磨砂悬浮卡片**：点击 Dock 图标即可在上方升起半透明磨砂气泡卡片，智能跟随 Dock 位置并带有指示呼应箭头，展示今日各活跃 Agent 的细分用量，并附带“一键打开完整 Web 看板”入口。
+- **一键运行与构建**：
+  ```bash
+  # 终端直接运行（首次会自动构建，约需 2 秒）
+  myccusage dock
+  ```
+  或者通过脚本手动构建：
+  ```bash
+  bash macos/build_app.sh
+  open dist/myccusage.app
+  ```
+  构建产物仅数百 KB，常驻内存仅数十 MB，离电续航完全无感。
+
+---
+
+---
+
 ## 二次开发与底层文档
 
 如果需要了解数据缓存切片机制、计价规则配置或扩展新的 Agent 适配，请参阅：

myccusage-1.4.0/myccusage.egg-info/SOURCES.txt

@@ -0,0 +1,31 @@
+LICENSE
+README.md
+pyproject.toml
+myccusage.egg-info/PKG-INFO
+myccusage.egg-info/SOURCES.txt
+myccusage.egg-info/dependency_links.txt
+myccusage.egg-info/entry_points.txt
+myccusage.egg-info/top_level.txt
+myccusage_lib/__init__.py
+myccusage_lib/__main__.py
+myccusage_lib/cli.py
+myccusage_lib/core.py
+myccusage_lib/adapters/__init__.py
+myccusage_lib/adapters/agy.py
+myccusage_lib/adapters/base.py
+myccusage_lib/adapters/claude.py
+myccusage_lib/adapters/codex.py
+myccusage_lib/adapters/grok.py
+myccusage_lib/adapters/hermes.py
+myccusage_lib/adapters/opencode.py
+myccusage_lib/adapters/pi.py
+myccusage_lib/adapters/workbuddy.py
+myccusage_lib/macos/AppIcon.icns
+myccusage_lib/macos/build_app.sh
+myccusage_lib/macos/generate_icon.py
+myccusage_lib/macos/main.swift
+myccusage_lib/web/__init__.py
+myccusage_lib/web/server.py
+myccusage_lib/web/static/app.js
+myccusage_lib/web/static/index.html
+myccusage_lib/web/static/style.css

myccusage-1.4.0/myccusage_lib/__init__.py

@@ -0,0 +1,6 @@
+"""
+myccusage: 多 AI 编程 Agent 本地会话用量分析与 DeepSeek-V4.1-Flash 等效计费工具。
+本包提供了从命令行接口到本地数据解析、Web 服务展示的完整实现。
+"""
+
+__version__ = "1.4.0"  # 定义项目的当前版本号，方便其他模块或发布脚本引用

myccusage-1.4.0/myccusage_lib/__main__.py

@@ -0,0 +1,8 @@
+"""
+myccusage package entrypoint:
+python3 -m myccusage_lib [...]
+"""
+from myccusage_lib.cli import main
+
+if __name__ == "__main__":
+    main()

myccusage-1.4.0/myccusage_lib/adapters/__init__.py

@@ -0,0 +1,63 @@
+"""
+myccusage_lib.adapters:
+Agent 原生适配器统一导出注册表:
+包含 8 大 Agent 的高性能适配器实现
+该模块用于集中管理所有 Agent 的数据源适配器，提供统一的注册和获取机制。
+"""
+
+from __future__ import annotations
+
+from .base import BaseAgentAdapter
+from .workbuddy import WorkBuddyAdapter
+from .claude import ClaudeAdapter
+from .hermes import HermesAdapter
+from .opencode import OpenCodeAdapter
+from .codex import CodexAdapter
+from .pi import PiAdapter
+from .grok import GrokAdapter
+from .agy import AntigravityAdapter
+
+# 适配器注册表字典，键为 Agent 类型标识，值为具体的适配器实例
+ADAPTERS = {
+    "workbuddy": WorkBuddyAdapter(),
+    "claude": ClaudeAdapter(),
+    "hermes": HermesAdapter(),
+    "opencode": OpenCodeAdapter(),
+    "codex": CodexAdapter(),
+    "pi": PiAdapter(),
+    "grok": GrokAdapter(),
+    "agy": AntigravityAdapter(),
+}
+
+def get_adapter(agent_type: str) -> BaseAgentAdapter:
+    """
+    获取指定 Agent 适配器实例
+    
+    参数:
+        agent_type (str): Agent 类型的短标识，例如 'claude', 'codex'
+        
+    返回:
+        BaseAgentAdapter: 对应的适配器实例
+        
+    异常:
+        ValueError: 当请求了不支持的 Agent 类型时抛出
+    """
+    # 检查请求的类型是否在注册表中注册
+    if agent_type not in ADAPTERS:
+        raise ValueError(f"未知 Agent 类型: {agent_type}，支持列表: {list(ADAPTERS.keys())}")
+    # 返回注册的适配器实例
+    return ADAPTERS[agent_type]
+
+__all__ = [
+    "BaseAgentAdapter",
+    "ADAPTERS",
+    "get_adapter",
+    "WorkBuddyAdapter",
+    "ClaudeAdapter",
+    "HermesAdapter",
+    "OpenCodeAdapter",
+    "CodexAdapter",
+    "PiAdapter",
+    "GrokAdapter",
+    "AntigravityAdapter",
+]