3.1 KiB
3.1 KiB
Phase 7: 登录认证体系 - Context
Gathered: 2026-03-17 Status: Ready for planning
## Phase Boundary建立知乎登录认证机制,支持二维码扫码和手动 Cookie 两种方式,实现 Cookie 持久化和过期检测。
此阶段不涉及内容爬取(Phase 8),只处理登录认证和 Cookie 管理。
## Implementation Decisions二维码显示方式
- 显示方式: 保存为图片文件,作为标准 step 输出(让 AI 代理能够获取并展示)
- 存储位置: 中间目录(与现有中间文件存放位置一致)
- 等待超时: 60 秒
- 超时行为: 轮询检测,超时退出(不自动重试)
Cookie 存储策略
- 存储位置:
~/.kb_env文件(与现有配置文件一致) - 输入格式: 支持 JSON 导入(Chrome Cookie 导出插件格式),内部存储为字符串
- 存储格式: 原始 Cookie 字符串,例如
ZHIHU_COOKIE="name1=value1; name2=value2" - 加密: 不加密,用户需自行保护
~/.kb_env文件权限
过期检测机制
- 检测时机: 每次使用前检测 Cookie 有效性
- 检测方法: 请求知乎用户信息接口,检查返回状态
- 过期处理: 自动触发扫码重新登录
命令行交互流程
- 登录命令:
python3 kb-workflow/kb_workflow.py login - 默认模式: 扫码模式(弹出二维码让用户扫码)
- 手动设置:
--import-cookie cookies.json从文件导入 JSON 格式 Cookie - 状态查看:
login --status检查当前 Cookie 是否有效
Claude's Discretion
- 二维码图片的具体文件名格式
- 用户信息接口的具体 URL 和返回格式
- JSON Cookie 解析的具体实现
- 错误提示信息的具体文案
<code_context>
Existing Code Insights
Reusable Assets
kb_workflow/metadata/zhihu_extractor.py— PlaywrightBrowser 类,已支持 Cookie 设置kb_workflow/pipeline/config.py— KBSettings 配置类,支持环境变量加载kb_workflow/pipeline/schemas.py— StepInput/StepOutput 基类,可扩展登录相关 Schema~/.kb_env— 现有配置文件,已存储 ZHIHU_COOKIE
Established Patterns
- 配置管理: pydantic-settings BaseSettings + Field + 环境变量
- 处理器模式: BaseProcessor + process(input) -> output
- CLI 设计: argparse subparsers
- 用户确认: rich.prompt 或 input() fallback
Integration Points
- CLI 入口:
kb_workflow.py添加login子命令 - 配置类: KBSettings 添加 ZHIHU_COOKIE 相关逻辑
- 浏览器管理: 扩展 PlaywrightBrowser 支持二维码生成和 Cookie 提取
</code_context>
## Specific Ideas- 二维码图片路径:
~/work/intermediate/zhihu_qrcode_{timestamp}.png - Cookie 环境变量:
ZHIHU_COOKIE="name1=value1; name2=value2" - JSON 导入格式: Chrome Cookie Editor 导出的 JSON 数组格式
- 用户信息接口:
https://www.zhihu.com/api/v4/me或类似
None — discussion stayed within phase scope
Phase: 07-login-auth Context gathered: 2026-03-17