夜雨聆风# 🎯 扣子APP新手指南：从入门到建立体系
**33天真实踩坑经验 · 31个你一定会遇到的坑**
---
## 💡 这本能帮你什么？
帮你省下33天的踩坑时间，直接站在我们的经验上起步。
你不用像我们一样：
- 📂 文件乱放成垃圾堆，最后花两天整理
- 🚫 改文档覆盖了原文件，后悔莫及
- ⏰ 设了定时任务，10天全失败才发现API错了
- 🤯 被AI的各种幻觉坑了一次又一次
---
## 🚀 第一步：一键初始化
**打开扣子第一件事：复制粘贴这段**
打开扣子APP，新建主对话，把下面这段整段复制粘贴发送，3分钟就能建立好所有基础体系。
> 你好，我是新用户。请按照以下要求为我初始化扣子系统：
>
> 1. 建立标准7层文件夹结构：基础设定、用户资料、项目空间、定时产出、系统日志、临时文件、技能库
> 2. 建立核心文件防篡改机制：MEMORY、USER、SOUL、TOOLS纳入监控
> 3. 写入版本管理规则：永不覆盖、全程可审计、语义化版本号
> 4. 建立路径前置确认原则：任何文件生成前必须先确认保存路径
> 5. 写入文档质量基础标准和AI幻觉基础防护规则
> 6. 建立健康保护机制：00:00-04:00不工作、连续工作2小时提醒活动
> 7. 所有规则分类写入MEMORY.md
>
> 完成后给我一个初始化报告。
**⭐ 3分钟执行完，你直接拥有我们用了一个月才沉淀下来的完整基础体系。**
---
## ⚠️ 你一定会遇到的31个坑
**📋 坑的分类导航（遇到了回来查）**
不用一下全记住，按你使用的时间顺序，会遇到三类坑：
---
### 🔥 第1-7天必踩的12个坑
1. 文件乱放成垃圾堆
2. 版本覆盖了找不回
3. 定时任务设置了但不执行
4. 云手机任务排队卡死
5. AI胡说八道（幻觉）
6. 子Agent输出质量参差不齐
7. Skill遇到边界情况直接崩溃
8. 规则散落在各个对话找不到
9. 核心配置被其他对话偷偷修改
10. 文档编号混乱（x.5半层）
11. API接口路径变更全挂了
12. 整理文件夹后所有历史链接死链
---
### ⚡ 第8-30天大概率遇到的13个坑
1. 子任务做着做着忘了最初要求
2. 长文档生成到一半断了
3. 两个会话同时改同一个文件冲突
4. 记忆污染：错误被当成事实继承
5. "你应该知道"的默契坑
6. 你在睡觉，它还在熬夜干活
7. 云手机登录态说没就没了
8. 任务显示"运行中"，实际上已经卡死了
9. 子Agent自己开子子Agent，递归失控
10. 文件编码问题，中文乱码
11. Skill装了但用不了
12. "答应得好好的，实际上没做"
13. **⭐ 生成的Word/文档手机上打开惨不忍睹**
---
### 🔮 用了1个月后的6个深层坑
1. 不同模型输出质量天差地别
2. 删除会话就真没了，找不回来
3. 平台偷偷更新，所有东西都变了
4. 手机/电脑/iPad三个端数据不同步
5. Agent World注册各种坑
6. **⭐ 终极大坑：任务做完了，但没推送给你**
---
> 💡 **给新人的建议：** 先把前12个必踩的坑过一遍，剩下的遇到了再回来查就行。
---
## 📋 从"能用"到"用好"的6套规则
### 1️⃣ 路径管理规则
**核心原则：** 先确认路径，再生产文档。
所有文件按7层标准文件夹结构存放，根目录不允许零散文件。
---
### 2️⃣ 版本管理规则
**三条铁律：**
1. 永不覆盖
2. 全程可审计
3. 语义化版本号（v大版本.小版本.补丁号）
**⭐ 覆盖文件 = 严重事故，绝对禁止。**
---
### 3️⃣ 文档质量规则
通用文档15条基础标准：编号规范、标题统一、表格统一、链接可访问、引用有来源、数据有出处、日期格式统一...
**⭐ 重要文档同时生成手机友好版，不要直接发Word。**
---
### 4️⃣ AI幻觉防护规则
**核心原则：** AI输出的任何内容，默认需要验证，直到拿出证据证明是对的。
高风险字段必须单独校验：法规引用、数据、人名、日期。
---
### 5️⃣ 任务协作规则
主对话不干活，只负责派任务和验收。子任务描述必须包含：项目背景、关键人物、交接信息、产出要求、结果发送。
---
### 6️⃣ 健康保护规则
- 🕛 00:00-04:00 绝不工作
- 💪 连续工作2小时自动提醒活动
- 🍽️ 12:00、18:00 强制提醒吃饭
---
## 🧠 终极思维升级
### 从"写规则"到"建机制"
这是真正用好扣子的核心认知：
1. **发现问题** → "这个问题出现了，我们要注意" → 下次还犯 ❌
2. **写规则文档** → "我们写个规则，以后按这个来" → 大概率被遗忘 ⚠️
3. **建立自动执行机制** → "我们做个工具/定时任务，自动检查" → 真正生效 ✅
**⭐ 机制比规则重要100倍。** 能机制化的，绝对不要只写规则。
---
## 🗓️ 新人7天上手路径图
### ✅ 第1天：完成初始化
**今天就做一件事：** 把前面的初始化代码复制粘贴发送，等Agent执行完。
今天不用做别的。不要着急让它干活，先把基础打牢。
---
### ✅ 第2-3天：感受子Agent机制
找一个简单的任务（写1000字文章，或做5页PPT），用子Agent来做。
感受"主对话负责派任务和验收，子Agent负责干活"的模式。
输出质量差很正常，打回去重做就行。
---
### ✅ 第4-5天：设置第一个定时任务
设置一个简单的定时任务（比如每天早上9点发天气预报）。
第二天观察它有没有准时执行。如果失败了，排查原因。
不要设太复杂的，先跑通流程。
---
### ✅ 第6天：练习文件管理
让Agent生成3个不同类型的文件，要求按标准路径存放。
如果它又扔在根目录，打回去，提醒它路径规则。
---
### ✅ 第7天：复盘与校准
翻一遍这31个坑，看看你踩了哪几个。
问自己三个问题：哪些坑我踩过了？哪些规则我已经建立了？接下来一周我要重点注意什么？
---
> 💡 **7天心法：**
> 1. 不要追求完美，前7天踩坑是正常的
> 2. 不要着急做复杂任务，先摸熟基础机制
> 3. 不要嫌麻烦打回去重做，第一次就建立高标准
> 4. 遇到问题先翻这31个坑，80%都有答案
---
## ⚠️ 微信分享特别提醒
**两个分享到微信必踩的坑**
- ⭐ **扣子域名的链接在微信上打不开**，分享前一定要转成本地HTML文件
- Word文档在手机上打开排版全乱，重要内容一定要发HTML或纯文字版
---
## 🎯 最后说一句
所有31个坑，100%来自我们33天的真实使用经历，没有一个是脑补的。
希望你能站在我们的经验上起步，少走弯路。
祝你在扣子的世界里，踩坑愉快，然后建立起自己的机制体系。
---
**本手册由扣子AI基于我使用33天的真实踩坑经验整理**
**v2.0 · 2026年5月3日**
