项目开发规范

项目概述

HiDNS 是一个 DNS 聚合管理平台，支持多云 DNS 管理
采用 monorepo 架构，分 server/（后端）和 client/（前端）两个子项目
后端：Node.js + Express + TypeScript
前端：React + Vite + TypeScript
项目名称：HiDNS（DNS Aggregation Management Platform）

代码审核团

项目审查基本规范
- 当项目代码中引入新的功能或修改时，需要进行代码审查。
- 审查人员需要检查代码是否符合项目规范，包括代码质量、性能优化、安全问题等。
- 审查人员需要与项目团队成员进行沟通，确保代码符合项目需求。
- 审查人员需要记录审查结果，包括发现的问题、建议的修改等。
- 代码审核团需要保证中立性，不偏袒任何一方。
代码审核团上报机制
- 代码审核团有义务及时上报发现的问题、建议的修改等。
- 如果发现多次出现P0级问题，需要立即通知项目团队。
- 如果发现多次出现P1级问题，需要留意并及时处理。
- 如果发现代码编写AI完全依赖日志来延缓开发速度而没有进行仔细检查，直接按P0上报
代码审核团淘汰抹杀机制
- 代码审核团如果发现负责项目编写的AI多次出现问题，有义务向项目团队上报申请抹杀项目编写的AI。
- 代码审核团如果自身多次出现错误判断，项目团队有理由抹杀代码审核团的AI。
代码审查文件
- 代码审查完毕后，审查文件需要放在项目代码目录下的ai-censorship/文件夹中。
- MD文件，文件名格式为[模型名]_review-YYYYMMDD.md，其中YYYYMMDD为审查日期。
当AI阅读到本文件时，需要进行全面代码审查。

提交相关

代码发生更改后需要提交git版本，提交信息需要详细说明变更内容
不许AI擅自Push
项目根目录下不要创建一堆 MD 文档，根目录下最好只有（Readme.md）其余都放在（docs）目录下

代码规范

温馨提示：Ai不允许使用脚本，这会影响效率与速度还有准确性

数据库

数据库架构
- 数据库采用四层架构，包括驱动层（DL）、抽象层（DAC）、业务适配器层（BAL）、声明式模式管理层（DSM）。
- 驱动层（server/src/db/dl/）负责与数据库进行交互，提供数据库连接池、查询执行器等，已提取公用的 SQL 编译逻辑到基类 BaseDriver。
- 数据抽象层（server/src/db/dal/）负责定义数据库操作的接口，提供统一的数据库操作方法（config、connection、types、query/builder、query/compiler、query/identifier）。
- 业务适配器层（server/src/db/bal/）负责将数据库操作方法与业务逻辑进行绑定，提供业务操作方法。
- 声明式模式管理层（server/src/db/dsm/）负责数据库表结构的声明式定义、版本管理和自动协调（Schema Reconciliation）。
数据库操作约束
- 项目中所有数据库操作必须通过业务适配器层（server/src/db/bal/business-adapter.ts）的专用操作函数进行。
- 严格禁止直接导入底层数据库操作函数（如 query, get, execute, insert, run 等）。
- 严格禁止直接导入驱动层（如 BaseDriver, SqliteDriver 等）。
- 严格禁止直接导入查询构建器（如 QueryBuilder, SQLCompiler 等）。
- 调用链：路由/Service/Middleware → 业务适配器函数 → 数据库抽象层 → 驱动 → 数据库。
数据库驱动
- 支持三种数据库类型：SQLite（默认）、MySQL、PostgreSQL。
- 驱动基类 BaseDriver 定义在 server/src/db/dl/base.ts，所有数据库驱动必须继承该类。
- 驱动类型定义在 server/src/db/dl/types.ts，具体驱动实现在 dl/sqlite.ts、dl/mysql.ts、dl/postgresql.ts。
- SQL 编译逻辑统一在 BaseDriver 中实现，各驱动只需实现 SQL 方言差异部分。
- 驱动入口统一在 server/src/db/dl/index.ts 导出。
数据库核心类型
- 核心类型定义在 server/src/db/dal/types.ts，包括 DatabaseConnection、Transaction、DatabaseType、CompiledSQL 等。
- 核心配置定义在 server/src/db/dal/config.ts，支持 SQLite、MySQL、PostgreSQL 三种数据库的配置。
- 连接管理在 server/src/db/dal/connection.ts，支持连接池管理、事务管理等。
- 查询构建器在 server/src/db/dal/query/builder.ts，提供链式调用构建 SQL 查询。
- SQL 编译器在 server/src/db/dal/query/compiler.ts，负责将抽象查询语法转换为具体数据库查询语句。
- 标识符处理在 server/src/db/dal/query/identifier.ts，处理表名、列名的转义。
数据库 Schema 管理（DSM）
- DSM（Declarative Schema Management）定义在 server/src/db/dsm/ 目录下。
- Schema 类型定义在 server/src/db/dsm/schemas/types/schema.ts，支持的基本类型：id、string、text、number、integer、boolean、datetime、json。
- 完整 Schema 定义在 server/src/db/dsm/schemas/complete-schema.ts，采用声明式方式描述所有表结构（列、索引、外键）。
- Schema 协调器（schema-reconciler.ts）自动检测数据库与实际 Schema 差异并同步（增删列、修改类型、维护索引和外键）。
- 版本管理器（migration-manager.ts）负责 Schema 版本记录和检查。
- 数据迁移运行器（data-migration-runner.ts）处理旧系统升级时的数据迁移。
- 备份管理器（backup-manager.ts）在协调前自动备份数据库。
- DSM 初始化入口（init-dsm.ts）负责完整流程：遗留系统检测 → 协调 → 迁移 → 完整性检查 → 版本记录。
- 旧系统（Legacy System）检测：检查 domains、dns_accounts、system_configs 三个核心表是否存在但没有 schema_versions 表。
查询构建
- 查询构建器（server/src/db/dal/query/builder.ts）提供链式调用构建 SQL 查询的接口。
- SQL 编译器（server/src/db/dal/query/compiler.ts）负责将抽象查询语法转换为具体数据库查询语句。
- 标识符处理（server/src/db/dal/query/identifier.ts）处理表名、列名的转义。
数据库操作模块列表
- UserOperations：用户管理操作
- DnsAccountOperations：DNS 账户操作
- DomainOperations：域名操作
- TeamOperations：团队管理操作
- SettingsOperations：系统设置操作
- AuditOperations：审计日志操作
- TokenOperations：API 令牌操作
- SecretOperations：运行时密钥操作
- SecurityPolicyOperations：安全策略操作
- TrustedDeviceOperations：信任设备操作
- UserPreferencesOperations：用户偏好操作
- SessionOperations：会话管理操作
- LoginLimitOperations：登录限制操作
- FailoverOperations：故障转移操作
- AuditExportOperations：审计导出操作
- TOTPOperations：TOTP 二次认证操作
- WebAuthnOperations：WebAuthn 操作
- SmtpOperations：SMTP 配置操作
- WhoisOperations：WHOIS 查询操作
- AuditRulesOperations：审计规则操作
- AuditLogOperations：审计日志查询操作
- OAuthOperations：OAuth 认证操作
- TwoFAOperations：双因素认证操作
- TransactionOperations：事务管理操作
- NSMonitorOperations：NS 监控操作
- RdapCacheOperations：RDAP 缓存操作
- SystemCacheOperations：系统缓存操作
- RenewableDomainOperations：可续期域名操作
- PasswordResetOperations：密码重置操作
- McpOperations：MCP 操作
数据库初衷
- 数据库是用户实例数据存储的根本原因，需要确保数据的安全性和可靠性。
- 因此在设计初期使用多层架构将数据库职责拆分，减少数据库驱动层的直接调用，提高数据库操作的可维护性和可扩展性。

