Hi我擅长AI 大模型应用落地、意识解码与 AI 开发工具链。 创业路上用技术换时间一起把 AI 变成生产力 GitHub 热门项目拆解用 AI 与自动化重塑个人进阶知识库在技术快速迭代的当下单凭传统的记笔记已无法处理海量信息。近期在 GitHub 上热度极高的byoungd/up人生进阶指南项目提供了一种新思路将个人学习如英语、AI 应用转化为可自动化构建、校验的 Markdown 知识库。这种模式不仅适合个人成长更是技术从业者构建作品集的优秀实践。本文将借鉴该项目的核心理念带你从零搭建一个基于 Git、Node.js 与当前主流大模型 API 的个人知识库系统。① 前置准备环境、账号、依赖目标读者为在校学生与转行者。我们将搭建一个本地可运行的知识库校验脚手架它能自动检查你的学习笔记格式并调用大模型对笔记内容进行复盘。明确前置知识了解基础 Git 命令与 Node.js 语法。完成本教程后你将掌握「Markdown 自动化校验」与「AI 辅助内容生成」能力这可以直接写进简历作品集中体现你对工程化思维的理解。环境与依赖要求Node.js: v20.11.0 LTS 或以上包管理器: pnpm v9.xGit: v2.40大模型 API Key以当前主流大模型如 DeepSeek 4.0 Pro 或 GLM 5.1为例需提前申请好 API Key。初始化项目mkdirknowledge-upcdknowledge-upgitinitpnpminitpnpmaddactions/core1.10.1 gray-matter4.0.3 zod3.22.4pnpmadd-Dtypescript5.3.3 tsx4.7.0 types/node20.11.5创建src目录与.env文件mkdirsrctouch.envechoLLM_API_KEYyour_api_key_here.envechonode_modules/.gitignoreecho.env.gitignore② 步骤 1定义知识库的 Markdown 结构规范目标建立标准化的学习笔记格式让机器可读。参考行业实践技术文档通常需要 Frontmatter元数据来管理。操作在项目根目录创建docs/english-vocab.md写入以下内容--- title: 英语核心词汇进阶 date: 2024-05-20 tags: [english, vocabulary] status: reviewed --- ## 本周词汇 1. **Resilience** (n.) 恢复力弹性 2. **Paradigm** (n.) 范例范式 ## 学习复盘 今天学习了系统论中的两个高频词需要在听力中加强练习。预期输出文件创建成功目录结构为docs/english-vocab.md。失败时怎么查确保 Frontmatter两个---之间的内容格式为合法的 YAML缩进必须使用空格不能使用 Tab。② 步骤 2编写自动化校验脚本目标使用 TypeScript 编写脚本校验docs目录下所有 Markdown 文件的格式是否合规。操作创建src/validate.ts输入以下完整代码importfsfromfs;importpathfrompath;importmatterfromgray-matter;import{z}fromzod;constFrontmatterSchemaz.object({title:z.string(),date:z.string(),tags:z.array(z.string()),status:z.enum([draft,reviewed,published]),});functionvalidateDocs(dir:string){constfilesfs.readdirSync(dir);lethasErrorfalse;files.forEach(file{if(!file.endsWith(.md))return;constfilePathpath.join(dir,file);constrawfs.readFileSync(filePath,utf-8);constparsedmatter(raw);constresultFrontmatterSchema.safeParse(parsed.data);if(!result.success){console.error([X] 校验失败:${file});console.error(result.error.errors);hasErrortrue;}else{console.log([✓] 校验通过:${file});}});if(hasError)process.exit(1);}validateDocs(path.join(__dirname,../docs));运行命令与预期输出pnpmtsx src/validate.ts# 预期输出:# [✓] 校验通过: english-vocab.md失败时怎么查如果报Cannot find module gray-matter检查是否在项目根目录执行了pnpm install如果报 Zod 校验错误检查 Markdown 文件的 YAML 头部是否缺少了必填字段。② 步骤 3接入大模型实现 AI 辅助复盘目标读取笔记正文内容调用大模型 API 生成扩展学习建议如造句、词根词缀分析。这是目前 AI 辅助学习的主流落地方式。操作创建src/ai-review.ts输入以下完整代码importfsfromfs;importpathfrompath;importmatterfromgray-matter;asyncfunctiongetAIReview(content:string){constapiKeyprocess.env.LLM_API_KEY;if(!apiKey)thrownewError(请在 .env 中配置 LLM_API_KEY);// 以当前主流大模型 API 格式为例 (兼容 OpenAI 格式)constresponseawaitfetch(https://api.deepseek.com/v1/chat/completions,{method:POST,headers:{Content-Type:application/json,Authorization:Bearer${apiKey}},body:JSON.stringify({model:deepseek-chat,// 替换为你实际使用的模型版本messages:[{role:system,content:你是一个严格的语言教练请根据用户提供的笔记内容生成3个相关的进阶例句并指出常见搭配错误。},{role:user,content:content}],temperature:0.7})});if(!response.ok)thrownewError(API 请求失败:${response.statusText});constdataawaitresponse.json();returndata.choices[0].message.content;}asyncfunctionmain(){constdocPathpath.join(__dirname,../docs/english-vocab.md);constrawfs.readFileSync(docPath,utf-8);constparsedmatter(raw);console.log(正在请求 AI 复盘...);constreviewawaitgetAIReview(parsed.content);console.log(\n--- AI 生成的复盘建议 ---\n);console.log(review);}main().catch(console.error);运行命令与预期输出pnpmtsx src/ai-review.ts# 预期输出:# 正在请求 AI 复盘...## --- AI 生成的复盘建议 ---## 1. The resilience of the economy surprised many analysts.# ...失败时怎么查若返回 401说明 API Key 无效若返回超时检查网络代理设置。在面试或作业中常被追问的点为什么要把 API Key 放在.env而不是代码里因为硬编码密钥会导致严重的安全漏洞一旦提交到 Git 历史中极易被恶意爬取。③ 完整示例GitHub Actions 持续集成将上述步骤串联起来。当你在 GitHub 上更新笔记时自动执行校验和 AI 复盘。在项目根目录创建.github/workflows/check-knowledge.ymlname:Knowledge Base Checkon:push:paths:-docs/**-src/**jobs:validate-and-review:runs-on:ubuntu-lateststeps:-uses:actions/checkoutv4-name:Setup Node.jsuses:actions/setup-nodev4with:node-version:20.11.0-name:Install pnpmrun:npm install-g pnpm9.0.0-name:Install dependenciesrun:pnpm install-name:Run Validationrun:pnpm tsx src/validate.ts-name:Run AI Reviewenv:LLM_API_KEY:${{secrets.LLM_API_KEY}}run:pnpm tsx src/ai-review.ts操作说明将代码推送到 GitHub 仓库在仓库的Settings - Secrets and variables - Actions中添加名为LLM_API_KEY的 Secret。每次提交 Markdown 修改Actions 将自动运行。④ 常见问题 (FAQ)Q1:pnpm tsx命令报错 “command not found” 怎么办A: 检查package.json中是否将tsx安装为开发依赖 (devDependencies)。如果没有执行pnpm add -D tsx。不要全局安装以保证项目环境的一致性。Q2: Zod 校验报 “Expected array, received string” 是什么原因A: 在 Markdown 的 YAML 头部数组格式必须使用中括号[a, b]或每行一个- item的形式。如果写成tags: english会被识别为字符串。Q3: 大模型 API 调用经常超时断开如何处理A: 可以在fetch请求中增加signal参数设置超时时间如 30 秒或在 GitHub Actions 中使用retry步骤策略。网络波动在调用海外接口时常见建议国内开发者优先选择延迟更低的 API 端点。最佳实践收束原子化提交每次 Git Commit 只包含一个知识点的修改或一篇笔记的更新便于回溯和 AI 上下文分析。密钥严格隔离本地使用.envCI/CD 使用平台 Secrets永远不要在代码中出现明文密钥。Schema 驱动开发先定义 Markdown 的 Zod Schema再写文档确保非结构化数据也具备工程级的约束力。大模型结果需二次校验AI 生成的扩展内容必须经过人工 Review 后才能合并到主干分支避免幻觉错误知识污染知识库。定期清理冗余依赖使用pnpm prune或depcheck定期清理未使用的包保持脚手架轻量。