项目怎么读取和输出文件？

07-01 项目怎么读取和输出文件？

课程定位

这一课进入「数据、文件和隐私」。很多实用小工具都会碰到文件：读取表格、整理名单、导出结果、批量处理文件名。

本课先讲文件型小工具的基本流程：输入文件、处理规则、输出文件、保存位置、验收方式。

这一课的成果是一张「文件输入输出流程卡」。

本课目标

能理解文件型小工具的输入、处理、输出流程。
能把示例输入放进 inputs。
能把输出结果放进 outputs。
能说明处理规则。
能用小样本测试文件流程。

录制建议

建议时长：20 到 30 分钟。
用一个小 CSV 文件演示输入输出。
屏幕上同时展示 inputs 和 outputs 文件夹。
强调先用小样本，先看一条或三条数据。
收尾保存文件输入输出流程卡。

课前准备

主项目文件夹。
inputs 和 outputs 文件夹。
一份脱敏示例 CSV。
AI 工作台工具。
README。

讲稿正文

可以这样开场：

“很多真正有用的小工具，最后都会回到文件：我给它一个文件，它帮我处理，最后给我一个结果文件。”

文件型小工具有五个环节。

第一，输入文件。

输入文件放在 inputs。比如 sample.csv，里面是几行脱敏数据。第一版建议先用 3 到 5 行小样本。

第二，处理规则。

处理规则要写清楚。比如“读取 CSV 第一行作为表头”“把每行转成 Markdown 表格行”“空白行跳过”。

第三，输出文件。

输出结果放在 outputs。比如 result.md 或 cleaned.csv。输出位置固定，后面验收更方便。

第四，运行动作。

网页工具可能是点击按钮；脚本工具可能是在终端运行命令。运行方式要写进 README。

第五，验收方式。

验收要看输入和输出是否对应。比如输入 3 行，输出也应有 3 行；字段顺序要一致；结果能复制或打开。

用一个流程图讲：

inputs/sample.csv
        |
        v
处理规则：读取 -> 转换 -> 检查
        |
        v
outputs/result.md

最后收束：

“文件型项目不要一开始就上大文件。先用小样本走通流程，像先用一小杯水试管道，通了以后再接大桶。”

屏幕演示流程

打开项目文件夹。
在 inputs 放入 sample.csv。
让 AI 读取样例文件结构。
让 AI 复述处理规则。
运行或模拟转换。
查看 outputs 是否生成结果。
对照输入输出做验收。
更新 README 里的文件说明。
保存流程卡。

给 AI 的协作卡

我准备让项目处理文件。

输入文件位置：
【例如 inputs/sample.csv】

输出文件位置：
【例如 outputs/result.md】

处理规则：
【说明怎么处理输入】

请帮我检查：
1. 输入文件是否适合做小样本
2. 处理规则是否清楚
3. 输出文件应该是什么格式
4. 怎么用 3 到 5 行数据验收
5. README 需要补哪些说明

文件输入输出流程卡

输入文件：
输入格式：
样例数据行数：
处理规则：
输出文件：
输出格式：
验收方式：
README 是否更新：

课堂练习

让学员为自己的项目设计文件输入输出流程。

要求：

输入放进 inputs。
输出放进 outputs。
先用 3 到 5 行小样本。
写清处理规则和验收方式。

常见卡点

学员直接用大文件：先缩成小样本。
输入输出位置混乱：固定使用 inputs 和 outputs。
处理规则含糊：写成一条条动作。
输出文件打不开：检查格式、后缀和保存位置。

课后作业

完成主项目文件输入输出流程卡。

提交内容：

inputs 文件截图。
outputs 文件截图或预期说明。
文件输入输出流程卡。

课件页建议

第 1 页：文件型工具的三段路
第 2 页：输入、规则、输出
第 3 页：先用小样本试管道
第 4 页：固定 inputs 和 outputs
第 5 页：文件输入输出流程卡