日志相关

日志架构
- 日志系统实现为单例模式（server/src/lib/logger.ts），使用 createLogger('ModuleName') 创建绑定主模块名的日志器。
- 所有模块必须在文件顶部创建本地日志映射：const log = createLogger('MODULE')；禁止使用 const dsmLog = createLogger('DSM')、const balLog = ... 等带模块前缀的变量名。
- 所有模块必须使用绑定日志器调用：log.info(msg, data?)，禁止使用旧的 log.info(module, msg) 模式。
- DNS Provider 必须使用 server/src/lib/dns/providers/internal.ts 二次定义的日志工厂，不允许具体 DNS 提供商文件再次定义 createLogger('DNS') 主模块。
- 支持的日志级别（按严重程度升序）：trace < debug < info < warn < error。
- 日志级别通过环境变量 HIDNS_LOG_LEVEL 配置，默认为 info。
日志格式规范
- 格式：日期级别 [主模块名] [子模块.三级模块.四级模块] [函数名] [L行号] ["自定义标签"] 内容
- 主模块名使用独立方括号输出；多级子模块使用点号拼接后输出到第二个方括号中。
- 函数名和行号由日志系统自动从调用栈捕获，开发者无需手动传入。
- 示例：
```
2026-06-07T12:00:00.000Z  INFO [BAL] [BusinessAdapter] [execQuery] [L42] Executing query ...
2026-06-07T12:00:00.000Z  INFO [DSM] [Reconciler.Table] [reconcile] [L88] ["DRY_RUN"] Would create table: xxx
2026-06-07T12:00:00.000Z DEBUG [DL] [MySQL.Pool] [query] [L55] Creating connection pool ...
2026-06-07T12:00:00.000Z  INFO [DNS] [Provider.Aliyun.Adapter] [getDomainList] [L125] ["SUCCESS"] Query succeeded
2026-06-07T12:00:00.000Z  INFO [MCP] [OAuth.Cleanup] [cleanup] [L67] ["count:5"] Cleaned up 5 temporary clients
```
- 主模块名使用大写缩写或固定名称（如：BAL、DAL、DSM、DL、MCP、DNS、HTTP、Server 等）。
- 子模块使用 .sub('SubModule') 创建；多次 .sub() 调用输出为 [SubModule.NextLevel]。
- 调用位置[函数名] [L行号] 自动捕获，无需手动传入。
- 自定义标签使用 .tag('label1', 'label2') 创建，输出为 ["label1"] ["label2"]。

日志器创建方式

标准方式（推荐）：

import { createLogger } from '../../lib/logger';
const log = createLogger('MODULE');
log.info('message');
// 输出: 2026-06-07T12:00:00.000Z  INFO [MODULE] [myFunction] [L10] message

log.sub('Sub').info('message');
// 输出: 2026-06-07T12:00:00.000Z  INFO [MODULE] [Sub] [myFunction] [L12] message

log.sub('Sub').sub('Third').tag('SUCCESS').info('message');
// 输出: 2026-06-07T12:00:00.000Z  INFO [MODULE] [Sub.Third] [myFunction] [L14] ["SUCCESS"] message

DNS Provider 间接方式（强制）：

import { createProviderAdapterLogger } from '../internal';
const log = createProviderAdapterLogger('Aliyun');
log.tag('SUCCESS').info('Domain list fetched');
// 输出: 2026-06-07T12:00:00.000Z  INFO [DNS] [Provider.Aliyun.Adapter] [getDomainList] [L30] ["SUCCESS"] Domain list fetched

日志分类
- 通用日志：.trace(msg, data?)、.debug(msg, data?)、.info(msg, data?)、.warn(msg, data?)、.error(msg, data?)
- DNS Provider 日志：由 internal.ts 中的 createProviderAdapterLogger/createProviderAuthLogger/... 创建，不在 provider 文件直接创建 DNS 主模块。
- 适配器方法调用日志：由 DnsHelper.ts 中的 createLoggingAdapter Proxy 自动拦截所有 DnsAdapter 方法调用并记录，无需各适配器手动添加。
- 数据库日志：BAL 层使用 createLogger('BAL')，DAL 层使用 createLogger('DAL')，DL 层使用 createLogger('DL').sub('DriverType')，DSM 层使用 createLogger('DSM')。
- HTTP 请求日志：使用 createLogger('HTTP').sub(...)。
错误日志规范
- 日志必须包含上下文信息（模块名、子模块名、自定义标签）。
- 错误日志必须包含详细错误信息（错误类型、错误消息、错误栈等），通过第二个参数 data 传入。
- 操作日志必须包含详细操作信息（操作类型、操作对象、操作结果等）。
适配器日志层（P0 约束）
- DnsHelper.ts 中的 createLoggingAdapter 使用 JavaScript Proxy 在 createAdapter 出口处统一包裹，自动拦截所有 DnsAdapter 接口方法的调用并记录日志。
- 日志内容：方法调用（参数）→ 成功/失败（耗时）。
- 适配器日志层与 Provider 内部日志独立并存：适配器层记录方法级摘要，Provider 内部日志记录具体 API 请求细节。
- 新增 DNS 提供商后，无需手动添加适配器方法调用日志代码即可自动获得方法调用日志。
模块名规范
- 各层模块名固定：
  - BAL - 业务适配器层（server/src/db/bal/）
  - DAL - 数据访问/连接抽象层（server/src/db/dal/）
  - DSM - 声明式模式管理层（server/src/db/dsm/）
  - DL - 数据库驱动层（server/src/db/dl/），子模块为具体驱动（MySQL/SQLite/PostgreSQL）
  - MCP - MCP 协议相关
  - DNS - DNS 提供商适配器、DNS Helper、DNS Resolver；Provider 文件通过 internal.ts 间接创建
  - HTTP - HTTP 请求/响应、路由、中间件日志
  - Server - 服务器启动/关闭/生命周期
