refactor(config): standardize API key configuration field naming

- Rename `api_key_env` to `api_key` for env auth type
- Rename `api_key_key` to `api_key` for dotenv auth type
- Update default config path from root to `config/ai_providers.toml`
- Update default output path to `outputs/output.apkg`
- Update all provider examples in ai_providers.toml.example
- Update documentation in README.md to reflect new paths

BREAKING CHANGE: Configuration field names have changed
- Users must update their ai_providers.toml files
- `api_key_env` → `api_key` (for env auth)
- `api_key_key` → `api_key` (for dotenv auth)

This change improves consistency by using a single field name
`api_key` across different authentication types, making the
configuration more intuitive and easier to understand.

Author: SOV710

README.md

@@ -19,13 +19,13 @@ uv sync
 
 ## 配置
 
-在项目根目录创建 `ai_providers.toml` 文件，配置语言模型提供商:
+在 `config/ai_providers.toml` 文件中配置语言模型提供商:
 
 ```toml
 [provider_name]
 enable = true
 auth_type = "env"
-api_key_env = "YOUR_API_KEY_ENV_VAR"
+api_key = "YOUR_API_KEY_ENV_VAR"
 default_base_url = "https://api.example.com/v1"
 default_model = "model-name"
 ```

config/ai_providers.toml.example

@@ -13,7 +13,7 @@ enable = false
 auth_type = "env"
 base_url_env = "OPENAI_BASE_URL"
 model_env = "OPENAI_MODEL"
-api_key_env = "OPENAI_API_KEY"
+api_key = "OPENAI_API_KEY"
 default_base_url = "https://api.openai.com/v1"
 default_model = "gpt-4o"
 
@@ -23,14 +23,14 @@ auth_type = "dotenv"
 dotenv_path = ".env.d/anthropic.env"
 base_url_key = "ANTHROPIC_BASE_URL"
 model_key = "ANTHROPIC_MODEL"
-api_key_key = "ANTHROPIC_API_KEY"
+api_key = "ANTHROPIC_API_KEY"
 default_base_url = "https://api.anthropic.com"
 default_model = "claude-sonnet-4-20250514"
 
 [google]
 enable = false
 auth_type = "env"
-api_key_env = "GOOGLE_API_KEY"
+api_key = "GOOGLE_API_KEY"
 model_env = "GOOGLE_MODEL"
 default_base_url = "https://generativelanguage.googleapis.com/v1beta/openai"
 default_model = "gemini-1.5-pro"
@@ -40,7 +40,7 @@ enable = false
 auth_type = "env"
 base_url_env = "ZHIPU_BASE_URL"
 model_env = "ZHIPU_MODEL"
-api_key_env = "ZHIPU_API_KEY"
+api_key = "ZHIPU_API_KEY"
 default_base_url = "https://open.bigmodel.cn/api/paas/v4"
 default_model = "glm-4-plus"
 
@@ -49,7 +49,7 @@ enable = false
 auth_type = "env"
 base_url_env = "MOONSHOT_BASE_URL"
 model_env = "MOONSHOT_MODEL"
-api_key_env = "MOONSHOT_API_KEY"
+api_key = "MOONSHOT_API_KEY"
 default_base_url = "https://api.moonshot.cn/v1"
 default_model = "moonshot-v1-8k"
 
@@ -58,7 +58,7 @@ enable = false
 auth_type = "env"
 base_url_env = "QWEN_BASE_URL"
 model_env = "QWEN_MODEL"
-api_key_env = "DASHSCOPE_API_KEY"
+api_key = "DASHSCOPE_API_KEY"
 default_base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1"
 default_model = "qwen-plus"
 
@@ -67,7 +67,7 @@ enable = false
 auth_type = "env"
 base_url_env = "DOUBAO_BASE_URL"
 model_env = "DOUBAO_MODEL"
-api_key_env = "DOUBAO_API_KEY"
+api_key = "DOUBAO_API_KEY"
 default_base_url = "https://ark.cn-beijing.volces.com/api/v3"
 default_model = "doubao-pro-4k"
 
