# todo-station

**Repository Path**: windoze/todo-station

## Basic Information

- **Project Name**: todo-station
- **Description**: No description available
- **Primary Language**: Rust
- **License**: MIT
- **Default Branch**: brower-auth
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-19
- **Last Updated**: 2025-07-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ToDo Station

一个基于Rust和[Slint](https://slint.dev/)的简单日历和待办事项应用程序。

## 使用说明

1. 按照[getting-started guide](https://www.rust-lang.org/learn/get-started)安装Rust。
2. 安装平台所需的依赖：
    * Windows: 无需额外依赖。
    * MacOS: 无需额外依赖。
    * Linux: `sudo apt-get install build-essential libfontconfig-dev libfreetype-dev pkg-config cmake`
2. 用以下命令编译程序（注意: 在macOs下使用Python 3.13会导致程序无法编译，建议使用Python 3.12）：
    ```
    cargo build --release
    ```
3. 在下列位置创建一个名为`config.toml`的配置文件，文件内容参见[config.toml.example](config.toml.example)：
    * Windows: `C:\Users\<username>\AppData\Roaming\todo-station\`
    * MacOS: `/Users/<username>/Library/Application Support/todo-station/`
    * Linux: `/home/<username>/.config/todo-station/`
4. 运行程序
    ```
    cargo run --release
    ```

## 天气预报配置

天气信息来自[和风天气](https://www.qweather.com/)，需要注册账号并创建应用程序以获取项目ID和密钥ID。

1. 在[和风天气](https://id.qweather.com/#/login)注册账号。
2. 在["控制台 - 项目管理"](https://dev.qweather.com/docs/configuration/project-and-key/)中创建一个项目，并获得项目ID。
3. 在新创建的项目中选择"创建凭据"，然后按照[身份认证 JSON Web Token](https://dev.qweather.com/docs/authentication/jwt/)中的说明创建密钥。上传公钥后，获得密钥ID。
4. 将私钥中间的部分复制到`config.toml`中的`[weather] signing-key`字段。

## Outlook日历配置

首次运行程序会看到下列信息：
```
To sign in, use a web browser to open the page https://www.microsoft.com/link and enter the code ABCD1234 to authenticate.
```
打开浏览器访问`https://www.microsoft.com/link`并输入设备码（用实际的设备码替换`ABCD1234`），然后按照浏览器中的提示授权程序访问Outlook日历。

程序停止运行7天后已有的授权将会过期，需要重新授权。

Outlook日历及一些基本信息将会被授权给`00df9c7d-7b32-4e89-9e3e-834fff775318`这个Azure应用程序ID，如需使用其他的应用程序ID，请自行修改`[todo] app-id`，并可以参照下面的步骤创建新的Azure应用程序。

App ID仅用于程序本身获取日历信息，不会导致信息被泄露给第三方，也不会让其他人拥有访问用户Outlook日历的权限。

### 创建新的Azure应用程序

1. 参照[这篇文章](https://docs.microsoft.com/zh-cn/azure/active-directory/develop/quickstart-register-app)创建一个新的Azure应用程序。
2. 设置App权限，包含`Calendars.Read`、`offline_access`、`openid`、`profile`，注意这些是`Delegated`而非`Application`权限。
3. 在`Authentication`中允许`Allow public client flows`。

## 安全性

* 本程序不会收集用户的任何信息，也不会将获取的数据传至任何第三方。
* 本程序会将用户的和风天气密钥存储在本地，用于获取天气信息，程序不会将密钥传至任何第三方。
* 本程序会将用户的Outlook授权token存储在本地，用于持续更新日历信息，程序不会将token传至任何第三方。
* 本程序除必要的Web访问外不会与外部进行任何通信。必要的Web访问包括：
    * 用于更新壁纸的必应每日图片API。
    * 用于获取天气信息的和风天气API。
    * 用于获取Outlook日历信息的登录认证API及Microsoft Graph API。

## 许可协议

* 本项目基于MIT许可协议发布 - 查看[LICENSE](LICENSE)文件了解更多信息。
* `device_code_flow` 功能来自[Azure SDK for Rust](https://github.com/Azure/azure-sdk-for-rust)， 以[MIT许可协议](https://github.com/Azure/azure-sdk-for-rust/blob/36682f31ba86444967d4bfda441ebc7e249fddfb/LICENSE.txt)发布。
* SourceHanSans-Regular字体基于SIL开源字体许可协议发布 - 查看[LICENSE.source-han-sans](LICENSE.source-han-sans)文件了解更多信息。
* 天气图标来自[和风天气图标](https://github.com/qwd/Icons)，基于[MIT许可协议](https://github.com/qwd/Icons/blob/main/LICENSE)发布。
* 其他第三方资产根据其各自的许可协议发布。