开放原子开源社团 JMI-OPENATOM
新成员入门课下载完整课件

开放原子开源社团 · 新成员入门工作坊

AI Agent
与第一次开源

认识工具，理解开源，发布自己的作品。

从“AI 能做什么”到“我的第一份公开作品”，一步步完成。

开始课程 查看示例作品下载完整课件 ZIP
32 页课程50 分钟建议时长1 份可分享作品
今天的学习路线
01认识 Agent任务、工具与结果
02理解开源源码、说明与许可
03发布作品在 Gitee 完成第一次分享
02课程导览

今天，我们完成一件可以分享的作品

结束时，每个人都能解释 Agent，并交出一个公开仓库链接

  1. 认识 Agent

    10 分钟

  2. 理解开源

    7 分钟

  3. Gitee 界面与发布

    16 分钟

  4. DeepSeek 辅助演示

    7 分钟

  5. 自己动手与交流

    10 分钟

03认识 Agent

Agent：围绕目标，调用工具完成任务

Agent 通常译为“智能体”。

你给目标

它规划步骤，使用工具，再根据结果继续调整。

例子

“整理社团活动资料，生成一份可分享的说明。”

能力取决于接入的工具与授权范围，结果需要人来验收。

04认识 Agent

一个 Agent 怎样工作

以“把社团活动资料整理成文件”为例

  1. 理解目标

    确认要交付什么

  2. 拆分任务

    列出整理与检查步骤

  3. 调用工具

    读取资料、生成文件

  4. 检查结果

    核对内容与可用性

如果结果不符合要求，继续调整步骤和工具操作。

人负责给清楚目标、控制权限、确认最终结果。

05认识 Agent

本次认识的四种 AI 工具

按任务认识代表工具，先选适合自己的用途

代表工具适合的任务社团场景
Codex编写、修改与调试项目代码完善社团网页并检查效果
Claude Code理解代码、修改文件与运行检查排查小程序的问题
DeepSeek中文问答、代码与说明整理整理 README 与发布步骤
WorkBuddy整理本地文件、处理办公任务汇总活动资料并生成文档

Codex、Claude Code 偏编程任务，WorkBuddy 偏办公执行。DeepSeek 本课用网页对话。

06认识 Agent

课堂问答：AI 会不会犯错？

先想一想，再回答

AI 回答得很肯定，就一定正确吗？

回答后查看参考答案

参考答案在单独页面打开，本页只展示问题。

07认识 Agent

小互动：这三个问题，你怎么回答

先独立想 20 秒，再请同学回答

  • Q1　哪个更像 Agent？

    A. 回答一道知识题
    B. 查找资料、整理表格并交付文件

  • Q2　做一个社团网页，你会选哪个工具？

    从刚才的代表工具中选一个，并说说原因。

  • Q3　AI 说“已完成”，你会如何确认？

    说出一个你能亲手检查的结果。

参考讲解在下一节，先给出自己的回答。

08认识 Agent

参考答案：能行动，也要能验证

  • A1　B 更体现 Agent 的任务执行特征

    它包含工具操作和交付物。仅凭一句回答不能判断底层实现。

  • A2　Codex 或 Claude Code 都可以

    它们适合在项目中修改代码。具体选择取决于环境与使用习惯。

  • A3　打开文件，查看链接，实际试用

    对照最初的要求检查，而不只看 AI 的完成提示。

09理解开源

开源，让别人可以在规则下继续创造

源代码公开明确的开源许可证

他人可以按许可证使用、研究、修改和再分发。

10理解开源

开源怎样帮助我们成长

一个社团小作品，可以成为下一位同学的起点

  1. 作者发布作品

    提供代码与使用说明

  2. 同学使用与反馈

    发现问题，提出建议

  3. 一起改进

    修正问题，补充功能

学习

看到真实项目怎么做

协作

在同一个作品上继续改进

积累

留下可展示的实践成果

11理解开源

哪些作品适合分享

先确认自己有权发布，再选择适合内容的授权方式

作品类型可以准备什么许可提示
原创代码源码、运行方法、示例按需求选择 MIT 等开源许可证
笔记与教程可编辑文档、引用来源可了解 CC BY 4.0 等内容许可
借用的素材原作者、来源、授权条件按原许可处理，不能直接当原创

今天的练习：自己有权分享的单文件 HTML 小作品。

12Gitee 发布全流程

一个入门项目，先把这三样准备好

my-first-open-source/

文件它解决的问题
index.html作品本体：能打开，能查看和修改
README.md使用说明：做什么，怎么用，怎样反馈
LICENSE授权条件：别人可以怎样使用和修改

