@symerian/symi 3.0.21 → 3.0.22

package/docs/zh-CN/providers/bedrock.md

@@ -1,170 +0,0 @@
----
-read_when:
-  - 你想在 Symi 中使用 Amazon Bedrock 模型
-  - 你需要为模型调用配置 AWS 凭证/区域
-summary: 在 Symi 中使用 Amazon Bedrock（Converse API）模型
-title: Amazon Bedrock
-x-i18n:
-  generated_at: "2026-02-03T10:04:01Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 318f1048451a1910b70522e2f7f9dfc87084de26d9e3938a29d372eed32244a8
-  source_path: providers/bedrock.md
-  workflow: 15
----
-
-# Amazon Bedrock
-
-Symi 可以通过 pi‑ai 的 **Bedrock Converse** 流式提供商使用 **Amazon Bedrock** 模型。Bedrock 认证使用 **AWS SDK 默认凭证链**，而非 API 密钥。
-
-## pi‑ai 支持的功能
-
-- 提供商：`amazon-bedrock`
-- API：`bedrock-converse-stream`
-- 认证：AWS 凭证（环境变量、共享配置或实例角色）
-- 区域：`AWS_REGION` 或 `AWS_DEFAULT_REGION`（默认：`us-east-1`）
-
-## 自动模型发现
-
-如果检测到 AWS 凭证，Symi 可以自动发现支持**流式传输**和**文本输出**的 Bedrock 模型。发现功能使用 `bedrock:ListFoundationModels`，并会被缓存（默认：1 小时）。
-
-配置选项位于 `models.bedrockDiscovery` 下：
-
-```json5
-{
-  models: {
-    bedrockDiscovery: {
-      enabled: true,
-      region: "us-east-1",
-      providerFilter: ["anthropic", "amazon"],
-      refreshInterval: 3600,
-      defaultContextWindow: 32000,
-      defaultMaxTokens: 4096,
-    },
-  },
-}
-```
-
-注意事项：
-
-- `enabled` 在存在 AWS 凭证时默认为 `true`。
-- `region` 默认为 `AWS_REGION` 或 `AWS_DEFAULT_REGION`，然后是 `us-east-1`。
-- `providerFilter` 匹配 Bedrock 提供商名称（例如 `anthropic`）。
-- `refreshInterval` 单位为秒；设置为 `0` 可禁用缓存。
-- `defaultContextWindow`（默认：`32000`）和 `defaultMaxTokens`（默认：`4096`）用于已发现的模型（如果你知道模型限制，可以覆盖这些值）。
-
-## 设置（手动）
-
-1. 确保 AWS 凭证在 **Gateway 网关主机**上可用：
-
-```bash
-export AWS_ACCESS_KEY_ID="AKIA..."
-export AWS_SECRET_ACCESS_KEY="..."
-export AWS_REGION="us-east-1"
-# 可选：
-export AWS_SESSION_TOKEN="..."
-export AWS_PROFILE="your-profile"
-# 可选（Bedrock API 密钥/Bearer 令牌）：
-export AWS_BEARER_TOKEN_BEDROCK="..."
-```
-
-2. 在配置中添加 Bedrock 提供商和模型（无需 `apiKey`）：
-
-```json5
-{
-  models: {
-    providers: {
-      "amazon-bedrock": {
-        baseUrl: "https://bedrock-runtime.us-east-1.amazonaws.com",
-        api: "bedrock-converse-stream",
-        auth: "aws-sdk",
-        models: [
-          {
-            id: "anthropic.claude-opus-4-5-20251101-v1:0",
-            name: "Claude Opus 4.5 (Bedrock)",
-            reasoning: true,
-            input: ["text", "image"],
-            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
-            contextWindow: 200000,
-            maxTokens: 8192,
-          },
-        ],
-      },
-    },
-  },
-  agents: {
-    defaults: {
-      model: { primary: "amazon-bedrock/anthropic.claude-opus-4-5-20251101-v1:0" },
-    },
-  },
-}
-```
-
-## EC2 实例角色
-
-当在附加了 IAM 角色的 EC2 实例上运行 Symi 时，AWS SDK 会自动使用实例元数据服务（IMDS）进行认证。但是，Symi 的凭证检测目前只检查环境变量，不检查 IMDS 凭证。
-
-**解决方法：** 设置 `AWS_PROFILE=default` 以表明 AWS 凭证可用。实际认证仍然通过 IMDS 使用实例角色。
-
-```bash
-# 添加到 ~/.bashrc 或你的 shell 配置文件
-export AWS_PROFILE=default
-export AWS_REGION=us-east-1
-```
-
-EC2 实例角色**所需的 IAM 权限**：
-
-- `bedrock:InvokeModel`
-- `bedrock:InvokeModelWithResponseStream`
-- `bedrock:ListFoundationModels`（用于自动发现）
-
-或者附加托管策略 `AmazonBedrockFullAccess`。
-
-**快速设置：**
-
-```bash
-# 1. 创建 IAM 角色和实例配置文件
-aws iam create-role --role-name EC2-Bedrock-Access \
-  --assume-role-policy-document '{
-    "Version": "2012-10-17",
-    "Statement": [{
-      "Effect": "Allow",
-      "Principal": {"Service": "ec2.amazonaws.com"},
-      "Action": "sts:AssumeRole"
-    }]
-  }'
-
-aws iam attach-role-policy --role-name EC2-Bedrock-Access \
-  --policy-arn arn:aws:iam::aws:policy/AmazonBedrockFullAccess
-
-aws iam create-instance-profile --instance-profile-name EC2-Bedrock-Access
-aws iam add-role-to-instance-profile \
-  --instance-profile-name EC2-Bedrock-Access \
-  --role-name EC2-Bedrock-Access
-
-# 2. 附加到你的 EC2 实例
-aws ec2 associate-iam-instance-profile \
-  --instance-id i-xxxxx \
-  --iam-instance-profile Name=EC2-Bedrock-Access
-
-# 3. 在 EC2 实例上启用发现功能
-symi config set models.bedrockDiscovery.enabled true
-symi config set models.bedrockDiscovery.region us-east-1
-
-# 4. 设置解决方法所需的环境变量
-echo 'export AWS_PROFILE=default' >> ~/.bashrc
-echo 'export AWS_REGION=us-east-1' >> ~/.bashrc
-source ~/.bashrc
-
-# 5. 验证模型已被发现
-symi models list
-```
-
-## 注意事项
-
-- Bedrock 需要在你的 AWS 账户/区域中启用**模型访问**。
-- 自动发现需要 `bedrock:ListFoundationModels` 权限。
-- 如果你使用配置文件，请在 Gateway 网关主机上设置 `AWS_PROFILE`。
-- Symi 按以下顺序获取凭证来源：`AWS_BEARER_TOKEN_BEDROCK`，然后是 `AWS_ACCESS_KEY_ID` + `AWS_SECRET_ACCESS_KEY`，然后是 `AWS_PROFILE`，最后是默认的 AWS SDK 链。
-- 推理支持取决于模型；请查看 Bedrock 模型卡了解当前功能。
-- 如果你更喜欢托管密钥流程，也可以在 Bedrock 前面放置一个 OpenAI 兼容的代理，并将其配置为 OpenAI 提供商。

