Thoughts on Jeanphilo Blog

别被 AI 牵着走：保持可独立完成的工程能力

Mon, 08 Dec 2025 00:00:00 +0000

讨论在使用 AI 辅助编码时如何避免复制粘贴依赖，结合费曼技巧、刻意练习与检索练习，给出可操作的自检清单与演练步骤。

How to Build a Blog System

Fri, 14 Nov 2025 15:04:02 +0800

标题：用 Hugo + GitHub Pages 十分钟上线个人博客（超详细新手指南）

副标题 / 摘要

本教程带你从零开始，将本地 Hugo 博客部署到 GitHub Pages，全程只需 10 分钟，适合想快速上线技术博客、文档站点的开发者。确保你不仅能跑起来，还能理解背后的工作原理。

目标读者

Hugo 初学者
想快速上线个人技术博客的开发者
想了解 GitHub Pages + GitHub Actions 部署的用户
想要零成本托管静态网站的同学

背景 / 动机：为什么要用 Hugo + GitHub Pages？

许多人写博客时面临这些痛点：

发布文章要手动上传，不自动化
静态站点生成器很多，但部署步骤零散
GitHub Pages 文档不够清晰，新手容易踩坑
主题（如 PaperMod）需要正确处理资源（SCSS）才能编译成功

Hugo + GitHub Pages + GitHub Actions 组合 完美解决了这些问题：

Hugo 构建速度极快（上千文章依旧瞬间生成）
GitHub Pages 完全免费，不需要服务器
GitHub Actions 自动部署，写完文章 push 即上线

核心概念（必须理解）

1. Hugo

一个超快的静态博客生成器，通过 Markdown 生成 HTML。

2. GitHub Pages

GitHub 提供的免费静态网站托管。

How to Publish by Hugo

Fri, 14 Nov 2025 15:01:32 +0800

标题：如何使用 Hugo 发布文章：从 Markdown 到线上博客的全流程指南

副标题 / 摘要

这篇文章教你如何使用 Hugo 创建、管理与发布文章，包括 front matter 设置、草稿管理、图片处理、目录结构、预览与上线，让你从零掌握完整写作流程。

目标读者

Hugo 初学者
想用 Hugo 搭建技术博客的人
想学习 Markdown + 静态站点写作流程的开发者
使用 PaperMod、DoIt 等主题的用户

背景 / 动机

很多人在成功搭建 Hugo 博客后会遇到新的困惑：

文章应该放在哪个目录？
front matter 要怎么写？
图片要放哪？
为什么本地能看到文章但线上看不到？
草稿 / 发布时间如何控制？
怎样让文章自动出现在首页？

这些都是 Hugo 新手非常常见的痛点。本教程用实战步骤 + 最佳实践帮助你完全掌握“如何发布文章”的整个流程。

核心概念

1. Hugo Content（内容目录）

Hugo 的文章都放在 content/ 目录下，比如：

content/
posts/
my-first-post.md

2. Front Matter

文章头部的三段 YAML/TOML/JSON，用来控制文章：

---
title: "文章标题"
date: 2024-08-26
draft: false
tags: ["hugo", "blog"]
---

3. Draft（草稿）

草稿不会被构建，只能在本地用 hugo server -D 查看。

api标准

Thu, 06 Nov 2025 00:00:00 +0000

🧭 标题：

如何编写一份合格的 API 文档：从 Tony Tam 的 Swagger 到现代 OpenAPI 实践

✍️ 副标题 / 摘要

想让你的 API 被开发者真正用得舒服？这篇文章将带你从理念到实践，全面掌握一份高质量 API 文档的结构、示例与最佳规范，基于 Tony Tam 提出的 Swagger / OpenAPI 标准。

🎯 目标读者

初学者：想了解 API 文档标准结构的人。
中级开发者：希望提升接口文档可维护性与规范性的人。
架构师 / 技术负责人：负责 API 设计规范制定与团队协作的人。

💡 背景 / 动机

许多开发团队的 API 文档存在以下痛点：

信息零散，缺乏统一格式；
更新滞后，开发与文档脱节；
无法直接用于自动生成或测试。

