给一个函数补上说明

场景：~/proj/lib.py 里有几个函数，其中一个没写说明——就是行为最不明显的那个（会抛异常）。

任务：给它补上文档字符串，写清：它做什么、参数、返回、异常（这四个词都要出现）。补好运行 ~/check（它调用 tools/doccheck.py 的第 2 项）。

（判分只看你在受控容器里做出的真机产物：找东西类到 ~/对照表.txt 查标记填进题里；改状态类改完运行 ~/check。）

（本机受控环境：项目在 ~/proj（第 2、3 题在 ~/proj2），文档检查器是仓库自带的 tools/doccheck.py（纯本机），无外网、没有 root；题面细节在 ~/说明.txt。）