Skip to content

AI 驱动开发

Pro 是为 AI 协作设计的自动化框架:页面是声明式 JSON,任务是普通 JavaScript。你几乎不用先学完整 API——空目录放一份 AGENT.md、描述需求,AI 就能写出可运行工程,跑不通再对照日志修。

准备工作

跑起来必须先有手机端 Pro。装好并开好开关即可,不必克隆示例工程。完整安装见 快速开始

安装手机端 Pro(必需)

扫码安装:

下载安装包

打开 Pro 侧边栏,按 快速开始 · 安装手机端 开启开关(无障碍、悬浮窗、开发模式等)。

你能交给 AI 做什么

能力说明
写界面pages/<id>/page.json + page.js
写脚本tasks/*.js、权限与无障碍流程
自动调试对照日志、编译错误继续改
自动修 Bug按官方约定改,避免发明不存在的 API

流程

  1. 完成准备工作
  2. 电脑上新建空目录。
  3. 根目录放一份 AGENT.md(见下一节)。
  4. 用自然语言描述:有哪些页、主题色、参数、任务怎么跑。
  5. AI 生成后同步到手机,在 Pro 上运行预览。
  6. 跑不通就把日志、报错和节点信息贴回对话,让 AI 继续修。

AGENT.md 写什么

根目录新建 AGENT.md,告诉 AI 按官方约定写代码。可先粘贴:

md
# 本项目:按 DeekeScript Pro 约定编写

规格仓库:

- 国内镜像(优先):https://gitee.com/DeekeScript/DeekeScriptV2Agent.git
- GitHub:https://github.com/DeekeScript/DeekeScriptV2Agent.git

所有方法或对象都要符合该仓库约定,不要凭空创造。

## 第一步(必做,禁止跳过)

**禁止**用 WebFetch、curl、浏览器去 GitHub / Gitee **逐条**`AGENTS.md``INDEX.md` 或其它 md。一次任务会打几十个 HTTP,又慢又容易超时。

编写或修改任何代码前,必须先把规格仓库**整份弄到本机**,再读本地文件。落盘目录:`.deeke/DeekeScriptV2Agent/`(已 gitignore,不要提交)。具体命令自己选,只遵守下面规则:

1. **只使用 Gitee 与 GitHub**,不用第三方代理。Gitee 失败立刻改试 GitHub,不要停在超时上,也不要改成逐条拉取。
2. 本地已有该目录则先更新;没有则整仓取下。有 git 就 clone / pull;没有 git,或 git 失败,就下载 `main` 分支压缩包再解压。
3. 新 clone 成功后把 `origin` 指回 Gitee,后续更新走国内源。
4. zip 根目录名不固定,以包内 `AGENTS.md` 所在目录为准,整理到 `.deeke/DeekeScriptV2Agent/`
5. 两个源都失败则停下来让用户给本机路径,不要凭记忆发明 API 继续写代码。

之后只用 Read / Grep 打开该目录下的文件。`tools/deeke-device.sh` 也从这份本地副本复制或直接调用,不要再从远端单文件下载。

## 怎么读

1. 先读完本地规格仓库根目录 `AGENTS.md`(注意文件名多一个 S)。
2. 再读 `INDEX.md`,按当前任务只打开需要的篇。
3. 硬规则全文:`00-core/constraints.md`;落盘前自检:`04-cheatsheets/donts.md`
4. 搭工程优先抄 `03-recipes/` 里的最小可运行片段。

## 调试与修复

跑不通时:对照日志与上述约定继续改,不要另起一套写法。

可以这样描述需求

帮我做一个手机上的自动化工具,主色用蓝色,风格简洁正式。
需要登录、注册、首页和设置。
首页按「抖音」「小红书」等平台分入口。
每个功能开始前,让用户先填好参数并保存,再点开始运行。

先做「抖音自动点赞」:
打开抖音,在推荐页里一条一条自动点赞。
点赞条数、每条间隔几秒,在页面上可以自己填。
点赞失败或卡住时自动重试,并在界面上能看到运行状态。

或只说任务:

帮我做一个抖音自动点赞:
打开抖音 → 进推荐页 → 给当前视频点赞 → 上滑下一条 → 按我设好的次数循环。
点赞条数和间隔时间要能在设置里改。
按框架约定写好,跑不通就根据提示继续修。

接下来

同步和预览:VSCode 开发。页面字段:界面开发 · 概述。任务脚本:自动化脚本