coding-plan-usage
# Coding Plan Usage Helper
用于查询阿里云 Coding Plan 余量的命令行工具。
## 何时使用
在以下场景主动调用：
- 用户希望“查询阿里云 Coding Plan余量”
## 执行流程
1. 直接运行 Python 脚本 `scripts/aliyun.py`
2. 若运行时报 `agent-browser` 不存在：先判断是否沙盒环境；仅真实环境缺失时安装依赖，否则提示用户：沙盒中找不到依赖是正常现象
3. 输出并解释结果
> 注意运行时的路径，切换到包含脚本的目录或使用完整路径执行。
## 如何运行
直接运行 Python 脚本 `scripts/aliyun.py`：
macOS / Linux:
```bash
python scripts/aliyun.py
```
Windows(PowerShell):
```powershell
python .\scripts\aliyun.py
```
如果命令存在，直接进入“输出解释规则”。
## 输出解释规则
- **未登录**：会自动打开阿里云首页并进入登录页，保存截图到当前目录`aliyu-login.png`，终端提示你扫码；扫码后再次运行即可。如果频道允许发送图片 你可以直接发给用户，否则可以帮用户打开图片。
截图完成后脚本会停止运行，当用户回复已经完成扫码登陆后，再次运行即可。
示例输出：
```text
Already logged in: false
Entered login page: true
请使用阿里云 App 扫码完成登录后，再次执行此程序以查询用量。
Login screenshot: /opt/coding-plan-usage/aliyu-login.png
Scan completed: false
```
- **已登录**：会自动进入 Coding Plan 页面并输出余量 JSON。
示例输出：
```json
{
"hours5": {
"usage": "0%",
"resetTime": "2026-03-14 18:27:45"
},
"week": {
"usage": "27%",
"resetTime": "2026-03-16 00:00:00"
},
"month": {
"usage": "15%",
"resetTime": "2026-04-09 00:00:00"
}
}
```
成功读取到用量后，程序会自动关闭浏览器会话。
标签
skill
ai