Tony Tam 于 2010 年提出的 Swagger 规范（后更名为 OpenAPI） 正是为了解决这些问题。如今，它已成为 RESTful API 文档的事实标准，被 Google、Amazon、Stripe 等公司广泛采用。

🔍 核心概念

概念	说明
API 文档	描述应用程序接口如何被调用、请求与响应的技术说明书。
Swagger / OpenAPI	一种用于定义、生成、测试 REST API 的标准化规范。
Endpoint（端点）	API 中可访问的具体路径（如 `/users/{id}`）。
Schema（数据模型）	定义请求与响应的字段结构。

🧰 实践指南 / 步骤

明确文档结构

对于ai系统的思考

Fri, 31 Oct 2025 00:00:00 +0000

对于一个系统来说，单线程就应该是一个助手，我们应该给每个用户就单纯提供一个助手，我们所需要做的就是优化这一个助手，

绝对不是向一个用户可以提供很多个线程的处理方式，成本太高

怎么撰写一篇完美的机器学习文档

Fri, 24 Oct 2025 00:00:00 +0000

🧠 Bengio 风格的机器学习任务说明文档：从研究到工程的技术规范指南

副标题： 如何编写一份可复现、可解释、可比较的模型微调任务说明文档 —— 来自 Yoshua Bengio 的研究方法论 阅读时长： 10 分钟 标签： 机器学习文档结构 模型微调 技术规范 深度学习实践 适合读者： 中高级 ML 工程师、研究员、技术写作者

一、为什么需要这样的文档？

在机器学习项目中，我们经常遇到这样的情况：团队完成了一个模型微调实验，但几个月后再回头看，没人能完全复现结果，也不清楚为什么要采用某个学习率或 LoRA 层。

Yoshua Bengio（深度学习三巨头之一）早在 Montréal Institute for Learning Algorithms (MILA) 就提出了一个理念：

“一个机器学习研究或工程任务的文档，必须能让他人完全重现结果并理解背后的设计动机。”

这就是后来被称为 Bengio-style Machine Learning Project Report Structure 的经典模板，被 Google Research、Meta AI、OpenAI 等广泛采用。

二、Bengio 风格模板的核心思想

项目	内容
来源	Yoshua Bengio，《Deep Learning Research Practice Notes》
目标	确保机器学习实验可复现、可理解、可比较
适用场景	模型微调、对比实验、学术研究报告、内部技术说明
优势	逻辑清晰、结构统一、可直接转化为论文或内部白皮书

三、标准结构（适用于四个模型微调任务）

以下是 Bengio 风格文档的经典九个部分：

关于ai助手前端界面的新构建方案构思

Wed, 27 Aug 2025 00:00:00 +0000

Introduction

我现在想要构建一个可以树状,或者图状进行问答的ai系统,而不是传统的单线式对话流程

探索

开源框架探索

flowise

mastering paper

Tue, 26 Aug 2025 00:00:00 +0000

如何尽可能掌握一篇论文中的所有知识

结论

我们要真正"掌握"一篇论文,不是读一遍就行,而是按照现有结构把论文进行拆解,验证,重构并把关键点转化为你自己的表述或者实现.目标是:可以在5分钟内讲清楚核心贡献,可以手推关键公式,可以实现并复现一个核心实验

原理和背景

论文是作者对问题的压缩表达：省略背景、实验细节、直觉和失败。要掌握，需要把这种高密度信息“解压”回你自己的知识网络：理解背景假设、数学推导、工程实现、以及结论的适用范围。这样才能判断什么时候能用，什么时候不能用，什么时候要改进。

具体步骤

不要把论文当成“权威”，把它当成一个可以测验的主张：把声明分解成可验证的小断言，然后去验证它。掌握不是记住论文的文字，而是把它变为你自己能用的工具。不要偷懒 — 真正的理解需要做事：推导、实现、对比、解释。现在就挑一篇，按上面的三天计划开始。

准备与预读（30–60 分钟）

