# Chronosight

![一些徽章 - 可选](https://img.shields.io/badge/状态-开发中-blue.svg)
[![Kotlin 版本 - 可选](https://img.shields.io/badge/Kotlin-2.1.20-blueviolet.svg)](https://kotlinlang.org)

**[English](README.md) | 简体中文**

**时间都去哪儿了？通过 Chronosight 了解您的数字习惯，跨平台跟踪和分析您的屏幕时间。**

深入了解您在设备上花费时间的方式。Chronosight 帮助您跟踪屏幕使用时间、分析您的应用使用情况，并最终促进您在手机、平板电脑和电脑上实现更好的数字健康。

## 主要功能

* **跨平台跟踪:** 在 Android、iOS 和桌面 (macOS, Windows, Linux) 上无缝跟踪您的屏幕使用时间。
* **详细使用情况分析:** 获取您的应用使用情况明细，包括每个应用花费的时间和使用模式。
* **数字健康洞察:** 了解您的数字习惯并找出需要改进的方面。
* **共享状态:** 可选择与朋友或您自己的其他设备共享您的使用统计信息，以获得全面的了解。
* **可自定义报告:** 生成可自定义的报告，以分析您在特定时间段内的屏幕使用时间数据。

## 技术栈

* **Kotlin Multiplatform Mobile (KMM):** 为所有平台提供核心业务逻辑、数据分析和共享功能。
* **Android:** 使用 Kotlin 和 Jetpack Compose 进行原生 UI 开发。
* **iOS:** 使用 Swift 和 SwiftUI 进行原生 UI 开发。
* **桌面:** 使用 [例如，Compose for Desktop] 进行基于 Kotlin 的 UI 开发。
* **后端:** Ktor 3.0 用于用户身份验证，云端同步和共享状态功能。

## 平台支持

* 📱 **移动端:** Android, iOS
* 💻 **桌面端:** macOS, Windows, Linux

## 入门指南 (面向开发者)

如果您有兴趣贡献代码或自行构建项目，请参考以下简要指南：

1.  **前提条件:** 确保您已设置好 Android、iOS 和桌面 Kotlin 开发所需的 SDK 和开发环境。
2.  **克隆代码仓库:** `git clone https://github.com/grtsinry43/Chronosight.git`
3.  **打开:** 在 IntelliJ IDEA 或 Android Studio 中打开项目。
4.  **构建并运行:**
    * **Android:** 运行 `androidApp` 模块。
    * **iOS:** 在 Xcode 中打开 `iosApp/iosApp.xcodeproj` 并运行。
    * **桌面:** 运行 `desktopApp` 模块。

## 屏幕截图



## 贡献指南



## 许可证



## 更多

这是一个面向 Android、iOS 和桌面平台的 Kotlin Multiplatform 项目。

* `/composeApp` 目录用于存放将在您的 Compose Multiplatform 应用程序之间共享的代码。
  它包含以下几个子文件夹：
   * `commonMain` 目录用于存放所有目标平台通用的代码。
   * 其他文件夹用于存放仅针对文件夹名称所指示的平台编译的 Kotlin 代码。
     例如，如果您想在您的 Kotlin 应用程序的 iOS 部分使用 Apple 的 CoreCrypto，
     `iosMain` 将是进行此类调用的正确文件夹。

* `/iosApp` 目录包含 iOS 应用程序。即使您正在使用 Compose Multiplatform 共享您的 UI，
  您仍然需要这个作为您的 iOS 应用程序的入口点。这也是您应该为您的项目添加 SwiftUI 代码的地方。

* `/shared` 目录用于存放将在项目中的所有目标平台之间共享的代码。
  最重要的子文件夹是 `commonMain`。如果需要，您也可以在此处的平台特定文件夹中添加代码。

了解更多关于 [Kotlin Multiplatform](https://www.jetbrains.com/help/kotlin-multiplatform-dev/get-started.html)…