README.md

metadata

title: KManager
sdk: docker
app_port: 7860

Autoreg (Kiro Account Manager)

用于管理 Kiro 账号、配额与自动注册的 Python 后端与 Web 管理界面。包含 FastAPI 服务、CLI、自动化注册与调试工具。

主要功能

• Web 管理面板（FastAPI + WebSocket）
• 账号/配额/Token 管理
• 自动注册与多种邮箱策略
• 防指纹与浏览器伪装模块
• 调试与抓包分析工具
• 可选 LLM API 兼容服务

目录结构

autoreg/
  app/                  # Web App (FastAPI)
  core/                 # 核心配置与工具
  registration/         # 注册与 OAuth 流程
  spoofers/             # 指纹伪装模块
  services/             # 业务服务层
  debugger/             # 调试/抓包分析
  llm/                  # LLM API Server
  scripts/              # 开发脚本
  cli.py                # CLI 入口
  run.py                # Web App 入口

快速开始

1) 安装依赖

pip install -r requirements.txt

2) 配置环境变量

复制 .env.example 为 .env，按需填写：

# IMAP
IMAP_SERVER=imap.gmail.com
IMAP_USER=your@gmail.com
IMAP_PASSWORD=app-password

# Email 策略: single, plus_alias, catch_all, pool
EMAIL_STRATEGY=plus_alias

# catch_all
EMAIL_DOMAIN=mydomain.com

# pool
EMAIL_POOL=["user1@mail.ru", "user2@mail.ru:password"]

3) 启动 Web App

python run.py
# 默认访问 http://127.0.0.1:8420

常用命令

CLI

python cli.py status
python cli.py tokens list
python cli.py tokens switch <name>
python cli.py quota --all
python cli.py patch status
python cli.py patch apply
python cli.py patch generate-id
python cli.py sso-import <cookie> -a

自动注册

python -m registration.register_auto
python -m registration.register --email user@domain.com
python -m registration.register --count 5
python -m registration.register --email user@domain.com --headless

LLM API Server

python -m llm.run_llm_server
# 默认 http://127.0.0.1:8421

Debug Session

python -m debugger.run
# 输出到 debug_sessions/

邮箱策略说明

策略	说明	示例
single	单邮箱	user@gmail.com
plus_alias	Plus 别名	user+abc@gmail.com
catch_all	域名 Catch-all	any@domain.com
pool	邮箱池	["a@mail.ru", "b@mail.ru:pass"]

数据与隐私

• 本地数据默认保存在 ~/.kiro-manager-wb/
• 敏感信息请放入 .env，不要提交到仓库
• 建议开启 .gitignore 保护 accounts/、tokens/、日志等

依赖说明

• FastAPI + Uvicorn 用于 Web 服务
• DrissionPage 用于浏览器自动化（需要系统浏览器）