Cursor Beefreesdk 编码规范

Cursor Beefreesdk 编码规范：来自 PatrickJS/awesome-cursorrules (40k stars) 的 bee，适用于各类文档与内容的智能化处理。

Skill Documentation

Cursor Beefreesdk 编码规范

摘要

Cursor Beefreesdk 编码规范：来自 PatrickJS/awesome-cursorrules (40k stars) 的 bee，适用于各类文档与内容的智能化处理。

**文件来源:** PatrickJS/awesome-cursorrules → `rules/beefreeSDK.mdc`

**原仓库:** https://github.com/PatrickJS/awesome-cursorrules

**评分:** ⭐ 仓库 40k stars (社区最权威 Cursor rules 合集)

这个 skill 是干什么的?

把 `beefreeSDK.mdc` 这条 Cursor 编码规则打包成可调用的 AI skill,帮你把代码生成统一到一致的标准上。

> Guidelines and best practices for building applications with [Beefree SDK](https://docs.beefree.io/beefree-sdk), including installation, authentication, configuration, customization, and template management

🤖 Agent 使用说明

• **输入:** 一段要生成/重构的代码需求
• **输出:** 严格遵守 `beefreeSDK.mdc` 规则的代码
• **触发:** 用户说"用 X 规范写代码" / "按 beefreeSDK.mdc 风格生成" / "用 PatrickJS 的 X 规则"

👤 用户需要做什么?

• [ ] 知道这条规则适合用在什么场景(参考下面"适用场景")
• [ ] 把规则原文内容应用到 IDE 项目的 `.cursor/rules/` 目录(直接复制 .mdc 文件)
• [ ] 调本 skill 时说清楚你的代码任务(语言/框架/目标)
• [ ] 输出后人工 review 风格是否符合预期

适用场景

• 想用统一规范生成 `beefreeSDK.mdc` 项目代码
• 团队需要把 AI 代码生成收敛到固定风格
• 学习业界最佳实践的工程化模板

原始规则内容

globs: **/*.{ts,tsx,js,jsx,html,css}
alwaysApply: false
---
# Beefree SDK Guidelines
Guidelines and best practices for building applications with [Beefree SDK](https://docs.beefree.io/beefree-sdk), including installation, authentication, configuration, customization, and template management.

## Installation Guidelines

### Package Installation
- Install the Beefree SDK package using npm or yarn:

npm install @beefree.io/sdk

or

yarn add @beefree.io/sdk

### Dependencies
- Beefree SDK requires the following core dependencies:

{

"dependencies": {

"@beefree.io/sdk": "^9.0.2-fix-optional-url-config.0",

"axios": "^1.10.0",

"express": "^5.1.0",

"cors": "^2.8.5",

"dotenv": "^17.2.0"

}

}

### Environment Setup
- Create a `.env` file in your project root with your Beefree credentials:

BEE_CLIENT_ID=your_client_id_here

BEE_CLIENT_SECRET=your_client_secret_here

## Authentication Guidelines

### Proxy Server Setup
- ALWAYS use a proxy server for authentication to protect your credentials
- Create a proxy server file (e.g., `proxy-server.js`) to handle authentication:

import express from 'express';

import cors from 'cors';

import axios from 'axios';

import dotenv from 'dotenv';

dotenv.config();

const app = express();

const PORT = 3001;

app.use(cors());

app.use(express.json());

const BEE_CLIENT_ID = process.env.BEE_CLIENT_ID;

const BEE_CLIENT_SECRET = process.env.BEE_CLIENT_SECRET;

// V2 Auth Endpoint

app.post('/proxy/bee-auth', async (req, res) => {

try {

const { uid } = req.body;

const response = await axios.post(

'https://auth.getbee.io/loginV2',

{

client_id: BEE_CLIENT_ID,

client_secret: BEE_CLIENT_SECRET,

uid: uid || 'demo-user'

},

{ headers: { 'Content-Type': 'application/json' } }

);

res.json(response.data);

} catch (error) {

console.error('Auth error:', error.message);

res.status(500).json({ error: 'Failed to authenticate' });

}

});

app.listen(PORT, () => {

console.log(`Proxy server running on http://localhost:${PORT}`);

});

### Authentication Process
- Use the V2 authentication endpoint: `https://auth.getbee.io/loginV2`
- Pass the ENTIRE API response to the Beefree SDK, not just the token
- Example authentication call:

const token = await fetch('http://localhost:3001/proxy/bee-auth', {

method: 'POST',

headers: { 'Content-Type': 'application/json' },

body: JSON.stringify({ uid: 'demo-user' })

}).then(res => res.json());

## Container Setup Guidelines

### HTML Container
- Create a dedicated container element for the Beefree SDK:

<div id="beefree-sdk-container"></div>

### CSS Styling
- Style the container to ensure proper display:

#beefree-sdk-container {

position: absolute;

top: 0px;

botto

...(完整内容在原仓库)...

## 数据来源

- 仓库: PatrickJS/awesome-cursorrules (40,581 stars, 257 个 .mdc 规则)
- 抓取时间: 2026-08-17
- License: 跟随原仓库(MIT)

## 联系方式

有问题或建议,在本 skill 下留言。