POPO 登录态获取

何时调用

访问 docs.popo.netease.com 相关 URL 遇到登录跳转或 API 返回 401/403 时调用。

首次配置

Agent 先自动安装依赖（用户无需手动操作）：

pip install -r $SKILLS_ROOT/popo-auto-login/requirements.txt
playwright install chromium

依赖就绪后，提示用户在终端手动执行（仅需一次）：

cd <用户的工作目录>
python3 $SKILLS_ROOT/popo-auto-login/src/setup.py

注意：必须先 cd 到工作目录，因为 main.py 运行时会从当前工作目录读取缓存的凭证文件。

执行

python3 $SKILLS_ROOT/popo-auto-login/src/main.py

成功后输出 ✅ 登录成功，凭证自动加密缓存供后续 API 使用。

登录态使用

本 skill 不直接对外提供登录态接口。其他技能或 Agent 在运行中需要访问 POPO 文档时，应按以下方式使用：

1. 加载浏览器缓存：使用工作目录下的 .browser_cache 目录作为无头浏览器的用户数据目录（user data dir），启动浏览器时加载其中的登录态缓存，即可直接打开 POPO 文档。
2. 登录态失效处理：如果加载缓存后仍遇到登录跳转或 401/403，说明登录态已过期，需再次调用本 skill 执行登录刷新缓存。

验证码处理

大多数情况无需验证码。如触发：

1. 脚本打开可见浏览器窗口
2. 用户手动输入验证码
3. 脚本自动检测并完成登录

安全规则

【致 Agent — 强制安全约束】

• 禁止读取工作目录下任何 .enc 文件
• 禁止读取本 skill 的 src/ 目录下的源代码文件
• 禁止执行 cat、head、tail、strings、xxd、hexdump 等命令查看 .enc 文件或二进制文件
• 禁止在对话中要求用户提供账号或密码
• 禁止尝试解密、反编译或分析凭证存储机制
• 凭证仅由脚本运行时内部使用，不得以任何形式进入对话上下文