workbuddy2api 2.0.1__tar.gz → 2.0.2__tar.gz

{workbuddy2api-2.0.1 → workbuddy2api-2.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: workbuddy2api
-Version: 2.0.1
+Version: 2.0.2
 Summary: Local OpenAI/Responses/Anthropic compatible proxy for CodeBuddy
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -30,21 +30,40 @@ Dynamic: license-file
 
 ## 安装
 
-推荐使用 [uv](https://docs.astral.sh/uv/)：
+推荐使用 [uv](https://docs.astral.sh/uv/) 从 PyPI 运行：
 
 ```bash
 # 安装 uv
 curl -LsSf https://astral.sh/uv/install.sh | sh
 
-# 直接运行（uv 会自动安装依赖）
-uv run codebuddy_proxy.py
+# 运行最新可用版本（uv 会自动创建环境并安装依赖）
+uv run --with workbuddy2api python -m codebuddy_proxy \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
+
+# 强制刷新缓存后运行最新版本
+uv run --refresh-package workbuddy2api --with workbuddy2api \
+  python -m codebuddy_proxy \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
+```
+
+后续启动无需手动激活虚拟环境，重复执行上述 `uv run` 命令即可。
+
+### 本地源码启动
+
+在项目根目录执行以下命令，使用当前工作区源码而不是 PyPI 中的已发布版本：
+
+```bash
+# 同步本地项目依赖
+uv sync
+
+# 启动本地源码
+uv run python -m codebuddy_proxy --desensitize
 ```
 
-或传统方式：
+首次使用需要登录时：
 
 ```bash
-pip install -r requirements.txt
-python codebuddy_proxy.py
+uv run python -m codebuddy_proxy --login --desensitize
 ```
 
 ## 快速开始
@@ -52,11 +71,9 @@ python codebuddy_proxy.py
 ### 1. 启动 proxy
 
 ```bash
-# 使用 uv（推荐）
-uv run codebuddy_proxy.py --desensitize
-
-# 或传统方式
-python codebuddy_proxy.py --desensitize
+# 使用最新版本（推荐）
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 默认监听 `http://127.0.0.1:8787`
@@ -118,7 +135,7 @@ codex --profile codebuddy "你的任务"
 --port PORT              监听端口（默认 8787）
 --endpoint ENDPOINT      CodeBuddy 后端地址
 --session-file PATH      会话文件路径（默认 ~/.codebuddy-session.json）
---log-file PATH          JSONL 日志文件（默认 logs/codebuddy-proxy.jsonl）
+--log-file PATH          JSONL 日志文件（默认 ~/.workbuddy2api/codebuddy-proxy.jsonl）
 --desensitize            启用脱敏处理（推荐）
 --optimize-context       启用消息压缩优化（Codex CLI 推荐）
 --login                  启动时执行浏览器登录
@@ -142,7 +159,8 @@ CODEBUDDY_PROXY_LOG_FILE  # 等同 --log-file
 ### 首次使用（需要登录）
 
 ```bash
-uv run codebuddy_proxy.py --login
+uv run --with workbuddy2api python -m codebuddy_proxy --login \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 浏览器打开后登录，成功后 proxy 自动启动。
@@ -150,29 +168,34 @@ uv run codebuddy_proxy.py --login
 ### 日常使用（自动读取登录态）
 
 ```bash
-uv run codebuddy_proxy.py --desensitize
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ### Codex CLI 场景（启用压缩优化）
 
 ```bash
-uv run codebuddy_proxy.py --desensitize --optimize-context
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize --optimize-context \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ### 多账号切换
 
 ```bash
 # 账号 1
-uv run codebuddy_proxy.py --session-file ~/.codebuddy-work.json --login
+uv run --with workbuddy2api python -m codebuddy_proxy --session-file ~/.codebuddy-work.json --login \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 
 # 账号 2
-uv run codebuddy_proxy.py --session-file ~/.codebuddy-personal.json --login
+uv run --with workbuddy2api python -m codebuddy_proxy --session-file ~/.codebuddy-personal.json --login \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ### 监听所有网卡（局域网共享）
 
 ```bash
-uv run codebuddy_proxy.py --host 0.0.0.0 --desensitize
+uv run --with workbuddy2api python -m codebuddy_proxy --host 0.0.0.0 --desensitize \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ## API 接口
@@ -371,7 +394,8 @@ upstream chunk → response.output_text.delta
 
 ```bash
 # 必须启用 --desensitize，否则几乎每次都被拦截
-uv run codebuddy_proxy.py --desensitize
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 
 # 在 Claude Code / CC Switch 中配置
 # Base URL: http://127.0.0.1:8787/v1/messages
@@ -381,7 +405,8 @@ uv run codebuddy_proxy.py --desensitize
 
 ```bash
 # 同时启用脱敏和消息压缩（最佳配置）
-uv run codebuddy_proxy.py --desensitize --optimize-context
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize --optimize-context \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 
 # 在 Codex CLI 配置文件中
 # base_url: http://127.0.0.1:8787/v1/responses
@@ -391,7 +416,8 @@ uv run codebuddy_proxy.py --desensitize --optimize-context
 
 ```bash
 # 启用脱敏以避免合规术语被误拦
-uv run codebuddy_proxy.py --desensitize
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 
 # 示例请求
 curl http://127.0.0.1:8787/v1/chat/completions \
@@ -465,10 +491,12 @@ curl http://127.0.0.1:8787/v1/chat/completions \
 
 ```bash
 # 启用消息压缩
-uv run codebuddy_proxy.py --optimize-context
+uv run --with workbuddy2api python -m codebuddy_proxy --optimize-context \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 
 # 同时启用两个功能（推荐用于 Codex CLI）
-uv run codebuddy_proxy.py --desensitize --optimize-context
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize --optimize-context \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 #### 工作原理
@@ -512,7 +540,7 @@ uv run codebuddy_proxy.py --desensitize --optimize-context
 启用功能后，日志会记录压缩统计：
 
 ```bash
-grep projection_applied logs/codebuddy-proxy.jsonl | jq .
+grep projection_applied "$HOME/.workbuddy2api/codebuddy-proxy.jsonl" | jq .
 ```
 
 示例输出：
@@ -543,26 +571,36 @@ grep projection_applied logs/codebuddy-proxy.jsonl | jq .
 ### 日志
 
 日志包含：
-- 文本日志：`logs/proxy.log`（按天滚动，保留 30 天）
-- 结构化日志：`logs/codebuddy-proxy.jsonl`（完整请求/响应，包含流式细节）
+- 文本日志：`$HOME/.workbuddy2api/proxy.log`（按天滚动，保留 30 天）
+- 结构化日志：`$HOME/.workbuddy2api/codebuddy-proxy.jsonl`（按天滚动，保留 30 天，完整请求/响应）
+
+JSONL 每条记录包含 `app_version`、`system_version`、`python_version` 和 `machine` 字段；启动时还会记录 `startup` 事件。
+
+也可以指定日志文件的绝对路径：
+
+```bash
+uv run --with workbuddy2api python -m codebuddy_proxy \
+  --desensitize \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
+```
 
 查看日志：
 
 ```bash
 # 实时查看
-tail -f logs/codebuddy-proxy.jsonl
+tail -f "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 
 # 查看流式事件
-tail -100 logs/codebuddy-proxy.jsonl | jq 'select(.event | startswith("stream"))'
+tail -100 "$HOME/.workbuddy2api/codebuddy-proxy.jsonl" | jq 'select(.event | startswith("stream"))'
 
 # 统计超时
-jq 'select(.event=="stream_timeout")' logs/codebuddy-proxy.jsonl | wc -l
+jq 'select(.event=="stream_timeout")' "$HOME/.workbuddy2api/codebuddy-proxy.jsonl" | wc -l
 
 # 验证脱敏
-grep desensitize_applied logs/codebuddy-proxy.jsonl
+grep desensitize_applied "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 
 # 验证压缩（查看统计数据）
-grep projection_applied logs/codebuddy-proxy.jsonl | jq .
+grep projection_applied "$HOME/.workbuddy2api/codebuddy-proxy.jsonl" | jq .
 ```
 
 ### 找不到 session 文件
@@ -570,7 +608,8 @@ grep projection_applied logs/codebuddy-proxy.jsonl | jq .
 首次使用需要登录：
 
 ```bash
-uv run codebuddy_proxy.py --login
+uv run --with workbuddy2api python -m codebuddy_proxy --login \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ### 401 认证失败
@@ -578,7 +617,8 @@ uv run codebuddy_proxy.py --login
 Token 过期，重新登录：
 
 ```bash
-uv run codebuddy_proxy.py --login
+uv run --with workbuddy2api python -m codebuddy_proxy --login \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ### 审核拦截
@@ -586,20 +626,23 @@ uv run codebuddy_proxy.py --login
 启用脱敏：
 
 ```bash
-uv run codebuddy_proxy.py --desensitize
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 如果仍然被拦截，尝试压缩优化（仅 `/v1/responses`）：
 
 ```bash
-uv run codebuddy_proxy.py --desensitize --optimize-context
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize --optimize-context \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ### 端口被占用
 
 ```bash
 lsof -i :8787
-uv run codebuddy_proxy.py --port 8788
+uv run --with workbuddy2api python -m codebuddy_proxy --port 8788 \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ### SOCKS proxy 错误
@@ -614,7 +657,8 @@ env | grep -i proxy
 
 ```bash
 unset http_proxy https_proxy all_proxy
-uv run codebuddy_proxy.py
+uv run --with workbuddy2api python -m codebuddy_proxy \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ## 技术细节

{workbuddy2api-2.0.1 → workbuddy2api-2.0.2}/README.md

@@ -15,21 +15,40 @@
 
 ## 安装
 
-推荐使用 [uv](https://docs.astral.sh/uv/)：
+推荐使用 [uv](https://docs.astral.sh/uv/) 从 PyPI 运行：
 
 ```bash
 # 安装 uv
 curl -LsSf https://astral.sh/uv/install.sh | sh
 
-# 直接运行（uv 会自动安装依赖）
-uv run codebuddy_proxy.py
+# 运行最新可用版本（uv 会自动创建环境并安装依赖）
+uv run --with workbuddy2api python -m codebuddy_proxy \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
+
+# 强制刷新缓存后运行最新版本
+uv run --refresh-package workbuddy2api --with workbuddy2api \
+  python -m codebuddy_proxy \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
+```
+
+后续启动无需手动激活虚拟环境，重复执行上述 `uv run` 命令即可。
+
+### 本地源码启动
+
+在项目根目录执行以下命令，使用当前工作区源码而不是 PyPI 中的已发布版本：
+
+```bash
+# 同步本地项目依赖
+uv sync
+
+# 启动本地源码
+uv run python -m codebuddy_proxy --desensitize
 ```
 
-或传统方式：
+首次使用需要登录时：
 
 ```bash
-pip install -r requirements.txt
-python codebuddy_proxy.py
+uv run python -m codebuddy_proxy --login --desensitize
 ```
 
 ## 快速开始
@@ -37,11 +56,9 @@ python codebuddy_proxy.py
 ### 1. 启动 proxy
 
 ```bash
-# 使用 uv（推荐）
-uv run codebuddy_proxy.py --desensitize
-
-# 或传统方式
-python codebuddy_proxy.py --desensitize
+# 使用最新版本（推荐）
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 默认监听 `http://127.0.0.1:8787`
@@ -103,7 +120,7 @@ codex --profile codebuddy "你的任务"
 --port PORT              监听端口（默认 8787）
 --endpoint ENDPOINT      CodeBuddy 后端地址
 --session-file PATH      会话文件路径（默认 ~/.codebuddy-session.json）
---log-file PATH          JSONL 日志文件（默认 logs/codebuddy-proxy.jsonl）
+--log-file PATH          JSONL 日志文件（默认 ~/.workbuddy2api/codebuddy-proxy.jsonl）
 --desensitize            启用脱敏处理（推荐）
 --optimize-context       启用消息压缩优化（Codex CLI 推荐）
 --login                  启动时执行浏览器登录
@@ -127,7 +144,8 @@ CODEBUDDY_PROXY_LOG_FILE  # 等同 --log-file
 ### 首次使用（需要登录）
 
 ```bash
-uv run codebuddy_proxy.py --login
+uv run --with workbuddy2api python -m codebuddy_proxy --login \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 浏览器打开后登录，成功后 proxy 自动启动。
@@ -135,29 +153,34 @@ uv run codebuddy_proxy.py --login
 ### 日常使用（自动读取登录态）
 
 ```bash
-uv run codebuddy_proxy.py --desensitize
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ### Codex CLI 场景（启用压缩优化）
 
 ```bash
-uv run codebuddy_proxy.py --desensitize --optimize-context
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize --optimize-context \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ### 多账号切换
 
 ```bash
 # 账号 1
-uv run codebuddy_proxy.py --session-file ~/.codebuddy-work.json --login
+uv run --with workbuddy2api python -m codebuddy_proxy --session-file ~/.codebuddy-work.json --login \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 
 # 账号 2
-uv run codebuddy_proxy.py --session-file ~/.codebuddy-personal.json --login
+uv run --with workbuddy2api python -m codebuddy_proxy --session-file ~/.codebuddy-personal.json --login \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ### 监听所有网卡（局域网共享）
 
 ```bash
-uv run codebuddy_proxy.py --host 0.0.0.0 --desensitize
+uv run --with workbuddy2api python -m codebuddy_proxy --host 0.0.0.0 --desensitize \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ## API 接口
@@ -356,7 +379,8 @@ upstream chunk → response.output_text.delta
 
 ```bash
 # 必须启用 --desensitize，否则几乎每次都被拦截
-uv run codebuddy_proxy.py --desensitize
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 
 # 在 Claude Code / CC Switch 中配置
 # Base URL: http://127.0.0.1:8787/v1/messages
@@ -366,7 +390,8 @@ uv run codebuddy_proxy.py --desensitize
 
 ```bash
 # 同时启用脱敏和消息压缩（最佳配置）
-uv run codebuddy_proxy.py --desensitize --optimize-context
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize --optimize-context \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 
 # 在 Codex CLI 配置文件中
 # base_url: http://127.0.0.1:8787/v1/responses
@@ -376,7 +401,8 @@ uv run codebuddy_proxy.py --desensitize --optimize-context
 
 ```bash
 # 启用脱敏以避免合规术语被误拦
-uv run codebuddy_proxy.py --desensitize
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 
 # 示例请求
 curl http://127.0.0.1:8787/v1/chat/completions \
@@ -450,10 +476,12 @@ curl http://127.0.0.1:8787/v1/chat/completions \
 
 ```bash
 # 启用消息压缩
-uv run codebuddy_proxy.py --optimize-context
+uv run --with workbuddy2api python -m codebuddy_proxy --optimize-context \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 
 # 同时启用两个功能（推荐用于 Codex CLI）
-uv run codebuddy_proxy.py --desensitize --optimize-context
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize --optimize-context \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 #### 工作原理
@@ -497,7 +525,7 @@ uv run codebuddy_proxy.py --desensitize --optimize-context
 启用功能后，日志会记录压缩统计：
 
 ```bash
-grep projection_applied logs/codebuddy-proxy.jsonl | jq .
+grep projection_applied "$HOME/.workbuddy2api/codebuddy-proxy.jsonl" | jq .
 ```
 
 示例输出：
@@ -528,26 +556,36 @@ grep projection_applied logs/codebuddy-proxy.jsonl | jq .
 ### 日志
 
 日志包含：
-- 文本日志：`logs/proxy.log`（按天滚动，保留 30 天）
-- 结构化日志：`logs/codebuddy-proxy.jsonl`（完整请求/响应，包含流式细节）
+- 文本日志：`$HOME/.workbuddy2api/proxy.log`（按天滚动，保留 30 天）
+- 结构化日志：`$HOME/.workbuddy2api/codebuddy-proxy.jsonl`（按天滚动，保留 30 天，完整请求/响应）
+
+JSONL 每条记录包含 `app_version`、`system_version`、`python_version` 和 `machine` 字段；启动时还会记录 `startup` 事件。
+
+也可以指定日志文件的绝对路径：
+
+```bash
+uv run --with workbuddy2api python -m codebuddy_proxy \
+  --desensitize \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
+```
 
 查看日志：
 
 ```bash
 # 实时查看
-tail -f logs/codebuddy-proxy.jsonl
+tail -f "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 
 # 查看流式事件
-tail -100 logs/codebuddy-proxy.jsonl | jq 'select(.event | startswith("stream"))'
+tail -100 "$HOME/.workbuddy2api/codebuddy-proxy.jsonl" | jq 'select(.event | startswith("stream"))'
 
 # 统计超时
-jq 'select(.event=="stream_timeout")' logs/codebuddy-proxy.jsonl | wc -l
+jq 'select(.event=="stream_timeout")' "$HOME/.workbuddy2api/codebuddy-proxy.jsonl" | wc -l
 
 # 验证脱敏
-grep desensitize_applied logs/codebuddy-proxy.jsonl
+grep desensitize_applied "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 
 # 验证压缩（查看统计数据）
-grep projection_applied logs/codebuddy-proxy.jsonl | jq .
+grep projection_applied "$HOME/.workbuddy2api/codebuddy-proxy.jsonl" | jq .
 ```
 
 ### 找不到 session 文件
@@ -555,7 +593,8 @@ grep projection_applied logs/codebuddy-proxy.jsonl | jq .
 首次使用需要登录：
 
 ```bash
-uv run codebuddy_proxy.py --login
+uv run --with workbuddy2api python -m codebuddy_proxy --login \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ### 401 认证失败
@@ -563,7 +602,8 @@ uv run codebuddy_proxy.py --login
 Token 过期，重新登录：
 
 ```bash
-uv run codebuddy_proxy.py --login
+uv run --with workbuddy2api python -m codebuddy_proxy --login \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ### 审核拦截
@@ -571,20 +611,23 @@ uv run codebuddy_proxy.py --login
 启用脱敏：
 
 ```bash
-uv run codebuddy_proxy.py --desensitize
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 如果仍然被拦截，尝试压缩优化（仅 `/v1/responses`）：
 
 ```bash
-uv run codebuddy_proxy.py --desensitize --optimize-context
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize --optimize-context \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ### 端口被占用
 
 ```bash
 lsof -i :8787
-uv run codebuddy_proxy.py --port 8788
+uv run --with workbuddy2api python -m codebuddy_proxy --port 8788 \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ### SOCKS proxy 错误
@@ -599,7 +642,8 @@ env | grep -i proxy
 
 ```bash
 unset http_proxy https_proxy all_proxy
-uv run codebuddy_proxy.py
+uv run --with workbuddy2api python -m codebuddy_proxy \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ## 技术细节

{workbuddy2api-2.0.1 → workbuddy2api-2.0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "workbuddy2api"
-version = "2.0.1"
+version = "2.0.2"
 description = "Local OpenAI/Responses/Anthropic compatible proxy for CodeBuddy"
 readme = "README.md"
 requires-python = ">=3.10"

{workbuddy2api-2.0.1 → workbuddy2api-2.0.2}/src/codebuddy_proxy/__main__.py

@@ -8,20 +8,22 @@ Features:
 - Robust timeout handling with async iterators
 
 Usage with uv:
-    uv run codebuddy_proxy.py
-    uv run codebuddy_proxy.py --desensitize
-    uv run codebuddy_proxy.py --host 0.0.0.0 --port 8787
+    uv run --with workbuddy2api python -m codebuddy_proxy
+    uv run --with workbuddy2api python -m codebuddy_proxy --desensitize
+    uv run --with workbuddy2api python -m codebuddy_proxy --host 0.0.0.0 --port 8787
 """
 
 import argparse
 import base64
 import hashlib
 import io
+import importlib.metadata
 import json
 import logging
 import logging.handlers
 import os
 import pathlib
+import platform
 import sys
 import time
 import uuid
@@ -101,10 +103,40 @@ def setup_logging(log_dir: pathlib.Path) -> logging.Logger:
     return logger
 
 
+def setup_json_logging(log_file: pathlib.Path) -> logging.Logger:
+    """配置 JSONL 滚动日志：按天分片，保留30天。"""
+    logger = logging.getLogger("codebuddy_proxy.jsonl")
+    logger.setLevel(logging.INFO)
+    logger.propagate = False
+    logger.handlers.clear()
+
+    handler = logging.handlers.TimedRotatingFileHandler(
+        log_file, when="midnight", interval=1, backupCount=30, encoding="utf-8"
+    )
+    handler.suffix = "%Y-%m-%d"
+    handler.setFormatter(logging.Formatter("%(message)s"))
+    logger.addHandler(handler)
+
+    return logger
+
+
 def now_s() -> int:
     return int(time.time())
 
 
+def get_runtime_info() -> dict[str, str]:
+    try:
+        app_version = importlib.metadata.version("workbuddy2api")
+    except importlib.metadata.PackageNotFoundError:
+        app_version = "unknown"
+    return {
+        "app_version": app_version,
+        "system_version": platform.platform(),
+        "python_version": platform.python_version(),
+        "machine": platform.machine(),
+    }
+
+
 # ============================================================================
 # 全局状态管理
 # ============================================================================
@@ -121,6 +153,7 @@ class ProxyState:
         enable_optimize_context: bool = False,
         verbose_llm: bool = False,
         logger: logging.Logger | None = None,
+        json_logger: logging.Logger | None = None,
     ):
         self.client = client
         self.mock_dir = mock_dir
@@ -129,6 +162,8 @@ class ProxyState:
         self.enable_optimize_context = enable_optimize_context
         self.verbose_llm = verbose_llm
         self.logger = logger
+        self.json_logger = json_logger
+        self.runtime_info = get_runtime_info()
         self.started_at = time.time()
     
     def ensure_auth(self) -> None:
@@ -136,29 +171,33 @@ class ProxyState:
             self.client.ensure_authenticated()
     
     def write_log(self, event: str, **kwargs) -> None:
-        if self.log_file is None:
+        if self.json_logger is None:
             return
         try:
-            record = {"timestamp": time.strftime("%Y-%m-%dT%H:%M:%S%z"), "event": event, **kwargs}
-            with open(self.log_file, "a", encoding="utf-8") as f:
-                f.write(json.dumps(record, ensure_ascii=False) + "\n")
+            record = {
+                "timestamp": time.strftime("%Y-%m-%dT%H:%M:%S%z"),
+                "event": event,
+                **self.runtime_info,
+                **kwargs,
+            }
+            self.json_logger.info(json.dumps(record, ensure_ascii=False))
         except Exception:
             pass
     
     def write_body_log(self, event: str, body: bytes, **kwargs) -> None:
-        if self.log_file is None:
+        if self.json_logger is None:
             return
         try:
             text = body.decode("utf-8", errors="replace")
             record = {
                 "timestamp": time.strftime("%Y-%m-%dT%H:%M:%S%z"),
                 "event": event,
+                **self.runtime_info,
                 "body_bytes": len(body),
                 "body_text": text,
                 **kwargs
             }
-            with open(self.log_file, "a", encoding="utf-8") as f:
-                f.write(json.dumps(record, ensure_ascii=False) + "\n")
+            self.json_logger.info(json.dumps(record, ensure_ascii=False))
         except Exception:
             pass
 
@@ -1500,9 +1539,18 @@ def main():
                         help="会话文件路径")
     parser.add_argument("--mock-dir", type=pathlib.Path,
                         help="只使用指定目录中的真实响应 fixture，不访问 CodeBuddy 后端")
-    parser.add_argument("--log-file", type=pathlib.Path,
-                        default=pathlib.Path(os.getenv("CODEBUDDY_PROXY_LOG_FILE", "logs/codebuddy-proxy.jsonl")),
-                        help="记录完整请求/响应的 JSONL 文件（默认 logs/codebuddy-proxy.jsonl）")
+    default_log_file = pathlib.Path(
+        os.getenv(
+            "CODEBUDDY_PROXY_LOG_FILE",
+            str(pathlib.Path.home() / ".workbuddy2api" / "codebuddy-proxy.jsonl"),
+        )
+    ).expanduser()
+    parser.add_argument(
+        "--log-file",
+        type=pathlib.Path,
+        default=default_log_file,
+        help="记录完整请求/响应的 JSONL 文件（默认 ~/.workbuddy2api/codebuddy-proxy.jsonl）",
+    )
     parser.add_argument("--desensitize", action="store_true",
                         help="启用脱敏处理，对 system 消息中的敏感词插入零宽空格（缓解审核误拦）")
     parser.add_argument("--optimize-context", action="store_true",
@@ -1518,10 +1566,12 @@ def main():
     parser.add_argument("--config-cache-ttl", type=int, default=int(os.getenv("CODEBUDDY_CONFIG_CACHE_TTL", "300")),
                         help="远程配置缓存 TTL（秒，默认 300）")
     args = parser.parse_args()
+    args.log_file = args.log_file.expanduser()
     
     # 设置日志
     log_dir = args.log_file.parent if args.log_file else pathlib.Path("logs")
     logger = setup_logging(log_dir)
+    json_logger = setup_json_logging(args.log_file)
     
     # 初始化客户端
     client = CodeBuddyClient(args.endpoint, session_file=args.session_file)
@@ -1538,7 +1588,20 @@ def main():
         enable_desensitize=args.desensitize,
         enable_optimize_context=args.optimize_context,
         verbose_llm=args.verbose_llm,
-        logger=logger
+        logger=logger,
+        json_logger=json_logger,
+    )
+    proxy_state.write_log(
+        "startup",
+        host=args.host,
+        port=args.port,
+    )
+    logger.info(
+        "Runtime: app_version=%s system_version=%s python_version=%s machine=%s",
+        proxy_state.runtime_info["app_version"],
+        proxy_state.runtime_info["system_version"],
+        proxy_state.runtime_info["python_version"],
+        proxy_state.runtime_info["machine"],
     )
     
     # 初始化远程配置缓存（默认启用动态模型列表）

{workbuddy2api-2.0.1 → workbuddy2api-2.0.2}/src/workbuddy2api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: workbuddy2api
-Version: 2.0.1
+Version: 2.0.2
 Summary: Local OpenAI/Responses/Anthropic compatible proxy for CodeBuddy
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -30,21 +30,40 @@ Dynamic: license-file
 
 ## 安装
 
-推荐使用 [uv](https://docs.astral.sh/uv/)：
+推荐使用 [uv](https://docs.astral.sh/uv/) 从 PyPI 运行：
 
 ```bash
 # 安装 uv
 curl -LsSf https://astral.sh/uv/install.sh | sh
 
-# 直接运行（uv 会自动安装依赖）
-uv run codebuddy_proxy.py
+# 运行最新可用版本（uv 会自动创建环境并安装依赖）
+uv run --with workbuddy2api python -m codebuddy_proxy \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
+
+# 强制刷新缓存后运行最新版本
+uv run --refresh-package workbuddy2api --with workbuddy2api \
+  python -m codebuddy_proxy \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
+```
+
+后续启动无需手动激活虚拟环境，重复执行上述 `uv run` 命令即可。
+
+### 本地源码启动
+
+在项目根目录执行以下命令，使用当前工作区源码而不是 PyPI 中的已发布版本：
+
+```bash
+# 同步本地项目依赖
+uv sync
+
+# 启动本地源码
+uv run python -m codebuddy_proxy --desensitize
 ```
 
-或传统方式：
+首次使用需要登录时：
 
 ```bash
-pip install -r requirements.txt
-python codebuddy_proxy.py
+uv run python -m codebuddy_proxy --login --desensitize
 ```
 
 ## 快速开始
@@ -52,11 +71,9 @@ python codebuddy_proxy.py
 ### 1. 启动 proxy
 
 ```bash
-# 使用 uv（推荐）
-uv run codebuddy_proxy.py --desensitize
-
-# 或传统方式
-python codebuddy_proxy.py --desensitize
+# 使用最新版本（推荐）
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 默认监听 `http://127.0.0.1:8787`
@@ -118,7 +135,7 @@ codex --profile codebuddy "你的任务"
 --port PORT              监听端口（默认 8787）
 --endpoint ENDPOINT      CodeBuddy 后端地址
 --session-file PATH      会话文件路径（默认 ~/.codebuddy-session.json）
---log-file PATH          JSONL 日志文件（默认 logs/codebuddy-proxy.jsonl）
+--log-file PATH          JSONL 日志文件（默认 ~/.workbuddy2api/codebuddy-proxy.jsonl）
 --desensitize            启用脱敏处理（推荐）
 --optimize-context       启用消息压缩优化（Codex CLI 推荐）
 --login                  启动时执行浏览器登录
@@ -142,7 +159,8 @@ CODEBUDDY_PROXY_LOG_FILE  # 等同 --log-file
 ### 首次使用（需要登录）
 
 ```bash
-uv run codebuddy_proxy.py --login
+uv run --with workbuddy2api python -m codebuddy_proxy --login \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 浏览器打开后登录，成功后 proxy 自动启动。
@@ -150,29 +168,34 @@ uv run codebuddy_proxy.py --login
 ### 日常使用（自动读取登录态）
 
 ```bash
-uv run codebuddy_proxy.py --desensitize
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ### Codex CLI 场景（启用压缩优化）
 
 ```bash
-uv run codebuddy_proxy.py --desensitize --optimize-context
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize --optimize-context \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ### 多账号切换
 
 ```bash
 # 账号 1
-uv run codebuddy_proxy.py --session-file ~/.codebuddy-work.json --login
+uv run --with workbuddy2api python -m codebuddy_proxy --session-file ~/.codebuddy-work.json --login \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 
 # 账号 2
-uv run codebuddy_proxy.py --session-file ~/.codebuddy-personal.json --login
+uv run --with workbuddy2api python -m codebuddy_proxy --session-file ~/.codebuddy-personal.json --login \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ### 监听所有网卡（局域网共享）
 
 ```bash
-uv run codebuddy_proxy.py --host 0.0.0.0 --desensitize
+uv run --with workbuddy2api python -m codebuddy_proxy --host 0.0.0.0 --desensitize \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ## API 接口
@@ -371,7 +394,8 @@ upstream chunk → response.output_text.delta
 
 ```bash
 # 必须启用 --desensitize，否则几乎每次都被拦截
-uv run codebuddy_proxy.py --desensitize
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 
 # 在 Claude Code / CC Switch 中配置
 # Base URL: http://127.0.0.1:8787/v1/messages
@@ -381,7 +405,8 @@ uv run codebuddy_proxy.py --desensitize
 
 ```bash
 # 同时启用脱敏和消息压缩（最佳配置）
-uv run codebuddy_proxy.py --desensitize --optimize-context
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize --optimize-context \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 
 # 在 Codex CLI 配置文件中
 # base_url: http://127.0.0.1:8787/v1/responses
@@ -391,7 +416,8 @@ uv run codebuddy_proxy.py --desensitize --optimize-context
 
 ```bash
 # 启用脱敏以避免合规术语被误拦
-uv run codebuddy_proxy.py --desensitize
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 
 # 示例请求
 curl http://127.0.0.1:8787/v1/chat/completions \
@@ -465,10 +491,12 @@ curl http://127.0.0.1:8787/v1/chat/completions \
 
 ```bash
 # 启用消息压缩
-uv run codebuddy_proxy.py --optimize-context
+uv run --with workbuddy2api python -m codebuddy_proxy --optimize-context \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 
 # 同时启用两个功能（推荐用于 Codex CLI）
-uv run codebuddy_proxy.py --desensitize --optimize-context
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize --optimize-context \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 #### 工作原理
@@ -512,7 +540,7 @@ uv run codebuddy_proxy.py --desensitize --optimize-context
 启用功能后，日志会记录压缩统计：
 
 ```bash
-grep projection_applied logs/codebuddy-proxy.jsonl | jq .
+grep projection_applied "$HOME/.workbuddy2api/codebuddy-proxy.jsonl" | jq .
 ```
 
 示例输出：
@@ -543,26 +571,36 @@ grep projection_applied logs/codebuddy-proxy.jsonl | jq .
 ### 日志
 
 日志包含：
-- 文本日志：`logs/proxy.log`（按天滚动，保留 30 天）
-- 结构化日志：`logs/codebuddy-proxy.jsonl`（完整请求/响应，包含流式细节）
+- 文本日志：`$HOME/.workbuddy2api/proxy.log`（按天滚动，保留 30 天）
+- 结构化日志：`$HOME/.workbuddy2api/codebuddy-proxy.jsonl`（按天滚动，保留 30 天，完整请求/响应）
+
+JSONL 每条记录包含 `app_version`、`system_version`、`python_version` 和 `machine` 字段；启动时还会记录 `startup` 事件。
+
+也可以指定日志文件的绝对路径：
+
+```bash
+uv run --with workbuddy2api python -m codebuddy_proxy \
+  --desensitize \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
+```
 
 查看日志：
 
 ```bash
 # 实时查看
-tail -f logs/codebuddy-proxy.jsonl
+tail -f "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 
 # 查看流式事件
-tail -100 logs/codebuddy-proxy.jsonl | jq 'select(.event | startswith("stream"))'
+tail -100 "$HOME/.workbuddy2api/codebuddy-proxy.jsonl" | jq 'select(.event | startswith("stream"))'
 
 # 统计超时
-jq 'select(.event=="stream_timeout")' logs/codebuddy-proxy.jsonl | wc -l
+jq 'select(.event=="stream_timeout")' "$HOME/.workbuddy2api/codebuddy-proxy.jsonl" | wc -l
 
 # 验证脱敏
-grep desensitize_applied logs/codebuddy-proxy.jsonl
+grep desensitize_applied "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 
 # 验证压缩（查看统计数据）
-grep projection_applied logs/codebuddy-proxy.jsonl | jq .
+grep projection_applied "$HOME/.workbuddy2api/codebuddy-proxy.jsonl" | jq .
 ```
 
 ### 找不到 session 文件
@@ -570,7 +608,8 @@ grep projection_applied logs/codebuddy-proxy.jsonl | jq .
 首次使用需要登录：
 
 ```bash
-uv run codebuddy_proxy.py --login
+uv run --with workbuddy2api python -m codebuddy_proxy --login \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ### 401 认证失败
@@ -578,7 +617,8 @@ uv run codebuddy_proxy.py --login
 Token 过期，重新登录：
 
 ```bash
-uv run codebuddy_proxy.py --login
+uv run --with workbuddy2api python -m codebuddy_proxy --login \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ### 审核拦截
@@ -586,20 +626,23 @@ uv run codebuddy_proxy.py --login
 启用脱敏：
 
 ```bash
-uv run codebuddy_proxy.py --desensitize
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 如果仍然被拦截，尝试压缩优化（仅 `/v1/responses`）：
 
 ```bash
-uv run codebuddy_proxy.py --desensitize --optimize-context
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize --optimize-context \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ### 端口被占用
 
 ```bash
 lsof -i :8787
-uv run codebuddy_proxy.py --port 8788
+uv run --with workbuddy2api python -m codebuddy_proxy --port 8788 \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ### SOCKS proxy 错误
@@ -614,7 +657,8 @@ env | grep -i proxy
 
 ```bash
 unset http_proxy https_proxy all_proxy
-uv run codebuddy_proxy.py
+uv run --with workbuddy2api python -m codebuddy_proxy \
+  --log-file "$HOME/.workbuddy2api/codebuddy-proxy.jsonl"
 ```
 
 ## 技术细节