Skip to content

docs: clarify CLI authentication boundary for 401 errors - #111

Closed
2EU55 wants to merge 1 commit into
Dailin521:mainfrom
2EU55:docs-401-auth-boundary-20261027
Closed

2EU55 wants to merge 1 commit into
Dailin521:mainfrom
2EU55:docs-401-auth-boundary-20261027

Conversation

@2EU55

@2EU55 2EU55 commented Oct 27, 2026

Copy link
Copy Markdown

目的 / Why

在 CLI 的“遇到失败”里补充401的处理边界,避免用户在 Provider 元数据已对齐后,仍把重复 Sync/Repair 当成认证修复手段。现有 README 和 Agent 指南已经声明工具不处理认证,这次只是把同一边界放到用户查具体错误的位置。

关联 Issue / Related issue

无。按 CONTRIBUTING,小型文档改进直接提 PR;没有把未复现的情形提交为软件 Bug。

改动 / Changes

  • 在 docs/README_CLI_ZH.md 的失败清单增加一条401说明。
  • 引用 OpenAI 官方认证文档,没有在用户文档中加入商业站点、服务商推荐或邀请链接。
  • 现有英文摘要已明确“does not ... handle authentication”,本次未改变行为或增加命令。

影响范围 / Impact

  • Node.js CLI
  • Shared .NET Core
  • Windows GUI
  • macOS GUI
  • WSL / SQLite paths
  • Backup / restore
  • CI / GitHub Actions
  • Documentation

数据写入 / Data writes

无用户数据写入;仅一条 Markdown 文档补充。

验证 / Validation

Automated

检查改动只有目标文件的一条新增文档、现有文字未删除,外链为 HTTPS 官方文档。未运行程序测试;没有代码或命令行为变更。

Manual

对照当前 README 的认证边界、AGENTS 的 Goal/Safety boundaries、CLI 失败清单、现有英文摘要,以及2026-10-27读取的 OpenAI 官方认证资料。

Not run

未执行本工具、未读取任何真实 Codex Home、未使用真实 Key 或进行模型调用;未验证所有客户端与平台,没有构建桌面包或运行全量程序测试。文档说明不构成实机修复报告。

检查清单 / Checklist

  • PR 只包含相关修改 / This PR contains only related changes
  • 已补充相关测试,或说明不需要测试的原因 / Tests were added or the reason they are unnecessary is explained
  • 如有用户可见变化,已更新相关文档 / Relevant documentation was updated for user-facing changes
  • 未提交未脱敏的凭据、会话、SQLite、备份、日志或个人信息 / No unredacted credentials, sessions, databases, backups, logs, or personal data are included

关系披露:我是巨浪 AI(模型 API 公开报价目录)的维护者,网站有广告合作入口。AI 协助整理本次文档贡献。我们有一份中文 Codex 接入排错整理,这里只披露背景与参考关系,不请求把商业链接插入文档,是否额外引用由维护者自行决定。

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review 🔄 Running since 2026-10-27T09:00:23.001294Z ffc3f80 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@2EU55 2EU55 closed this by deleting the head repository Oct 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant