# lichaoshun

**Repository Path**: software-engineering-pre-project/apollo

## Basic Information

- **Project Name**: lichaoshun
- **Description**: 系统交互
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-28
- **Last Updated**: 2025-12-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# lichaoshun 软件工程 API 说明

## 简介
本项目为 Windows 平台下的软件自动化与操作 API，基于 FastAPI 框架，支持命令执行、应用启动、文本输入、选中内容检测、SSE 实时推送等功能，适用于自动化测试、办公辅助、前后端集成等场景。

## 主要功能
- 执行系统命令（/UseCmd）
- 获取应用程序路径（/GetExePath）
- 获取选中的文本内容（/GetSelectText）
- 启动指定应用（/OpenApp）
- 在鼠标光标处输入文本（/InputTextAtMouseCursor）
- SSE 实时推送选中内容状态（/IsSelectText_sse）

## API 接口说明
接口定义详见 `openapi.json`，主要接口如下：

| 路径 | 方法 | 说明 |
| ---- | ---- | ---- |
| /UseCmd | POST | 执行命令 |
| /GetExePath | GET | 获取应用路径 |
| /GetSelectText | GET | 获取选中内容 |
| /OpenApp | POST | 启动应用 |
| /InputTextAtMouseCursor | POST | 在鼠标处输入文本 |
| /IsSelectText_sse | GET | SSE推送选中状态 |

## 快速开始
1. 安装依赖：
   ```bash
   pip install -r uv.lock
   ```
2. 启动服务：
  python -m main
3. 访问接口，具体参数和返回格式见 `openapi.json`。

## 测试方法
- 可参考 `client_test`，使用 requests 流式读取接口：
  ```python
  import requests
  response = requests.get('http://127.0.0.1:30702/IsSelectText_sse', stream=True)
  for line in response.iter_lines():
      if line:
          print(line.decode())
  ```

## 目录结构
```
lichaoshun/
    openapi.json         # OpenAPI 接口定义
    main.py              # 项目入口
    api/                 # 业务逻辑与路由               
    uv.lock              # 依赖锁定文件
    README.md            # 项目说明文档
    ...
```

## 其他说明
- 所有接口均为 RESTful 风格，部分支持 SSE 实时推送。
- 详细用法和扩展请参考源码及 openapi.json。
- 依赖管理采用 uv，推荐使用 uv 安装依赖。

---
如有问题或建议，请联系项目维护者。