feat: add Anthropic format compatibility and mock models terminal logging

- Add use_anthropic config option for Anthropic protocol compatibility
- Fix null values in JSON Schema (required, enum, items, properties, etc.)
- Convert Anthropic input_schema to OpenAI parameters format
- Add terminal logging for mock models requests
- Bump version to 0.8.4

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: systemime

Makefile

@@ -3,7 +3,7 @@
 # Variables
 APP_NAME := mask-ctl
 SERVICE_BINARY := coding-plan-mask
-VERSION := 0.8.3
+VERSION := 0.8.4
 BUILD_DIR := build
 BIN_DIR := $(BUILD_DIR)/bin
 CMD_DIR := cmd/coding-plan-mask

README.md

@@ -6,7 +6,7 @@
 
 [![Go Version](https://img.shields.io/badge/Go-1.21+-00ADD8?style=flat&logo=go)](https://golang.org/)
 [![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-0.8.3-green.svg)](https://github.com/systemime/coding-plan-mask)
+[![Version](https://img.shields.io/badge/version-0.8.4-green.svg)](https://github.com/systemime/coding-plan-mask)
 
 *Use your Coding Plan subscription with ANY OpenAI-compatible coding tool*
 
@@ -71,22 +71,22 @@ Download the binary for your platform from [GitHub Releases](https://github.com/
 
 ```bash
 # Linux amd64
-wget https://github.com/systemime/coding-plan-mask/releases/download/v0.8.3/mask-ctl-linux-amd64
+wget https://github.com/systemime/coding-plan-mask/releases/download/v0.8.4/mask-ctl-linux-amd64
 chmod +x mask-ctl-linux-amd64
 sudo mv mask-ctl-linux-amd64 /usr/local/bin/mask-ctl
 
 # Linux arm64
-wget https://github.com/systemime/coding-plan-mask/releases/download/v0.8.3/mask-ctl-linux-arm64
+wget https://github.com/systemime/coding-plan-mask/releases/download/v0.8.4/mask-ctl-linux-arm64
 chmod +x mask-ctl-linux-arm64
 sudo mv mask-ctl-linux-arm64 /usr/local/bin/mask-ctl
 
 # macOS (Darwin amd64)
-wget https://github.com/systemime/coding-plan-mask/releases/download/v0.8.3/mask-ctl-darwin-amd64
+wget https://github.com/systemime/coding-plan-mask/releases/download/v0.8.4/mask-ctl-darwin-amd64
 chmod +x mask-ctl-darwin-amd64
 sudo mv mask-ctl-darwin-amd64 /usr/local/bin/mask-ctl
 
 # macOS (Darwin arm64)
-wget https://github.com/systemime/coding-plan-mask/releases/download/v0.8.3/mask-ctl-darwin-arm64
+wget https://github.com/systemime/coding-plan-mask/releases/download/v0.8.4/mask-ctl-darwin-arm64
 chmod +x mask-ctl-darwin-arm64
 sudo mv mask-ctl-darwin-arm64 /usr/local/bin/mask-ctl
 
@@ -157,6 +157,10 @@ remove_version_path = false
 mock_models = false
 # Mock /models response content (JSON string)
 mock_models_resp = '{"object":"list","data":[{"id":"gpt-4","object":"model","owned_by":"organization"}]}'
+# Anthropic format compatibility mode (default: false)
+# When enabled, fixes null values in JSON Schema (required, enum, items, etc.)
+# Useful for API providers using Anthropic native protocol
+use_anthropic = false
 ```
 
 #### 4. Start
@@ -274,6 +278,7 @@ You can also configure via environment variables:
 | `REMOVE_VERSION_PATH` | Remove version prefix (e.g., `/v1`) from request path when forwarding (true/false) |
 | `MOCK_MODELS` | Enable mock /models endpoint response (true/false) |
 | `MOCK_MODELS_RESP` | Mock /models response content (JSON string) |
+| `USE_ANTHROPIC` | Enable Anthropic format compatibility mode (true/false) |
 
 ### ⚠️ Risk Warning
 
@@ -337,22 +342,22 @@ This project is provided for **educational and research purposes only**.
 
 ```bash
 # Linux amd64
-wget https://github.com/systemime/coding-plan-mask/releases/download/v0.8.3/mask-ctl-linux-amd64
+wget https://github.com/systemime/coding-plan-mask/releases/download/v0.8.4/mask-ctl-linux-amd64
 chmod +x mask-ctl-linux-amd64
 sudo mv mask-ctl-linux-amd64 /usr/local/bin/mask-ctl
 
 # Linux arm64
-wget https://github.com/systemime/coding-plan-mask/releases/download/v0.8.3/mask-ctl-linux-arm64
+wget https://github.com/systemime/coding-plan-mask/releases/download/v0.8.4/mask-ctl-linux-arm64
 chmod +x mask-ctl-linux-arm64
 sudo mv mask-ctl-linux-arm64 /usr/local/bin/mask-ctl
 
 # macOS amd64
-wget https://github.com/systemime/coding-plan-mask/releases/download/v0.8.3/mask-ctl-darwin-amd64
+wget https://github.com/systemime/coding-plan-mask/releases/download/v0.8.4/mask-ctl-darwin-amd64
 chmod +x mask-ctl-darwin-amd64
 sudo mv mask-ctl-darwin-amd64 /usr/local/bin/mask-ctl
 
 # macOS arm64
-wget https://github.com/systemime/coding-plan-mask/releases/download/v0.8.3/mask-ctl-darwin-arm64
+wget https://github.com/systemime/coding-plan-mask/releases/download/v0.8.4/mask-ctl-darwin-arm64
 chmod +x mask-ctl-darwin-arm64
 sudo mv mask-ctl-darwin-arm64 /usr/local/bin/mask-ctl
 ```
@@ -419,6 +424,10 @@ remove_version_path = false
 mock_models = false
 # 模拟 /models 响应内容 (JSON 字符串)
 mock_models_resp = '{"object":"list","data":[{"id":"gpt-4","object":"model","owned_by":"organization"}]}'
+# Anthropic 格式兼容模式 (默认: false)
+# 启用后会修复请求体中的 schema 字段，将 null 转为正确的默认值
+# 适用于使用 Anthropic 原生协议的 API 供应商
+use_anthropic = false
 ```
 
 #### 4. 启动
@@ -518,6 +527,7 @@ curl http://127.0.0.1:8787/stats
 | `REMOVE_VERSION_PATH` | 转发时移除请求路径中的版本前缀（如 `/v1`）(true/false) |
 | `MOCK_MODELS` | 启用模拟 /models 端点响应 (true/false) |
 | `MOCK_MODELS_RESP` | 模拟 /models 响应内容 (JSON 字符串) |
+| `USE_ANTHROPIC` | 启用 Anthropic 格式兼容模式 (true/false) |
 
 ### ⚠️ 风险预警
 

deploy/config.example.toml

@@ -66,6 +66,10 @@ coding_url = ""
 auth_header = ""
 # 认证前缀 (留空使用默认 "Bearer ")
 auth_prefix = ""
+# Anthropic 格式兼容模式 (默认 false)
+# 启用后会修复请求体中的 schema 字段，将 null 转为正确的默认值
+# 适用于使用 Anthropic 原生协议的 API 供应商
+use_anthropic = false
 
 # ============================================================================
 # 服务商默认 URL 参考

internal/config/config.go

@@ -77,6 +77,9 @@ type APIConfig struct {
 	MockModels bool `toml:"mock_models"`
 	// 模拟 /models 响应内容 (JSON 字符串)
 	MockModelsResp string `toml:"mock_models_resp"`
+	// Anthropic 格式兼容模式
+	// 启用后会修复请求体中的 schema 字段，将 null 转为正确的默认值
+	UseAnthropic bool `toml:"use_anthropic"`
 }
 
 // Config 应用配置（运行时使用）
@@ -107,6 +110,7 @@ type Config struct {
 	RemoveVersionPath bool
 	MockModels        bool
 	MockModelsResp    string
+	UseAnthropic      bool // Anthropic 格式兼容模式
 
 	configPath string
 }
@@ -305,6 +309,7 @@ func LoadConfig(path string) (*Config, error) {
 	cfg.CustomAuthPrefix = cfgFile.API.AuthPrefix
 	cfg.RemoveVersionPath = cfgFile.API.RemoveVersionPath
 	cfg.MockModels = cfgFile.API.MockModels
+	cfg.UseAnthropic = cfgFile.API.UseAnthropic
 	if cfgFile.API.MockModelsResp != "" {
 		cfg.MockModelsResp = cfgFile.API.MockModelsResp
 	}
@@ -362,6 +367,9 @@ func (c *Config) loadFromEnv() {
 	if v := os.Getenv("MOCK_MODELS_RESP"); v != "" {
 		c.MockModelsResp = v
 	}
+	if v := os.Getenv("USE_ANTHROPIC"); strings.ToLower(v) == "true" {
+		c.UseAnthropic = true
+	}
 }
 
 // Set 设置配置项
@@ -412,6 +420,8 @@ func (c *Config) Set(key string, value string) error {
 		c.MockModels = strings.ToLower(value) == "true"
 	case "mock_models_resp":
 		c.MockModelsResp = value
+	case "use_anthropic":
+		c.UseAnthropic = strings.ToLower(value) == "true"
 	default:
 		return fmt.Errorf("未知配置项: %s", key)
 	}
@@ -530,6 +540,7 @@ func (c *Config) GetSafe() map[string]interface{} {
 		"remove_version_path":    c.RemoveVersionPath,
 		"mock_models":            c.MockModels,
 		"mock_models_resp":       c.MockModelsResp,
+		"use_anthropic":          c.UseAnthropic,
 	}
 }
 
@@ -639,6 +650,10 @@ remove_version_path = false
 mock_models = false
 # 模拟 /models 响应内容 (JSON 字符串)
 mock_models_resp = '{"object":"list","data":[{"id":"gpt-4","object":"model","owned_by":"organization"}]}'
+# Anthropic 格式兼容模式 (默认 false)
+# 启用后会修复请求体中的 schema 字段，将 null 转为正确的默认值
+# 适用于使用 Anthropic 原生协议的 API 供应商
+use_anthropic = false
 `
 
 	return os.WriteFile(path, []byte(defaultContent), 0644)