的完整搭建过程：功能设计、动手前必须知道的微信硬约束、架构选型、数据模型和交互细节。

系列共三篇：① 搭建篇（本篇）→ ② 

（RLS 无限递归、串数据、thenable 陷阱）→ ③ 

（生成卡死 60 秒的根因与解法）。

：7 个页面、6 张数据表、27 条权限策略，全部在真机跑通。

二、动手前必须知道的 5 条微信硬约束

这一节最省时间。我是在写完全部代码、真机报错之后才逐个撞上的。

——你设了 120 秒，它默默给你用 60 秒，你以为改了，其实没改。这个约束直接决定了后面 AI 生成的整套架构（系列第三篇细讲）。

第 4 条的降级方案：我最终没做真人语音，改成

（按句拆分 + 每句计时 8–12 秒 + 中文对照）。对训练其实也有效，只是少了语音示范。

三、架构：为什么不用自建后端

。没有后端就等于「关掉小程序数据全没」。

但为了一个自用小程序去买服务器、配数据库、申请 API Key，成本太高。WorkBuddy 的托管云服务正好覆盖四块能力：

// utils/cloud-config.js —— 开通后平台会给你这两个值
module.exports = {
  endpoint: '<你的 endpoint>',
  publishableKey: '<你的 publishableKey>',
}

// utils/cloud.js
const { createMiniProgramWorkBuddyCloud } = require('@tencent-ai/workbuddy-cloud-sdk/miniprogram')
const { endpoint, publishableKey } = require('./cloud-config')

const cloud = createMiniProgramWorkBuddyCloud({ endpoint, publishableKey, wx })

module.exports = { cloud }

npm install @tencent-ai/workbuddy-cloud-sdk@dev

设计上有一个关键决定：每张表都带 

owner_id TEXT NOT NULL DEFAULT auth.uid()

这一行省掉了大量代码 —— 配合 RLS 的 

 策略，插入时不用手动填 owner，查询时也不用手动过滤，

数据库层保证你只能看到自己的数据

-- 用户档案
CREATE TABLE profiles (
  id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
  owner_id TEXT NOT NULL DEFAULT auth.uid(),
  nickname TEXT NOT NULL DEFAULT '学习者',
  track TEXT NOT NULL DEFAULT 'daily',        -- 学习类型
  daily_goal INTEGER NOT NULL DEFAULT 20,
  onboarded BOOLEAN NOT NULL DEFAULT false,
  created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);

-- 个人词库（间隔重复的核心表）
CREATE TABLE vocab_items (
  id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
  owner_id TEXT NOT NULL DEFAULT auth.uid(),
  track TEXT NOT NULL DEFAULT 'daily',
  word TEXT NOT NULL,
  phonetic TEXT, pos TEXT, meaning TEXT NOT NULL,
  example_en TEXT, example_zh TEXT,
  status TEXT NOT NULL DEFAULT 'new',         -- new / learning / mastered
  ease NUMERIC NOT NULL DEFAULT 2.5,
  interval_days INTEGER NOT NULL DEFAULT 0,   -- 间隔重复天数
  reps INTEGER NOT NULL DEFAULT 0,
  lapses INTEGER NOT NULL DEFAULT 0,          -- 遗忘次数
  due_date DATE NOT NULL DEFAULT CURRENT_DATE,
  last_result TEXT,                           -- known / fuzzy / unknown
  last_reviewed_at DATE,                      -- 最近一次学习日期（支撑按日期回看）
  broken BOOLEAN NOT NULL DEFAULT false,
  created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);

-- 每日阅读短文
CREATE TABLE reading_passages (
  id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
  owner_id TEXT NOT NULL DEFAULT auth.uid(),
  track TEXT NOT NULL DEFAULT 'daily',
  topic TEXT, title TEXT NOT NULL,
  content_en TEXT NOT NULL, content_zh TEXT,
  notes JSONB NOT NULL DEFAULT '[]'::jsonb,     -- 生词注释
  questions JSONB NOT NULL DEFAULT '[]'::jsonb, -- 理解题
  word_count INTEGER NOT NULL DEFAULT 0,
  passed BOOLEAN NOT NULL DEFAULT false,
  study_date DATE NOT NULL DEFAULT CURRENT_DATE,
  created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);

-- 打卡
CREATE TABLE checkins (
  id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
  owner_id TEXT NOT NULL DEFAULT auth.uid(),
  study_date DATE NOT NULL DEFAULT CURRENT_DATE,
  words_done INTEGER NOT NULL DEFAULT 0,
  words_goal INTEGER NOT NULL DEFAULT 20,
  reading_done BOOLEAN NOT NULL DEFAULT false,
  is_complete BOOLEAN NOT NULL DEFAULT false,
  streak INTEGER NOT NULL DEFAULT 0,
  created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);

