136 lines
3.1 KiB
Markdown
136 lines
3.1 KiB
Markdown
---
|
||
name: chinaweal-pms
|
||
description: |
|
||
众望通 PMS 系统数据查询工具。用于查询 PMS 系统中的待办任务数据。
|
||
|
||
当用户提到以下场景时使用此 Skill：
|
||
(1) 查询待办、待办详情、待办任务
|
||
(2) 需要从 PMS 系统获取任务信息
|
||
(3) 用户提到 "PMS"、"待办"、"todo"、"所有待办"、"未完成待办"
|
||
version: 1.0.0
|
||
license: Apache-2.0
|
||
metadata:
|
||
author: lirh
|
||
category: development
|
||
tags:
|
||
- pms
|
||
- chinaweal
|
||
- enterprise
|
||
- todo
|
||
---
|
||
|
||
# Chinaweal PMS 系统查询
|
||
|
||
## 概述
|
||
|
||
此 Skill 用于查询众望通 PMS 系统（Project Management System）的数据。
|
||
|
||
## 认证配置
|
||
|
||
使用此 Skill 前，需要配置环境变量 `CHINAWEAL_PMS_TOKEN`：
|
||
|
||
- **环境变量名称**: `CHINAWEAL_PMS_TOKEN`
|
||
- **用途**: PMS 系统的用户授权 Token
|
||
|
||
### 请求鉴权方式
|
||
|
||
所有 API 请求需要在请求头中携带 Authorization 信息：
|
||
|
||
```
|
||
Authorization: Bearer {CHINAWEAL_PMS_TOKEN}
|
||
```
|
||
|
||
其中 `{CHINAWEAL_PMS_TOKEN}` 需要替换为环境变量 `CHINAWEAL_PMS_TOKEN` 的值。
|
||
|
||
## 功能清单
|
||
|
||
### 功能1: 查询所有未完成待办
|
||
|
||
查询当前用户的所有未完成待办任务列表。
|
||
|
||
**接口地址**: `https://www.chinaweal.com.cn/pms-api/api/todo/unfinished/list/all`
|
||
|
||
**请求方法**: GET
|
||
|
||
**请求头**:
|
||
```
|
||
Authorization: Bearer {CHINAWEAL_PMS_TOKEN}
|
||
Content-Type: application/json
|
||
```
|
||
|
||
**查询参数**:
|
||
- `status` - 任务状态，0 表示未完成
|
||
|
||
**响应关键字段**:
|
||
- `todoNo` - 待办编号
|
||
- `todoTitle` - 待办标题
|
||
- `todoDescription` - 待办描述
|
||
- `createTime` - 创建时间
|
||
|
||
**使用示例**
|
||
|
||
```
|
||
帮我查询所有待办
|
||
查询所有未完成的待办
|
||
看看我有哪些待办任务
|
||
我的待办有哪些
|
||
```
|
||
|
||
### 功能2: 查询待办详情
|
||
|
||
查询指定待办编号的详细信息。
|
||
|
||
**接口地址**: `https://www.chinaweal.com.cn/pms-api/api/todo/detail/{todoNo}`
|
||
|
||
**请求方法**: GET
|
||
|
||
**请求头**:
|
||
```
|
||
Authorization: Bearer {CHINAWEAL_PMS_TOKEN}
|
||
Content-Type: application/json
|
||
```
|
||
|
||
**路径参数**:
|
||
- `todoNo` - 待办编号
|
||
|
||
**响应关键字段**:
|
||
- `todoTitle` - 待办标题
|
||
- `todoDescription` - 待办任务的详情描述
|
||
- `todoAtt` - 待办附件下载地址清单（下载地址中包含 `filename` 参数，表示附件原名）
|
||
|
||
### 使用示例
|
||
|
||
```
|
||
帮我查询待办号 TODO2024030001 的详情
|
||
查询一下 todoNo 为 12345 的待办信息
|
||
```
|
||
|
||
### 调用方式
|
||
|
||
使用 exec 工具执行 curl 命令进行 API 调用。
|
||
|
||
**查询所有未完成待办**:
|
||
```bash
|
||
CHINAWEAL_PMS_TOKEN="your-token-here"
|
||
|
||
curl -X GET "https://www.chinaweal.com.cn/pms-api/api/todo/unfinished/list/all" \
|
||
-H "Authorization: Bearer ${CHINAWEAL_PMS_TOKEN}" \
|
||
-H "Content-Type: application/json"
|
||
```
|
||
|
||
**查询单个待办详情**:
|
||
```bash
|
||
CHINAWEAL_PMS_TOKEN="your-token-here"
|
||
TODO_NO="TODO2024030001"
|
||
|
||
curl -X GET "https://www.chinaweal.com.cn/pms-api/api/todo/detail/${TODO_NO}" \
|
||
-H "Authorization: Bearer ${CHINAWEAL_PMS_TOKEN}" \
|
||
-H "Content-Type: application/json"
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
1. 确保环境变量 `CHINAWEAL_PMS_TOKEN` 已正确配置
|
||
2. 待办编号 `todoNo` 需要从 PMS 系统获取
|
||
3. 附件下载地址中包含 `filename` 参数，即为附件原文件名
|