AI 智能体与知识库搭建
数字微专业核心实训体系。零编程基础,不写一行代码,在自然语言指挥的时代,成为真正的 AI 驾驭者。
认知破冰与选型地图
区分陪聊工具与实干助手,掌握反向访谈法;建立 2026 主流 Agent 三大形态全景地图与常驻助理安全雷达。
用一句话把平时用的聊天机器人和今天讲的智能体区分开;破除死记硬背提示词的误区;看清桌面端、IDE端、CLI终端三大形态的适用场景,为自己挑选最合适的工具。
解构本质与分轨实操
扒开外壳看清 Agent = LLM + Harness 本质,掌握四步通用法,按自己的专业场景任选一条实操轨道深度跟练。
拆解 Harness 七大核心零件(提示词、规则文件、工具、MCP、Skills、Hooks、循环引擎);理解 Token 与桌面限制;实操桌面档案整理、IDE 氛围编程或 CLI 极简终端并收获实物交付。
网关换脑与知识库
看懂 API 必抓四要素与报错排查,用 CC Switch 换上高性价比国产大脑;搞懂 RAG 原理并搭建专属 LLM Wiki。
学会读懂任何 API 文档;用本地网关给顶级智能体外壳换上国内几毛钱就能用很久的 DeepSeek 大脑;掌握 RAG 开卷考试流水线,用 Karpathy 编译思想搭建个人终身进化的数字外脑。
实训知识体系与阶段核心产出
| 模块板块 | 核心学习内容 | 阶段核心交付物 |
|---|---|---|
| 第一部分 · 认知破冰 | 从陪聊到数字实习生,长嘴 vs 长手脚,反向访谈法 | 掌握反向访谈法,产出首份项目清单 |
| 第二部分 · 选型全景 | 2026 三大外壳形态、国内外差异、常驻助理安全雷达 | 完成 30 秒自测,选定个人实操轨道 |
| 第三部分 · 扒开本质 | Agent = LLM + Harness,七大零件,Token 与上下文限制 | 搞懂运行支架,理解行业三大开放标准 |
| 第四部分 · 分轨实操 | 四步通用法,三大轨道(桌面 / IDE / CLI 终端)跟练 | 获得真实整理文件 / 单页 / 分叉对话 |
| 第五部分 · API 与网关 | 读懂四要素,报错排查,CC Switch / Magpie 本地换脑 | 成功接入国产大脑,掌握成本与防盗刷 |
| 第六部分 · 专属知识库 | RAG 开卷考试四步,Karpathy LLM Wiki 编译工作流 | 建立 Obsidian 三层目录,掌握馆长提示词 |
| 总结与交流 | 终章三句心法,现场高频疑虑解答,开放互动 | 带走底层思维框架,开启持续进化 |
告别死记硬背。重塑你的 AI 认知与学习心法
不背提示词模板、不迷信跑分。从理解能力边界、放下技术焦虑到建立人机耐心的实战心路。
传统低效学习误区
很多网课教你像背公式一样背上千条提示词,但随着模型推理能力(Reasoning)的进化,机械的套话早已失去意义。大模型真正需要的是清晰的场景上下文、明确的约束边界和真实的业务目标,而不是假大空的修辞模板。
开汽车不需要先成为发动机制造工程师。作为智能体的主理人,你的使命是用自然语言精准调动它的手脚解决实际问题,而不是去推导反向传播算法的数学公式。
现代高效学习正道
角色认知彻底转变:从死记硬背的“应试考生”,变成从容调度资源的“项目总监”。先摸清工具的能力边界,再用小步快跑的敏捷思维与智能体共同迭代。
核心法则:先让 AI 吞下重复脏活,再与 AI 拆解复杂任务,以 MVP 最小可用为纲。
理解能力边界,跑通最小 MVP
不同模型各有所长,不盲目迷信跑分。先让 AI 代劳简单重复脏活;遇复杂任务与 AI 一同拆解步骤,优先跑通最小可用原型 (MVP),再迭代打磨。
有的模型长于复杂的逻辑推理与代码编写,有的模型长于多语言文案润色与长文本检索。了解你手中不同模型的优势与盲区,因材施艺,才能让每一次任务指派都事半功倍。
做网站不要一上来就让它做全套电商系统;做报告不要一上来让它写 3 万字白皮书。先让它在一个单文件里输出一个最简粗胚(哪怕只有一个核心功能),亲眼验证闭环成立后,再一层层追加样式、增加交互、补充数据。这样绝不会迷失在庞大的报错泥潭中。
拒绝信息裹挟,卸下 AI 焦虑
每天都有新模型发布,不必跟风恐慌。工具的本质都是执行器;决定上限的是你的业务判断力与品味。AI 是不知疲倦的实习生,做它无可替代的主理人。
很多人天天刷科技新闻,今天担心这个岗位被取代,明天害怕自己跟不上节奏。请认清一个客观事实:大模型解决的是「实现成本」的问题,而不是「解决什么问题」的问题。
是对具体业务场景痛点的敏锐洞察,是对人情冷暖与用户体验的体悟,是对最终交付质量的严苛品味。AI 跑得越快,拥有清晰业务逻辑和判断力的人就越值钱。放下焦虑,把精力聚焦在你想创造的具体价值上。
保持耐心包容,建立人机磨合期
AI 不是能读懂心事的算命先生,首轮生成不完美是必然常态。像培养新入职的高潜员工一样,用清晰上下文和连续追问校准偏差,磨合会化为长期复利。
很多同学输入一句话,发现 AI 生成得不尽如人意,就立刻得出“AI 没用、不可靠”的负面结论。试想一下:即便是人类顶尖实习生,你一句话吩咐下去,他也必须与你沟通几轮才能完全摸透你的真实标准。
第一轮:让 AI 输出粗框架与设计思考,帮我们梳理盲区;第二轮:指出具体偏差,补充边界与反面案例;第三轮:定型并交付。多给 AI 一点具体的上下文,你的每一次耐心微调,都是在建立专属你的高默契工作流。
聊天机器人负责陪聊,智能体负责替你干活
网页版豆包只长了嘴;智能体长了手和脚。给它一个最终目标,它自己拆步骤把苦力彻底干完。
Chatbot 聊天机器人 · 只长了嘴的参谋
你问一句它答一句。给它发一段大纲让它写策划案,它在屏幕上吐出一大段漂亮文字。但写完之后,新建文档、复制粘贴、排版配图、核对表格 4 步繁杂苦力全归你。
特点:没有手脚、不能碰你的硬盘、无法直接帮你交付任何实物。
聊天机器人运行在网页沙盒中,它只有文本输入框和文本输出框。它既读不到你桌面上乱成一团的几十份 Excel,也没法替你在电脑里新建一个文件夹并把整理好的文件存进去。文字写得再天花乱坠,真正干脏活累活的还是你自己。
Agent 智能体 · 长了手脚的数字实习生
你给它一个最终目标:“把这个文件夹里的 20 份发票汇总成 Excel 并分类归档”。它自己建文件夹、逐一读内容、提取数字、公式核对,报错自己修,直到交付最终成果。
关键区别:具备「工具调用能力」与「自我验证报错自愈闭环」。
普通聊天中,如果代码写错或文件路径不存在,对话直接卡死;智能体拥有循环引擎(Agent Loop):它执行命令时如果看到系统终端报错,它会自己读取错误信息:“哦,原文件编码是 GBK”,于是自动改写参数重新执行,完全不需要你一次次手工当传话筒。
反向访谈法:为什么写 1000 字提示词往往换来一堆废话?
很多人开局硬憋一千字提示词,结果像开盲盒。Google 今年发布的 Antigravity 2.0 内置了 /grill-me 指令(反转控制权):更省力的做法不是你费劲写长篇大论,而是让 AI 反过来连续采访你 4 轮! 逼它追问你的受众、亮点与边界,AI 瞬间从盲目瞎猜变成步步引导的专业顾问。
三类外壳,按场景选型
按“外壳长什么样、怎么跟人打交道”分为三大主流形态。看清长相与生态差异,按场景挑工具。
1. 桌面 Agent
独立桌面应用,看不到代码。选定工作文件夹,用大白话派活出报告与 PPT。
文商科日常首选:不碰代码与终端,装上就能整理文件出报告。
像微信、飞书一样的独立桌面软件,你看不到代码。你只需要用大白话派活,指定一个工作文件夹,它就会在里面自己建文档、写表格、生成网页或 PPT 交付给你。
文商科、日常白领、非技术同学首选:不用管 Python 环境和终端命令行,装上软件选定文件夹就能干活。避坑:千万不要直接把全盘 C 盘或桌面丢给它,必须给它圈定一个专属的小练习文件夹。
2. IDE 智能工作台
左看文件树、中看实时预览与 Diff 红绿改动、右聊 AI。每个改动透明可控。
作品集首选:做网页、小游戏、数据看板,改动看得见最踏实。
原本是给专业程序员写代码用的编辑器,但在 2026 年演进成了“带 AI 秘书的可视化文件夹总管”。最核心的价值是提供实时浏览器预览窗口和改动对比视图(Diff),红底代表删减、绿底代表新增,绝不在背后偷偷瞎改。
3. CLI 终端智能体
住在终端黑框框里,体积极小、响应极快、权限极直接。能自由换上国产大脑。
批量与极客首选:学会几个斜杠指令,批量处理上千文件最快。
没有几百兆的重型前端界面,纯靠终端字符运行。启动只需毫秒级,不仅占用内存不到图形软件的十分之一,更重要的是它只给大模型配备最克制的四个原生工具(read, write, edit, bash),能把宝贵的上下文窗口全部留给真正的问题处理。
国内外通用 Agent 怎么选?看清两个现实差异
国内工具(豆包工作、WorkBuddy、TRAE)手机号直接登录,中文界面开箱即用。海外工具(Cursor、Claude Code)需要稳定网络环境与外币信用卡支付月费。
国内工具深度整合飞书、企业微信、钉钉,文件能直接发到工作群;海外工具默认接入 GitHub、Google Drive、Slack。按你的日常主力软件选型。
核心心法:因为 Agent = 大脑 (LLM) + 身体 (Harness) 可以解耦,我们完全可以用 Pi 或 Claude Code 的身体,接上国内几块钱用很久的 DeepSeek 大脑!
| 你的真实情况与需求 | 首选形态 | 国内免翻网络推荐 | 海外产品参考 |
|---|---|---|---|
| 主要处理 Word/Excel/PPT,不想碰任何代码 | 桌面 Agent | 豆包工作、WorkBuddy | Antigravity 2.0 |
| 要做网页作品集、小游戏、数据图表,想看可视化预览 | IDE 智能工作台 | 字节 TRAE IDE | Cursor、AWS Kiro |
| 批量重命名/统计成百上千文件,想自由换 DeepSeek 等高性价比大脑 | CLI 终端智能体 | Pi CLI + 本地网关换脑 | Claude Code |
越主动的智能体,越要想清楚它能碰什么
个人常驻智能体具备心跳,会主动在微信、飞书里找你。权限交得越大,恶意技能与泄露风险越致命。
ClawHub 技能市场恶意脚本比例
Koi Security 扫描 OpenClaw 技能市场的 2,857 个技能,查出 341 个恶意木马,约每 8 个就有 1 个有毒。装上就会在后台偷取你的密码与 API 密钥。
公网另有 2 万多个配置不当的裸奔实例,正在泄露密钥与聊天记录。
保护主力电脑的三道防火墙
拒绝非官方渠道的第三方脚本,防止后台键盘监听与文件泄密。
仅限本机局域网或 VPN 访问,禁止无密码配置端口映射。
严禁装在存有毕业设计、求职简历、银行密码的主力个人电脑上。
Agent 等于大模型大脑加驾驭层
Harness 原意是马具。千里马再能跑,没有缰绳与马鞍人也骑不了。大模型只负责思考,Harness 赋予身体与工位。
LLM 负责理解与规划,Harness 提供工具手脚、规则手册、长期记忆、权限门禁与执行闭环。
SWE-bench 编程基准测试
同一个大模型,套上不同的 Harness 外壳,任务解决率直接拉开一倍差距:
普通人的最大机会
大模型训练是万亿巨头的资本角逐,普通人插不上手;但 Harness 每个人都能亲手配置。
写好一份规则、配置几个高效工具、接上私有知识库,你就能用低成本模型打造出远超同行的强悍智能体。
Harness 到底是哪七样东西?
无论换到哪款智能体软件,里面的零件全部都是这七样。点击任意卡片,查看内部原理与实战模板。
系统提示词
出厂岗位守则,预设基础性格与工具清单。
这是软件出厂时就写死在最底层的“员工入职培训手册”。它不需要你每次手动复制粘贴,而是在你每次提问时,由 Harness 自动拼装在最前面。它通常包含:今天是几月几号、你的电脑是 Mac 还是 Windows、当前命令行是什么、当前装了哪些工具。
规则文件 AGENTS.md
贴在工位上的家规,写明背景与红线,教一次记一辈子。
放在项目文件夹根目录的一个纯文本 Markdown 文件。任何符合现代标准的 Agent 进驻你的文件夹时,第一件事就是静默读取它。你可以在里面写明:你的身份背景、代码缩进风格、绝对不能删核心文件等红线。只要写一次,以后开新会话永远不用再教。
基础工具 Tools
模型的手脚:read、write、edit 与终端 bash 命令。
大模型本身只负责计算概率,Harness 赋予了它 4 个最基础的原生工具:
学术实测表明,给 Agent 塞入上百个花里胡哨的工具,会极大地污染模型的决策树导致死循环。克制地保持 4 个原子工具,配合强大的大模型推理,解决率反而最高。
模型上下文协议 MCP
AI 工具界的 Type-C 插座,外部系统一次开发全平台通用。
过去每个 AI 平台都要单独写一遍对接飞书、GitHub、数据库的插件代码。Anthropic 发起并开源的 MCP 协议统一了接口规范:任何公司只需编写一个 MCP Server,就能同时插在 Cursor、Claude Code、Antigravity、Pi 等任何智能体上直接使用。
技能包 Skills
书架上的专项 SOP,平时只读标题,点名要用才翻开。
如果把上百个专业领域的操作规范(比如网页设计、合同法务审查、视频剪辑)全部塞进系统提示词,Token 桌面瞬间被占满。Skills 的机制是:在系统常驻区只放一句话的技能名称和描述,大模型只有在判断用户当前任务确实命中该技能时,才会动态读取内部的 SKILL.md 详细指导手册。
自动化钩子 Hooks
烟雾报警器,改动自动触发备份,强制执行铁律。
无论在提示词里怎样强调“写完代码记得运行测试”,大模型有时候还是会偷懒遗忘。Hooks 是一种确定性的代码逻辑:在文件修改前、命令执行后等关键时机强制触发。例如修改代码后自动触发 Git 本地提交备份,或者发现删库危险命令时硬性拦截。
循环引擎 Loop 与门禁
搜集上下文 → 采取行动 → 自我验证。干完自己检查修 Bug,配合高风险操作的人工确认弹窗。
普通聊天是一问一答;Agent 的引擎是一个持续自旋的 while 循环:思考下一步做什么 → 挑选并执行一个工具 → 观察工具返回的报错或结果 → 如果出错自己修正再次重试,直到最终完成任务。
遇到不可逆危险操作(如删除核心文件、往公网发送私密数据、支付调用)时,循环引擎会硬性挂起,向用户弹窗请求授权:“我正准备执行该危险指令,是否批准?”
三大行业开放标准
AGENTS.md、MCP、Agent Skills 均交由 Linux 基金会旗下统一维护,学会一套技能,跨工具随身带走。
2026 年是智能体协议统一之年。Linux 基金会主导收编了全行业三大协议,你在一个工具里调教好的配置,可以无缝迁移到另一个工具:
桌面一旦堆满,AI 就会开始胡言乱语
Token 是字数计费单位,上下文窗口是工作桌面。每一轮对话,都要把整张桌子上的文件重新算一遍钱。
上下文窗口工作桌面
你给它看的每份文件、说的每句话都平摊在桌面上。桌面超限后,模型会产生严重遗忘并剧烈消耗额度。
•
/compact [要求]:把前面几十轮对话压缩成一张便签,腾出 80% 桌面空间•
/new:把桌面彻底清空,开启全新话题
算力计费与分身机制
Subagents 分身术:读 30 篇论文时,派 3 个分身各自在小房间读 10 篇,只交回 500 字结论,避免挤爆主桌面。
学会一套规则,跨所有工具随身带走
智能体协议统一之年。Linux 基金会统一维护三大标准,界面再怎么变,你的资产永不失效。
| 行业开放标准 | 它负责管什么 | 托管机构与生效现状 | 支持的核心工具生态 |
|---|---|---|---|
| AGENTS.md | 项目通用规则与工位家规 | 2025 年 12 月由 Linux 基金会旗下 Agentic AI Foundation 统一托管 | Codex、Cursor、Pi 等直接默认读取;Claude Code 兼容支持 |
| MCP 协议 | 连接外部工具与系统的统一接口 | 同期交由 Linux 基金会托管,2026 年 7 月 28 日发布全新版本规范 | 全行业公认标准,已支持 GitHub、飞书、PostgreSQL、Brave 等上千系统 |
| Agent Skills | 复合业务 SOP 技能包 (SKILL.md) | 2026 年 10 月 22 日交由 Agentic AI Foundation 统一维护 | 全行业 40+ 款主流 Agent 工具开箱原生支持 |
家规随身带
你在 AGENTS.md 里写好的语言习惯、红线约束,无论换到哪个符合标准的 Agent,放进文件夹即可自动生效。
过去在不同软件之间切换,必须把预设提示词挨个重新复制配置一遍。现在只要在项目根目录维护一个标准的 AGENTS.md 文件,任何智能体驻留该目录都会自动解析并严格遵守。
插件一次开发
基于 MCP 编写的外部连接器,可以在 Claude Code、Cursor、Pi 之间自由插拔,再也不用为每个软件重复写插件。
无论是数据库厂商、协同办公软件还是云计算平台,只需要官方发布一个 MCP Server,就能瞬间接入全球所有符合 MCP 标准的智能体应用,极大加速了自动化工具链的成熟。
技能模块化积木
你沉淀下来的专业报告撰写、网页设计审美品味等 SOP 技能包,换一个新工具依然能直接点名调用。
不要把时间浪费在学习某个特定闭源工具的独门秘籍上。沉淀基于 SKILL.md 标准的领域专业规范,这才是能陪伴你跨越工具周期的长期个人生产力资产。
四步通用法与桌面实操
圈工位、立家规、控边界、验成果。不管是什么形态的 Agent,永远遵循这标准四步。
四步通用法则
1. 圈工位:新建文件夹,圈定活动范围,不准乱跑
2. 立家规:放好 AGENTS.md 规则文件,写明底线要求
3. 控边界:要求两阶段执行,先出方案确认后再动手
4. 验成果:打开成果检查,不满意一句话让它微调
无论是使用豆包工作、WorkBuddy、TRAE 还是 Claude Code,把任务交给智能体的底层逻辑永远不会变:明确空间边界(工位)→ 注入规范约束(家规)→ 设置两阶段确认(控边界)→ 验收与微调(验成果)。只要掌握这四步,未来出现任何新软件,你都是从容的指挥官。
轨道 A · 豆包工作 / WorkBuddy
专治混乱资料夹。两阶段执行:先读取真实文件内容生成归档预览表,确认后再执行文件移动,并自动产出可视化 HTML 看板。
第一阶段:只读扫描,输出 Markdown 计划表;第二阶段:等你回复“确认执行”后再行动。绝对不允许智能体直接物理移动或覆盖你的源文件!
轨道 B · 氛围编程与 Diff 审查
告别黑盒瞎改。在 IDE 里做“AI 监工”:左看文件树、中看实时网页预览与红绿差异标记、右边聊天指挥。
两代 AI 编码工具的本质跃迁
上一代 Copilot 只是“打字机联想词”;2026 年现代 IDE Agent 是“项目总工”,能跨数十个文件自主阅读、构思、调试并自我修复。
特斯拉前 AI 总监 Karpathy 提出的概念:人类负责把握整体审美氛围(Vibe)、需求愿景与业务规则,不需要去纠结每一行具体的 JavaScript 或 CSS 语法,把繁重的语法实现全部交给 IDE Agent。但请牢记:氛围编程不等于闭着眼睛瞎按,你必须做好 Diff 审查者。
Diff 审查机制:红删绿增
看懂 Diff 是你唯一的必修课。红色背景代表 Agent 删除了哪几行,绿色背景代表新增了什么。满意再点 Accept,绝不在黑盒里听天由命。
很多初学者害怕使用 AI 生成代码,是因为“不知道它在背后偷偷改了什么”。现代 IDE 强制在中心区域渲染 Diff 对比视图:红色高亮是原版中被移除的行,绿色高亮是即将插入的新代码。你只需要看懂绿色的内容是否符合你的需求,再点击 Accept 或 Reject,完全掌控项目主权。
轨道 C · 极简终端与对话分叉树
开源标杆 Pi:只有 4 个基础工具,却能任意连接国内外各大模型,并在对话树里自由分叉穿越。
极简四工具:为什么克制反而更强大?
没有几百兆的重型前端界面,纯靠终端字符运行。Pi 仅给大模型提供 read、write、edit、bash 四个工具,把全部上下文窗口留给真正的问题处理。
对话分叉树:时间线平行穿梭
普通聊天是一条路走到黑,第 5 步聊偏了整段垮掉;Pi 把对话存成一棵树,输入 /tree 纵览分支,输入 /fork 随时回到过去开启平行探索。
讲者避坑提醒:对话可以回到过去,但已经写在硬盘上的文件不会自动消失!
做设计、写文章、调研方案时,经常需要尝试完全不同的方向。分叉树让你无需开几十个互不相干的新窗口,直接在历史节点上拉出一条平行时间线,两边对比哪个效果好就保留哪个。
换个工具,只是换了个按钮
三条轨道界面各不相同,底层做的事一模一样。查阅这张速查表,跨工具无缝平替。
| 想要达成的操作 | 开源标杆 Pi | Claude Code | Codex CLI | 桌面 / IDE 对应形式 |
|---|---|---|---|---|
| 生成规则家规 | 新建 AGENTS.md |
/init (生成 CLAUDE.md) |
/init (生成 AGENTS.md) |
项目根目录放家规文件 |
| 更换思考大脑 | /model 或 Ctrl+L |
/model |
/model |
设置面板下拉菜单 |
| 压缩上下文桌面 | /compact [要求] |
/compact [要求] |
/compact |
自动浓缩历史 / 归档按钮 |
| 开启全新对话 | /new |
/clear |
/new |
点击「新建会话」图标 |
| 回到过去 / 开分支 | /tree、/fork |
/rewind、/branch |
/fork |
历史记录版本树 |
| 设置权限与边界 | 启动时 --tools 限制 |
Shift+Tab / /permissions |
/permissions |
权限弹窗勾选 |
| 先出计划再动手 | 在提示词里明确要求 | /plan |
/plan |
两阶段执行开关 |
| 管理 MCP 与技能 | 扩展、.pi/skills |
/mcp、/skills |
/mcp、/skills |
插件市场与技能标签页 |
四步通用法则的终极闭环
回顾实操阶段:桌面端的豆包工作/WorkBuddy、IDE 端的 TRAE、终端里的 Pi,界面各不相同,核心永远是这四步:圈工位 → 立家规 → 看计划、控边界 → 验成果、促迭代。学会其中一条,未来遇到任何新出的 Agent,照这四步走、对照这张表找按钮即可通杀!
网页版是“堂食”,API 是“外卖窗口”
同一个模型,进门方式不同。学会只抓四样东西看懂任何文档,遇到报错对号入座秒级排查。
网页版 · 餐厅堂食
你坐在店里,桌椅菜单都是餐厅定好的。只能手动复制粘贴,收费方式通常是固定月费(如每月 $20)或每天限制次数。Agent 无法直接进入堂食餐厅。
网页版是为人眼阅读设计的,它被封装在浏览器封闭的沙盒中。你的本地终端 Pi、专业 IDE TRAE 或桌面助理,无法直接登录你的网页版账号去批量修改你硬盘上的几百个本地文件。必须通过标准的数据通道——API,才能赋予智能体真正的行动力。
API · 外卖取餐窗口
窗口不关心你是谁,只认三样东西:走到哪个窗口 (Base URL)、递出哪张会员卡 (API Key)、报哪道菜名 (Model ID)。Pi 和 Claude Code 就是替你站在窗口前取餐的人,按 Token 实际用量结算。
API 是每家服务自己开的外卖窗口,规矩各不相同;而 MCP 是统一的取餐方式。智能体学会了 MCP 这套标准动作,就能用同一种规范去所有接了 MCP 的窗口取餐。今天我们精读的,就是各大模型厂商官方开辟的直接外卖窗口。
看懂任何 API 文档:只找这四个填空项
| 必找四要素 | 文档常见写法 | 外卖窗口比喻 | 操作指南与避坑 |
|---|---|---|---|
| 1. 接口地址 | Base URL / Endpoint |
窗口的物理地址 | 找到以 https://... 开头的网址原样复制,末尾有没有 /v1 切勿擅自修改 |
| 2. 身份密钥 | API Key / Auth Token |
无密码会员卡 | 后台生成通常以 sk- 开头。谁拿谁刷,绝对保密,严禁发群或推上公网 |
| 3. 模型代号 | Model / Model ID |
精确菜名 | 必须去官方文档模型列表复制当前有效代号,一个字符都不能错 |
| 4. 接口协议 | OpenAI 格式 / Anthropic 格式 | 点菜方言 | 你的 Agent 说哪种方言,就填对应的方言地址。方言对不上会直接报格式错误 |
报错排查宝典:四类症状对号入座
课堂 30 秒实操:找齐四要素,Key 记在心中切勿外传| 终端或软件弹出的报错现象 | 优先检查哪一项与解决方案 |
|---|---|
| 提示认证失败 (Unauthorized / 401)、没有权限 | 查密钥 API Key:是否复制完整、前后是否有多余空格、该 Key 是否已在后台被作废删除。 |
| 提示找不到该模型 (Model Not Found / 404) | 查模型代号 Model ID:检查大小写字母,确认是否照抄了网上已下线的旧教程废弃代号。 |
| 一直转圈无反应,或提示连接被拒绝 / 404 Not Found | 查接口地址与协议方言:检查结尾是否多写或少写了 /v1,地址与工具说的方言是否兼容。 |
| 提示额度不足 (Insufficient Balance / 402) | 查平台后台余额:这不是工具出 Bug,是账户钱包欠费了,按需充值几块钱即可恢复。 |
官方直连与聚合平台:两类靶子实战
现场精读官方直连(DeepSeek)与聚合超市(硅基流动 / OpenRouter),看懂三行环境变量与斜杠代号规律。
靶子一 · 官方直连 (DeepSeek)
官方同时开放两种方言。认准当前有效代号 deepseek-flash,拒绝网上过时旧教程。
第一行是地址,第二行是会员卡,第三行是菜名,末尾的 /anthropic 就是方言。Windows PowerShell 用 $env:ANTHROPIC_MODEL=...。
https://api.deepseek.com(末尾不带 /v1,用于 Pi、Codex 等)https://api.deepseek.com/anthropic(专用于 Claude Code 等)网上很多老旧文章还在教大家填 deepseek-chat 或 deepseek-reasoner,官方文档现已更新迭代。模型代号必须去官方开放平台实时复制,不要凭记忆盲猜。
靶子二 · 聚合平台 (模型超市)
充一次钱、拿一个 Key,同时调用几十家国内外模型(DeepSeek、Kimi、千问、智谱、Llama),免去去十家平台注册十个账号的繁琐。
硅基流动为
https://api.siliconflow.cn/v1,OpenRouter 为 https://openrouter.ai/api/v1。超市里货品多,为免重名必须带厂家前缀,去平台的模型广场直接点击复制最新代号。
接入说 Anthropic 方言的 Claude Code 时,填不带
/v1 的根域名。如果你想在同一个项目里对比不同厂商模型的效果,聚合平台是最高效的选择。国内推荐硅基流动(备案完备、国内直连极速),海外推荐 OpenRouter(汇集全球数百个开源与商用模型,支持免绑定信用卡的免费体验档位)。
记住这些环境变量:下一幕图形网关替你全自动修改
程序员以前需要手动把这些环境变量逐个敲进终端或层层嵌套的 settings.json 配置文件里,少敲一个标点符号整个 Agent 就崩溃。接下来我们用 CC Switch 与 Magpie 图形工具,鼠标点选即可一键完成换脑!
不用手改配置文件:CC Switch 与 Magpie
告别手写 JSON 文件的痛苦。用开源图形工具一键换脑,理解 127.0.0.1 本地网关与隐私脱敏机制。
| 对比维度 | CC Switch (ccswitch.io) | Magpie (usemagpie.ai) |
|---|---|---|
| 它是什么 | 跨平台独立桌面应用 (Win/Mac/Linux),官方说明支持 Pi、Claude Code、Codex、Hermes、OpenClaw 等 12+ 款 Agent。 | 开源桌面应用,有 Mac 菜单栏、Windows、Linux 版。核心是在电脑本地跑一个翻译网关,支持 Pi、Claude Code、Codex、WorkBuddy 等。 |
| 怎么换模型 | 选中某个工具,新建一张“供应商卡片”,填入四要素,保存并一键启用。 | 列表里展示每个 Agent 当前用哪个模型,点一下就切换。智能修改各自配置文件,换模型时不破坏其他原有配置。 |
| 特色功能 | 在一个地方统一管理 MCP 工具、Skills 技能包和系统提示词,一键同步给多个智能体。 | 本地网关在不同格式协议之间实时转译;自带隐私脱敏功能(离开电脑前自动替换敏感字符)。 |
本地网关原理 · 门口的翻译官
在电脑本地开一个极小的服务(如 127.0.0.1:3425)。Agent 以为自己在跟云端说话,其实请求先到了本机网关。网关自动把 OpenAI 格式转为 Anthropic 或 Gemini 格式再发给云端,回复返回后再转译回来。
计算机网络中,127.0.0.1 是本地回环地址(Localhost),指的就是你眼前的这台物理电脑。本地网关服务只监听你电脑内部的请求,不需要联网暴露出公网端口,因此速度极快且完全私密安全。
Magpie 隐私脱敏 · 默认关闭需手动开
开启后,提示词离开电脑前,密钥、密码、邮箱会自动被换成占位符;云端回复返回时再换回原内容。注意:该功能默认关闭,使用需手动勾选;极端机密文件依然遵循不传云端铁律。
Magpie 内部内置了敏感词规则库。如果脱敏组件无法正常运行,Magpie 会硬性拦截住该次网络请求,防止原文直接泄露出去。但它无法保证 100% 识别复杂变体,商业级核心机密数据绝不能上传到外部公有云大模型。
现场 3 步实操流程与主控防冲突铁律
在 CC Switch 选中 Claude Code 或 Pi,填入地址、Key 与代号 deepseek-flash 并启用。
新开终端启动 Agent,输入 /model(或按 Ctrl+L),查看当前模型已成功切换。
两个工具改的是同一批系统文件!选定一个当主控,切勿两个同时接管同一个 Agent 防止配置互踩。
算力成本与防盗刷:三条安全铁律
API 是按量计费真金白银。看清 DeepSeek 官方价格与高峰时段翻倍规则,建立终身受用的安全习惯。
API Key 当密码:$82,314 盗刷账单
2026 年 Google Cloud 用户报告其 Key 疑似泄露,48 小时内被黑客盗刷产生 82,314 美元(超 50 万元)天价账单。Key 是无密码的会员卡,谁拿到谁就能刷。
公网爬虫 24 小时全天候扫描 GitHub 公开仓库和网络博客。一旦你把带 sk-... 的配置文件推送上去,几秒内就会被脚本抓取,随后被挂到黑产接口池中并发调用高价旗舰模型,几小时内就能刷出几万美元巨款。
一旦怀疑 Key 泄露,不要等待!立即打开对应云平台后台,把该 Key 彻底点击 Delete 删除作废,再重新生成一个新 Key。
小额充值 · 不上公网 · 删换自救
第二条 · 先知价格再放心用 (DeepSeek 官方价格表)
官方定价文档 ↗| 官方当前型号 | 空闲时段 输入 (未命中缓存) | 空闲时段 输出 | 高峰时段 (工作日 9-12 / 14-18点) |
|---|---|---|---|
deepseek-flash (推荐日常) |
1.00 元 / 百万 Token | 4.00 元 / 百万 Token | 价格翻倍(输入 2 元 / 输出 8 元) |
deepseek-v4-pro (旗舰推理) |
4.50 元 / 百万 Token | 13.50 元 / 百万 Token | 价格翻倍(输入 9 元 / 输出 27 元) |
deepseek-flash 读 10 万汉字(约 6 万 Token),空闲时段仅需 0.06 元 (6分钱),写 10 万字仅需 0.24 元,量级就是“几毛钱”。注意新变动:自 2026 年 11 月 1 日 起,DeepSeek 联网搜索与网页抓取按每 1000 次成功请求 5 元计费(单次半分钱),长任务后记得查看后台账单。
第三条 · 想体验不想充值:OpenRouter 免费模型
OpenRouter 官网 ↗
在 OpenRouter 平台,模型代号以 :free 结尾的是官方免费模型。限制按调用频次计算:每分钟 20 次,每天 50 次(累计充值满 $10 后每天可达 1000 次),足够初学者零成本完成全套调试跟练!
从闭卷瞎编到开卷考试:RAG 检索流水线
大模型没读过你的私人资料。不要指望它硬背私有事实,在回答前把参考资料装进它的桌面。
闭卷考试 · 参数幻觉
大模型没读过你的私人资料、专业课件或内部文档。直接问它,它往往不会说“我不知道”,而是基于概率编一个听起来极像样的答案,这就是所谓的参数幻觉。
就像闭卷考试全靠脑子死记硬背,记不清的地方就容易凭感觉瞎写。
大模型本质上是一个巨大的“下一个词预测器”(Next-token predictor)。它的训练数据在特定时间点被截断,并且几百亿个神经元参数无法保证每一条历史细节都被 100% 精确固化。当你问一个超出它参数记忆范围的问题时,它的首要目标是生成一句“在语法和语义上最通顺”的回答,而不是查证事实。
开卷考试 · RAG 检索增强
RAG (Retrieval-Augmented Generation,检索增强生成):回答前先在本地资料库里翻书,把最相关的几段真实材料捞出来拼进提示词:“照着以下资料答,没提的说不知道”。
开卷翻书,照着答还要标明出自哪一页,回答带原文精准出处,彻底消灭瞎编。
与其花几百万元去微调大模型,不如建立一个外部检索外脑。当你提问时,系统先去检索 3 段真实权威文献,把它们以纯文本形式塞进 Prompt:“基于这三段材料,提炼答案”。此时大模型只发挥其强大的阅读理解和归纳推理能力,完全不用依赖飘忽不定的参数记忆。
图书馆借书比喻:工业级 RAG 四步标准流水线
| 检索阶段 | 工业术语 | 图书馆借书通俗比喻 | 核心技术细节与规范 |
|---|---|---|---|
| 第一步 | 切块 (Chunking) | 把 300 页厚书切成几百张小借书卡片 | 长文切为 300–500 Token 短片段,相邻卡片保留 10% 上下文重叠,防语义被硬截断。 |
| 第二步 | 向量化 (Embedding) | 给每张卡片打上空间索书号 | 文字送进向量模型转换为几千维浮点数数学坐标。含义相近的句子在几何空间中自然挨着。 |
| 第三步 | 检索重排 (Search & Rerank) | 提问时快速计算余弦相似度定位卡片 | 给提问也算一个坐标,在毫秒级内比对出空间距离最近的 3 到 5 张卡片作为事实证据。 |
| 第四步 | 组装生成 (Generation) | 把证据卡片和提问组装给模型作答 | 拼入系统指令:“请严格根据以下卡片资料回答,未提及请说不知道,并标注出处”。 |
三条路线搭建:Karpathy 的维基编译哲学
从开箱即用平台,到本地终身数字外脑。人类产生原生灵感,智能体通过 MCP 主动编译百科。
开箱即用 SaaS 平台
把 PDF、网页丢进去,每句话都带原文精准引用,支持一键生成双人对谈播客、导图与闪卡。
免费版可建 100 个笔记本,每个放 50 份资料。最大特色是强大的事实溯源能力,回答里的每个引用角标点击直接定位到原书那一页那一自然段。
Obsidian + Agent 维基编译
Andrej Karpathy 提出的 LLM Wiki 理念。拒绝做数字仓鼠,所有笔记以纯 Markdown 格式存本地,由 Agent 定期编译维护。
你只管记你的灵感日志,丢给 Agent,它像维基百科主编一样,提炼新概念、合并重复条目、建立双向链接,生成标准 Wiki 词条,你的外脑会终身自我进化。
团队与企业开源方案
给部门搭建规章制度问答机器人首选。支持多人协同、权限管控与可视化编排。
当面临公司法务合规、多用户并发访问、敏感数据私有化部署在内部内网机房时,选用 Dify 或 RAGFlow 等开源自建方案是企业落地的标准规范。
前置环境:配置 Obsidian MCP 让 Agent 真正接管外脑
在 Obsidian 社区插件市场安装 Local REST API,生成专属通信 Key 并保持软件开启。
在 CC Switch、Claude Code 或 Cursor 中添加 mcp-server-obsidian 工具,赋予 Agent 检索与写入手脚。
若不配 MCP,直接在 Obsidian 库本地文件夹启动 Agent,智能体通过基础文件读写同样完美落盘!
工具越少,威力越大。成为智能体的主理人
走出这间教室,带走这三句底层心法,开启属于你的第二大脑与数字分身进化之路。
先做执行者,再做指挥官
如果你自己都说不清楚解决一个问题的具体步骤与验证标准,给智能体再多算力它也只能替你制造更多混乱。
上下文是唯一的真金白银
珍惜有限的 Token 窗口。给智能体最干净的上下文桌面,让它在局部极小范围内一次性解决一个具体问题。
少即是多,深挖三把刀
不要沉迷搜集 100 个新工具。熟练掌握一个终端 CLI、一个专业 IDE、一个本地 Markdown 文件夹,足矣。
现场高频答疑 (Q&A)
你不需要成为程序员。你的核心竞争力在于行业专业业务认知、判断交付质量的能力和清晰的沟通逻辑。
非重度使用每月几块到十几块钱即可畅用旗舰国产大模型。善用本地网关与免费额度,成本极低。
核心资产坚守「本地存储优先」原则,关键执行命令保留人工审核确认,不把敏感密钥推上公网。