开发与诊断

开发页把运行日志、数据库、客户端测试、服务端测试、基础信息、开发文档和接口文档收进同一个桌面入口。

截图展示了服务端测试报告：用例结果、耗时、覆盖率和文件级摘要可以直接在 Mira 中查看。

这一页服务谁

开发页主要服务项目作者、协作者和需要排查本地环境的高级用户。

它不是普通聊天用户每天都要进入的页面，但对一个持续演化的本地桌面应用非常重要：维护者不必在命令行、日志目录、测试报告和独立文档之间反复切换。

当前入口

页面顶部包含：

• 日志；
• 数据库；
• 客户端测试；
• 服务端测试；
• 基础信息；
• 开发文档；
• 接口文档。

这些入口覆盖了从运行状态到代码验证的主要维护面。

测试报告

当前服务端测试页会显示：

• 总用例、通过和失败数量；
• 本次测试耗时；
• Statements、Branches、Functions、Lines 覆盖率；
• 文件级测试与覆盖率摘要；
• 单个文件的详情入口。

测试通过数量只是第一层信息。覆盖率和失败文件列表可以帮助维护者判断：问题是局部回归、未覆盖路径，还是整条链路已经不可用。

日志与数据库

日志页适合查看本地后端和错误日志，并在需要时导出或清理日志。

数据库页用于检查本地数据状态。对知识库、角色、会话和配置这类本地数据而言，能够直接查看数据库连通与基础状态，有助于把“界面异常”和“数据异常”区分开。

开发文档与接口文档

文档入口用于把稳定合同、架构说明和接口信息留在应用附近。

Mira 的文档不只是给最终用户阅读，也承担项目记忆：当系统复杂到一个人无法记住所有调用链和边界时，结构化文档可以成为人和 AI 共同使用的稳定入口。

使用边界

开发页展示的是诊断与验证信息，不应被理解为“测试全绿就代表产品一定没有问题”。

真实验收还需要结合：

• 用户流程；
• 数据迁移与兼容性；
• 权限和副作用边界；
• 本地与云端 Provider 的实际运行环境；
• 黑盒场景和人工判断。