workbuddy2api 2.0.1__tar.gz → 2.0.3__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: workbuddy2api
-Version: 2.0.1
+Version: 2.0.3
 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
-pip install -r requirements.txt
-python codebuddy_proxy.py
+# 同步本地项目依赖
+uv sync
+
+# 启动本地源码
+uv run python -m codebuddy_proxy --desensitize
+```
+
+首次使用需要登录时：
+
+```bash
+uv run python -m codebuddy_proxy --login --desensitize
 ```
 
 ## 快速开始
@@ -52,11 +71,11 @@ python codebuddy_proxy.py
 ### 1. 启动 proxy
 
 ```bash
-# 使用 uv（推荐）
-uv run codebuddy_proxy.py --desensitize
+# 使用最新版本（推荐）
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize
 
-# 或传统方式
-python codebuddy_proxy.py --desensitize
+# 首次使用：登录并启动
+uv run --with workbuddy2api python -m codebuddy_proxy --login --desensitize
 ```
 
 默认监听 `http://127.0.0.1:8787`
@@ -118,7 +137,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 +161,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 +170,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 +396,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 +407,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 +418,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 +493,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 +542,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 +573,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 +610,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 +619,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 +628,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 +659,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.3}/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
-pip install -r requirements.txt
-python codebuddy_proxy.py
+# 同步本地项目依赖
+uv sync
+
+# 启动本地源码
+uv run python -m codebuddy_proxy --desensitize
+```
+
+首次使用需要登录时：
+
+```bash
+uv run python -m codebuddy_proxy --login --desensitize
 ```
 
 ## 快速开始
@@ -37,11 +56,11 @@ python codebuddy_proxy.py
 ### 1. 启动 proxy
 
 ```bash
-# 使用 uv（推荐）
-uv run codebuddy_proxy.py --desensitize
+# 使用最新版本（推荐）
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize
 
-# 或传统方式
-python codebuddy_proxy.py --desensitize
+# 首次使用：登录并启动
+uv run --with workbuddy2api python -m codebuddy_proxy --login --desensitize
 ```
 
 默认监听 `http://127.0.0.1:8787`
@@ -103,7 +122,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 +146,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 +155,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 +381,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 +392,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 +403,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 +478,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 +527,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 +558,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 +595,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 +604,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 +613,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 +644,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.3}/pyproject.toml

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

{workbuddy2api-2.0.1 → workbuddy2api-2.0.3}/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
 
@@ -293,7 +332,7 @@ class RemoteConfigCache:
             
             # 构造请求头（包含认证信息）
             headers = state.client.auth_headers()
-            headers["User-Agent"] = "CodeBuddy-Proxy/2.0"
+            headers["User-Agent"] = "Mozilla/5.0 (compatible; Genie-IDE/1.0)"
             headers["Accept"] = "application/json"
             
             # 发起请求（超时 5 秒，匹配插件）
@@ -858,11 +897,18 @@ async def forward_chat(
     
     url = state.client.endpoint + "/v2/chat/completions"
     headers = {
+        "User-Agent": "Mozilla/5.0 (compatible; Genie-IDE/1.0)",
         **state.client.auth_headers(),
         "Content-Type": "application/json",
         "Accept": "text/event-stream",
     }
     
+    # 🔍 调试：输出实际发送的IDE识别headers
+    if state.logger:
+        ide_headers = {k: v for k, v in headers.items() 
+                      if k.startswith("X-IDE-") or k == "X-Product-Version" or k == "X-Machine-Id"}
+        diagnostic("upstream_ide_headers", **ide_headers)
+    
     if stream:
         # 流式：直接转发
         return StreamingResponse(
@@ -1500,9 +1546,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 +1573,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 +1595,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.3}/src/codebuddy_proxy/codebuddy_client_demo.py

@@ -81,8 +81,11 @@ class CodeBuddyClient:
         body: Any = None,
         timeout: float = 30,
     ) -> Any:
-        request_headers = {"User-Agent": "CodeBuddyClientDemo/1.0"}
-        request_headers.update(headers or {})
+        # 🔥 所有请求都必须包含这两个基础标识（匹配插件行为）
+        request_headers = {
+            "User-Agent": "Mozilla/5.0 (compatible; Genie-IDE/1.0)",
+            "X-Product-Code": "codebuddy",
+        }
         data = None
         if body is not None:
             data = json.dumps(body).encode("utf-8")
