txai-dev/zhiyin
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: update project status v4.8, AGENTS.md build notes, deployment docs

Browse Source 
- 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
This commit is contained in:
yuzhiran
2026-06-21 20:09:45 +08:00
parent d8fb8e3bba
commit 30b208b35b
3 changed files with 25 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AGENTS.md
+11 -3
View File
@@ -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）
---
docs/DEPLOYMENT.md
+6 -1
View File
@@ -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 |
docs/PROJECT-STATUS.md
+8 -6
View File
@@ -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 |