Skip to content

07 · 零代码做一个本地小应用 ​

速览 ​

解决什么想要一个趁手的小工具,但没有现成的,也不会写代码
需要什么「代码开发」模式;一个空文件夹
大概多久最小可用版本 5–10 分钟;调试和迭代看复杂度
风险等级中——会生成并运行代码

场景 ​

你想要一个记录灵感的小工具:能新增、能搜、能分类,界面简洁,数据存本地。

市面上的笔记软件不是太重就是要订阅,而你要的功能其实只有四个。

开始前的准备 ​

  1. 新建一个空文件夹当工作空间,例如 我的小工具
  2. 新建任务时选**「代码开发」模式**——它面向代码场景,默认配置更合适
  3. 权限保持「默认权限」

用空文件夹

生成代码会往目录里写不少文件。放在空目录里,出问题直接删整个文件夹重来,不会牵连别的东西。

提示词 ​

第一轮:最小可用版本 ​

text
帮我做一个本地可运行的灵感记录小工具。

功能就四个:
1. 新增一条记录(标题 + 正文 + 标签)
2. 按关键词搜索
3. 按标签筛选
4. 编辑和删除

要求:
- 单页应用,双击 HTML 就能打开,不需要装任何东西
- 数据存在浏览器本地,关掉再打开还在
- 界面简洁,浅色,适合长时间看
- 手机上也能用

先做这四个功能,跑起来再说。不要加其他功能。

「先做最小可用版本」是这个案例的核心

官方建议的原话:先完成核心功能,再逐步增加复杂能力。

一次要十个功能,结果是十个都半残,而且你没法判断是哪里出的问题。四个功能跑通了,加第五个就很容易。

第二轮:确认能跑 ​

生成完之后,在右侧「浏览器」视图里打开预览。挨个点一遍那四个功能。

第三轮:报错怎么说 ​

text
点保存按钮后页面白屏,控制台提示 TypeError: Cannot read properties of null。

复现步骤:
1. 点「新增」
2. 标题填「测试」,正文留空
3. 点保存

正文填了内容的时候不会出错。

描述具体现象比说「不好使」有效十倍。 三个要素:

  • 现象——具体看到了什么(白屏、报错文字、按钮没反应)
  • 复现步骤——怎么操作会出现
  • 边界——什么情况下正常,什么情况下不正常

第三条最有价值。「正文填了就不出错」直接把问题范围缩小到了空值处理。

善用截图

报错界面、控制台信息、日志截图都能帮它定位问题。Ctrl / Cmd + V 直接粘贴到对话框。

前提是当前模型支持图片输入,见 模型清单。

为什么这么写 ​

「双击 HTML 就能打开,不需要装任何东西」。 这一句决定了技术选型。不说的话,它可能给你一个需要 npm install 和 node server.js 的项目——对不写代码的人来说那就是不可用。

「数据存在浏览器本地」。 明确了持久化方式。不说的话可能刷新就没了。

「先做这四个功能,不要加其他功能」。 模型有强烈的加功能倾向。不禁止的话,你会拿到一个带标签云、导出、主题切换、快捷键的版本,然后其中三个是坏的。

「跑起来再说」。 给它一个明确的完成标准:能跑 > 功能全。

验收清单 ​

  • [ ] 双击文件能打开,不需要任何额外步骤
  • [ ] 四个功能挨个试一遍都正常
  • [ ] 关掉浏览器再打开,数据还在
  • [ ] 手机上打开,布局没乱
  • [ ] 输入空值、超长文本、特殊字符,不会崩
  • [ ] 右侧「变更」视图里看得懂它生成了哪些文件

试试异常输入

标题留空、正文粘 5000 字、标签里输入 <script>——AI 生成的代码在正常路径上通常没问题,翻车都在边界情况。

花两分钟试这几个,比上线后再修省事。

持续升级 ​

工具跑起来之后,可以在使用中持续扩展。官方给的几个方向:

需求它可能怎么做
希望支持模糊搜索,不依赖精确关键词接入本地向量或语义检索能力
每天早上自动推送待处理任务配置自动化任务并汇总待办
通过 QQ 或微信随时录入内容对接消息平台并增加移动端输入通道
新增内容时自动关联已有记录增加关联分析与知识整理能力

一次只加一类能力

「把升级需求拆开提」——一次只增加一类能力,更利于稳定迭代。

同时提三个需求,改坏了你分不清是哪个改动导致的。

升级时的写法:

text
现在加一个功能:导出。

支持导出成 Markdown 和 CSV 两种格式,
导出当前筛选结果(不是全部)。

只加这一个,别动其他地方。

最后那句很有用——明确划定改动范围,减少它顺手「优化」别的地方的概率。

变体 ​

从设计稿开始 ​

走「设计创意」模式:先对话生成界面设计稿,在 Ardot 画布上改到满意,然后一键生成应用代码。

两种触发方式:在对话中说「将当前画布中的设计稿生成应用」,或点画布 Tab 顶部的「生成应用」按钮。

生成后还能继续用对话调代码:「用 React 重写」「加一个 dark mode」「改成 Tailwind 样式」。

这条路适合你对界面有明确要求的时候。 直接写提示词生成的界面通常能用但不惊艳。

数据存在文件里而不是浏览器 ​

text
改一下数据存储:不用浏览器本地存储,
改成读写工作空间里的 data.csv。

这样我能直接用 Excel 打开看,也方便备份。

这个改动让工具和 资料库的 CSV 数据源思路 接上了——数据和界面分离,改数据不用碰代码。

一个纯本地的小脚本 ​

不需要界面的话,让它写脚本:

text
写一个脚本,扫描 D:/照片 目录下所有图片,
按 EXIF 拍摄日期整理到 YYYY-MM 子文件夹。

要求:
- 先 dry-run 输出计划,不实际移动
- 加 --execute 参数才真的执行
- 遇到没有 EXIF 的文件跳过并记录
- 每一步打印日志

dry-run 这个设计值得学:让脚本自带预览模式,和 批量重命名案例 里「先预览后执行」是同一个思路,只不过固化进了代码。

常见问题 ​

Q:生成的代码我看不懂,安全吗?

对纯前端单页应用(HTML + JS,数据存浏览器)来说,风险很低——它跑在浏览器沙箱里。

需要警惕的是会跑在你系统上的脚本:Python、PowerShell、Shell。这类先让它解释:

text
把这个脚本每一行在做什么解释一遍,
特别标出:会读哪些文件、会写哪些文件、会不会联网、会不会删东西。

看不明白就别执行。这也是默认权限会在执行脚本前拦你一下的原因。

Q:改着改着越改越坏怎么办?

两个办法:

  1. 开新任务重来。 会话太长之后模型容易「前说后忘」,与其在烂上下文里死磕,不如开新任务,把当前代码和需求重新说一遍
  2. 让它先备份。 改之前先把当前版本复制成 index-v1.html

Q:能做成真正的桌面软件吗?

能生成 Electron 之类的项目,但打包、签名、分发这些超出了「零代码」的范畴。

如果你的目标是自己用,单页 HTML 就够了,而且没有任何分发和更新的麻烦。

Q:这些工具能给同事用吗?

单页 HTML 直接发文件就行,数据各存各的。需要共享数据的话,考虑用 资料库的轻量发布——把 HTML 发布成在线链接,配合 CSV 做数据源。

下一步 ​

08 把重复流程沉淀成 Skill

非官方社区教程 · 内容整理自 WorkBuddy 公开文档与实测记录 · 以官方最新说明为准