[{"content":"它到底是什么先用一句话说清楚：AI 编程助手是一个能读你的代码、按你的要求改代码、还能自己跑命令验证的智能体（agent）。\n和普通的代码补全（code completion）不同，它面对的是整个任务，而不是光标后面那一行。\n一句话记住把它当成一位“刚入职、很勤快、但不了解背景”的同事：任务说得越清楚，结果越好。\n打个比方普通补全像输入法联想，只帮你把这句话说完；编程助手像请了一位实习生，你交代一件事，他自己去翻代码、动手改、跑测试，最后把改动交给你审。\n所以关键不在“它会不会写代码”，而在你会不会交代任务。\n怎么给它布置任务一条好的任务描述通常有三部分：\n公式任务描述模板目标：\u0026lt;要达成什么，一句话\u0026gt; 上下文：\u0026lt;相关文件、约束、已有做法\u0026gt; 验收：\u0026lt;怎样算做完，比如哪个测试要通过\u0026gt; 目标：只写一件事，避免“顺便也把……” 上下文：告诉它去看哪些文件、不能动哪些文件 验收：可执行、可检查，比如 npm test 全部通过 算一遍把一句模糊的需求改写成好任务原始需求：“帮我把登录做好一点。”\n找出真正的目标：登录失败时要给出明确提示。 补上下文：登录逻辑在 src/auth/login.ts，不要改数据库结构。 写验收：新增一个测试，密码错误时返回“密码不正确”。 合起来：“在 src/auth/login.ts 里，密码错误时返回‘密码不正确’提示；不改数据库；新增对应单元测试并通过。” 答：改写后的任务有明确目标、范围和验收标准，助手不用猜。\n先想一想下面哪条任务描述最好？\nA. “优化一下代码。” B. “把 utils.js 里的日期格式化函数改成支持时区，并补测试，npm test 通过即可。” C. “把整个项目重构成 TypeScript。” 想好了，看答案选 B。A 没有目标，助手只能乱猜；C 范围太大，一次很难验收。B 有明确的文件、目标和验收标准。\n检查它的改动助手交回改动以后，不要直接合并。\n实操要点 先看 diff：改了哪些文件，有没有动到不该动的地方。 再看 测试：它说测试通过了，自己再跑一遍。 最后看 说明：让它用三句话解释改了什么、为什么这么改。 别踩坑 一次给它十件事，最后一起验收。 只看它的总结，不看实际 diff。 测试失败时让它“直接把测试删了”。 一次一件事，每件事都有能执行的验收标准。 本篇小结 编程助手面对的是任务，不是一行代码。 好任务 = 目标 + 上下文 + 验收。 改动一定要自己看 diff、跑测试。 ","date":"2026 年 11 月 1 日","externalUrl":null,"permalink":"/notes/codex-intro/","section":"AI 工具教程与学习笔记","summary":"","title":"Codex 入门","type":"notes"},{"content":"先分清两个概念用 AI 助手时最容易混的是上下文窗口（context window）和记忆（memory）。\n一句话记住上下文窗口是“桌面”，记忆是“抽屉”：桌面放当前在用的东西，抽屉放以后还要用的东西。\n打个比方上下文窗口像一张固定大小的书桌，东西太多就得把旧的推下去；记忆像旁边的文件柜，需要时再拿出来放回桌上。\n估算 token 用量公式$$\\text{总 token} \\approx \\text{系统提示} + \\sum_{i=1}^{n} (\\text{提问}_i + \\text{回答}_i)$$ 中文大约 1 个汉字 ≈ 1～2 个 token（不同模型不一样，这里只是示例） 对话越长，每一轮都要把前面的内容再带上 算一遍估算一段对话的用量（示例数字） 系统提示约 500 token。 共 5 轮对话，每轮提问约 200、回答约 1,000 token。 合计：500 + 5 × (200 + 1,000) = 6,500。 答：约 6,500 个 token。\n先想一想对话越来越长以后，回答开始“忘记”最早说过的要求，最可能的原因是什么？\n想好了，看答案早期内容超出了上下文窗口被截掉了。解决办法是把关键要求写进记忆或系统提示，或者开一个新对话并附上摘要。\n常用指令清单 场景 示例指令（占位） 总结 “用三句话总结上面的内容” 改写 “改成更口语的语气，保留要点” 检查 “列出这段话里可能的事实错误” 实操要点让助手越用越顺手 把反复用到的偏好写成固定的系统提示。 每次开新任务前，先给一段背景摘要。 别踩坑 把密码、密钥直接贴进对话。 一个对话里塞进十几个不相关的任务。 一个任务一个对话，敏感信息永远不贴。 ","date":"2026 年 11 月 2 日","externalUrl":null,"permalink":"/notes/hermes-notes/","section":"AI 工具教程与学习笔记","summary":"","title":"Hermes 使用笔记","type":"notes"},{"content":"提示框怎么写每种提示框都是一个 Hugo 短代码（shortcode），包住一段 Markdown 即可。\n公式短代码一览key 一句话记住 analogy 打个比方 example 算一遍(answer=) formula 公式 tip 实操要点 pitfall 别踩坑（✗ / ✓ 开头的列表） check 先想一想（里面放 reveal） term 术语弹窗 ==文字== 高亮 一句话记住一段只放一个提示框，提示框里只讲一件事。\n写完以后的检查别踩坑 提示框一个接一个，正文反而没几句。 正文讲清楚，提示框只做强调和补充。 先想一想“别踩坑”的列表项要以什么开头，才会显示红叉和绿勾？\n想好了，看答案以 ✗ 开头显示红叉（错误做法），以 ✓ 开头显示绿勾（正确做法）。\n","date":"2026 年 11 月 3 日","externalUrl":null,"permalink":"/notes/learning-method/","section":"AI 工具教程与学习笔记","summary":"","title":"怎么做学习笔记","type":"notes"},{"content":"怎么用这些笔记【占位】左边按系列列出了全部笔记，带圈的数字是它在系列里的顺序。每一节末尾都有“这一节我看懂了”按钮，点一下就会记进度，进度只存在你自己的浏览器里。\n正文里带虚线下划线的词（比如智能体（agent））都可以点开看解释。提示框只有下面几种，看颜色就知道它在干什么：\n一句话记住这一段最该记住的一句话。 打个比方用生活里的事情解释一个抽象概念。 算一遍带具体操作或数字的例子，一步一步来，最后给结论。 公式正式的公式、命令格式或模板，下面逐个解释。 实操要点真正上手时最值得注意的地方。 别踩坑最容易犯的错误做法（✗）和正确做法（✓）。 先想一想先自己想答案，再点开对照。 ","date":"2026 年 11 月 3 日","externalUrl":null,"permalink":"/notes/","section":"AI 工具教程与学习笔记","summary":"","title":"AI 工具教程与学习笔记","type":"notes"},{"content":"","date":"2026 年 11 月 3 日","externalUrl":null,"permalink":"/","section":"Theo Howe","summary":"","title":"Theo Howe","type":"page"},{"content":"","date":"2026 年 11 月 2 日","externalUrl":null,"permalink":"/tags/hugo/","section":"Tags","summary":"","title":"Hugo","type":"tags"},{"content":"","date":"2026 年 11 月 2 日","externalUrl":null,"permalink":"/tags/","section":"Tags","summary":"","title":"Tags","type":"tags"},{"content":"","date":"2026 年 11 月 2 日","externalUrl":null,"permalink":"/blog/","section":"博客","summary":"","title":"博客","type":"blog"},{"content":"","date":"2026 年 11 月 2 日","externalUrl":null,"permalink":"/tags/%E5%BB%BA%E7%AB%99/","section":"Tags","summary":"","title":"建站","type":"tags"},{"content":" 技术选型 # 【占位】Hugo 生成静态页面，主题用 Blowfish，部署到 Cloudflare Pages。\nhugo new site theo-site git submodule add https://github.com/nunocoracao/blowfish.git themes/blowfish hugo server 部署 # 【占位】推送到 GitHub 后，Cloudflare Pages 自动构建。\n","date":"2026 年 11 月 2 日","externalUrl":null,"permalink":"/blog/site-setup/","section":"博客","summary":"记录这个网站的技术选型与部署方式（占位）。","title":"用 Hugo + Blowfish 搭个人网站（占位文章）","type":"blog"},{"content":" 这是一篇占位文章，博客样式暂用 Blowfish 默认，之后再定。 为什么建这个网站 # 【占位】写下建站的初衷。\n接下来会写什么 # 【占位】项目复盘 【占位】工具推荐 【占位】生活随笔 【占位】一句喜欢的话。\n","date":"2026 年 11 月 1 日","externalUrl":null,"permalink":"/blog/hello-world/","section":"博客","summary":"第一篇占位文章，用来展示博客的默认样式。","title":"你好，世界（占位文章）","type":"blog"},{"content":"","date":"2026 年 11 月 1 日","externalUrl":null,"permalink":"/tags/%E9%9A%8F%E7%AC%94/","section":"Tags","summary":"","title":"随笔","type":"tags"},{"content":"","date":"2026 年 10 月 4 日","externalUrl":null,"permalink":"/tags/cloudflare/","section":"Tags","summary":"","title":"Cloudflare","type":"tags"},{"content":" 占位项目：以下内容均为示例，待替换。 项目简介 # 用 Hugo + Blowfish 搭建、部署在 Cloudflare Pages 上的个人网站（占位描述）。\n用到的技术 # 【占位】技术 1 【占位】技术 2 链接 # 演示：https://example.com 源码：https://github.com/your-username ","date":"2026 年 10 月 4 日","externalUrl":null,"permalink":"/projects/project-d/","section":"项目","summary":"用 Hugo + Blowfish 搭建、部署在 Cloudflare Pages 上的个人网站（占位描述）。","title":"示例项目 D：这个网站","type":"projects"},{"content":"【占位】这里展示我做过和正在做的项目，下面的卡片都是示例。\n","date":"2026 年 10 月 4 日","externalUrl":null,"permalink":"/projects/","section":"项目","summary":"","title":"项目","type":"projects"},{"content":"","date":"2026 年 10 月 3 日","externalUrl":null,"permalink":"/tags/%E6%8F%92%E4%BB%B6/","section":"Tags","summary":"","title":"插件","type":"tags"},{"content":"","date":"2026 年 10 月 3 日","externalUrl":null,"permalink":"/tags/%E5%89%8D%E7%AB%AF/","section":"Tags","summary":"","title":"前端","type":"tags"},{"content":" 占位项目：以下内容均为示例，待替换。 项目简介 # 一个提升阅读效率的浏览器插件（占位描述）。\n用到的技术 # 【占位】技术 1 【占位】技术 2 链接 # 演示：https://example.com 源码：https://github.com/your-username ","date":"2026 年 10 月 3 日","externalUrl":null,"permalink":"/projects/project-c/","section":"项目","summary":"一个提升阅读效率的浏览器插件（占位描述）。","title":"示例项目 C：浏览器插件","type":"projects"},{"content":" 占位项目：以下内容均为示例，待替换。 项目简介 # 把笔记、书签和对话整理成可搜索的知识库（占位描述）。\n用到的技术 # 【占位】技术 1 【占位】技术 2 链接 # 演示：https://example.com 源码：https://github.com/your-username ","date":"2026 年 10 月 2 日","externalUrl":null,"permalink":"/projects/project-b/","section":"项目","summary":"把笔记、书签和对话整理成可搜索的知识库（占位描述）。","title":"示例项目 B：个人知识库","type":"projects"},{"content":"","date":"2026 年 10 月 2 日","externalUrl":null,"permalink":"/tags/%E7%9F%A5%E8%AF%86%E7%AE%A1%E7%90%86/","section":"Tags","summary":"","title":"知识管理","type":"tags"},{"content":"","date":"2026 年 10 月 1 日","externalUrl":null,"permalink":"/tags/ai/","section":"Tags","summary":"","title":"AI","type":"tags"},{"content":"","date":"2026 年 10 月 1 日","externalUrl":null,"permalink":"/tags/%E5%B7%A5%E5%85%B7/","section":"Tags","summary":"","title":"工具","type":"tags"},{"content":" 占位项目：以下内容均为示例，待替换。 项目简介 # 一个把日常重复工作交给 AI 的小工具（占位描述）。\n用到的技术 # 【占位】技术 1 【占位】技术 2 链接 # 演示：https://example.com 源码：https://github.com/your-username ","date":"2026 年 10 月 1 日","externalUrl":null,"permalink":"/projects/project-a/","section":"项目","summary":"一个把日常重复工作交给 AI 的小工具（占位描述）。","title":"示例项目 A：AI 工作流助手","type":"projects"},{"content":"","externalUrl":null,"permalink":"/categories/","section":"Categories","summary":"","title":"Categories","type":"categories"},{"content":"","externalUrl":null,"permalink":"/series/","section":"Series","summary":"","title":"Series","type":"series"},{"content":" 本页是占位内容，所有信息待替换成真实介绍。 👋 你好，我是 Theo Howe # 【占位】在这里写一段自我介绍：你是谁、现在在做什么、对什么感兴趣。\n🛠 我在关注 # 【占位】AI 工具与工作流 【占位】Web 开发 【占位】效率与知识管理 📮 联系方式 # 方式 地址 邮箱 hello@example.com GitHub github.com/your-username X x.com/your-username 发邮件给我 ","externalUrl":null,"permalink":"/about/","section":"Theo Howe","summary":"","title":"关于 / 联系方式","type":"page"}]