改写润色

把复述代码的字面注释改写成解释「为什么」的意图型注释，按团队规范统一语言、时态与标签格式，并标出应删除的冗余注释。

把内部草稿式的接口说明改写成面向外部调用方的参考文档：统一第二人称、补齐前置条件与返回值语义，输出可直接粘进文档站的结构化 Markdown。