# ai作品集

**Repository Path**: hoppin/ai-portfolio

## Basic Information

- **Project Name**: ai作品集
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-19
- **Last Updated**: 2026-10-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# hoppinzq · AI 作品集

蓝白风格的 AI 分享平台，支持 AI 作品、MCP 服务、Skills 技能分享、分类检索、独立详情与评论。

## 功能

- 🖼 **首页画廊**：分类筛选 / 热门标签 / 搜索 / 排序 / 网格·瀑布流·列表三种视图
- ⚡ **快速预览弹窗**：封面、简介、使用的大模型与相关作品推荐
- 📄 **独立详情页**：`#/work/:id` 直达（封面、作品信息、可选提示词、资源内容与评论）
- **模型归属**：普通作品、MCP、Skills 均可标注生成或开发时使用的大模型
- **多模型版本**：同一个作品包含多个模型生成结果，在卡片、预览和详情切换截图、说明与各自体验入口，不恢复调参面板
- **GitHub 源码**：主作品与各模型版本可设置独立仓库链接，支持源码跳转和 JSON 导入导出
- **MCP 分享**：工具列表、传输协议、兼容客户端、安装命令与 JSON 配置复制
- **Skills 分享**：完整 SKILL.md、安装与使用说明、文件下载及源码直达
- **封面上传**：登录后选图上传至文件服务，支持 JPG / PNG / WEBP / SVG / GIF（≤10MB），发布时提交 URL，兼容历史 data-URI 展示
- **后端存储**：作品、评论、点赞来自服务端，登录后发布与导入；JSON 导出拉取完整详情

> 既有接口见 [docs/ai-portfolio-api.md](docs/ai-portfolio-api.md)；
> 新增资源的实现契约见 [docs/mcp-skills-api.md](docs/mcp-skills-api.md)，后端已由维护者确认实现，实机联调状态见文档。
> 调参字段已从前端移除，模型名保留；后端删除范围和部署顺序见 [docs/portfolio-field-cleanup.md](docs/portfolio-field-cleanup.md)。
> 轻量版本与变体表仍需保留，新增体验链接契约见 [docs/model-variants-api.md](docs/model-variants-api.md)。

## 本地运行

**前置要求**：使用满足当前 Vite 引擎要求的 Node.js 版本与 pnpm。

1. 安装依赖：

   ```bash
   pnpm install
   ```

2. 启动开发服务器：

   ```bash
   pnpm run dev    # http://localhost:3008
   ```

## 构建与检查

```bash
pnpm run build:dev # dev 后端部署构建，产物输出 dist/
pnpm run preview   # 本地预览构建产物
pnpm run lint      # TypeScript 类型检查
```

## 目录结构

```
src/
├─ components/          # 页面区块组件（含 WorkPreviewModal / WorkDetailPage）
├─ components/effects/  # 视觉特效组件
├─ api/                 # 后端接口与 ZAI 认证
├─ data/                # UI 分类字典
├─ types/portfolio.ts   # 核心数据模型
└─ utils/format.ts
docs/
├─ ai-portfolio-api.md   # 既有后端接口
├─ mcp-skills-api.md     # MCP / Skills 扩展接口契约与联调清单
├─ portfolio-field-cleanup.md # 字段精简与后端清理
└─ model-variants-api.md # 同一作品的轻量模型版本
```