# AI 开发入口 [!IMPORTANT]

- 本文档为项目级别规范和重要导航,必须严格参考
- 对我的回复/文档编写 ,必须是 中文为主体语言，技术术语保留英文原文
- 强制工作流：按下方索引表定位需要的文档 → 读取匹配文档 → 进入源码
- 禁止跳过文档检查直接写复杂业务；禁止已有对应文档却不读
- 索引表无匹配时，按本文件通用规则和现有同层代码风格实现
- 业务流程需要遵循 `主流做法` `工业级正规`
- 规范型文档是给 AI 的顶层入口文档，不是“解释得更全”就更好，而是要 更短、更硬、更可判定
- 本文档只允许在已有的结构上CURD,不允许增加其他标题区


## 工具使用规则

- **搜索范围限制**：Grep/Glob 严禁全盘搜索，绝对禁止扫描 `.gitignore` 忽略的目录，以避免性能卡顿。
- **读写**：所有文件读取/写入统一使用 UTF-8（建议无 BOM）
- **读写**：PowerShell/脚本读取项目文件必须显式指定 `-Encoding utf8`

## 当前项目代码要求

### 通用要求

- 优化代码时必须同时考虑冗余、孤岛代码、代码清晰度、复杂度、边界条件和兼容性，不能只追求功能跑通。
- 优化代码时不要修改ui/ux 视觉效果,除非明确要求。
- 先复用再新增
- 允许抽公共逻辑，但公共逻辑必须放在根级共享目录，并保证边界仍清晰。

### 项目偏好
- 

## 文档体系

开始写代码前，根据下表判断当前任务涉及哪些文档，有对应文档必须先读。
- .ai-specs 为规范根目录
- .ai-specs\coding-specs 
- .ai-specs\logic-specs

### 目录索引表

| 类型 | 路径 | 用途 | 说明 |
|:---|:---|:---|:---|

## 项目架构

### 模块说明


### 业务流转

#### 1. xxx

- 

## 命名规范

- 


### 模块词汇

| 中文 | 英文 | 说明 |
|:---|:---|:---|
| 设备 | device | 设备管理模块 |


## 可复用组件

- 

## 技术栈专项规范

### xxx
- 
