云上艾飞 CLI 技能

云上艾飞 OA 系统的纯 API 客户端，零浏览器依赖，支持查询和写入操作。

快速使用

cd C:\Users\EF\.openclaw\workspace\skills\yunshang-aifei-cli

# 正式环境（默认）
python aifei.py todo                          # 查工作待办
python aifei.py user                          # 查当前用户
python aifei.py projects                      # 查项目列表
python aifei.py projects --name "万鑫测试"     # 搜索项目

# 测试环境
python aifei.py --env test todo
python aifei.py --env test projects

Python API 调用

from aifei_api import create_client, sm4_encrypt, parse_response

c = create_client('prod')  # 或 'test'
base = c.base_url
h = {'Authorization': 'Bearer ' + c.token, 'Content-Type': 'application/json;charset=UTF-8'}

已验证的 API 接口

微服务路由前缀

所有接口通过 nginx 代理，URL 格式：{base_url}/dev-api/{服务名}/{Controller路径}

查询接口（已验证 ✅）

写入接口（已验证 ✅）

技术架构

加解密（SM4/ECB/PKCS5Padding）

• 密钥: 1097659710ff550f7da111309f64386b（前后端统一）
• 请求: JSON → sm4_encrypt → hex 字符串
• 响应: hex 字符串 → sm4_decrypt → JSON（部分接口直接返回 JSON）
• 密码: 明文 → sm4_encrypt → hex，放入 login 请求体的 password 字段
• gmssl 库：内部已处理 PKCS5 padding，不要手动 pad

认证

• 登录: POST /dev-api/auth/login，必须 forceLogin: '1'（否则已有在线会话时返回 loginStatus:100）
• Token: 登录返回 data.access_token
• 传递: Cookie Admin-Token=<token> + Header Authorization: Bearer <token> 双传
• 缓存: .token-{env}.json，4 小时有效，自动验证

环境差异

响应格式差异

关键字段名映射

任务创建必要字段

{
    'taskContent': '任务内容',
    'taskType': '01',       # 01=技术交流 02=现场勘察 03=需求调研 04=原型制作 05=可研及评审 06=商务招投标 07=其它
    'taskHeadBy': 'userId', 
    'taskHeadByName': '姓名',
    'taskHeadDeptId': 'deptId',
    'taskHeadDeptName': '部门名',
    'taskStartTime': 'YYYY-MM-DD',
    'taskEndTime': 'YYYY-MM-DD',
    'expectManDay': 2,
    'taskSource': '02',     # 02=项目关联
    'businessId': '项目ID', # 必须关联项目，否则 500
    'businessName': '项目名',
    'taskStatus': '01',     # 01=执行中
    'isPlan': 'N',
    'projectPhase': '04',
}

钉钉机器人推送

import requests
webhook = 'https://oapi.dingtalk.com/robot/send?access_token=daf5fd...'
requests.post(webhook, json={
    'msgtype': 'markdown',
    'markdown': {'title': '标题', 'text': '@康楠 内容...'},
    'at': {'atMobiles': ['手机号'], 'isAtAll': False}
})

常用人员 ID

常用项目 ID

文件结构

skills/yunshang-aifei-cli/
├── SKILL.md              # 本文件
├── aifei.py              # CLI 入口
├── aifei_api.py          # API 客户端核心（SM4 + 认证）
├── login.py              # Playwright 登录（备用）
├── modules/
│   └── captcha_solver.py # 验证码识别（阿里云通义千问 VL）
├── .token-test.json      # 测试环境 token 缓存
├── .token-prod.json      # 正式环境 token 缓存
└── results/              # 调试输出

依赖

• Python 3.10+
• gmssl（SM4 加解密）
• requests
• playwright（仅备用登录需要）

踩坑记录

1. forceLogin 必须为 '1'：否则已有在线会话时返回 loginStatus:100 没有 token
2. Token 双传：Cookie Admin-Token + Header Authorization: Bearer 缺一不可
3. gmssl 不要手动 pad：crypt_ecb() 内部已处理 PKCS5，手动加 pad 会变成双倍长度
4. 正式环境待办用 /prod-api：其他接口用 /dev-api，待办走 /prod-api
5. clueFollow/list 返回所有线索的跟进：需要用 clueId 在结果中过滤
6. 创建任务必须关联 businessId：否则后端调用商机/项目服务失败（500）
7. 项目列表返回格式多包一层 data：result.data.rows 而非 result.rows