package/docs/zh-CN/providers/claude-max-api-proxy.md

@@ -1,155 +0,0 @@
----
-read_when:
-  - 你想将 Claude Max 订阅与 OpenAI 兼容工具配合使用
-  - 你想要一个封装 Claude Code CLI 的本地 API 服务器
-  - 你想通过使用订阅而非 API 密钥来节省费用
-summary: 将 Claude Max/Pro 订阅用作 OpenAI 兼容的 API 端点
-title: Claude Max API 代理
-x-i18n:
-  generated_at: "2026-02-01T21:34:52Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 63b61096b96b720c6d0c317520852db65d72ca8279b3868f35e8387fe3b6ce41
-  source_path: providers/claude-max-api-proxy.md
-  workflow: 15
----
-
-# Claude Max API 代理
-
-**claude-max-api-proxy** 是一个社区工具，将你的 Claude Max/Pro 订阅暴露为 OpenAI 兼容的 API 端点。这使你可以将订阅与任何支持 OpenAI API 格式的工具配合使用。
-
-## 为什么使用它？
-
-| 方式            | 费用                                            | 适用场景                 |
-| --------------- | ----------------------------------------------- | ------------------------ |
-| Anthropic API   | 按 token 计费（Opus 约 $15/M 输入，$75/M 输出） | 生产应用、高流量场景     |
-| Claude Max 订阅 | 每月固定 $200                                   | 个人使用、开发、无限用量 |
-
-如果你有 Claude Max 订阅并希望与 OpenAI 兼容工具配合使用，这个代理可以帮你节省大量费用。
-
-## 工作原理
-
-```
-你的应用 → claude-max-api-proxy → Claude Code CLI → Anthropic（通过订阅）
-     （OpenAI 格式）              （转换格式）           （使用你的登录凭据）
-```
-
-该代理：
-
-1. 在 `http://localhost:3456/v1/chat/completions` 接受 OpenAI 格式的请求
-2. 将其转换为 Claude Code CLI 命令
-3. 以 OpenAI 格式返回响应（支持流式传输）
-
-## 安装
-
-```bash
-# 需要 Node.js 20+ 和 Claude Code CLI
-npm install -g claude-max-api-proxy
-
-# 验证 Claude CLI 已认证
-claude --version
-```
-
-## 使用方法
-
-### 启动服务器
-
-```bash
-claude-max-api
-# 服务器运行在 http://localhost:3456
-```
-
-### 测试
-
-```bash
-# 健康检查
-curl http://localhost:3456/health
-
-# 列出模型
-curl http://localhost:3456/v1/models
-
-# 聊天补全
-curl http://localhost:3456/v1/chat/completions \
-  -H "Content-Type: application/json" \
-  -d '{
-    "model": "claude-opus-4",
-    "messages": [{"role": "user", "content": "Hello!"}]
-  }'
-```
-
-### 与 Symi 配合使用
-
-你可以将 Symi 指向该代理作为自定义 OpenAI 兼容端点：
-
-```json5
-{
-  env: {
-    OPENAI_API_KEY: "not-needed",
-    OPENAI_BASE_URL: "http://localhost:3456/v1",
-  },
-  agents: {
-    defaults: {
-      model: { primary: "openai/claude-opus-4" },
-    },
-  },
-}
-```
-
-## 可用模型
-
-| 模型 ID           | 对应模型        |
-| ----------------- | --------------- |
-| `claude-opus-4`   | Claude Opus 4   |
-| `claude-sonnet-4` | Claude Sonnet 4 |
-| `claude-haiku-4`  | Claude Haiku 4  |
-
-## macOS 自动启动
-
-创建 LaunchAgent 以自动运行代理：
-
-```bash
-cat > ~/Library/LaunchAgents/com.claude-max-api.plist << 'EOF'
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-  <key>Label</key>
-  <string>com.claude-max-api</string>
-  <key>RunAtLoad</key>
-  <true/>
-  <key>KeepAlive</key>
-  <true/>
-  <key>ProgramArguments</key>
-  <array>
-    <string>/usr/local/bin/node</string>
-    <string>/usr/local/lib/node_modules/claude-max-api-proxy/dist/server/standalone.js</string>
-  </array>
-  <key>EnvironmentVariables</key>
-  <dict>
-    <key>PATH</key>
-    <string>/usr/local/bin:/opt/homebrew/bin:~/.local/bin:/usr/bin:/bin</string>
-  </dict>
-</dict>
-</plist>
-EOF
-
-launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.claude-max-api.plist
-```
-
-## 链接
-
-- **npm:** https://www.npmjs.com/package/claude-max-api-proxy
-- **GitHub:** https://github.com/atalovesyou/claude-max-api-proxy
-- **Issues:** https://github.com/atalovesyou/claude-max-api-proxy/issues
-
-## 注意事项
-
-- 这是一个**社区工具**，并非由 Anthropic 或 Symi 官方支持
-- 需要有效的 Claude Max/Pro 订阅并已认证 Claude Code CLI
-- 代理在本地运行，不会将数据发送到任何第三方服务器
-- 完全支持流式响应
-
-## 另请参阅
-
-- [Anthropic 提供商](/providers/anthropic) - Symi 与 Claude 的原生集成，使用 setup-token 或 API 密钥
-- [OpenAI 提供商](/providers/openai) - 适用于 OpenAI/Codex 订阅