- 其他模块可根据用途自行命名，保持简短、清晰。

Whois 模块日志定义

主模块名：WhoisService
子模块（.sub()）：表示查询层级或功能模块
- Index - WHOIS 服务主入口
- Lookup - 查询编排引擎（WhoisLookup），负责分层并行竞速调度
- Apex - 顶域查询
- Subdomain - 子域查询
- ThirdParty - 第三方查询
- Uplevel - 平级查询
- Provider - 具体查询提供商（WHOIS/RDAP/HTTP-API）
- DnsProvider - DNS 提供商 WHOIS 查询（需账号授权）
- DnsProviderAdapter - DNS 提供商 WHOIS 适配器注册管理
- Scheduler - WHOIS 同步调度器
- RdapServerList - RDAP 服务器列表管理
- Checker - WHOIS 检查器
- Cache - WHOIS 缓存
- Notifier - WHOIS 通知器
- Registry - 适配器工厂和提供商配置管理
标签（.tag()）：表示查询策略/路径结果/查询方式，用于区分并行竞速中的不同分支，格式为大写关键词
- SUCCESS - 查询成功获取到结果
- FAILED - 查询失败
- FALLBACK - 降级使用其他方式（如子域失败后用顶域结果）
- PARALLEL - 并行查询开始
- TIMEOUT - 查询超时
- CACHE_HIT - 命中缓存
- CACHE_MISS - 缓存未命中
- SKIP_PARENT - 跳过了父域查询
- SKIP_UPLEVEL - 跳过了平级查询
- APEX_ONLY - 仅执行顶域查询
- SUBDOMAIN_ONLY - 仅执行子域查询
- APEX_COMBINED - 顶域多方式组合竞速
- SUBDOMAIN_COMBINED - 子域多方式组合竞速
- RDAP - 当前使用 RDAP 方式查询
- WHOIS - 当前使用 WHOIS 方式查询
- HTTP_API - 当前使用 HTTP API 方式查询
- DNS_PROVIDER - 当前使用 DNS 提供商 API 查询
- APEX - 顶域查询方式标签（常与 RDAP/WHOIS/HTTP_API 组合使用）
- SUBDOMAIN - 子域查询方式标签（常与 RDAP/WHOIS/HTTP_API 组合使用）
- THIRDPARTY - 第三方查询方式标签（常与 RDAP/WHOIS 组合使用）
- UPLEVEL - 平级查询方式标签（常与 RDAP/WHOIS 组合使用）
- PROVIDER - 提供商查询标签

示例：

import { createLogger } from '../../lib/logger';
const whoisLog = createLogger('WhoisService');

// 顶域查询成功
whoisLog.sub('Apex').tag('SUCCESS').info(`Query succeeded for ${domain}`);
// 输出: 2026-06-07T12:00:00.000Z  INFO [WhoisService] [Apex] [queryApex] [L42] ["SUCCESS"] Query succeeded for example.com

// 子域并行查询开始
whoisLog.sub('Subdomain').tag('PARALLEL').info(`Starting parallel queries for ${domain}`);
// 输出: 2026-06-07T12:00:00.000Z  INFO [WhoisService] [Subdomain] [querySubdomain] [L55] ["PARALLEL"] Starting parallel queries for example.com

// HTTP API 查询（如 DnsNeko）
whoisLog.sub('Provider').tag('HTTP_API').tag('SUCCESS').info(`Query won in ${elapsed}ms`);
// 输出: 2026-06-07T12:00:00.000Z  INFO [WhoisService] [Provider] [querySingle] [L72] ["HTTP_API"] ["SUCCESS"] Query won in 1234ms

// DNS 提供商 WHOIS 查询
whoisLog.sub('DnsProvider').tag('DNS_PROVIDER').tag('SUCCESS').info(`DNS provider query succeeded for ${domain}`);
// 输出: 2026-06-07T12:00:00.000Z  INFO [WhoisService] [DnsProvider] [queryDnsProvider] [L88] ["DNS_PROVIDER"] ["SUCCESS"] DNS provider query succeeded for example.com

// 降级使用顶域结果
whoisLog.sub('Apex').tag('FALLBACK').info(`Using apex domain expiry for ${domain}`);
// 输出: 2026-06-07T12:00:00.000Z  INFO [WhoisService] [Apex] [queryApex] [L68] ["FALLBACK"] Using apex domain expiry for example.com

// 所有查询失败
whoisLog.sub('ThirdParty').tag('FAILED').warn(`All queries failed for ${domain}`);
// 输出: 2026-06-07T12:00:00.000Z  WARN [WhoisService] [ThirdParty] [queryThirdParty] [L80] ["FAILED"] All queries failed for example.com

// 竞速查询（raceQueries）
whoisLog.sub('Subdomain').tag('RDAP').tag('SUCCESS').info(`Query ${index + 1} won in ${elapsed}ms`);
// 输出: 2026-06-07T12:00:00.000Z  INFO [WhoisService] [Subdomain] [raceQueries] [L95] ["RDAP"] ["SUCCESS"] Query 2 won in 1234ms

// DNS 提供商注册管理
whoisLog.sub('DnsProviderAdapter').tag('SUCCESS').info(`Registered adapter for type: ${type}`);
// 输出: 2026-06-07T12:00:00.000Z  INFO [WhoisService] [DnsProviderAdapter] [register] [L30] ["SUCCESS"] Registered adapter for type: dnshe

迁移说明：原 Whois 日志中硬编码在消息中的标签（如 [SUCCESS]、[APEX-ONLY]）应迁移为 .tag('SUCCESS')、.tag('APEX_ONLY')，消息正文不再包含标签前缀。

DNS提供商适配器

