优雅草科技新产品·优雅草递个名片2026年10月19日v1.0.4版本正式发布-正式运营

优雅草递个名片

面向个人、企业和店铺的电子名片应用，简称「递个名片」。以微信小程序为主要入口，提供名片创建、资料展示、分享与收藏能力，配套管理后台用于名片管理、审核、举报处理和运营配置。

研发背景

近几个月，卓伊凡团队多次外出参会。会场上反复出现同一类情况：不少同事的纸质名片已经弄丢，也有人本来就没有名片；团队自己有时也会忘记随身携带。遇到加好友、刚认识的人想交换联系方式时，往往没法立刻把名片递出去。

卓伊凡把名片看成每个人的标签。一张名片同时建立起个人的基础形象和企业形象。更快的社交方式，需要在见面当时就能递出、被记住，之后也能被再次找到。

递个名片因此把相互发现做成社交的一部分：发展关系，也展示自己。广场可以按行业和企业筛选已经加入的名片。用户既能把自己的名片分享出去，也能顺着行业去认识人、拓展业务。产品由此诞生。

运营上不接入任何第三方广告，以免费与付费双驱动：基础使用免费开放，进阶能力通过付费补充，两条路径一起支撑产品持续运营。

当前版本

v1.0.4 已于 2026 年 10 月 19 日 正式发布微信小程序并投入运营。这是优雅草递个名片的首次公开版本。

版本变更记录见 [color=rgb(22, 119, 255) !important]CHANGELOG.md。

项目由 uni-app 用户端、Vue 管理后台和 PHP 服务端组成，基于 LikeAdmin 扩展名片业务。

截图

主要功能

• 名片管理：创建多张名片，编辑个人资料、联系方式、服务内容和作品图片，支持复制、默认名片及个人额度设置。
• 模板与主题：20 套免费名片模板，支持预览、切换版式和界面主题设置。
• 分享与海报：微信好友分享、朋友圈分享、小程序码及名片海报。
• 名片夹：收藏名片，维护私人备注和标签，按关键词或标签查找。
• 发现广场：按地区、行业和关键词浏览名片，支持申请展示、撤回及人工审核。
• 隐私与安全：联系方式按字段控制公开范围，草稿与发布版分离，支持内容安全检测、举报和账号注销。
• 运营后台：名片新增与编辑、状态管理、审核、举报处理、模板开关、额度配置和访问统计。
  

名片模板不提供付费解锁。用户端与后台管理员使用各自的账号体系。

Plus VIP 权益

• 免费用户每张名片最多添加 5 条产品介绍，名片默认展示 1 条；Plus VIP 最多添加 50 条，默认展示 5 条，其余通过“查看更多”查看。
• 用户可从「我的 → Plus VIP」进入购买与续费页面，使用现有服务点钱包支付；后台「VIP 会员与订单」配置价格、正式服务及退款说明和购买开关。默认参考价为 20 服务点/30 天、199 服务点/365 天，1 服务点对应 1 元，不自动续费。续费从当前到期时间与开通时间中的较晚者顺延。
• 后台「用户详情 → 名片额度与 VIP 权益」仍可手动设置 VIP 到期时间，清空可取消；复用 card.card/setUserLimit 管理权限并记录操作日志。所有模板及基础功能继续免费开放，平台永久不接入第三方广告。
• VIP 到期后自动恢复免费权益，不删除已有产品；超额产品可保持不变并编辑其他资料，修改产品需精简至免费额度或续费。未发布的超额草稿到期后不能新发布。
• 已有安装须先备份并执行 server/sql/card/016_card_vip.sql 和 server/sql/card/017_card_vip_purchase.sql，自定义表前缀需替换为实际前缀；不要重复导入基础初始化 SQL。自助购买依赖现有钱包迁移和真实微信虚拟支付配置，默认不开放；只有服务端核实的生产环境扣点才开通正式 VIP，沙箱订单不改变真实权益。
• 每分钟运行 php server/think card:wallet-reconcile 核实钱包、置顶及 VIP 订单。支付联调、正式协议、商户及平台能力验收完成前，不要开放正式购买。原单恢复与退款按服务端核实结果处理。
  

技术栈模块技术
用户端uni-app、Vue 3、TypeScript、Vite、uni-ui
管理后台Vue 3、TypeScript、Element Plus、Pinia、Vue Router、ECharts
服务端PHP、ThinkPHP 8、Think ORM、LikeAdmin
数据库MySQL

依赖版本以各模块的 package-lock.json 和 server/composer.lock 为准。

目录结构.├── admin/                 管理后台│   ├── src/               页面、组件、接口与状态管理│   └── scripts/           检查与发布脚本├── uniapp/                微信小程序及 H5 前端│   ├── src/               页面、组件、模板和静态资源│   ├── scripts/           构建检查与资源生成脚本│   └── tests/             前端回归测试├── server/                PHP 服务端│   ├── app/               接口与业务逻辑│   ├── config/            应用配置│   ├── public/            Web 入口与后台部署目录│   ├── resources/         地区、行业数据及来源说明│   ├── runtime/           缓存、日志、私有附件和备份│   ├── scripts/           安装及维护脚本│   ├── sql/               数据库增量脚本│   └── tests/             后端回归检查├── docs/design-system/    界面设计规范├── img/                   项目参考图片├── CHANGELOG.md           版本更新日志└── .gitignore             本地配置和生成文件的忽略规则环境准备

