AI 使用基础

这一页把使用 SJTU Agent（以及任何 AI 工具）需要的最小背景知识一次讲完。已经懂的同学可以直接跳到从零安装。

大语言模型是什么

你经常听到的「大模型」「LLM」「DeepSeek」「Qwen」，指的是同一类东西：读过海量文本的预测机器。它不查数据库、不记忆互联网，而是根据上下文一个字一个字地"接"出最合理的回答——像一个博览群书但偶尔会记错细节的学长学姐。

它擅长：读懂一段话的意思、写作改稿、总结翻译、解释概念、写代码、按你的要求组织信息。

它不擅长：精确计算和统计、没见过的新鲜事（除非现场联网搜索）、对"事实"保持绝对准确。所以重要的事情要交叉核对，下一节展开。

幻觉：AI 会一本正经地说错话

大模型的本质决定了它可能编造听起来很可信的内容——编文献、编规定、编"学校通知"，语气还特别笃定。这叫幻觉，是所有大模型的通病，不是这个项目做得不好。

SJTU Agent 的应对方式是：能用工具的绝不靠背。DDL 查的是 Canvas / 教务的真实数据，成绩直连教学信息服务网，新闻来自真实的教务处/水源页面。凡是它调用了工具回答的，结果就是系统里真实的那个数字。

但你仍然要注意：

• 开放性问题（"这门课好过吗""老师严不严"）没有工具可查，答案就是模型自己的判断，听听就好；
• 生成类内容（作业解答、论文段落）必须自己理解和核对后才能提交——既是因为幻觉风险，也是学术诚信问题；
• 拿不准的时候直接问它：「这个结论你是查了数据还是猜的？」

API Key：你的钥匙，别外借

API Key 是一串类似 sk-xxxxxxxx 的密文，作用相当于一张绑定你身份的饭卡：

• 你向 AI 服务发请求时出示它，对方就知道是谁在用、从谁的额度里扣；
• 谁拿到这串字符，谁就能用你的额度——所以不要发到群里、不要截图发社交媒体、不要提交进 Git 仓库；
• SJTU Agent 把 Key 存在你电脑本地的 .env 文件里，该文件已在 .gitignore 中，正常情况下不会被泄露。

推荐用的致远一号是交大官方免费平台，对学生免费，不需要国外信用卡，注册入口：https://zhiyuan.sjtu.edu.cn。调用名、限流与校外访问是否需要校园网，以官方指南为准：https://claw.sjtu.edu.cn/guide/sjtu-api/。

Token 与上下文窗口

模型读写文字以 token 为单位（大致一个汉字 ≈ 1–2 个 token）。两件事你需要知道：

1. 每次对话有长度上限（上下文窗口）。聊得越久、贴的内容越长，越早触顶——触顶后最早的对话会被压缩或遗忘。
2. 长资料用附件，别整段粘贴。几十页 PDF 直接粘贴既浪费又容易丢细节；用 Web GUI 的上传按钮或 TUI 的 /attach <文件路径>，后台会自动解析提炼后再喂给模型。

觉得"它好像忘了前面说的什么"，最简单的办法是开个新会话重来（Web/TUI 都是 ctrl+n），把关键背景重新交代一遍。

怎么提问效果好

把它当成一位聪明的、但不认识你、也看不见你屏幕的助理——他不知道的课程、时间、课程名，你得说给他听：

❌ 不太好	✅ 更好
「帮我安排一下时间」	「我这周有三个 DDL 周五截止，帮我按优先级排个赶工计划」
「这道题怎么做」	（先上传题目图片）「第 2 题，我用高斯消元做到这里卡住了：……」
「写个东西」	「帮我写一封给任课老师的邮件，申请周一补交实验报告，语气礼貌简洁」

三条心法：

1. 具体：给出课程名、日期、序号等定位信息；
2. 一次一件事：复杂任务拆成几步，一步步来效果远好于一句话甩十个要求;
3. 可以追问和返工：「第二条展开讲讲」「换个更口语的说法」都是完全合法的操作，聊天就是工作方式。

另外不需要背命令：斜杠命令（/hw、/eat 这些）只是常用需求的快捷方式，见话术库；自然语言永远可用。

安全三原则

1. 凭据只进本机、只走官方渠道。jAccount 账号密码、API Key 只填进安装向导或本地 .env；警惕任何在网上自称"代装 SJTU Agent、要你账号密码"的人。
2. AI 的输出核对后再用于正式场合。提交的作业、发给老师的邮件、涉及成绩的规定解读，自己过目一遍。
3. 别让它替你做高危操作而不看过程。本项目对删文件、执行代码这类危险操作默认弹出审批（Web/TUI 里点批准才执行），看到审批框请真的读一眼再批。

小词典

词	一句话解释
Prompt（提示词）	你发给 AI 的话本身
LLM / 大模型	本页开头讲的那种预测式文本引擎
幻觉	模型一本正经地编造错误内容
上下文窗口	单次对话能容纳的最大文字量
多模态	除了文字还能读图/音频/PDF 的能力
Agent	会自己调用工具（查课表、跑脚本）分步完成任务的 AI
MCP / Skill	给 Agent 外挂新工具和新本领的扩展机制，见 README 的「MCP 与技能扩展」