写在后面#
为什么编写这些资料？#
常有人问我，为什么要为社团活动重新准备这些资料，而不是直接使用现成的教材——这看起来像是在“重新发明轮子”。说实话，我自己也没有一个非常确定的答案。这些文档在我看来，更像是一页页的PPT，而非信息完备的教程。
理论上，我当然可以直接选用几本深度学习领域的经典著作，比如斋藤康毅老师的“鱼书”。但如果只是像学校上课那样照本宣科，对于纯粹由兴趣驱动的社团来说，恐怕不太合适。这样做很可能导致参与人数随时间“指数级衰减”。我个人对这种单向灌输的模式并不认同——它更像是在把整理与消化知识的负担，从备课者转移给听讲者，效率甚至不如鼓励大家自学。
因此，将知识点重新梳理，用某种清晰、有序的方式呈现出来，就显得非常必要，尤其对于有一定基础的初学者。这些资料的主要目的，并非成为面面俱到的百科全书，而是一份循序渐进的、带有解释的“知识清单”。
关于组织：为什么这些主题看起来有点跳跃？#
我本人是个行动派，习惯边做边想，不太热衷于“三思而后行”。在编写这些文档时，我并没有一个非常完整的大纲，因此内容组织的先后顺序可能显得有些跳跃，但都是大体围绕“是什么”到“为什么”再到“怎么用”这样的顺序。这个问题我们会在后续的修订中尽力改善。
关于形式：为什么不使用传统的PPT？#
那么，为什么我没有选择做成PPT呢？我们的社团指导老师Bob强烈建议我们把学习过程整理成教案，以便后来者参考。PPT固然能突出重点，但它难以处理复杂的引用、丰富的图表插入，以及便捷的公式书写。更重要的是，现有的AI工具在辅助PPT创作方面还不够成熟。
为什么是Sphinx？#
LT;DR
总的来说，我们选择了一种兼顾结构化、可扩展与网页友好的技术语言（Sphinx + Markdown），它在技术文档中已经被广泛验证
最初我使用LaTeX编写，生成的PDF效果很好，但想要编译成网页就不太方便了。我曾尝试用Lwarp配合一个Vue.js写的文档查看器来搭建在线站点，但效果并不理想。受限于Lwarp的一些古怪问题，部署过程屡屡受阻，而且它处理文件间引用的能力也较弱。在寻找替代方案时，我遇到了Sphinx——这个支撑了Linux和Python文档的强大工具。
为什么大量使用AI辅助书写？#
坦白说，一半是因为懒，一半是因为自己水平有限。但主要原因有两点：第一，我们毕竟是AI社团；第二，我们选择的方案（编写Markdown/LaTeX再编译）本身很适合AI辅助。在我看来，只要信息准确、语言简洁，文本是否由AI生成，从功利角度讲并不重要。人们反感的“AI文”，通常是通篇套话的废话文学，而非这样有实质内容、表述清晰的辅助创作。当然，这能否完全代表我个人对知识的理解？我觉得还不够。事实上，AI在输出内容时，也常常给我带来新的启发。而文章质量的把控，始终是我这个“审稿人”的责任。从某种角度看，这也是一种“氛围编码”（Vibe coding）吧。
我发现了疏漏，该如何反馈？#
如果你发现了文档中的错误或不足，我们非常欢迎你的指正。如果你愿意为后来的同学做点贡献，可以fork本资料的仓库，修改后提交Pull Request。我和其他组员审核确认后，便会合并你的修改。（请在PR中尽量详细地说明改动内容，以节省大家的时间。在此先表示感谢！）
最后，希望几年后，这些文字还能帮到那些初来乍到的新朋友。也希望你能在这个社团里，找到探索世界的好奇与同行者。
2025年12月，Anson (Anson2251)
贡献者与修订历史
查看详细修订记录
-
b20ef3e2026-04-28 - Heyan Zhu: docs: update pytorch practice section with detailed explanations and code examples -
49fd5d92025-12-07 - Heyan Zhu: update(doc): complete migrate lesson2 & 4 -
1f386542025-12-07 - Heyan Zhu: feat(doc): partially migrated to sphinx