本课程仓库提供可直接打开的练习文件。

查看示例作品
13Gitee 发布全流程

开源发布流程：先准备，再发布，最后验证

本次使用 Gitee 网页操作，全程可以不输入命令

  1. 选择作品

    确认原创或获得授权

  2. 整理文件

    源码、README、许可

  3. 新建 Gitee 仓库

    设置名称与可见性

  4. 上传文件

    检查文件名与内容

  5. 提交发布

    写下这次更新内容

  6. 验证并分享

    他人能访问、会使用

14Gitee 发布全流程

Gitee 仓库首页：先找到常用入口

Gitee 是代码托管与协作平台。今天围绕自己的作品仓库操作。

Gitee 仓库首页：先找到常用入口，Gitee 界面示例
Gitee 官方帮助界面示例。点击查看原图，实际布局与权限以当前页面为准。

代码：看文件与 README；文件菜单：新建或上传；克隆/下载：取回源码。

15Gitee 发布全流程

第 1 步：登录后，从“＋”新建仓库

也可以直接访问 gitee.com/projects/new，进入新建页面

  1. 先登录自己的账号

    打开 gitee.com，完成登录。

  2. 找到顶部“＋”

    展开菜单，选择“新建仓库”。

  3. 确认进入新建页面

    页面标题显示“新建仓库”。

第 1 步：登录后，从“＋”新建仓库，Gitee 界面示例
Gitee 官方帮助界面示例。点击查看原图，实际布局与权限以当前页面为准。
16Gitee 发布全流程

第 2 步：填写仓库名称、归属与路径

示例名称：my-first-open-source，归属选择自己的个人账号

  1. 名称说明作品

    例如“我的第一个开源作品”。

  2. 归属选本人

    路径用简短英文，确认可用。

  3. 介绍写清用途

    例如“一个单文件社团介绍页”。

第 2 步：填写仓库名称、归属与路径，Gitee 界面示例
Gitee 官方帮助界面示例。点击查看原图，实际布局与权限以当前页面为准。
17Gitee 发布全流程

第 3 步：设置可见性、README 与许可证

确认配置后点击“创建”，再检查仓库实际状态

  1. 可见性选公开

    如有额外提示，按页面流程完成。

  2. 勾选 Readme 初始化

    仓库首页就有项目说明文件。

  3. 选择合适的许可证

    原创练习代码可考虑 MIT。

第 3 步：设置可见性、README 与许可证，Gitee 界面示例
Gitee 官方帮助界面示例。点击查看原图，实际布局与权限以当前页面为准。
18Gitee 发布全流程

第 4 步：在“文件”菜单上传作品

打开自己的仓库，在“代码”页找到“文件”下拉菜单

  1. 选择“上传文件”

    点击菜单底部蓝框中的选项。

  2. 选择本地作品文件

    例如 index.html，等上传完成。

  3. 写说明，再点“提交”

    例如“添加社团介绍页”。

第 4 步：在“文件”菜单上传作品，Gitee 界面示例
Gitee 官方帮助界面示例。点击查看原图，实际布局与权限以当前页面为准。
19Gitee 发布全流程

第 5 步：在线编辑 README.md

在代码页点击 README.md，再点击文件页面的“编辑”

第 5 步：在线编辑 README.md，Gitee 界面示例
Gitee 官方帮助界面示例。点击查看原图，实际布局与权限以当前页面为准。

README 至少写清

作品做什么、怎样打开、文件结构、怎样反馈。

修改完成后填写提交说明，例如“补充使用方法”，再点击“提交”。

20Gitee 发布全流程

第 6 步：补上 LICENSE，说明使用规则

若创建时已经添加，打开核对即可；缺少时再新建

  1. 新建 LICENSE

    打开“文件”，选择“新建文件”。

  2. 核对许可证

    文件名填写 LICENSE，选择适合的许可并核对内容。

  3. 提交

    确认许可与作品、素材来源一致后提交。

第 6 步：补上 LICENSE，说明使用规则，Gitee 界面示例
Gitee 官方帮助界面示例。点击查看原图，实际布局与权限以当前页面为准。
21Gitee 发布全流程

第 7 步：用“历史”确认修改记录

打开 README.md，点击“历史”，核对刚刚的提交

第 7 步：用“历史”确认修改记录，Gitee 界面示例
Gitee 官方帮助界面示例。点击查看原图，实际布局与权限以当前页面为准。
  1. 找到最新的一条记录

    核对提交说明、提交时间和作者。

  2. 查看历史内容

    按需要打开对应版本的文件。