package/docs/zh-CN/providers/deepgram.md

@@ -1,97 +0,0 @@
----
-read_when:
-  - 你想使用 Deepgram 语音转文字处理音频附件
-  - 你需要一个快速的 Deepgram 配置示例
-summary: Deepgram 语音转录，用于接收语音消息
-title: Deepgram
-x-i18n:
-  generated_at: "2026-02-01T21:34:47Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 8f19e072f08672116ed1a72578635c0dcebb2b1f0dfcbefa12f80b21a18ad25c
-  source_path: providers/deepgram.md
-  workflow: 15
----
-
-# Deepgram（音频转录）
-
-Deepgram 是一个语音转文字 API。在 Symi 中，它通过 `tools.media.audio` 用于**接收音频/语音消息的转录**。
-
-启用后，Symi 会将音频文件上传到 Deepgram，并将转录文本注入回复管道（`{{Transcript}}` + `[Audio]` 块）。这**不是流式**处理；它使用的是预录音转录端点。
-
-网站：https://deepgram.com  
-文档：https://developers.deepgram.com
-
-## 快速开始
-
-1. 设置你的 API 密钥：
-
-```
-DEEPGRAM_API_KEY=dg_...
-```
-
-2. 启用提供商：
-
-```json5
-{
-  tools: {
-    media: {
-      audio: {
-        enabled: true,
-        models: [{ provider: "deepgram", model: "nova-3" }],
-      },
-    },
-  },
-}
-```
-
-## 选项
-
-- `model`：Deepgram 模型 ID（默认：`nova-3`）
-- `language`：语言提示（可选）
-- `tools.media.audio.providerOptions.deepgram.detect_language`：启用语言检测（可选）
-- `tools.media.audio.providerOptions.deepgram.punctuate`：启用标点符号（可选）
-- `tools.media.audio.providerOptions.deepgram.smart_format`：启用智能格式化（可选）
-
-带语言参数的示例：
-
-```json5
-{
-  tools: {
-    media: {
-      audio: {
-        enabled: true,
-        models: [{ provider: "deepgram", model: "nova-3", language: "en" }],
-      },
-    },
-  },
-}
-```
-
-带 Deepgram 选项的示例：
-
-```json5
-{
-  tools: {
-    media: {
-      audio: {
-        enabled: true,
-        providerOptions: {
-          deepgram: {
-            detect_language: true,
-            punctuate: true,
-            smart_format: true,
-          },
-        },
-        models: [{ provider: "deepgram", model: "nova-3" }],
-      },
-    },
-  },
-}
-```
-
-## 注意事项
-
-- 认证遵循标准提供商认证顺序；`DEEPGRAM_API_KEY` 是最简单的方式。
-- 使用代理时，可通过 `tools.media.audio.baseUrl` 和 `tools.media.audio.headers` 覆盖端点或请求头。
-- 输出遵循与其他提供商相同的音频规则（大小限制、超时、转录文本注入）。

