调试凭据与 auth_hint

调试凭据与 auth_hint

Agent 调试时经常遇到登录和鉴权墙。SuperDev 给它两种明确输入。

auth_hint

auth_hint 是 Agent 可见的非敏感提示。用它说明从哪里登录、token 怎么刷新，或者调试时哪些接口危险。

debug_credentials

debug_credentials 是允许 Agent 明文读取的测试凭据。每条只有三个字段：

• name
• value
• desc

作用域只有两层：项目级和服务级。同名时服务级覆盖项目级。

明文值只由 get_debug_credentials 返回。运行态快照和 list_services 只暴露 has_debug_credentials 和不含 value 的 debug_credential_hints。

环境变量和调试凭据语义相反：env 对 Agent 脱敏，debug credentials 是刻意让 Agent 可读。

安全模型

写入凭据就表示授权 Agent 读取它。这里没有额外的逐次读取审批开关。不想让 Agent 使用，就不要添加或直接删除。