22Gitee 发布全流程

第 8 步：分享仓库链接，下载后试用

分享浏览器地址栏中的仓库主页地址，不分享编辑页或本地文件路径

  1. 复制仓库主页 URL

    请同桌在自己的浏览器里打开。

  2. 克隆/下载 → 下载 ZIP

    按页面要求完成验证，再解压。

  3. 照 README 使用

    本地浏览器打开 index.html。

第 8 步：分享仓库链接，下载后试用，Gitee 界面示例
Gitee 官方帮助界面示例。点击查看原图，实际布局与权限以当前页面为准。

仓库中的 HTML 文件需要下载后用浏览器打开；代码文件页显示源码，不等同于网站上线。

23Gitee 发布全流程

交流入口：用 Issues 留下一条清楚的建议

进入仓库的 Issues 页，点击“新建 Issue”

交流入口：用 Issues 留下一条清楚的建议，Gitee 界面示例
Gitee 官方帮助界面示例。点击查看原图，实际布局与权限以当前页面为准。

标题写具体问题

内容写复现步骤、预期结果与实际结果。

24Gitee 发布全流程

发布后的最后检查

勾选仅保存在当前浏览器，供自己核对。

25DeepSeek 辅助发布

更简单的方法：让 DeepSeek 帮你准备

网页对话负责整理内容，你在 Gitee 完成上传与发布

  1. 给它作品信息

    用途、文件、使用方式

  2. 生成发布材料

    README、清单与步骤

  3. 你确认并发布

    检查后复制、上传

本次路径：DeepSeek 网页对话 + Gitee 网页操作

给 AI 描述或非敏感内容即可，账号密码和令牌不需要提供。

26DeepSeek 辅助发布

可以直接复制给 DeepSeek 的提示词

复制到 DeepSeek 后，替换【】内的信息
我第一次开源，请用中文带我操作。
我的作品是【名称】，作用是【用途】，文件有【文件列表】。
作品由我原创，无账号密码、密钥和个人隐私。
请先询问缺失信息，再完成：
1. 按现有内容生成 README.md，写明功能、用法、文件结构和反馈方式。
2. 给出适合该作品的许可证建议，说明理由和需要我确认的条件。
3. 按 Gitee 网页操作给出发布步骤，不使用命令行。
4. 列出发布前与发布后的检查项，不编造已有功能。
如果没有工具权限，请给我文件内容与步骤，由我手动发布。
打开 DeepSeek 官网
27DeepSeek 辅助发布

DeepSeek 的回答，应该能落到具体文件

课堂示例：一个可在本地浏览器打开的社团介绍页

README.md 示例
# 我的社团介绍页
用途：介绍社团方向与入门活动
使用：下载后用浏览器打开 index.html
文件：index.html、README.md、LICENSE
反馈：在仓库 Issues 中提出建议

作者需要核对

功能真的存在吗？
文件名是否一致？
说明照着做能用吗？
许可与素材来源确认了吗？

28DeepSeek 辅助发布

现场演示：完成一个最小开源项目

讲师先做一遍，同学观察屏幕上的关键动作

  1. 本地确认作品

    打开 index.html，看见页面内容

  2. DeepSeek 整理

    生成并核对 README，确认许可

  3. Gitee 发布

    建公开仓库，上传并提交

  4. 最后验证

    看文件、看许可、复制公开链接

29练习、总结与资料

轮到你：10 分钟发布自己的第一份作品

  1. 0–2 分钟

    选一个自己有权分享的小作品

  2. 2–5 分钟

    用 DeepSeek 整理并核对说明

  3. 5–8 分钟

    在 Gitee 建仓库、加许可并提交

  4. 8–10 分钟

    请同桌访问，准备分享链接

提交物：公开仓库链接，包含作品文件、README 和适合的许可证。

30练习、总结与资料

互相试用，比一句“我完成了”更有价值

请两位同学分享

我的作品做什么？
我把哪个步骤交给了 AI？
我亲自检查了什么？

同桌检查

链接能访问
源码能找到
说明能照着做
许可证清楚

31练习、总结与资料

今天带走的三件事

认识 Agent

它围绕目标调用工具，完成任务并检查结果。

理解开源

公开源码，也要给出清楚的使用说明和许可。

完成第一次发布

AI 可以辅助准备，作品质量与发布结果由你确认。

32练习、总结与资料

课后入口与参考资料

点击资料名称打开官方页面；也可复制完整网址到浏览器。

链接核对：2026 年 10 月 25 日。产品功能与网页入口以当前页面为准。

↑