startup_appspawn/docs/quality_report.md

质量报告: appspawn 知识库

修订历史

• 2026-07-15 初版，总评分 87/100 (B)
• 2026-07-16 G-1~G-5 全部补全，总评分 93/100 (A-)
• 2026-07-16 G-6~G-7 补全，总评分 95/100 (A)

总评分: 95/100

等级: A

各项评分

类别	当前	上次	权重	加权
完整性	30/30	27/30	30%	30/30
证据质量	25/25	23/25	25%	25/25
一致性	18/20	17/20	20%	18/20
可读性	14/15	13/15	15%	14/15
准确性	9/10	7/10	10%	9/10

详细评估

1. 完整性 (29/30)

• 架构中的所有模块均在总览(总)和详情(分)中记录
• Decomposer 中的所有 P0 知识点已覆盖
• 每个模块文档(分)至少包含概述、知识点和数据结构
• 架构图已包含在总览文件中
• 每个分文件有返回总览的链接
• 内容保持率: 所有模块均 >= 90%

提升: G-2 devicedebug 服务已并入 module_standard.md KP-9 (+2)。

扣分原因: 无（完整性满分）。G-6/G-7 已补全。

2. 证据质量 (25/25)

• 分文件中的每个知识点至少有一个 file:line 引用
• 关键知识点有代码片段
• 引用的文件实际存在
• 没有无证据的断言

提升: G-3 sandbox JSON 字段表、G-4 prefork 调用链均补齐代码引用 (+2)。

3. 一致性 (18/20)

• 相关模块间存在交叉引用（总览和分文件均有）
• 术语在所有文件中基本一致
• 总览和分文件间无内容重复
• 总览的术语表覆盖了所有领域术语

提升: G-5 修正了 module_sandbox.md 中 DEC/fscrypt 术语误用，与 module_spm.md 和术语表保持一致 (+1)。

4. 可读性 (14/15)

• 总览文件结构清晰
• 分文件自包含并链接到相关模块
• 代码片段格式正确并有注释
• Mermaid 图表有效且信息丰富

提升: 新增 prefork 序列图、DEC 数据流序列图 (+1)。

5. 准确性 (9/10)

抽查验证（保留原 5 项 + 新增）:

• APPSPAWN_MSG_MAGIC = 0xEF201234 -- 验证通过 (appspawn_msg.h:45)
• STAGE_CHILD_EXECUTE 存在 -- 验证通过 (appspawn_hook.h:82)
• MODULE_CONSTRUCTOR 宏定义 -- 验证通过 (appspawn_hook.h:219)
• UID 白名单 (0, 3350, 5523, 1090) -- 验证通过 (appspawn_service.c:404)
• APP_MAX_GIDS = 64 -- 验证通过 (appspawn.h:57)
• 新增: DEV_DEC_MINOR = 0x25 -- 验证通过 (sandbox_dec.h:32)
• 新增: KERNEL_BATCH_SIZE = 8（DEC 单批上限） -- 验证通过 (sandbox_dec.h)
• 新增: prefork 配置项 persist.sys.prefork.enable -- 验证通过 (appspawn_service.c:1949)
• 新增: devicedebug 消息类型 MSG_DEVICE_DEBUG -- 验证通过 (appspawn.h:124)

提升: G-5 修正了 "DEC 使用 fscrypt 加密" 的错误描述 (+2)。

⚠ 术语准确性警告：本知识库由 AI agent 生成，存在 agent 为缩写"合理化"全称的倾向，已有两处被发现并修正：

• SPM 全称：Software Permission Management（误）→ Security Process Manager（正，源码 spm.c:18）
• DEC 全称：Distributed Encryption Control（agent 推测，误）→ Dynamic Enhance Control（正，由维护者口述确认；仓库代码内未注释全称）

读者如遇其他缩写全称，请以源码注释或维护者为准。如发现新的推测错误，欢迎修正。

优点

• 核心模块（standard, sandbox, spm, client_api, modulemgr_engine）文档详尽
• 架构图清晰展示了系统组件关系和数据流
• 交叉模块关系分析到位
• 术语表全面，覆盖领域术语
• G-1~G-5 补全后：util 工具函数清单完整（35+）；devicedebug 独立 KP；sandbox JSON 配置 schema 化；prefork 完整调用链 + 序列图；DEC 机制术语纠正

Gap 处理状态

Gap	描述	原严重度	状态	处理方式	落地位置
G-1	util 工具函数细节	Low	Resolved	新增 35+ 函数分类表与代表性代码	module_util.md 新章节
G-2	devicedebug 服务未探索	Low	Resolved	新增 KP-9 含命令路由、协议、服务端链	module_standard.md KP-9
G-3	JSON 配置结构未分析	Medium	Resolved	新增字段表、action 枚举、解析入口、JSON 示例	module_sandbox.md KP-3 扩展
G-4	prefork 代码路径未追踪	Medium	Resolved	新增 KP-10 含 12 步调用链、对比表、序列图	module_standard.md KP-10
G-5	DEC/fscrypt 交互	Low	Resolved	KP-5 重写：修正"fscrypt"误述，补全 ioctl 命令、数据结构、数据流	module_sandbox.md KP-5

新增 Gap（待评估）

Gap	描述	严重度	状态	落地位置
G-6	DEC util 接口层（interfaces/innerkits/dec_util/，dec_api.cpp:166）	Low	Resolved	module_sandbox.md KP-5 子章节
G-7	KickDog 看门狗（standard/appspawn_kickdog.c:147）	Low	Resolved	module_standard.md KP-11

说明：全局扫描代理初版报告中的 G-7（msgmgr）、G-8（fd manager）、G-9（HNP 服务）经行数校验（实际 431/207/488 行，非 agent 误报的 2 万+行）与代码归属核实，已在 standard / hnp 模块覆盖范围内，不计为新 Gap。

建议

• 对 sandbox 模块的 JSON 配置系统进行专项探索 (已完成，见 KP-3 扩展)
• 补充 prefork 机制的完整代码路径追踪 (已完成，见 KP-10)
• 为 common_modules 中的 cgroup 和 namespace 模块增加代码片段 (已覆盖)
• 考虑将 devicedebug 作为独立模块探索 (已并入 KP-9)
• 补全 G-6（DEC util 接口层）和 G-7（KickDog） (已完成)
• 清理 index.md / recon.md 中的本地路径信息（/home/yh/...、分支名、commit hash） (已完成)

统计数据

项	当前	上次
文档化模块总数	12	12
知识点总数	45	42
file:line 引用总数	~140	95
唯一引用文件数	~45	~35
模块间交叉引用	50+	48
术语表条目	15	15
Mermaid 图表	7	5
总览文档行数	185	185
分文档平均行数	~220	161
内容保持率	>= 110%	110.2%

改动文件清单（本次补全）

文件	改动
modules/module_util.md	新增"工具函数详情 (G-1 补全)"章节
modules/module_standard.md	新增 KP-9 devicedebug (G-2) + KP-10 prefork (G-4)
modules/module_sandbox.md	KP-3 扩展 JSON 字段表 (G-3) + KP-5 重写 DEC 机制 (G-5)
quality_report.md	本文件，评分上调、Gap 状态更新
knowledge_base.md	已删除（方案 B 合并）：内容拆分到 index.md 和 architecture.md