workbuddy2api 2.0.7__tar.gz → 2.0.8.dev1__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {workbuddy2api-2.0.7/src/workbuddy2api.egg-info → workbuddy2api-2.0.8.dev1}/PKG-INFO +115 -40
- workbuddy2api-2.0.7/PKG-INFO → workbuddy2api-2.0.8.dev1/README.md +112 -54
- {workbuddy2api-2.0.7 → workbuddy2api-2.0.8.dev1}/pyproject.toml +5 -3
- {workbuddy2api-2.0.7 → workbuddy2api-2.0.8.dev1}/src/codebuddy_proxy/__main__.py +311 -25
- workbuddy2api-2.0.8.dev1/src/codebuddy_proxy/account_checkin.py +4 -0
- workbuddy2api-2.0.8.dev1/src/codebuddy_proxy/account_manager.py +947 -0
- workbuddy2api-2.0.8.dev1/src/codebuddy_proxy/account_store.py +4 -0
- workbuddy2api-2.0.8.dev1/src/codebuddy_proxy/admin.html +1883 -0
- workbuddy2api-2.0.8.dev1/src/codebuddy_proxy/admin_api.py +496 -0
- workbuddy2api-2.0.8.dev1/src/codebuddy_proxy/backend_profile.py +4 -0
- workbuddy2api-2.0.8.dev1/src/codebuddy_proxy/billing_proxy.py +4 -0
- workbuddy2api-2.0.8.dev1/src/codebuddy_proxy/codebuddy_client_demo.py +116 -0
- {workbuddy2api-2.0.7 → workbuddy2api-2.0.8.dev1}/src/codebuddy_proxy/role_compat.py +15 -9
- {workbuddy2api-2.0.7 → workbuddy2api-2.0.8.dev1}/src/codebuddy_proxy/upstream_request.py +3 -3
- workbuddy2api-2.0.7/README.md → workbuddy2api-2.0.8.dev1/src/workbuddy2api.egg-info/PKG-INFO +129 -39
- {workbuddy2api-2.0.7 → workbuddy2api-2.0.8.dev1}/src/workbuddy2api.egg-info/SOURCES.txt +5 -0
- {workbuddy2api-2.0.7 → workbuddy2api-2.0.8.dev1}/src/workbuddy2api.egg-info/requires.txt +2 -0
- workbuddy2api-2.0.7/src/codebuddy_proxy/backend_profile.py +0 -198
- workbuddy2api-2.0.7/src/codebuddy_proxy/billing_proxy.py +0 -99
- workbuddy2api-2.0.7/src/codebuddy_proxy/codebuddy_client_demo.py +0 -566
- {workbuddy2api-2.0.7 → workbuddy2api-2.0.8.dev1}/LICENSE +0 -0
- {workbuddy2api-2.0.7 → workbuddy2api-2.0.8.dev1}/setup.cfg +0 -0
- {workbuddy2api-2.0.7 → workbuddy2api-2.0.8.dev1}/src/codebuddy_proxy/anthropic_adapter.py +0 -0
- {workbuddy2api-2.0.7 → workbuddy2api-2.0.8.dev1}/src/codebuddy_proxy/desensitize.py +0 -0
- {workbuddy2api-2.0.7 → workbuddy2api-2.0.8.dev1}/src/codebuddy_proxy/dsml_parser.py +0 -0
- {workbuddy2api-2.0.7 → workbuddy2api-2.0.8.dev1}/src/codebuddy_proxy/models_config.domestic.json +0 -0
- {workbuddy2api-2.0.7 → workbuddy2api-2.0.8.dev1}/src/codebuddy_proxy/models_config.global.json +0 -0
- {workbuddy2api-2.0.7 → workbuddy2api-2.0.8.dev1}/src/codebuddy_proxy/process_diagnostics.py +0 -0
- {workbuddy2api-2.0.7 → workbuddy2api-2.0.8.dev1}/src/codebuddy_proxy/projection_metadata.py +0 -0
- {workbuddy2api-2.0.7 → workbuddy2api-2.0.8.dev1}/src/codebuddy_proxy/protocol_response.py +0 -0
- {workbuddy2api-2.0.7 → workbuddy2api-2.0.8.dev1}/src/codebuddy_proxy/responses_adapter.py +0 -0
- {workbuddy2api-2.0.7 → workbuddy2api-2.0.8.dev1}/src/codebuddy_proxy/responses_projection.py +0 -0
- {workbuddy2api-2.0.7 → workbuddy2api-2.0.8.dev1}/src/codebuddy_proxy/tool_pairing.py +0 -0
- {workbuddy2api-2.0.7 → workbuddy2api-2.0.8.dev1}/src/workbuddy2api.egg-info/dependency_links.txt +0 -0
- {workbuddy2api-2.0.7 → workbuddy2api-2.0.8.dev1}/src/workbuddy2api.egg-info/entry_points.txt +0 -0
- {workbuddy2api-2.0.7 → workbuddy2api-2.0.8.dev1}/src/workbuddy2api.egg-info/top_level.txt +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: workbuddy2api
|
|
3
|
-
Version: 2.0.
|
|
3
|
+
Version: 2.0.8.dev1
|
|
4
4
|
Summary: Local OpenAI/Responses/Anthropic compatible proxy for CodeBuddy
|
|
5
5
|
Requires-Python: >=3.10
|
|
6
6
|
Description-Content-Type: text/markdown
|
|
@@ -9,6 +9,8 @@ Requires-Dist: fastapi>=0.104.0
|
|
|
9
9
|
Requires-Dist: uvicorn>=0.24.0
|
|
10
10
|
Requires-Dist: httpx[socks]>=0.25.0
|
|
11
11
|
Requires-Dist: requests>=2.31.0
|
|
12
|
+
Requires-Dist: buddy-agent-auth<0.2,>=0.1.0.dev1
|
|
13
|
+
Requires-Dist: buddy-agent-checkin[workbuddy]<0.2,>=0.1.1.dev2
|
|
12
14
|
Provides-Extra: dev
|
|
13
15
|
Requires-Dist: pytest>=7.4.0; extra == "dev"
|
|
14
16
|
Dynamic: license-file
|
|
@@ -30,7 +32,9 @@ For unexplained Windows process exits, use the [independent process monitor](doc
|
|
|
30
32
|
- **DSML parsing** - Automatically detects and converts DeepSeek Markup Language (DSML) tool calls
|
|
31
33
|
- **Streaming responses** - SSE streaming output, returning generated content in real time, with built-in 60-second timeout protection
|
|
32
34
|
- **Domestic and international backends** - Uses domestic CodeBuddy by default and switches to the international CodeBuddy service with `--global`, with isolated sessions and model catalogs
|
|
33
|
-
- **Multi-account management** -
|
|
35
|
+
- **Multi-account management** - Link domestic and Global accounts, switch the active account, and remove non-active accounts from the local admin page
|
|
36
|
+
- **Model-level 429 handling** - Track cooldowns per account and model, with optional same-region failover
|
|
37
|
+
- **Daily check-in** - Check in manually or enable background checks for all linked accounts
|
|
34
38
|
|
|
35
39
|
---
|
|
36
40
|
|
|
@@ -66,12 +70,14 @@ uv sync
|
|
|
66
70
|
uv run python -m codebuddy_proxy --desensitize
|
|
67
71
|
```
|
|
68
72
|
|
|
69
|
-
On first use,
|
|
73
|
+
On first use, start the proxy and open the local account manager:
|
|
70
74
|
|
|
71
75
|
```bash
|
|
72
|
-
uv run python -m codebuddy_proxy --
|
|
76
|
+
uv run python -m codebuddy_proxy --desensitize
|
|
73
77
|
```
|
|
74
78
|
|
|
79
|
+
Then visit `http://127.0.0.1:8787/admin` and link a domestic or Global account.
|
|
80
|
+
|
|
75
81
|
## Quick Start
|
|
76
82
|
|
|
77
83
|
### 1. Start the proxy
|
|
@@ -80,8 +86,8 @@ uv run python -m codebuddy_proxy --login --desensitize
|
|
|
80
86
|
# Use the latest version (recommended)
|
|
81
87
|
uv run --with workbuddy2api python -m codebuddy_proxy --desensitize
|
|
82
88
|
|
|
83
|
-
# First use:
|
|
84
|
-
uv run --with workbuddy2api python -m codebuddy_proxy --
|
|
89
|
+
# First use: start, then link an account at http://127.0.0.1:8787/admin
|
|
90
|
+
uv run --with workbuddy2api python -m codebuddy_proxy --desensitize
|
|
85
91
|
|
|
86
92
|
# International service: first login and start
|
|
87
93
|
uv run --with workbuddy2api python -m codebuddy_proxy --global --login --desensitize
|
|
@@ -97,12 +103,23 @@ Listens on `http://127.0.0.1:8787` by default.
|
|
|
97
103
|
The proxy supports both CodeBuddy regions. Domestic mode remains the default,
|
|
98
104
|
so existing startup commands continue to work unchanged.
|
|
99
105
|
|
|
100
|
-
| Mode | Startup option | Upstream endpoint |
|
|
101
|
-
| --- | --- | --- |
|
|
102
|
-
| Domestic (default) | none | `https://copilot.tencent.com` |
|
|
103
|
-
| International | `--global` | `https://www.codebuddy.ai` |
|
|
106
|
+
| Mode | Startup option | Upstream endpoint |
|
|
107
|
+
| --- | --- | --- |
|
|
108
|
+
| Domestic (default) | none | `https://copilot.tencent.com` |
|
|
109
|
+
| International | `--global` | `https://www.codebuddy.ai` |
|
|
110
|
+
|
|
111
|
+
Linked accounts are stored separately by region in `~/.workbuddy2api/accounts`.
|
|
112
|
+
Use `--accounts-dir DIR` to choose another local directory. With no explicit
|
|
113
|
+
selector, the proxy restores the saved active account. On the first migration,
|
|
114
|
+
matching legacy session files are imported once and kept; deleting an imported
|
|
115
|
+
account does not import it again. Explicit `--global` or `--endpoint` selects a
|
|
116
|
+
matching account, while `--session-file` can import that file again. If there is
|
|
117
|
+
no match, the proxy starts without an active account. `--login` uses a temporary
|
|
118
|
+
session file to add or refresh an account without replacing a legacy file.
|
|
104
119
|
|
|
105
|
-
|
|
120
|
+
The account manager can add accounts for either region while the proxy is
|
|
121
|
+
running. For a terminal-driven login, the existing `--login` option remains
|
|
122
|
+
available:
|
|
106
123
|
|
|
107
124
|
```bash
|
|
108
125
|
# First login
|
|
@@ -118,16 +135,18 @@ If the package is installed as a command, the equivalent short form is
|
|
|
118
135
|
`workbuddy2api --global --login`. When running from source, use
|
|
119
136
|
`uv run python -m codebuddy_proxy --global --login`.
|
|
120
137
|
|
|
121
|
-
`--global`
|
|
122
|
-
OpenCode, and other clients continue to use
|
|
123
|
-
selected profile also controls the model catalog
|
|
138
|
+
`--global` selects the Global backend and a matching account when one exists.
|
|
139
|
+
Codex CLI, Claude Code/CC Switch, OpenCode, and other clients continue to use
|
|
140
|
+
the same local proxy URLs. The selected profile also controls the model catalog
|
|
141
|
+
returned by `/v1/models`.
|
|
124
142
|
|
|
125
|
-
Domestic and international
|
|
126
|
-
`--session-file`
|
|
127
|
-
|
|
128
|
-
|
|
143
|
+
Domestic and international accounts remain isolated. An explicit
|
|
144
|
+
`--session-file` is imported only when its saved backend and endpoint match the
|
|
145
|
+
current startup options. The proxy refuses mismatched credentials and does not
|
|
146
|
+
modify the original file.
|
|
129
147
|
|
|
130
|
-
For a custom international endpoint,
|
|
148
|
+
For a custom international endpoint, use a dedicated session file when
|
|
149
|
+
importing or creating a login from the command line:
|
|
131
150
|
|
|
132
151
|
```bash
|
|
133
152
|
uv run --with workbuddy2api python -m codebuddy_proxy \
|
|
@@ -142,20 +161,23 @@ Endpoint precedence is: explicit `--endpoint` > the `--global` profile default
|
|
|
142
161
|
Therefore `--global` without `--endpoint` cannot be redirected to the domestic
|
|
143
162
|
host by `CODEBUDDY_ENDPOINT`.
|
|
144
163
|
|
|
145
|
-
###
|
|
164
|
+
### Built-in CodeBuddy gateways: developer-role compatibility
|
|
146
165
|
|
|
147
|
-
The domestic
|
|
148
|
-
Chat Completions
|
|
149
|
-
|
|
150
|
-
`developer` to `system`
|
|
151
|
-
|
|
152
|
-
|
|
166
|
+
The built-in domestic (`https://copilot.tencent.com`) and international
|
|
167
|
+
(`https://www.codebuddy.ai`) Chat Completions gateways may reject requests
|
|
168
|
+
containing a `developer` message with HTTP 400 / code 11128. Before forwarding
|
|
169
|
+
to either matching backend and host, the proxy maps `developer` to `system`
|
|
170
|
+
without changing message order, content, tool-call history, or the original
|
|
171
|
+
client request. If enabled, `--desensitize` runs after this role adaptation.
|
|
172
|
+
No client-side configuration is needed.
|
|
153
173
|
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
not
|
|
158
|
-
|
|
174
|
+
The mapping is scoped to these exact backend/host pairs; endpoints using
|
|
175
|
+
other host names keep their original roles. International `X-Conversation-*` headers
|
|
176
|
+
are still generated after request-body transformations. Because the upstreams
|
|
177
|
+
do not represent the separate `system` and `developer` instruction priorities,
|
|
178
|
+
the mapping is an approximation, not exact semantic equivalence. The
|
|
179
|
+
`upstream_role_compat` log event reports the backend and number of mapped
|
|
180
|
+
messages, not prompt contents.
|
|
159
181
|
|
|
160
182
|
Runtime model catalogs are loaded from the packaged profile resources
|
|
161
183
|
`src/codebuddy_proxy/models_config.domestic.json` and
|
|
@@ -324,6 +346,7 @@ Select the model inside OMP with `/model codebuddy/hy3` (or set it as the defaul
|
|
|
324
346
|
--global Use the international CodeBuddy backend (default domestic)
|
|
325
347
|
--endpoint ENDPOINT CodeBuddy backend address (overrides the profile default)
|
|
326
348
|
--session-file PATH Session file path (isolated by profile by default)
|
|
349
|
+
--accounts-dir DIR Account library directory (default ~/.workbuddy2api/accounts)
|
|
327
350
|
--log-file PATH JSONL log file (default ~/.workbuddy2api/codebuddy-proxy.jsonl)
|
|
328
351
|
--desensitize Enable desensitization (recommended)
|
|
329
352
|
--optimize-context Enable message compression (recommended for Codex CLI)
|
|
@@ -384,15 +407,58 @@ uv run --with workbuddy2api python -m codebuddy_proxy --desensitize --optimize-c
|
|
|
384
407
|
|
|
385
408
|
### Multi-account switching
|
|
386
409
|
|
|
387
|
-
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
410
|
+
Start the proxy and open [http://127.0.0.1:8787/admin](http://127.0.0.1:8787/admin).
|
|
411
|
+
Choose **Domestic** or **Global**, then link the account in the browser window.
|
|
412
|
+
The first linked account becomes active automatically; linking another account
|
|
413
|
+
does not change the account currently in use. Use **Set active** to switch, or
|
|
414
|
+
remove a non-active account from the same page. The selection is saved for the
|
|
415
|
+
next proxy start. Switching affects new requests; requests already in progress
|
|
416
|
+
continue with the account selected when they began.
|
|
417
|
+
|
|
418
|
+

|
|
419
|
+
|
|
420
|
+
The screenshot uses synthetic demo accounts. Account UIDs are covered, and no
|
|
421
|
+
credentials or session contents are shown. Accounts are kept separately by
|
|
422
|
+
backend, normalized endpoint, and user ID in `~/.workbuddy2api/accounts`; use
|
|
423
|
+
`--accounts-dir DIR` to choose another local directory. The manager remains
|
|
424
|
+
available before any account is linked. Its page and API are restricted to
|
|
425
|
+
loopback access, and API responses do not include tokens or session data.
|
|
426
|
+
|
|
427
|
+
Use the language selector at the top of the page to switch between Chinese and
|
|
428
|
+
English. The choice is remembered in this browser; without a saved preference,
|
|
429
|
+
the page follows the browser language. Switching languages keeps ongoing login
|
|
430
|
+
and account operations running.
|
|
431
|
+
|
|
432
|
+
Automatic account switching after an upstream HTTP `429` is off by default.
|
|
433
|
+
When enabled, a request can fail over only before any response has been sent,
|
|
434
|
+
and only to accounts with the same region and endpoint. Each account is tried
|
|
435
|
+
at most once per request. The proxy skips a candidate only when the request's
|
|
436
|
+
model is cooling down there; other models on that account remain eligible. A
|
|
437
|
+
missing or invalid model does not create a model cooldown or trigger failover.
|
|
438
|
+
If all tried accounts return `429`, the final status remains `429`, and the
|
|
439
|
+
last upstream response's `Retry-After` header is preserved when present.
|
|
440
|
+
Cooldowns are tracked per account and model, using upstream `Retry-After` or a
|
|
441
|
+
default 60 seconds when that value is missing or invalid. The setting and model
|
|
442
|
+
cooldowns persist across restarts. Old v1 account-wide cooldowns had no model
|
|
443
|
+
identity and are not carried forward during upgrade. The page shows a separate
|
|
444
|
+
remaining countdown and source for each model, and refreshes account state
|
|
445
|
+
periodically and immediately when a hidden page becomes visible again.
|
|
446
|
+
|
|
447
|
+
The account list also shows each linked account's check-in status for today
|
|
448
|
+
(Beijing time). The **Check in** action is available for every account, including
|
|
449
|
+
the active one; it checks the account first and does nothing when today's check-in
|
|
450
|
+
is already complete. The global automatic check-in setting is off by default and
|
|
451
|
+
applies to all linked accounts without changing the active account. The page saves
|
|
452
|
+
this setting and displays status; the proxy performs automatic checks and check-ins
|
|
453
|
+
in the background, including when the management page is closed. When enabled, the
|
|
454
|
+
proxy checks all linked accounts immediately and on startup. At Beijing midnight it
|
|
455
|
+
checks them, waits a random 0–10 minutes, then checks again before signing; disabling
|
|
456
|
+
it cancels pending scheduled work. Unknown status is never treated as permission to
|
|
457
|
+
sign. The setting persists; after restart, check-in status is confirmed by querying
|
|
458
|
+
the upstream service again.
|
|
459
|
+
|
|
460
|
+
The command-line `--login` flow and `--session-file` option remain available for
|
|
461
|
+
terminal use and importing an existing session.
|
|
396
462
|
|
|
397
463
|
### Listening on all interfaces (LAN sharing)
|
|
398
464
|
|
|
@@ -408,11 +474,20 @@ All endpoints do not require an extra token in the request by default; the proxy
|
|
|
408
474
|
| Method | Path | Purpose |
|
|
409
475
|
| --- | --- | --- |
|
|
410
476
|
| GET | `/health` | Query local service and auth status |
|
|
477
|
+
| GET | `/admin` | Open the local account manager |
|
|
411
478
|
| GET | `/v1/models` | Query the CodeBuddy model list |
|
|
412
479
|
| POST | `/v1/chat/completions` | OpenAI Chat Completions, supports tools and streaming |
|
|
413
480
|
| POST | `/v1/responses` | Responses API, compatible with Codex CLI |
|
|
414
481
|
| POST | `/v1/messages` | Anthropic Messages API, compatible with Claude Code / CC Switch |
|
|
415
482
|
|
|
483
|
+
Account-management endpoints live under `/admin/api` and are restricted to
|
|
484
|
+
loopback clients. Write requests require the `X-Account-Manager: 1` header, and
|
|
485
|
+
cross-origin requests are rejected. `GET /admin/api/accounts` reports active
|
|
486
|
+
account, cooldown, and cached check-in state. `GET /admin/api/accounts/{id}/checkin-status`
|
|
487
|
+
checks that account against the upstream service; `POST /admin/api/accounts/{id}/checkin`
|
|
488
|
+
checks first and signs only when needed. `GET` and `PATCH /admin/api/settings` read
|
|
489
|
+
and save the automatic-switch and automatic-check-in preferences independently.
|
|
490
|
+
|
|
416
491
|
### `/health` - health check
|
|
417
492
|
|
|
418
493
|
```bash
|
|
@@ -1,18 +1,3 @@
|
|
|
1
|
-
Metadata-Version: 2.4
|
|
2
|
-
Name: workbuddy2api
|
|
3
|
-
Version: 2.0.7
|
|
4
|
-
Summary: Local OpenAI/Responses/Anthropic compatible proxy for CodeBuddy
|
|
5
|
-
Requires-Python: >=3.10
|
|
6
|
-
Description-Content-Type: text/markdown
|
|
7
|
-
License-File: LICENSE
|
|
8
|
-
Requires-Dist: fastapi>=0.104.0
|
|
9
|
-
Requires-Dist: uvicorn>=0.24.0
|
|
10
|
-
Requires-Dist: httpx[socks]>=0.25.0
|
|
11
|
-
Requires-Dist: requests>=2.31.0
|
|
12
|
-
Provides-Extra: dev
|
|
13
|
-
Requires-Dist: pytest>=7.4.0; extra == "dev"
|
|
14
|
-
Dynamic: license-file
|
|
15
|
-
|
|
16
1
|
# CodeBuddy API Proxy
|
|
17
2
|
|
|
18
3
|
> A lightweight API proxy service that converts CodeBuddy's underlying interface into standard OpenAI, Anthropic, and Responses protocol formats.
|
|
@@ -30,7 +15,9 @@ For unexplained Windows process exits, use the [independent process monitor](doc
|
|
|
30
15
|
- **DSML parsing** - Automatically detects and converts DeepSeek Markup Language (DSML) tool calls
|
|
31
16
|
- **Streaming responses** - SSE streaming output, returning generated content in real time, with built-in 60-second timeout protection
|
|
32
17
|
- **Domestic and international backends** - Uses domestic CodeBuddy by default and switches to the international CodeBuddy service with `--global`, with isolated sessions and model catalogs
|
|
33
|
-
- **Multi-account management** -
|
|
18
|
+
- **Multi-account management** - Link domestic and Global accounts, switch the active account, and remove non-active accounts from the local admin page
|
|
19
|
+
- **Model-level 429 handling** - Track cooldowns per account and model, with optional same-region failover
|
|
20
|
+
- **Daily check-in** - Check in manually or enable background checks for all linked accounts
|
|
34
21
|
|
|
35
22
|
---
|
|
36
23
|
|
|
@@ -66,12 +53,14 @@ uv sync
|
|
|
66
53
|
uv run python -m codebuddy_proxy --desensitize
|
|
67
54
|
```
|
|
68
55
|
|
|
69
|
-
On first use,
|
|
56
|
+
On first use, start the proxy and open the local account manager:
|
|
70
57
|
|
|
71
58
|
```bash
|
|
72
|
-
uv run python -m codebuddy_proxy --
|
|
59
|
+
uv run python -m codebuddy_proxy --desensitize
|
|
73
60
|
```
|
|
74
61
|
|
|
62
|
+
Then visit `http://127.0.0.1:8787/admin` and link a domestic or Global account.
|
|
63
|
+
|
|
75
64
|
## Quick Start
|
|
76
65
|
|
|
77
66
|
### 1. Start the proxy
|
|
@@ -80,8 +69,8 @@ uv run python -m codebuddy_proxy --login --desensitize
|
|
|
80
69
|
# Use the latest version (recommended)
|
|
81
70
|
uv run --with workbuddy2api python -m codebuddy_proxy --desensitize
|
|
82
71
|
|
|
83
|
-
# First use:
|
|
84
|
-
uv run --with workbuddy2api python -m codebuddy_proxy --
|
|
72
|
+
# First use: start, then link an account at http://127.0.0.1:8787/admin
|
|
73
|
+
uv run --with workbuddy2api python -m codebuddy_proxy --desensitize
|
|
85
74
|
|
|
86
75
|
# International service: first login and start
|
|
87
76
|
uv run --with workbuddy2api python -m codebuddy_proxy --global --login --desensitize
|
|
@@ -97,12 +86,23 @@ Listens on `http://127.0.0.1:8787` by default.
|
|
|
97
86
|
The proxy supports both CodeBuddy regions. Domestic mode remains the default,
|
|
98
87
|
so existing startup commands continue to work unchanged.
|
|
99
88
|
|
|
100
|
-
| Mode | Startup option | Upstream endpoint |
|
|
101
|
-
| --- | --- | --- |
|
|
102
|
-
| Domestic (default) | none | `https://copilot.tencent.com` |
|
|
103
|
-
| International | `--global` | `https://www.codebuddy.ai` |
|
|
89
|
+
| Mode | Startup option | Upstream endpoint |
|
|
90
|
+
| --- | --- | --- |
|
|
91
|
+
| Domestic (default) | none | `https://copilot.tencent.com` |
|
|
92
|
+
| International | `--global` | `https://www.codebuddy.ai` |
|
|
93
|
+
|
|
94
|
+
Linked accounts are stored separately by region in `~/.workbuddy2api/accounts`.
|
|
95
|
+
Use `--accounts-dir DIR` to choose another local directory. With no explicit
|
|
96
|
+
selector, the proxy restores the saved active account. On the first migration,
|
|
97
|
+
matching legacy session files are imported once and kept; deleting an imported
|
|
98
|
+
account does not import it again. Explicit `--global` or `--endpoint` selects a
|
|
99
|
+
matching account, while `--session-file` can import that file again. If there is
|
|
100
|
+
no match, the proxy starts without an active account. `--login` uses a temporary
|
|
101
|
+
session file to add or refresh an account without replacing a legacy file.
|
|
104
102
|
|
|
105
|
-
|
|
103
|
+
The account manager can add accounts for either region while the proxy is
|
|
104
|
+
running. For a terminal-driven login, the existing `--login` option remains
|
|
105
|
+
available:
|
|
106
106
|
|
|
107
107
|
```bash
|
|
108
108
|
# First login
|
|
@@ -118,16 +118,18 @@ If the package is installed as a command, the equivalent short form is
|
|
|
118
118
|
`workbuddy2api --global --login`. When running from source, use
|
|
119
119
|
`uv run python -m codebuddy_proxy --global --login`.
|
|
120
120
|
|
|
121
|
-
`--global`
|
|
122
|
-
OpenCode, and other clients continue to use
|
|
123
|
-
selected profile also controls the model catalog
|
|
121
|
+
`--global` selects the Global backend and a matching account when one exists.
|
|
122
|
+
Codex CLI, Claude Code/CC Switch, OpenCode, and other clients continue to use
|
|
123
|
+
the same local proxy URLs. The selected profile also controls the model catalog
|
|
124
|
+
returned by `/v1/models`.
|
|
124
125
|
|
|
125
|
-
Domestic and international
|
|
126
|
-
`--session-file`
|
|
127
|
-
|
|
128
|
-
|
|
126
|
+
Domestic and international accounts remain isolated. An explicit
|
|
127
|
+
`--session-file` is imported only when its saved backend and endpoint match the
|
|
128
|
+
current startup options. The proxy refuses mismatched credentials and does not
|
|
129
|
+
modify the original file.
|
|
129
130
|
|
|
130
|
-
For a custom international endpoint,
|
|
131
|
+
For a custom international endpoint, use a dedicated session file when
|
|
132
|
+
importing or creating a login from the command line:
|
|
131
133
|
|
|
132
134
|
```bash
|
|
133
135
|
uv run --with workbuddy2api python -m codebuddy_proxy \
|
|
@@ -142,20 +144,23 @@ Endpoint precedence is: explicit `--endpoint` > the `--global` profile default
|
|
|
142
144
|
Therefore `--global` without `--endpoint` cannot be redirected to the domestic
|
|
143
145
|
host by `CODEBUDDY_ENDPOINT`.
|
|
144
146
|
|
|
145
|
-
###
|
|
147
|
+
### Built-in CodeBuddy gateways: developer-role compatibility
|
|
146
148
|
|
|
147
|
-
The domestic
|
|
148
|
-
Chat Completions
|
|
149
|
-
|
|
150
|
-
`developer` to `system`
|
|
151
|
-
|
|
152
|
-
|
|
149
|
+
The built-in domestic (`https://copilot.tencent.com`) and international
|
|
150
|
+
(`https://www.codebuddy.ai`) Chat Completions gateways may reject requests
|
|
151
|
+
containing a `developer` message with HTTP 400 / code 11128. Before forwarding
|
|
152
|
+
to either matching backend and host, the proxy maps `developer` to `system`
|
|
153
|
+
without changing message order, content, tool-call history, or the original
|
|
154
|
+
client request. If enabled, `--desensitize` runs after this role adaptation.
|
|
155
|
+
No client-side configuration is needed.
|
|
153
156
|
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
not
|
|
158
|
-
|
|
157
|
+
The mapping is scoped to these exact backend/host pairs; endpoints using
|
|
158
|
+
other host names keep their original roles. International `X-Conversation-*` headers
|
|
159
|
+
are still generated after request-body transformations. Because the upstreams
|
|
160
|
+
do not represent the separate `system` and `developer` instruction priorities,
|
|
161
|
+
the mapping is an approximation, not exact semantic equivalence. The
|
|
162
|
+
`upstream_role_compat` log event reports the backend and number of mapped
|
|
163
|
+
messages, not prompt contents.
|
|
159
164
|
|
|
160
165
|
Runtime model catalogs are loaded from the packaged profile resources
|
|
161
166
|
`src/codebuddy_proxy/models_config.domestic.json` and
|
|
@@ -324,6 +329,7 @@ Select the model inside OMP with `/model codebuddy/hy3` (or set it as the defaul
|
|
|
324
329
|
--global Use the international CodeBuddy backend (default domestic)
|
|
325
330
|
--endpoint ENDPOINT CodeBuddy backend address (overrides the profile default)
|
|
326
331
|
--session-file PATH Session file path (isolated by profile by default)
|
|
332
|
+
--accounts-dir DIR Account library directory (default ~/.workbuddy2api/accounts)
|
|
327
333
|
--log-file PATH JSONL log file (default ~/.workbuddy2api/codebuddy-proxy.jsonl)
|
|
328
334
|
--desensitize Enable desensitization (recommended)
|
|
329
335
|
--optimize-context Enable message compression (recommended for Codex CLI)
|
|
@@ -384,15 +390,58 @@ uv run --with workbuddy2api python -m codebuddy_proxy --desensitize --optimize-c
|
|
|
384
390
|
|
|
385
391
|
### Multi-account switching
|
|
386
392
|
|
|
387
|
-
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
393
|
+
Start the proxy and open [http://127.0.0.1:8787/admin](http://127.0.0.1:8787/admin).
|
|
394
|
+
Choose **Domestic** or **Global**, then link the account in the browser window.
|
|
395
|
+
The first linked account becomes active automatically; linking another account
|
|
396
|
+
does not change the account currently in use. Use **Set active** to switch, or
|
|
397
|
+
remove a non-active account from the same page. The selection is saved for the
|
|
398
|
+
next proxy start. Switching affects new requests; requests already in progress
|
|
399
|
+
continue with the account selected when they began.
|
|
400
|
+
|
|
401
|
+

|
|
402
|
+
|
|
403
|
+
The screenshot uses synthetic demo accounts. Account UIDs are covered, and no
|
|
404
|
+
credentials or session contents are shown. Accounts are kept separately by
|
|
405
|
+
backend, normalized endpoint, and user ID in `~/.workbuddy2api/accounts`; use
|
|
406
|
+
`--accounts-dir DIR` to choose another local directory. The manager remains
|
|
407
|
+
available before any account is linked. Its page and API are restricted to
|
|
408
|
+
loopback access, and API responses do not include tokens or session data.
|
|
409
|
+
|
|
410
|
+
Use the language selector at the top of the page to switch between Chinese and
|
|
411
|
+
English. The choice is remembered in this browser; without a saved preference,
|
|
412
|
+
the page follows the browser language. Switching languages keeps ongoing login
|
|
413
|
+
and account operations running.
|
|
414
|
+
|
|
415
|
+
Automatic account switching after an upstream HTTP `429` is off by default.
|
|
416
|
+
When enabled, a request can fail over only before any response has been sent,
|
|
417
|
+
and only to accounts with the same region and endpoint. Each account is tried
|
|
418
|
+
at most once per request. The proxy skips a candidate only when the request's
|
|
419
|
+
model is cooling down there; other models on that account remain eligible. A
|
|
420
|
+
missing or invalid model does not create a model cooldown or trigger failover.
|
|
421
|
+
If all tried accounts return `429`, the final status remains `429`, and the
|
|
422
|
+
last upstream response's `Retry-After` header is preserved when present.
|
|
423
|
+
Cooldowns are tracked per account and model, using upstream `Retry-After` or a
|
|
424
|
+
default 60 seconds when that value is missing or invalid. The setting and model
|
|
425
|
+
cooldowns persist across restarts. Old v1 account-wide cooldowns had no model
|
|
426
|
+
identity and are not carried forward during upgrade. The page shows a separate
|
|
427
|
+
remaining countdown and source for each model, and refreshes account state
|
|
428
|
+
periodically and immediately when a hidden page becomes visible again.
|
|
429
|
+
|
|
430
|
+
The account list also shows each linked account's check-in status for today
|
|
431
|
+
(Beijing time). The **Check in** action is available for every account, including
|
|
432
|
+
the active one; it checks the account first and does nothing when today's check-in
|
|
433
|
+
is already complete. The global automatic check-in setting is off by default and
|
|
434
|
+
applies to all linked accounts without changing the active account. The page saves
|
|
435
|
+
this setting and displays status; the proxy performs automatic checks and check-ins
|
|
436
|
+
in the background, including when the management page is closed. When enabled, the
|
|
437
|
+
proxy checks all linked accounts immediately and on startup. At Beijing midnight it
|
|
438
|
+
checks them, waits a random 0–10 minutes, then checks again before signing; disabling
|
|
439
|
+
it cancels pending scheduled work. Unknown status is never treated as permission to
|
|
440
|
+
sign. The setting persists; after restart, check-in status is confirmed by querying
|
|
441
|
+
the upstream service again.
|
|
442
|
+
|
|
443
|
+
The command-line `--login` flow and `--session-file` option remain available for
|
|
444
|
+
terminal use and importing an existing session.
|
|
396
445
|
|
|
397
446
|
### Listening on all interfaces (LAN sharing)
|
|
398
447
|
|
|
@@ -408,11 +457,20 @@ All endpoints do not require an extra token in the request by default; the proxy
|
|
|
408
457
|
| Method | Path | Purpose |
|
|
409
458
|
| --- | --- | --- |
|
|
410
459
|
| GET | `/health` | Query local service and auth status |
|
|
460
|
+
| GET | `/admin` | Open the local account manager |
|
|
411
461
|
| GET | `/v1/models` | Query the CodeBuddy model list |
|
|
412
462
|
| POST | `/v1/chat/completions` | OpenAI Chat Completions, supports tools and streaming |
|
|
413
463
|
| POST | `/v1/responses` | Responses API, compatible with Codex CLI |
|
|
414
464
|
| POST | `/v1/messages` | Anthropic Messages API, compatible with Claude Code / CC Switch |
|
|
415
465
|
|
|
466
|
+
Account-management endpoints live under `/admin/api` and are restricted to
|
|
467
|
+
loopback clients. Write requests require the `X-Account-Manager: 1` header, and
|
|
468
|
+
cross-origin requests are rejected. `GET /admin/api/accounts` reports active
|
|
469
|
+
account, cooldown, and cached check-in state. `GET /admin/api/accounts/{id}/checkin-status`
|
|
470
|
+
checks that account against the upstream service; `POST /admin/api/accounts/{id}/checkin`
|
|
471
|
+
checks first and signs only when needed. `GET` and `PATCH /admin/api/settings` read
|
|
472
|
+
and save the automatic-switch and automatic-check-in preferences independently.
|
|
473
|
+
|
|
416
474
|
### `/health` - health check
|
|
417
475
|
|
|
418
476
|
```bash
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
[project]
|
|
2
2
|
name = "workbuddy2api"
|
|
3
|
-
version = "2.0.
|
|
3
|
+
version = "2.0.8.dev1"
|
|
4
4
|
description = "Local OpenAI/Responses/Anthropic compatible proxy for CodeBuddy"
|
|
5
5
|
readme = "README.md"
|
|
6
6
|
requires-python = ">=3.10"
|
|
@@ -9,6 +9,8 @@ dependencies = [
|
|
|
9
9
|
"uvicorn>=0.24.0",
|
|
10
10
|
"httpx[socks]>=0.25.0",
|
|
11
11
|
"requests>=2.31.0",
|
|
12
|
+
"buddy-agent-auth>=0.1.0.dev1,<0.2",
|
|
13
|
+
"buddy-agent-checkin[workbuddy]>=0.1.1.dev2,<0.2",
|
|
12
14
|
]
|
|
13
15
|
|
|
14
16
|
[project.optional-dependencies]
|
|
@@ -27,9 +29,9 @@ build-backend = "setuptools.build_meta"
|
|
|
27
29
|
where = ["src"]
|
|
28
30
|
|
|
29
31
|
[tool.setuptools.package-data]
|
|
30
|
-
codebuddy_proxy = ["models_config.*.json"]
|
|
32
|
+
codebuddy_proxy = ["models_config.*.json", "admin.html"]
|
|
31
33
|
|
|
32
34
|
[dependency-groups]
|
|
33
35
|
dev = [
|
|
34
36
|
"pytest>=7.4.0",
|
|
35
|
-
]
|
|
37
|
+
]
|