docs(plugin): 登录口径改为浏览器一键授权(不需要终端),studio 0.3.6
CI / contract (push) Has been cancelled

配合 ant-copilot 新增的 login 工具(回环 OAuth 授权):技能里 auth_required 的处置从"让用户去终端跑命令"改为"调 login 工具 + 浏览器点一下允许";三份 README 同步,终端助手降为无 login 工具形态(CLI 等)的兜底。
This commit is contained in:
ringo
2026-09-20 13:46:54 +08:00
parent 36347f3222
commit c77d2fe864
7 changed files with 32 additions and 28 deletions
+12 -8
View File
@@ -89,19 +89,23 @@ codex plugin add studio@deta
bash <插件目录>/bin/deta-mcp.sh --profile studio
```
装完即用,**没有 OAuth 登录步骤**。需要云侧能力(项目列表 / 项目同步 / 打开 Studio)时登录一次
(`~/.deta/bin/deta` 由启动器自动注册,无需手工创建):
装完即用,**没有 OAuth 登录步骤、也不需要终端**。需要云侧能力(项目列表 / 新建项目 / 项目同步 / 打开 Studio)时:
```
在对话里说"登录"或直接让助手新建项目/上传到云 —— 助手会调 login 工具给出一个授权地址,
你在浏览器打开(首次输一次账号密码或邮箱验证码)→ 点「登录并授权」→ 完成。
令牌自动写入 ~/.deta 并即时生效;凭据过期时先用 refresh token 静默续期,用户无感。
```
命令行形态(无 `login` 工具时)的兜底做法:
```bash
~/.deta/bin/deta login # 输入账号 + 密码,或 --email-code <邮箱> 走验证码
~/.deta/bin/deta status # 看凭据来源 / 运行时 / 工作区(不打印令牌)
~/.deta/bin/deta login # 由启动器自动注册;账号密码或 --email-code <邮箱>
~/.deta/bin/deta doctor # 端到端自检:运行时、凭据、GSA、MCP 握手
```
登录后**开新会话**(MCP 服务重新拉起时读到凭据)。启动器自己按
`DETA_TOKEN` 环境变量 → `~/.deta/env` → `~/.deta/credentials.json` 的顺序解析令牌,
所以**不需要 source、不需要 launchctl 注入、不需要改 .zshrc、也不需要重启应用**——
Finder/Dock 启动的宿主不继承终端环境,令牌由启动器直接读取才可靠。
启动器按 `DETA_TOKEN` 环境变量 → `~/.deta/env` → `~/.deta/credentials.json` 的顺序解析令牌,
所以浏览器授权后的下一次会话也自动带着登录态——不需要 source、不需要 launchctl、不需要重启应用。
### 登录助手(云侧能力用)