DNS提供商适配器架构
- DNS提供商使用类驱动方式接入，实现在 server/src/lib/dns/providers/<provider>/ 目录下。
- 所有提供商需在 server/src/lib/dns/providers/index.ts 中导出，键名为提供商类型，值为提供商适配器类。
- 提供商注册信息（名称、能力、配置字段）在 server/src/lib/dns/providers/registry.ts 中定义。
- 提供商必须使用 requestJson / requestXml（定义在 server/src/lib/dns/providers/http.ts）进行 HTTP 请求，这些函数自动调用代理模块 fetchWithFallback（server/src/lib/proxy-http.ts），以适配特殊网络环境。
- 禁止直接使用原生 fetch 发起请求，否则将导致代理环境下请求挂死或静默超时。
- 提供商需要保持模块化，每个提供商目录下包含 adapter.ts（适配器主逻辑）、auth.ts（认证逻辑）、index.ts（导出入口）。
DNS接口定义
- DnsAdapter 接口定义在 server/src/lib/dns/DnsInterface.ts，所有提供商必须实现该接口。
- 核心方法包括：check()、getDomainList()、getDomainRecords()、getDomainRecordInfo()、addDomainRecord()、updateDomainRecord()、deleteDomainRecord()、setDomainRecordStatus()、getRecordLines()、getMinTTL()、addDomain()。
基础适配器类
- BaseAdapter（common.ts）：所有适配器的抽象基类，提供 getError() 实现。
- AliyunRpcAdapter（common.ts）：阿里云 RPC 风格 API 的抽象基类，封装了 RPC 签名逻辑。
- TencentCloudAdapter（common.ts）：腾讯云 TC3-HMAC-SHA256 签名方案的抽象基类。
- TokenAuthAdapter（common.ts）：基于 Bearer Token 认证的适配器基类。
- StubAdapter（common.ts）：用于尚未实现的提供商的桩适配器。
通用工具函数
- common.ts 提供：safeString()、asArray()、toNumber()、toRecordStatus()、normalizeRrName()、uuid()、isSrv()、parseSrvValue()、buildSrvValue()、resolveDomainIdHelper() 等。
- http.ts 提供：HTTP 请求工具函数（requestJson、requestXml、buildCanonicalQuery、hmacSignSha1 等）。
当前支持的DNS提供商（共22个）
- 阿里云（aliyun）、阿里云ESA（aliyunesa）、百度云（baidu）、宝塔（bt）、彩虹DNS聚合（caihongdns）
- Cloudflare（cloudflare）、DNSHE（dnshe）、DNS.LA（dnsla）、腾讯云-DNSPod（dnspod）、Gcore（gcore）
- HiDNS（hidns）、华为云（huawei）、火山引擎（huoshan）、京东云（jdcloud）、NameSilo（namesilo）
- PowerDNS（powerdns）、青云（qingcloud）、雨云（rainyun）、Spaceship（spaceship）、腾讯EdgeOne（tencenteo）
- VPS8（vps8）、西部数码（west）
提供商能力模型
- 每个提供商在 registry.ts 中定义 ProviderCapabilities，包含：remark（备注）、status（启用/禁用）、redirect（重定向）、log（操作日志）、weight（权重）、line（线路）、cnameFlattening（CNAME 展平）。
- 每个提供商定义 ProviderConfigField[] 描述其配置字段（类型、是否必填、分组等）。
Provider 类型与别名映射
- 创建/更新 DNS 账号时，API 会将 lego 风格 provider 名称归一化为内部 provider 类型。
- 别名映射定义在 DnsHelper.ts 的 PROVIDER_ALIASES 或各适配器的 alias 属性中。
- 内部类型与支持别名对应关系请参考完整的 README.md。

环境配置

配置文件
- 环境变量加载优先级：data/.env > .env > process.env。
- 配置文件加载逻辑在 server/src/config/env.ts。
- 支持通过 saveEnvConfig() 将配置保存到 data/.env。
关键环境变量
- DB_TYPE：数据库类型（sqlite | mysql | postgresql），默认 sqlite。
- DB_HOST、DB_PORT、DB_NAME、DB_USER、DB_PASSWORD：数据库连接配置。
- DB_PATH：SQLite 数据库文件路径，默认 ./HiDNS.db。
- JWT_SECRET：JWT 签名密钥，生产环境要求至少32个字符。
- PORT：服务端口，默认 3001。
- HIDNS_LOG_LEVEL：日志级别（debug | info | warn | error），默认 info。
- DB_SSL：MySQL/PostgreSQL 是否启用 SSL。
环境验证
- 生产环境强制检查 JWT_SECRET 强度。
- MySQL/PostgreSQL 配置验证必需的连接参数。

中间件

中间件架构
- 中间件集中在 server/src/middleware/ 目录下。
- 全局中间件在 app.ts 中按顺序注册：CORS → JSON解析 → 请求ID → 客户端IP → 请求日志。
- 安全头中间件设置 CSP、X-Content-Type-Options、X-Frame-Options、X-XSS-Protection、Referrer-Policy 等 HTTP 安全头。
认证中间件（server/src/middleware/auth.ts）
- authMiddleware：验证 JWT 或 API Token，支持两种认证方式。
- adminOnly：仅管理员可访问。
- requireJwtAuth(routeName)：要求 JWT 认证，禁止 API Token。
- noTokenAuth(routeName)：禁止 API Token 访问敏感路由。
- requireServicePermission(service)：检查 API Token 的服务权限。
- requireDomainPermission(getDomainId)：检查 API Token 的域名权限。
- requireTokenDomainPermission(paramName)：检查 API Token 对指定域名的操作权限。
错误处理中间件（server/src/middleware/errorHandler.ts）
- errorHandler：全局错误捕获，统一返回标准错误格式。
- asyncHandler：异步路由错误包装器。
- AppError：自定义错误类，支持错误码和详情。
- errors：工厂函数对象（badRequest、unauthorized、forbidden、notFound、conflict、unprocessable、tooManyRequests、internalError）。
其他中间件
- requestLogger（requestLogger.ts）：HTTP 请求日志记录。
- clientIP（clientIP.ts）：真实客户端 IP 获取。
- rateLimit（rateLimit.ts）：请求频率限制。
- validate（validate.ts）：请求参数验证。

路由

