手帐 Blog

主题

01 · AI 应用工程路线图与本系列约定 ​

目标：锁定本系列定位（TS/Node 应用工程）、四阶段顺序、与「AI 辅助自学」的边界，并挂上后续篇目。

1. 本系列要解决什么 ​

「会用 ChatGPT」≠「会做 AI 功能」。本系列补的是可交付链路：

  1. Prompt / 结构化输出：让模型稳定吐你要的形状
  2. API 与工具调用：把模型接到真实代码与外部能力
  3. RAG：用你的文档/笔记回答，而不是只靠参数记忆
  4. 评测、安全、可观测：能回归、防注入、看得见成本与错误
  5. 小项目收束：迷你笔记问答一类 demo，能跑能讲

默认语言：TypeScript / Node（对齐你现有栈）；不强制某一家闭源模型，接口以 OpenAI 兼容 为主。

2. 与「AI 辅助自学」怎么分 ​

文档回答的问题
AI 辅助自学怎么用才不废怎么用 AI 学技术（官方优先、验收闭环）
本系列怎么做 AI 产品能力（Prompt / RAG / 评测 / 安全）

学 Go / 算法时仍按自学文用 AI；做「笔记问答」功能时走本目录。

3. 四阶段（已定） ​

text
阶段一  心智与成本（01～03）
阶段二  应用骨架（04～07）
阶段三  工程化与安全（08～10）
阶段四  小项目收束（11～12）

明确不做 ​

  • 模型训练、微调、从零造模型
  • Python 科研 / 论文复现主线
  • 把「让 AI 代写整站」当成系列目标

4. 后续文章规划 ​

#标题状态
01AI 应用工程路线图与本系列约定（本文）已写
02Prompt 与结构化输出待写
03Token、上下文窗口与成本直觉待写
04OpenAI 兼容 API 与 TypeScript SDK待写
05工具调用 / Function calling待写
06RAG 入门：切分、嵌入、检索待写
07评测与回归：golden set待写
08流式输出与前端对接待写
09安全：提示注入、权限与数据出域待写
10可观测：日志、追踪与成本待写
11迷你笔记问答小项目（Journal 场景举例）待写
12系列复盘与面试能讲清单待写

索引与读法：→ README · 导学。

5. 官方 / 厂商入口（一级） ​

主题入口
OpenAI API（兼容生态的常见基准）platform.openai.com/docs
结构化输出 / Function calling同上文档对应章节（学到哪篇打开哪篇）
你选用的兼容网关 / 国内厂商以该厂商官方 API 文档为准

二级资料（博客合集、营销向「Agent 框架对比」）永远低于官方接口说明与你本机跑通的验收。AI 起草代码后必须对照官方字段复现。

6. 与 blog 其他文的边界 ​

  • 算法 / Go / 前端主线配额不变；本线周里程碑。
  • Journal 方案在 docs/spec/：篇 11 只用笔记问答举例，不改产品文档。
  • 练习代码默认文内或本机小仓；不强制塞进 Journal 客户端。

验收清单 ​

  • [ ] 能用一句话说清：本系列 vs「AI 辅助自学」的分工
  • [ ] 能指出「不做」清单里至少两项
  • [ ] 知道四阶段顺序，且 02～12 目前均为待写
  • [ ] 知道默认栈是 TypeScript/Node + OpenAI 兼容 API

下一篇 ​

→ 02 · Prompt 与结构化输出（待写）