koishi-plugin-rocom 1.0.11 → 1.0.13

package/lib/render-templates/yuanxing-shangren/CHANGELOG.md

@@ -0,0 +1,138 @@
+# 远行商人UI更新日志
+
+## 更新时间
+2026-06-19
+
+## 更新内容
+
+### 1. 模板文件更新
+
+#### ✅ 主模板 (index.html)
+- **来源**: 从 `src/doc/plugins/WeGame-plugin/modules/rocom/resources/render/yuanxing-shangren/today.html` 搬运
+- **特性**:
+  - 标题改为"今日远行商人"
+  - 按轮次分组显示商品（支持4轮展示）
+  - 每个轮次显示独立的商品列表
+  - 当前轮次高亮显示（is-current样式）
+  - 空轮次显示"该轮次暂无商品"提示
+
+#### 📦 备份文件
+- **index.html.backup**: 保存了现代化WeGame风格的设计版本
+  - 采用Inter + Fraunces字体
+  - 温暖的奶油色调 (#F7F4EF)
+  - 陶土色强调 (#C4612F)
+  - 卡片式网格布局
+
+#### 📄 样式文件
+- **style.css**: 保留的原始旧版样式（传统中式风格）
+- **today.style.css**: 从today.html提取的样式文件（供参考）
+
+#### 📖 文档文件
+- **README.md**: 详细说明各版本差异和切换方法
+
+### 2. 数据结构调整 (merchant.ts)
+
+#### 新增字段
+```typescript
+{
+  total_products: number,  // 今日商品总数
+  categories: [
+    {
+      product_count: number,  // 该分类商品数
+      roundGroups: [          // 轮次分组
+        {
+          round_id: number,   // 轮次ID (1-4)
+          label: string,      // 时间标签 "08:00-12:00"
+          is_current: boolean,// 是否当前轮次
+          products: []        // 该轮次的商品列表
+        }
+      ]
+    }
+  ]
+}
+```
+
+#### 轮次分组逻辑
+- 第1轮: 08:00-12:00
+- 第2轮: 12:00-16:00
+- 第3轮: 16:00-20:00
+- 第4轮: 20:00-次日08:00
+
+#### 当前实现特点
+- 常规商品(round)按轮次分组显示
+- 热销商品(normal)和周末限定(weekend)不分轮次
+- 只在当前轮次显示商品（可根据实际需求调整）
+
+### 3. 视觉设计特点
+
+#### 配色方案
+- 背景: #ece3d3 (温暖土色)
+- 卡片: 白色渐变 + 暖黄渐变
+- 边框: 暖色系半透明
+- 强调色: 
+  - 热销: 绿色 (#2a8040)
+  - 常规: 蓝色 (#2a60b0)
+  - 周末: 红色 (#c04030)
+
+#### 布局特点
+- 最大宽度: 1040px
+- 圆角设计: 16px-30px
+- 卡片阴影: 柔和的暖色调阴影
+- 响应式: 移动端自适应
+
+#### 字体
+- 主字体: fzlant (方正兰亭)
+- 强调字体: dundun (敦敦体)
+- 后备字体: Microsoft YaHei, PingFang SC
+
+### 4. 文件结构
+
+```
+src/render-templates/yuanxing-shangren/
+├── index.html              # 当前使用（今日版）
+├── index.html.backup       # 现代化版本备份
+├── style.css               # 旧版样式（保留）
+├── today.style.css         # 今日版样式（独立文件）
+└── README.md               # 版本说明文档
+```
+
+## 兼容性说明
+
+### ✅ 已验证
+- 数据结构已适配新模板
+- merchant.ts 已更新以支持 roundGroups
+- 保留了原有的 fallback 文本功能
+
+### ⚠️ 待测试
+- 实际渲染效果
+- 各种商品数量组合的显示
+- 空轮次的处理
+- 订阅推送功能的兼容性
+
+## 回滚方法
+
+### 恢复到现代化版本
+```bash
+cd src/render-templates/yuanxing-shangren
+cp index.html.backup index.html
+```
+
+### 恢复到仓库原始版本
+```bash
+git checkout HEAD -- src/render-templates/yuanxing-shangren/index.html
+git checkout HEAD -- src/commands/merchant.ts
+```
+
+## 后续优化建议
+
+1. **轮次分组优化**: 根据实际API数据调整商品分配逻辑
+2. **性能优化**: 考虑缓存渲染结果
+3. **样式提取**: 将index.html中的内嵌样式提取到外部CSS
+4. **数据验证**: 添加数据结构验证，确保类型安全
+5. **错误处理**: 完善空数据和异常情况的处理
+
+## 技术债务
+
+- [ ] style.css 与 today.style.css 内容重复，需要整合
+- [ ] 轮次分组逻辑较为简化，可能需要根据实际时间窗口动态分配商品
+- [ ] 现代化版本(backup)的样式依赖外部字体CDN，考虑本地化

package/lib/render-templates/yuanxing-shangren/README.md

@@ -0,0 +1,86 @@
+# 远行商人模板说明
+
+## 文件列表
+
+### 当前使用版本
+- **index.html** - "今日远行商人"版本（从 WeGame-plugin modules 搬运）
+  - 特点：按轮次分组展示，显示"今日商品数"
+  - 数据结构：需要 `total_products`、`categories` 中包含 `roundGroups`
+  - 样式：内嵌在HTML中
+
+### 备份版本
+- **index.html.backup** - 之前创建的现代化设计版本
+  - 特点：使用 WeGame-plugin 风格的现代化设计
+  - 采用 Inter + Fraunces 字体，温暖的奶油色调
+  - 编辑风格排版，卡片式布局
+
+### 样式文件
+- **style.css** - 原始旧版本的样式（传统中式风格）
+- **today.style.css** - 从 today.html 提取的样式（供参考）
+
+## 版本对比
+
+| 版本 | 文件 | 风格 | 数据结构 |
+|------|------|------|----------|
+| 今日商人 | index.html | 传统土色调，按轮次分组 | 需要 `total_products`, `roundGroups` |
+| 现代版 | index.html.backup | 现代化 WeGame 风格 | 原有的 `categories` 结构 |
+| 旧版 | 仓库历史版本 | 传统中式风格 | 原有的 `categories` 结构 |
+
+## 切换版本
+
+如需切换回现代化版本：
+```bash
+cd src/render-templates/yuanxing-shangren
+cp index.html.backup index.html
+```
+
+如需恢复到仓库原始版本：
+```bash
+git checkout HEAD -- index.html
+```
+
+## 数据结构差异
+
+### 今日商人版本需要的数据
+```javascript
+{
+  title: "今日远行商人",
+  subtitle: "...",
+  total_products: 10,
+  categories: [
+    {
+      key: "round",
+      label: "常规商品",
+      product_count: 8,
+      roundGroups: [
+        {
+          round_id: 1,
+          label: "08:00-12:00",
+          is_current: true,
+          products: [...]
+        }
+      ]
+    }
+  ]
+}
+```
+
+### 原版本数据结构
+```javascript
+{
+  title: "远行商人",
+  product_count: 10,
+  round_info: { current: 1, total: 4, countdown: "3小时20分钟" },
+  categories: [
+    {
+      key: "normal",
+      label: "热销商品",
+      products: [...]
+    }
+  ]
+}
+```
+
+## 注意事项
+
+使用 today.html 版本需要修改 merchant.ts 中的数据渲染逻辑，以匹配新的数据结构。