# HeySiri

**Repository Path**: handloong/HeySiri

## Basic Information

- **Project Name**: HeySiri
- **Description**: Hey Siri
通过Siri远程调用插件,例如实现 HeySiri 关机
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 0
- **Created**: 2023-07-24
- **Last Updated**: 2025-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# HeySiri

通过Siri远程调用插件，实现语音控制电脑操作，例如关机、重启等。

## 介绍

HeySiri 是一个基于语音助手Siri的远程控制插件系统。通过MQTT协议实现通信，支持多种自定义插件，可以轻松扩展功能。

## 软件架构

- **SiriRobot**: 客户端应用，基于WinForm实现图形界面。
- **SiriWeb**: 服务端应用，使用MQTTNet类库搭建MQTT服务器并提供Web接口。
- **插件系统**: 插件需实现 `IPlugin` 接口，支持动态加载和配置。

## 功能说明

- 通过Siri语音指令远程控制电脑执行插件任务。
- 支持插件配置界面，部分插件可以自定义设置。
- 插件通过MQTT协议与服务器通信，实现远程调用。
- 提供插件开发模板，方便扩展新功能。

## 使用说明

### 客户端配置

运行 `SiriRobot` 客户端，进入配置页面设置MQTT服务器地址、端口、用户名密码等信息。默认服务器地址为：

```
MQTT Server: 47.103.148.154
Port: 1883
Username: anonymous
Password: anonymous
```

你也可以部署自己的服务器并修改配置。

### 插件使用

1. 将插件编译为 `.dll` 文件并放入 `Plugins` 目录。
2. 打开插件配置页面，复制对应插件的URL。
3. 在iPhone快捷指令中添加“获取网页内容”操作，并将URL粘贴进去。
4. 使用Siri语音指令触发快捷指令，执行插件功能。

示例：  
> Hey Siri，关闭次卧电脑

将触发关机插件的 `Execute()` 方法。

### 查看连接状态

可以通过以下链接查看当前连接的客户端数量：

```
http://47.103.148.154:8000/status
```

## 开发插件

新建一个类库项目，实现 `IPlugin` 接口，重写以下方法：

- `Id`: 插件唯一标识
- `Name`: 插件名称
- `Version`: 插件版本
- `Author`: 插件作者
- `Description`: 插件描述
- `Execute()`: 插件执行逻辑
- `Initialize()`: 插件初始化
- `SettingUI()`: 是否支持设置界面
- `ShowSettingUI()`: 显示设置界面

参考 `Pg.Siri.Reboot` 或 `Pg.Siri.EchoUI` 示例插件。

## 参与贡献

1. Fork 本仓库
2. 创建新分支（例如：`Feat_新功能`）
3. 提交代码
4. 创建 Pull Request

## 协议

本项目使用 MIT 协议，详情请见 [LICENSE](LICENSE) 文件。

---

> 无私奉献不是天方夜谭，有时候，我们也可以做到。