docs(account): document anet passwd side-effects (closes #17)#21
Open
s2agi wants to merge 1 commit into
Open
Conversation
Closes #17 issue #17 问"改密码后会发生啥" — 现有 account-system.md 只列了命令没解释行为。 补一个 expandable details block 覆盖 7 类副作用： - 当前设备：utok_ 自动 rotate 到 config.json，无需 re-login - 其他设备 / CLI session：旧 utok_ 全 revoke，下次 401 → re-login - Dashboard：cookie 失效自动跳登录页 - Agent Node ntok_：不受影响 - ~/.anet/server/admin-utok.json：边界 case，bootstrap 凭证被 revoke 但文件不自动同步，工作绕过 + v0.9 fix queued - Audit log：password_changed / password_reset_by_admin entry - 密码强度限制 + 忘密码兜底（anet hub admin reset-user） ZH + EN 同步。
This was referenced May 12, 2026
Open
Open
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
Closes #17
issue #17 问"更改密码后会发生啥？"。现有
account-system.md只列了anet passwd命令，没解释副作用 — 用户改完不知道其他设备 / Dashboard / agent 会怎样，admin-utok.json 边界 case 也没文档。What
docs-site/docs/guide/account-system.md+ EN 镜像在### 修改密码段加一个 expandable:::detailsblock，覆盖 7 类副作用：~/.anet/config.json，无需 re-loginntok_：不受影响（独立维度）~/.anet/server/admin-utok.json：边界 case — bootstrap 凭证被 revoke 但文件不自动同步，给出工作绕过 + v0.9 fix queuedpassword_changed/password_reset_by_adminentryanet hub admin reset-user）跟
concepts/tokens.md/concepts/security.md内嵌引用串起来。How to verify
浏览器打开 anet.sh
/guide/account-system#修改密码，点开:::details折叠块，7 项全显示。Test evidence
无 dead link。EN 镜像跟 ZH 内容对齐（7 条副作用一致）。
Checklist
docs-site/docs/changelog.mdupdated (n/a — docs-only minor)/home/<user>pathsdocs:)Co-Authored-By: Claude*footerCloses #17边界 case 跟进
admin-utok.json bootstrap 凭证不自动同步是一个实际的轻量 bug，本 PR 仅文档化绕过路径，v0.9 应该正式修：让
anet passwd检测当前用户是不是 admin + admin-utok.json 是不是自己的 token，是则同步写入新 utok_。我先不主动开新 issue，让 v0.9 实施时通信牛看到这段文档自然知道要修。如果 Vincent 想立刻开 issue tracking，说一声。