diff --git a/website/docs/acp/examples.md b/website/docs/acp/examples.md index 139661b5..e559d3a2 100644 --- a/website/docs/acp/examples.md +++ b/website/docs/acp/examples.md @@ -265,7 +265,7 @@ async def main(): "params": { "protocolVersion": 1, "clientInfo": {"name": "http-client", "version": "1.0"}, - "capabilities": {} + "clientCapabilities": {} } }, headers=HEADERS) resp.raise_for_status() diff --git a/website/docs/acp/http-transport.md b/website/docs/acp/http-transport.md index 3ff915ef..ee7ee5d6 100644 --- a/website/docs/acp/http-transport.md +++ b/website/docs/acp/http-transport.md @@ -102,7 +102,7 @@ Below is a full interaction using `curl`: # Step 1: Initialize — creates a connection and returns the Connection ID CONN_ID=$(curl -s -D - -X POST http://localhost:8765/acp \ -H "Content-Type: application/json" \ - -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":1,"capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}' \ + -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":1,"clientCapabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}' \ | grep -i 'acp-connection-id' | awk '{print $2}' | tr -d '\r') echo "Connection ID: $CONN_ID" diff --git a/website/docs/acp/protocol-reference.md b/website/docs/acp/protocol-reference.md index ee0df093..b38fd5ba 100644 --- a/website/docs/acp/protocol-reference.md +++ b/website/docs/acp/protocol-reference.md @@ -64,6 +64,8 @@ Protocol handshake. Must be the first call on every connection. | `promptCapabilities.embeddedContext` | `true` | Accepts embedded resource content in prompts | | `promptCapabilities.image` | `false` | Image input not supported (degrades to text marker) | | `promptCapabilities.audio` | `false` | Audio input not supported (degrades to text marker) | +| `mcpCapabilities.http` | `true` | Accepts HTTP (streamable) MCP servers at session creation | +| `mcpCapabilities.sse` | `true` | Accepts SSE MCP servers at session creation | | `sessionCapabilities.list` | `{}` | Supports listing sessions | | `sessionCapabilities.close` | `{}` | Supports closing sessions | @@ -78,7 +80,7 @@ Create a new session with an independent agent runtime, tool registry, and LLM c | Field | Type | Required | Description | |-------|------|----------|-------------| | `cwd` | string | Yes | Absolute path to the working directory | -| `mcpServers` | object | No | MCP server configuration (accepted but not yet functional) | +| `mcpServers` | object | No | MCP server configuration; HTTP (streamable) and SSE servers are connected for the session | **Response Fields** @@ -189,7 +191,7 @@ Send user input and trigger streaming agent responses. | Field | Type | Description | |-------|------|-------------| | `stopReason` | string | Why the prompt completed (see Stop Reasons) | -| `usage` | object | Token usage: `inputTokens`, `outputTokens`, `totalTokens` | +| `_meta.usage` | object | Token usage delivered under the response `_meta` object: `input_tokens`, `output_tokens`, `total_tokens` | **Stop Reasons** @@ -243,7 +245,7 @@ Close a session and release its resources. --- -### sessions/list +### session/list List all persisted sessions for a given working directory. @@ -261,7 +263,7 @@ List all persisted sessions for a given working directory. --- -### config/set +### session/set_config_option Dynamically set a configuration option for a session. @@ -371,8 +373,8 @@ For `aliyun_api`, read-only actions are auto-allowed. Non-read-only RPC and ROA ```json { - "outcome": "allowed", - "option_id": "allow_once" + "outcome": "selected", + "optionId": "allow_once" } ``` @@ -380,7 +382,7 @@ Or to deny: ```json { - "outcome": "denied" + "outcome": "cancelled" } ``` diff --git a/website/docs/cli/command-line-options.md b/website/docs/cli/command-line-options.md index 66e7748b..587d99f7 100644 --- a/website/docs/cli/command-line-options.md +++ b/website/docs/cli/command-line-options.md @@ -17,6 +17,7 @@ Command line options change how IaC Code starts. Use them before entering the in | `--max-turns ` | Limit the maximum number of agent turns in non-interactive mode. The default is `100`. | | `--thinking-enabled`, `--no-thinking-enabled` | Control whether one-shot non-interactive requests explicitly enable thinking. The default is `--thinking-enabled`; use `--no-thinking-enabled` to send `thinking_enabled=false` for this run without rewriting `settings.yml`. | | `-d`, `--debug` | Enable debug logging for the current run. In interactive mode, use `/debug` to inspect or change debug logging after startup. | +| `--verbose` | Show headless (non-interactive) progress on standard error. | | `-r `, `--resume ` | Resume a previous session by exact session ID, unique ID prefix, or unique session name. Cross-project resolved sessions print a `cd ... && iac-code --resume ` command instead of hot-swapping the current project. | | `-c`, `--continue` | Resume the most recent session. This cannot be used together with `--resume`. | | `--allowed-tools ` | Comma-separated tool permission patterns to allow, e.g. `'bash(git *),write_file'`. | @@ -47,7 +48,7 @@ iac-code Start with a specific model for this run: ```bash -iac-code --model qwen3.6-plus +iac-code --model qwen3.7-max ``` Run a one-shot prompt: diff --git a/website/docs/cli/skills.md b/website/docs/cli/skills.md index 87a93cd1..dc68f97d 100644 --- a/website/docs/cli/skills.md +++ b/website/docs/cli/skills.md @@ -7,26 +7,14 @@ description: Create and use reusable prompt templates as slash commands. Skills are reusable prompt templates that extend IaC Code with custom slash commands. They let you package complex instructions, tool configurations, and workflow patterns into named commands that can be invoked during a conversation. -## Skill File Formats +## Skill File Format -Skills are defined as Markdown files with YAML frontmatter. Two formats are supported: - -### Single File - -A standalone Markdown file named after the skill: - -```text -skills/ - deploy-check.md - code-review.md -``` - -### Directory - -A directory containing a `SKILL.md` file, useful when the skill needs additional reference files: +A skill is a directory containing a `SKILL.md` file with YAML frontmatter. The directory name is the skill's default name, and the directory can hold additional reference files the skill depends on: ```text skills/ + deploy-check/ + SKILL.md my-skill/ SKILL.md references/ @@ -35,16 +23,16 @@ skills/ ## Discovery and Priority -IaC Code discovers skills from multiple locations. When skills share the same name, later sources override earlier ones: +IaC Code discovers skills from multiple locations. When skills share the same name, higher-priority sources override lower-priority ones: | Priority | Location | Description | |----------|----------|-------------| -| 1 (lowest) | Bundled | Built-in skills shipped with IaC Code | -| 2 | `~/.iac-code/skills/` | User-global skills (follows `IAC_CODE_CONFIG_DIR`) | -| 3 | `skills/` | Project-level skills directory | -| 4 (highest) | `.iac-code/skills/` | Project config-level skills directory | +| 1 (lowest) | `~/.iac-code/skills/` | User-global skills (follows `IAC_CODE_CONFIG_DIR`) | +| 2 | `skills/` | Project-level skills directory | +| 3 | `.iac-code/skills/` | Project config-level skills directory | +| 4 (highest) | Bundled | Built-in skills shipped with IaC Code; cannot be shadowed by user or project skills of the same name | -Project skill directories are searched upward from the current working directory to the filesystem root. +Project skill directories are searched from the git repository root down to the current working directory. When the current directory is not inside a git repository, only the current directory is searched. ## Frontmatter Reference @@ -81,7 +69,7 @@ paths: | `when_to_use` | No | `""` | Hint for the model on when to invoke this skill automatically | | `argument_hint` | No | `""` | Placeholder shown after the command name | | `arguments` | No | `[]` | Named argument list for positional substitution | -| `allowed_tools` | No | `[]` | Tools the skill is allowed to use (applies to fork mode) | +| `allowed_tools` | No | `[]` | Tools the skill is allowed to use (applies to both inline and fork modes) | | `user_invocable` | No | `true` | Whether the user can invoke this skill directly via `/name` (or `$name`) | | `model` | No | `"inherit"` | Model override for this skill execution | | `effort` | No | `""` | Thinking effort override | @@ -189,7 +177,7 @@ Review the current project and generate a pre-deployment checklist covering: If a stack name is provided, also check the current stack status. ``` -Save this as `~/.iac-code/skills/checklist.md` or `.iac-code/skills/checklist.md` in your project. Then invoke it with `/checklist` in the REPL — or with `$checklist`, which is identical but filters autocomplete suggestions to skills only. +Save this as `~/.iac-code/skills/checklist/SKILL.md` or `.iac-code/skills/checklist/SKILL.md` in your project. Then invoke it with `/checklist` in the REPL — or with `$checklist`, which is identical but filters autocomplete suggestions to skills only. ## Permissions diff --git a/website/docs/configuration/environment-variables.md b/website/docs/configuration/environment-variables.md index d8c4ec05..334e90cf 100644 --- a/website/docs/configuration/environment-variables.md +++ b/website/docs/configuration/environment-variables.md @@ -19,7 +19,7 @@ Environment variables are useful for CI/CD pipelines, containers, and one-off ov |---|---| | `IAC_CODE_PROVIDER` | Model provider name (case-insensitive). Valid values: `DashScope`, `DashScope Token Plan`, `OpenAI`, `Anthropic`, `DeepSeek`, `Gemini`, `Azure OpenAI`, `ModelScope`, `Kimi CN`, `Kimi Intl`, `MiniMax CN`, `MiniMax Intl`, `ZhiPu CN`, `ZhiPu Intl`, `Volcengine CN`, `SiliconFlow CN`, `SiliconFlow Intl`, `Aliyun CodingPlan`, `Aliyun CodingPlan Intl`, `ZhiPu CN CodingPlan`, `ZhiPu Intl CodingPlan`, `Volcengine CodingPlan`, `OpenAI Compatible`, `Anthropic Compatible`, `OpenRouter`, `Ollama`, `LM Studio` | | `IAC_CODE_MODEL` | Model name | -| `IAC_CODE_BASE_URL` | API endpoint for `OpenAI Compatible` and `Anthropic Compatible` only; ignored for other providers | +| `IAC_CODE_BASE_URL` | API endpoint for `OpenAI Compatible` only; ignored (with a warning) for other providers | | `IAC_CODE_API_KEY` | Provider API key; overrides the active provider's key in `.credentials.yml` | See [LLM Providers](./llm-providers.md) for provider details. diff --git a/website/docs/configuration/llm-providers.md b/website/docs/configuration/llm-providers.md index 0898336c..5d5e54d9 100644 --- a/website/docs/configuration/llm-providers.md +++ b/website/docs/configuration/llm-providers.md @@ -74,5 +74,5 @@ CLI arguments > environment variables > configuration files |---|---| | `IAC_CODE_PROVIDER` | Model provider name (case-insensitive). See tables above for valid values | | `IAC_CODE_MODEL` | Model name | -| `IAC_CODE_BASE_URL` | API endpoint for `OpenAI Compatible` and `Anthropic Compatible` only; ignored for other providers | +| `IAC_CODE_BASE_URL` | API endpoint for `OpenAI Compatible` only; ignored (with a warning) for other providers | | `IAC_CODE_API_KEY` | Provider API key | diff --git a/website/docs/intro.md b/website/docs/intro.md index ae8ccb2d..a0750888 100644 --- a/website/docs/intro.md +++ b/website/docs/intro.md @@ -10,8 +10,8 @@ IaC Code is an AI-powered Infrastructure as Code assistant for cloud infrastruct Core capabilities: -- **Say it, ship it** — describe what you need in plain language and get validated, deployment-ready ROS or Terraform templates. -- **One command to production** — go from template to running infrastructure and applications in one flow; create, update, delete, and monitor stacks across regions. +- **Say it, ship it** — describe what you need in plain language and get validated ROS templates ready to deploy, or generated Terraform templates. +- **One command to production** — for Alibaba Cloud ROS, go from template to running infrastructure in one flow: create, update, delete, and monitor stacks across regions. Terraform support covers template generation and conversion, not deployment. - **Cloud smarts built in** — search documentation, check resource availability, and estimate costs before you deploy; every decision backed by real cloud data. The documentation is organized around user tasks. Start with installation and quick start, then configure providers and credentials, then use the CLI reference when you need command details. diff --git a/website/docs/mcp/oauth-and-security.md b/website/docs/mcp/oauth-and-security.md index 57c84a3f..ab2a226f 100644 --- a/website/docs/mcp/oauth-and-security.md +++ b/website/docs/mcp/oauth-and-security.md @@ -85,7 +85,7 @@ Headless and protocol server modes skip unapproved project servers rather than p IaC Code protects secrets in several ways: - Config output from `iac-code mcp get` redacts keys that look like tokens, secrets, passwords, API keys, and authorization headers. -- Plaintext sensitive header or env values are rejected unless they use an environment-variable reference. +- Plaintext sensitive header or env values are rejected when adding servers via `iac-code mcp add` or `mcp add-json` unless they use an environment-variable reference. Configuration files edited by hand are not re-validated on load, so avoid storing plaintext secrets directly. - MCP stdio servers inherit only an allowlist of safe environment variables plus the explicit server env. - Proxy environment variables with embedded usernames or passwords are not inherited by stdio MCP servers. - MCP artifact files are written under the private IaC Code runtime configuration directory. diff --git a/website/docs/mcp/overview.md b/website/docs/mcp/overview.md index a9012003..133e4c1e 100644 --- a/website/docs/mcp/overview.md +++ b/website/docs/mcp/overview.md @@ -43,7 +43,7 @@ Use MCP when you want IaC Code to call a local or remote capability that is not At runtime IaC Code: -1. Loads MCP configuration from user, local, project, and session sources. +1. Loads MCP configuration from user, project, local, and session sources. 2. Expands `${VAR}` and `${VAR:-default}` references. 3. Skips unsafe or invalid servers with user-visible warnings. 4. Connects approved servers with bounded concurrency. diff --git a/website/i18n/de/docusaurus-plugin-content-docs/current/acp/examples.md b/website/i18n/de/docusaurus-plugin-content-docs/current/acp/examples.md index 052bbbad..35891e46 100644 --- a/website/i18n/de/docusaurus-plugin-content-docs/current/acp/examples.md +++ b/website/i18n/de/docusaurus-plugin-content-docs/current/acp/examples.md @@ -265,7 +265,7 @@ async def main(): "params": { "protocolVersion": 1, "clientInfo": {"name": "http-client", "version": "1.0"}, - "capabilities": {} + "clientCapabilities": {} } }, headers=HEADERS) resp.raise_for_status() diff --git a/website/i18n/de/docusaurus-plugin-content-docs/current/acp/http-transport.md b/website/i18n/de/docusaurus-plugin-content-docs/current/acp/http-transport.md index ac1ce7d2..44d2ddda 100644 --- a/website/i18n/de/docusaurus-plugin-content-docs/current/acp/http-transport.md +++ b/website/i18n/de/docusaurus-plugin-content-docs/current/acp/http-transport.md @@ -102,7 +102,7 @@ Nachfolgend eine vollstaendige Interaktion mit `curl`: # Step 1: Initialize — creates a connection and returns the Connection ID CONN_ID=$(curl -s -D - -X POST http://localhost:8765/acp \ -H "Content-Type: application/json" \ - -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":1,"capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}' \ + -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":1,"clientCapabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}' \ | grep -i 'acp-connection-id' | awk '{print $2}' | tr -d '\r') echo "Connection ID: $CONN_ID" diff --git a/website/i18n/de/docusaurus-plugin-content-docs/current/acp/protocol-reference.md b/website/i18n/de/docusaurus-plugin-content-docs/current/acp/protocol-reference.md index dc50d68c..e94c9f80 100644 --- a/website/i18n/de/docusaurus-plugin-content-docs/current/acp/protocol-reference.md +++ b/website/i18n/de/docusaurus-plugin-content-docs/current/acp/protocol-reference.md @@ -64,6 +64,8 @@ Protokoll-Handshake. Muss der erste Aufruf bei jeder Verbindung sein. | `promptCapabilities.embeddedContext` | `true` | Akzeptiert eingebettete Ressourceninhalte in Eingaben | | `promptCapabilities.image` | `false` | Bildeingabe nicht unterstuetzt (wird zu Textmarker degradiert) | | `promptCapabilities.audio` | `false` | Audioeingabe nicht unterstuetzt (wird zu Textmarker degradiert) | +| `mcpCapabilities.http` | `true` | Akzeptiert HTTP-/Streamable-MCP-Server bei der Sitzungserstellung | +| `mcpCapabilities.sse` | `true` | Akzeptiert SSE-MCP-Server bei der Sitzungserstellung | | `sessionCapabilities.list` | `{}` | Unterstuetzt das Auflisten von Sitzungen | | `sessionCapabilities.close` | `{}` | Unterstuetzt das Schliessen von Sitzungen | @@ -78,7 +80,7 @@ Erstellen Sie eine neue Sitzung mit einer unabhaengigen Agenten-Laufzeitumgebung | Feld | Typ | Erforderlich | Beschreibung | |-------|------|----------|-------------| | `cwd` | string | Ja | Absoluter Pfad zum Arbeitsverzeichnis | -| `mcpServers` | object | Nein | MCP-Serverkonfiguration (akzeptiert, aber noch nicht funktional) | +| `mcpServers` | object | Nein | MCP-Serverkonfiguration; HTTP- (Streamable) und SSE-Server werden fuer die Sitzung verbunden | **Antwortfelder** @@ -189,7 +191,7 @@ Senden Sie Benutzereingaben und loesen Sie Streaming-Agentenantworten aus. | Feld | Typ | Beschreibung | |-------|------|-------------| | `stopReason` | string | Warum die Eingabe abgeschlossen wurde (siehe Abschlussgruende) | -| `usage` | object | Token-Nutzung: `inputTokens`, `outputTokens`, `totalTokens` | +| `_meta.usage` | object | Token-Nutzung unter dem `_meta`-Objekt der Antwort: `input_tokens`, `output_tokens`, `total_tokens` | **Abschlussgruende** @@ -243,7 +245,7 @@ Schliessen Sie eine Sitzung und geben Sie ihre Ressourcen frei. --- -### sessions/list +### session/list Listen Sie alle gespeicherten Sitzungen fuer ein gegebenes Arbeitsverzeichnis auf. @@ -261,7 +263,7 @@ Listen Sie alle gespeicherten Sitzungen fuer ein gegebenes Arbeitsverzeichnis au --- -### config/set +### session/set_config_option Setzen Sie dynamisch eine Konfigurationsoption fuer eine Sitzung. @@ -371,8 +373,8 @@ Fuer `aliyun_api` werden Nur-Lese-Aktionen automatisch erlaubt. Nicht nur lesend ```json { - "outcome": "allowed", - "option_id": "allow_once" + "outcome": "selected", + "optionId": "allow_once" } ``` @@ -380,7 +382,7 @@ Oder zum Verweigern: ```json { - "outcome": "denied" + "outcome": "cancelled" } ``` diff --git a/website/i18n/de/docusaurus-plugin-content-docs/current/cli/command-line-options.md b/website/i18n/de/docusaurus-plugin-content-docs/current/cli/command-line-options.md index 4a8af4f0..bdedba9f 100644 --- a/website/i18n/de/docusaurus-plugin-content-docs/current/cli/command-line-options.md +++ b/website/i18n/de/docusaurus-plugin-content-docs/current/cli/command-line-options.md @@ -17,6 +17,7 @@ Befehlszeilenoptionen steuern, wie IaC Code gestartet wird. Sie können vor dem | `--max-turns ` | Maximale Anzahl der Agenten-Runden im nicht-interaktiven Modus begrenzen. Standard ist `100`. | | `--thinking-enabled`, `--no-thinking-enabled` | Steuert, ob einmalige nicht-interaktive Anfragen Thinking explizit aktivieren. Standard ist `--thinking-enabled`; verwenden Sie `--no-thinking-enabled`, um fuer diesen Lauf `thinking_enabled=false` zu senden, ohne `settings.yml` umzuschreiben. | | `-d`, `--debug` | Debug-Protokollierung für den aktuellen Lauf aktivieren. Im interaktiven Modus verwenden Sie `/debug`, um die Debug-Protokollierung nach dem Start zu prüfen oder zu ändern. | +| `--verbose` | Headless-Fortschritt (nicht-interaktiv) auf der Standardfehlerausgabe anzeigen. | | `-r `, `--resume ` | Eine vorherige Sitzung über die exakte Sitzungs-ID, ein eindeutiges ID-Präfix oder einen eindeutigen Sitzungsnamen fortsetzen. Projektübergreifend aufgelöste Sitzungen geben einen `cd ... && iac-code --resume `-Befehl aus, statt das aktuelle Projekt direkt zu wechseln. | | `-c`, `--continue` | Die letzte Sitzung fortsetzen. Kann nicht zusammen mit `--resume` verwendet werden. | | `--allowed-tools ` | Kommagetrennte Werkzeug-Berechtigungsmuster zum Erlauben, z.B. `'bash(git *),write_file'`. | @@ -47,7 +48,7 @@ iac-code Für diesen Lauf ein bestimmtes Modell angeben: ```bash -iac-code --model qwen3.6-plus +iac-code --model qwen3.7-max ``` Einen einmaligen Prompt ausführen: diff --git a/website/i18n/de/docusaurus-plugin-content-docs/current/cli/skills.md b/website/i18n/de/docusaurus-plugin-content-docs/current/cli/skills.md index 7733d0e7..bb890817 100644 --- a/website/i18n/de/docusaurus-plugin-content-docs/current/cli/skills.md +++ b/website/i18n/de/docusaurus-plugin-content-docs/current/cli/skills.md @@ -7,26 +7,14 @@ description: Create and use reusable prompt templates as slash commands. Skills are reusable prompt templates that extend IaC Code with custom slash commands. They let you package complex instructions, tool configurations, and workflow patterns into named commands that can be invoked during a conversation. -## Skill File Formats +## Skill-Dateiformat -Skills are defined as Markdown files with YAML frontmatter. Two formats are supported: - -### Single File - -A standalone Markdown file named after the skill: - -```text -skills/ - deploy-check.md - code-review.md -``` - -### Directory - -A directory containing a `SKILL.md` file, useful when the skill needs additional reference files: +Ein Skill ist ein Verzeichnis, das eine `SKILL.md`-Datei enthält. Der Verzeichnisname ist der Standard-Skill-Name. Das Verzeichnis kann zusätzliche Referenzdateien enthalten: ```text skills/ + deploy-check/ + SKILL.md my-skill/ SKILL.md references/ @@ -35,16 +23,16 @@ skills/ ## Discovery and Priority -IaC Code discovers skills from multiple locations. When skills share the same name, later sources override earlier ones: +IaC Code entdeckt Skills aus mehreren Quellen. Wenn Skills denselben Namen haben, überschreiben Quellen mit höherer Priorität die mit niedrigerer Priorität: -| Priority | Location | Description | +| Priorität | Quelle | Beschreibung | |----------|----------|-------------| -| 1 (lowest) | Bundled | Built-in skills shipped with IaC Code | -| 2 | `~/.iac-code/skills/` | User-global skills (follows `IAC_CODE_CONFIG_DIR`) | -| 3 | `skills/` | Project-level skills directory | -| 4 (highest) | `.iac-code/skills/` | Project config-level skills directory | +| 1 (niedrigste) | `~/.iac-code/skills/` | Benutzerweite Skills (folgt `IAC_CODE_CONFIG_DIR`) | +| 2 | `skills/` | Skills-Verzeichnis auf Projektebene | +| 3 | `.iac-code/skills/` | Skills-Verzeichnis auf Projektkonfigurationsebene | +| 4 (höchste) | Gebündelt | Eingebaute Skills, die mit IaC Code ausgeliefert werden. Können nicht durch gleichnamige Benutzer- oder Projekt-Skills überschattet werden | -Project skill directories are searched upward from the current working directory to the filesystem root. +Projekt-Skill-Verzeichnisse werden von der Wurzel des Git-Repositorys abwärts bis zum aktuellen Arbeitsverzeichnis durchsucht. Wenn Sie sich nicht in einem Git-Repository befinden, wird nur das aktuelle Verzeichnis durchsucht. ## Frontmatter Reference @@ -81,7 +69,7 @@ paths: | `when_to_use` | No | `""` | Hint for the model on when to invoke this skill automatically | | `argument_hint` | No | `""` | Placeholder shown after the command name | | `arguments` | No | `[]` | Named argument list for positional substitution | -| `allowed_tools` | No | `[]` | Tools the skill is allowed to use (applies to fork mode) | +| `allowed_tools` | No | `[]` | Tools the skill is allowed to use (applies to both inline and fork modes) | | `user_invocable` | No | `true` | Whether the user can invoke this skill directly via `/name` (or `$name`) | | `model` | No | `"inherit"` | Model override for this skill execution | | `effort` | No | `""` | Thinking effort override | @@ -189,7 +177,7 @@ Review the current project and generate a pre-deployment checklist covering: If a stack name is provided, also check the current stack status. ``` -Save this as `~/.iac-code/skills/checklist.md` or `.iac-code/skills/checklist.md` in your project. Then invoke it with `/checklist` in the REPL — or with `$checklist`, which is identical but filters autocomplete suggestions to skills only. +Save this as `~/.iac-code/skills/checklist/SKILL.md` or `.iac-code/skills/checklist/SKILL.md` in your project. Then invoke it with `/checklist` in the REPL — or with `$checklist`, which is identical but filters autocomplete suggestions to skills only. ## Permissions diff --git a/website/i18n/de/docusaurus-plugin-content-docs/current/configuration/environment-variables.md b/website/i18n/de/docusaurus-plugin-content-docs/current/configuration/environment-variables.md index c324969a..91c6d271 100644 --- a/website/i18n/de/docusaurus-plugin-content-docs/current/configuration/environment-variables.md +++ b/website/i18n/de/docusaurus-plugin-content-docs/current/configuration/environment-variables.md @@ -19,7 +19,7 @@ Umgebungsvariablen sind nuetzlich fuer CI/CD-Pipelines, Container und einmalige |---|---| | `IAC_CODE_PROVIDER` | Name des Modellanbieters (Gross-/Kleinschreibung wird nicht beachtet). Gueltige Werte: `DashScope`, `DashScope Token Plan`, `OpenAI`, `Anthropic`, `DeepSeek`, `Gemini`, `Azure OpenAI`, `ModelScope`, `Kimi CN`, `Kimi Intl`, `MiniMax CN`, `MiniMax Intl`, `ZhiPu CN`, `ZhiPu Intl`, `Volcengine CN`, `SiliconFlow CN`, `SiliconFlow Intl`, `Aliyun CodingPlan`, `Aliyun CodingPlan Intl`, `ZhiPu CN CodingPlan`, `ZhiPu Intl CodingPlan`, `Volcengine CodingPlan`, `OpenAPI Compatible`, `Anthropic Compatible`, `OpenRouter`, `Ollama`, `LM Studio` | | `IAC_CODE_MODEL` | Modellname | -| `IAC_CODE_BASE_URL` | API-Endpunkt nur fuer `OpenAPI Compatible` und `Anthropic Compatible`; wird fuer andere Anbieter ignoriert | +| `IAC_CODE_BASE_URL` | API-Endpunkt nur fuer `OpenAI Compatible`; wird fuer andere Anbieter ignoriert (mit einer Warnung) | | `IAC_CODE_API_KEY` | API-Schluessel des Anbieters; ueberschreibt den Schluessel des aktiven Anbieters in `.credentials.yml` | Siehe [LLM-Anbieter](./llm-providers.md) fuer Anbieterdetails. diff --git a/website/i18n/de/docusaurus-plugin-content-docs/current/configuration/llm-providers.md b/website/i18n/de/docusaurus-plugin-content-docs/current/configuration/llm-providers.md index 773fb1ed..fdd1a8f1 100644 --- a/website/i18n/de/docusaurus-plugin-content-docs/current/configuration/llm-providers.md +++ b/website/i18n/de/docusaurus-plugin-content-docs/current/configuration/llm-providers.md @@ -74,5 +74,5 @@ CLI-Argumente > Umgebungsvariablen > Konfigurationsdateien |---|---| | `IAC_CODE_PROVIDER` | Name des Modellanbieters (Gross-/Kleinschreibung wird nicht beachtet). Gueltige Werte siehe obige Tabellen | | `IAC_CODE_MODEL` | Modellname | -| `IAC_CODE_BASE_URL` | API-Endpunkt nur fuer `OpenAPI Compatible` und `Anthropic Compatible`; wird fuer andere Anbieter ignoriert | +| `IAC_CODE_BASE_URL` | API-Endpunkt nur fuer `OpenAI Compatible`; wird fuer andere Anbieter ignoriert (mit einer Warnung) | | `IAC_CODE_API_KEY` | API-Schluessel des Anbieters | diff --git a/website/i18n/de/docusaurus-plugin-content-docs/current/intro.md b/website/i18n/de/docusaurus-plugin-content-docs/current/intro.md index e99e1089..78d75bbf 100644 --- a/website/i18n/de/docusaurus-plugin-content-docs/current/intro.md +++ b/website/i18n/de/docusaurus-plugin-content-docs/current/intro.md @@ -10,8 +10,8 @@ IaC Code ist ein KI-gestuetzter Infrastructure-as-Code-Assistent fuer Cloud-Infr Kernfunktionen: -- **Sagen Sie es, liefern Sie es** -- beschreiben Sie Ihren Bedarf in natuerlicher Sprache und erhalten Sie validierte, einsatzbereite ROS- oder Terraform-Vorlagen. -- **Ein Befehl bis zur Produktion** -- gehen Sie in einem Ablauf von der Vorlage zur laufenden Infrastruktur und Anwendungen; erstellen, aktualisieren, loeschen und ueberwachen Sie Stacks ueber Regionen hinweg. +- **Sagen Sie es, liefern Sie es** -- beschreiben Sie Ihren Bedarf in natuerlicher Sprache und erhalten Sie validierte, einsatzbereite ROS-Vorlagen oder generierte Terraform-Vorlagen. +- **Von der Vorlage zur laufenden Infrastruktur** -- fuer Alibaba Cloud ROS gehen Sie von der Vorlage bis zur laufenden Infrastruktur: erstellen, aktualisieren, loeschen und ueberwachen Sie Stacks ueber Regionen hinweg. Die Terraform-Unterstuetzung umfasst die Generierung und Konvertierung von Vorlagen, nicht jedoch die Bereitstellung. - **Integrierte Cloud-Intelligenz** -- durchsuchen Sie Dokumentation, pruefen Sie die Ressourcenverfuegbarkeit und schaetzen Sie Kosten, bevor Sie bereitstellen; jede Entscheidung wird durch echte Cloud-Daten gestuetzt. Die Dokumentation ist nach Benutzeraufgaben organisiert. Beginnen Sie mit Installation und Schnellstart, konfigurieren Sie dann Anbieter und Anmeldedaten und verwenden Sie die CLI-Referenz, wenn Sie Befehlsdetails benoetigen. diff --git a/website/i18n/de/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md b/website/i18n/de/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md index c8212153..bcb834b2 100644 --- a/website/i18n/de/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md +++ b/website/i18n/de/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md @@ -85,7 +85,7 @@ Headless- und Protokollservermodi überspringen nicht genehmigte Projektserver, IaC Code schützt Secrets auf mehrere Arten: - Die Ausgabe von `iac-code mcp get` schwärzt Keys, die wie Tokens, Secrets, Passwörter, API-Keys oder Authorization-Headers aussehen. -- Klartextwerte in sensiblen Headers oder env-Einträgen werden abgelehnt, sofern sie keine Umgebungsvariablen-Referenz nutzen. +- Klartextwerte in sensiblen Headers oder env-Einträgen werden nur beim Hinzufügen von Servern über `iac-code mcp add` / `mcp add-json` abgelehnt, sofern sie keine Umgebungsvariablen-Referenz nutzen. Von Hand bearbeitete Konfigurationsdateien werden beim Laden nicht erneut validiert; speichern Sie daher keine Klartext-Secrets direkt darin. - MCP-stdio-Server erben nur eine Allowlist sicherer Umgebungsvariablen plus explizites Server-env. - Proxy-Umgebungsvariablen mit Benutzernamen oder Passwörtern werden nicht an stdio-MCP-Server vererbt. - MCP-Artefaktdateien werden im privaten Runtime-Konfigurationsverzeichnis von IaC Code geschrieben. diff --git a/website/i18n/de/docusaurus-plugin-content-docs/current/mcp/overview.md b/website/i18n/de/docusaurus-plugin-content-docs/current/mcp/overview.md index 996a6c08..8e809af6 100644 --- a/website/i18n/de/docusaurus-plugin-content-docs/current/mcp/overview.md +++ b/website/i18n/de/docusaurus-plugin-content-docs/current/mcp/overview.md @@ -43,7 +43,7 @@ Verwenden Sie MCP, wenn IaC Code lokale oder entfernte Funktionen aufrufen soll, Zur Laufzeit führt IaC Code diese Schritte aus: -1. Lädt MCP-Konfiguration aus Benutzer-, lokalen, Projekt- und Sitzungsquellen. +1. Lädt MCP-Konfiguration aus Benutzer-, Projekt-, lokalen und Sitzungsquellen. 2. Erweitert `${VAR}`- und `${VAR:-default}`-Referenzen. 3. Überspringt unsichere oder ungültige Server mit sichtbaren Warnungen. 4. Verbindet genehmigte Server mit begrenzter Parallelität. diff --git a/website/i18n/es/docusaurus-plugin-content-docs/current/acp/examples.md b/website/i18n/es/docusaurus-plugin-content-docs/current/acp/examples.md index 4b8b324c..17f27f59 100644 --- a/website/i18n/es/docusaurus-plugin-content-docs/current/acp/examples.md +++ b/website/i18n/es/docusaurus-plugin-content-docs/current/acp/examples.md @@ -265,7 +265,7 @@ async def main(): "params": { "protocolVersion": 1, "clientInfo": {"name": "http-client", "version": "1.0"}, - "capabilities": {} + "clientCapabilities": {} } }, headers=HEADERS) resp.raise_for_status() diff --git a/website/i18n/es/docusaurus-plugin-content-docs/current/acp/http-transport.md b/website/i18n/es/docusaurus-plugin-content-docs/current/acp/http-transport.md index 18850032..53b1c991 100644 --- a/website/i18n/es/docusaurus-plugin-content-docs/current/acp/http-transport.md +++ b/website/i18n/es/docusaurus-plugin-content-docs/current/acp/http-transport.md @@ -102,7 +102,7 @@ A continuacion se muestra una interaccion completa usando `curl`: # Step 1: Initialize — creates a connection and returns the Connection ID CONN_ID=$(curl -s -D - -X POST http://localhost:8765/acp \ -H "Content-Type: application/json" \ - -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":1,"capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}' \ + -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":1,"clientCapabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}' \ | grep -i 'acp-connection-id' | awk '{print $2}' | tr -d '\r') echo "Connection ID: $CONN_ID" diff --git a/website/i18n/es/docusaurus-plugin-content-docs/current/acp/protocol-reference.md b/website/i18n/es/docusaurus-plugin-content-docs/current/acp/protocol-reference.md index 15fd89c7..6093dd9a 100644 --- a/website/i18n/es/docusaurus-plugin-content-docs/current/acp/protocol-reference.md +++ b/website/i18n/es/docusaurus-plugin-content-docs/current/acp/protocol-reference.md @@ -64,6 +64,8 @@ Handshake del protocolo. Debe ser la primera llamada en cada conexion. | `promptCapabilities.embeddedContext` | `true` | Acepta contenido de recursos incrustados en prompts | | `promptCapabilities.image` | `false` | Entrada de imagen no soportada (degrada a marcador de texto) | | `promptCapabilities.audio` | `false` | Entrada de audio no soportada (degrada a marcador de texto) | +| `mcpCapabilities.http` | `true` | Acepta servidores MCP HTTP/streamable en la creación de la sesión | +| `mcpCapabilities.sse` | `true` | Acepta servidores MCP SSE en la creación de la sesión | | `sessionCapabilities.list` | `{}` | Soporta listar sesiones | | `sessionCapabilities.close` | `{}` | Soporta cerrar sesiones | @@ -78,7 +80,7 @@ Crea una nueva sesion con un runtime de agente independiente, registro de herram | Campo | Tipo | Requerido | Descripcion | |-------|------|----------|-------------| | `cwd` | string | Si | Ruta absoluta al directorio de trabajo | -| `mcpServers` | object | No | Configuracion de servidores MCP (aceptada pero aun no funcional) | +| `mcpServers` | object | No | Configuracion de servidores MCP; los servidores HTTP (streamable) y SSE se conectan para la sesion | **Campos de respuesta** @@ -189,7 +191,7 @@ Envia entrada del usuario y activa respuestas de streaming del agente. | Campo | Tipo | Descripcion | |-------|------|-------------| | `stopReason` | string | Por que se completo el prompt (ver Razones de parada) | -| `usage` | object | Uso de tokens: `inputTokens`, `outputTokens`, `totalTokens` | +| `_meta.usage` | object | Uso de tokens bajo el objeto `_meta` de la respuesta: `input_tokens`, `output_tokens`, `total_tokens` | **Razones de parada** @@ -243,7 +245,7 @@ Cierra una sesion y libera sus recursos. --- -### sessions/list +### session/list Lista todas las sesiones persistidas para un directorio de trabajo dado. @@ -261,7 +263,7 @@ Lista todas las sesiones persistidas para un directorio de trabajo dado. --- -### config/set +### session/set_config_option Establece dinamicamente una opcion de configuracion para una sesion. @@ -371,8 +373,8 @@ Para `aliyun_api`, las acciones de solo lectura se permiten automáticamente. La ```json { - "outcome": "allowed", - "option_id": "allow_once" + "outcome": "selected", + "optionId": "allow_once" } ``` @@ -380,7 +382,7 @@ O para denegar: ```json { - "outcome": "denied" + "outcome": "cancelled" } ``` diff --git a/website/i18n/es/docusaurus-plugin-content-docs/current/cli/command-line-options.md b/website/i18n/es/docusaurus-plugin-content-docs/current/cli/command-line-options.md index 14be7985..897b7e3b 100644 --- a/website/i18n/es/docusaurus-plugin-content-docs/current/cli/command-line-options.md +++ b/website/i18n/es/docusaurus-plugin-content-docs/current/cli/command-line-options.md @@ -17,6 +17,7 @@ Las opciones de línea de comandos cambian cómo se inicia IaC Code. Úselas ant | `--max-turns ` | Limitar el número máximo de turnos del agente en modo no interactivo. El valor predeterminado es `100`. | | `--thinking-enabled`, `--no-thinking-enabled` | Controla si las solicitudes no interactivas de una sola ejecucion habilitan explicitamente thinking. El valor predeterminado es `--thinking-enabled`; usa `--no-thinking-enabled` para enviar `thinking_enabled=false` en esta ejecucion sin reescribir `settings.yml`. | | `-d`, `--debug` | Habilitar el registro de depuración para la ejecución actual. En modo interactivo, use `/debug` para inspeccionar o cambiar el registro de depuración después del inicio. | +| `--verbose` | Mostrar el progreso del modo headless (no interactivo) en la salida de error estándar. | | `-r `, `--resume ` | Reanudar una sesión anterior por ID exacto, prefijo único de ID o nombre único de sesión. Las sesiones resueltas en otro proyecto imprimen un comando `cd ... && iac-code --resume ` en lugar de cambiar en caliente el proyecto actual. | | `-c`, `--continue` | Reanudar la sesión más reciente. No se puede usar junto con `--resume`. | | `--allowed-tools ` | Patrones de permisos de herramientas separados por comas para permitir, ej. `'bash(git *),write_file'`. | @@ -47,7 +48,7 @@ iac-code Iniciar con un modelo específico para esta ejecución: ```bash -iac-code --model qwen3.6-plus +iac-code --model qwen3.7-max ``` Ejecutar un prompt único: diff --git a/website/i18n/es/docusaurus-plugin-content-docs/current/cli/skills.md b/website/i18n/es/docusaurus-plugin-content-docs/current/cli/skills.md index 0cd3e1d3..4810ae4a 100644 --- a/website/i18n/es/docusaurus-plugin-content-docs/current/cli/skills.md +++ b/website/i18n/es/docusaurus-plugin-content-docs/current/cli/skills.md @@ -9,24 +9,12 @@ Skills are reusable prompt templates that extend IaC Code with custom slash comm ## Skill File Formats -Skills are defined as Markdown files with YAML frontmatter. Two formats are supported: - -### Single File - -A standalone Markdown file named after the skill: - -```text -skills/ - deploy-check.md - code-review.md -``` - -### Directory - -A directory containing a `SKILL.md` file, useful when the skill needs additional reference files: +A skill is a directory containing a `SKILL.md` file. The directory name is the skill's default name. The directory can also hold additional reference files: ```text skills/ + deploy-check/ + SKILL.md my-skill/ SKILL.md references/ @@ -35,16 +23,16 @@ skills/ ## Discovery and Priority -IaC Code discovers skills from multiple locations. When skills share the same name, later sources override earlier ones: +IaC Code discovers skills from multiple locations. When skills share the same name, higher-priority sources override lower-priority ones: | Priority | Location | Description | |----------|----------|-------------| -| 1 (lowest) | Bundled | Built-in skills shipped with IaC Code | -| 2 | `~/.iac-code/skills/` | User-global skills (follows `IAC_CODE_CONFIG_DIR`) | -| 3 | `skills/` | Project-level skills directory | -| 4 (highest) | `.iac-code/skills/` | Project config-level skills directory | +| 1 (lowest) | `~/.iac-code/skills/` | User-global skills (follows `IAC_CODE_CONFIG_DIR`) | +| 2 | `skills/` | Project-level skills directory | +| 3 | `.iac-code/skills/` | Project config-level skills directory | +| 4 (highest) | Bundled | Built-in skills shipped with IaC Code; cannot be shadowed by same-name user or project skills | -Project skill directories are searched upward from the current working directory to the filesystem root. +Project skill directories are searched from the git repository root down to the current working directory. When not inside a git repository, only the current directory is searched. ## Frontmatter Reference @@ -81,7 +69,7 @@ paths: | `when_to_use` | No | `""` | Hint for the model on when to invoke this skill automatically | | `argument_hint` | No | `""` | Placeholder shown after the command name | | `arguments` | No | `[]` | Named argument list for positional substitution | -| `allowed_tools` | No | `[]` | Tools the skill is allowed to use (applies to fork mode) | +| `allowed_tools` | No | `[]` | Tools the skill is allowed to use (applies to both inline and fork modes) | | `user_invocable` | No | `true` | Whether the user can invoke this skill directly via `/name` (or `$name`) | | `model` | No | `"inherit"` | Model override for this skill execution | | `effort` | No | `""` | Thinking effort override | @@ -189,7 +177,7 @@ Review the current project and generate a pre-deployment checklist covering: If a stack name is provided, also check the current stack status. ``` -Save this as `~/.iac-code/skills/checklist.md` or `.iac-code/skills/checklist.md` in your project. Then invoke it with `/checklist` in the REPL — or with `$checklist`, which is identical but filters autocomplete suggestions to skills only. +Save this as `~/.iac-code/skills/checklist/SKILL.md` or `.iac-code/skills/checklist/SKILL.md` in your project. Then invoke it with `/checklist` in the REPL — or with `$checklist`, which is identical but filters autocomplete suggestions to skills only. ## Permissions diff --git a/website/i18n/es/docusaurus-plugin-content-docs/current/configuration/environment-variables.md b/website/i18n/es/docusaurus-plugin-content-docs/current/configuration/environment-variables.md index 76b64498..f7d6614c 100644 --- a/website/i18n/es/docusaurus-plugin-content-docs/current/configuration/environment-variables.md +++ b/website/i18n/es/docusaurus-plugin-content-docs/current/configuration/environment-variables.md @@ -19,7 +19,7 @@ Las variables de entorno son utiles para pipelines de CI/CD, contenedores y sobr |---|---| | `IAC_CODE_PROVIDER` | Nombre del proveedor de modelos (sin distincion de mayusculas/minusculas). Valores validos: `DashScope`, `DashScope Token Plan`, `OpenAI`, `Anthropic`, `DeepSeek`, `Gemini`, `Azure OpenAI`, `ModelScope`, `Kimi CN`, `Kimi Intl`, `MiniMax CN`, `MiniMax Intl`, `ZhiPu CN`, `ZhiPu Intl`, `Volcengine CN`, `SiliconFlow CN`, `SiliconFlow Intl`, `Aliyun CodingPlan`, `Aliyun CodingPlan Intl`, `ZhiPu CN CodingPlan`, `ZhiPu Intl CodingPlan`, `Volcengine CodingPlan`, `OpenAPI Compatible`, `Anthropic Compatible`, `OpenRouter`, `Ollama`, `LM Studio` | | `IAC_CODE_MODEL` | Nombre del modelo | -| `IAC_CODE_BASE_URL` | Endpoint de API para `OpenAPI Compatible` y `Anthropic Compatible` solamente; se ignora para otros proveedores | +| `IAC_CODE_BASE_URL` | Endpoint de API que se aplica únicamente a `OpenAPI Compatible`; se ignora (con una advertencia) para otros proveedores | | `IAC_CODE_API_KEY` | Clave API del proveedor; sobreescribe la clave del proveedor activo en `.credentials.yml` | Consulta [Proveedores de LLM](./llm-providers.md) para mas detalles sobre los proveedores. diff --git a/website/i18n/es/docusaurus-plugin-content-docs/current/configuration/llm-providers.md b/website/i18n/es/docusaurus-plugin-content-docs/current/configuration/llm-providers.md index 0b1a2bec..4c9c4661 100644 --- a/website/i18n/es/docusaurus-plugin-content-docs/current/configuration/llm-providers.md +++ b/website/i18n/es/docusaurus-plugin-content-docs/current/configuration/llm-providers.md @@ -74,5 +74,5 @@ CLI arguments > environment variables > configuration files |---|---| | `IAC_CODE_PROVIDER` | Nombre del proveedor de modelos (sin distincion de mayusculas/minusculas). Consulta las tablas anteriores para valores validos | | `IAC_CODE_MODEL` | Nombre del modelo | -| `IAC_CODE_BASE_URL` | Endpoint de API para `OpenAPI Compatible` y `Anthropic Compatible` solamente; se ignora para otros proveedores | +| `IAC_CODE_BASE_URL` | Endpoint de API que se aplica únicamente a `OpenAPI Compatible`; se ignora (con una advertencia) para otros proveedores | | `IAC_CODE_API_KEY` | Clave API del proveedor | diff --git a/website/i18n/es/docusaurus-plugin-content-docs/current/intro.md b/website/i18n/es/docusaurus-plugin-content-docs/current/intro.md index 2d645ef7..7aa6bb32 100644 --- a/website/i18n/es/docusaurus-plugin-content-docs/current/intro.md +++ b/website/i18n/es/docusaurus-plugin-content-docs/current/intro.md @@ -10,8 +10,8 @@ IaC Code es un asistente de Infraestructura como Codigo potenciado por IA para i Capacidades principales: -- **Dilo y despliegalo** — describe lo que necesitas en lenguaje natural y obtendras plantillas de ROS o Terraform validadas y listas para desplegar. -- **Un comando a produccion** — pasa de la plantilla a la infraestructura y las aplicaciones en ejecucion en un solo flujo; crea, actualiza, elimina y monitorea stacks en distintas regiones. +- **Dilo y despliegalo** — describe lo que necesitas en lenguaje natural y obtendras plantillas de ROS validadas y listas para desplegar, o plantillas de Terraform generadas. +- **De la plantilla a produccion** — para Alibaba Cloud ROS, pasa de la plantilla a la infraestructura en ejecucion: crea, actualiza, elimina y monitorea stacks en distintas regiones. El soporte de Terraform cubre la generacion y conversion de plantillas, no el despliegue. - **Inteligencia de nube integrada** — consulta documentacion, verifica la disponibilidad de recursos y estima costos antes de desplegar; cada decision respaldada por datos reales de la nube. La documentacion esta organizada en torno a las tareas del usuario. Comienza con la instalacion y el inicio rapido, luego configura los proveedores y las credenciales, y usa la referencia del CLI cuando necesites detalles sobre los comandos. diff --git a/website/i18n/es/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md b/website/i18n/es/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md index f1a7e5e0..46764193 100644 --- a/website/i18n/es/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md +++ b/website/i18n/es/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md @@ -85,7 +85,7 @@ Los modos headless y servidor de protocolo omiten servidores de proyecto no apro IaC Code protege secretos de varias maneras: - La salida de `iac-code mcp get` redacta claves que parecen tokens, secrets, passwords, API keys y authorization headers. -- Los valores sensibles de headers o env en texto claro se rechazan salvo que usen una referencia a variable de entorno. +- Los valores sensibles de headers o env en texto claro se rechazan solo al añadir servidores mediante `iac-code mcp add` / `mcp add-json` (salvo que usen una referencia a variable de entorno); los archivos de configuración editados a mano no se vuelven a validar al cargarse, así que evita almacenar secretos en texto claro directamente. - Los servidores MCP stdio heredan solo una allowlist de variables de entorno seguras más el env explícito del servidor. - Las variables proxy con usernames o passwords no se heredan por servidores MCP stdio. - Los archivos de artefactos MCP se escriben bajo el directorio privado de configuración runtime de IaC Code. diff --git a/website/i18n/es/docusaurus-plugin-content-docs/current/mcp/overview.md b/website/i18n/es/docusaurus-plugin-content-docs/current/mcp/overview.md index 5d8f69ab..71504615 100644 --- a/website/i18n/es/docusaurus-plugin-content-docs/current/mcp/overview.md +++ b/website/i18n/es/docusaurus-plugin-content-docs/current/mcp/overview.md @@ -43,7 +43,7 @@ Usa MCP cuando quieras que IaC Code llame a una capacidad local o remota que no En tiempo de ejecución, IaC Code: -1. Carga configuración MCP desde fuentes de usuario, locales, de proyecto y de sesión. +1. Carga configuración MCP desde fuentes de usuario, de proyecto, locales y de sesión. 2. Expande referencias `${VAR}` y `${VAR:-default}`. 3. Omite servidores inseguros o inválidos con advertencias visibles para el usuario. 4. Conecta servidores aprobados con concurrencia limitada. diff --git a/website/i18n/fr/docusaurus-plugin-content-docs/current/acp/examples.md b/website/i18n/fr/docusaurus-plugin-content-docs/current/acp/examples.md index ddc3fa01..c6420bf5 100644 --- a/website/i18n/fr/docusaurus-plugin-content-docs/current/acp/examples.md +++ b/website/i18n/fr/docusaurus-plugin-content-docs/current/acp/examples.md @@ -265,7 +265,7 @@ async def main(): "params": { "protocolVersion": 1, "clientInfo": {"name": "http-client", "version": "1.0"}, - "capabilities": {} + "clientCapabilities": {} } }, headers=HEADERS) resp.raise_for_status() diff --git a/website/i18n/fr/docusaurus-plugin-content-docs/current/acp/http-transport.md b/website/i18n/fr/docusaurus-plugin-content-docs/current/acp/http-transport.md index 5e69a974..33d085e6 100644 --- a/website/i18n/fr/docusaurus-plugin-content-docs/current/acp/http-transport.md +++ b/website/i18n/fr/docusaurus-plugin-content-docs/current/acp/http-transport.md @@ -102,7 +102,7 @@ Voici une interaction complète utilisant `curl` : # Step 1: Initialize — creates a connection and returns the Connection ID CONN_ID=$(curl -s -D - -X POST http://localhost:8765/acp \ -H "Content-Type: application/json" \ - -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":1,"capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}' \ + -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":1,"clientCapabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}' \ | grep -i 'acp-connection-id' | awk '{print $2}' | tr -d '\r') echo "Connection ID: $CONN_ID" diff --git a/website/i18n/fr/docusaurus-plugin-content-docs/current/acp/protocol-reference.md b/website/i18n/fr/docusaurus-plugin-content-docs/current/acp/protocol-reference.md index dfc09696..f720256d 100644 --- a/website/i18n/fr/docusaurus-plugin-content-docs/current/acp/protocol-reference.md +++ b/website/i18n/fr/docusaurus-plugin-content-docs/current/acp/protocol-reference.md @@ -64,6 +64,8 @@ Poignée de main du protocole. Doit être le premier appel sur chaque connexion. | `promptCapabilities.embeddedContext` | `true` | Accepte le contenu de ressources embarquées dans les requêtes | | `promptCapabilities.image` | `false` | Entrée image non prise en charge (dégradée en marqueur texte) | | `promptCapabilities.audio` | `false` | Entrée audio non prise en charge (dégradée en marqueur texte) | +| `mcpCapabilities.http` | `true` | Accepte les serveurs MCP HTTP/streamable lors de la création de session | +| `mcpCapabilities.sse` | `true` | Accepte les serveurs MCP SSE lors de la création de session | | `sessionCapabilities.list` | `{}` | Prend en charge le listage des sessions | | `sessionCapabilities.close` | `{}` | Prend en charge la fermeture des sessions | @@ -78,7 +80,7 @@ Créer une nouvelle session avec un runtime d'agent indépendant, un registre d' | Champ | Type | Requis | Description | |-------|------|----------|-------------| | `cwd` | string | Oui | Chemin absolu vers le répertoire de travail | -| `mcpServers` | object | Non | Configuration du serveur MCP (acceptée mais pas encore fonctionnelle) | +| `mcpServers` | object | Non | Configuration du serveur MCP ; les serveurs HTTP (streamable) et SSE sont connectés pour la session | **Champs de réponse** @@ -189,7 +191,7 @@ Envoyer l'entrée utilisateur et déclencher les réponses de l'agent en streami | Champ | Type | Description | |-------|------|-------------| | `stopReason` | string | Raison de la fin de la requête (voir Raisons d'arrêt) | -| `usage` | object | Utilisation des tokens : `inputTokens`, `outputTokens`, `totalTokens` | +| `_meta.usage` | object | Utilisation des tokens sous l'objet `_meta` de la réponse : `input_tokens`, `output_tokens`, `total_tokens` | **Raisons d'arrêt** @@ -243,7 +245,7 @@ Fermer une session et libérer ses ressources. --- -### sessions/list +### session/list Lister toutes les sessions persistées pour un répertoire de travail donné. @@ -261,7 +263,7 @@ Lister toutes les sessions persistées pour un répertoire de travail donné. --- -### config/set +### session/set_config_option Définir dynamiquement une option de configuration pour une session. @@ -371,8 +373,8 @@ Pour `aliyun_api`, les actions en lecture seule sont autorisées automatiquement ```json { - "outcome": "allowed", - "option_id": "allow_once" + "outcome": "selected", + "optionId": "allow_once" } ``` @@ -380,7 +382,7 @@ Ou pour refuser : ```json { - "outcome": "denied" + "outcome": "cancelled" } ``` diff --git a/website/i18n/fr/docusaurus-plugin-content-docs/current/cli/command-line-options.md b/website/i18n/fr/docusaurus-plugin-content-docs/current/cli/command-line-options.md index 67892452..62520e51 100644 --- a/website/i18n/fr/docusaurus-plugin-content-docs/current/cli/command-line-options.md +++ b/website/i18n/fr/docusaurus-plugin-content-docs/current/cli/command-line-options.md @@ -17,6 +17,7 @@ Les options de ligne de commande modifient le démarrage d'IaC Code. Utilisez-le | `--max-turns ` | Limiter le nombre maximum de tours de l'agent en mode non interactif. La valeur par défaut est `100`. | | `--thinking-enabled`, `--no-thinking-enabled` | Contrôler si les requêtes non interactives ponctuelles activent explicitement le thinking. La valeur par défaut est `--thinking-enabled` ; utilisez `--no-thinking-enabled` pour envoyer `thinking_enabled=false` pour cette exécution sans réécrire `settings.yml`. | | `-d`, `--debug` | Activer la journalisation de débogage pour l'exécution en cours. En mode interactif, utilisez `/debug` pour inspecter ou modifier la journalisation de débogage après le démarrage. | +| `--verbose` | Afficher la progression du mode headless (non interactif) sur la sortie d'erreur standard. | | `-r `, `--resume ` | Reprendre une session précédente par identifiant exact, préfixe d'identifiant unique ou nom de session unique. Les sessions résolues dans un autre projet affichent une commande `cd ... && iac-code --resume ` au lieu de basculer le projet courant à chaud. | | `-c`, `--continue` | Reprendre la session la plus récente. Ne peut pas être utilisé avec `--resume`. | | `--allowed-tools ` | Modèles de permissions d'outils séparés par des virgules à autoriser, ex. `'bash(git *),write_file'`. | @@ -47,7 +48,7 @@ iac-code Démarrer avec un modèle spécifique pour cette exécution : ```bash -iac-code --model qwen3.6-plus +iac-code --model qwen3.7-max ``` Exécuter un prompt unique : diff --git a/website/i18n/fr/docusaurus-plugin-content-docs/current/cli/skills.md b/website/i18n/fr/docusaurus-plugin-content-docs/current/cli/skills.md index 7a07e167..14fabd6d 100644 --- a/website/i18n/fr/docusaurus-plugin-content-docs/current/cli/skills.md +++ b/website/i18n/fr/docusaurus-plugin-content-docs/current/cli/skills.md @@ -7,44 +7,32 @@ description: Create and use reusable prompt templates as slash commands. Skills are reusable prompt templates that extend IaC Code with custom slash commands. They let you package complex instructions, tool configurations, and workflow patterns into named commands that can be invoked during a conversation. -## Skill File Formats +## Format des fichiers de compétence -Skills are defined as Markdown files with YAML frontmatter. Two formats are supported: - -### Single File - -A standalone Markdown file named after the skill: - -```text -skills/ - deploy-check.md - code-review.md -``` - -### Directory - -A directory containing a `SKILL.md` file, useful when the skill needs additional reference files: +Une compétence est un répertoire contenant un fichier `SKILL.md`. Le nom du répertoire sert de nom de compétence par défaut. Le répertoire peut aussi contenir des fichiers de référence supplémentaires : ```text skills/ + deploy-check/ + SKILL.md my-skill/ SKILL.md references/ template.yml ``` -## Discovery and Priority +## Découverte et priorité -IaC Code discovers skills from multiple locations. When skills share the same name, later sources override earlier ones: +IaC Code découvre les compétences depuis plusieurs emplacements. Lorsque des compétences partagent le même nom, les sources de priorité plus élevée remplacent celles de priorité plus faible : -| Priority | Location | Description | +| Priorité | Emplacement | Description | |----------|----------|-------------| -| 1 (lowest) | Bundled | Built-in skills shipped with IaC Code | -| 2 | `~/.iac-code/skills/` | User-global skills (follows `IAC_CODE_CONFIG_DIR`) | -| 3 | `skills/` | Project-level skills directory | -| 4 (highest) | `.iac-code/skills/` | Project config-level skills directory | +| 1 (la plus faible) | `~/.iac-code/skills/` | Compétences globales utilisateur (suit `IAC_CODE_CONFIG_DIR`) | +| 2 | `skills/` | Répertoire de compétences au niveau du projet | +| 3 | `.iac-code/skills/` | Répertoire de compétences au niveau de la configuration du projet | +| 4 (la plus élevée) | Intégrées | Compétences intégrées livrées avec IaC Code ; elles ne peuvent pas être masquées par des compétences utilisateur ou projet portant le même nom | -Project skill directories are searched upward from the current working directory to the filesystem root. +Les répertoires de compétences de projet sont recherchés depuis la racine du dépôt git jusqu'au répertoire de travail courant ; en dehors d'un dépôt git, seul le répertoire courant est recherché. ## Frontmatter Reference @@ -81,7 +69,7 @@ paths: | `when_to_use` | No | `""` | Hint for the model on when to invoke this skill automatically | | `argument_hint` | No | `""` | Placeholder shown after the command name | | `arguments` | No | `[]` | Named argument list for positional substitution | -| `allowed_tools` | No | `[]` | Tools the skill is allowed to use (applies to fork mode) | +| `allowed_tools` | No | `[]` | Tools the skill is allowed to use (applies to both inline and fork modes) | | `user_invocable` | No | `true` | Whether the user can invoke this skill directly via `/name` (or `$name`) | | `model` | No | `"inherit"` | Model override for this skill execution | | `effort` | No | `""` | Thinking effort override | @@ -189,7 +177,7 @@ Review the current project and generate a pre-deployment checklist covering: If a stack name is provided, also check the current stack status. ``` -Save this as `~/.iac-code/skills/checklist.md` or `.iac-code/skills/checklist.md` in your project. Then invoke it with `/checklist` in the REPL — or with `$checklist`, which is identical but filters autocomplete suggestions to skills only. +Save this as `~/.iac-code/skills/checklist/SKILL.md` or `.iac-code/skills/checklist/SKILL.md` in your project. Then invoke it with `/checklist` in the REPL — or with `$checklist`, which is identical but filters autocomplete suggestions to skills only. ## Permissions diff --git a/website/i18n/fr/docusaurus-plugin-content-docs/current/configuration/environment-variables.md b/website/i18n/fr/docusaurus-plugin-content-docs/current/configuration/environment-variables.md index fb7a0db5..4f4648e1 100644 --- a/website/i18n/fr/docusaurus-plugin-content-docs/current/configuration/environment-variables.md +++ b/website/i18n/fr/docusaurus-plugin-content-docs/current/configuration/environment-variables.md @@ -19,7 +19,7 @@ Les variables d'environnement sont utiles pour les pipelines CI/CD, les conteneu |---|---| | `IAC_CODE_PROVIDER` | Nom du fournisseur de modèles (insensible à la casse). Valeurs valides : `DashScope`, `DashScope Token Plan`, `OpenAI`, `Anthropic`, `DeepSeek`, `Gemini`, `Azure OpenAI`, `ModelScope`, `Kimi CN`, `Kimi Intl`, `MiniMax CN`, `MiniMax Intl`, `ZhiPu CN`, `ZhiPu Intl`, `Volcengine CN`, `SiliconFlow CN`, `SiliconFlow Intl`, `Aliyun CodingPlan`, `Aliyun CodingPlan Intl`, `ZhiPu CN CodingPlan`, `ZhiPu Intl CodingPlan`, `Volcengine CodingPlan`, `OpenAPI Compatible`, `Anthropic Compatible`, `OpenRouter`, `Ollama`, `LM Studio` | | `IAC_CODE_MODEL` | Nom du modèle | -| `IAC_CODE_BASE_URL` | Point de terminaison API pour `OpenAPI Compatible` et `Anthropic Compatible` uniquement ; ignoré pour les autres fournisseurs | +| `IAC_CODE_BASE_URL` | Point de terminaison API pour `OpenAPI Compatible` uniquement ; ignoré (avec un avertissement) pour les autres fournisseurs | | `IAC_CODE_API_KEY` | Clé API du fournisseur ; remplace la clé du fournisseur actif dans `.credentials.yml` | Consultez [Fournisseurs LLM](./llm-providers.md) pour les détails des fournisseurs. diff --git a/website/i18n/fr/docusaurus-plugin-content-docs/current/configuration/llm-providers.md b/website/i18n/fr/docusaurus-plugin-content-docs/current/configuration/llm-providers.md index 143d8731..1a862b97 100644 --- a/website/i18n/fr/docusaurus-plugin-content-docs/current/configuration/llm-providers.md +++ b/website/i18n/fr/docusaurus-plugin-content-docs/current/configuration/llm-providers.md @@ -74,5 +74,5 @@ CLI arguments > environment variables > configuration files |---|---| | `IAC_CODE_PROVIDER` | Nom du fournisseur de modèles (insensible à la casse). Consultez les tableaux ci-dessus pour les valeurs valides | | `IAC_CODE_MODEL` | Nom du modèle | -| `IAC_CODE_BASE_URL` | Point de terminaison API pour `OpenAPI Compatible` et `Anthropic Compatible` uniquement ; ignoré pour les autres fournisseurs | +| `IAC_CODE_BASE_URL` | Point de terminaison API pour `OpenAPI Compatible` uniquement ; ignoré (avec un avertissement) pour les autres fournisseurs | | `IAC_CODE_API_KEY` | Clé API du fournisseur | diff --git a/website/i18n/fr/docusaurus-plugin-content-docs/current/intro.md b/website/i18n/fr/docusaurus-plugin-content-docs/current/intro.md index c637d453..6c4b7d3e 100644 --- a/website/i18n/fr/docusaurus-plugin-content-docs/current/intro.md +++ b/website/i18n/fr/docusaurus-plugin-content-docs/current/intro.md @@ -10,8 +10,8 @@ IaC Code est un assistant d'Infrastructure as Code alimenté par l'IA pour l'inf Capacités principales : -- **Décrivez, déployez** -- décrivez ce dont vous avez besoin en langage naturel et obtenez des templates ROS ou Terraform validés, prêts au déploiement. -- **Une commande pour la production** -- passez du template à l'infrastructure et aux applications en production en un seul flux ; créez, mettez à jour, supprimez et surveillez les stacks dans toutes les régions. +- **Décrivez, déployez** -- décrivez ce dont vous avez besoin en langage naturel et obtenez des templates ROS validés, prêts au déploiement, ou des templates Terraform générés. +- **Du template à l'infrastructure** -- pour Alibaba Cloud ROS, passez du template à l'infrastructure en cours d'exécution ; créez, mettez à jour, supprimez et surveillez les stacks dans toutes les régions. La prise en charge de Terraform couvre la génération et la conversion de templates, pas le déploiement. - **Intelligence cloud intégrée** -- recherchez dans la documentation, vérifiez la disponibilité des ressources et estimez les coûts avant de déployer ; chaque décision est étayée par des données cloud réelles. La documentation est organisée autour des tâches utilisateur. Commencez par l'installation et le démarrage rapide, puis configurez les fournisseurs et les identifiants, puis utilisez la référence CLI lorsque vous avez besoin de détails sur les commandes. diff --git a/website/i18n/fr/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md b/website/i18n/fr/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md index 6734fe05..6b4492b3 100644 --- a/website/i18n/fr/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md +++ b/website/i18n/fr/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md @@ -85,7 +85,7 @@ Les modes headless et serveur de protocole ignorent les serveurs de projet non a IaC Code protège les secrets de plusieurs façons : - La sortie de `iac-code mcp get` masque les clés qui ressemblent à des tokens, secrets, mots de passe, clés API et headers d'autorisation. -- Les valeurs sensibles de headers ou env en clair sont rejetées sauf si elles utilisent une référence à une variable d'environnement. +- Les valeurs sensibles de headers ou env en clair sont rejetées uniquement lors de l'ajout de serveurs via `iac-code mcp add` / `mcp add-json` (sauf si elles utilisent une référence à une variable d'environnement) ; les fichiers de configuration modifiés à la main ne sont PAS re-validés au chargement, donc évitez d'y stocker des secrets en clair directement. - Les serveurs MCP stdio héritent seulement d'une allowlist de variables d'environnement sûres plus l'env explicite du serveur. - Les variables proxy contenant un nom d'utilisateur ou un mot de passe ne sont pas héritées par les serveurs MCP stdio. - Les fichiers d'artefact MCP sont écrits sous le répertoire privé de configuration runtime de IaC Code. diff --git a/website/i18n/fr/docusaurus-plugin-content-docs/current/mcp/overview.md b/website/i18n/fr/docusaurus-plugin-content-docs/current/mcp/overview.md index 021a3534..013233f3 100644 --- a/website/i18n/fr/docusaurus-plugin-content-docs/current/mcp/overview.md +++ b/website/i18n/fr/docusaurus-plugin-content-docs/current/mcp/overview.md @@ -43,7 +43,7 @@ Utilisez MCP lorsque vous voulez que IaC Code appelle une capacité locale ou di À l'exécution, IaC Code : -1. Charge la configuration MCP depuis les sources utilisateur, locales, projet et session. +1. Charge la configuration MCP depuis les sources utilisateur, projet, locales et session. 2. Développe les références `${VAR}` et `${VAR:-default}`. 3. Ignore les serveurs non sûrs ou invalides avec des avertissements visibles par l'utilisateur. 4. Se connecte aux serveurs approuvés avec une concurrence bornée. diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/current/acp/examples.md b/website/i18n/ja/docusaurus-plugin-content-docs/current/acp/examples.md index f03aa3c6..6bf312c5 100644 --- a/website/i18n/ja/docusaurus-plugin-content-docs/current/acp/examples.md +++ b/website/i18n/ja/docusaurus-plugin-content-docs/current/acp/examples.md @@ -265,7 +265,7 @@ async def main(): "params": { "protocolVersion": 1, "clientInfo": {"name": "http-client", "version": "1.0"}, - "capabilities": {} + "clientCapabilities": {} } }, headers=HEADERS) resp.raise_for_status() diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/current/acp/http-transport.md b/website/i18n/ja/docusaurus-plugin-content-docs/current/acp/http-transport.md index 8ebadb90..050b8114 100644 --- a/website/i18n/ja/docusaurus-plugin-content-docs/current/acp/http-transport.md +++ b/website/i18n/ja/docusaurus-plugin-content-docs/current/acp/http-transport.md @@ -102,7 +102,7 @@ Authorization: Bearer your-secret-token # Step 1: Initialize — creates a connection and returns the Connection ID CONN_ID=$(curl -s -D - -X POST http://localhost:8765/acp \ -H "Content-Type: application/json" \ - -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":1,"capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}' \ + -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":1,"clientCapabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}' \ | grep -i 'acp-connection-id' | awk '{print $2}' | tr -d '\r') echo "Connection ID: $CONN_ID" diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/current/acp/protocol-reference.md b/website/i18n/ja/docusaurus-plugin-content-docs/current/acp/protocol-reference.md index 78db62d5..5f15f2ab 100644 --- a/website/i18n/ja/docusaurus-plugin-content-docs/current/acp/protocol-reference.md +++ b/website/i18n/ja/docusaurus-plugin-content-docs/current/acp/protocol-reference.md @@ -64,6 +64,8 @@ ACP セッションは、対話実行および headless 実行と同じ v2 セ | `promptCapabilities.embeddedContext` | `true` | プロンプトに埋め込みリソースコンテンツを受け入れ | | `promptCapabilities.image` | `false` | 画像入力は未サポート（テキストマーカーにフォールバック） | | `promptCapabilities.audio` | `false` | 音声入力は未サポート（テキストマーカーにフォールバック） | +| `mcpCapabilities.http` | `true` | セッション作成時に HTTP（streamable）MCP サーバーを受け入れ | +| `mcpCapabilities.sse` | `true` | セッション作成時に SSE MCP サーバーを受け入れ | | `sessionCapabilities.list` | `{}` | セッション一覧をサポート | | `sessionCapabilities.close` | `{}` | セッションのクローズをサポート | @@ -78,7 +80,7 @@ ACP セッションは、対話実行および headless 実行と同じ v2 セ | フィールド | 型 | 必須 | 説明 | |-------|------|----------|-------------| | `cwd` | string | はい | 作業ディレクトリの絶対パス | -| `mcpServers` | object | いいえ | MCP サーバー設定（受け入れられますがまだ機能しません） | +| `mcpServers` | object | いいえ | MCP サーバー設定。HTTP（streamable）と SSE サーバーはそのセッションで接続されます | **レスポンスフィールド** @@ -189,7 +191,7 @@ ACP セッションは、対話実行および headless 実行と同じ v2 セ | フィールド | 型 | 説明 | |-------|------|-------------| | `stopReason` | string | プロンプトが完了した理由（停止理由を参照） | -| `usage` | object | トークン使用量：`inputTokens`、`outputTokens`、`totalTokens` | +| `_meta.usage` | object | トークン使用量。レスポンスの `_meta` オブジェクト配下に `input_tokens`、`output_tokens`、`total_tokens` のキーで配信されます | **停止理由** @@ -243,7 +245,7 @@ ACP セッションは、対話実行および headless 実行と同じ v2 セ --- -### sessions/list +### session/list 指定された作業ディレクトリのすべての永続化されたセッションを一覧表示します。 @@ -261,7 +263,7 @@ ACP セッションは、対話実行および headless 実行と同じ v2 セ --- -### config/set +### session/set_config_option セッションの設定オプションを動的に設定します。 @@ -371,8 +373,8 @@ ToolCallStart (status=in_progress) ```json { - "outcome": "allowed", - "option_id": "allow_once" + "outcome": "selected", + "optionId": "allow_once" } ``` @@ -380,7 +382,7 @@ ToolCallStart (status=in_progress) ```json { - "outcome": "denied" + "outcome": "cancelled" } ``` diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/current/cli/command-line-options.md b/website/i18n/ja/docusaurus-plugin-content-docs/current/cli/command-line-options.md index 4c638496..9e8f3499 100644 --- a/website/i18n/ja/docusaurus-plugin-content-docs/current/cli/command-line-options.md +++ b/website/i18n/ja/docusaurus-plugin-content-docs/current/cli/command-line-options.md @@ -17,6 +17,7 @@ description: IaC Code の起動オプションとワンショット実行パラ | `--max-turns ` | 非対話モードでのエージェントの最大ターン数を制限します。デフォルトは `100` です。 | | `--thinking-enabled`, `--no-thinking-enabled` | ワンショットの非対話リクエストで thinking を明示的に有効化するかどうかを制御します。デフォルトは `--thinking-enabled` です。`--no-thinking-enabled` はこの実行だけ `thinking_enabled=false` を送信し、`settings.yml` は書き換えません。 | | `-d`, `--debug` | 今回の実行でデバッグログを有効にします。対話モードでは、起動後に `/debug` を使用してデバッグログを確認または変更できます。 | +| `--verbose` | ヘッドレス（非対話）実行の進捗を標準エラー出力に表示します。 | | `-r <セッションIDまたは名前>`, `--resume <セッションIDまたは名前>` | 正確なセッション ID、一意な ID プレフィックス、または一意なセッション名で以前のセッションを再開します。別プロジェクトとして解決されたセッションは、現在のプロジェクトをその場で切り替えず、`cd ... && iac-code --resume ` コマンドを表示します。 | | `-c`, `--continue` | 最新のセッションを再開します。`--resume` と同時に使用できません。 | | `--allowed-tools ` | 許可するツール権限パターンをカンマ区切りで指定します。例：`'bash(git *),write_file'`。 | @@ -47,7 +48,7 @@ iac-code 今回の実行で特定のモデルを指定する： ```bash -iac-code --model qwen3.6-plus +iac-code --model qwen3.7-max ``` ワンショットプロンプトを実行する： diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/current/cli/skills.md b/website/i18n/ja/docusaurus-plugin-content-docs/current/cli/skills.md index 23dcbb10..99203304 100644 --- a/website/i18n/ja/docusaurus-plugin-content-docs/current/cli/skills.md +++ b/website/i18n/ja/docusaurus-plugin-content-docs/current/cli/skills.md @@ -9,24 +9,12 @@ Skills are reusable prompt templates that extend IaC Code with custom slash comm ## Skill File Formats -Skills are defined as Markdown files with YAML frontmatter. Two formats are supported: - -### Single File - -A standalone Markdown file named after the skill: - -```text -skills/ - deploy-check.md - code-review.md -``` - -### Directory - -A directory containing a `SKILL.md` file, useful when the skill needs additional reference files: +Skills are defined as a directory containing a `SKILL.md` file with YAML frontmatter. The directory name is the skill's default name. A skill directory can also hold additional reference files. ```text skills/ + deploy-check/ + SKILL.md my-skill/ SKILL.md references/ @@ -35,16 +23,16 @@ skills/ ## Discovery and Priority -IaC Code discovers skills from multiple locations. When skills share the same name, later sources override earlier ones: +IaC Code discovers skills from multiple locations. When skills share the same name, higher-priority sources override lower-priority ones: | Priority | Location | Description | |----------|----------|-------------| -| 1 (lowest) | Bundled | Built-in skills shipped with IaC Code | -| 2 | `~/.iac-code/skills/` | User-global skills (follows `IAC_CODE_CONFIG_DIR`) | -| 3 | `skills/` | Project-level skills directory | -| 4 (highest) | `.iac-code/skills/` | Project config-level skills directory | +| 1 (lowest) | `~/.iac-code/skills/` | User-global skills (follows `IAC_CODE_CONFIG_DIR`) | +| 2 | `skills/` | Project-level skills directory | +| 3 | `.iac-code/skills/` | Project config-level skills directory | +| 4 (highest) | Bundled | Built-in skills shipped with IaC Code (cannot be shadowed by user/project skills of the same name) | -Project skill directories are searched upward from the current working directory to the filesystem root. +Project skill directories are searched from the git repository root down to the current working directory. When not inside a git repository, only the current directory is searched. ## Frontmatter Reference @@ -81,7 +69,7 @@ paths: | `when_to_use` | No | `""` | Hint for the model on when to invoke this skill automatically | | `argument_hint` | No | `""` | Placeholder shown after the command name | | `arguments` | No | `[]` | Named argument list for positional substitution | -| `allowed_tools` | No | `[]` | Tools the skill is allowed to use (applies to fork mode) | +| `allowed_tools` | No | `[]` | Tools the skill is allowed to use (applies to both inline and fork modes) | | `user_invocable` | No | `true` | Whether the user can invoke this skill directly via `/name` (or `$name`) | | `model` | No | `"inherit"` | Model override for this skill execution | | `effort` | No | `""` | Thinking effort override | @@ -189,7 +177,7 @@ Review the current project and generate a pre-deployment checklist covering: If a stack name is provided, also check the current stack status. ``` -Save this as `~/.iac-code/skills/checklist.md` or `.iac-code/skills/checklist.md` in your project. Then invoke it with `/checklist` in the REPL — or with `$checklist`, which is identical but filters autocomplete suggestions to skills only. +Save this as `~/.iac-code/skills/checklist/SKILL.md` or `.iac-code/skills/checklist/SKILL.md` in your project. Then invoke it with `/checklist` in the REPL — or with `$checklist`, which is identical but filters autocomplete suggestions to skills only. ## Permissions diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/current/configuration/environment-variables.md b/website/i18n/ja/docusaurus-plugin-content-docs/current/configuration/environment-variables.md index faea0a02..c8f5db1a 100644 --- a/website/i18n/ja/docusaurus-plugin-content-docs/current/configuration/environment-variables.md +++ b/website/i18n/ja/docusaurus-plugin-content-docs/current/configuration/environment-variables.md @@ -19,7 +19,7 @@ CLI 引数 > 環境変数 > 設定ファイル |---|---| | `IAC_CODE_PROVIDER` | モデルプロバイダー名（大文字小文字不問）。有効な値：`DashScope`、`DashScope Token Plan`、`OpenAI`、`Anthropic`、`DeepSeek`、`Gemini`、`Azure OpenAI`、`ModelScope`、`Kimi CN`、`Kimi Intl`、`MiniMax CN`、`MiniMax Intl`、`ZhiPu CN`、`ZhiPu Intl`、`Volcengine CN`、`SiliconFlow CN`、`SiliconFlow Intl`、`Aliyun CodingPlan`、`Aliyun CodingPlan Intl`、`ZhiPu CN CodingPlan`、`ZhiPu Intl CodingPlan`、`Volcengine CodingPlan`、`OpenAPI Compatible`、`Anthropic Compatible`、`OpenRouter`、`Ollama`、`LM Studio` | | `IAC_CODE_MODEL` | モデル名 | -| `IAC_CODE_BASE_URL` | `OpenAPI Compatible` と `Anthropic Compatible` 専用の API エンドポイント。他のプロバイダーでは無視されます | +| `IAC_CODE_BASE_URL` | `OpenAI Compatible` 専用の API エンドポイント。他のプロバイダーでは無視され、warning が表示されます | | `IAC_CODE_API_KEY` | プロバイダー API キー。`.credentials.yml` のアクティブプロバイダーのキーを上書きします | 詳細は [LLM プロバイダー](./llm-providers.md) をご覧ください。 diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/current/configuration/llm-providers.md b/website/i18n/ja/docusaurus-plugin-content-docs/current/configuration/llm-providers.md index 82a5f554..3b5e1d35 100644 --- a/website/i18n/ja/docusaurus-plugin-content-docs/current/configuration/llm-providers.md +++ b/website/i18n/ja/docusaurus-plugin-content-docs/current/configuration/llm-providers.md @@ -74,5 +74,5 @@ CLI 引数 > 環境変数 > 設定ファイル |---|---| | `IAC_CODE_PROVIDER` | モデルプロバイダー名（大文字小文字不問）。有効な値は上記の表を参照 | | `IAC_CODE_MODEL` | モデル名 | -| `IAC_CODE_BASE_URL` | `OpenAPI Compatible` と `Anthropic Compatible` 用の API エンドポイント。他のプロバイダーでは無視されます | +| `IAC_CODE_BASE_URL` | `OpenAI Compatible` 専用の API エンドポイント。他のプロバイダーでは無視され、warning が表示されます | | `IAC_CODE_API_KEY` | プロバイダー API キー | diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/current/intro.md b/website/i18n/ja/docusaurus-plugin-content-docs/current/intro.md index f0886246..d29709b8 100644 --- a/website/i18n/ja/docusaurus-plugin-content-docs/current/intro.md +++ b/website/i18n/ja/docusaurus-plugin-content-docs/current/intro.md @@ -10,8 +10,8 @@ IaC Code は、クラウドインフラ向けの AI 駆動 Infrastructure as Cod 主な機能： -- **言葉にすれば、即生成** — 自然言語で必要なものを記述するだけで、検証済みですぐにデプロイ可能な ROS または Terraform テンプレートを生成します。 -- **ワンコマンドで本番へ** — テンプレートから稼働中のインフラとアプリケーションまでを一気通貫で実現。リージョンをまたいでスタックの作成・更新・削除・監視を行います。 +- **言葉にすれば、即生成** — 自然言語で必要なものを記述するだけで、検証済みですぐにデプロイ可能な ROS テンプレート、または生成された Terraform テンプレートを作成します。 +- **ワンコマンドで本番へ** — Alibaba Cloud ROS では、テンプレートから稼働中のインフラまでを一気通貫で実現し、リージョンをまたいでスタックの作成・更新・削除・監視を行います。Terraform のサポートはテンプレートの生成と変換が対象で、デプロイは含みません。 - **クラウドの知見を内蔵** — ドキュメント検索、リソース在庫確認、デプロイ前のコスト見積もり。すべての判断が実際のクラウドデータに裏付けられています。 ドキュメントはユーザータスクに沿って構成されています。まずインストールとクイックスタートから始め、次にプロバイダーと認証情報を設定し、コマンドの詳細が必要な場合は CLI リファレンスをご覧ください。 diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md b/website/i18n/ja/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md index 547879f2..8248cfb2 100644 --- a/website/i18n/ja/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md +++ b/website/i18n/ja/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md @@ -85,7 +85,7 @@ Headless と protocol server modes は、未承認の project servers を確認 IaC Code は複数の方法で secrets を保護します。 - `iac-code mcp get` の config 出力では、token、secret、password、API key、authorization header に見える keys を秘匿化します。 -- 機密性の高い header または env 値の plaintext は、環境変数参照でない限り拒否されます。 +- 機密性の高い header または env 値の plaintext は、`iac-code mcp add` / `mcp add-json` でサーバーを追加する場合にのみ拒否されます（環境変数参照を使う場合を除く）。手動で編集した config ファイルは読み込み時に再検証されないため、plaintext の secret を直接保存しないでください。 - MCP stdio servers は、安全な環境変数 allowlist と明示的な server env だけを継承します。 - username または password を含む proxy 環境変数は stdio MCP servers に継承されません。 - MCP artifact files は非公開の IaC Code runtime configuration directory に書き込まれます。 diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/current/mcp/overview.md b/website/i18n/ja/docusaurus-plugin-content-docs/current/mcp/overview.md index bb9c9ded..a214debd 100644 --- a/website/i18n/ja/docusaurus-plugin-content-docs/current/mcp/overview.md +++ b/website/i18n/ja/docusaurus-plugin-content-docs/current/mcp/overview.md @@ -43,7 +43,7 @@ IaC Code は Model Context Protocol (MCP) のホストとして動作できま 実行時、IaC Code は次の処理を行います。 -1. ユーザー、ローカル、プロジェクト、セッションの各ソースから MCP 設定を読み込みます。 +1. ユーザー、プロジェクト、ローカル、セッションの各ソースから MCP 設定を読み込みます。 2. `${VAR}` と `${VAR:-default}` 参照を展開します。 3. 安全でない、または無効なサーバーをユーザーに見える warning とともにスキップします。 4. 承認済みサーバーに制限付き並行数で接続します。 diff --git a/website/i18n/pt/docusaurus-plugin-content-docs/current/acp/examples.md b/website/i18n/pt/docusaurus-plugin-content-docs/current/acp/examples.md index 95c1ac1d..05709278 100644 --- a/website/i18n/pt/docusaurus-plugin-content-docs/current/acp/examples.md +++ b/website/i18n/pt/docusaurus-plugin-content-docs/current/acp/examples.md @@ -265,7 +265,7 @@ async def main(): "params": { "protocolVersion": 1, "clientInfo": {"name": "http-client", "version": "1.0"}, - "capabilities": {} + "clientCapabilities": {} } }, headers=HEADERS) resp.raise_for_status() diff --git a/website/i18n/pt/docusaurus-plugin-content-docs/current/acp/http-transport.md b/website/i18n/pt/docusaurus-plugin-content-docs/current/acp/http-transport.md index 0591b79f..806076c9 100644 --- a/website/i18n/pt/docusaurus-plugin-content-docs/current/acp/http-transport.md +++ b/website/i18n/pt/docusaurus-plugin-content-docs/current/acp/http-transport.md @@ -102,7 +102,7 @@ Abaixo esta uma interacao completa usando `curl`: # Step 1: Initialize — creates a connection and returns the Connection ID CONN_ID=$(curl -s -D - -X POST http://localhost:8765/acp \ -H "Content-Type: application/json" \ - -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":1,"capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}' \ + -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":1,"clientCapabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}' \ | grep -i 'acp-connection-id' | awk '{print $2}' | tr -d '\r') echo "Connection ID: $CONN_ID" diff --git a/website/i18n/pt/docusaurus-plugin-content-docs/current/acp/protocol-reference.md b/website/i18n/pt/docusaurus-plugin-content-docs/current/acp/protocol-reference.md index c128a0f8..81ee93a3 100644 --- a/website/i18n/pt/docusaurus-plugin-content-docs/current/acp/protocol-reference.md +++ b/website/i18n/pt/docusaurus-plugin-content-docs/current/acp/protocol-reference.md @@ -64,6 +64,8 @@ Handshake do protocolo. Deve ser a primeira chamada em cada conexao. | `promptCapabilities.embeddedContext` | `true` | Aceita conteudo de recurso incorporado em prompts | | `promptCapabilities.image` | `false` | Entrada de imagem nao suportada (degrada para marcador de texto) | | `promptCapabilities.audio` | `false` | Entrada de audio nao suportada (degrada para marcador de texto) | +| `mcpCapabilities.http` | `true` | Aceita servidores MCP HTTP/streamable na criacao da sessao | +| `mcpCapabilities.sse` | `true` | Aceita servidores MCP SSE na criacao da sessao | | `sessionCapabilities.list` | `{}` | Suporta listagem de sessoes | | `sessionCapabilities.close` | `{}` | Suporta fechamento de sessoes | @@ -78,7 +80,7 @@ Cria uma nova sessao com um runtime de agente independente, registro de ferramen | Campo | Tipo | Obrigatorio | Descricao | |-------|------|----------|-------------| | `cwd` | string | Sim | Caminho absoluto para o diretorio de trabalho | -| `mcpServers` | object | Nao | Configuracao de servidor MCP (aceito mas ainda nao funcional) | +| `mcpServers` | object | Nao | Configuracao de servidor MCP; servidores HTTP (streamable) e SSE sao conectados para a sessao | **Campos da resposta** @@ -189,7 +191,7 @@ Envia entrada do utilizador e aciona respostas do agente em streaming. | Campo | Tipo | Descricao | |-------|------|-------------| | `stopReason` | string | Por que o prompt foi concluido (veja Motivos de parada) | -| `usage` | object | Uso de tokens: `inputTokens`, `outputTokens`, `totalTokens` | +| `_meta.usage` | object | Uso de tokens sob o objeto `_meta` da resposta: `input_tokens`, `output_tokens`, `total_tokens` | **Motivos de parada** @@ -243,7 +245,7 @@ Fecha uma sessao e libera seus recursos. --- -### sessions/list +### session/list Lista todas as sessoes persistidas para um determinado diretorio de trabalho. @@ -261,7 +263,7 @@ Lista todas as sessoes persistidas para um determinado diretorio de trabalho. --- -### config/set +### session/set_config_option Define dinamicamente uma opcao de configuracao para uma sessao. @@ -371,8 +373,8 @@ Para `aliyun_api`, ações somente leitura são permitidas automaticamente. Aç ```json { - "outcome": "allowed", - "option_id": "allow_once" + "outcome": "selected", + "optionId": "allow_once" } ``` @@ -380,7 +382,7 @@ Ou para negar: ```json { - "outcome": "denied" + "outcome": "cancelled" } ``` diff --git a/website/i18n/pt/docusaurus-plugin-content-docs/current/cli/command-line-options.md b/website/i18n/pt/docusaurus-plugin-content-docs/current/cli/command-line-options.md index 1acec8fc..c7973a19 100644 --- a/website/i18n/pt/docusaurus-plugin-content-docs/current/cli/command-line-options.md +++ b/website/i18n/pt/docusaurus-plugin-content-docs/current/cli/command-line-options.md @@ -17,6 +17,7 @@ As opções de linha de comando alteram como o IaC Code é iniciado. Use-as ante | `--max-turns ` | Limitar o número máximo de turnos do agente no modo não interativo. O padrão é `100`. | | `--thinking-enabled`, `--no-thinking-enabled` | Controla se solicitações nao interativas de execucao unica habilitam thinking explicitamente. O padrão é `--thinking-enabled`; use `--no-thinking-enabled` para enviar `thinking_enabled=false` nesta execução sem reescrever `settings.yml`. | | `-d`, `--debug` | Ativar o registro de depuração para a execução atual. No modo interativo, use `/debug` para inspecionar ou alterar o registro de depuração após a inicialização. | +| `--verbose` | Mostrar o progresso do modo headless (não interativo) na saída de erro padrão. | | `-r `, `--resume ` | Retomar uma sessão anterior por ID exato, prefixo único de ID ou nome único de sessão. Sessões resolvidas em outro projeto imprimem um comando `cd ... && iac-code --resume ` em vez de trocar o projeto atual em tempo real. | | `-c`, `--continue` | Retomar a sessão mais recente. Não pode ser usado junto com `--resume`. | | `--allowed-tools ` | Padrões de permissão de ferramentas separados por vírgulas para permitir, ex. `'bash(git *),write_file'`. | @@ -47,7 +48,7 @@ iac-code Iniciar com um modelo específico para esta execução: ```bash -iac-code --model qwen3.6-plus +iac-code --model qwen3.7-max ``` Executar um prompt único: diff --git a/website/i18n/pt/docusaurus-plugin-content-docs/current/cli/skills.md b/website/i18n/pt/docusaurus-plugin-content-docs/current/cli/skills.md index 6c920d89..8f6ef7be 100644 --- a/website/i18n/pt/docusaurus-plugin-content-docs/current/cli/skills.md +++ b/website/i18n/pt/docusaurus-plugin-content-docs/current/cli/skills.md @@ -7,26 +7,14 @@ description: Create and use reusable prompt templates as slash commands. Skills are reusable prompt templates that extend IaC Code with custom slash commands. They let you package complex instructions, tool configurations, and workflow patterns into named commands that can be invoked during a conversation. -## Skill File Formats +## Formato dos arquivos de skill -Skills are defined as Markdown files with YAML frontmatter. Two formats are supported: - -### Single File - -A standalone Markdown file named after the skill: - -```text -skills/ - deploy-check.md - code-review.md -``` - -### Directory - -A directory containing a `SKILL.md` file, useful when the skill needs additional reference files: +Uma skill é um diretório que contém um arquivo `SKILL.md` com frontmatter YAML. O nome do diretório é o nome padrão da skill, e o diretório pode conter arquivos de referência adicionais: ```text skills/ + deploy-check/ + SKILL.md my-skill/ SKILL.md references/ @@ -35,16 +23,16 @@ skills/ ## Discovery and Priority -IaC Code discovers skills from multiple locations. When skills share the same name, later sources override earlier ones: +O IaC Code descobre skills a partir de várias localizações. Quando skills têm o mesmo nome, as fontes de prioridade mais alta substituem as de prioridade mais baixa: -| Priority | Location | Description | +| Prioridade | Localização | Descrição | |----------|----------|-------------| -| 1 (lowest) | Bundled | Built-in skills shipped with IaC Code | -| 2 | `~/.iac-code/skills/` | User-global skills (follows `IAC_CODE_CONFIG_DIR`) | -| 3 | `skills/` | Project-level skills directory | -| 4 (highest) | `.iac-code/skills/` | Project config-level skills directory | +| 1 (mais baixa) | `~/.iac-code/skills/` | Skills globais do usuário (segue `IAC_CODE_CONFIG_DIR`) | +| 2 | `skills/` | Diretório de skills no nível do projeto | +| 3 | `.iac-code/skills/` | Diretório de skills no nível de configuração do projeto | +| 4 (mais alta) | Integradas | Skills integradas fornecidas com o IaC Code; não podem ser sobrepostas por skills de usuário ou de projeto com o mesmo nome | -Project skill directories are searched upward from the current working directory to the filesystem root. +Os diretórios de skills de projeto são pesquisados a partir da raiz do repositório git para baixo, até o diretório de trabalho atual; quando não está dentro de um repositório git, apenas o diretório atual é pesquisado. ## Frontmatter Reference @@ -81,7 +69,7 @@ paths: | `when_to_use` | No | `""` | Hint for the model on when to invoke this skill automatically | | `argument_hint` | No | `""` | Placeholder shown after the command name | | `arguments` | No | `[]` | Named argument list for positional substitution | -| `allowed_tools` | No | `[]` | Tools the skill is allowed to use (applies to fork mode) | +| `allowed_tools` | No | `[]` | Tools the skill is allowed to use (applies to both inline and fork modes) | | `user_invocable` | No | `true` | Whether the user can invoke this skill directly via `/name` (or `$name`) | | `model` | No | `"inherit"` | Model override for this skill execution | | `effort` | No | `""` | Thinking effort override | @@ -189,7 +177,7 @@ Review the current project and generate a pre-deployment checklist covering: If a stack name is provided, also check the current stack status. ``` -Save this as `~/.iac-code/skills/checklist.md` or `.iac-code/skills/checklist.md` in your project. Then invoke it with `/checklist` in the REPL — or with `$checklist`, which is identical but filters autocomplete suggestions to skills only. +Save this as `~/.iac-code/skills/checklist/SKILL.md` or `.iac-code/skills/checklist/SKILL.md` in your project. Then invoke it with `/checklist` in the REPL — or with `$checklist`, which is identical but filters autocomplete suggestions to skills only. ## Permissions diff --git a/website/i18n/pt/docusaurus-plugin-content-docs/current/configuration/environment-variables.md b/website/i18n/pt/docusaurus-plugin-content-docs/current/configuration/environment-variables.md index 04e1431d..9a960d8f 100644 --- a/website/i18n/pt/docusaurus-plugin-content-docs/current/configuration/environment-variables.md +++ b/website/i18n/pt/docusaurus-plugin-content-docs/current/configuration/environment-variables.md @@ -19,7 +19,7 @@ As variaveis de ambiente sao uteis para pipelines de CI/CD, containers e substit |---|---| | `IAC_CODE_PROVIDER` | Nome do provedor de modelo (insensivel a maiusculas e minusculas). Valores validos: `DashScope`, `DashScope Token Plan`, `OpenAI`, `Anthropic`, `DeepSeek`, `Gemini`, `Azure OpenAI`, `ModelScope`, `Kimi CN`, `Kimi Intl`, `MiniMax CN`, `MiniMax Intl`, `ZhiPu CN`, `ZhiPu Intl`, `Volcengine CN`, `SiliconFlow CN`, `SiliconFlow Intl`, `Aliyun CodingPlan`, `Aliyun CodingPlan Intl`, `ZhiPu CN CodingPlan`, `ZhiPu Intl CodingPlan`, `Volcengine CodingPlan`, `OpenAPI Compatible`, `Anthropic Compatible`, `OpenRouter`, `Ollama`, `LM Studio` | | `IAC_CODE_MODEL` | Nome do modelo | -| `IAC_CODE_BASE_URL` | Endpoint de API para `OpenAPI Compatible` e `Anthropic Compatible` apenas; ignorado para outros provedores | +| `IAC_CODE_BASE_URL` | Endpoint de API aplicável apenas a `OpenAPI Compatible`; ignorado (com um aviso) para outros provedores | | `IAC_CODE_API_KEY` | Chave de API do provedor; substitui a chave do provedor ativo em `.credentials.yml` | Consulte [Provedores de LLM](./llm-providers.md) para detalhes sobre os provedores. diff --git a/website/i18n/pt/docusaurus-plugin-content-docs/current/configuration/llm-providers.md b/website/i18n/pt/docusaurus-plugin-content-docs/current/configuration/llm-providers.md index c942b8b8..f22e4b7c 100644 --- a/website/i18n/pt/docusaurus-plugin-content-docs/current/configuration/llm-providers.md +++ b/website/i18n/pt/docusaurus-plugin-content-docs/current/configuration/llm-providers.md @@ -74,5 +74,5 @@ CLI arguments > environment variables > configuration files |---|---| | `IAC_CODE_PROVIDER` | Nome do provedor de modelo (insensivel a maiusculas e minusculas). Consulte as tabelas acima para valores validos | | `IAC_CODE_MODEL` | Nome do modelo | -| `IAC_CODE_BASE_URL` | Endpoint de API para `OpenAPI Compatible` e `Anthropic Compatible` apenas; ignorado para outros provedores | +| `IAC_CODE_BASE_URL` | Endpoint de API aplicável apenas a `OpenAPI Compatible`; ignorado (com um aviso) para outros provedores | | `IAC_CODE_API_KEY` | Chave de API do provedor | diff --git a/website/i18n/pt/docusaurus-plugin-content-docs/current/intro.md b/website/i18n/pt/docusaurus-plugin-content-docs/current/intro.md index 16b88901..9e878b39 100644 --- a/website/i18n/pt/docusaurus-plugin-content-docs/current/intro.md +++ b/website/i18n/pt/docusaurus-plugin-content-docs/current/intro.md @@ -10,8 +10,8 @@ O IaC Code e um assistente de Infrastructure as Code com tecnologia de IA para i Capacidades principais: -- **Diga e implante** — descreva o que precisa em linguagem natural e obtenha templates ROS ou Terraform validados e prontos para implantacao. -- **Um comando para producao** — va do template a infraestrutura e aplicacoes em execucao em um unico fluxo; crie, atualize, exclua e monitore stacks em diferentes regioes. +- **Diga e obtenha o template** — descreva o que precisa em linguagem natural e obtenha templates ROS validados e prontos para implantacao, ou templates Terraform gerados. +- **Do template a producao** — para o Alibaba Cloud ROS, va do template a infraestrutura em execucao: crie, atualize, exclua e monitore stacks em diferentes regioes. O suporte a Terraform cobre a geracao e a conversao de templates, nao a implantacao. - **Inteligencia de nuvem integrada** — pesquise documentacao, verifique a disponibilidade de recursos e estime custos antes de implantar; cada decisao respaldada por dados reais da nuvem. A documentacao esta organizada em torno das tarefas do utilizador. Comece com a instalacao e o inicio rapido, depois configure provedores e credenciais, e em seguida use a referencia do CLI quando precisar de detalhes sobre os comandos. diff --git a/website/i18n/pt/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md b/website/i18n/pt/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md index 050851d0..2abf0f7e 100644 --- a/website/i18n/pt/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md +++ b/website/i18n/pt/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md @@ -85,7 +85,7 @@ Modos headless e servidor de protocolo ignoram servidores de projeto não aprova O IaC Code protege segredos de várias formas: - A saída de `iac-code mcp get` mascara chaves que parecem tokens, secrets, passwords, API keys e authorization headers. -- Valores sensíveis de headers ou env em texto claro são rejeitados, a menos que usem referência a variável de ambiente. +- Valores sensíveis de headers ou env em texto claro são rejeitados apenas ao adicionar servidores via `iac-code mcp add` / `mcp add-json` (a menos que usem referência a variável de ambiente); arquivos de configuração editados manualmente NÃO são revalidados no carregamento, então evite armazenar segredos em texto claro diretamente. - Servidores MCP stdio herdam apenas uma allowlist de variáveis de ambiente seguras mais o env explícito do servidor. - Variáveis de proxy com usernames ou passwords não são herdadas por servidores MCP stdio. - Arquivos de artefato MCP são escritos no diretório privado de configuração runtime do IaC Code. diff --git a/website/i18n/pt/docusaurus-plugin-content-docs/current/mcp/overview.md b/website/i18n/pt/docusaurus-plugin-content-docs/current/mcp/overview.md index 06dcf761..89e01190 100644 --- a/website/i18n/pt/docusaurus-plugin-content-docs/current/mcp/overview.md +++ b/website/i18n/pt/docusaurus-plugin-content-docs/current/mcp/overview.md @@ -43,7 +43,7 @@ Use MCP quando quiser que o IaC Code chame uma capacidade local ou remota que n Em tempo de execução, o IaC Code: -1. Carrega configuração MCP de fontes de usuário, locais, de projeto e de sessão. +1. Carrega configuração MCP de fontes de usuário, de projeto, locais e de sessão. 2. Expande referências `${VAR}` e `${VAR:-default}`. 3. Ignora servidores inseguros ou inválidos com avisos visíveis ao usuário. 4. Conecta servidores aprovados com concorrência limitada. diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/acp/examples.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/acp/examples.md index 19964ab7..10d97f57 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/acp/examples.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/acp/examples.md @@ -265,7 +265,7 @@ async def main(): "params": { "protocolVersion": 1, "clientInfo": {"name": "http-client", "version": "1.0"}, - "capabilities": {} + "clientCapabilities": {} } }, headers=HEADERS) resp.raise_for_status() diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/acp/http-transport.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/acp/http-transport.md index d467c70f..40cc5f46 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/acp/http-transport.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/acp/http-transport.md @@ -102,7 +102,7 @@ Authorization: Bearer your-secret-token # 第 1 步：初始化 — 创建连接并获取连接 ID CONN_ID=$(curl -s -D - -X POST http://localhost:8765/acp \ -H "Content-Type: application/json" \ - -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":1,"capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}' \ + -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":1,"clientCapabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}' \ | grep -i 'acp-connection-id' | awk '{print $2}' | tr -d '\r') echo "Connection ID: $CONN_ID" diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/acp/protocol-reference.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/acp/protocol-reference.md index 5254cc91..e377c319 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/acp/protocol-reference.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/acp/protocol-reference.md @@ -64,6 +64,8 @@ ACP session 使用与交互式和 headless 运行相同的 v2 session 备份行 | `promptCapabilities.embeddedContext` | `true` | 接受在提示中嵌入资源内容 | | `promptCapabilities.image` | `false` | 不支持图片输入（降级为文本标记） | | `promptCapabilities.audio` | `false` | 不支持音频输入（降级为文本标记） | +| `mcpCapabilities.http` | `true` | 在会话创建时接受 HTTP/streamable MCP 服务器 | +| `mcpCapabilities.sse` | `true` | 在会话创建时接受 SSE MCP 服务器 | | `sessionCapabilities.list` | `{}` | 支持列出会话 | | `sessionCapabilities.close` | `{}` | 支持关闭会话 | @@ -78,7 +80,7 @@ ACP session 使用与交互式和 headless 运行相同的 v2 session 备份行 | 字段 | 类型 | 必填 | 描述 | |-------|------|----------|-------------| | `cwd` | string | 是 | 工作目录的绝对路径 | -| `mcpServers` | object | 否 | MCP 服务器配置（已接受但尚未生效） | +| `mcpServers` | object | 否 | MCP 服务器配置；HTTP（streamable）和 SSE 服务器会在该会话中建立连接 | **响应字段** @@ -189,7 +191,7 @@ Fork 一个现有会话，创建一个具有相同历史记录的独立分支。 | 字段 | 类型 | 描述 | |-------|------|-------------| | `stopReason` | string | 提示完成的原因（见停止原因） | -| `usage` | object | Token 用量：`inputTokens`、`outputTokens`、`totalTokens` | +| `_meta.usage` | object | Token 用量，通过响应的 `_meta` 对象返回，包含 `input_tokens`、`output_tokens`、`total_tokens` 键 | **停止原因** @@ -243,7 +245,7 @@ Fork 一个现有会话，创建一个具有相同历史记录的独立分支。 --- -### sessions/list +### session/list 列出给定工作目录下所有已持久化的会话。 @@ -261,7 +263,7 @@ Fork 一个现有会话，创建一个具有相同历史记录的独立分支。 --- -### config/set +### session/set_config_option 动态设置会话的配置选项。 @@ -371,8 +373,8 @@ ToolCallStart (status=in_progress) ```json { - "outcome": "allowed", - "option_id": "allow_once" + "outcome": "selected", + "optionId": "allow_once" } ``` @@ -380,7 +382,7 @@ ToolCallStart (status=in_progress) ```json { - "outcome": "denied" + "outcome": "cancelled" } ``` diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli/command-line-options.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli/command-line-options.md index 0de4be01..1f518005 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli/command-line-options.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli/command-line-options.md @@ -17,6 +17,7 @@ description: IaC Code 启动选项和一次性执行参数参考。 | `--max-turns ` | 限制非交互模式中的最大代理轮次，默认值为 `100`。 | | `--thinking-enabled`, `--no-thinking-enabled` | 控制一次性非交互请求是否显式启用 thinking。默认值为 `--thinking-enabled`；使用 `--no-thinking-enabled` 会在本次运行中发送 `thinking_enabled=false`，但不会改写 `settings.yml`。 | | `-d`, `--debug` | 为本次运行启用调试日志。交互模式启动后，可以使用 `/debug` 查看或调整调试日志。 | +| `--verbose` | 在标准错误输出上显示 headless（非交互）模式的进度。 | | `-r `, `--resume ` | 按精确会话 ID、唯一 ID 前缀或唯一会话名称恢复历史会话。解析到跨项目会话时，会打印 `cd ... && iac-code --resume ` 命令，而不是直接热切换当前项目。 | | `-c`, `--continue` | 恢复最近一次会话。不能与 `--resume` 同时使用。 | | `--allowed-tools ` | 逗号分隔的工具权限允许模式，例如 `'bash(git *),write_file'`。 | @@ -47,7 +48,7 @@ iac-code 为本次运行指定模型： ```bash -iac-code --model qwen3.6-plus +iac-code --model qwen3.7-max ``` 执行一次性提示词： diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli/skills.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli/skills.md index e7e7701d..14518686 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli/skills.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli/skills.md @@ -9,24 +9,12 @@ description: 创建和使用可复用的提示词模板作为 Slash 命令。 ## 技能文件格式 -技能以 Markdown 文件定义，包含 YAML frontmatter。支持两种格式： - -### 单文件 - -以技能名称命名的独立 Markdown 文件： - -```text -skills/ - deploy-check.md - code-review.md -``` - -### 目录 - -包含 `SKILL.md` 的目录，适用于技能需要附带额外参考文件的场景： +技能是一个包含 `SKILL.md` 文件的目录，`SKILL.md` 以 YAML frontmatter 开头。目录名即技能的默认名称，目录中还可以存放技能所需的额外参考文件： ```text skills/ + deploy-check/ + SKILL.md my-skill/ SKILL.md references/ @@ -35,16 +23,16 @@ skills/ ## 发现与优先级 -IaC Code 从多个位置发现技能。同名技能按后者覆盖前者的规则处理： +IaC Code 从多个位置发现技能。同名技能按优先级高者覆盖低者的规则处理： | 优先级 | 位置 | 说明 | |--------|------|------| -| 1（最低） | 内置 | IaC Code 自带的内置技能 | -| 2 | `~/.iac-code/skills/` | 用户全局技能（跟随 `IAC_CODE_CONFIG_DIR`） | -| 3 | `skills/` | 项目级技能目录 | -| 4（最高） | `.iac-code/skills/` | 项目配置级技能目录 | +| 1（最低） | `~/.iac-code/skills/` | 用户全局技能（跟随 `IAC_CODE_CONFIG_DIR`） | +| 2 | `skills/` | 项目级技能目录 | +| 3 | `.iac-code/skills/` | 项目配置级技能目录 | +| 4（最高） | 内置 | IaC Code 自带的内置技能；不会被同名的用户或项目技能覆盖 | -项目技能目录会从当前工作目录向上搜索至文件系统根目录。 +项目技能目录会从 git 仓库根目录向下搜索至当前工作目录。当当前目录不在 git 仓库中时，仅搜索当前目录。 ## Frontmatter 参考 @@ -81,7 +69,7 @@ paths: | `when_to_use` | 否 | `""` | 提示模型何时自动调用此技能 | | `argument_hint` | 否 | `""` | 命令名后显示的占位符提示 | | `arguments` | 否 | `[]` | 用于位置替换的命名参数列表 | -| `allowed_tools` | 否 | `[]` | 技能允许使用的工具（适用于 fork 模式） | +| `allowed_tools` | 否 | `[]` | 技能允许使用的工具（inline 和 fork 模式均适用） | | `user_invocable` | 否 | `true` | 用户是否可以通过 `/name`（或 `$name`）直接调用 | | `model` | 否 | `"inherit"` | 技能执行时的模型覆盖 | | `effort` | 否 | `""` | 思考 effort 覆盖 | @@ -189,7 +177,7 @@ user_invocable: true 如果提供了资源栈名称，还需检查当前资源栈状态。 ``` -将此文件保存为 `~/.iac-code/skills/checklist.md` 或项目中的 `.iac-code/skills/checklist.md`，然后在 REPL 中通过 `/checklist` 调用 —— 也可以使用 `$checklist`，效果完全相同，但 `$` 触发器只会筛选 skill 候选项。 +将此文件保存为 `~/.iac-code/skills/checklist/SKILL.md` 或项目中的 `.iac-code/skills/checklist/SKILL.md`，然后在 REPL 中通过 `/checklist` 调用 —— 也可以使用 `$checklist`，效果完全相同，但 `$` 触发器只会筛选 skill 候选项。 ## 权限 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/configuration/environment-variables.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/configuration/environment-variables.md index c0c8ec4f..76a9dcc8 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/configuration/environment-variables.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/configuration/environment-variables.md @@ -19,7 +19,7 @@ CLI 参数 > 环境变量 > 配置文件 |---|---| | `IAC_CODE_PROVIDER` | 模型提供商名称（大小写不敏感）。有效值：`DashScope`、`DashScope Token Plan`、`OpenAI`、`Anthropic`、`DeepSeek`、`Gemini`、`Azure OpenAI`、`ModelScope`、`Kimi CN`、`Kimi Intl`、`MiniMax CN`、`MiniMax Intl`、`ZhiPu CN`、`ZhiPu Intl`、`Volcengine CN`、`SiliconFlow CN`、`SiliconFlow Intl`、`Aliyun CodingPlan`、`Aliyun CodingPlan Intl`、`ZhiPu CN CodingPlan`、`ZhiPu Intl CodingPlan`、`Volcengine CodingPlan`、`OpenAPI Compatible`、`Anthropic Compatible`、`OpenRouter`、`Ollama`、`LM Studio` | | `IAC_CODE_MODEL` | 模型名称 | -| `IAC_CODE_BASE_URL` | `OpenAPI Compatible` 和 `Anthropic Compatible` 使用的 API 端点；其他提供商会忽略此值 | +| `IAC_CODE_BASE_URL` | 仅 `OpenAI Compatible` 使用的 API 端点；其他提供商会忽略此值（并给出 warning） | | `IAC_CODE_API_KEY` | 提供商 API Key；覆盖 `.credentials.yml` 中活跃提供商的密钥 | 详见 [LLM 提供商](./llm-providers.md)。 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/configuration/llm-providers.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/configuration/llm-providers.md index d18cb84b..226979ed 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/configuration/llm-providers.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/configuration/llm-providers.md @@ -74,5 +74,5 @@ CLI 参数 > 环境变量 > 配置文件 |---|---| | `IAC_CODE_PROVIDER` | 模型提供商名称（大小写不敏感），有效值见上表 | | `IAC_CODE_MODEL` | 模型名称 | -| `IAC_CODE_BASE_URL` | `OpenAPI Compatible` 和 `Anthropic Compatible` 使用的 API 端点；其他提供商会忽略此值 | +| `IAC_CODE_BASE_URL` | 仅 `OpenAI Compatible` 使用的 API 端点；其他提供商会忽略此值（并给出 warning） | | `IAC_CODE_API_KEY` | 提供商 API Key | diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/intro.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/intro.md index caa36928..25284b6d 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/intro.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/intro.md @@ -10,8 +10,8 @@ IaC Code 是面向云基础设施的 AI 基础设施即代码助手。它帮助 核心能力： -- **说出来，就生成** — 用自然语言描述需求，自动生成经过校验、可直接部署的 ROS 或 Terraform 模板。 -- **一句话到上线** — 从模板到基础设施和应用运行，一站式完成；创建、更新、删除资源栈，跨地域监控部署进度。 +- **说出来，就生成** — 用自然语言描述需求，自动生成经过校验、可直接部署的 ROS 模板，或生成 Terraform 模板。 +- **一句话到上线** — 面向阿里云 ROS，从模板到基础设施运行一站式完成：创建、更新、删除资源栈，并跨地域监控部署进度；Terraform 支持仅覆盖模板生成与转换，不包含部署。 - **云端智能加持** — 搜索云产品文档、查询资源库存、部署前估算成本；每一个决策都有真实云数据支撑。 文档按用户任务组织。建议先阅读安装和快速开始，然后配置提供商与凭证；需要命令细节时再查看 CLI 参考。 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md index b6812c92..627b3d39 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/mcp/oauth-and-security.md @@ -85,7 +85,7 @@ Headless 和 protocol server 模式会跳过未批准的项目 servers，而不 IaC Code 通过多种方式保护 secrets： - `iac-code mcp get` 的 config 输出会对看起来像 token、secret、password、API key 和 authorization header 的字段脱敏。 -- 敏感 header 或 env 的 plaintext values 会被拒绝，除非使用环境变量引用。 +- 只有在通过 `iac-code mcp add` / `mcp add-json` 添加 server 时，敏感 header 或 env 的 plaintext values 才会被拒绝（除非使用环境变量引用）；手动编辑的配置文件在加载时不会被重新校验，因此请避免直接存储 plaintext secrets。 - MCP stdio servers 只会继承安全环境变量 allowlist 以及显式 server env。 - 带 username 或 password 的 proxy 环境变量不会被 stdio MCP servers 继承。 - MCP artifact files 会写入私有的 IaC Code runtime configuration directory。 diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/mcp/overview.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/mcp/overview.md index 49abf460..52294a42 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/mcp/overview.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/mcp/overview.md @@ -43,7 +43,7 @@ IaC Code 可以作为 Model Context Protocol (MCP) host 运行。MCP 服务器 运行时 IaC Code 会： -1. 从用户、本地、项目和会话来源加载 MCP 配置。 +1. 从用户、项目、本地和会话来源加载 MCP 配置。 2. 展开 `${VAR}` 和 `${VAR:-default}` 引用。 3. 通过用户可见 warning 跳过不安全或无效的 server。 4. 以有界并发连接已批准的 server。