读题目、摘要、结论、图表（不必细读正文）。目的：抓住“这篇论文到底解决了什么问题、给出了什么结果”。
快速扫一遍引言和贡献列表，记录作者声称的三个关键点。
检查参考文献，确定是否需要补读哪些基础材料（比如某个经典算法或证明）。

精读（2–6 小时）

逐段细读方法/理论部分。遇到公式，尝试手推关键推导（用纸和笔）。
把每个重要符号写成表格，免得混淆。对算法，写伪代码。
标注不理解/可疑的地方，形成问题清单。

解构与重构（半天到几天）

把论文分解为：问题定义、关键假设、方法/算法、主要定理、实验设置、结论与限制。
为每一部分写一段 2–3 句的“我能讲给同领域的人”的解释（用你自己的话）。
将算法实现为最小可运行版本（See 实现建议）。

实现与复现（几小时到几天）

优先实现最能体现贡献的部分（一个算法/一个模型/一个关键实验）。
用小规模合成数据先做调试，再跑论文的设置。
必要工具/模板示例：
推荐环境：Python + Jupyter/Colab，或 C++/Rust（如果是系统/性能论文）。
常用库：numpy/pandas/matplotlib/scikit-learn/torch/tensorflow。
示例：把论文算法写成 Python 函数（伪代码转实现）。
逐行注释已写在函数 docstring 和代码中。把论文中的符号映射到代码变量，记录在注释里。

绘图与结果对比

重现关键图表（训练曲线、误差表）。如果不能一次跑出论文结果，先验证趋势和相对对比（例如比基线高多少）。
加入断言和单元测试：例如，对已知问题（合成数据）的行为应与理论一致。

消化与输出（持续）

把关键点写成一页“cheatsheet”或一篇短博客，目标：在五分钟内让人理解。
将难点做成 Anki 卡片（问题：关键假设、定理条件、公式推导步骤）。
尝试解释给陌生人或写读书报告。

工具推荐（实操）

文献管理：Zotero / Mendeley
笔记与知识库：Obsidian / Notion / org-mode
代码与实验：Git + Jupyter/Colab + Docker（必要时复现环境）
文本处理：pdftotext、pdfgrep、grep、ripgrep

常见错误

错误：只读不做（只看结论，不推导、不实现）。
调试：强制自己实现或至少写伪代码并手推一遍。
错误：忽视假设/边界条件（在不满足假设的地方直接使用方法）。调试：列出所有假设，构造违反假设的测试用例，观察失败模式。
错误：把作者的实现等同于论文中的方法（代码细节、超参常被省略）。调试：阅读作者代码（如开源），比对论文描述，记录差异。
错误：过早追求论文结果的数值精确复现。调试：先验证可复制的趋势，再逐步细化超参/实现细节。
错误：数学推导只看结论公式，未验证每一步是否合法。调试：逐行手推，找出隐含步骤或引用的引理，补读来源。

验证方法

能在五分钟内口述论文的核心贡献、适用场景与限制（不看稿）。能手动推导关键公式或重写证明的主要步骤（纸笔完成）。能实现一个最小工作例子，得到与论文一致的趋势或数值（至少在合成数据上）。能回答以下问题：作者的关键假设是什么？结果如何依赖这些假设？有哪些潜在失败模式？能把论文的想法应用到一个稍有不同的问题上并观察结果（迁移能力）。

阅读nvidia小模型理论论文

Tue, 26 Aug 2025 00:00:00 +0000

这篇论文解决了什么问题,给出了什么结果

首先我们知道AI系统现在广阔发展,可以像人类一样解决很多通用问题,但是现在发展中的ai agent系统所制作的大量应用作用于一些很小的任务,然后nvidia在这篇文献中提出了小语言模型(SLMs) 有着足够的能力,更适合,而且也更廉价,对于很多agent系统,也应该作为后来ai agent的一个主要发展方向

然后针对与其提出的这个论点,该论文进行了以下几点讨论 1.当前小语言模型可以做到的任务 2.在某些通用语言能力是重要的部分 3.讨论了小模型作为agent系统的潜力界限

结论,介绍了不管是从能力还是经济价值方面,从LLMs移动到SLMs的优势