即页 v1.3 正式发布：从「能分享」到「好管理」，一次质的飞跃

短链接、ZIP 网站包、版本历史、标签收藏分类、多用户管理——你的个人内容中心，正式上线

先回顾一下

v1.2 我们带来了 Markdown 增强渲染、MCP 协议支持、文件隐私控制——即页解决了「 AI 生成的内容怎么完整分享」的问题。

但很快，新的痛点来了：

链接太长：/api/files/42/render——发给客户总觉得不够正式
整站项目没法传：AI 生成的 HTML 报告带了一堆 CSS 、JS 、图片，只能一个个文件传
文件多了找不到：上传了 50 份文档，只能靠肉眼翻列表
没有后悔药：覆盖上传后旧版本就没了，想回去？没门
团队不好用：所有人共用一个账号，分不清谁上传了什么

v1.3 ，一次性解决这些问题。

🚀 六大核心更新

1️⃣ 短链接：告别长 URL ，分享更专业

每份文件自动生成 8 位随机短链接：

旧链接： https://jpage.example.com/api/files/42/render
新链接： https://jpage.example.com/s/kX9mP2wQ

上传即自动生成，无需手动操作
复制链接按钮直接复制短链接格式
MCP 工具返回的也是短链接
已有文件启动时自动补生成，平滑升级

以前：发链接前总得删掉 /api/files/，怕暴露系统结构现在：短、干净、专业，直接发

2️⃣ ZIP 包上传：整站项目，一次搞定

支持两种模式，自动识别：

网站包模式（ ZIP 内含 index.html + 资源目录）

