diff --git a/Project/fonrey/ADR.md b/Project/fonrey/ADR.md index bea79918..aaf247eb 100644 --- a/Project/fonrey/ADR.md +++ b/Project/fonrey/ADR.md @@ -8,13 +8,13 @@ ## 变更历史 -| 日期 | 变更人 | 变更内容 | -|---|---|---| -| 2026-04-30 | Atlas | 初始化 ADR 动态决策记录；补录当日关键技术与需求决策 | -| 2026-05-02 | Sisyphus | 新增 ADR-20260502-001：合并系统管理与客户端发布两份 PRD 为统一的『平台管理后台 PRD』，原文件删除 | -| 2026-05-02 | Sisyphus | 新增 ADR-20260502-003：定义『PRD 与 Tech 文档职责边界』规则（PRD 管 what/why、Tech 管 how）；首次落地于登录管理 PRD v3.0 | +| 日期 | 变更人 | 变更内容 | +| ---------- | -------- | ------------------------------------------------------------------------------------------------------------------------ | +| 2026-04-30 | Atlas | 初始化 ADR 动态决策记录；补录当日关键技术与需求决策 | +| 2026-05-02 | Sisyphus | 新增 ADR-20260502-001：合并系统管理与客户端发布两份 PRD 为统一的『平台管理后台 PRD』，原文件删除 | +| 2026-05-02 | Sisyphus | 新增 ADR-20260502-003：定义『PRD 与 Tech 文档职责边界』规则（PRD 管 what/why、Tech 管 how）；首次落地于登录管理 PRD v3.0 | | 2026-06-04 | Sisyphus | 新增 ADR-20260604-001：列表分页全局采用 Keyset(cursor)，允许 page-based 作过渡兼容；同步修订 `UI_DESIGN/ROUTES.md` 与 `UI_DESIGN/房源管理/房源列表_UI.md` | -| 2026-06-04 | Sisyphus | 新增 ADR-20260604-002：ROUTES.md 客源条目"重复客源(成交)"与"重复客源(公客)"合并为单条 `/clients/duplicates/?tab=transacted\|public`，客源条目数稳定为 19 | +| 2026-06-04 | Sisyphus | 新增 ADR-20260604-002：ROUTES.md 客源条目"重复客源(成交)"与"重复客源(公客)"合并为单条 `/clients/duplicates/?tab=transacted\|public`，客源条目数稳定为 19 | ## 一、记录规范（必须遵守） diff --git a/ishenwei/慧世睿联/公司信息.md b/ishenwei/慧世睿联/公司信息.md index 8dffa3b6..0616702f 100644 --- a/ishenwei/慧世睿联/公司信息.md +++ b/ishenwei/慧世睿联/公司信息.md @@ -1,4 +1,4 @@ - +#慧世睿联 #公司信息 #统一社会信用代码 #办公地址 #经营范围 ## 公司名称 上海慧世睿联科技有限公司 diff --git a/ishenwei/沈玮 个人简历.md b/ishenwei/沈玮 个人简历.md new file mode 100644 index 00000000..f6751dad --- /dev/null +++ b/ishenwei/沈玮 个人简历.md @@ -0,0 +1,21 @@ + +情况说明： + +- 男性 出生日期：1978年2月20日， 48岁， 上海户籍 +- 2000年上海工程技术大学 材料工程专业 本科毕业 +- 工作经历 + - 2000~2003 金宝电子上海有限公司 + - 2003~2006 奥太软件上海有限公司 + - 2006~2026 + - 2006~2015 上海惠普有限公司 (HP) + - 2015 ~2026 上海微福斯软件科技有限公司 (MicroFocus/Opentext) 公司收购转移 +- 工作职责 + - 大型商用SaaS系统全球系统运维负责人 + - 带领全球团队负责公司商用软件SaaS运维工作 (24x7) +- 个人能力 + - 大型软件系统运维管理，调度。自动化部署，应急响应，系统监控，安全防护等。 + - 精通国际主流云计算服务AWS, GCP, Azure 等 + - 国际化团队管理，跨时区员工管理 + - 精通英语，流利交流 + - 熟悉目前最新AI技术：AI编程 多媒体实现 + - 深耕IT软件开发领域25年，产品开发，软件工程，运维实施全链路精通 diff --git a/knowledgebase/CUE+WAV分割与高质量MP3转换.md b/knowledgebase/CUE+WAV分割与高质量MP3转换.md index 9a35553b..44f952c2 100644 --- a/knowledgebase/CUE+WAV分割与高质量MP3转换.md +++ b/knowledgebase/CUE+WAV分割与高质量MP3转换.md @@ -3,7 +3,7 @@ title: CUE + WAV 分割与高质量 MP3 转换 date: 2026-05-20 tags: [audio, cue, wav, mp3, ffmpeg, linux] --- - +#audio #cue #wav #mp3 #ffmepg #linux # CUE + WAV 分割与高质量 MP3 转换 这篇笔记记录如何在命令行下，把一张专辑常见的 `cue + wav` 形式，切分成单曲，并转换成高质量 MP3。 diff --git a/knowledgebase/Codex接入阿里云百炼Token Plan配置方法.md b/knowledgebase/Codex接入阿里云百炼Token Plan配置方法.md new file mode 100644 index 00000000..86c06817 --- /dev/null +++ b/knowledgebase/Codex接入阿里云百炼Token Plan配置方法.md @@ -0,0 +1,539 @@ +--- +title: "Codex" +source: "https://help.aliyun.com/zh/model-studio/codex?utm_source=chatgpt.com" +author: +published: +created: 2026-09-03 +description: "Codex 是 OpenAI 推出的终端 AI 编程助手。可通过 Token Plan 个人版、Token Plan 团队版、Coding Plan 或按量计费接入阿里云百炼。" +tags: + - "clippings" +--- +#codex #openai #aliyun #阿里云百炼 #api-key #coding-plan +Codex 是 OpenAI 推出的终端 AI 编程助手。可通过 Token Plan 个人版、Token Plan 团队版、Coding Plan 或按量计费接入阿里云百炼。 + +## 安装 Codex + +1. 安装或更新 [Node.js](https://nodejs.org/en/download/) （v18.0 或更高版本）。 +2. 在终端中执行以下命令安装 Codex。 + +```bash +npm install -g @openai/codex +``` + +执行以下命令验证安装。 + +```bash +codex --version +``` + +## 配置接入凭证 + +接入需要编辑配置文件 `~/.codex/config.toml` 并配置环境变量 `OPENAI_API_KEY` 。请根据您的接入方式选择对应配置。 + +### 配置模型元数据 + +使用自定义模型（如 qwen3.8-max）时，需要配置模型元数据文件，使 Codex 正确识别模型的上下文窗口、推理深度等参数。 + +1. 新建文件 `~/.codex/model-catalog.local.json` ，写入以下内容： + +```json +{ + "models": [ + { + "slug": "qwen3.8-max", + "display_name": "qwen3.8-max", + "description": "DashScope model: qwen3.8-max", + "default_reasoning_level": "xhigh", + "supported_reasoning_levels": [ + { + "effort": "low", + "description": "Fast responses with lighter reasoning" + }, + { + "effort": "medium", + "description": "Greater reasoning depth for complex problems" + }, + { + "effort": "xhigh", + "description": "Extra high reasoning depth for complex problems" + } + ], + "context_window": 983616, + "effective_context_window_percent": 95, + "supports_parallel_tool_calls": false, + "supports_image_detail_original": true, + "input_modalities": ["text", "image"], + "shell_type": "default", + "visibility": "list", + "supported_in_api": true, + "priority": 1, + "base_instructions": "", + "support_verbosity": false, + "supports_reasoning_summaries": false, + "experimental_supported_tools": [], + "truncation_policy": { + "mode": "bytes", + "limit": 10000 + } + } + ] +} +``` + +2. 在 `~/.codex/config.toml` 中添加以下配置，指向元数据文件： + +``` +model_catalog_json = "~/.codex/model-catalog.local.json" +``` + +### Token Plan 个人版 + +`model` 请选择 [支持的模型](https://help.aliyun.com/zh/model-studio/token-plan-personal-overview) 。将 `OPENAI_API_KEY` 环境变量设置为 Token Plan 个人版专属 [API Key](https://bailian.console.aliyun.com/cn-beijing?tab=plan#/efm/subscription/overview) 。 + +#### Responses API + +若所选模型支持 [OpenAI Responses API](https://help.aliyun.com/zh/model-studio/qwen-api-via-openai-responses) ，可使用最新版 Codex。 + +``` +model_provider = "Model_Studio_Token_Plan_Personal" +model = "qwen3.8-max" +[model_providers.Model_Studio_Token_Plan_Personal] +name = "Model_Studio_Token_Plan_Personal" +base_url = "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1" +env_key = "OPENAI_API_KEY" +wire_api = "responses" +``` + +#### Chat/Completions API（其他模型） + +其他模型需通过 Chat/Completions API 接入，需安装旧版本 Codex，如 0.80.0（新版本 Codex 已不再支持 wire\_api = "chat" 配置，升级后如遇报错请参见下文 FAQ）： + +```bash +npm install -g @openai/codex@0.80.0 +``` + +``` +model_provider = "Model_Studio_Token_Plan_Personal" +model = "glm-5" +[model_providers.Model_Studio_Token_Plan_Personal] +name = "Model_Studio_Token_Plan_Personal" +base_url = "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1" +env_key = "OPENAI_API_KEY" +wire_api = "chat" +``` + +#### 配置环境变量 + +将 `OPENAI_API_KEY` 环境变量设置为 Token Plan 个人版专属 API Key。 + +1. 在终端中执行以下命令，查看默认 Shell 类型。 + +```bash +echo $SHELL +``` + +2. 根据 Shell 类型设置环境变量： + ```bash + # 将 YOUR_API_KEY 替换为 Token Plan 个人版 API Key + echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc + ``` + ```bash + # 将 YOUR_API_KEY 替换为 Token Plan 个人版 API Key + echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.bash_profile + ``` +3. 执行以下命令使环境变量生效。 + ```bash + source ~/.zshrc + ``` + ```bash + source ~/.bash_profile + ``` + +1. 在 CMD 中运行以下命令，设置环境变量。 + +``` +REM 将 YOUR_API_KEY 替换为 Token Plan 个人版 API Key +setx OPENAI_API_KEY "YOUR_API_KEY" +``` + +2. 打开一个新的 CMD 窗口，运行以下命令检查环境变量是否生效。 + +``` +echo %OPENAI_API_KEY% +``` + +1. 在 PowerShell 中运行以下命令，设置环境变量。 + +```powershell +# 将 YOUR_API_KEY 替换为 Token Plan 个人版 API Key +[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User) +``` + +2. 打开一个新的 PowerShell 窗口，运行以下命令检查环境变量是否生效。 + +```powershell +echo $env:OPENAI_API_KEY +``` + +### Token Plan 团队版 + +`model` 请选择 [支持的模型](https://help.aliyun.com/zh/model-studio/token-plan-overview) 。将 `OPENAI_API_KEY` 环境变量设置为 Token Plan 团队版专属 [API Key](https://bailian.console.aliyun.com/cn-beijing?tab=plan#/efm/subscription/uac-admin/organization/members/list) 。 + +#### Responses API + +若所选模型支持 [OpenAI Responses API](https://help.aliyun.com/zh/model-studio/qwen-api-via-openai-responses) ，可使用最新版 Codex。 + +``` +model_provider = "Model_Studio_Token_Plan" +model = "qwen3.8-max" +[model_providers.Model_Studio_Token_Plan] +name = "Model_Studio_Token_Plan" +base_url = "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1" +env_key = "OPENAI_API_KEY" +wire_api = "responses" +``` + +#### Chat/Completions API（其他模型） + +其他模型需通过 Chat/Completions API 接入，需安装旧版本 Codex，如 0.80.0（新版本 Codex 已不再支持 wire\_api = "chat" 配置，升级后如遇报错请参见下文 FAQ）： + +```bash +npm install -g @openai/codex@0.80.0 +``` + +``` +model_provider = "Model_Studio_Token_Plan" +model = "glm-5" +[model_providers.Model_Studio_Token_Plan] +name = "Model_Studio_Token_Plan" +base_url = "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1" +env_key = "OPENAI_API_KEY" +wire_api = "chat" +``` + +#### 配置环境变量 + +将 `OPENAI_API_KEY` 环境变量设置为 Token Plan 团队版专属 API Key。 + +1. 在终端中执行以下命令，查看默认 Shell 类型。 + +```bash +echo $SHELL +``` + +2. 根据 Shell 类型设置环境变量： + ```bash + # 将 YOUR_API_KEY 替换为 Token Plan 团队版 API Key + echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc + ``` + ```bash + # 将 YOUR_API_KEY 替换为 Token Plan 团队版 API Key + echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.bash_profile + ``` +3. 执行以下命令使环境变量生效。 + ```bash + source ~/.zshrc + ``` + ```bash + source ~/.bash_profile + ``` + +1. 在 CMD 中运行以下命令，设置环境变量。 + +``` +REM 将 YOUR_API_KEY 替换为 Token Plan 团队版 API Key +setx OPENAI_API_KEY "YOUR_API_KEY" +``` + +2. 打开一个新的 CMD 窗口，运行以下命令检查环境变量是否生效。 + +``` +echo %OPENAI_API_KEY% +``` + +1. 在 PowerShell 中运行以下命令，设置环境变量。 + +```powershell +# 将 YOUR_API_KEY 替换为 Token Plan 团队版 API Key +[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User) +``` + +2. 打开一个新的 PowerShell 窗口，运行以下命令检查环境变量是否生效。 + +```powershell +echo $env:OPENAI_API_KEY +``` + +### Coding Plan + +`model` 请选择 [支持的模型](https://help.aliyun.com/zh/model-studio/coding-plan) 。将 `OPENAI_API_KEY` 环境变量设置为 Coding Plan 专属 [API Key](https://bailian.console.aliyun.com/cn-beijing/?tab=model#/efm/coding_plan) 。 + +#### Chat/Completions API + +Coding Plan 仅支持 Chat/Completions API，需安装旧版本 Codex，如 0.80.0（新版本 Codex 已不再支持 wire\_api = "chat" 配置，升级后如遇报错请参见下文 FAQ）： + +```bash +npm install -g @openai/codex@0.80.0 +``` + +``` +model_provider = "Model_Studio_Coding_Plan" +model = "qwen3.7-plus" +[model_providers.Model_Studio_Coding_Plan] +name = "Model_Studio_Coding_Plan" +base_url = "https://coding.dashscope.aliyuncs.com/v1" +env_key = "OPENAI_API_KEY" +wire_api = "chat" +``` + +#### 配置环境变量 + +将 `OPENAI_API_KEY` 环境变量设置为 Coding Plan 专属 API Key。 + +1. 在终端中执行以下命令，查看默认 Shell 类型。 + +```bash +echo $SHELL +``` + +2. 根据 Shell 类型设置环境变量： + ```bash + # 将 YOUR_API_KEY 替换为 Coding Plan API Key + echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc + ``` + ```bash + # 将 YOUR_API_KEY 替换为 Coding Plan API Key + echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.bash_profile + ``` +3. 执行以下命令使环境变量生效。 + ```bash + source ~/.zshrc + ``` + ```bash + source ~/.bash_profile + ``` + +1. 在 CMD 中运行以下命令，设置环境变量。 + +``` +REM 将 YOUR_API_KEY 替换为 Coding Plan API Key +setx OPENAI_API_KEY "YOUR_API_KEY" +``` + +2. 打开一个新的 CMD 窗口，运行以下命令检查环境变量是否生效。 + +``` +echo %OPENAI_API_KEY% +``` + +1. 在 PowerShell 中运行以下命令，设置环境变量。 + +```powershell +# 将 YOUR_API_KEY 替换为 Coding Plan API Key +[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User) +``` + +2. 打开一个新的 PowerShell 窗口，运行以下命令检查环境变量是否生效。 + +```powershell +echo $env:OPENAI_API_KEY +``` + +### 按量计费 + +将 `OPENAI_API_KEY` 环境变量设置为 [百炼 API Key](https://help.aliyun.com/zh/model-studio/get-api-key) 。可用模型参见 [支持的模型](https://help.aliyun.com/zh/model-studio/compatibility-of-openai-with-dashscope#7f9c78ae99pwz) 。 + +根据地域设置 `base_url` ，API Key 须与所选地域对应，请将 URL 中的 `{WorkspaceId}` 替换为真实的 [获取Workspace ID](https://help.aliyun.com/zh/model-studio/obtain-the-app-id-and-workspace-id#732535cfc959h) ： + +- 华北2（北京）： `https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1` +- 新加坡： `https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1` + +按量计费支持 Responses API 和 Chat/Completions API 两种接入方式，请根据使用的模型选择： + +#### Responses API + +适用于支持 [OpenAI Responses API](https://help.aliyun.com/zh/model-studio/qwen-api-via-openai-responses) 的模型（如 qwen3.7-max），可使用最新版 Codex。 + +``` +model_provider = "Model_Studio" +model = "qwen3.7-max" +[model_providers.Model_Studio] +name = "Model_Studio" +base_url = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1" +env_key = "OPENAI_API_KEY" +wire_api = "responses" +``` + +#### Chat/Completions API + +适用于仅支持 Chat/Completions API 的模型，需安装 Codex 0.80.0（新版本 Codex 已不再支持 wire\_api = "chat" 配置，升级后如遇报错请参见下文 FAQ）： + +```bash +npm install -g @openai/codex@0.80.0 +``` + +``` +model_provider = "Model_Studio" +model = "qwen3.6-plus" +[model_providers.Model_Studio] +name = "Model_Studio" +base_url = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1" +env_key = "OPENAI_API_KEY" +wire_api = "chat" +``` + +#### 配置环境变量 + +将 `OPENAI_API_KEY` 环境变量设置为 [百炼 API Key](https://help.aliyun.com/zh/model-studio/get-api-key) 。 + +1. 在终端中执行以下命令，查看默认 Shell 类型。 + +```bash +echo $SHELL +``` + +2. 根据 Shell 类型设置环境变量： + ```bash + # 将 YOUR_API_KEY 替换为百炼 API Key + echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc + ``` + ```bash + # 将 YOUR_API_KEY 替换为百炼 API Key + echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.bash_profile + ``` +3. 执行以下命令使环境变量生效。 + ```bash + source ~/.zshrc + ``` + ```bash + source ~/.bash_profile + ``` + +1. 在 CMD 中运行以下命令，设置环境变量。 + +``` +REM 将 YOUR_API_KEY 替换为百炼 API Key +setx OPENAI_API_KEY "YOUR_API_KEY" +``` + +2. 打开一个新的 CMD 窗口，运行以下命令检查环境变量是否生效。 + +``` +echo %OPENAI_API_KEY% +``` + +1. 在 PowerShell 中运行以下命令，设置环境变量。 + +```powershell +# 将 YOUR_API_KEY 替换为百炼 API Key +[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User) +``` + +2. 打开一个新的 PowerShell 窗口，运行以下命令检查环境变量是否生效。 + +```powershell +echo $env:OPENAI_API_KEY +``` + +## 验证配置 + +配置完成后，新建终端窗口，执行以下命令启动 Codex： + +```bash +codex +``` + +如果正常进入对话界面，说明配置成功。 + +## 使用 CC Switch + +[CC Switch](https://github.com/farion1231/cc-switch) 是社区开源的桌面 GUI，支持在多个 API Key 或计费套餐之间一键切换，无需手动修改 `~/.codex/config.toml` 。 + +### 安装 + +- macOS：执行 `brew tap farion1231/ccswitch && brew install --cask cc-switch` ，或从 [Releases](https://github.com/farion1231/cc-switch/releases) 下载 `.dmg` 。 +- Windows：从 [Releases](https://github.com/farion1231/cc-switch/releases) 下载 `.msi` 安装包或便携版 `.zip` 。 +- Linux：Arch 发行版执行 `paru -S cc-switch-bin` ；其他发行版从 [Releases](https://github.com/farion1231/cc-switch/releases) 下载 `.deb` / `.rpm` / `.AppImage` 。 + +### 添加供应商 + +1. 在 CC Switch 主界面顶部图标栏选中 Codex 图标，点击右上角 **+** 进入 **添加新供应商** ，按下表填入配置后点击 **添加** 。 + | **计费方案** | **配置信息** | + | --- | --- | + | Token Plan 个人版 | 供应商名称：百炼-Token Plan 个人版 API Key： [控制台获取](https://bailian.console.aliyun.com/cn-beijing?tab=plan#/efm/subscription/overview) 请求地址： `https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1` | + | Token Plan 团队版 | 供应商名称：百炼-Token Plan 团队版 API Key： [控制台获取](https://bailian.console.aliyun.com/cn-beijing?tab=plan#/efm/subscription/uac-admin/organization/members/list) 请求地址： `https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1` | + | Coding Plan | 供应商名称：百炼-Coding Plan API Key： [控制台获取](https://bailian.console.aliyun.com/cn-beijing/?tab=model#/efm/coding_plan) 请求地址： `https://coding.dashscope.aliyuncs.com/v1` | + | 按量计费 | 供应商名称：百炼-按量计费 API Key： [百炼 API Key](https://help.aliyun.com/zh/model-studio/get-api-key) 请求地址： `https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1` | +2. 展开 **高级选项** 填写模型名称，从对应套餐 [支持的模型](https://help.aliyun.com/zh/model-studio/token-plan-overview) 中选择，例如 `qwen3.7-max` （Coding Plan 不支持）。 +3. 回到主界面，点击该供应商右侧 **启用** 按钮，然后重新打开终端窗口执行 `codex` 使配置生效。 + +## 常见问题 + +### 第三方工具提示“不支持国内模型”或“检查被拒 / Bad request (400)”怎么办？ + +**原因** ：部分第三方管理工具（如 CC-Switch）在切换供应商时会发起“健康检查/连接测试”探测请求，该探测请求的格式与 Codex 实际调用的请求格式不同，百炼网关可能因此返回 400 Bad request 并提示“检查被拒”，工具据此显示“不支持国内模型”。此提示仅代表健康检查探测未通过， **并不代表百炼不支持中国内地模型，也不影响 Codex 的实际使用。** + +**说明** ：百炼支持通过 Codex 使用中国内地模型，配置方式详见上文 [配置接入凭证](https://help.aliyun.com/zh/model-studio/codex#cdx-config-h) 。 + +**解决方案** ：建议参照上文配置接入凭证，直接在 `~/.codex/config.toml` 中完成配置，无需依赖第三方工具的健康检查结果；配置完成后参照 [验证配置](https://help.aliyun.com/zh/model-studio/codex#cdx-verify-h) 启动 Codex，若能正常进入对话界面即表示可正常使用中国内地模型。 + +### 报错 wire\_api 配置问题怎么办？ + +**原因** ：Codex 新版本不再支持 `wire_api = "chat"` 配置。根据版本不同，可能出现以下报错： + +- `wire_api = "chat" is no longer supported` +- `unknown configuration field wire_api` + +**解决方案** ： + +- 报错 `wire_api = "chat" is no longer supported` ：将配置文件中的 `wire_api` 改为 `responses` ，并确认 `base_url` 配置正确。详见上文 [配置接入凭证](https://help.aliyun.com/zh/model-studio/codex#cdx-config-h) 中对应方案的配置示例。 +- 报错 `unknown configuration field wire_api` ：从配置文件 `~/.codex/config.toml` 的对应 provider 节中删除 `wire_api` 字段。 + +### 报错 unexpected status 401 Unauthorized 怎么办？ + +**原因** ： + +- 误用了其他方案的 API Key（Token Plan 个人版、Token Plan 团队版、Coding Plan 和按量计费的 API Key 互不相通） +- 订阅过期 +- API Key 复制不完整、有空格或拼写错误 + +**解决方案** ： + +- 确认使用的是所选方案对应的专属 API Key。 +- 前往对应方案的管理页面确认订阅是否过期。 +- 重新复制 API Key，确保完整且无空格。 +- 如以上均正常仍报错，可在对应管理页面重置 API Key，重置后请使用新 API Key 进行配置。 + +### 报错 unexpected status 404 Not Found 怎么办？ + +**原因** ：配置文件中的 `base_url` 或 `wire_api` 填写错误。 + +**解决方案** ：确认 `base_url` 和 `wire_api` 与所选方案的配置一致。参见上文 [配置接入凭证](https://help.aliyun.com/zh/model-studio/codex#cdx-config-h) 中对应方案的配置示例。 + +### 报错 stream disconnected before completion: stream closed before response.completed 怎么办？ + +**原因** ：Codex 与服务端的流式连接在响应完成前断开。常见于以下场景： + +- 对话线程过长，Codex 触发上下文压缩时请求失败 +- 网络不稳定，SSE 或 WebSocket 连接中途断开 +- 服务端过载或触发限流，提前终止连接 + +**解决方案** ： + +- 开启新的对话线程，避免单个线程积累过多上下文。 +- 检查网络连接是否稳定，关闭 VPN 或代理后重试。 +- 等待一段时间后重试，Codex 内置了自动重试机制，多数情况下重试可恢复。 + +### 报错 429 请求超频或额度用尽怎么办？ + +**原因** ：429 错误有以下两种情形： + +- **请求超频** （ `429 Requests rate limit exceeded` ）：短时间内请求过于密集。 +- **限额用尽** （ `429 Allocated quota exceeded` 或 `Your token-plan 1-week quota has been exhausted` ）：Token Plan 个人版的 7 天限额触顶。 + +**解决方案** ： + +- 请求超频：等待一分钟后重试，降低请求频率。 +- 限额用尽：等待 7 天窗口周期结束后额度自动重置；或购买用量包（用量包额度不受窗口限额约束）；或升级套餐。注意：报错信息中的重置时间（如 `The quota will reset at HH:MM:SS UTC` ）以协调世界时（UTC）为准，换算为北京时间（CST）需加 8 小时。 + +[[Hermes Agent接入阿里云百炼Token Plan]] \ No newline at end of file diff --git a/knowledgebase/Hermes Agent接入阿里云百炼Token Plan.md b/knowledgebase/Hermes Agent接入阿里云百炼Token Plan.md new file mode 100644 index 00000000..cc63778f --- /dev/null +++ b/knowledgebase/Hermes Agent接入阿里云百炼Token Plan.md @@ -0,0 +1,184 @@ +--- +title: "更多工具" +source: "https://help.aliyun.com/zh/model-studio/hermes-agent?spm=a2c4g.11186623.help-menu-2400256.d_0_4_1.525b1fe88PXBk7" +author: +published: +created: 2026-09-03 +description: "除已列出的工具外，阿里云百炼还支持接入兼容 OpenAI / Anthropic API 协议且支持自定义服务端点的第三方编程工具。可通过按量计费、Coding Plan、Token Plan 个人版或 Token Plan 团队版接入。" +tags: + - "clippings" +--- +#hermes #agents #阿里云百炼 #token-plan #coding-plan + +Hermes Agent 是一款终端 AI 编程工具，可以通过按量计费、Coding Plan、Token Plan 个人版或 Token Plan 团队版接入阿里云百炼。 + +## 安装 Hermes Agent + +1. 在终端中执行以下命令安装 Hermes Agent，安装脚本会自动安装 Python、Git 等依赖。 + +```bash +curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash +``` + +**说明** + +Windows 不支持原生安装，请先安装 [WSL2](https://learn.microsoft.com/en-us/windows/wsl/install) ，在 WSL2 中运行以上命令。 + +2. 安装完成后，重新加载终端环境。 + +```bash +source ~/.bashrc # 如果使用 zsh，改为 source ~/.zshrc +``` + +3. 运行以下命令验证安装。若有版本号输出，则表示安装成功。 + +```bash +hermes --version +``` + +## 配置接入凭证 + +通过 `hermes config set` 命令配置接入参数，根据所选方案填入对应的 Base URL 和 API Key： + +- **Token Plan 个人版** ：个人订阅，按 token 消耗抵扣 Credits。 +- **Token Plan 团队版** ：按坐席订阅，按 token 消耗抵扣 Credits。 +- **Coding Plan** ：固定月费订阅，按模型调用次数计量。 +- **按量计费** ：按实际调用量后付费。 + +**说明** + +本文示例均使用 **Anthropic 兼容协议** ：Base URL 以 `/apps/anthropic` 结尾，并将 `api_mode` 设为 `anthropic_messages` 。Hermes Agent 同样支持 **OpenAI 兼容协议** ：将 Base URL 结尾的 `/apps/anthropic` 替换为 `/compatible-mode/v1` ，并删除 `api_mode` 配置项即可。例如按量计费（华北2·北京）的 OpenAI 兼容 Base URL 为 `https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1` 。 + +除命令行版外，Hermes Agent 还提供桌面版（Hermes Desktop）。可从 [Hermes 官网](https://hermes-agent.nousresearch.com/) 下载安装包，或在命令行版安装完成后运行 `hermes desktop` 启动。桌面版与命令行版共用同一份 `~/.hermes/config.yaml` 配置文件，接入参数与本文一致；在桌面版中以自定义端点（Custom Endpoint）方式接入时，请使用上述 OpenAI 兼容 Base URL。 + +### Token Plan 个人版 + +将 `YOUR_API_KEY` 替换为 Token Plan 个人版专属 [API Key](https://bailian.console.aliyun.com/cn-beijing?tab=plan#/efm/subscription/overview) 。可用模型请参考 Token Plan 个人版 [支持的模型](https://help.aliyun.com/zh/model-studio/token-plan-personal-overview) 。 + +```bash +hermes config set model.provider custom +hermes config set model.base_url https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic +hermes config set model.api_mode anthropic_messages +hermes config set model.api_key YOUR_API_KEY +hermes config set model.default qwen3.8-max +``` + +以上命令将配置写入 `~/.hermes/config.yaml` 。也可以直接编辑该文件，写入以下内容： + +config.yaml 配置示例 + +```yaml +model: + default: qwen3.8-max + provider: custom + base_url: https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic + api_mode: anthropic_messages + api_key: YOUR_API_KEY +``` + +### Token Plan 团队版 + +将 `YOUR_API_KEY` 替换为 Token Plan 团队版专属 [API Key](https://bailian.console.aliyun.com/cn-beijing?tab=plan#/efm/subscription/uac-admin/organization/members/list) 。可用模型请参考 Token Plan 团队版 [支持的模型](https://help.aliyun.com/zh/model-studio/token-plan-overview) 。 + +```bash +hermes config set model.provider custom +hermes config set model.base_url https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic +hermes config set model.api_mode anthropic_messages +hermes config set model.api_key YOUR_API_KEY +hermes config set model.default qwen3.8-max +``` + +以上命令将配置写入 `~/.hermes/config.yaml` 。也可以直接编辑该文件，写入以下内容： + +config.yaml 配置示例 + +```yaml +model: + default: qwen3.8-max + provider: custom + base_url: https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic + api_mode: anthropic_messages + api_key: YOUR_API_KEY +``` + +### Coding Plan + +将 `YOUR_API_KEY` 替换为 Coding Plan 专属 [API Key](https://bailian.console.aliyun.com/cn-beijing/?tab=model#/efm/coding_plan) 。可用模型请参考 Coding Plan [支持的模型](https://help.aliyun.com/zh/model-studio/coding-plan) 。 + +```bash +hermes config set model.provider custom +hermes config set model.base_url https://coding.dashscope.aliyuncs.com/apps/anthropic +hermes config set model.api_mode anthropic_messages +hermes config set model.api_key YOUR_API_KEY +hermes config set model.default qwen3.7-plus +``` + +以上命令将配置写入 `~/.hermes/config.yaml` 。也可以直接编辑该文件，写入以下内容： + +config.yaml 配置示例 + +```yaml +model: + default: qwen3.7-plus + provider: custom + base_url: https://coding.dashscope.aliyuncs.com/apps/anthropic + api_mode: anthropic_messages + api_key: YOUR_API_KEY +``` + +### 按量计费 + +将 `YOUR_API_KEY` 替换为 [阿里云百炼 API Key](https://help.aliyun.com/zh/model-studio/get-api-key) 。可用模型请参考 [Anthropic 兼容 API](https://help.aliyun.com/zh/model-studio/anthropic-api-messages) 。 + +`base_url` 按地域设置，API Key 需与所选地域对应，并将 `WorkspaceId` 替换为真实的 [获取Workspace ID](https://help.aliyun.com/zh/model-studio/obtain-the-app-id-and-workspace-id#732535cfc959h) ： + +- 华北2（北京）： `https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic` +- 新加坡： `https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic` + +```bash +hermes config set model.provider alibaba +hermes config set model.base_url https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic +hermes config set model.api_mode anthropic_messages +hermes config set model.api_key YOUR_API_KEY +hermes config set model.default qwen3.7-max +``` + +以上命令将配置写入 `~/.hermes/config.yaml` 。也可以直接编辑该文件，写入以下内容： + +config.yaml 配置示例 + +```yaml +model: + default: qwen3.7-max + provider: alibaba + base_url: https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic + api_mode: anthropic_messages + api_key: YOUR_API_KEY +``` + +## 验证配置 + +配置完成后，执行以下命令发送一条测试消息： + +```bash +hermes chat -q "你好" +``` + +如果返回正常的回复，则配置成功。如需切换模型，通过 `-m` 参数指定： + +```bash +hermes chat -m qwen3.7-max +``` + +## 常见问题 + +### 错误码 + +配置过程中遇到报错，请参考对应计费方案的常见问题文档： + +- 按量付费： [错误码排查](https://help.aliyun.com/zh/model-studio/error-code) +- Coding Plan： [Coding Plan 常见问题](https://help.aliyun.com/zh/model-studio/coding-plan-faq) +- Token Plan 个人版： [Token Plan 个人版常见问题](https://help.aliyun.com/zh/model-studio/token-plan-team-faq) +- Token Plan 团队版： [Token Plan 团队版常见问题](https://help.aliyun.com/zh/model-studio/token-plan-team-faq) + +[[Codex接入阿里云百炼Token Plan配置方法]] \ No newline at end of file diff --git a/openclaw/🟠API Key.md b/openclaw/🟠API Key.md index 0edcf9fc..107ad9ab 100644 --- a/openclaw/🟠API Key.md +++ b/openclaw/🟠API Key.md @@ -278,4 +278,34 @@ BJVys7j427n0xgLOX7AmCu2evMBbJzBVtcukQY6hKak ## Kimi ``` sk-ADsNHdojiQ9Dzo72MSsP0AXAuqsWkHXGdRL9rn4jryIgA3GH +``` + + +## 阿里云百炼 +``` bash +# Token Plan个人版套餐专属API Key +sk-sp-H.DRRPYX.1HDA.MEUCIQClsmzfP-XfBcSWfyzbLBp08Xt9HSUINuMWUSDSeZmYPgIgG0PapJzn0vHqQpxHkCy4t88UYMV0lnOCK_RINXd7wEQ +# Token Plan个人版套餐专属Base URL +# Open AI 兼容 +https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 +# Anthropic 兼容 +https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic + + + +# API Key +sk-ws-H.PMIXRME.jb64.MEQCIGyaWmxvUdxxgcHfmJ411x-xneKMRyf1jRc4m98yNG5AAiB_ou3gMsdUut9E6bJrXRMVsgmB9UX10Z3nAsM4XxpDhg + +# API Host +ws-zmc22ex11uy2l5jm.cn-beijing.maas.aliyuncs.com + +# DashScope +https://ws-zmc22ex11uy2l5jm.cn-beijing.maas.aliyuncs.com/api/v1 + +# Base URL +# OpenAI compatible +https://ws-zmc22ex11uy2l5jm.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 + +# Anthropic +https://ws-zmc22ex11uy2l5jm.cn-beijing.maas.aliyuncs.com/apps/anthropic ``` \ No newline at end of file