PinMe

PinMe 是一个专注于简化全栈项目交付的零配置部署命令行工具。它旨在通过一条命令快速搭建并启动包含集成前端、Worker 后端和数据库的完整 Web 应用，消除繁琐的服务器配置、域名绑定及 SSL 证书管理过程。PinMe 结合 AI 辅助开发流程，为开发者提供从项目创建到云端发布的无缝体验。

核心特性

• 🚀 一键全栈搭建：只需一条命令即可生成包含前端、Worker 后端及数据库迁移文件的标准化项目结构。
• 🔒 安全与去中心化：基于密码学原理的部署方案，提供端到端安全保障，防止内容篡改，无需信任第三方托管商的基础设施安全性。
• ⚡ 分层更新机制：支持针对前端、Worker 后端或数据库进行独立的增量更新，显著提升迭代效率。
• 🤖 AI 原生集成：提供专用的 PinMe Skill，可与主流 AI 编码助手（如 Cursor, Claude Code 等）深度配合，实现智能化的项目初始化与维护。

快速开始指南

1. 安装 PinMe Skill (可选但推荐)

如果你使用支持 Agent Skills 的 AI 编码环境，建议先安装专用技能以增强 AI 对 PinMe 工作流的理解：

npx skills add glitternetwork/pinme --all

2. 安装 CLI 工具

全局安装 PinMe 命令行工具：

npm install -g pinme
pinme --version # 验证安装

3. 登录账号

在创建项目前需完成身份认证：

pinme login
# 推荐使用浏览器自动登录

4. 创建全栈项目

生成一个新的全栈应用骨架：

pinme create my-app
# 若目录已存在且希望覆盖，可加 --force 参数

5. 首次部署

进入项目目录并执行完整保存流程（涵盖构建、部署及数据库迁移）：

cd my-app
pinme save

6. 增量更新

后续开发中，可根据修改内容选择性地更新特定层级：

• pinme update-web：仅更新前端静态资源。
• pinme update-worker：仅更新 Worker 后端逻辑。
• pinme update-db：仅执行 SQL 迁移文件。

静态站点托管

如果仅需托管现有的静态产物（如 React/Vue 构建后的 dist 或 build 目录），可直接使用上传命令：

pinme upload dist

项目结构概览

一个典型的 PinMe 项目包含以下核心部分：

• frontend/：前端应用源码。
• backend/：Worker 后端业务逻辑。
• db/：SQL 数据库迁移脚本。
• pinme.toml：项目元数据配置文件，记录部署后的访问 URL 等信息。

参考Demo：

• 人力发电机：https://7b08da33.pinme.dev