BitwardenForReactor

使用 Microsoft.UI.Reactor 和 WinUI 3 开发的 Bitwarden 桌面客户端，支持简体中文和英文界面。

项目通过 Bitwarden CLI（bw）访问密码库，界面采用 Reactor 的声明式组件和 MVU 状态管理，不使用 XAML 或传统 ViewModel 架构。

当前进度

核心功能已经可以使用：

• 检查登录状态、解锁、锁定和同步密码库
• 浏览、搜索和筛选登录、卡片、身份、安全笔记、收藏、归档及回收站项目
• 查看项目详情，复制用户名、密码、TOTP 等字段
• 新建、编辑、克隆、收藏、归档和删除项目
• 从回收站恢复或永久删除项目
• 生成密码、密码短语和用户名，并复制生成结果
• 配置 Bitwarden CLI 路径、认证环境和剪贴板清除时间
• 可持久化的跟随系统、浅色和深色主题选择
• 基于 Reactor LocaleProvider 的简体中文、英文界面切换
• 树状侧边导航、列表快捷操作、详情卡片和 Toolkit 设置控件

目前主要工作是继续优化各页面的布局、控件一致性和交互细节。附件、导入导出等入口尚未全部完成。

运行要求

• Windows 10 1809 或更高版本
• .NET SDK 10
• 已安装并可调用 Bitwarden CLI

首次使用前在终端完成登录：

bw login

然后构建并运行：

dotnet restore
dotnet run -p:Platform=x64

项目当前使用 Microsoft.UI.Reactor 0.1.0-preview.13。主要设计和开发记录位于 docs/。

发布与打包

默认构建仍是 unpackaged、Windows App SDK self-contained 的开发版本。发布 x64 Native AOT 版本：

dotnet publish -c Release -r win-x64 -p:Platform=x64 -p:NativeAot=true -o bin\publish\aot-win-x64

验证未签名的 MSIX 包布局：

dotnet build -c Release -p:Platform=x64 -p:ReactorPackaged=true

生成可安装的签名 MSIX 时，证书主题必须与 Package.appxmanifest 的 Publisher 一致：

dotnet build -c Release -p:Platform=x64 -p:ReactorPackaged=true -p:GenerateAppxPackageOnBuild=true -p:AppxPackageSigningEnabled=true -p:PackageCertificateThumbprint=<thumbprint>

ARM64 使用相同命令，将 x64 / win-x64 分别替换为 ARM64 / win-arm64。AOT 发布保留官方针对 Windows App SDK #6394 的 PRI/XBF 复制修复；Release 和 AOT 构建不包含 Reactor DevTools。

推送 v1.2.3 格式的 Tag 后，GitHub Actions 会生成 Microsoft Store 的 x64/ARM64 上传包；配置生产证书后也可创建已签名的 GitHub Release。所需变量、Secrets 和 Partner Center 配置见 docs/release-ci-setup.md。

项目结构

• Application/：异步命令和副作用编排
• Components/、Pages/、Shell/：Reactor UI 组件与应用外壳
• State/：应用状态、Action 和纯 Reducer
• Services/：Bitwarden CLI、设置、剪贴板和图标服务
• Models/：密码库数据模型和编辑草稿
• Localization/、Strings/：Reactor 国际化适配与语言资源
• Controls/Toolkit/：通过 [GenerateReactorWrapper] 生成的 Windows Community Toolkit Reactor 适配器