-- 学习圈子 / 圈成员
CREATE TABLE study_groups (
  id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
  owner_id TEXT NOT NULL DEFAULT auth.uid(),
  name TEXT NOT NULL,
  invite_code TEXT NOT NULL UNIQUE,
  created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);

CREATE TABLE group_members (
  id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
  owner_id TEXT NOT NULL DEFAULT auth.uid(),
  group_id BIGINT NOT NULL,
  nickname TEXT NOT NULL DEFAULT '',
  joined_at TIMESTAMPTZ NOT NULL DEFAULT now()
);

唯一索引是防重复词的最后一道防线

sCREATE UNIQUE INDEX profiles_owner_idx  ON profiles (owner_id);
CREATE UNIQUE INDEX vocab_user_word_idx ON vocab_items (owner_id, lower(word));
CREATE UNIQUE INDEX checkins_owner_date_idx ON checkins (owner_id, study_date);
CREATE UNIQUE INDEX group_members_unique_idx ON group_members (group_id, owner_id);
CREATE INDEX vocab_due_idx ON vocab_items (owner_id, due_date);
CREATE INDEX vocab_reviewed_idx ON vocab_items (owner_id, last_reviewed_at);

技术之外，有几处体验设计值得单独说。

：打开小程序看打卡墙的同时，单词已经在后台生成了。两边加 60 秒去重，避免预热和点进单词页重复生成、撞出重复词。

：不要让用户干等。「正在生成单词 8/20」「网络较慢，第 1 次重试…」「已生成 5 个，先开始学习」—— 有反馈就不焦虑。

：整轮设 100 秒总预算，超时就用已经生成的词开工；哪怕只生成 5 个，也提示后直接进入学习。

（很容易被忽略）：当天目标完成后，用户再进单词页如果看到「暂时没有可学习的单词」，就什么都做不了了。应该落到

，上面显示「今日已学 20 / 20」，下面给三个出口：

 一辈子只跑一次，切回来会残留上次状态。但

 —— 用户点进「复习」或「按日期回看」再切个 tab 回来就会被打断重来。正确做法是只在「空状态」时重跑，「完成态」只静默刷新数字。

english-daily-miniprogram/
├── app.js / app.json / app.wxss
├── utils/
│   ├── cloud-config.js      # endpoint + publishableKey
│   ├── cloud.js             # SDK 初始化
│   ├── api.js               # 全部数据访问 + AI 调用（核心）
│   └── nav.js               # 路由统一收口
├── pages/
│   ├── index/               # 今日
│   ├── words/               # 单词（学习 / 复习 / 加量 / 按日期回看）
│   ├── reading/             # 阅读列表
│   ├── reading-detail/      # 短文详情 + 跟读 + 理解题
│   ├── mine/                # 我的
│   ├── onboarding/          # 首次引导
│   └── group/               # 学习圈子
└── images/logo.png

本篇讲从零到真机跑通的完整搭建过程：功能设计、动手前必须知道的微信硬约束、架构选型、数据模型和交互细节。

WorkBuddy 实战（一）：不写后端、不申请 API Key，从零做一个带 AI 的英语打卡小程序

不用买服务器、不用申请大模型 API Key，用 WorkBuddy 托管云服务 + 微信小程序，我搭出了一个会自己出题、自己判卷、还能和家人互相监督打卡的英语学习小程序。本篇讲完整搭建过程：动手前必须知道的 5 条微信硬约束（其中 3 条没有官方解法）、架构选型、6 张表的数据模型设计，以及几个容易被忽略的体验细节。

编程语言

一篇微信小程序英语学习工具从零到真机跑通的完整搭建指南。涵盖单词、阅读、打卡、亲友圈子四大功能，解析5条关键微信硬约束，提供不自建后端的云端架构方案与6张数据表设计。内含7个页面、27条权限策略及防超时、防重复词的实战细节，适合个人开发者快速落地同类项目。

语音合成

WorkBuddy 

数据库

服务器

路由

JSON

WorkBuddy企业版限时双倍 Credits 活动

workbuddy

2026上云采购 | AI焕新·智启新局

热销域名限时优惠，新客首年免费！


domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

WorkBuddy 实战（一）：不写后端、不申请 API Key，从零做一个带 AI 的英语打卡小程序

WorkBuddy 实战（一）：不写后端、不申请 API Key，从零做一个带 AI 的英语打卡小程序

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