服药-PH 记录助手

一款用于记录服药剂量和尿液 PH 值变化趋势的实用工具应用。

📱 应用简介

本应用专为需要长期服药控制尿液 PH 值的用户设计，帮助您便捷地记录每日服药剂量和 PH 值数据，并通过可视化图表展示变化趋势，让健康管理更加科学直观。

✨ 核心功能

📝 数据记录

• ✅ 记录每日服药剂量（单位：克）
• ✅ 记录尿液 PH 值
• ✅ 自定义日期和时间
• ✅ 按时间倒序显示所有记录

📊 数据可视化

• ✅ PH 值变化趋势折线图
• ✅ 智能颜色标识：
  • 🟡 黄色：PH 0-6（酸性）
  • 🟢 绿色：PH 6-7（中性）
  • 🔵 蓝色：PH 7-14（碱性）
• ✅ 自动过滤极端值（PH<4 或 PH>10），确保图表清晰可读

⚙️ 数据管理

• ✅ 数据备份与导出（复制到剪贴板）
• ✅ 数据导入与恢复（从剪贴板粘贴）
• ✅ 清空所有数据
• ✅ 本地存储，保护隐私安全

🎨 交互体验

• ✅ 编辑已有记录
• ✅ 删除单条记录
• ✅ 唯一 ID 标识，确保操作准确性
• ✅ 简洁直观的 Material Design 风格界面

🛠️ 技术栈

前端框架

• 框架: UniApp - 跨平台开发框架
• 语言: Vue 3.4.21 - 渐进式 JavaScript 框架
• 构建工具: Vite 5.2.8 - 下一代前端构建工具
• UI: 原生 UniApp 组件 + 自定义样式

核心依赖

• @dcloudio/uni-app - UniApp 核心库
• vue-i18n - 国际化支持
• @qiun/ucharts - 图表库（备用）

目标平台

• 🎯 主要发行平台: Android APP
• 🔄 可扩展平台: 微信小程序、H5、以及其他 UniApp 支持的平台

🚀 快速开始

环境要求

• Node.js >= 16.x
• npm >= 8.x
• HBuilderX（推荐）或 VS Code
• Android Studio（如需打包 Android APP）

安装依赖

npm install

开发运行

Android APP 开发模式

npm run dev:custom

微信小程序开发模式

npm run dev:mp-weixin

H5 开发模式

npm run dev:h5

生产构建

Android APP 打包

npm run build:custom

微信小程序打包

npm run build:mp-weixin

H5 打包

npm run build:h5

📖 使用说明

1. 添加记录

1. 点击首页「添加新记录」按钮
2. 输入服药剂量（单位：克）
3. 输入尿液 PH 值
4. 选择日期和时间
5. 点击「保存记录」

2. 查看列表

• 首页自动显示所有记录，按时间倒序排列
• 每条记录显示剂量、PH 值和时间
• PH 值左侧彩色条标识酸碱性

3. 编辑记录

1. 在列表中点击某条记录的「编辑」按钮
2. 修改相关信息
3. 点击「保存记录」完成更新

4. 删除记录

1. 在列表中点击某条记录的「删除」按钮
2. 确认删除操作

5. 查看图表

1. 点击首页右上角「图表」按钮
2. 查看 PH 值变化趋势折线图
3. 图表自动过滤极端值，只显示 PH 4-10 的数据

6. 数据备份与恢复

备份数据

1. 进入「设置」页面
2. 点击「导出数据（备份）」
3. 数据将复制到剪贴板，可粘贴保存到其他地方

恢复数据

1. 复制之前备份的数据（JSON 格式）
2. 进入「设置」页面
3. 点击「导入数据（恢复）」
4. 确认导入，数据将覆盖当前记录

💡 提示: 导入功能会自动兼容旧版本数据格式，无需担心版本升级问题。

📁 项目结构

ph-note/
├── src/
│   ├── pages/              # 页面目录
│   │   ├── add/           # 添加/编辑记录页
│   │   ├── chart/         # 图表页
│   │   ├── index/         # 首页（列表页）
│   │   └── setting/       # 设置页
│   ├── utils/             # 工具类
│   │   └── storage.js     # 本地存储工具
│   ├── App.vue            # 应用入口
│   ├── main.js            # 入口文件
│   ├── manifest.json      # 应用配置
│   └── pages.json         # 页面路由配置
├── package.json           # 项目依赖配置
└── vite.config.js         # Vite 配置文件

🔧 配置说明

manifest.json

• 应用名称、版本号、appid 等基础信息
• 各平台特定配置（小程序、H5、APP 等）

pages.json

• 页面路由注册
• 全局样式配置
• 导航栏配置

📝 更新日志

v1.5.6 (2026-03-30)

• ✨ 初始版本发布
• ✨ 基础记录功能
• ✨ 图表展示功能
• ✨ 数据导入导出功能
• 🐛 修复索引错乱问题（使用唯一 ID 替代索引）
• 🐛 优化图表显示（过滤极端值）
• ♻️ 数据兼容性改进（自动为旧数据生成 ID）

🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

📄 许可证

Apache-2.0 License

👤 联系方式

• 作者邮箱: icexmoon@qq.com
• 技术支持: 如有问题请通过邮件联系

🙏 致谢

感谢以下开源项目：

• UniApp
• Vue.js
• Vite

---

© 2026 icexmoon@qq.com. All Rights Reserved.