dsv4-cc-proxy 1.8.0__tar.gz

dsv4_cc_proxy-1.8.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsv4-cc-proxy contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dsv4_cc_proxy-1.8.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include README.zh-CN.md
+include LICENSE
+recursive-include scripts *

dsv4_cc_proxy-1.8.0/PKG-INFO

@@ -0,0 +1,273 @@
+Metadata-Version: 2.4
+Name: dsv4-cc-proxy
+Version: 1.8.0
+Summary: DeepSeek Anthropic API 兼容性代理 — 让 Claude Code 在 DeepSeek V4 模型上稳定运行
+Author: HosheaLi
+License: MIT License
+        
+        Copyright (c) 2026 dsv4-cc-proxy contributors
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/HosheaLi/P14_dsv4ToCC
+Project-URL: Source, https://github.com/HosheaLi/P14_dsv4ToCC
+Project-URL: Documentation, https://hosheali.github.io/P14_dsv4ToCC
+Keywords: deepseek,claude,proxy,anthropic,api
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: Proxy Servers
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: starlette>=0.37.0
+Requires-Dist: uvicorn>=0.29.0
+Provides-Extra: test
+Requires-Dist: pytest>=8.0; extra == "test"
+Requires-Dist: ruff>=0.4.0; extra == "test"
+Dynamic: license-file
+
+<div align="center">
+
+[**中文版 README**](README.zh-CN.md)
+
+# dsv4-cc-proxy
+
+**Make DeepSeek V4 work flawlessly with Claude Code**
+
+Anthropic API compatibility proxy that fixes 3 DeepSeek V4 incompatibilities.
+
+```
+Claude Code ←→ localhost:16889 (dsv4-cc-proxy) ←→ api.deepseek.com/anthropic
+```
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org)
+[![CI](https://github.com/HosheaLi/dsv4-cc-proxy/actions/workflows/ci.yml/badge.svg)](https://github.com/HosheaLi/dsv4-cc-proxy/actions)
+[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey)]()
+[![Docker Pulls](https://img.shields.io/docker/pulls/hosheali/dsv4-cc-proxy)](https://hub.docker.com/r/hosheali/dsv4-cc-proxy)
+
+</div>
+
+---
+
+## Why dsv4-cc-proxy
+
+DeepSeek V4 implements the Anthropic API format, but has 3 critical incompatibilities that break Claude Code. This proxy fixes them transparently.
+
+| # | Problem | Symptom | Fix |
+|---|---------|---------|-----|
+| 1 | `tool_use` assistant messages missing a `thinking` block | `reasoning_content` 400 error | Inject empty thinking block before each tool_use |
+| 2 | DeepSeek unconditionally emits `thinking`/`signature_delta` SSE events even when thinking is disabled | `Tool result missing due to internal error` in Claude Code | Strip thinking events from the SSE response stream |
+| 3 | `thinking.type=adaptive` (Claude Code default) + `reasoning_effort` not supported by DeepSeek | Stream truncation / 400 errors | Normalize to `disabled` + strip reasoning_effort |
+
+Non-DeepSeek requests and non-`/messages` endpoints pass through with zero overhead.
+
+## Quick Start
+
+### Option 1: pip install (recommended)
+
+```bash
+pip install dsv4-cc-proxy
+
+# Start the proxy (default port 16889)
+dsv4-cc-proxy
+
+# Stop the proxy
+dsv4-cc-proxy --stop
+```
+
+### Option 2: pipx (isolated environment)
+
+```bash
+pipx install dsv4-cc-proxy
+dsv4-cc-proxy
+```
+
+### Option 3: Docker
+
+```bash
+docker run -d -p 16889:16889 --name dsv4-cc-proxy hosheali/dsv4-cc-proxy:latest
+```
+
+Or via docker compose:
+
+```bash
+docker compose up -d
+```
+
+### Configuration
+
+Point Claude Code to the proxy by adding to your `settings.local.json`:
+
+```json
+"ANTHROPIC_BASE_URL": "http://localhost:16889"
+```
+
+## Configuration
+
+| Env Var | Default | Description |
+|---------|---------|-------------|
+| `PROXY_UPSTREAM` | `https://api.deepseek.com/anthropic` | DeepSeek API base URL |
+| `PROXY_HOST` | `127.0.0.1` | Bind address |
+| `PROXY_PORT` | `16889` | Bind port |
+| `PROXY_LOG_LEVEL` | `warning` | Log level (`info` for debugging) |
+| `PROXY_DUMP_DIR` | *(empty=off)* | Debug traffic dump directory. ⚠ Contains conversation data |
+
+## Comparison
+
+| Scenario | Without Proxy | With Proxy |
+|----------|--------------|------------|
+| tool_use msg without thinking | 400 error | Auto-injected empty thinking |
+| Claude Code sends `thinking.type=adaptive` | Stream truncation / 400 | Normalized to `disabled` |
+| DeepSeek SSE thinking events | Tool result missing error | Silently stripped from stream |
+| Non-messages endpoints | — | Zero-overhead passthrough |
+| Non-DeepSeek models | — | Zero-overhead passthrough |
+
+## Platform Guides
+
+### macOS (launchd auto-start)
+
+```bash
+# Copy and edit paths in the plist file first!
+cp scripts/com.deepseek.thinking-proxy.plist ~/Library/LaunchAgents/
+launchctl load ~/Library/LaunchAgents/com.deepseek.thinking-proxy.plist
+```
+
+**Note:** Edit the plist file to update paths like `/Users/yourname/.claude/proxy/` to match your setup.
+
+### Windows (Scheduled Task)
+
+```batch
+:: One-time setup (auto-start at logon, restart on crash)
+scripts\install_windows_service.ps1 -Install
+
+:: Start manually in terminal
+scripts\start.bat
+
+:: Or with PowerShell
+scripts\start.ps1
+```
+
+### Linux (systemd)
+
+Create `/etc/systemd/system/dsv4-cc-proxy.service`:
+
+```ini
+[Unit]
+Description=dsv4-cc-proxy — DeepSeek Anthropic API proxy
+After=network.target
+
+[Service]
+Type=simple
+User=your-user
+WorkingDirectory=/path/to/dsv4-cc-proxy
+ExecStart=/path/to/.venv/bin/python3 proxy/deepseek-thinking-proxy.py
+Restart=on-failure
+RestartSec=5
+
+[Install]
+WantedBy=multi-user.target
+```
+
+```bash
+sudo systemctl daemon-reload
+sudo systemctl enable --now dsv4-cc-proxy
+```
+
+## Docker (manual build)
+
+```bash
+docker build -t dsv4-cc-proxy .
+docker run -d -p 16889:16889 --name dsv4-cc-proxy dsv4-cc-proxy
+```
+
+## How It Works
+
+```
+┌─────────────┐     ┌──────────────────┐     ┌────────────────────┐
+│ Claude Code │ ──→ │  dsv4-cc-proxy   │ ──→ │  api.deepseek.com  │
+│             │     │  localhost:16889  │     │  /anthropic        │
+└─────────────┘     └──────────────────┘     └────────────────────┘
+                           │
+                   ┌───────┴────────┐
+                   │  Fixes applied  │
+                   │  1. Thinking     │
+                   │     injection   │
+                   │  2. Thinking     │
+                   │     normalize   │
+                   │  3. SSE events   │
+                   │     strip       │
+                   └────────────────┘
+```
+
+The proxy intercepts `POST /v1/messages` and applies three fixes for `deepseek-v4*` models. All other requests pass through transparently.
+
+## Testing
+
+```bash
+pip install dsv4-cc-proxy[test]
+pytest tests/ -v
+```
+
+### Health Check
+
+```bash
+curl http://localhost:16889/health
+# → {"status":"ok","version":"1.8.0","upstream":"https://api.deepseek.com/anthropic"}
+```
+
+## Project Structure
+
+```
+.
+├── dsv4_cc_proxy/
+│   ├── __init__.py                  # Package entry, exports VERSION + create_app
+│   ├── __main__.py                  # CLI entry — dsv4-cc-proxy command
+│   ├── _version.py                  # VERSION = "1.8.0" (single source of truth)
+│   └── proxy.py                     # Core proxy logic (factory pattern)
+├── tests/
+│   └── test_proxy.py                # 22 unit tests
+├── scripts/
+│   ├── start.bat                    # Windows batch startup
+│   ├── start.ps1                    # PowerShell startup
+│   ├── install_windows_service.ps1  # Windows Task Scheduler setup
+│   └── com.deepseek.thinking-proxy.plist  # macOS launchd (optional)
+├── Dockerfile                       # Docker multi-stage build
+├── docker-compose.yml               # Docker Compose
+├── pyproject.toml                   # Build config, entry point
+├── MANIFEST.in                      # Package extras
+├── .github/workflows/ci.yml         # GitHub Actions CI
+├── LICENSE                          # MIT License
+└── CONTRIBUTING.md                  # Contributor guidelines
+```
+
+## Contributing
+
+Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+[MIT](LICENSE)

dsv4_cc_proxy-1.8.0/README.md

@@ -0,0 +1,222 @@
+<div align="center">
+
+[**中文版 README**](README.zh-CN.md)
+
+# dsv4-cc-proxy
+
+**Make DeepSeek V4 work flawlessly with Claude Code**
+
+Anthropic API compatibility proxy that fixes 3 DeepSeek V4 incompatibilities.
+
+```
+Claude Code ←→ localhost:16889 (dsv4-cc-proxy) ←→ api.deepseek.com/anthropic
+```
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org)
+[![CI](https://github.com/HosheaLi/dsv4-cc-proxy/actions/workflows/ci.yml/badge.svg)](https://github.com/HosheaLi/dsv4-cc-proxy/actions)
+[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey)]()
+[![Docker Pulls](https://img.shields.io/docker/pulls/hosheali/dsv4-cc-proxy)](https://hub.docker.com/r/hosheali/dsv4-cc-proxy)
+
+</div>
+
+---
+
+## Why dsv4-cc-proxy
+
+DeepSeek V4 implements the Anthropic API format, but has 3 critical incompatibilities that break Claude Code. This proxy fixes them transparently.
+
+| # | Problem | Symptom | Fix |
+|---|---------|---------|-----|
+| 1 | `tool_use` assistant messages missing a `thinking` block | `reasoning_content` 400 error | Inject empty thinking block before each tool_use |
+| 2 | DeepSeek unconditionally emits `thinking`/`signature_delta` SSE events even when thinking is disabled | `Tool result missing due to internal error` in Claude Code | Strip thinking events from the SSE response stream |
+| 3 | `thinking.type=adaptive` (Claude Code default) + `reasoning_effort` not supported by DeepSeek | Stream truncation / 400 errors | Normalize to `disabled` + strip reasoning_effort |
+
+Non-DeepSeek requests and non-`/messages` endpoints pass through with zero overhead.
+
+## Quick Start
+
+### Option 1: pip install (recommended)
+
+```bash
+pip install dsv4-cc-proxy
+
+# Start the proxy (default port 16889)
+dsv4-cc-proxy
+
+# Stop the proxy
+dsv4-cc-proxy --stop
+```
+
+### Option 2: pipx (isolated environment)
+
+```bash
+pipx install dsv4-cc-proxy
+dsv4-cc-proxy
+```
+
+### Option 3: Docker
+
+```bash
+docker run -d -p 16889:16889 --name dsv4-cc-proxy hosheali/dsv4-cc-proxy:latest
+```
+
+Or via docker compose:
+
+```bash
+docker compose up -d
+```
+
+### Configuration
+
+Point Claude Code to the proxy by adding to your `settings.local.json`:
+
+```json
+"ANTHROPIC_BASE_URL": "http://localhost:16889"
+```
+
+## Configuration
+
+| Env Var | Default | Description |
+|---------|---------|-------------|
+| `PROXY_UPSTREAM` | `https://api.deepseek.com/anthropic` | DeepSeek API base URL |
+| `PROXY_HOST` | `127.0.0.1` | Bind address |
+| `PROXY_PORT` | `16889` | Bind port |
+| `PROXY_LOG_LEVEL` | `warning` | Log level (`info` for debugging) |
+| `PROXY_DUMP_DIR` | *(empty=off)* | Debug traffic dump directory. ⚠ Contains conversation data |
+
+## Comparison
+
+| Scenario | Without Proxy | With Proxy |
+|----------|--------------|------------|
+| tool_use msg without thinking | 400 error | Auto-injected empty thinking |
+| Claude Code sends `thinking.type=adaptive` | Stream truncation / 400 | Normalized to `disabled` |
+| DeepSeek SSE thinking events | Tool result missing error | Silently stripped from stream |
+| Non-messages endpoints | — | Zero-overhead passthrough |
+| Non-DeepSeek models | — | Zero-overhead passthrough |
+
+## Platform Guides
+
+### macOS (launchd auto-start)
+
+```bash
+# Copy and edit paths in the plist file first!
+cp scripts/com.deepseek.thinking-proxy.plist ~/Library/LaunchAgents/
+launchctl load ~/Library/LaunchAgents/com.deepseek.thinking-proxy.plist
+```
+
+**Note:** Edit the plist file to update paths like `/Users/yourname/.claude/proxy/` to match your setup.
+
+### Windows (Scheduled Task)
+
+```batch
+:: One-time setup (auto-start at logon, restart on crash)
+scripts\install_windows_service.ps1 -Install
+
+:: Start manually in terminal
+scripts\start.bat
+
+:: Or with PowerShell
+scripts\start.ps1
+```
+
+### Linux (systemd)
+
+Create `/etc/systemd/system/dsv4-cc-proxy.service`:
+
+```ini
+[Unit]
+Description=dsv4-cc-proxy — DeepSeek Anthropic API proxy
+After=network.target
+
+[Service]
+Type=simple
+User=your-user
+WorkingDirectory=/path/to/dsv4-cc-proxy
+ExecStart=/path/to/.venv/bin/python3 proxy/deepseek-thinking-proxy.py
+Restart=on-failure
+RestartSec=5
+
+[Install]
+WantedBy=multi-user.target
+```
+
+```bash
+sudo systemctl daemon-reload
+sudo systemctl enable --now dsv4-cc-proxy
+```
+
+## Docker (manual build)
+
+```bash
+docker build -t dsv4-cc-proxy .
+docker run -d -p 16889:16889 --name dsv4-cc-proxy dsv4-cc-proxy
+```
+
+## How It Works
+
+```
+┌─────────────┐     ┌──────────────────┐     ┌────────────────────┐
+│ Claude Code │ ──→ │  dsv4-cc-proxy   │ ──→ │  api.deepseek.com  │
+│             │     │  localhost:16889  │     │  /anthropic        │
+└─────────────┘     └──────────────────┘     └────────────────────┘
+                           │
+                   ┌───────┴────────┐
+                   │  Fixes applied  │
+                   │  1. Thinking     │
+                   │     injection   │
+                   │  2. Thinking     │
+                   │     normalize   │
+                   │  3. SSE events   │
+                   │     strip       │
+                   └────────────────┘
+```
+
+The proxy intercepts `POST /v1/messages` and applies three fixes for `deepseek-v4*` models. All other requests pass through transparently.
+
+## Testing
+
+```bash
+pip install dsv4-cc-proxy[test]
+pytest tests/ -v
+```
+
+### Health Check
+
+```bash
+curl http://localhost:16889/health
+# → {"status":"ok","version":"1.8.0","upstream":"https://api.deepseek.com/anthropic"}
+```
+
+## Project Structure
+
+```
+.
+├── dsv4_cc_proxy/
+│   ├── __init__.py                  # Package entry, exports VERSION + create_app
+│   ├── __main__.py                  # CLI entry — dsv4-cc-proxy command
+│   ├── _version.py                  # VERSION = "1.8.0" (single source of truth)
+│   └── proxy.py                     # Core proxy logic (factory pattern)
+├── tests/
+│   └── test_proxy.py                # 22 unit tests
+├── scripts/
+│   ├── start.bat                    # Windows batch startup
+│   ├── start.ps1                    # PowerShell startup
+│   ├── install_windows_service.ps1  # Windows Task Scheduler setup
+│   └── com.deepseek.thinking-proxy.plist  # macOS launchd (optional)
+├── Dockerfile                       # Docker multi-stage build
+├── docker-compose.yml               # Docker Compose
+├── pyproject.toml                   # Build config, entry point
+├── MANIFEST.in                      # Package extras
+├── .github/workflows/ci.yml         # GitHub Actions CI
+├── LICENSE                          # MIT License
+└── CONTRIBUTING.md                  # Contributor guidelines
+```
+
+## Contributing
+
+Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+[MIT](LICENSE)