Skip to content

docs: clarify OpenCode auth state precedence in deployments#284

Open
liujuanjuan1984 wants to merge 2 commits intomainfrom
docs/opencode-auth-precedence-283
Open

docs: clarify OpenCode auth state precedence in deployments#284
liujuanjuan1984 wants to merge 2 commits intomainfrom
docs/opencode-auth-precedence-283

Conversation

@liujuanjuan1984
Copy link
Collaborator

@liujuanjuan1984 liujuanjuan1984 commented Mar 22, 2026

背景

围绕 issue #283 的部署边界问题,本次提交对文档进行精简归一:将运行时鉴权优先级与排障细节集中在 docs/guide.md,并在 README 统一引导。

改动范围

README

  • 去除与 guide 重复的持久化认证说明。
  • 保留单行指引:docs/guide.md 的 Troubleshooting Provider Auth State 章节作为详情来源。

docs/guide

  • 保留完整的 provider-auth 排障说明,持续覆盖以下内容:
    • provider 环境变量与用户 HOME/XDG 持久化状态并存时的行为边界
    • 排障最小路径(HOME/XDG、auth.json、opencode.json、workspace)
    • 避免将问题误判为 opencode-a2a 适配层

关联

Closes #283

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.

[docs] 澄清 OpenCode 持久化认证状态与环境变量并存时的部署排障边界

1 participant