@asframe/opencode-iflow-auth 1.0.0 → 1.0.1

package/README.md

@@ -16,6 +16,56 @@ OpenCode plugin for iFlow.cn providing access to Qwen, DeepSeek, Kimi, GLM, and
 - **Native thinking mode**: Support for GLM-4.x, GLM-5 and DeepSeek R1 models.
 - **Configurable timeout**: Request timeout and iteration limits to prevent hangs.
 - **Automatic port selection**: OAuth callback server port conflict avoidance.
+- **Auto-install CLI**: Automatically install iflow CLI if not found.
+
+## Supported Models
+
+### API Key Mode (`iflow` provider)
+
+Models available via OAuth 2.0 or API Key authentication:
+
+| Model | Context | Output | Description |
+|-------|---------|--------|-------------|
+| `deepseek-v3` | 128K | 32K | DeepSeek V3 |
+| `deepseek-v3.2` | 128K | 64K | DeepSeek V3.2 |
+| `deepseek-r1` | 128K | 32K | DeepSeek R1 (Thinking) |
+| `glm-4.6` | 200K | 128K | GLM-4.6 (Reasoning, Vision) |
+| `glm-4.7` | 256K | 64K | GLM-4.7 (Latest, Reasoning, Vision) |
+| `qwen3-max` | 256K | 32K | Qwen3 Max |
+| `qwen3-max-preview` | 256K | 32K | Qwen3 Max Preview |
+| `qwen3-coder-plus` | 1M | 64K | Qwen3 Coder Plus |
+| `qwen3-vl-plus` | 256K | 32K | Qwen3 VL Plus (Vision) |
+| `qwen3-32b` | 128K | 32K | Qwen3 32B |
+| `qwen3-235b` | 256K | 64K | Qwen3 235B |
+| `qwen3-235b-a22b-thinking-2507` | 256K | 64K | Qwen3 235B Thinking |
+| `qwen3-235b-a22b-instruct` | 256K | 64K | Qwen3 235B Instruct |
+| `kimi-k2` | 128K | 64K | Kimi K2 |
+| `kimi-k2-0905` | 256K | 64K | Kimi K2 0905 |
+| `iflow-rome-30ba3b` | 256K | 64K | iFlow ROME 30B |
+
+### CLI Proxy Mode (`iflow-proxy` provider)
+
+**All models from API Key Mode** PLUS these exclusive models:
+
+| Model | Context | Output | Description |
+|-------|---------|--------|-------------|
+| `glm-5` | 256K | 64K | GLM-5 - Flagship model (744B params, 40B active), best for reasoning & coding |
+| `glm-5-free` | 256K | 64K | GLM-5 Free - Same capabilities as glm-5, free for limited time |
+| `glm-5-thinking` | 256K | 64K | GLM-5 Thinking - Enhanced "System 2" deep reasoning capabilities |
+
+**GLM-5 Model Family:**
+
+| Model | Description |
+|-------|-------------|
+| `glm-5` | Latest flagship model from Zhipu AI. 744B parameters (40B active), 28.5T tokens. Best-in-class for reasoning, coding, and agentic tasks. |
+| `glm-5-free` | Free access to GLM-5 during promotional period. Same capabilities, no cost. |
+| `glm-5-thinking` | Enhanced deep reasoning mode. Excels at complex architectural problems and "System 2" thinking. |
+
+**Summary:**
+- **API Key Mode**: 16 models
+- **CLI Proxy Mode**: 19 models (16 + 3 exclusive)
+
+**Note**: CLI Proxy mode can also be used if you prefer CLI authentication over API Key for any model.
 
 ## Two Plugin Modes
 
@@ -29,7 +79,7 @@ Direct API calls to iFlow.cn for standard models.
 |----------|-------|
 | Provider | `iflow` |
 | baseURL | `https://apis.iflow.cn/v1` |
-| Models | deepseek-v3.2, glm-4.6, kimi-k2.5, qwen3-coder-plus, etc. |
+| Auth | OAuth 2.0 / API Key |
 
 ### 2. `IFlowProxyPlugin` - CLI Proxy Mode
 
@@ -39,7 +89,7 @@ Routes requests through iflow CLI for GLM-5 support. The proxy server starts aut
 |----------|-------|
 | Provider | `iflow-proxy` |
 | Proxy Port | `127.0.0.1:19998` |
-| Models | glm-5, glm-5-free, glm-5-thinking |
+| Auth | iflow CLI login |
 
 **How it works:**
 1. Plugin detects if model requires CLI (glm-5, glm-5-free, glm-5-thinking)
@@ -49,8 +99,18 @@ Routes requests through iflow CLI for GLM-5 support. The proxy server starts aut
 
 ## Installation
 
+### Quick Start
+
 Add the plugin to your `opencode.json` or `opencode.jsonc`:
 
+```json
+{
+  "plugin": ["@asframe/opencode-iflow-auth"]
+}
+```
+
+### Full Configuration
+
 ```json
 {
   "plugin": ["@asframe/opencode-iflow-auth"],
@@ -91,17 +151,17 @@ Add the plugin to your `opencode.json` or `opencode.jsonc`:
       "models": {
         "glm-5": {
           "name": "GLM-5 (via CLI Proxy)",
-          "limit": { "context": 202000, "output": 64000 },
-          "modalities": { "input": ["text"], "output": ["text"] }
+          "limit": { "context": 256000, "output": 64000 },
+          "modalities": { "input": ["text", "image"], "output": ["text"] }
         },
         "glm-5-free": {
           "name": "GLM-5 Free (via CLI Proxy)",
-          "limit": { "context": 202000, "output": 64000 },
+          "limit": { "context": 256000, "output": 64000 },
           "modalities": { "input": ["text"], "output": ["text"] }
         },
         "glm-5-thinking": {
           "name": "GLM-5 Thinking (via CLI Proxy)",
-          "limit": { "context": 202000, "output": 64000 },
+          "limit": { "context": 256000, "output": 64000 },
           "modalities": { "input": ["text"], "output": ["text"] }
         }
       }
@@ -174,26 +234,30 @@ Edit `~/.config/opencode/iflow.json`:
 
 ### Configuration Options
 
-- `default_auth_method`: Default authentication method (`oauth`, `apikey`)
-- `account_selection_strategy`: Account rotation strategy (`sticky`, `round-robin`)
-- `auth_server_port_start`: Starting port for OAuth callback server (1024-65535)
-- `auth_server_port_range`: Number of ports to try (1-100)
-- `max_request_iterations`: Maximum loop iterations to prevent hangs (10-1000)
-- `request_timeout_ms`: Request timeout in milliseconds (60000-600000ms)
-- `enable_log_api_request`: Enable API request/response logging (errors always logged)
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `default_auth_method` | string | `oauth` | Default authentication method (`oauth`, `apikey`) |
+| `account_selection_strategy` | string | `sticky` | Account rotation strategy (`sticky`, `round-robin`) |
+| `auth_server_port_start` | number | `8087` | Starting port for OAuth callback server (1024-65535) |
+| `auth_server_port_range` | number | `10` | Number of ports to try (1-100) |
+| `max_request_iterations` | number | `50` | Maximum loop iterations to prevent hangs (10-1000) |
+| `request_timeout_ms` | number | `300000` | Request timeout in milliseconds (60000-600000ms) |
+| `enable_log_api_request` | boolean | `false` | Enable API request/response logging |
 
 ### Environment Variables
 
-- `IFLOW_AUTH_DEBUG`: Enable debug logging for auth plugin (`true`/`false`)
-- `IFLOW_PROXY_DEBUG`: Enable debug logging for proxy plugin (`true`/`false`)
-- `IFLOW_AUTO_INSTALL_CLI`: Auto-install iflow CLI if not installed (`true`/`false`)
-- `IFLOW_DEFAULT_AUTH_METHOD`
-- `IFLOW_ACCOUNT_SELECTION_STRATEGY`
-- `IFLOW_AUTH_SERVER_PORT_START`
-- `IFLOW_AUTH_SERVER_PORT_RANGE`
-- `IFLOW_MAX_REQUEST_ITERATIONS`
-- `IFLOW_REQUEST_TIMEOUT_MS`
-- `IFLOW_ENABLE_LOG_API_REQUEST`
+| Variable | Description |
+|----------|-------------|
+| `IFLOW_AUTH_DEBUG` | Enable debug logging for auth plugin (`true`/`false`) |
+| `IFLOW_PROXY_DEBUG` | Enable debug logging for proxy plugin (`true`/`false`) |
+| `IFLOW_AUTO_INSTALL_CLI` | Auto-install iflow CLI if not installed (`true`/`false`) |
+| `IFLOW_DEFAULT_AUTH_METHOD` | Override default auth method |
+| `IFLOW_ACCOUNT_SELECTION_STRATEGY` | Override account selection strategy |
+| `IFLOW_AUTH_SERVER_PORT_START` | Override OAuth server port |
+| `IFLOW_AUTH_SERVER_PORT_RANGE` | Override OAuth server port range |
+| `IFLOW_MAX_REQUEST_ITERATIONS` | Override max iterations |
+| `IFLOW_REQUEST_TIMEOUT_MS` | Override request timeout |
+| `IFLOW_ENABLE_LOG_API_REQUEST` | Enable API logging |
 
 ## Storage
 
@@ -261,6 +325,58 @@ Get-Process -Id (Get-NetTCPConnection -LocalPort 19998).OwningProcess | Stop-Pro
 lsof -i :19998 | grep LISTEN | awk '{print $2}' | xargs kill -9
 ```
 
+### Authentication Issues
+
+1. **API Key not working:**
+   - Ensure your API key starts with `sk-`
+   - Check if the key is valid at [iFlow.cn](https://iflow.cn)
+
+2. **OAuth not working:**
+   - Clear browser cookies
+   - Try a different browser
+   - Check if the callback port is available
+
+## FAQ
+
+### Q: Why do I need CLI Proxy for GLM-5?
+
+GLM-5 requires special authentication that is only available through the iflow CLI. The CLI Proxy mode bridges this gap by routing requests through the CLI.
+
+### Q: Can I use both modes at the same time?
+
+Yes! You can configure both `iflow` and `iflow-proxy` providers and use them interchangeably.
+
+### Q: Is this plugin official?
+
+No, this is an independent implementation and is not affiliated with, endorsed by, or supported by iFlow.cn.
+
+### Q: How do I get an API key?
+
+1. Visit [iFlow.cn](https://iflow.cn)
+2. Create an account or login
+3. Go to API settings
+4. Generate a new API key
+
+## Changelog
+
+### v1.0.0
+- Initial release
+- Dual authentication (OAuth 2.0 / API Key)
+- CLI Proxy mode for GLM-5
+- Auto-install CLI feature
+- Multi-account rotation
+- Thinking model support
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
 ## License
 
 MIT License - see [LICENSE](LICENSE) for details.
@@ -276,3 +392,4 @@ Feel free to open a PR to optimize this plugin further.
 - [GitHub Repository](https://github.com/asframe/opencode-iflow-auth)
 - [npm Package](https://www.npmjs.com/package/@asframe/opencode-iflow-auth)
 - [iFlow.cn](https://iflow.cn)
+- [OpenCode](https://opencode.ai)

package/dist/iflow/proxy.js

@@ -5,6 +5,14 @@ const IFLOW_PROXY_PORT = 19998;
 const IFLOW_PROXY_HOST = '127.0.0.1';
 const IFLOW_API_BASE = 'https://apis.iflow.cn';
 const CLI_REQUIRED_MODELS = ['glm-5', 'glm-5-free', 'glm-5-thinking'];
+const IFLOW_CLI_SUPPORTED_MODELS = [
+    'glm-5', 'glm-5-free', 'glm-5-thinking',
+    'glm-4.6', 'glm-4.7',
+    'qwen3-max', 'qwen3-max-preview', 'qwen3-coder-plus', 'qwen3-vl-plus', 'qwen3-32b', 'qwen3-235b', 'qwen3-235b-a22b-thinking-2507', 'qwen3-235b-a22b-instruct',
+    'kimi-k2', 'kimi-k2-0905',
+    'deepseek-v3', 'deepseek-v3.2', 'deepseek-r1',
+    'iflow-rome-30ba3b'
+];
 const DEBUG = process.env.IFLOW_PROXY_DEBUG === 'true';
 const AUTO_INSTALL_CLI = process.env.IFLOW_AUTO_INSTALL_CLI === 'true';
 function log(...args) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asframe/opencode-iflow-auth",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "OpenCode plugin for iFlow.cn - Access Qwen, DeepSeek, Kimi, GLM-5 models with OAuth 2.0, API Key, and CLI Proxy support",
   "type": "module",
   "main": "dist/index.js",