安装必要工具

安装Git。如果计划开发，还需安装JDK和Android Studio（或IntelliJ IDEA）。

克隆项目仓库

在终端运行 `git clone https://github.com/AChep/keyguard-app.git` 下载项目源码。

确保网络通畅，仓库较大，可能需要一些时间。

了解项目结构

浏览项目根目录的文件，特别是 `README.md`、`build.gradle.kts` 和 `settings.gradle.kts`，对项目布局有初步印象。

选择平台并安装应用

根据README的‘Install’部分，为你的操作系统（如Android、Windows、macOS）选择一种安装方式（如直接下载APK/MSI/DMG，或使用包管理器如Scoop、Homebrew、AUR）。

新手推荐从官方Releases页面直接下载预编译的二进制文件。

首次启动与设置

打开Keyguard应用，按照界面引导完成初始设置，如创建或登录Bitwarden账户，或导入KeePass文件。

可以使用Bitwarden的官方账户进行测试，或创建一个新的测试账户。

熟悉主界面与搜索

浏览密码库列表，尝试使用强大的搜索功能查找特定条目。

注意观察Material You设计风格和界面响应性。

体验自动填充与Passkey

在支持的场景（如浏览器登录页）测试自动填充密码的功能。了解并尝试设置一个Passkey（如果服务支持）。

Passkey是新功能，需要目标网站支持。

使用Watchtower安全检查

进入Watchtower功能，查看它识别出的弱密码、重复密码、泄露密码等安全问题。

这是Keyguard的亮点功能，能直观了解密码库的健康状态。

探索多账户与离线功能

尝试添加另一个账户（如另一个Bitwarden账户或KeePass文件）。在断网状态下查看是否能访问已同步的密码库。

注意，写入操作（如添加、修改条目）需要联网同步。

尝试密码生成器

使用内置的密码、SSH密钥、GPG密钥或邮箱转发器生成功能。

探索不同的生成选项和配置。

配置SSH/GPG代理（针对开发者）

如果你使用SSH或GPG，可以尝试配置Keyguard的代理功能，用于连接Git等服务。

此功能配置较复杂，可参考项目更详细的文档。

体验附件与导出

尝试为条目上传附件，并在应用内预览。尝试导出条目。

部分高级功能可能需要Premium许可证。

定位多平台模块

在IDE中打开项目，重点查看 `shared`、`androidApp`、`desktopApp` 等模块，理解Kotlin Multiplatform的代码共享结构。

主要业务逻辑在 `shared` 模块中。

理解Compose UI

在 `ui` 相关的包中，查找使用 `@Composable` 注解的函数，观察Keyguard的UI是如何用Compose构建的。

从主Activity或入口点开始追踪。

寻找一个简单功能的实现

选择一个你熟悉的功能，如“密码生成器”，尝试在代码中找到其UI和逻辑的实现位置。

使用IDE的“Find in Path”或“Go to Symbol”功能进行搜索。