From 1e8e22c9eddcda27ef877fc72cf5ac2624726105 Mon Sep 17 00:00:00 2001 From: yuzhiran Date: Sun, 21 Jun 2026 20:09:45 +0800 Subject: [PATCH] docs: update project status v4.8, AGENTS.md build notes, deployment docs - PROJECT-STATUS.md: v4.8 changelog (SEO, share hooks, version injection) - AGENTS.md: update version to v1.0.17, add build notes for SEO/version/share - DEPLOYMENT.md: update deploy instructions for robots.txt/sitemap.xml/static, version bump --- AGENTS.md | 14 +++++++++++--- docs/DEPLOYMENT.md | 7 ++++++- docs/PROJECT-STATUS.md | 14 ++++++++------ 3 files changed, 25 insertions(+), 10 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 501378f..ad215f1 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -141,6 +141,12 @@ npm test # 前端单元测试（vitest，7 个） cd backend && npm run build ``` +### 构建产物说明 +- **H5 构建** (`npm run build:h5`)：自动复制 `avatar-*.png` 到 `static/`，复制 `robots.txt` 和 `sitemap.xml` 到输出根目录 +- **版本号注入**：`vite.config.js` 中 `define.__APP_VERSION__` 自动从 `git describe --tags` 获取版本号，`about.vue` 页面实时显示 +- **小程序上传版本** (`scripts/upload-mp.js`)：自动从 git tag 获取基础版本，末位自增 1（如 tag v1.0.16 → 上传版本 1.0.17） +- **微信分享**：所有主页面均已注册 `onShareAppMessage` + `onShareTimeline`，右上角菜单转发/分享到朋友圈可用 + ### 部署后端 ```bash cd backend && npm run build @@ -156,7 +162,9 @@ cd zhiyin-app && npm run build:h5 rm -rf /www/wwwroot/zhiyin.yzrcloud.cn/assets cp -r dist/build/h5/index.html /www/wwwroot/zhiyin.yzrcloud.cn/ cp -r dist/build/h5/assets /www/wwwroot/zhiyin.yzrcloud.cn/ -chown -R www:www /www/wwwroot/zhiyin.yzrcloud.cn/index.html /www/wwwroot/zhiyin.yzrcloud.cn/assets +cp -r dist/build/h5/static /www/wwwroot/zhiyin.yzrcloud.cn/ +cp -f dist/build/h5/robots.txt dist/build/h5/sitemap.xml /www/wwwroot/zhiyin.yzrcloud.cn/ +chown -R www:www /www/wwwroot/zhiyin.yzrcloud.cn/ # 验证无缺失文件 grep -oP '["'"'"']([a-zA-Z0-9_-]+\.[a-z]+(\.js|\.css|\.png|\.svg))["'"'"']' /www/wwwroot/zhiyin.yzrcloud.cn/assets/index-*.js | sort -u ``` @@ -194,7 +202,7 @@ cd zhiyin-app && npm run build:mp-weixin && node scripts/upload-mp.js ## 六、项目状态与开发阶段 -**当前**: Phase 1.5（商业化 + 全量部署）— v1.0.16 +**当前**: Phase 1.5（商业化 + 全量部署）— v1.0.17 | 阶段 | 状态 | 关键交付 | |------|------|---------| @@ -262,7 +270,7 @@ VITE_APP_NAME=AI磁场 - 远程仓库: `http://127.0.0.1:2999/txai-dev/zhiyin.git`（本机 Gitea，带 token 认证） - 默认分支: `master` -- 最新 tag: `v1.0.16`（小程序上传版本 v1.0.16 源自 git tag） +- 最新 tag: `v1.0.16`（小程序上传版本 v1.0.17 源自 git tag + 末位自增 1） --- diff --git a/docs/DEPLOYMENT.md b/docs/DEPLOYMENT.md index e43c13a..e72ad14 100644 --- a/docs/DEPLOYMENT.md +++ b/docs/DEPLOYMENT.md @@ -128,7 +128,11 @@ npm run build:h5 ### 3. 部署到 Web 服务器 ```bash +# 构建含 SEO 文件（robots.txt, sitemap.xml, 数字人头像） +npm run build:h5 +# 部署所有产物 scp -r dist/build/h5/* user@your-server:/www/wwwroot/zhiyin.yzrcloud.cn/ +# 或者使用服务端脚本（自动复制 static/、robots.txt、sitemap.xml） ``` ### 4. Nginx 配置 @@ -223,7 +227,7 @@ node scripts/upload-mp.js ``` ### 版本号 -当前线上版本：**1.0.16**（git tag v1.0.16） +当前线上版本：**1.0.17**（git tag v1.0.16，脚本自动末位自增 → 上传版本 1.0.17） --- @@ -250,3 +254,4 @@ node scripts/upload-mp.js | 2026-06-09 | 初版 | AI | | 2026-06-09 | 更新生产域名：zhiyinwx.yzrcloud.cn（API :3006）、zhiyin.yzrcloud.cn（H5 静态目录） | 小之 | | 2026-06-21 | 更新部署版本至 v1.0.16；小程序上传工具使用 git tag 自动获取版本号 | 小之 | +| 2026-06-21 | v4.8 SEO + 分享全面优化：部署新增 robots.txt、sitemap.xml、static/ 目录；版本号自动注入（Vite define）；13 页面微信分享全部开启；上传脚本版本号末位自增 1 | AI | diff --git a/docs/PROJECT-STATUS.md b/docs/PROJECT-STATUS.md index 7dbe324..2b4313c 100644 --- a/docs/PROJECT-STATUS.md +++ b/docs/PROJECT-STATUS.md @@ -1,8 +1,8 @@ -# 职引项目 · 状态报告 v4.7 +# 职引项目 · 状态报告 v4.8 -> **项目版本**: v4.7 +> **项目版本**: v4.8 > **更新时间**: 2026-06-21 -> **项目状态**: ✅ 引力值按量购买 + H5/小程序已部署 +> **项目状态**: ✅ SEO 优化 + 微信分享全面开启 + 全量部署 --- @@ -25,7 +25,7 @@ | 模块 | 完成度 | 说明 | |------|------|------| | 后端 API | **99%** | 核心 + 护城河 P0-P5 全部实现 | -| 前端页面 | **92%** | 18 个页面含真实 API 调用 | +| 前端页面 | **95%** | 20 个页面含真实 API 调用 | | AI 面试模拟 | **95%** | 多轮对话 + 评分 + 报告 + 进度追踪 | | 简历诊断/优化 | **95%** | 文件上传 + AI 分析 + 下载 | | 支付系统(微信) | **95%** | API v3 完整对接，含真实证书，H5 扫码支付可用 | @@ -35,8 +35,9 @@ | 测试体系 | **85%** | 43 单元 + 11 e2e + 7 前端 + Playwright 框架 | | 代码质量 | **95%** | console→Logger，as any 类型化，空 catch 检查 | | 安全审计 | **90%** | JWT 硬编码 / 凭据泄漏 / IDOR / NoSQL 注入 全部修复 | -| 小程序审核 | **100%** | v1.0.16 已提交审核，类目已备案 | -| 生产部署 | **100%** | 后端 PM2 / H5 已部署 / 小程序已上传 | +| 小程序审核 | **100%** | v1.0.17 已提交审核，类目已备案 | +| 生产部署 | **100%** | 后端 PM2 / H5 已部署 / 小程序 v1.0.17 已上传 | +| SEO / 分享优化 | **100%** | H5 canonical + robots.txt + sitemap + 结构化数据；小程序 13 页面全量开启分享 | --- @@ -223,6 +224,7 @@ | 日期 | 版本 | 变更内容 | 操作者 | |------|------|----------|--------| +| 2026-06-21 | **v4.8** | **SEO 全量优化**（canonical URL、robots.txt、sitemap.xml、结构化数据）；**微信分享全面开启**（13 个页面 onShareAppMessage + onShareTimeline）；**版本号自动注入**（Vite define __APP_VERSION__）；**导航栏/Tab标题关键词优化**；manifest 描述更新；页面描述统一增强 | AI | | 2026-06-21 | v4.7 | 按量购买引力值体系重构（¥5/份取代月订阅）；member.vue 完全重写；微信小程序剪贴板购买链路；客服按钮；管理后台字段全面完善；代码清理；测试数据清理；后端/H5/小程序全量部署上线 | AI | | 2026-06-19 | v4.6 | 引力值体系统一：VIP 取消无限面试改为月度引力值消耗；管理后台全面完善（搜索/筛选/分页/CRUD/分析tab/岗位描述字段） | AI | | 2026-06-17 | v4.5 | AI 择业顾问 MVP：后端模块 + 前端职业分析页面 + 热门岗位联动 | AI |