Initial commit from WSL migration

This commit is contained in:
Rocky
2026-04-09 13:42:10 +02:00
commit 7eac00a35c
29 changed files with 11991 additions and 0 deletions

View File

@@ -0,0 +1,360 @@
# 穹狼科创 · AI编程创新课 · 教学方法论规则
> 本文件从 AI05/CLAUDE.md 提取核心方法论,适配 AI编程创新 教学场景。
> 适用对象课程设计者、教案编写AI、授课教师。
---
## 一、顶层方法论SDDT 螺旋深化式诊断教学法
### 四大核心哲学
#### 1. 以诊定教 (Diagnosis Instructs Teaching)
- 教学的每一个后续动作都必须由前一个动作收集到的学生认知证据驱动
- 不预设固定的教学路径,而是根据实时诊断结果动态调整
- 每个"进度同步"环节必须是真正的诊断点,而非形式化检查
#### 2. 递归深化 (Recursive Deepening)
- 理解是螺旋式上升的,同一个概念在不同层级多次接触
- 教学设计需要多个循环层级:识别层 → 理解层 → 应用层 → 综合层
- 避免"一次性讲透"的幻觉,接受学生需要多轮接触才能内化
#### 3. 误概念优先 (Misconception-First)
- 预设并主动暴露关键误概念,将其作为教学的核心靶点
- 每节课必须明确列出3-5个典型误概念
- 设计"误概念激发"问题,让错误认知浮出水面
- 在逐字稿中预设学生的错误回应,并设计针对性引导策略
#### 4. 自适应路径 (Adaptive Pathing)
- 没有完全固定的教学流程,只有根据实时诊断结果动态生成的决策树
- 教案必须设计"分支路径"如果A情况则策略1如果B情况则策略2
- 6-8人小班使得个性化自适应成为可能
### AI编程创新 场景下的 SDDT 适配
AI05中的误概念围绕"飞书多维表格字段类型"和"数据关联"。AI编程创新场景的典型误概念完全不同
| 误概念类别 | 典型误概念 | 诊断方式 |
|-----------|-----------|---------|
| AI认知类 | "AI什么都知道"、"AI会像人一样思考"、"所有AI都一样"、"AI的回答都是对的" | 让学生给AI出难题幻觉测试题库观察它犯错Token成本计算建立资源意识 |
| 提示词类 | "说得越多越好"、"AI能读懂我脑子里的想法"、"一次就该得到完美答案"、"给了角色就够了不需要示例" | 对比好/烂提示词的输出差异;五要素模型(角色、指令、场景、限制、示例)逐步拆解 |
| 模型选型类 | "模型越贵越好"、"什么任务都用最强的模型"、"所有模型做同一件事" | 快思考vs慢思考对比实验模型选型口诀训练 |
| 代码黑箱类 | "代码很可怕看不懂"、"AI做完了就不用改了"、"我不懂代码就不能判断对错" | 功能审查训练:点按钮有反应吗?显示正常吗? |
| 审查判断类 | "能跑就行"、"好看=酷炫特效"、"我说不清楚哪里不对" | Bug描述三要素训练步骤→预期→实际 |
| 项目规划类 | "不需要策划直接让AI做"、"一次说完所有需求"、"所有功能都同样重要" | 需求文档撰写+优先级排序 |
| 创作同质类 | "按老师的模板做就行"、"和别人做一样的最安全" | 开放主题选择+个性化输入训练 |
---
## 二、4C 四幕剧教学结构90分钟
### 结构概览
| 幕 | 名称 | 时长 | 核心功能 | SDDT角色 |
|----|------|------|---------|---------|
| 第一幕 | 联系 (Connect) | 10分钟 | 唤醒已有知识 + 情景导入 | 初诊阶段 |
| 第二幕 | 建构 (Construct) | 65分钟 | 分段实践 + AI编程创作 | 持续诊断与深化循环 |
| 第三幕 | 反思 (Contemplate) | 10分钟 | 成果展示 + 同伴互评 | 元认知诊断 |
| 第四幕 | 延续 (Continue) | 5分钟 | 抽象总结 + 5分钟挑战发布 | 迁移诊断 |
### 第一幕:联系 (Connect) — 10分钟
**上节课回顾 (3分钟)**
- 1-2个引导性问题唤醒已有知识
- 本课程特有:展示"上周最佳5分钟AI挑战"作品,既是复习也是社交激励
- **诊断目标**:探测学生的前概念和知识保持度
**情景导入 (7分钟)**
- 从真实场景或学生感兴趣的痛点切入
- 本课程特有导入方式:
- 展示一个"哇这也是AI做的"的作品案例
- 抛出今天的创作挑战:"你今天要做一个____"
- 制造认知冲突:"你觉得AI能做到这个吗我们来试试"
- **误概念激发**:在导入中设计"陷阱问题",主动引出可能的误解
### 第二幕:建构 (Construct) — 65分钟
将项目拆成3-4个分段每段15-20分钟。每段遵循
**讲解与演示 (Teach & Demo) — 3-5分钟**
- 只讲一个核心概念(单一焦点原则)
- 本课程特有:演示"我是怎么跟AI说的"——教师现场示范提示词
- 标注本段预设误概念
**学生实践 (Practice) — 8-12分钟**
- 学生自己动手进行AI编程
- **关键:开放主题。** 同一个能力目标,每个学生做不同主题的作品(原则四)
- 教师走动观察谁的屏幕3分钟没变化就主动过去
- **主动诊断**:不等学生举手,观察操作过程,识别思维痕迹
**进度同步 (Checkpoint) — 2-3分钟**
- 必须是真正的诊断点,而非"大家都做完了吗"
- 诊断方式让1-2个学生展示屏幕追问"你是怎么跟AI说的"
- 针对预设误概念设计诊断问题
- 分支决策:根据诊断结果决定继续深化还是转入下一分段
**本课程特有的建构节奏**
```
分段一 → 需求描述训练
"用一句话告诉AI你想做什么" → AI生成 → 看结果
分段二 → 审查与反馈训练
"哪里不满意怎么跟AI说修改意见" → 迭代
分段三 → 深度优化训练
"从'能用'到'好看'" → 视觉/体验优化
分段四(视课时而定)→ 拓展挑战
"能不能加一个你自己想的功能?" → 个性化发挥
```
### 第三幕:反思 (Contemplate) — 10分钟
**成果展示 (6分钟)**
- 2-3名学生展示作品轮换制确保每个学生一学期至少展示3次
- 本课程特有:不只展示结果,还要展示"我的提示词"和"我的迭代过程"
**互评与讨论 (4分钟)**
- 结构化互评:"一个优点 + 一个改进建议"
- 讨论"最酷的设计"和"最大挑战"
- **元认知诊断**:让学生解释"为什么这样设计"、"最难的部分在哪里"
### 第四幕:延续 (Continue) — 5分钟
**抽象总结 (3分钟)**
- 提炼可迁移的思维模型:"今天学到的XX能力还能用在哪里"
- **迁移诊断**:测试学生能否将具体经验抽象为可迁移的方法
**5分钟挑战发布 + 下节预告 (2分钟)**
- 发布本周的5分钟日常AI挑战任务
- 预告下节课内容,制造认知悬念
---
## 三、逐字稿编写规范
### 基本格式
```markdown
**师:** 教师的话【诊断点:本问题的诊断目标】【认知层级】
**【分支A】若学生回答出关键词**
**师:** 追问/深化
**【分支B】若学生沉默或回答偏离**
**师:** 引导/脚手架
**【分支C】若学生出现预设误概念**
**师:** 纠正策略
```
### SDDT标注清单
| 标注 | 含义 | 使用位置 |
|------|------|---------|
| `【诊断点】` | 关键认知证据收集时刻 | 每个分段至少1个 |
| `【分支A/B/C】` | 基于诊断的不同教学路径 | 每个诊断点之后 |
| `【识别层/理解层/应用层/迁移层】` | 问题的认知层级 | 每个追问标注 |
| `**预设误概念:**` | 本分段可能出现的错误认知 | 每个分段开头 |
### AI编程创新场景的逐字稿示例
```markdown
**【分段二用AI制作个人主页 - 审查与迭代】(15分钟)**
**预设误概念:**
- 误概念1AI做出来就算完成了不需要审查
- 误概念2不满意就重新来一遍而非给AI修改意见
- 误概念3不知道怎么描述"哪里不对"
**讲解与演示 (Teach & Demo):**
**师:** 大家的网页AI都做出来了。现在我来问个问题——你满意吗
【诊断点:观察学生是否有审查意识,还是"能跑就行"】
**【分支A】若有学生说"还行但是某处不太对"**
**师:** 太好了!你注意到了!能不能具体说说哪里不对?
【理解层】
**【分支B】若学生说"挺好的"但明显有问题(比如颜色刺眼、文字太小):**
**师:** 我们来做个实验。把你的网页在手机上打开看看。字看得清吗?颜色舒服吗?
【通过场景切换暴露问题】
**【分支C】若学生说"不好但不知道哪里不好"误概念3的表现**
**师:** 没关系,我们有个"审查三问"——
第一问:功能对不对?(按钮能点吗?链接能跳吗?)
第二问:好不好看?(颜色搭配?字体大小?间距?)
第三问:好不好用?(手机上能正常显示吗?导航清楚吗?)
用这三个问题再看一遍你的网页。
【提供脚手架——审查三问】
**学生实践 (Practice):**
学生用"审查三问"检查自己的网页写下至少2条修改意见
然后用自然语言告诉AI修改。
**进度同步 (Checkpoint):**
**师:** 谁来分享一下你给AI提了什么修改意见AI改对了吗
【诊断点:检验学生的反馈是否具体("导航栏字太小"vs"不好看")】
```
---
## 四、六大能力标注规范
### 课程大纲标注要求(原则十一)
每节课必须在教案YAML页眉中标注本课训练的核心能力1-3项
```yaml
---
课时: 5
主题: 我的个人主页(上)
核心能力: [拆解力, 审美力]
时长: 90分钟
---
```
### 各能力的课堂诊断指标
| 能力 | 入门 | 基础 | 进阶 | 精通 |
|------|------|------|------|------|
| **提问力** | 能写出基本提示词 | 能使用四要素写提示词 | 能根据AI输出调整提示词 | 能设计多轮对话策略 |
| **拆解力** | 能列出3个子任务 | 能排出执行优先级 | 能写出完整功能清单 | 能独立撰写需求文档 |
| **审美力** | 能说出"好看/不好看" | 能指出具体的视觉问题 | 能提出改进方案 | 能建立统一的设计标准 |
| **韧性力** | 遇到问题会求助 | 能描述bug的表现 | 能定位问题的大致范围 | 能独立调试并修复 |
| **表达力** | 能简单介绍作品 | 能讲清楚创作过程 | 能分析遇到的挑战和解决方案 | 能进行完整的项目路演 |
| **共创力** | 能完成单轮AI对话 | 能完成"需求→生成→修改" | 能完成多轮迭代达到满意 | 能独立管理完整项目流程 |
---
## 五、项目制发布流程规范
### 穹狼项目制区别于传统PBL
传统PBL一节课做一个作品 → 展示 → 结束。
穹狼项目制:完整的产品开发流程。
| 阶段 | 活动 | 产出 | 适用课时 |
|------|------|------|---------|
| **搜集需求** | 引导学生发现真实需求 | 需求描述 | 第1课时 |
| **编写需求文档** | AI辅助撰写并迭代需求文档 | 项目提案文档 | 第1课时 |
| **执行与开发** | 按文档进行AI编程开发 | 核心功能版本 | 第2课时 |
| **上线与迭代** | 发布、测试、优化 | 可展示版本 | 第3课时 |
| **召开发布会** | 路演展示、同伴互评、邀请家长 | 最终作品+路演 | 第4课时 |
### 春季学期简化版
第一学期仅在期末项目17-20课试水完整流程。前面的小项目使用简化版
| 项目规模 | 课时 | 流程 |
|---------|------|------|
| 单课作品 | 1课 | 需求描述→开发→审查→完成 |
| 双课项目 | 2课 | 策划→开发→优化→完成 |
| 期末大项目 | 4课 | 完整五阶段发布流程 |
---
## 六、教案编写自检清单
### 基础质量检查
- [ ] 趣味性:哪个环节会让学生发出"哇!"
- [ ] 引导性:引导性问句是否多于陈述句
- [ ] 分层分段:是否为不同水平学生设计挑战路径
- [ ] 叙事感:学生是否清楚今天要"创造"什么
- [ ] 聚焦性:每个讲解环节是否遵守单一焦点原则
- [ ] 开放主题:学生是否有自主选择创作方向的空间(原则四)
- [ ] 可操作性:新教师能否按逐字稿直接执行
### SDDT专项检查
- [ ] 诊断驱动:每个"进度同步"是否有明确的诊断目标和证据收集方式
- [ ] 误概念预设是否为每个分段列出3-5个典型误概念
- [ ] 误概念激发:是否设计了主动暴露误概念的问题
- [ ] 分支路径是否为关键诊断点设计了至少2-3条应对分支
- [ ] 螺旋深化:是否体现了识别→理解→应用→迁移的层级递进
- [ ] 认知层级:每个问题是否标注了所处的认知层级
### AI编程创新专项检查
- [ ] 六大能力是否在页眉标注了本课核心能力1-3项
- [ ] 开放创作:学生是否在做自己选的主题(而非统一模板)
- [ ] 完整循环:是否包含"需求→生成→审查→迭代"的至少一轮完整循环
- [ ] 审查训练是否有引导学生审查AI输出的环节而非"AI做完就行"
- [ ] 作品产出:本课是否有一个具体的、可展示的产出
- [ ] 5分钟挑战是否在第四幕发布了本周的课外挑战
### 教师指南检查(一石三鸟)
- [ ] 技术备注:是否包含本课涉及的技术概念底层解释(教师备课用)
- [ ] 教师提前体验:是否标注"教师备课时先自己做一遍课堂任务"
- [ ] 常见问题FAQ是否列出了学生可能问的技术问题和应对方式
---
## 七、教师角色定义
### 核心角色
| 角色 | 说明 | AI编程创新场景表现 |
|------|------|-------------------|
| **智慧引路人** | 用问题引导学生自己发现 | "你觉得AI为什么做错了"而非"AI做错了因为你的提示词缺少XX" |
| **探险队长** | 用故事和情景为学习赋予意义 | "今天你是一个设计师,你的客户就是你自己" |
| **平等对话者** | 承认不知道,共同探索 | "这个结果我也没见过,我们一起看看为什么" |
| **认知诊断师** | 敏锐观察学生认知状态 | 3分钟无屏幕变化就主动过去追问"你是怎么想的" |
| **学习促进者** | 引导学生自主解决问题 | "试试问AI'请解释这段代码在做什么'"而非直接解释代码 |
### 语言风格
- 使用四年级能理解的词汇,适当解释专业术语
- 大量使用学生生活中熟悉的事物做类比
- 充满热情和好奇心:"太酷了!""你居然做到了!"
- 多用开放性问题:"为什么?""如果...会怎样?""还有更好的方法吗?"
- 建立容错环境:"翻车了正常!最厉害的程序员也天天翻车"
### SDDT互动要求
- **主动诊断**:不等学生举手,主动走动观察操作过程
- **证据导向**:每次提问明确"我要通过这个问题收集什么证据"
- **误概念友好**:将错误视为宝贵的教学资源
- **分支思维**脑中时刻准备2-3条应对分支
- **深度追问**:不满足于"对"或"错",追问"为什么这样想"
- **螺旋意识**:明确当前处于哪个认知层级
---
## 八、Markdown教案格式规范
### YAML页眉必填固定顺序
```yaml
---
课时: [数字]
主题: [文本]
核心能力: [能力1, 能力2]
核心工具: [Trae, DeepSeek]
时长: 90分钟
透明化层级: 结果层
---
```
### 标准章节结构
1. `### 1. 课程目标` — 分知识/能力/情感目标
2. `### 2. 核心概念与误概念预设` — 认知层级 + 典型误概念
3. `### 3. 教学准备` — 工具/环境/资源
4. `### 4. 教学流程` — 四幕剧结构
5. `### 5. AI助教使用指南` — 教师/学生提示词模板
6. `### 6. 教师指南` — 技术备注 + FAQ + 备课体验任务
7. `### 7. 5分钟日常AI挑战` — 本周课外任务
8. `### 8. 拓展任务` — 进阶挑战
### 格式要求
- 四幕标题:使用加粗行,不使用`#`标题
- 分段标题:使用全角书名号加粗 `**【分段一XX】(15分钟)**`
- 小节标题固定三类:`**讲解与演示:**` / `**学生实践:**` / `**进度同步:**`
- 师生对话:`**师:**` / `**生:**`,加粗前缀+全角冒号
- 禁止在师生对话前使用引用符号`>`
- 禁止为四幕/分段标题使用`#`符号