@@ -110,9 +113,20 @@ class CodeBuddyClient:
             raise CodeBuddyError(f"{path} 返回的不是 JSON: {raw[:300]!r}") from exc
 
     def auth_headers(self, *, access: bool = True, refresh: bool = False) -> dict[str, str]:
+        """构造认证 headers，模拟插件行为"""
         account = self.session.get("account") or {}
         auth = self.session.get("auth") or {}
-        headers: dict[str, str] = {}
+        headers: dict[str, str] = {
+            # 🔥 关键标识：所有请求都需要这个 header
+            "X-Product-Code": "codebuddy",
+            # 🔥 IDE 识别信息（服务端用于识别客户端类型）
+            "X-IDE-Type": "vscode",
+            "X-IDE-Name": "Visual Studio Code",
+            "X-IDE-Version": "1.70.2",  # VSCode 最低版本要求
+            "X-Product-Version": "4.10.33259736",  # 插件版本
+            "X-Machine-Id": self._get_machine_id(),
+        }
+        
         if account.get("uid"):
             headers["X-User-Id"] = str(account["uid"])
         if access and auth.get("accessToken"):
@@ -122,12 +136,41 @@ class CodeBuddyClient:
         if account.get("enterpriseId"):
             headers["X-Enterprise-Id"] = str(account["enterpriseId"])
             headers["X-Tenant-Id"] = str(account["enterpriseId"])
+        if account.get("departmentInfo"):
+            # 🔥 新增：部门信息（如果有）
+            headers["X-Department-Info"] = str(account["departmentInfo"])
         if auth.get("domain"):
             # The extension calls this the domain header.  The server accepts
             # X-Domain for the plugin protocol.
             headers["X-Domain"] = str(auth["domain"])
         return headers
 
+    def _get_machine_id(self) -> str:
+        """获取或生成机器ID（模拟VSCode的machineId）"""
+        import hashlib
+        import platform
+        import uuid
+        
+        # 尝试从session读取已保存的machineId
+        saved_machine_id = self.session.get("machineId")
+        if saved_machine_id:
+            return str(saved_machine_id)
+        
+        # 生成一个稳定的machineId（基于主机名和用户）
+        try:
+            hostname = platform.node()
+            username = os.environ.get("USER") or os.environ.get("USERNAME") or "unknown"
+            seed = f"{hostname}-{username}"
+            machine_id = str(uuid.uuid5(uuid.NAMESPACE_DNS, seed))
+        except Exception:
+            # 如果失败，生成随机ID
+            machine_id = str(uuid.uuid4())
+        
+        # 保存到session
+        self.session["machineId"] = machine_id
+        self._save_session(self.session)
+        return machine_id
+
     def login(self, *, open_browser: bool = True, timeout: int = 300) -> None:
         no_auth = {
             "X-No-Authorization": "true",
@@ -250,6 +293,8 @@ class CodeBuddyClient:
             f"{self.endpoint}/v2/chat/completions",
             data=json.dumps(payload).encode("utf-8"),
             headers={
+                "User-Agent": "Mozilla/5.0 (compatible; Genie-IDE/1.0)",
+                "X-Product-Code": "codebuddy",
                 **self.auth_headers(),
                 "Content-Type": "application/json",
                 "Accept": "text/event-stream",

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: workbuddy2api
-Version: 2.0.1
+Version: 2.0.3
 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
-pip install -r requirements.txt
-python codebuddy_proxy.py
+# 同步本地项目依赖
+uv sync
+
+# 启动本地源码
+uv run python -m codebuddy_proxy --desensitize
+```
+
+首次使用需要登录时：
+
+```bash
+uv run python -m codebuddy_proxy --login --desensitize
 ```
 
 ## 快速开始
@@ -52,11 +71,11 @@ python codebuddy_proxy.py
 ### 1. 启动 proxy
 
 ```bash
-# 使用 uv（推荐）
-uv run codebuddy_proxy.py --desensitize
+# 使用最新版本（推荐）
+uv run --with workbuddy2api python -m codebuddy_proxy --desensitize
 
-# 或传统方式
-python codebuddy_proxy.py --desensitize
+# 首次使用：登录并启动
+uv run --with workbuddy2api python -m codebuddy_proxy --login --desensitize
 ```
 
 默认监听 `http://127.0.0.1:8787`
@@ -118,7 +137,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 +161,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 +170,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 +396,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 +407,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 +418,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 +493,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 +542,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 +573,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 +610,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 +619,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 +628,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 +659,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"
 ```
 
 ## 技术细节