[{"content":"这里记录我在 AI 应用、Agent 开发与工程实践中的学习与思考。\n","date":"2026年10月30日","externalUrl":null,"permalink":"/","section":"AI 工程师笔记","summary":"","title":"AI 工程师笔记","type":"page"},{"content":"","date":"2026年10月30日","externalUrl":null,"permalink":"/categories/","section":"Categories","summary":"","title":"Categories","type":"categories"},{"content":"","date":"2026年10月30日","externalUrl":null,"permalink":"/tags/hugo/","section":"Tags","summary":"","title":"Hugo","type":"tags"},{"content":"","date":"2026年10月30日","externalUrl":null,"permalink":"/tags/obsidian/","section":"Tags","summary":"","title":"Obsidian","type":"tags"},{"content":" 一句话理解 Obsidian # Obsidian 就是一个 Markdown 编辑器：左边管理文件，中间写内容，右边预览效果。默认情况下笔记只保存在本地，就是一个普通的 .md 文件。\n本站所有文章都放在 content/ 文件夹里，所以用 Obsidian 打开 content/ 这个文件夹就可以开始写了。\n第一次打开 # 打开 Obsidian。 点 Open folder as vault（打开文件夹作为仓库）。 选择本项目的 content 文件夹，不要选项目根目录。 如果弹出“是否信任作者”，点信任。 打开后，左侧文件列表里应该能看到 posts、about.md 等文件。\n先做两个设置（只做一次） # 打开左下角齿轮 → Files and links（文件与链接）。\n关闭 Use [[Wikilinks]] Obsidian 默认用 [[笔记名]] 这种写法链接笔记，但 Hugo 不认识它，发布后只会原样显示文字。关掉后，Obsidian 会使用标准 Markdown 链接。 把新附件默认位置改成“当前文件所在文件夹” 即 Default location for new attachments → Same folder as current file。这样拖进来的图片会和笔记放在一起，Hugo 才能找到它。 写第一篇笔记 # 目录结构 # 每篇文章占用一个文件夹：\ncontent/posts/my-first-note/ └── index.md 网址由 frontmatter 里的 slug 决定，建议和文件夹同名：slug: \u0026quot;my-first-note\u0026quot; 对应 /posts/my-first-note/。所以文件夹名和 slug 都请用「英文小写 + 连字符」，不要用中文和空格。如果漏写 slug，Hugo 会拿标题当网址，中文标题就会变成一长串编码。\n在 Obsidian 里新建 # 在左侧 posts 上右键 → New folder（新建文件夹），命名为 my-first-note。 在刚建好的文件夹上右键 → New note（新建笔记），命名为 index。 打开 index.md，把下面这段粘贴到文件最上面： --- title: \u0026#34;我的第一篇笔记\u0026#34; slug: \u0026#34;my-first-note\u0026#34; date: 2026-10-30 draft: true summary: \u0026#34;一句话说明这篇笔记写什么\u0026#34; tags: [\u0026#34;随笔\u0026#34;] categories: [\u0026#34;笔记\u0026#34;] series: [] --- 字段说明：\n字段 作用 建议 title 网页上的标题 直接写中文 slug 网址里的英文名 和文件夹名一致，如 my-first-note date 发布日期 格式 YYYY-MM-DD draft 是否草稿 写作时 true，发布时改 false summary 列表页的一句话摘要 一句话即可 tags 标签 没有就留 [] categories 分类 没有就留 [] series 系列名 没有就留 [] title、slug、date、draft 建议一定保留，其他字段可以删。\nObsidian 会把这段显示成一张“属性”表格，这是正常的。如果想直接看原始文本，可以在 设置 → 编辑器 → 文档属性 里切换成“源码”模式。\n在属性下面空一行，开始写正文。 更省事的方式（可选） # 在项目根目录运行：\nhugo new content posts/my-first-note/index.md 会自动生成文件夹和带 frontmatter 的 index.md，Obsidian 里会立刻出现。默认是 draft: true，记得改标题和日期，并补上 slug。\n正文怎么写 # 只记下面这些就够用了：\n用途 写法 二级标题 ## 二级标题 三级标题 ### 三级标题 加粗 **重点内容** 无序列表 - 第一项 有序列表 1. 第一步 引用 \u0026gt; 引用内容 行内代码 `hugo server` 链接 [OpenAI](https://openai.com) 图片 ![图片说明](photo.png) 代码块用三个反引号包起来，例如：\n```python print(\u0026#34;hello\u0026#34;) ``` 正文一般从 ## 开始，不要用 #。因为 frontmatter 里的 title 已经是文章的一级标题了。\n插入图片 # 确认前面已经设置过“附件放当前文件夹”。 直接把图片拖进正在编辑的笔记，或者复制图片后粘贴。 Obsidian 会自动把图片存到 index.md 旁边，并插入一行 ![](图片名.png)。 |想截什么|快捷键|说明| |---|---|---| |整个屏幕|Shift + Command + 3|直接保存整屏截图| |选定区域|Shift + Command + 4|拖选区域，松开即截图| |某个窗口|Shift + Command + 4，再按 空格|指针变相机，点窗口即可| |截图工具栏|Shift + Command + 5|可选区域、窗口、录屏、定时器等| - **取消截图**：按 **Esc**。 - **复制进剪贴板**：在上述快捷键里多加一个 **Control**，比如 `Control + Shift + Command + 4`，就不会生成桌面文件。 默认截图会保存在**桌面**，文件名类似 `Screen Shot [日期] [时间].png`。 最终目录长这样：\ncontent/posts/my-first-note/ ├── index.md └── photo.png 不要手写 ![[photo.png]]，站点上不会显示。关闭 Wikilink 后，Obsidian 会自动使用标准写法。\n标签和搜索 # 标签写在 frontmatter 的 tags 里，例如 tags: [\u0026quot;Agent\u0026quot;, \u0026quot;RAG\u0026quot;]。站点会自动生成标签页面。 搜索所有笔记：Cmd + Shift + F（Windows 是 Ctrl + Shift + F）。 快速打开某篇笔记：Cmd + O（Windows 是 Ctrl + O），输入文件夹名即可。 本地预览与发布 # 写作期间保持 draft: true，草稿不会出现在正式站点。\n本地预览：\nhugo server -D 然后打开 http://localhost:1313。-D 表示包含草稿，去掉就只能看到已发布的文章。\n准备发布时：\n把 frontmatter 里的 draft: true 改成 draft: false。 运行 hugo --gc --minify 重新构建。 把改动提交到 Git。 目前还没有自动部署，构建结果在 public/，由服务器上的 nginx 发布。\n笔记之间互相链接（可以先跳过） # Obsidian 的 [[另一篇笔记]] 在站点上不会生效。如果确实要链接，用标准 Markdown：\n[另一篇笔记](/posts/other-note/) 注意地址写的是文章网址，不是文件路径。这种链接在 Obsidian 里可能点不开，但发布后可以正常跳转。新手可以暂时不写站内链接。\n常见问题 # 左侧文件列表里全是 index：正常。本站每篇笔记都叫 index.md，靠文件夹名区分，看文件夹名就行。 图片在 Obsidian 里能看，网站上不显示：检查图片是否和 index.md 在同一个文件夹，以及有没有使用 ![[...]] 写法。 改了内容网站没变化：本地 hugo server 会自动刷新；线上需要重新构建并发布。 文件夹能用中文名吗：不建议。文件夹名就是网址，中文会变成一长串编码，也不方便分享。 .obsidian 文件夹是什么：Obsidian 的本地设置，Hugo 会忽略，不影响站点。 忘了 frontmatter 怎么写：复制任意一篇现有笔记，或者用 hugo new content 生成。 五个动作小结 # 用 Obsidian 打开 content/ 文件夹。 在 posts 下新建英文文件夹。 在文件夹里新建 index.md。 顶部粘贴 frontmatter，正文用 Markdown 写。 写完把 draft 改成 false，预览、构建、提交。 ","date":"2026年10月30日","externalUrl":null,"permalink":"/posts/obsidian-beginner-guide/","section":"文章","summary":"打开 content 文件夹、新建 index.md、写正文、插图片、发布——只学最必要的五步。","title":"Obsidian 新手教程：只用它来写笔记","type":"posts"},{"content":"","date":"2026年10月30日","externalUrl":null,"permalink":"/series/","section":"Series","summary":"","title":"Series","type":"series"},{"content":"","date":"2026年10月30日","externalUrl":null,"permalink":"/tags/","section":"Tags","summary":"","title":"Tags","type":"tags"},{"content":"","date":"2026年10月30日","externalUrl":null,"permalink":"/series/%E4%BB%8E%E9%9B%B6%E6%90%AD%E5%BB%BA%E7%AC%94%E8%AE%B0%E4%BD%93%E7%B3%BB/","section":"Series","summary":"","title":"从零搭建笔记体系","type":"series"},{"content":" 写在前面 # 这是一篇示例文章，用于确认主题、公式、流程图和代码块都能正常渲染。确认无误后可以删除。\n数学公式 # 行内公式：\\(E = mc^2\\)。\n块级公式：\n$$ \\mathcal{L}(\\theta) = -\\sum_{i=1}^{N} \\log p_\\theta(y_i \\mid x_i) $$ 流程图 # graph TD A[Obsidian 笔记] --\u003e B[Git 仓库] B --\u003e C[Hugo + Blowfish] C --\u003e D[静态站点] 代码 # def greet(name: str) -\u0026gt; str: return f\u0026#34;hello, {name}\u0026#34; ","date":"2026年10月30日","externalUrl":null,"permalink":"/posts/hello-ai/","section":"文章","summary":"站点搭建完成后的第一篇示例文章，用于验证主题、数学公式、Mermaid 流程图和代码块。","title":"第一篇笔记：开始记录 AI 工程实践","type":"posts"},{"content":"","date":"2026年10月30日","externalUrl":null,"permalink":"/categories/%E5%B7%A5%E5%85%B7/","section":"Categories","summary":"","title":"工具","type":"categories"},{"content":"","date":"2026年10月30日","externalUrl":null,"permalink":"/tags/%E9%9A%8F%E7%AC%94/","section":"Tags","summary":"","title":"随笔","type":"tags"},{"content":"","date":"2026年10月30日","externalUrl":null,"permalink":"/posts/","section":"文章","summary":"","title":"文章","type":"posts"},{"content":"","date":"2026年10月30日","externalUrl":null,"permalink":"/tags/%E6%96%B0%E6%89%8B%E6%95%99%E7%A8%8B/","section":"Tags","summary":"","title":"新手教程","type":"tags"},{"content":"","date":"2026年10月30日","externalUrl":null,"permalink":"/categories/%E7%AB%99%E7%82%B9%E6%90%AD%E5%BB%BA/","section":"Categories","summary":"","title":"站点搭建","type":"categories"},{"content":"","externalUrl":null,"permalink":"/authors/","section":"Authors","summary":"","title":"Authors","type":"authors"},{"content":" 你好，我是 wente # AI 工程师，关注 AI 应用、Agent 与工程化实践。\n这里是个人介绍，待补充：\n关注方向：AI 应用、Agent、RAG、工程化 联系方式：待补充 ","externalUrl":null,"permalink":"/about/","section":"AI 工程师笔记","summary":"","title":"关于","type":"page"}]