跟上AI的步伐,实践模型的魅力
# 任务:为 Xiuno X 开发模型API价格查询插件 "jzkf_model_price"
## 插件信息
- 目录:`jzkf_model_price`
- 名称:模型API价格查询
- 类型:工具插件
- 依赖:无需依赖(独立插件)
- 入口:在发现页(`jzkf_discover`)中以卡片形式展示入口,不增加导航栏独立入口
## 功能需求
### 模型数据管理
- **模型信息录入**:管理员可手动添加或编辑模型信息,包含模型名称、作者(OpenAI、腾讯、阿里等)、模态(多模态、文生图、图生图等)、价格(输入价格、输出价格)、免费试用开关、限时折扣信息、上下文字符范围、开源协议(Apache License 2.0、GPL-2.0等)、API可用状态(可用/待机)、发布时间、官方链接、模型简介等<span data-allow-html class='source-item source-aggregated' data-group-key='source-group-0' data-url='https://www.modelscope.cn/datasets' data-id='turn0search2'><span data-allow-html class='source-item-num' data-group-key='source-group-0' data-id='turn0search2' data-url='https://www.modelscope.cn/datasets'><span class='source-item-num-name' data-allow-html>modelscope.cn</span><span data-allow-html class='source-item-num-count'>+1</span></span></span>。
- **自动数据收集**:系统应支持通过配置的定时任务(Cron)或手动触发,从指定数据源(如 ModelScope 等平台)抓取模型数据<span data-allow-html class='source-item source-aggregated' data-group-key='source-group-1' data-url='https://www.modelscope.cn/skills/modelscope/ms-hub' data-id='turn0search8'><span data-allow-html class='source-item-num' data-group-key='source-group-1' data-id='turn0search8' data-url='https://www.modelscope.cn/skills/modelscope/ms-hub'><span class='source-item-num-name' data-allow-html>modelscope.cn</span><span data-allow-html class='source-item-num-count'>+1</span></span></span>。抓取逻辑需具备可扩展性,方便后续增加其他数据源。
- **数据导入导出**:支持 CSV/Excel 格式的模型数据批量导入导出,方便管理员进行数据维护和迁移。
- **图片管理**:模型卡片可展示模型封面图,支持本地上传或指定远程图片地址。上传图片需进行安全处理(如重采样、防注入)<span data-allow-html class='source-item source-aggregated' data-group-key='source-group-5' data-url='https://www.xiunobbs.cn/thread-7383.htm?post=all' data-id='turn1search9'><span data-allow-html class='source-item-num' data-group-key='source-group-5' data-id='turn1search9' data-url='https://www.xiunobbs.cn/thread-7383.htm?post=all'><span class='source-item-num-name' data-allow-html>xiunobbs.cn</span><span data-allow-html class='source-item-num-count'></span></span></span>。
### 前台查询与展示
- **多维度筛选**:用户可按模型作者、模态、价格区间、是否免费试用、是否有限时折扣、上下文字符区间、开源协议、API可用状态、发布时间等多个维度进行组合筛选<span data-allow-html class='source-item source-aggregated' data-group-key='source-group-2' data-url='https://www.modelscope.cn/learn/4906' data-id='turn0search4'><span data-allow-html class='source-item-num' data-group-key='source-group-2' data-id='turn0search4' data-url='https://www.modelscope.cn/learn/4906'><span class='source-item-num-name' data-allow-html>modelscope.cn</span><span data-allow-html class='source-item-num-count'>+1</span></span></span>。
- **排序功能**:支持按发布时间、价格(输入/输出)、上下文长度、点赞数等字段进行排序。
- **搜索功能**:提供关键词搜索,可匹配模型名称、作者、简介等文本内容。
- **卡片展示**:参考 ModelScope 等网站,以卡片形式展示模型信息,包含:模型封面图、名称、作者、模态标签、价格(输入/输出)、上下文长度、开源协议标签、API状态标签、发布时间、点赞数、NEW标记(7天内新发布的模型)<span data-allow-html class='source-item source-aggregated' data-group-key='source-group-3' data-url='https://www.modelscope.cn/learn/4906' data-id='turn0search4'><span data-allow-html class='source-item-num' data-group-key='source-group-3' data-id='turn0search4' data-url='https://www.modelscope.cn/learn/4906'><span class='source-item-num-name' data-allow-html>modelscope.cn</span><span data-allow-html class='source-item-num-count'>+1</span></span></span>。
- **点赞功能**:用户可为模型点赞,点赞数实时更新并排序。需防止用户重复点赞(需记录用户点赞状态)。
- **响应式设计**:确保在不同设备(桌面、平板、手机)上均有良好展示效果,参考提供的前端排版网站<span data-allow-html class='source-item source-aggregated' data-group-key='source-group-6' data-url='https://developer.aliyun.com/article/1677155' data-id='turn0search10'><span data-allow-html class='source-item-num' data-group-key='source-group-6' data-id='turn0search10' data-url='https://developer.aliyun.com/article/1677155'><span class='source-item-num-name' data-allow-html>aliyun.com</span><span data-allow-html class='source-item-num-count'></span></span></span>。
### 后台管理
- **配置管理**:
- **数据源配置**:设置自动数据收集的定时任务执行周期(如每日一次)、抓取的数据源URL列表、API密钥(如需要)等。
- **前端展示配置**:设置每页显示的模型卡片数量、排序默认选项、是否启用点赞功能等。
- **模型数据管理**:
- **模型列表**:分页展示所有模型,支持筛选、搜索、批量操作(如删除、下架)。
- **添加/编辑模型**:提供表单界面,包含所有模型字段的录入与编辑功能。
- **待审核模型**:若支持用户提交模型,可设置待审核队列,管理员需审核后模型才在前台显示(可选功能,按需实现)。
- **统计与日志**:记录数据抓取日志(成功/失败数量、耗时)、模型更新日志、用户点赞记录等。
### 技术约束
- 遵循 Xiuno X 插件规范。
- 前端:Bootstrap 5 + Tabler Icons,无 jQuery。
- 所有 POST 操作需 CSRF token 验证。
- 图片上传需进行安全检查,防止恶意文件<span data-allow-html class='source-item source-aggregated' data-group-key='source-group-4' data-url='https://www.xiunobbs.cn/thread-7383.htm?post=all' data-id='turn1search9'><span data-allow-html class='source-item-num' data-group-key='source-group-4' data-id='turn1search9' data-url='https://www.xiunobbs.cn/thread-7383.htm?post=all'><span class='source-item-num-name' data-allow-html>xiunobbs.cn</span><span data-allow-html class='source-item-num-count'></span></span></span>。
- 数据抓取功能需处理异常情况(如超时、格式错误)并记录日志。
- 入口由 `jzkf_discover` 统一管理,本插件不添加导航菜单。
- 不要修改系统源码,所有修改都应在插件目录下完成。
## 输出清单
- `conf.json`
- `install.php` / `uninstall.php`
- `setting.php` + `setting.htm`
- `model/ModelService.php` (模型数据业务逻辑)
- `model/ModelCrawlerService.php` (数据抓取服务,可按数据源分多个类)
- `route/model_price.php` (前台路由)
- `route/admin_model_price.php` (后台管理路由)
- `view/htm/model_price.htm` (前台模型列表页)
- `view/htm/model_detail.htm` (模型详情页,可选,若需独立详情页)
- `admin/view/htm/model_price_admin.htm` (后台模型管理页)
- `admin/view/htm/model_price_setting.htm` (后台配置页)
- `static/js/model_price.js` (前端交互逻辑,如筛选、排序、点赞)
- `static/css/model_price.css` (样式覆盖)
- `hook/index_discovery_card.htm` (在发现页插入插件卡片)
- `cron/crawl_models.php` (定时任务文件,用于自动抓取数据)
- `update.md`
## update.md
### 版本 1.0.0 (2025-07-16)
- 初始版本发布。
- 实现模型信息手动管理(增删改查)。
- 实现前台多维度筛选、排序、搜索功能。
- 实现模型卡片展示(含标签、价格、状态、点赞)。
- 实现后台配置与模型数据管理。
- 实现基础数据抓取功能(支持从指定URL抓取JSON数据)。
- 实现响应式设计。
---
> 提示词不一定准确,请根据源码进行调整修改,比如hook或者函数等。
> 不要修改系统源码,所有修改都应在插件目录下完成。
> 有任何问题先提问再规划执行。



