back
loading skill details...
API client for Yunshang Aifei OA system enabling query and write operations on tasks, projects, users, and reports via encrypted REST calls without browser d...
# 云上艾飞 CLI 技能
云上艾飞 OA 系统的纯 API 客户端，零浏览器依赖，支持查询和写入操作。
## 快速使用
```bash
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 调用
```python
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路径}`
| 微服务 | 服务名 | 说明 |
|--------|--------|------|
| 认证 | (无前缀) | `/dev-api/auth/login`, `/dev-api/code` |
| 系统 | (无前缀) | `/dev-api/system/user/getInfo` |
| 项目 | ef-project | 项目管理、项目计划、项目周报 |
| 市场 | ef-market | 线索、商机、线索跟进 |
| 财务 | ef-finance | 报销 |
| 人力 | ef-human | 员工、薪资、人力成本 |
| 公共 | ef-public | 任务、待办 |
### 查询接口（已验证 ✅）
| 功能 | 方法 | 路径 | 说明 |
|------|------|------|------|
| 验证码 | GET | `/dev-api/code` | 返回 uuid + base64 图片 |
| 登录 | POST | `/dev-api/auth/login` | forceLogin='1' 必须 |
| 用户信息 | GET | `/dev-api/system/user/getInfo` | |
| **待办** | POST | `/prod-api/public/pendingTask/processingList` | 正式用 prod-api |
| **项目列表** | POST | `/dev-api/ef-project/project/info/list` | data 包裹在 result.data |
| **项目周报列表** | POST | `/dev-api/ef-project/project/weekly/list` | 按 projectId 查 |
| **项目周报详情** | POST | `/dev-api/ef-project/project/weekly/getInfo/{weeklyId}` | |
| **报销列表** | POST | `/dev-api/ef-finance/expense/list` | applyStatus: 03=待会计审核, 05=已通过, 07=已发放 |
| **员工列表** | POST | `/dev-api/ef-human/employee/listAll` | 名字字段: employeeName |
| **人力成本** | POST | `/dev-api/ef-human/employeeCost/listPage` | 名字字段: userByName, 含税前工资/日单价 |
| **岗位薪资** | POST | `/dev-api/ef-human/salary/list2` | 岗位+职级的薪资配置 |
| **日单价** | POST | `/dev-api/ef-human/salary/getUserDayCost` | 返回所有人 |
| **线索列表** | POST | `/dev-api/ef-market/clue/selectList` | 返回全部线索（482条） |
| **线索跟进** | POST | `/dev-api/ef-market/clueFollow/list` | 用 clueId 过滤，注意返回所有线索的跟进 |
### 写入接口（已验证 ✅）
| 功能 | 方法 | 路径 | 关键字段 |
|------|------|------|----------|
| **周报评论** | POST | `/dev-api/ef-project/project/weekly/insertComment` | weeklyId, projectId, description |
| **创建任务** | POST | `/dev-api/ef-public/public/task/add` | 需 businessId 关联项目 |
## 技术架构
### 加解密（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 小时有效，自动验证
### 环境差异
| | 测试环境 | 正式环境 |
|---|---------|---------|
| 地址 | http://192.168.24.25 | http://192.168.24.208:20080 |
| 登录方式 | 纯 API ✅ | 纯 API ✅ |
| API 前缀 | /dev-api | /dev-api（系统） + /prod-api（业务待办） |
| 账号 | 18602920976 | 18602920976 |
### 响应格式差异
| 接口 | 格式 |
|------|------|
| 大多数接口 | `{code, msg, total, rows}` |
| 项目列表 | `{code, msg, data: {total, rows}}` — data 多包一层 |
| 员工列表 | `{code, msg, data: [...]}` — data 是数组 |
| 岗位薪资 | `{code, msg, data: {posts: [...]}}` — 嵌套结构 |
### 关键字段名映射
| 业务 | 名字字段 | 注意 |
|------|----------|------|
| 员工 | employeeName | 不是 nickName |
| 人力成本 | userByName | 不是 employeeName |
| 线索 | clueTitle | 不是 clueName |
| 跟进内容 | followRecords | 不是 followContent |
| 报销状态 | applyStatus | 03=待审核, 05=已通过, 07=已发放 |
### 任务创建必要字段
```python
{
'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',
}
```
### 钉钉机器人推送
```python
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
| 姓名 | userId | deptId | 部门 |
|------|--------|--------|------|
| 万鑫 | 10 | 105 | 总经办/研发中心 |
| 康楠 | 12 | 130 | 开发组 |
## 常用项目 ID
| 项目 | projectId |
|------|-----------|
| 艾飞-AI全栈赋能项目（2026） | 9a7192dc-4f4a-4423-bff5-c46575944785 |
## 文件结构
```
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`
don't have the plugin yet? install it then click "run inline in claude" again.