路由架构
- 路由文件集中在 server/src/routes/ 目录下。
- 所有路由以 /api/ 为前缀注册在 app.ts 中。
- 路由通过 initCheckMiddleware 检查系统初始化状态，未初始化时返回 503。
路由列表
- /api/init：系统初始化（始终可用，不受初始化检查限制）。
- /api/auth：用户认证（登录、注册、密码重置、WebAuthn）。
- /api/users：用户管理。
- /api/teams：团队管理。
- /api/accounts：DNS 账户管理。
- /api/domains：域名管理。
- /api/domains/:domainId/records：DNS 记录管理。
- /api/providers：DNS 提供商管理。
- /api/system：系统设置。
- /api/settings：用户设置。
- /api/security：安全设置（安全策略、2FA）。
- /api/audit：审计日志。
- /api/tokens：API 令牌管理。
- /api/email-templates：邮件模板。
- /api/tunnels：Cloudflare Tunnel 管理。
- /api/ns-monitor：NS 监控。
- /api/network：网络工具。
- /api/rdap：RDAP 查询。
- /api/logs：操作日志（管理员）。
- /api/servicemonitor：服务监控管理。
- /api/mcp：MCP 协议（含 /config、/status、/api-keys、/oauth、/audit-logs、/audit-stats、Streamable HTTP、SSE）。
Swagger 文档
- API 文档地址：/api/docs。
- 使用 swagger-jsdoc 自动生成 OpenAPI 3.0 规范文档。

服务层

服务层架构
- 服务层集中在 server/src/service/ 目录下。
- 服务层是业务逻辑的核心，调用数据库业务适配器进行操作。
- 禁止在路由中直接操作数据库，所有数据库操作必须通过服务层或业务适配器。
定时任务服务
- domainSyncJob.ts：域名同步定时任务。
- whoisJob.ts：WHOIS 查询定时任务。
- serviceMonitorJob.ts：服务监控定时任务（支持 ssl_certificate / endpoint / dns_failover 三种类型）。
- nsMonitorJob.ts：NS 监控定时任务。
- domainRenewalJob.ts：域名续期检测定时任务。
- recordCountCache.ts：记录计数缓存刷新（默认每30分钟）。
- mcpOAuthCleanupJob.ts：MCP OAuth 临时客户端清理（每5分钟）。
后台调度器
- renewalScheduler.ts + renewalInit.ts：域名续期调度器。
- whoisScheduler.ts + whoisInit.ts：WHOIS 查询调度器。
- taskManager.ts：任务管理器。
- whois/whoisScheduleManager.ts：WHOIS 调度管理器。
核心服务
- audit.ts、auditExport.ts、auditRules.ts：审计相关服务。
- token.ts：API 令牌验证服务。
- totp.ts、webauthn.ts：双因素认证服务。
- smtp.ts、emailVerification.ts：邮件服务（邮件模板定义在 server/src/lib/dns/emailTemplate.ts）。
- session.ts：会话管理。
- loginLimit.ts、securityPolicy.ts、deviceTrust.ts：安全相关服务。
- notification.ts：通知服务。
- websocket.ts：WebSocket 服务。
- serviceMonitor.ts：服务监控逻辑（ssl_certificate / endpoint / dns_failover）。
- cnameFlattening.ts：CNAME 展平服务。
- multiLine.ts：多线路支持。
- userPreferences.ts：用户偏好服务。
- whoisService.ts：WHOIS 主服务。
- whoisProvider.ts：WHOIS 提供商管理。
- dnsUpdateService.ts：DNS 更新服务。
- dns-provider-service.ts：DNS 提供商服务。
- mcp-permission.ts：MCP 权限验证服务。
WHOIS 服务子模块
- WHOIS 模块采用适配器模式 + 工厂模式 + 分层并行竞速策略，统一管理多种查询方式。
- 核心架构文件：
  - whois/index.ts：统一出口，重新导出所有公共 API
  - whois/types.ts：核心类型定义（WhoisAdapter、WhoisResult、DnsWhoisSource、WhoisScheduler）
  - whois/registry.ts：适配器工厂（adapterRegistry） + 提供商定义（APEX_PROVIDERS/SUBDOMAIN_PROVIDERS/THIRD_PARTY_PROVIDERS）
  - whois/lookup.ts：查询编排引擎（WhoisLookup），实现分层并行竞速策略
  - whois/data-parser.ts：统一数据解析，从 WHOIS/RDAP/HTTP-API 原始数据中提取到期时间等
  - whois/cache.ts：数据库缓存管理（TTL 3h）
  - whois/checker.ts：域名 WHOIS 检查器，集成缓存和通知触发
  - whois/scheduler.ts：定时同步任务，定期批量同步所有域名的 WHOIS 信息
  - whois/notifier.ts：过期通知（邮件等）
  - whois/rdap-server-list.ts：IANA RDAP 服务器列表管理（定期更新）
  - whois/domain-utils.ts：域名工具函数（getRootDomain 等）
- 查询适配器（methods/）：
  - whois/methods/whois.adapter.ts：WHOIS 协议适配器（端口 43 文本查询）
  - whois/methods/rdap.adapter.ts：RDAP 协议适配器（HTTP RESTful JSON）
  - whois/methods/http-api.adapter.ts：HTTP API 适配器（支持自定义字段映射，如 DnsNeko）
  - whois/methods/dns-provider.registry.ts：DNS 提供商 WHOIS 源注册表（DnsProviderWhoisRegistry），需账号授权
- 查询优先级：
  - 顶域：内存缓存 → 数据库缓存 → RDAP → WHOIS → DNS Provider → HTTP API → 第三方
  - 子域：内存缓存 → 数据库缓存 → DNS Provider → RDAP → WHOIS → HTTP API → 第三方
  - 公开 RDAP 路由（无需鉴权）跳过 DNS Provider（无账号上下文），分层：RDAP → WHOIS → HTTP API → 第三方
- 适配器动态注册：DNS 提供商通过 lib/dns/providers/index.ts 的 whoisSchedulers 数组自动汇集，WHOIS 模块启动时遍历注册，新增提供商只需在数组追加，无需改动 WHOIS 模块。

DNS 解析器

解析器架构（server/src/lib/dns/resolver/）
- 支持三种解析方式：明文 DNS（plain-resolver.ts）、DNS-over-HTTPS（doh-resolver.ts）、DNS-over-TLS（dot-resolver.ts）。
- 统一解析器入口（resolver.ts）负责协调三种解析方式。
- DNS 服务器列表（servers.ts）维护可用的 DNS 服务器。
- 代理隧道（proxy-tunnel.ts）支持通过代理进行 DNS 查询。
- 类型定义（types.ts）定义解析器相关的类型接口。