@@ -76,6 +76,6 @@ enable = false
 auth_type = "env"
 base_url_env = "SILICONFLOW_BASE_URL"
 model_env = "SILICONFLOW_MODEL"
-api_key_env = "SILICONFLOW_API_KEY"
+api_key = "SILICONFLOW_API_KEY"
 default_base_url = "https://api.siliconflow.cn/v1"
 default_model = "Qwen/Qwen2.5-72B-Instruct"

src/doc2anki/cli.py

@@ -21,7 +21,7 @@
 )
 console = Console()
 
-DEFAULT_CONFIG_PATH = Path("ai_providers.toml")
+DEFAULT_CONFIG_PATH = Path("config/ai_providers.toml")
 
 
 @app.command("list")
@@ -143,7 +143,7 @@ def generate_cmd(
         help="Input file or directory path",
     ),
     output: Path = typer.Option(
-        Path("output.apkg"),
+        Path("outputs/output.apkg"),
         "-o",
         "--output",
         help="Output APKG file path",

src/doc2anki/config/loader.py

@@ -78,16 +78,16 @@ def _resolve_direct_auth(provider_name: str, config: dict[str, Any]) -> Provider
 
 def _resolve_env_auth(provider_name: str, config: dict[str, Any]) -> ProviderConfig:
     """Resolve environment variable authentication config."""
-    if "api_key_env" not in config:
+    if "api_key" not in config:
         raise ConfigError(
-            f"Provider '{provider_name}' with auth_type=env missing 'api_key_env'"
+            f"Provider '{provider_name}' with auth_type=env missing 'api_key'"
         )
 
-    api_key = os.getenv(config["api_key_env"])
+    api_key = os.getenv(config["api_key"])
     if not api_key:
         raise ConfigError(
             f"Provider '{provider_name}': environment variable "
-            f"'{config['api_key_env']}' not set or empty"
+            f"'{config['api_key']}' not set or empty"
         )
 
     base_url = None
@@ -121,9 +121,9 @@ def _resolve_dotenv_auth(provider_name: str, config: dict[str, Any]) -> Provider
         raise ConfigError(
             f"Provider '{provider_name}' with auth_type=dotenv missing 'dotenv_path'"
         )
-    if "api_key_key" not in config:
+    if "api_key" not in config:
         raise ConfigError(
-            f"Provider '{provider_name}' with auth_type=dotenv missing 'api_key_key'"
+            f"Provider '{provider_name}' with auth_type=dotenv missing 'api_key'"
         )
 
     dotenv_path = Path(config["dotenv_path"])
@@ -135,10 +135,10 @@ def _resolve_dotenv_auth(provider_name: str, config: dict[str, Any]) -> Provider
     # Load the dotenv file
     load_dotenv(dotenv_path, override=True)
 
-    api_key = os.getenv(config["api_key_key"])
+    api_key = os.getenv(config["api_key"])
     if not api_key:
         raise ConfigError(
-            f"Provider '{provider_name}': key '{config['api_key_key']}' "
+            f"Provider '{provider_name}': key '{config['api_key']}' "
             f"not found in {dotenv_path}"
         )
 

src/doc2anki/config/models.py

@@ -29,7 +29,7 @@ class EnvAuthConfig(BaseModel):
     auth_type: Literal["env"]
     base_url_env: Optional[str] = None
     model_env: Optional[str] = None
-    api_key_env: str
+    api_key: str  # Environment variable name containing the API key
     default_base_url: Optional[str] = None
     default_model: Optional[str] = None
 
@@ -42,7 +42,7 @@ class DotenvAuthConfig(BaseModel):
     dotenv_path: str
     base_url_key: Optional[str] = None
     model_key: Optional[str] = None
-    api_key_key: str
+    api_key: str  # Key name in the dotenv file containing the API key
     default_base_url: Optional[str] = None
     default_model: Optional[str] = None