爱意满满的作品展示区。
heyzen

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

  •  
  •   heyzen · 1 day ago · 710 views

    即页 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️⃣ 多用户管理:团队协作的基础

    • 角色系统adminuser 两种角色,权限分明
    • 用户管理界面:管理员可创建、编辑、删除用户
    • 文件隔离:普通用户只能看到自己的文件和公开文件,管理员看全局
    • 用户级 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_versionsrestore_file_version
    标签管理 list_tagsadd_tags_to_file
    收藏管理 star_fileunstar_file
    分类管理 list_categoriescreate_categoryset_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 上传让项目更完整,版本历史让修改更安心,标签分类让管理更高效,多用户让团队更协作。

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


    拖入文件,即刻成页。

    即页,让分享回归简单。


    2 replies    2026-06-09 23:42:43 +08:00
    RoderickQiu
        1
    RoderickQiu  
       9h 36m ago
    感觉上有意思;就是能不能做一个类似 gist 的,你们 host 的版本;然后比如按量计费,我感觉可以买啊,要不然要自己配置还是太麻烦了(比如手机上不在内网里就看不了);现在基本上我的各种 plan 和分析都是 html 的了,如果能一键发网上公网链接,就比用飞书 cli 传到飞书上方便了
    heyzen
        2
    heyzen  
    OP
       1h 44m ago
    @RoderickQiu 有这个商业化的想法,不过商业化可以再等等; 我还有几个 idea 要往上面做;
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   1302 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 68ms · UTC 17:26 · PVG 01:26 · LAX 10:26 · JFK 13:26
    ♥ Do have faith in what you're doing.