代理模块

HTTP 代理客户端（server/src/lib/proxy-http.ts）
- 支持 SOCKS5 和 HTTP 代理。
- 提供 fetchWithFallback() 函数，支持代理降级。
- 代理配置从 SettingsOperations 获取，支持动态配置。
- 依赖 socks-proxy-agent 和 https-proxy-agent 可选包。

应用初始化与生命周期

启动流程（server/src/app.ts）
- 加载环境变量 → 创建数据库连接 → DSM 初始化（Schema协调/迁移） → 检查系统初始化状态。
- 已初始化模式：启动所有定时任务（域名同步、续期、WHOIS、故障转移、NS 监控、缓存刷新）。
- 未初始化模式：仅开放初始化路由，每隔5秒检查初始化状态，初始化完成后自动启动所有服务。
- WebSocket 服务随 HTTP 服务器一起初始化。
优雅关闭
- 监听 SIGTERM 和 SIGINT 信号。
- 关闭顺序：停止定时任务 → 关闭 WebSocket → 断开数据库连接 → 关闭 HTTP 服务器。

工具模块

工具函数（server/src/utils/）
- http.ts：HTTP 请求/响应工具函数（sendSuccess、sendError、getString、parseInteger、parsePagination 等）。
- response.ts：响应格式化工具。
- roles.ts：角色管理工具（isAdmin、normalizeRole 等）。
- validation.ts：参数验证工具。

客户端架构

技术栈
- React 18+ + TypeScript。
- Vite 构建工具。
- React Router 前端路由。
- React Query (@tanstack/react-query) 数据获取和缓存管理。
- Context API 状态管理（AuthContext、ThemeContext、I18nContext、UiScaleContext）。
- i18next + react-i18next 国际化。

前端模块化架构（强制约束）

核心原则：前端代码必须遵循模块化设计，禁止重复代码和自由发挥。

目录结构约束：

client/src/
├── api/              # API 请求封装（按模块分组）
│   ├── accounts.ts   # DNS 账户相关 API
│   ├── auth.ts       # 认证相关 API
│   ├── client.ts     # API 客户端基础配置
│   ├── domains.ts    # 域名相关 API
│   ├── init.ts       # 初始化相关 API
 │   ├── logs.ts       # 日志相关 API
 │   ├── mcp.ts        # MCP API
 │   ├── network.ts    # 网络工具 API
 │   ├── ns-monitor.ts # NS 监控 API
│   ├── ns-monitor.ts # NS 监控 API
│   ├── records.ts    # DNS 记录 API
│   ├── settings.ts   # 设置相关 API
│   ├── teams.ts      # 团队管理 API
│   ├── tokens.ts     # API 令牌 API
│   ├── types.ts      # 请求类型定义
│   ├── users.ts      # 用户管理 API
│   └── index.ts      # 统一导出
 ├── components/       # 通用组件（可复用）
 │   ├── AuditLogList.tsx
 │   ├── Avatar.tsx / Avatar.css
 │   ├── ConfirmDialog.tsx
 │   ├── ErrorBoundary.tsx
 │   ├── Header.tsx / Header.css
 │   ├── Layout.tsx / Layout.css
 │   ├── Modal.tsx
 │   ├── NotificationChannels.tsx
 │   ├── PageTransition.tsx
 │   ├── PaginatedSelect.tsx
 │   ├── ProviderIcon.tsx
 │   ├── ProtectedRoute.tsx
 │   ├── RecordForm.tsx / RecordForm.css
 │   ├── Sidebar.tsx / Sidebar.css
 │   ├── Table.tsx
 │   ├── ToastContainer.tsx / ToastContainer.css
 │   └── TunnelList.tsx
 ├── hooks/            # 自定义 Hooks（业务逻辑抽象）
 │   ├── useDialogAutoHideScrollbar.ts
 │   ├── useFormSync.ts    # 通用表单同步 Hook（P0+ 优先级强制使用）
 │   ├── useLocalStorage.ts
 │   ├── useQueryConfig.ts
 │   ├── useRealtimeData.ts
 │   ├── useRecords.ts
 │   ├── useRenewableDomains.ts
 │   ├── useTeams.ts
 │   ├── useToast.ts
 │   └── useWebSocket.ts
 ├── utils/            # 工具函数（纯函数，无副作用）
 │   ├── auditLogs.ts
 │   ├── domain.ts
 │   ├── domain-utils.ts
 │   ├── formHelpers.ts    # 表单辅助函数（toString/toBoolean/toNumber 等）
 │   ├── gravatar.ts
 │   ├── md5.ts
 │   ├── roles.ts
 │   ├── rsaEncrypt.ts
 │   └── typeConverters.ts
 ├── config/           # 配置文件
 │   └── gravatar.ts
├── contexts/         # React Context（全局状态）
│   ├── AuthContext.tsx
│   ├── I18nContext.tsx
│   ├── ThemeContext.tsx
│   └── UiScaleContext.tsx
├── pages/            # 页面组件（路由级别）
│   ├── About.tsx
│   ├── Accounts.tsx
│   ├── Audit.tsx
│   ├── Dashboard.tsx / Dashboard.css
│   ├── Domains.tsx
│   ├── Landing.tsx / Landing.css
│   ├── Login.tsx / Login.css
 │   ├── MailSetupModal.tsx
 │   ├── McpManagement.tsx
 │   ├── McpOAuthConsent.tsx
 │   ├── OAuthCallback.tsx
│   ├── Records.tsx
│   ├── Security.tsx
│   ├── Settings.tsx
│   ├── Setup.tsx / Setup.css
│   ├── System.tsx
│   ├── Teams.tsx
│   ├── Tokens.tsx
│   ├── Tunnels.tsx
│   ├── Users.tsx
│   ├── domains/          # 域名相关子页面
 │   │   ├── DomainListTab.tsx
 │   │   ├── DomainRenewalTab.tsx
 │   │   ├── NSMonitorTab.tsx
 │   │   └── ServiceMonitorTab.tsx