• Node.js 22.18 或更新的兼容版本，使用 npm 安装前端依赖。
• PHP 8.0 及以上、Composer，以及依赖要求的 PHP 扩展。
• MySQL，使用 utf8mb4 字符集。
• 微信开发者工具，用于小程序预览、调试和上传。
  

安装依赖时使用锁文件，避免直接升级整个依赖树：

cd servercomposer install

admin 和 uniapp 分别执行 npm ci，两端依赖独立管理。

服务端配置

将 server/.example.env 复制为 server/.env，填写数据库连接、表前缀等配置。生产环境应关闭 APP_DEBUG 和数据库调试。

Web 服务根目录指向 server/public，配置入口转发至 index.php。接口路径为：

路径用途
/api用户端接口
/adminapi管理后台接口
/admin/管理后台页面

本地临时启动服务可在 server 目录运行：

php -S 127.0.0.1:8000 -t public public/router.php

该命令仅用于开发，不作为生产部署方式。

数据库与定时任务

名片安装脚本用于在已有 LikeAdmin 数据库上添加名片表、配置和权限菜单，不代替基础数据库初始化。首次接入或升级前，应备份数据库，并先在独立数据库验证。

server/scripts/install_card.php 需要可用的 mysqldump；通过环境变量 CARD_MYSQLDUMP 指定其完整路径。脚本会备份数据库并在副本上验证迁移，--validate-only 模式也需要创建、复制和删除验证数据库的权限。

# 在项目根目录执行；先确认 server/.env 指向预期数据库php server/scripts/install_card.php --validate-only# 验证通过并确认备份后，安装名片模块php server/scripts/install_card.php

已有安装的后续升级按版本核对 server/sql/card/ 中的增量脚本；不要把整个 SQL 目录直接批量导入，也不要在已有业务库上重新执行基础初始化 SQL。

每分钟执行一次内容安全任务清理命令：

php server/think card:safety-expire用户端开发cd uniappnpm cinpm run dev:h5

H5 开发服务默认监听 127.0.0.1:5178。/api 默认代理到 http://mingpian.cc，可通过环境变量 API_PROXY 指向自己的后端，例如 http://127.0.0.1:8000。

以 PowerShell 为例：

$env:API_PROXY = 'http://127.0.0.1:8000'npm run dev:h5

H5 开发模式提供用户账号登录，正式小程序使用微信登录。后台管理员账号不能用于用户端登录。

小程序配置与构建

• 在 uniapp/src/manifest.json 中配置自己的微信小程序 AppID。
• 在 uniapp/.env.production.local 中设置 VITE_API_BASE=https://你的域名/api，覆盖项目现有生产地址。
• 在管理后台的小程序设置中配置对应的 AppID、AppSecret 和内容安全回调。
• 在微信公众平台配置服务器合法域名、图片下载域名及所需隐私声明。
  

AppSecret 仅保存在服务端，不写入前端代码或提交到版本库。

npm run check:releasenpm run build:mp-weixin

正式构建会先检查 HTTPS 接口、AppID 一致性、凭据配置、安全回调、调试状态和可用模板。构建完成后，用微信开发者工具导入 uniapp/dist/build/mp-weixin。

仅进行本地编译检查时可使用：

npm run build:mp-weixin:preview

预览构建不执行上线配置检查，不能代替正式发布检查。微信登录、内容安全回调、分享、小程序码和相册权限仍需在真实平台及设备上验收。

管理后台开发

将 admin/.env.development.example 复制为 admin/.env.development，配置 VITE_APP_BASE_URL 为后端服务地址，例如 http://127.0.0.1:8000，不要附加 /adminapi。

cd adminnpm cinpm run dev

生产配置可参考 admin/.env.production.example；同域部署时，VITE_APP_BASE_URL 可留空。

npm run build

构建只生成 admin/dist，不会自动部署。确认部署目标、备份和验收结果后，可在 admin 目录执行 npm run deploy。发布脚本将资源部署到 server/public/admin，并在 server/runtime/admin-releases 保留上一版本；不要并发执行发布。

测试与检查

管理后台：

cd adminnpm testnpm run type-checknpm run lint

用户端：

cd uniappnpm testnpm run type-checknpm run build:h5

后端回归脚本位于 server/tests/。运行前检查脚本用途和数据库目标，数据库集成测试使用独立测试库，不直接对运营数据库执行。

部署后，在 uniapp 目录执行 npm run check:deployment 检查公开接口、访问边界及部署配置。

运维注意事项

• 定期备份数据库、私有附件和服务端配置；运行目录不进入版本库，但不能当作普通缓存整体删除。
• 私有名片附件通过受保护的接口访问，不把 server/runtime 暴露为静态目录。
• 草稿、待审核版本与发布版分别管理；对外展示以服务端公开数据为准。
• 生产环境使用 HTTPS，关闭调试输出，配置内容安全回调和定时任务。
• 正式发布前核对用户协议、隐私政策、运营主体及微信平台要求。
• 保留第三方许可证和数据来源说明；敏感配置、依赖目录、构建产物和测试截图由根目录 .gitignore 排除。