Week 2 · M6a · 打包与项目结构操作清单（周一块 3）¶

用法：照顺序做，每完成一步把 [ ] 改成 [x]，并把要求记录的输出/答案写在该步下面的"记录"里。全程在仓库根目录 learn-python/ 执行命令（除特别说明）。卡住 8 分钟以上再按 ai-guide.md 的模板提问。

0. 为什么要有这份清单¶

第 1 周的代码是"一堆脚本"，第 2 周开始是"一个包"。包和脚本的区别不在于语法，而在于：别人（和一个月后的你）能不能安装它、导入它、给它写测试、给它发版本。

在 pyproject.toml 里指出这四段各自的作用：[project]、[project.scripts]、 [build-system]、[tool.ruff.lint]。
回答：为什么代码放在 src/kb/ 而不是仓库根的 kb/？（关键词：假阳性导入、 "在仓库根能 import、装好后却不能"）

记录：

（在这里写你的答案）

uv sync
uv run kb hello 小明
uv run python -m kb hello 小明
回答：这两条命令分别是怎么找到代码的？（关键词：[project.scripts] 生成的 .venv/Scripts/kb.exe 包装器 / python -m 找到包的 __main__.py）
故意试一次 uv run python projects/kb/src/kb/cli.py，把报错抄下来，解释为什么会失败。

记录：

（在这里写你的答案与报错信息）

记录：

（在这里写 wheel 的文件清单要点）

uv run python -c "import kb, importlib.metadata as m; print(kb.__file__, m.version('kb'))"
回答：importlib.metadata.version("kb") 读的是哪里的信息？和 kb.__version__ 有什么区别？如果两者不一致会怎样？

记录：

（在这里写你的答案）

确认 src/kb/cli.py 里有 version 子命令（骨架已给）；读懂它为什么在函数内部才 from kb import __version__（提示：避免循环导入 + 启动更快）。
在 projects/kb/tests/test_cli.py 里补一条测试：CliRunner 调用 version，断言输出里含 kb.__version__。
uv run pytest projects/kb/tests/test_cli.py -q

记录：

（在这里写测试通过的输出）

记录：

（在这里写你的答案）