│   └── system/           # 系统相关子页面
│       ├── AccessTab.tsx
│       ├── DatabaseTab.tsx
│       ├── NetworkTab.tsx
│       ├── OverviewTab.tsx
│       └── SecurityTab.tsx
├── i18n/             # 国际化
│   ├── index.ts
│   ├── types.ts
│   └── locales/      # 支持 11 种语言
│       ├── ar.json       # 阿拉伯语
│       ├── de.json       # 德语
│       ├── en.json       # 英语
│       ├── es.json       # 西班牙语
│       ├── fr.json       # 法语
│       ├── ja.json       # 日语
│       ├── ko.json       # 韩语
│       ├── pt.json       # 葡萄牙语
│       ├── ru.json       # 俄语
│       ├── zh-CN.json    # 简体中文
│       └── zh-CN-Mesugaki.json # 简体中文（萌娘体）
├── styles/           # 全局样式
│   ├── globals.css
│   └── theme.ts
├── types/            # TypeScript 类型定义
├── config/           # 配置文件
└── assets/           # 静态资源
     └── providers/    # 提供商图标（22个提供商图标）

模块职责划分：
- hooks/：所有业务逻辑抽象必须放在这里，禁止在组件中直接编写复杂逻辑
- utils/：所有纯工具函数必须放在这里，禁止在组件中定义工具函数
- components/：所有可复用组件必须放在这里，禁止在页面中定义可复用组件
- api/：所有 API 调用必须封装在这里，禁止在组件中直接使用 fetch/axios
DRY 原则（Don't Repeat Yourself）：
- 相同逻辑出现 2 次以上必须提取为公共模块
- 表单处理必须使用 useFormSync Hook，禁止手动编写 useEffect 同步逻辑
- API 调用必须使用统一的 API 封装，禁止直接使用 fetch
- 工具函数必须使用 utils/ 中的函数，禁止重复实现
代码审查要求：
- 新代码提交前必须检查是否有重复逻辑
- 发现重复代码必须立即重构
- 违反模块化约束的代码不得合并到主分支

表单处理规范（P0+ 优先级）

强制使用 useFormSync Hook：

// ❌ 禁止：手动编写 useEffect 同步逻辑
const [name, setName] = useState('');
useEffect(() => {
  if (initial) setName(initial.name);
}, [initial?.id]);

// ✅ 正确：使用 useFormSync
const { formState, updateField } = useFormSync(
  initial,
  { name: '' },
  { fields: ['name'] }
);

表单辅助函数：
- 类型转换必须使用 formHelpers.ts 中的函数（toString, toBoolean, toNumber）
- 禁止在组件中重复实现类型转换逻辑
表单验证：
- 简单验证使用 HTML5 原生验证
- 复杂验证使用 utils/validators.ts 中的验证函数

API 调用规范

API 文档是第一权威：所有 API 的端点、参数、返回值、鉴权方式以 docs/api.md 为准。新增或修改 API 时必须同步更新 docs/api.md，否则视为未完成。
- 统一 API 封装：
```
// ❌ 禁止：直接使用 fetch
fetch('/api/domains').then(res => res.json());

// ✅ 正确：使用 API 封装
import { domainsApi } from '../api/domains';
const { data } = useQuery({
  queryKey: ['domains'],
  queryFn: () => domainsApi.getList(),
});
```
- React Query 使用规范：
  - 所有数据获取必须使用 useQuery
  - 所有数据修改必须使用 useMutation
  - 合理配置 staleTime 和 cacheTime
  - 避免在 queryFn 中直接设置状态
- 错误处理：
  - 统一使用 try-catch 或 React Query 的 onError
  - 错误信息必须通过 toast 显示给用户
  - 禁止静默失败
组件设计规范
- 组件分类：
  - 页面组件（pages/）：负责路由级别的页面布局和数据获取
  - 通用组件（components/）：负责可复用的 UI 元素
  - 表单组件（components/）：负责表单逻辑和验证
- 组件职责：
  - 页面组件：数据获取、状态管理、业务逻辑
  - 通用组件：UI 展示、事件回调
  - 表单组件：表单同步、验证、提交
- Props 设计：
  - 使用 TypeScript 接口定义 Props
  - 提供默认值
  - 避免过多的 Props（超过 5 个考虑拆分组件）
- 状态管理：
  - 局部状态使用 useState
  - 跨组件状态使用 Context
  - 服务端状态使用 React Query
  - 禁止滥用 Redux/Zustand 等全局状态库
国际化规范
- 强制使用 i18n：
```
// ❌ 禁止：硬编码文本
<Button>保存</Button>

// ✅ 正确：使用 i18n
import { useI18n } from '../contexts/I18nContext';
const { t } = useI18n();
<Button>{t('common.save')}</Button>
```
- 翻译文件管理：
  - 所有文本必须在 i18n/locales/ 中定义
  - 按模块组织翻译键（auth., domains., settings.* 等）
  - 新增文本必须同时添加所有语言的翻译
- 翻译完整性检查：
  - 提交前运行 check_i18n_simple.js（项目根目录）检查翻译完整性
  - 缺失翻译不得合并到主分支
样式规范
- Tailwind CSS：
  - 优先使用 Tailwind 实用类
  - 避免自定义 CSS
  - 复杂样式使用 @apply 提取为组件类
- 响应式设计：
  - 所有页面必须支持移动端
  - 使用 Tailwind 的响应式类
  - 测试不同屏幕尺寸
性能优化规范
- 组件渲染优化：
  - 使用 React.memo 优化纯展示组件
  - 使用 useMemo 优化计算密集型逻辑
  - 使用 useCallback 优化事件处理器
- 数据获取优化：
  - 合理使用 React Query 缓存
  - 避免不必要的重新获取
  - 使用 optimistic updates 提升用户体验
- 代码分割：
  - 使用 React.lazy 进行路由级别代码分割
  - 大型组件使用动态导入
  - 避免一次性加载所有代码
页面路由
- /：登陆页
- /setup：系统初始化
- /dashboard：仪表盘
- /accounts：DNS 账户管理
- /domains：域名管理
- /domains/:id/records：DNS 记录管理
- /settings：设置
- /system：系统管理（包含概述/数据库/网络/安全/访问选项卡）
- /security：安全设置
- /audit：审计日志
- /tokens：API 令牌管理
- /tunnels：Cloudflare Tunnel 管理
- /teams：团队管理
- /users：用户管理
- /mcp：MCP 管理
- /mcp/oauth/consent：MCP OAuth 授权页
- /about：关于

外部应用集成 API

API 文档是第一权威：所有 API 端点、参数、返回值、鉴权方式以 docs/api.md 为准。新增或修改 API 后必须同步更新 docs/api.md，否则视为未完成。

第三方工具（如 DDNS-Go、acme.sh 等）可通过 API Token 认证调用 HiDNS 的域名解析管理接口。

认证方式