package/docs/zh-CN/providers/github-copilot.md

@@ -1,67 +0,0 @@
----
-read_when:
-  - 你想使用 GitHub Copilot 作为模型提供商
-  - 你需要了解 `symi models auth login-github-copilot` 流程
-summary: 使用设备流从 Symi 登录 GitHub Copilot
-title: GitHub Copilot
-x-i18n:
-  generated_at: "2026-02-01T21:34:57Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 503e0496d92c921e2f7111b1b4ba16374f5b781643bfbc6cb69cea97d9395c25
-  source_path: providers/github-copilot.md
-  workflow: 15
----
-
-# GitHub Copilot
-
-## 什么是 GitHub Copilot？
-
-GitHub Copilot 是 GitHub 的 AI 编程助手。它为你的 GitHub 账户和订阅计划提供 Copilot 模型的访问权限。Symi 可以通过两种不同的方式将 Copilot 用作模型提供商。
-
-## 在 Symi 中使用 Copilot 的两种方式
-
-### 1）内置 GitHub Copilot 提供商（`github-copilot`）
-
-使用原生设备登录流程获取 GitHub 令牌，然后在 Symi 运行时将其兑换为 Copilot API 令牌。这是**默认**且最简单的方式，因为它不需要 VS Code。
-
-### 2）Copilot Proxy 插件（`copilot-proxy`）
-
-使用 **Copilot Proxy** VS Code 扩展作为本地桥接。Symi 与代理的 `/v1` 端点通信，并使用你在其中配置的模型列表。当你已经在 VS Code 中运行 Copilot Proxy 或需要通过它进行路由时，选择此方式。你必须启用该插件并保持 VS Code 扩展运行。
-
-使用 GitHub Copilot 作为模型提供商（`github-copilot`）。登录命令运行 GitHub 设备流程，保存认证配置文件，并更新你的配置以使用该配置文件。
-
-## CLI 设置
-
-```bash
-symi models auth login-github-copilot
-```
-
-系统会提示你访问一个 URL 并输入一次性代码。请保持终端打开直到流程完成。
-
-### 可选参数
-
-```bash
-symi models auth login-github-copilot --profile-id github-copilot:work
-symi models auth login-github-copilot --yes
-```
-
-## 设置默认模型
-
-```bash
-symi models set github-copilot/gpt-4o
-```
-
-### 配置片段
-
-```json5
-{
-  agents: { defaults: { model: { primary: "github-copilot/gpt-4o" } } },
-}
-```
-
-## 注意事项
-
-- 需要交互式 TTY；请直接在终端中运行。
-- Copilot 模型的可用性取决于你的订阅计划；如果某个模型被拒绝，请尝试其他 ID（例如 `github-copilot/gpt-4.1`）。
-- 登录会将 GitHub 令牌存储在认证配置文件中，并在 Symi 运行时将其兑换为 Copilot API 令牌。

