LKS - 短链接生成器

基于 InsForge BaaS 构建的短链接生成服务。

技术栈

• React + TypeScript + Vite
• Tailwind CSS 3.4
• InsForge SDK

环境变量配置

本项目使用以下环境变量连接 InsForge 后端：

变量名	说明	获取方式
VITE_INSFORGE_BASE_URL	InsForge 后端地址	mcp__insforge__get-backend-metadata
VITE_INSFORGE_ANON_KEY	匿名访问密钥	mcp__insforge__get-anon-key

配置文件

1. 复制 .env.example 为 .env：

   cp .env.example .env

2. 使用 MCP 工具获取正确的值并填入 .env

⚠️ 重要警告

永远不要修改环境变量名称：

• VITE_INSFORGE_BASE_URL 和 VITE_INSFORGE_ANON_KEY 的名称必须与代码中 src/utils/insforge.ts 的配置完全一致
• 修改变量名将导致 SDK 无法连接后端，出现 ERR_NAME_NOT_RESOLVED 或 401 错误
• 如需更改后端地址，只修改变量值，不要改名

开发

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 运行测试
npm test

# 构建
npm run build

部署

使用 InsForge MCP 工具 create-deployment 进行部署。

项目结构

src/
  components/   # React 组件
  pages/        # 页面组件
  utils/        # 工具函数
  hooks/        # 自定义 Hooks
  types/        # TypeScript 类型
  i18n/         # 国际化配置

参考文档

• AGENTS.md - InsForge 开发指南
• docs/implementation/lks.md - 当前实现说明
• docs/runbook/lks.md - 故障排除与运维