微信小程序
- 2026-11-23 06:09:52
小书生工具箱:用一个小程序,装下 AI 对话与土方压实度计算
原生微信小程序,四个主入口:首页、激活、小书书、我的。内置 AI 对话、土方实验计算、激活与个人中心框架,可作为工具类小程序的起步模板。

一、为什么做一个小程序
很多办公工具装在电脑里,但人经常不在电脑前。
工地上想快速估一下压实度,掏出手机比开电脑快;
临时想问 AI 一个问题,不想再打开网页、登录账号;
想给客户或同事一个轻量入口,不想让对方装插件;
想做一个自己的工具类小程序,却不想从零搭页面。
它不追求大而全,而是把AI 对话和土方实验计算这两个高频小场景放进一个微信小程序,同时把激活、个人中心、版本信息这些基础框架搭好,方便继续往外长。
二、项目定位
一句话:一个可运行、可扩展的微信小程序工具底座。
项目速览
四个主 Tab、完整的 AI 对话页、可用的土方计算页、本地消息持久化、长按复制与清屏,再加上激活页和个人中心的页面骨架,都已经在代码里跑起来了。
三、功能拆解
页面结构
data-page跳转 | ||

1. 首页:四个入口
首页是一段欢迎文案,加上四个按钮:首页、激活、小书书、我的。
按钮通过data-page区分跳转目标,结构简单,适合直接替换成自己的导航。
2. 小书书 AI:能记住上下文的对话页
pages/小书书Ai/Ai是项目里最完整的功能页。
对话能力
调用智谱 GLM 的 Chat Completions 接口;
默认模型
glm-4-plus;请求头携带 Bearer Token;
多轮消息按 role 组装,用户消息和助手消息都进入上下文。
拿到完整回复后,用
setInterval每 50ms 追加一个字符;视觉上是“逐字输出”,比一次性弹出整段更像真人对话;
输出完成后自动解除发送状态。
消息通过
wx.setStorageSync('messages', messages)存入本地;页面
onLoad时读回,退出小程序再进来,对话还在;清屏时
wx.removeStorageSync('messages')并清空视图。
长按某条消息,弹出悬浮菜单;
菜单位置会根据屏幕宽高做边界修正,避免超出屏幕;
支持复制当前消息,点击遮罩关闭菜单。
每条消息带时间戳,格式为
yyyy/MM/dd hh:mm;用户和机器人使用不同头像,消息气泡左右区分。
每次更新消息后,通过
scroll-into-view定位到最后一条;新消息进来自动滚到底部,不需要手动拖。
3. 土方实验:压实度快速估算
pages/待开发/index虽然目录名叫“待开发”,但页面本身已经可用,是一个土方压实度估算工具。
输入项
土壤重量
水重量
最大干密度(占位提示带默认值)
含水率(默认 1.05)
土壤类型:素土、炮渣、碎石
4. 激活页
pages/激活/index提供了激活入口的交互骨架:
页面加载时初始化菜单状态;
长按弹出菜单,同样做屏幕边界修正;
支持复制激活文本,点击遮罩关闭;
预留删除操作。
5. 我的:个人中心
pages/我的/index是标准的个人中心布局:
顶部头像、昵称、角色标识;
个人信息、版本信息、联系我们、意见反馈;
小书书 Key;
底部“土方实验”入口。
data-page统一跳转,新增页面时只需要加一项配置。6. 预留页面
个人信息、版本信息、联系我们、小书书AI-kpy 目前是轻量骨架页。
它们保留了页面结构和跳转关系,方便按自己的业务补充内容。
四、技术结构
Excel书世界-小程序/ ├── app.json 页面注册、窗口样式、权限声明 ├── app.wxss 全局样式 ├── project.config.json 开发者工具配置 ├── project.miniapp.json Android / iOS 打包配置 ├── sitemap.json 搜索索引配置 ├── pages/ │ ├── 首页/ 欢迎页 + 四个入口 │ ├── 小书书Ai/ AI 对话(核心页) │ ├── 待开发/ 土方实验计算 │ ├── 激活/ 激活入口 │ ├── 我的/ 个人中心 │ ├── 个人信息/ 预留 │ ├── 版本信息/ 预留 │ ├── 联系我们/ 预留 │ └── 小书书AI-kpy/ 预留 └── utils/util.js 通用工具 几个实现细节:
页面注册集中管理:所有页面在
app.json的pages数组里声明,新增页面按顺序加即可。组件按需加载:
lazyCodeLoading: "requiredComponents",减少首屏注入。跨端打包:
project.miniapp.json里配置了 mini-android 和 mini-ios 的 SDK、权限、图标、启动图等字段,可继续打包成 Android / iOS 应用。本地存储优先:AI 对话不依赖后端数据库,消息直接存在本地,适合个人工具和轻量场景。
样式与逻辑分离:WXML 管结构,WXSS 管样式,JS 管数据与请求,结构清晰,便于二次开发。
五、可以怎么扩展
这个项目最适合作为“工具类小程序”的起点,下面几个方向都能顺着现有结构往下做。
扩展方向
Ai.js里的接口地址、模型名、Key 换成自己的;也可以加流式接口,替换打字机模拟 | |
六、适合哪些人
想快速做一个工具类微信小程序的开发者;
需要 AI 对话、本地记录和简单计算页的团队;
工程、施工、测量、造价等需要现场快速估算的从业者;
想学习原生小程序页面结构、本地存储、长按菜单、打字机效果的初学者;
想拿一套可运行骨架做二次开发的技术人员。
七、关于源码
本项目提供完整源码,100 元 / 套。
源码包含:
完整微信小程序工程结构与页面注册;
首页、AI 对话、土方实验、激活、我的等页面;
智谱 GLM 对话接入与打字机输出;
本地消息持久化、长按复制、清屏、自动滚动;
土方压实度估算逻辑与土类默认参数;
个人中心与预留页骨架;
mini-android / mini-ios 打包配置。
示例代码里的 API Key 只是演示值,使用前请替换成自己的密钥,并建议改为后端转发,避免密钥暴露;
小程序发布需要自己的 AppID 和微信开发者工具;
土方计算结果仅供参考,实际以实验室实测为准;
源码仅供学习与二次开发使用。
写在最后
小项目的价值,往往不在“功能多”,而在“结构对”。
小书生工具箱把页面注册、导航、AI 对话、本地存储、计算页、个人中心这些基础件都摆好了。
你可以把它当成一个能跑起来的起点:换掉 API Key,换掉计算逻辑,换掉文案和图标,就能变成一个属于自己的行业小工具。