在阿里云开发者社区记录一次完整的软件方案设计实践:如何借助 AI Agent 完成一个密码管理器从需求规格到架构设计、技术选型、多端扩展的全流程文档产出,重点沉淀可复用的工程方法论。
一、项目背景
目标产品是一款纯本地、离线、加密的密码记忆器(代号"灵钥 LingKey"),形态为 Windows 桌面 exe,预留移动端与浏览器插件扩展位。核心诉求:集中记录网站/文件/文件夹的账号密码,全程本地 AES-256 加密,不上传任何服务器。
二、方案设计的四阶段流程
本次实践沉淀出一套可复用的方案设计流程:
阶段一:需求规格定义
输出《需求规格说明书》,包含业务背景、用户场景(8 个核心场景)、范围界定(In/Out Scope)、11 项功能需求(FR-001~FR-011,带优先级)、非功能需求(性能/可靠性/安全性/可维护性)、验收标准。
关键经验:明确 Out of Scope 同样重要——本期不做"全 PC 自动搜集",避免范围蔓延,但架构需预留扩展接口。
阶段二:系统架构设计
输出《系统架构设计说明书》,采用分层架构 + 服务化:
- 表现层(PyQt6)
- 应用服务层(VaultService/RecordService/TagService/BackupService/LockManager)
- 领域安全层(CryptoService/PasswordToolkit)
- 数据访问层(Repository)
- 存储层(SQLite)
关键经验:需求到架构要做映射表(FR-001/002 → CryptoService + VaultService + LockManager),保证每个需求都有承载模块,无遗漏。
阶段三:技术选型与开发计划
输出《技术选型与开发计划》,明确技术栈(Python 3.12 + PyQt6 + cryptography + argon2-cffi + SQLite + PyInstaller),并拆分为 5 个开发阶段、4 个里程碑,总工期约 15 个工作日。
关键经验:技术选型要给出"为什么不用另一个"的对比,比如为什么选 SQLite 而非其他存储。
阶段四:扩展性规划
输出《多端生态扩展思路框架》,提出"一核一密多壳"思路,覆盖 Windows/macOS/iOS/Android/鸿蒙/微信小程序/浏览器插件七类终端。
三、安全设计的三个硬约束
1. 敏感数据零落盘明文:密码字段加密后入库;
2. 密钥生命周期管理:解锁时派生,锁定时立即清零;
3. 无任何网络上传:本期为纯本地应用,无网络接口。
四、可复用的方法论总结
| 环节 | 可复用要点 |
|---|---|
| 需求定义 | 明确 In/Out Scope,功能需求带优先级 |
| 架构设计 | 需求-模块映射表,分层解耦 |
| 技术选型 | 给出选型对比理由,不只看"用什么" |
| 扩展规划 | 预留接口,格式规范先行 |
五、小结
本次方案设计把"需求到方案"的周期压缩到了小时级,文档产出与架构梳理环节用了 AiPy 辅助。但加密方案、数据模型、范围边界这些关键决策,仍需开发者自己把关。