package/docs/zh-CN/providers/glm.md

@@ -1,39 +0,0 @@
----
-read_when:
-  - 你想在 Symi 中使用 GLM 模型
-  - 你需要了解模型命名规范和设置方法
-summary: GLM 模型系列概述 + 如何在 Symi 中使用
-title: GLM 模型
-x-i18n:
-  generated_at: "2026-02-01T21:34:53Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 2d7b457f033f26f28c230a9cd2310151f825fc52c3ee4fb814d08fd2d022d041
-  source_path: providers/glm.md
-  workflow: 15
----
-
-# GLM 模型
-
-GLM 是一个**模型系列**（而非公司），通过 Z.AI 平台提供。在 Symi 中，GLM 模型通过 `zai` 提供商访问，模型 ID 格式如 `zai/glm-4.7`。
-
-## CLI 设置
-
-```bash
-symi onboard --auth-choice zai-api-key
-```
-
-## 配置片段
-
-```json5
-{
-  env: { ZAI_API_KEY: "sk-..." },
-  agents: { defaults: { model: { primary: "zai/glm-4.7" } } },
-}
-```
-
-## 注意事项
-
-- GLM 版本和可用性可能会变化；请查阅 Z.AI 的文档获取最新信息。
-- 示例模型 ID 包括 `glm-4.7` 和 `glm-4.6`。
-- 有关提供商的详细信息，请参阅 [/providers/zai](/providers/zai)。

package/docs/zh-CN/providers/index.md

@@ -1,66 +0,0 @@
----
-read_when:
-  - 你想选择一个模型提供商
-  - 你需要快速了解支持的 LLM 后端
-summary: Symi 支持的模型提供商（LLM）
-title: 模型提供商
-x-i18n:
-  generated_at: "2026-02-03T07:53:32Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: eb4a97438adcf610499253afcf8b2af6624f4be098df389a6c3746f14c4a901b
-  source_path: providers/index.md
-  workflow: 15
----
-
-# 模型提供商
-
-Symi 可以使用许多 LLM 提供商。选择一个提供商，进行认证，然后将默认模型设置为 `provider/model`。
-
-## 亮点：Venice（Venice AI）
-
-Venice 是我们推荐的 Venice AI 设置，用于隐私优先的推理，并可选择使用 Opus 处理困难任务。
-
-- 默认：`venice/llama-3.3-70b`
-- 最佳综合：`venice/claude-opus-45`（Opus 仍然是最强的）
-
-参见 [Venice AI](/providers/venice)。
-
-## 快速开始
-
-1. 与提供商进行认证（通常通过 `symi onboard`）。
-2. 设置默认模型：
-
-```json5
-{
-  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-5" } } },
-}
-```
-
-## 提供商文档
-
-- [OpenAI（API + Codex）](/providers/openai)
-- [Anthropic（API + Claude Code CLI）](/providers/anthropic)
-- [Qwen（OAuth）](/providers/qwen)
-- [OpenRouter](/providers/openrouter)
-- [Vercel AI Gateway](/providers/vercel-ai-gateway)
-- [Moonshot AI（Kimi + Kimi Coding）](/providers/moonshot)
-- [OpenCode Zen](/providers/opencode)
-- [Amazon Bedrock](/providers/bedrock)
-- [Z.AI](/providers/zai)
-- [Xiaomi](/providers/xiaomi)
-- [GLM 模型](/providers/glm)
-- [MiniMax](/providers/minimax)
-- [Venice（Venice AI，注重隐私）](/providers/venice)
-- [Ollama（本地模型）](/providers/ollama)
-
-## 转录提供商
-
-- [Deepgram（音频转录）](/providers/deepgram)
-
-## 社区工具
-
-- [Claude Max API Proxy](/providers/claude-max-api-proxy) - 将 Claude Max/Pro 订阅作为 OpenAI 兼容的 API 端点使用
-
-有关完整的提供商目录（xAI、Groq、Mistral 等）和高级配置，
-参见[模型提供商](/concepts/model-providers)。