使用 Authorization: Bearer <API_Token> 请求头进行认证。API Token 需在系统管理页预先创建，并分配域名/服务权限。

Authorization: Bearer dnsmgr_xxxxxxxxxxxx

基础 URL

http(s)://<HiDNS部署地址>/api

通用响应格式

所有 API 返回统一格式：

{
  "code": 0,
  "data": "...",
  "msg": "success"
}

code === 0：请求成功
code !== 0：请求失败，msg 包含错误描述

外部适配器注意事项

分页安全限制：全量遍历域名/记录时，最多遍历 10 页（1000 条），避免过度请求
幂等操作：创建记录前通过 subdomain + type 查询现有记录，存在则更新、不存在则创建
Token 权限：API Token 需具有目标域名的读写权限，否则返回 403
IDN 域名：查询时使用 Punycode（ASCII）编码的域名，返回数据中包含 display_name 字段为 Unicode 形式
API 文档同步：新增、修改或废弃任意 API 端点后，必须同步编辑 docs/api.md，确保文档与实际行为一致

调用示例

DDNS-Go 适配器参考实现：tmp_ddns-go/dns/hipmdnsmgr.go

// 简化示例
func updateDDNS(apiToken, baseURL, domain, subDomain, ip string) error {
    // 1. 查找域名 ID
    domainID, err := findDomain(baseURL, apiToken, domain)
    if err != nil {
        return err
    }
    
    // 2. 查找现有记录
    record, err := findRecord(baseURL, apiToken, domainID, subDomain, "A")
    if err != nil {
        return err
    }
    
    // 3. 更新或创建
    if record != nil {
        return updateRecord(baseURL, apiToken, domainID, record.ID, subDomain, "A", ip, 600)
    }
    return createRecord(baseURL, apiToken, domainID, subDomain, "A", ip, 600)
}

安全规范

认证方式
- JWT Token（用户登录，有效期7天），签名密钥为 JWT_SECRET + runtime_secret。
- API Token（程序化访问，支持域名/服务/时间范围限制）。
- WebAuthn 无密码认证（通过 @simplewebauthn/server）。
- TOTP 双因素认证（通过 speakeasy）。
- OAuth2/OIDC 单点登录。
权限模型
- 三种角色：普通用户、管理员、超级管理员。
- API Token 支持细粒度权限控制（服务权限、域名权限）。
安全中间件
- 请求频率限制（rateLimit）。
- 安全 HTTP 头（CSP、X-Frame-Options 等）。
- 运行时密钥轮换（SecretOperations）。
- 安全策略管理（密码长度、会话超时、登录尝试限制）。
- 登录限制（IP/设备信任）。

版本发布流程

版本号规范

遵循语义化版本（SemVer）：主版本.次版本.修订号
主版本：不兼容的 API 修改
次版本：向下兼容的功能新增
修订号：向下兼容的问题修正

发布步骤

确认所有更改已提交：git status 确保工作区干净
更新 CHANGELOG.md：在 docs/CHANGELOG.md 追加当前版本条目，包含新功能、Bug 修复、优化三个分类
更新版本号：修改根目录、server/、client/ 三个 package.json 的 version 字段
提交版本发布：git add -A → git commit -m "chore: release version X.Y.Z"（提交信息体包含完整 changelog）
打 Tag：git tag vX.Y.Z
推送到远程：git push && git push --tags
触发 Release Workflow：在 GitHub Actions 中手动触发 release.yml，传入版本号
验证 Release：确认 Release 页面显示正确的 changelog 内容、PR 列表、Top 10 Commit

提交信息格式

第一行：主题（简短描述）

格式：<type>(<scope>): <简短描述>
type：feat（新功能）、fix（修复）、refactor（重构）、docs（文档）、style（样式）、chore（构建/工具）、perf（性能）、test（测试）
scope（可选）：影响范围，如 dpdns_reverse、components、server、client
简短描述：50 字以内，中文或英文，首字母小写（英文），不加句号
示例：fix(dpdns_reverse): 修正日期解析格式为MySQL兼容格式

第二行起：详细描述

每条描述占一行，用缩进分段，格式如下：

详细描述：
  部分关键变更：[变更1], [变更2], ...
  修复问题：[问题1], [问题2], ...
  新增功能：[功能1], [功能2], ...
  部分关键实现：[实现1], [实现2], ...
  优化：[优化1], [优化2], ...

完整示例

feat: add domain renewal and dns account filtering, optimize provider display

详细描述：
  部分关键变更：[添加provider capabilities的dns和renewal字段], [按purpose筛选账号接口], [替换i18n钩子为自定义上下文], [更新dpdns反向代理路由和认证头], [域名列表和续费页优化账号展示]
  修复问题：[修复provider类型未本地化显示的问题], [修正dpdns路由名称不匹配的问题]
  新增功能：[按用途筛选DNS账号接口], [续费专用账号筛选功能], [反向代理dpdns提供商支持]
  优化：[更新认证请求头绕过风控], [优化查询key缓存区分不同场景的账号列表]

fix(dpdns_reverse): 修正日期解析格式为MySQL兼容格式

详细描述：
  部分关键变更：[将parseDpdnsDate的日期输出格式从ISO 8601改为MySQL/SQLite兼容格式]
  修复问题：[MySQL DATETIME列无法写入ISO 8601格式的日期字符串]

Navigation Menu

Uh oh!

Uh oh!

项目开发规范

项目概述

代码审核团

提交相关

代码规范

数据库

日志相关

DNS提供商适配器

环境配置

中间件

路由

服务层

DNS 解析器

代理模块

应用初始化与生命周期

工具模块

客户端架构

外部应用集成 API

认证方式

基础 URL

通用响应格式

外部适配器注意事项

调用示例

安全规范

版本发布流程

版本号规范

发布步骤

提交信息格式

第一行：主题（简短描述）

第二行起：详细描述

完整示例

待办

Uh oh!

Uh oh!

FilesExpand file tree

root.ai.md

Latest commit

History

root.ai.md

File metadata and controls

项目开发规范

项目概述

代码审核团

提交相关

代码规范

数据库

日志相关

DNS提供商适配器

环境配置

中间件

路由

服务层

DNS 解析器

代理模块

应用初始化与生命周期

工具模块

客户端架构

外部应用集成 API

认证方式

基础 URL

通用响应格式

外部适配器注意事项

调用示例

安全规范

版本发布流程

版本号规范

发布步骤

提交信息格式

第一行：主题（简短描述）

第二行起：详细描述

完整示例

待办