1. 为什么要在一个 AI 编程工具上做“Excel 转 Markdown”
1.1 一个反复出现的小麻烦
我平时写技术文档、维护个人知识库、帮团队整理发布内容,最常遇到的一个操作就是:把 Excel 里的表格挪到 Markdown 编辑器里用。
这个动作听起来简单,实际做起来相当烦人。Excel 本身没有“导出为 Markdown”的选项,网上虽然有在线转换工具,但表格一长、列数一多,格式就出问题,而把数据传到第三方网站上,数据安全和隐私也是个隐患。更别提有些内部数据压根不应该出现在在线服务上。
我想要的其实是一个很朴素的能力:拷贝 Excel 表格,粘贴到一个工具里,拿到符合 Markdown 语法的表格,然后直接粘到文档中用。整个过程应该在本地完成,不经过任何外部服务器,几秒钟结束,没有多余的注册和网页等待。这个需求我惦记了很久,一直懒得专门写代码。
后来我开始认真用 Trae,画风就变了。
1.2 为什么是 Trae 而不是 Visual Studio Code 加插件
Trae 是一款免费的 AI 编程工具,核心卖点是你用自然语言描述需求,它帮你生成、修改、运行代码。它不像纯聊天机器人那样停留在“输出代码片段”的层面,而是内置了完整的项目工作区,可以读文件、改文件、执行终端命令、装依赖库,完整体现了“你说需求,它写代码”的闭环。
对比一下:早期我用 VS Code 写类似的小工具,要自己建项目、装 Python 环境、处理依赖、调试语法错误,一套流程下来少说一小时。用 Trae 的话,大多数代码工作被 AI 直接承接了,我做的更多是“提需求”和“验收结果”,效率不在一个维度上。
我当时给这个系列起了个名字叫“言出法随”,意思是:你像对搭档说话一样把自己的意图说出来,靠谱的代码就出现了。听起来有点玄学,但因为它是免费的,并且确实能用,我就开始了第一个实战项目——Excel 复制内容转 Markdown。
1.3 项目目标与功能范围
在开始之前,我先把需求边界想清楚:
- 核心功能:从 Excel 复制内容后,将其转换为 Markdown 表格,再复制回剪贴板。
- 使用方式:最好是图形界面,或者系统托盘小工具,不应该要求用户打开命令行。
- 运行环境:Windows 为主,能打包成独立 exe 最好。
- 不做什么:不打算做完整的 Excel 文件解析,不做复杂格式转换,不做在线同步。
这些边界对和 AI 对话很重要。AI 在没有约束的时候容易把范围越做越大,你只想要一个开瓶器,它可能连整个厨房都给你包了。提前定义需求和非目标,能让整个开发过程更快。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 跟 Trae 对话:第一版脚本的完整诞生过程
2.1 环境准备与第一印象
Trae 的安装没什么可多说的,官网下载对应系统的版本,安装完打开就是一个类似 VS Code 的界面。有一点体验很好:它默认帮我配好了 Python 和 Node 相关的开发环境检测,不需要我先去装一堆插件。
我当时的新建项目步骤是这样的:
- 打开 Trae,选择“新建项目”,选择 Python 作为基础语言。
- 项目目录建好后,在 Trae 的对话窗口里开始描述需求。
- 直接说“帮我写一个 Python 脚本,读取剪贴板中的 Excel 表格内容,转换为 Markdown 表格”。
Trae 很快就生成了一版代码。它不是那种简单的一句代码,而是带注释、带函数拆分的完整脚本。
2.2 第一条提示词,我是怎么写的
很多人和 AI 编程工具配合的第一道坎,是不会提需求。提得含糊,拿到的代码就含糊。我第一条提示词是这样的:
code复制你的角色是 Python 桌面开发专家。请帮我写一个 Windows 桌面小工具:
1. 用户从 Excel 复制一段表格内容后,运行这个工具;
2. 工具读取 Windows 剪贴板中的文本;
3. 如果能识别出表格结构(多行多列,列之间用制表符分隔),就转换成 Markdown 表格;
4. 转换结果自动写回剪贴板,并在界面提示成功;
5. 如果剪贴板中没有内容或不是表格结构,给出清晰提示。
技术选型不限,但平台要 Windows,尽量少依赖第三方库。
你会发现我在这段提示词里做了几件事:
- 给了角色定义,告诉 AI 它应该以什么身份来写代码。
- 列出了完整的用户使用流程,而不是只描述功能。
- 明确指定了数据来源是剪贴板,以及数据的特征(制表符分隔)。
- 要求结果自动回填剪贴板,并提示用户。
- 限定了技术平台和依赖程度。
这些约束条件会让 AI 的输出质量明显提高,因为它的可选范围被收窄了,生成的东西更贴近实际使用。
2.3 Trae 生成的第一版代码及分析
第一版代码出来之后,我仔细看了一遍。整体结构是:
- 用
