# 工作台、模型与连接方式帮助页

更新日期：2026-08-13。本页解释各章反复出现、但不适合每章重复展开的基础概念。

## 1. 工作台中各部分分别做什么

| 部分 | 主要作用 | 不能替代什么 |
|---|---|---|
| VS Code | 打开限定工作区、查看差异、运行命令和管理文件 | 不会自动保证AI修改正确 |
| Jupyter Notebook | 把说明、完整代码、结果和实验记录按顺序放在一起 | 不是只看输出的演示幻灯片 |
| Qwen Code | 把自然语言任务转成阅读、修改和运行计划，并在获准后执行 | 不能替学生授权、验收或承担责任 |
| Qwen/DeepSeek网页端 | 研讨概念、解释错误、比较方案 | 不能直接读取本地工程；不得上传敏感资料 |
| 本地或云端模型API | 让代码按明确接口调用模型能力 | 需要单独核对能力、权限、费用和数据边界 |

## 2. “一个模型配置”为什么不够

不同项目需要的能力并不相同，配置前应逐项检查：

- `chat`：文本对话或生成；
- `embedding`：把文本变成可比较的向量；
- `vision`：接收图像并理解内容；
- `tool_call`：按约定结构提出工具调用请求。

聊天模型能回答问题，不代表它一定能生成embedding、看图或稳定输出工具参数。教学资源因此为每种能力单独检查，并提供 `mock`、确定性算法或预计算结果作为离线基线。

## 3. 本地、云端和网页端怎样选择

| 路径 | 适合 | 主要代价与风险 |
|---|---|---|
| 离线基线 | 第一次学习、断网、统一验收 | 能力较窄，必须明确它不是在线大模型表现 |
| 本地模型服务 | 数据不宜外发、需要反复实验 | 受硬件、模型大小、版本和服务配置影响 |
| 学校授权云端API | 需要稳定接口和较强能力 | 需管理密钥、费用、网络与数据出境/合规边界 |
| 模型网页端 | 快速研讨、人工复制少量非敏感内容 | 难以自动复现，平台和模型版本可能变化 |

不能只按“哪个模型最强”选择。应同时比较任务能力、输入数据、可复现性、成本、延迟、失败降级和责任边界。

## 4. 密钥与隐私的最低规则

1. API密钥只从环境变量或学校批准的密钥管理方式读取，不能写进代码、Notebook、截图、聊天记录或提交包。
2. 使用云端模型时，只发送完成任务必需且已脱敏的最小内容。
3. 摄像头帧默认不保存、不上传；含人脸、证件、车牌、屏幕内容时停止实验。
4. Qwen Code的工作区限定在当前章节；联网、安装、运行、覆盖、删除、摄像头和外部设备操作必须人工确认。
5. 离线mock的输出必须醒目标明，不能当作真实模型评测结论。

## 5. 如何与AI协同而不把任务交给AI代做

建议保留一次五段证据：

1. **原始意图**：我想改变什么，预计结果怎样；
2. **模型建议**：AI建议改哪些文件、代码和测试；
3. **人工选择**：我接受、拒绝或缩小了什么，为什么；
4. **实际变更**：查看差异后批准的最小修改；
5. **最终判断**：运行证据是否支持预测，还有什么限制。

前3章完整练习这一方法；后续章节只记录本章最关键的一次修改，避免留痕本身挤占实验时间。

## 6. 权威入口

- [VS Code数据科学与Notebook官方说明](https://code.visualstudio.com/docs/datascience/overview)
- [Jupyter官方文档](https://docs.jupyter.org/zh-cn/latest/)
- [Python中文文档](https://docs.python.org/zh-cn/3/)
- [TensorFlow中文教程](https://tensorflow.google.cn/tutorials?hl=zh-cn)
- [阿里云百炼模型服务官方文档](https://help.aliyun.com/zh/model-studio/)
- [DeepSeek API官方文档](https://api-docs.deepseek.com/zh-cn/)
- [Qwen Code官方文档](https://github.com/QwenLM/QwenCode)

外部接口和模型名称会变化。课程提供的模型卡应记录检查日期、服务地址、模型显示名称、能力类型和离线替代路径；不要把本页的产品名称当作永久配置。