税局登录助手

要解决的问题

电子税务局登录链路长、多企业切换繁琐：每家企业对应一套网址、统一社会信用代码、手机号、密码，中间还要过图形验证码、短信验证码和身份选择。脚本化时常见的两类坑：一是多个进程来回调用，验证码已经过期；二是把验证码识别自动化，既不稳定也不合规。这个技能要做的是：在保留人工决策的前提下，把重复登录和切换变成可配置、可恢复的流程。

技能如何工作

配置层：首次使用通过对话一次性登记 登录网址、企业全称、简称、统一社会信用代码、手机号、密码，保存到本机 scripts/companies.json。一家企业一条记录，互不影响；简称由使用者自定义，AI 不代拟。config_manager.py 是唯一校验来源，负责格式、校验位和简称冲突。

执行层：用 playwright-cli 驱动系统 Chrome，参数为 --browser=chrome --headed --persistent，每家企业独立 profile。登录按“取配置 → 打开页面 → 点登录 → 选企业业务 → 填表单 → 图形验证码 → 短信验证码 → 身份选择”推进。

关键优化：验证码弹窗等待、网格标注、截图合并进一次 run-code，目标是点登录后 ≤3 秒出标注图；输入框赋值走原生 setter 并派发 input/change；页面跳转参数交给 tpass 自身生成，不在技能里硬编码。

人工接管：图形验证码只做 10×6 网格编号，由用户回复点击序号；短信验证码由用户发送；出现多身份或多企业时停下来让用户选编号。

适用边界与注意点

• 仅用于本人或财务人员已授权的企业税局账号，不做越权登录。
• 凭据只存本机 companies.json，不写聊天、不外发服务器、不提交 git。
• 不自动识别验证码，不接入第三方识别或破解服务，不绕过安全机制。
• 支持单企业登录与登录后身份切换两种模式；首次仍需至少一家配置作为入口。
• 页面改版时更新 DOM 锚点区，避免依赖固定 class；发现省份差异时按省追加适配。