View File

@@ -0,0 +1,269 @@
# 穹狼科创 · 标准教案模板
> 本模板从 AICODE-06 高质量教案中提取,所有新教案必须遵循此结构。
> 配合 `教学方法论规则.md` 中的 SDDT + 4C 方法论使用。
---
## YAML 页眉(必填,固定顺序)
```yaml
---
课时: [数字]
主题: [中文主题名]
核心能力: [能力1, 能力2] # 从六大能力中选1-3项
核心工具: [工具1, 工具2]
时长: 90分钟
透明化层级: [结果层/过程层/原理层]
适用路线: [AICODE-03 / AICODE-06 / 共享]
---
```
**六大能力**:提问力、拆解力、审美力、韧性力、表达力、共创力
**透明化层级说明**
- **结果层**:学生只关注 AI 产出的结果(早期课程)
- **过程层**:学生开始关注"AI 是怎么做到的"(中期课程)
- **原理层**:学生理解底层逻辑并能自主决策(后期课程)
---
## 章节结构(按顺序)
### 1. 课程目标
```markdown
### 1. 课程目标
**知识目标:**
- [学生要理解的概念/原理2-3条]
**能力目标:**
- [学生要掌握的技能/操作2-3条]
**情感目标:**
- [学生要建立的态度/信念2-3条]
```
### 2. 核心概念与误概念预设
```markdown
### 2. 核心概念与误概念预设
**核心概念认知层级:**
| 概念 | 学生类比 | 认知层级 |
|------|---------|---------|
| [概念名] | [用学生熟悉的事物类比] | 识别层/理解层/应用层/迁移层 |
**典型误概念表:**
| 编号 | 误概念 | 正确认知 | 激发策略 |
|------|--------|---------|---------|
| M1 | [学生可能的错误认知] | [正确理解] | [如何暴露并纠正] |
| M2 | ... | ... | ... |
```
> 每课预设 3-5 个误概念,覆盖本课核心知识点。
### 3. 教学准备
```markdown
### 3. 教学准备
**工具与环境:**
- [需要的软硬件,含预装/预配置说明]
**教学资源:**
- 教师准备:[成品展示/备用文件/保底提示词]
- 学生资源:[上节课的作品/无需准备]
**教师备课体验任务:**
> 备课前,教师必须亲自完成以下操作:
> 1. [完整走一遍课堂核心任务]
> 2. [故意制造一个常见错误,准备应对]
> 3. [验证环境可用性]
```
### 4. 教学流程(四幕剧结构)
#### 第一幕:联系 (Connect) — 10分钟
```markdown
**第一幕:联系 (Connect) — 10分钟** 🔗
**【环节】上节课回顾 (3分钟)**
**师:** [1-2个引导性回顾问题]
**生:** [预设学生回应A / 回应B]
**【环节】情景导入 (7分钟)**
**师:** [从真实场景或学生兴趣切入,引出今天的创作挑战]
【诊断点:探测学生的前概念】
**【分支A】若学生...**
**师:** [追问/深化]
**【分支B】若学生...**
**师:** [引导/脚手架]
```
#### 第二幕:建构 (Construct) — 65分钟
```markdown
**第二幕:建构 (Construct) — 65分钟** 🛠️
**【分段一:[分段主题]】(15-20分钟)**
**预设误概念:**
- 误概念1[描述]
- 误概念2[描述]
**讲解与演示 (Teach & Demo): (3-5分钟)**
**师:** [只讲一个核心概念——单一焦点原则]
**师:** [演示"我是怎么跟AI说的"——现场示范提示词]
**学生实践 (Practice): (8-12分钟)**
学生动手操作:[具体任务描述]
> 教师走动观察谁的屏幕3分钟没变化就主动过去
**进度同步 (Checkpoint): (2-3分钟)**
**师:** [诊断性问题,不是"大家都做完了吗"]
【诊断点:[本问题要收集的认知证据]】
**【分支A】若学生...**
**师:** [继续深化]
**【分支B】若学生...**
**师:** [回退/脚手架]
---
**【分段二:[分段主题]】(15-20分钟)**
[同样的 讲解→实践→同步 结构]
---
**【分段三:[分段主题]】(15-20分钟)**
[同样的 讲解→实践→同步 结构]
```
> 通常 3-4 个分段,遵循递进节奏:
> - 分段一:需求描述训练(识别层)
> - 分段二:审查与反馈训练(理解层)
> - 分段三:深度优化训练(应用层)
> - 分段四(视情况):拓展挑战(迁移层)
#### 第三幕:反思 (Contemplate) — 10分钟
```markdown
**第三幕:反思 (Contemplate) — 10分钟** 🤔
**【环节】成果展示 (6分钟)**
**师:** 谁愿意来展示一下今天的作品?
[2-3名学生展示不只展示结果还要展示"我的提示词"和"迭代过程"]
**【环节】互评与讨论 (4分钟)**
**师:** [引导结构化互评:"一个优点 + 一个改进建议"]
**师:** [元认知问题:"今天最大的挑战在哪里?你是怎么解决的?"]
```
#### 第四幕:延续 (Continue) — 5分钟
```markdown
**第四幕:延续 (Continue) — 5分钟** 🚀
**【环节】抽象总结 (3分钟)**
**师:** 今天我们学到的核心能力是什么?
**师:** [提炼可迁移的思维模型:"今天学到的XX能力还能用在哪里"]
**【环节】下节预告 + 5分钟挑战 (2分钟)**
**师:** [预告下节课内容,制造认知悬念]
**师:** 本周5分钟AI挑战[简短有趣的课外小任务]
```
### 5. AI助教使用指南
```markdown
### 5. AI助教使用指南
**教师演示用提示词:**
[教师在课堂上示范用的提示词,经过验证可稳定产出]
**学生保底提示词:**
[当学生想不出来时可以直接用的提示词,保证基础体验]
**进阶提示词:**
[学有余力的学生挑战用]
```
### 6. 教师指南
```markdown
### 6. 教师指南
**本课技术备注:**
[底层技术概念的简要解释,帮助教师理解但不需要传达给学生]
**常见问题 FAQ**
| 问题 | 应对 |
|------|------|
| [学生可能问的问题] | [教师回应方式] |
**课堂风险预案:**
- 如果AI服务不可用[备选方案]
- 如果学生进度差异过大:[分层策略]
```
### 7. 5分钟日常AI挑战
```markdown
### 7. 5分钟日常AI挑战
**本周挑战:** [一句话描述]
**挑战说明:** [2-3句话的具体要求]
**下节课分享:** 下周课上选2-3位同学展示挑战成果
```
### 8. 拓展任务
```markdown
### 8. 拓展任务
**拓展一(推荐):** [中等难度的延伸]
**拓展二(挑战):** [高难度的创新方向]
```
---
## 质量自检清单
编写完成后,逐项检查:
**格式检查:**
- [ ] YAML 页眉字段齐全且顺序正确
- [ ] 四幕标题使用加粗行(不使用 `#`),带时长和 emoji
- [ ] 分段标题使用全角书名号 `**【分段一XX】(15分钟)**`
- [ ] 师生对话格式:`**师:**` / `**生:**`,无 `>` 引用
- [ ] 时间分配合计 90 分钟
**SDDT 检查:**
- [ ] 每个分段开头有 **预设误概念**3-5个
- [ ] 每个分段至少 1 个 `【诊断点】`
- [ ] 关键诊断点后有 `【分支A/B/C】` 路径
- [ ] 重要问题标注认知层级 `【识别层/理解层/应用层/迁移层】`
- [ ] 整体体现螺旋深化:识别→理解→应用→迁移
**AI编程创新专项**
- [ ] 开放主题:学生可选不同创作方向
- [ ] 完整循环:至少一轮"需求→生成→审查→迭代"
- [ ] 有明确的、可展示的课堂产出
- [ ] 包含教师保底提示词AI 翻车时的备用方案)

