AI 大鱼的AI实验室

实验 / 进行中

AI实验清单系统网站

一个自托管的 AI 实验清单与内容管理系统，用 Astro/React/Hono/SQLite 管理实验、进度、文章、截图资产、标签与公开展示，并支持私有后台、Token API、CSV 导入导出、备份恢复和生产部署。

项目说明

项目定位

AI实验清单系统网站是“AI实验室清单”的自托管 CMS，用来集中记录想法、实验项目、开发进度、文章教程、截图素材和可公开展示的复盘内容。它不是单纯的静态展示页，而是一个带后台、API、权限、导入导出和部署运维能力的完整实验管理系统。

核心功能特点

  • 实验清单管理：支持实验编号、标题、slug、摘要、详细描述、状态、可见性、记录/开始/完成日期、收益、视频状态、封面资产和手动排序。
  • 进度记录管理：每个实验可挂载多条进度，区分私有工作记录与可公开内容，支持日期、标题、来源、视频收录状态等字段。
  • 文章与教程管理：支持文章、教程、笔记、案例、更新日志等内容类型，并可关联实验项目。
  • 公开站点展示：提供首页、实验列表、实验详情、博客、标签页、归档、搜索、RSS 和 sitemap，只展示被主动设为公开的内容。
  • 后台管理界面：Astro 页面结合 React 管理组件，实现实验编辑、进度编辑、文章编辑、资产管理、标签管理、Token 管理、设置页和活动日志查看。
  • 富文本与图片工作流：Markdown 渲染预览，支持粘贴截图或选择图片上传，自动生成 Markdown 图片引用，并可按关联对象保存资产元数据。
  • 标签体系：支持标签创建、管理和为实验/文章分配标签，方便后续分类、检索和公开展示。
  • 搜索与筛选：后台实验列表支持关键词、状态、可见性筛选；公共侧也有搜索入口。
  • CSV 导入导出：支持从现有 Excel/CSV 字段导入实验清单，也支持 JSON/CSV 导出，方便迁移和备份。
  • 自动化 API：提供 /api/v1 接口、OpenAPI 输出、Bearer Token、作用域权限、每日进度 ingest 等，方便 Codex/OpenClaw 这类自动化客户端写入实验进展。
  • 权限与隐私控制：后台使用管理员会话登录；API Token 可按 scope 授权；实验、进度、文章、资产都具备 private/public 等可见性控制，公共页面避免泄露私有内容。
  • 运维与部署：包含 Node 22、systemd、nginx、HTTPS、健康检查、数据库迁移、部署脚本、生产环境变量和 Oracle/Ubuntu VM 部署说明。
  • 备份与恢复：内置本地备份、生产加密备份、systemd 定时器、GitHub Release 上传配置和 restore-check 校验脚本。
  • 质量保障：配置 TypeScript/Astro 检查、Vitest 单元测试与端到端测试，覆盖权限、公开隐私隔离、后台流程、API schema、资产上传、富文本 Markdown 等关键路径。

技术实现

  • 前端/页面：Astro + React 管理组件 + Tailwind CSS。
  • 服务端：Hono 路由挂载在 Astro Node adapter 下。
  • 数据层：SQLite + better-sqlite3 + Drizzle schema。
  • 校验与文档：Zod schema 与 zod-to-openapi。
  • 内容渲染：Markdown-it 渲染 Markdown 内容。
  • 自动化脚本：tsx 脚本用于迁移、备份、恢复校验、创建管理员密码 hash、创建 API Token、提交每日摘要。

当前状态

项目已经具备可运行的 CMS 主体能力：清单、进度、文章、资产、标签、公开站点、后台管理、API、导入导出、备份恢复和部署文档均已实现。近期重点优化了实验列表可见性、筛选控件、默认选中最新实验、拖拽排序、富文本图片预览、图片上传方式、实验编辑布局、字段保留和生产环境部署细节。

后续可完善方向

  • 继续打磨后台中文文案、交互细节和批量编辑效率。
  • 扩展公开页面的信息架构，例如更多实验筛选、时间线或专题集合。
  • 为自动化写入增加更多幂等更新策略和更细粒度的审计视图。
  • 根据实际运营情况补充数据看板、视频发布状态联动和素材复用能力。

公开截图

还没有公开截图。

公开进度

  1. 修复实验列表条目可见性，保持后台列表稳定可浏览

    修复了后台实验列表在部分布局下条目不可见或浏览不稳定的问题。

    实验列表是整个 CMS 的高频入口，列表内容必须稳定显示，后续的筛选、排序和编辑流程才不会被布局问题打断。这次调整主要提升后台管理页面的稳定性和可浏览性。

  2. 优化实验列表筛选控件、状态徽标和响应式布局

    继续优化后台实验列表的筛选和信息展示。实验列表的关键词、状态、可见性筛选控件排列更清晰，状态与可见性徽标也更容易扫描。

    同时修复了筛选区域在部分窗口宽度下容易重叠的问题，让后台在不同屏幕尺寸下都能保持可用。这一步让实验清单从“功能可用”进一步变成“长期使用不容易乱”。

  3. 明确实验创建动作，减少后台操作歧义

    调整了后台实验创建入口的交互表达，让“新增实验”和“保存已有实验”的状态更加清楚。

    这个改动主要是减少后台操作歧义。实验清单会频繁新增条目，如果创建动作不明确，容易造成误操作；这次优化让录入流程更稳定，也更适合持续维护大量实验想法。

  4. 修正实验列表选中与滚动定位体验

    优化了后台实验列表的选择体验。现在进入后台或切换实验时，当前选中的实验会更自然地定位到可见区域，默认也会优先选中最近的实验。

    这类改动不新增大功能，但会直接影响日常编辑效率：当实验数量逐渐变多时，用户不需要反复在列表中重新寻找当前正在编辑的条目。

  5. 打磨后台编辑体验、排序、富文本图片和 Markdown 展示

    围绕“更适合长期记录实验过程”做了一轮后台和内容展示打磨。实验编辑器布局更完整，实验列表支持排序和筛选，公开首页和整体主题也进行了刷新。

    这次还补上了富文本图片工作流：可以在实验、进度和文章里粘贴截图或上传图片，并自动生成 Markdown 图片引用。公开实验详情和博客详情也开始渲染 Markdown 内容，让项目记录可以承载截图、教程和复盘，而不只是纯文本备注。

  6. 完成 AI 实验清单 CMS 从架构到 MVP 的主体建设

    完成了 AI 实验清单 CMS 的主体搭建，从项目脚手架、数据库模型、领域服务到 API、后台管理和公开展示页面，形成了一个可以持续记录 AI 实验的基础系统。

    公开侧已经具备实验列表、实验详情、博客、标签、RSS 和 sitemap；后台侧可以管理实验、进度、文章、资产、标签和 API Token。系统同时加入了登录保护、Token 授权、导入导出、备份恢复和生产部署配置，为后续长期运营打下基础。

还没有关联的公开文章。