KPanel 质量改进提案模板

本模板用于把重复问题、指标恶化、门禁缺口或高成本人工步骤转化为可验证改进。复制为 docs/quality-improvement-<YYYY-MM-DD>-<slug>.md 后填写。没有事实证据时保持观察，不以模型偏好、 发布次数或一次偶发现象直接修改永久规范。

• 提案状态：草案 / 待复核 / 试行 / 已采纳 / 已拒绝 / 已回滚
• 提案日期：YYYY-MM-DD
• 负责人：
• 适用业务域：
• 基线提交 / 标签：
• 关联缺陷、验收记录、CI 或事件：
• 提交、推送、发布和生产权限：

观察证据

• 可重复观察：
• 精确环境、版本、时间范围和样本量：
• 原始命令、日志、截图或验收记录：
• 已确认事实：
• 未确认信息与数据缺口：
• 为什么不是一次偶发环境故障：

原因假设

• 待验证根因：
• 可能的替代解释：
• 能证伪本假设的结果：
• 是否涉及 kejilion.sh、真实系统资源、Panel/Agent 权限边界或兼容契约：

产品原则与核心思想对齐

• 对业务真源和双端互通的影响：
• 对轻量、低资源、单管理员控制面的影响：
• 对安全、稳定、性能、体验、数据/迁移的影响：
• 不应引入的复杂度或第二真源：

基线、目标与观察窗口

指标	当前基线	目标 / 守护阈值	数据源	观察窗口
主指标
防回归指标

数据不足时写“先建立基线”，不得把缺失值当作零缺陷或成功。

范围与非目标

• 允许修改：
• 明确不修改：
• 受影响用户旅程：
• 风险等级与所需验收层级：L0 / L1 / L2 / L3

规范验收合同（仅永久规范、工作流、策略或治理门禁变更填写）

按 PROJECT_RULES.md 5.3 的“规范验收契约 v1.0”填写，不在本模板复制或改写其严重度定义：

• 精确规范基线：
• 冻结的允许范围：
• 明确非目标：
• 权威入口和正常授权路径：
• 固定验收矩阵：正确性 / 一致性 / 完整性 / 可执行性 / 效率与比例性 / 可演进性
• 预先确定的回归集与证据：
• 本轮停止条件：
• 范围外发现如何进入后续事项：

备选方案与取舍

方案	收益	风险 / 成本	是否采用及理由
A
B

最小改动方案

• 预计修改文件或唯一入口：
• 新增或调整的自动门禁：
• 迁移、兼容和失败恢复：
• 防止指标投机或规则自我弱化的约束：

验证与证据层级

• 定向测试：
• make verify-change / make verify-l2 / make verify-release：
• 隔离真机或浏览器证据：
• 公开产物证据：
• 生产部署安全核对（仅在明确授权后；不作为质量验证证据）：
• 未验证项：

独立复核

• 复核人 / 智能体：
• 是否独立读取原始证据：
• 假设与方案评审结论：
• 门禁是否被削弱、绕过或只对样例优化：
• 复核状态：通过 / 修改后复核 / 拒绝

回滚

• 源码 / 规范回滚点：
• 数据或配置备份：
• 触发回滚的客观条件：
• 回滚步骤和回滚后复核：

采纳决策与结果

• 决策：采纳 / 继续试行 / 拒绝 / 回滚
• 决策依据和日期：
• 观察窗口结果：
• 实际收益、回归和意外影响：
• 是否更新永久规范、测试、工作流或验收模板：
• 规范验收结论（仅规范变更）：PASS / PASS WITH FOLLOW-UP / FAIL
• 规范验收停止依据：
• 后续事项：