上传后自动解压，作为完整项目预览
注入 <base> 标签，CSS/JS/图片等相对路径自动指向资源服务
资源文件通过 /api/files/:id/asset/* 独立访问
适合：AI 生成的完整网站、前端 Demo 、带资源的项目报告

批量文件模式（ ZIP 内含多个独立 HTML/MD ）

自动识别并拆分，每个文件独立创建记录
适合：一次性上传多份文档

安全防护也没落下：Zip Slip 路径穿越检测、膨胀炸弹限制、Symlink 拦截、文件数量上限。

以前：一个带 3 张图片的 HTML 页面，得传 4 次现在：打包成 ZIP ，一次上传，完整预览

3️⃣ 版本历史：覆盖不再怕，随时回滚

每次覆盖上传，旧版本自动备份到版本历史：

版本列表：查看所有历史版本
内容查看：查看任意版本的原文内容
渲染预览：直接渲染历史版本，所见即所得
一键恢复：不满意？恢复到任意历史版本
版本清理：删除不需要的历史版本，释放空间

以前：改坏了就改坏了，只能重新上传现在：完整的版本时间线，随时回到任何节点

4️⃣ 标签、收藏、分类：文件管理，井井有条

三种组织维度，灵活组合：

🏷️ 标签系统：给文件打标签，跨分类关联。支持多标签筛选，一个文件可以属于多个标签
⭐ 收藏功能：重要文件一键收藏，快速访问，不会被淹没在列表里
📁 分类管理：按项目、按客户、按类型——你说了算。未分类文件也有归属

以前：50 个文件排成一排，找到目标靠运气现在：标签筛选 + 分类归档 + 收藏置顶，3 秒定位

5️⃣ 多用户管理：团队协作的基础

角色系统：admin 和 user 两种角色，权限分明
用户管理界面：管理员可创建、编辑、删除用户
文件隔离：普通用户只能看到自己的文件和公开文件，管理员看全局
用户级 API Token：每人最多 10 个独立 Token ，格式 jp_ + 32 位随机串

MCP 也支持用户级 Token 认证——不同用户通过各自的 Token 连接，文件归属自动隔离。

以前：团队共用一个账号，谁传了什么分不清现在：每人独立账号，MCP 自动隔离，安全又清晰

6️⃣ UI/UX 全面升级：不只是功能，体验也进化了

📊 上传进度条：XHR 实时进度 + 百分比显示，大文件上传不再焦虑
🦴 骨架屏加载：列表加载时显示骨架屏，告别突兀的白屏闪烁
🎨 Badge 标签：文件类型（ HTML/MD ）、权限状态（公开/私有）一目了然
** Modal 弹窗**：自定义 Modal 替代原生 prompt/confirm，风格统一
🔄 iframe Loading Spinner：预览页面加载中显示旋转指示器
📱 移动端优化：Toast 底部居中，预览页紧凑模式，触摸友好
🫙 空状态引导：没有文件时显示 CTA 按钮，引导用户开始上传

🛡️ 安全加固

v1.3 在安全层面做了多项增强：

CSP 策略：主页面启用 Content-Security-Policy ，渲染端点按需跳过
iframe Sandbox 加强：移除 allow-same-origin，进一步隔离渲染内容
Mermaid 安全等级：securityLevel 设为 strict，防止 SVG 注入
MCP 认证隔离：Token 认证不再创建 session ，避免会话污染
ZIP 安全防护：Zip Slip 路径穿越检测、膨胀炸弹限制、Symlink 拦截

📊 MCP 协议扩展

MCP Tools 从 6 个扩展到 15 个，新增：

类别	新增工具
版本管理	`list_file_versions`、`restore_file_version`
标签管理	`list_tags`、`add_tags_to_file`
收藏管理	`star_file`、`unstar_file`
分类管理	`list_categories`、`create_category`、`set_file_category`

upload_file 工具也增强了——支持 base64 编码的 ZIP 上传、覆盖指定文件、添加标签和分类，一次调用完成全部操作。

🏗️ 技术基础设施

数据库迁移系统：正式的 Migration Runner ，启动时自动执行未应用的迁移，升级无感
结构化日志：JSON Lines 格式输出，logger.info/warn/error/audit 四个级别，Docker logs 直接看，12-factor 标准实践
设置菜单分组：前端设置菜单按功能分组，结构更清晰

🎯 实战场景：从想法到链接，一句话搞定

v1.3 的功能不是孤立的——配合即页的 Claude Code Skill （ jpage-upload ），整个流程可以变成一句话的事：

产品经理：原型图秒出，不用等设计师

「帮我做一个电商首页原型，顶部搜索栏、中部商品瀑布流、底部导航栏」

Claude Code 生成完整 HTML → 自动上传即页 → 返回短链接 → 直接甩到产品群里。交互可点击，布局可调整，评审效率翻倍。

不用 Figma 画半天，不用截图发微信——原型直接在线可交互。

数据分析师：报告即出即分享

「根据这份 CSV 生成一份销售数据分析仪表板，带折线图和饼图」

AI 生成带 Chart.js 的完整 HTML 报告 → 上传即页 → 自动打上「报告」「 Q3 」标签 → 归入「数据分析」分类 → 短链接发邮件。

图表可交互，数据可筛选，不是截图，是活的报告。

技术写作者：Markdown 增强渲染，公式图表不崩

「写一份微服务架构设计文档，包含时序图和关键公式」

Markdown 文档自动上传，Mermaid 时序图完美渲染，KaTeX 数学公式原样展示。版本历史自动记录每次修改——文档即代码，版本可追溯。

前端开发者：Demo 秒分享，不用部署

「做一个带动画的登录页 Demo 」

ZIP 包上传——HTML + CSS + JS + 图片资源一键打包，上传后自动解压，资源路径自动处理。短链接发 PM ，30 秒从代码到可预览页面。

一句话总结：装上即页 Skill 后，你和 AI 的对话就是你的「发布工作流」。

生成 → 上传 → 分类 → 标签 → 短链接分享，全程零手动操作。

🌟 谁最适合升级？

如果你…	v1.3 带给你的价值
经常分享链接给客户/同事	短链接更专业，不再暴露内部结构
用 AI 生成完整的 HTML 项目	ZIP 上传一次搞定，资源路径自动处理
文件越来越多，管理混乱	标签 + 分类 + 收藏，三维度组织
团队多人使用即页	独立账号 + Token 隔离，各管各的
经常覆盖更新文件	版本历史兜底，随时回滚
用 MCP 对接 AI 工具	15 个 Tools 覆盖全生命周期

📊 与常见方案对比（ v1.3 更新版）

维度	即页 v1.3	GitHub Gist	语雀/Notion	Vercel
HTML 完整渲染	✅	❌ 仅代码	❌ 仅嵌入	✅
Markdown 增强	✅ 高亮+公式+图表	❌	⚠️ 基础	❌
自托管	✅ Docker 一键	❌	❌	❌
MCP 原生支持	✅ 15 个 Tools	❌	❌	❌
ZIP 网站包上传	✅ 自动解压预览	❌	❌	⚠️ 需仓库
版本历史	✅ 查看/恢复/删除	✅ Git 版本	✅	✅ Git 版本
文件组织	✅ 标签+分类+收藏	⚠️ 仅标签	✅	⚠️ 仓库组织
短链接	✅ `/s/:key`	✅	✅	⚠️ 需配置
多用户	✅ 角色隔离	❌	✅	⚠️ 团队版
上手门槛	🟢 极低	🟡 中	🟡 中	🔴 高

🏗️ 升级指南

已经部署了即页？升级非常简单：

cd jpage
git pull
docker-compose up -d --build

Migration Runner 会自动处理数据库升级，已有文件自动补生成短链接。无需手动操作。

🔮 下一步规划

搜索与筛选：文件名/内容全文搜索
数据统计仪表盘：存储使用、文件分布、上传趋势可视化
实时协作预览：多人同时查看同一文件
更多 AI 集成：智能摘要、自动标签推荐

🎁 开源免费，MIT 协议

即页采用 MIT 开源协议，免费商用、无功能限制。

GitHub 仓库： https://github.com/code2rich/jpage

如果你也觉得「 AI 生成的精美内容值得被完整呈现」，欢迎 Star ⭐、提 Issue 、贡献代码。

v1.1 ，解决了「能不能分享」的问题。

v1.2 ，解决了「分享得好不好看」的问题。

v1.3 ，解决了「分享之后怎么管理」的问题。

短链接让分享更专业，ZIP 上传让项目更完整，版本历史让修改更安心，标签分类让管理更高效，多用户让团队更协作。

即页，从「即用即走」进化为「即用即管理」。

拖入文件，即刻成页。

即页，让分享回归简单。