技术栈与组织
网站使用 Next.js、App Router、React、TypeScript 和 Bootstrap 5,并辅以 BI3LYX 专属样式表。编辑页面由仓库中带类型的数据生成。
- app/
- 路由、布局、元数据、站点地图、RSS 源和状态路由。
- components/
- 可复用的界面组件,包括导航、卡片和浏览器。
- lib/
- 带类型的编辑数据、网站配置和未来 API 模型。
- tests/
- 内容、导航、组件和页面渲染测试。
本地命令
- npm install — 安装依赖。
- npm run dev — 启动开发服务器。
- npm run typecheck — 检查 TypeScript 而不生成文件。
- npm run lint — 使用 ESLint 分析代码。
- npm test — 运行测试套件。
- npm run build — 生成生产构建。
- npm start — 启动 Next.js 构建。
发布内容
文档页面和新闻由带类型的区块描述。每次新发布都必须提供唯一的 slug、标题、描述、日期以及不含未确认数据撰写的正文。
- 检查内部链接和元数据。
- 清楚标明准备中的信息。
- 绝不要发布虚构的统计数据或模拟截图。
- 发布前请人复核技术陈述。
API 集成规则
- 保持与显示组件分离的服务器访问层。
- 仅通过环境变量配置 API URL。
- 设置超时和明确的错误状态。
- 显示前验证响应模式。
- 绝不要暴露 RPC URL、密钥或钱包数据。
贡献与验证
- 不得从网站仓库直接修改生产基础设施。
- 任何变更都必须通过类型检查、lint、测试和构建。
- 提交和部署需要项目负责人的授权。
- 未经验证和签名,绝不从网站发布二进制文件。