第一部分：认识 Clacky AI

🎯 学习目标

完成这一部分后，你将：

理解什么是编程以及 AI 如何改变编程
掌握 Clacky AI 的核心概念
了解为什么 Clacky AI 适合编程初学者

1.1 什么是编程？

🤔 编程就像写菜谱

想象一下，你要教一个从来没有做过饭的朋友如何做一道菜。你需要：

明确目标：我要做什么菜？（比如：西红柿炒鸡蛋）
准备材料：需要哪些食材？（西红柿、鸡蛋、油、盐等）
详细步骤：
- 先打散鸡蛋
- 热锅放油
- 倒入鸡蛋炒熟盛起
- 放入西红柿炒出汁水
- 加入炒蛋，调味即可

编程其实就是这样！我们告诉计算机：

目标：我要创建一个什么样的应用程序
材料：需要什么功能和数据
步骤：一步一步如何实现

传统编程 vs AI 辅助编程

传统编程方式 😰

你需要学习：
├── 编程语言（如 JavaScript、Python）
├── 框架和库（如 React、Vue）
├── 数据库知识
├── 服务器配置
├── 调试和测试
└── 部署和维护

就像：你需要先学会种菜、养鸡、做调料，才能做出一道菜

AI 辅助编程方式 😊

你只需要：
├── 清楚地描述你想要什么
├── 与 AI 进行对话交流
├── 提供反馈和建议
└── 测试最终结果

就像：你只需要告诉一个专业厨师你想吃什么，他来负责所有的技术细节

1.2 Clacky AI 核心概念

🏢 工作空间（Workspace）

简单理解：工作空间就像你的数字办公室

想象你在一家公司工作：

你有自己的办公桌（个人工作区域）
可以和同事协作（团队功能）
有各种工具和资源（开发环境）
可以管理多个项目（项目管理）

在 Clacky AI 中，工作空间提供：

🖥️ 云端开发环境：无需在自己电脑上安装复杂软件
👥 团队协作：可以邀请他人一起工作
🔧 完整工具链：所有开发需要的工具都已准备好
📁 项目管理：统一管理所有项目

📁 项目（Project）

简单理解：项目就是你要创建的完整应用程序

比如：

📝 个人博客网站 = 一个项目
🛒 在线商店 = 一个项目
📱 待办事项应用 = 一个项目

每个项目包含：

所有的代码文件
配置和设置
版本历史记录
相关文档

🧵 线程（Thread）

简单理解：线程就是处理具体任务的独立工作环境

官方定义：线程是基于 git 分支组织的独立开发环境，用于处理项目工作流中的具体任务。每个线程都在独立的云开发环境中运行，变更不会影响项目其他部分，直到合并为止。

生活中的例子：假设你要装修房子（项目），你会分别处理：

🎨 装修客厅（一个线程）
🛏️ 装修卧室（另一个线程）
🍳 装修厨房（又一个线程）

每个房间的装修不会互相干扰，完成后再整合到整个房子里。

在 Clacky AI 中：

🆕 添加新功能 = 创建新线程
🐛 修复问题 = 创建新线程
✨ 改进界面 = 创建新线程

线程的类型

1. 根线程（Root Thread）

🏗️ 作用：仅用于首次导入项目时设置开发环境、提交 .1024 文件和更新 .gitignore，不做业务开发。
🔧 内容：安装必要工具，配置开发环境，初始化依赖。
⚠️ 注意：根线程关闭后，所有 Issue 线程均继承该基础环境。

2. Issue 线程（功能线程） ：开发具体功能

✨ 作用：每个线程只处理一个明确需求（如新功能、bug 修复等），继承根线程环境配置。
🎯 特点：上下文干净，便于聚焦单一任务，提升 AI 编码效果。
🔄 流程：需求沟通 → 创建线程 → 开发 → 测试 → 提交变更 → 合并到主项目 → 关闭线程

🤖 AI 代理（AI Agents）

简单理解：AI 代理就是你的智能助手团队

想象你有一个专业团队帮你工作：

Clacky AI 包含以下四大核心代理模块，每个模块各司其职，协同完成开发任务：

1. 任务计划代理（Task Plan Agent）📋

就像项目经理

理解你的需求
制定详细计划
分解复杂任务
监督执行进度

工作流程：

你的需求 → 分析理解 → 制定计划 → 执行任务 → 检查结果

2. 聊天代理（Chat Agent）💬

就像技术顾问

回答你的问题
解释代码含义
提供技术建议
帮助解决问题

3. Git 代理（Git Agent）📚

就像版本管理员

保存代码版本
管理代码变更
处理代码合并
连接远程仓库

4. 智能检测代理（Smart Detect Agent）🛠️

就像自动化测试和修复专家

自动检测代码中的潜在问题
提供修复建议或自动修复
辅助保障代码质量和稳定性

1.3 Clacky AI 的优势

🚀 为什么选择 Clacky AI？

1. 零基础友好 👶

无需学习编程语言：用自然语言描述需求即可
AI 处理技术细节：复杂的代码由 AI 自动生成
实时指导：遇到问题立即获得帮助
渐进式学习：在实践中逐步理解编程概念

2. 专业级质量 💎

成熟的工作流程：遵循行业最佳实践
高质量代码：AI 生成的代码符合专业标准
完整的测试：自动检查和修复问题
版本控制：专业的代码管理方式

3. 高效协作 🤝

实时反馈：随时调整和修改
可视化过程："任务时光机"让你看到每一步
团队协作：可以邀请他人参与项目
知识共享：学习他人的项目经验

4. 完整生态 🌟

云端环境：无需复杂的本地配置
集成工具：开发、测试、部署一站式解决
官方支持：专业的技术支持
持续更新：功能不断改进和增强

🎯 适合的使用场景

✅ 非常适合

创建个人网站和博客
开发简单的 Web 应用
制作原型和演示项目
学习现代开发流程
快速验证创意想法

⚠️ 需要注意

复杂的企业级系统（建议分阶段实现）
需要特殊硬件支持的应用
对性能有极高要求的系统

🧠 知识检查

完成这一部分后，请确认你已经理解：

基础概念 ✅

[ ] 编程就是给计算机写"菜谱"
[ ] AI 辅助编程让初学者也能创建专业应用
[ ] 工作空间是你的数字办公室
[ ] 项目是完整的应用程序
[ ] 线程是处理具体任务的独立环境

核心优势 ✅

[ ] Clacky AI 适合零基础学习者
[ ] AI 代理团队各有专门职责
[ ] 可以生成专业级质量的代码
[ ] 支持实时协作和反馈

实际应用 ✅

[ ] 知道什么项目适合用 Clacky AI 开发
[ ] 理解根线程和功能线程的区别
[ ] 了解 AI 辅助开发的基本流程

🎉 恭喜！

你已经完成了第一部分的学习！现在你对 Clacky AI 有了基本的了解。

接下来，我们将学习如何实际使用 Clacky AI，包括注册、登录和基本操作。

第一部分 - Clacky AI 基础概念