# agent_pre

**Repository Path**: daeee-goose/agent

## Basic Information

- **Project Name**: agent_pre
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-10
- **Last Updated**: 2026-11-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agent 入门与实践讲座

面向数学学院大一学生的两期讲座仓库：投影课件、可分发 Skill、课堂材料与生成器脚本。

## 仓库结构

| 目录 | 内容 |
|---|---|
| `slides/1.html` | 第一期课件，21 页：认识模型、Agent、能力评估、付费接入与成本 |
| `slides/2.html` | 第二期课件，22 页：使用现成 Agent |
| `slides/assets/session2/` | 第二期引用的官方图标与界面截图 |
| `work/` | 生成器与运行时脚本 |
| `skills/` | 两个可分发 Skill：`meeting-notes-and-actions`、`travel-planner` |
| `downloads/` | 课堂材料包（`agent-class.zip` 及解压内容、单 Skill zip） |
| `publish/skills-release/` | Skill 发布步骤 |
| `群聊演示/` | 飞书群聊演示剧本与配套 skill-pack |

## 课件使用

两份 HTML 均可离线用浏览器打开（点击官网链接需联网）。方向键／空格翻页，G 打开目录，F 全屏，B 黑屏；答案可点击揭晓，排行榜先点产品再点档位、可重置，浏览器允许时排名保存在本地。HTML 不含讲师备注或打印功能。

- **第一期（`1.html`）**：以"读活动通知 → 生成参与安排 → 保存文件"为贯穿案例，按问题推动 Prompt、Context、Agent 机制的讲解；能力评估在产品排名之前。该文件为用户修改版，独立于生成器维护。
- **第二期（`2.html`）**：主线为下载与接入 → 完成任务 → 加载已有 Skill → 改进使用 → 语音与飞书。提供 13 款工具参考：P3 展示 OpenCode、DeepSeek Harness（dsh）、Codex、TRAE、Cursor、VS Code Copilot 六款常用入口，操作页另保留 WorkBuddy、Qoder、ZCode、Antigravity、Kiro、Claude Code 和 pi；选择会跨操作页同步。P4 按对应客户端说明下载安装；P7 按真实入口区分账号登录、官方 API Key、预设供应商和自定义端点。海外服务和地区限制在卡片与操作页分别标注。
- 60 分钟安排：P1—P2 3 分钟；P3—P8 18 分钟；P9—P11 10 分钟；P12—P16 15 分钟；P17—P19 7 分钟；P20—P21 4 分钟；P22 与答疑 3 分钟。现场选一款完整演示，其余工具作为课后参考。

## 编辑与重建

- `python3 work/build_session2.py` 只重建 `slides/2.html`。它读取 `slides/1.html` 以及本地 `lectures/resources/` 下的 `api-providers.json`、`agent-clients.json`、`session2-media.json`；**`lectures/` 不入库**，克隆本仓库后无法直接重建第二期，需先补齐这三个 JSON。直接修改生成的 HTML 会在重建时被覆盖。
- 第二期的切换与复制逻辑在 `work/session2_usage_runtime.js`，桌面操作页样式在 `work/session2_desktop.css`，由生成器内联进 HTML。
- `1.html` 为手工维护；`work/finalize_user_deck.py` 是其版式收尾脚本。
- `work/build_slides.py`、`first_session.py`、`speaker_scripts.py`、`story_revision.py`、`visual_revision.py`、`revise_slides_v2.py` 属于旧的中文文件名课件生成链，对应产物与 Mermaid 本地副本已清理，仅留作历史参考，不可直接运行。

## Skill 与课堂材料

- `skills/` 为 Skill 源目录。正式安装时按所选客户端的 Skill 导入方式导入整个文件夹（或 `downloads/` 中对应 ZIP），导入后确认客户端能够识别和调用，不能只凭文件存在判断已加载。
- `downloads/agent-class.zip`：课堂材料包，含材料文件、输出目录说明与 skill-pack。解压后按所选客户端的项目级 Skill 路径复制，无自动安装或全局配置变更。
- `publish/skills-release/发布步骤.md`：Skill 发布步骤说明。
- `群聊演示/演示剧本.md`：飞书群聊演示剧本；飞书使用课前已接好的测试群。

## 说明

- 资源核对日期 2026-11-06：已核对官方公开文档与下载的界面原图，检查源码、资源路径和交互逻辑；未在真实客户端执行安装、Key 配置或模型调用。Skill 和模型支持以课前实测的客户端版本为准。
- 讲稿（`lectures/`）、原始录屏与个人客户端配置仅本地保留，不入库；`.gitignore` 中已排除。