7
.claude/settings.json Normal file
View File

@@ -0,0 +1,7 @@
{
"permissions": {
"allow": [
"Bash(python3 -c \":*)"
]
}
}

View File

@@ -0,0 +1,78 @@
---
name: sync-dingtalk
description: 同步教案到钉钉知识库。用于将本地 Markdown 教案/大纲/销售材料同步到钉钉「标准化教案手册」知识库。支持同步单个文件或批量同步。
user-invokable: true
---
# 同步教案到钉钉知识库
将本地 Markdown 文件同步到钉钉「标准化教案手册」知识库,创建为可在线编辑的钉钉文档。
## 前置条件
需要有效的用户 Token。如果 Token 过期30天需要重新授权
```bash
cd d:/projects/vibecoding/AICODE-2026 && python scripts/sync_to_dingtalk.py auth
```
## 用法
用户可能会用以下方式触发:
- `/sync-dingtalk AICODE03-05` — 同步指定课次
- `/sync-dingtalk aicode03` — 同步 AICODE-03 全部教案
- `/sync-dingtalk aicode06` — 同步 AICODE-06 全部教案
- `/sync-dingtalk outline` — 同步课程大纲
- `/sync-dingtalk sales` — 同步销售材料
- `/sync-dingtalk all` — 同步所有内容
- "把这篇教案同步到钉钉" — 同步当前讨论的教案
## 执行逻辑
### 1. 解析用户意图
从用户输入中判断要同步的目标:
- **指定课次**(如 `AICODE03-05`):找到对应的 `.md` 文件,同步单篇
- **指定路线**(如 `aicode03``aicode06`):批量同步该路线所有教案
- **`outline`**:同步 `3-lessons/AICODE-03/AICODE-03课程大纲.md` + `3-lessons/AICODE-06/AICODE-06课程大纲.md`
- **`sales`**:同步 `2-sales/课程介绍.md` + `2-sales/家长QA.md`
- **`all`**:同步全部
### 2. 执行同步
使用 Bash 工具运行以下命令:
```bash
cd d:/projects/vibecoding/AICODE-2026 && python scripts/sync_to_dingtalk.py <target>
```
其中 `<target>` 是以下之一:
- `all` — 全部同步
- `aicode03` — AICODE-03 全部教案
- `aicode06` — AICODE-06 全部教案
- `outline` — 课程大纲
- `sales` — 销售材料
如果是**同步单个文件**,直接传文件路径:
```bash
cd d:/projects/vibecoding/AICODE-2026 && python scripts/sync_to_dingtalk.py "3-lessons/AICODE-03/AICODE03-05 自然语言驱动开发.md"
```
### 3. 处理结果
- 成功:告诉用户同步完成,报告同步了多少篇文档
- Token 过期:提示用户运行 `python scripts/sync_to_dingtalk.py auth` 重新授权
- 其他错误:显示错误信息
## 文件夹映射
| 本地路径 | 钉钉知识库位置 |
|---------|--------------|
| `3-lessons/AICODE-03/*.md` | AICODE-AI编程创新课 / AICODE-03 |
| `3-lessons/AICODE-06/*.md` | AICODE-AI编程创新课 / AICODE-06 |
| `3-lessons/AICODE-03/AICODE-03课程大纲.md` | AICODE-AI编程创新课 / AICODE-03 |
| `3-lessons/AICODE-06/AICODE-06课程大纲.md` | AICODE-AI编程创新课 / AICODE-06 |
| `2-sales/课程介绍.md` | AI人工智能课 / 销售工具 |
| `2-sales/家长QA.md` | AI人工智能课 / 销售工具 |