diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..1d1fe94
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1 @@
+Dockerfile
\ No newline at end of file
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3cacfea
--- /dev/null
+++ b/README.md
@@ -0,0 +1,35 @@
+# Knowai Dev 镜像维护文档
+
+## 分支职责
+负责提供包含开发依赖（基于Base镜像）的CI测试镜像
+不包含任何业务代码或配置，仅提供基础依赖环境。
+
+## 镜像标签命名规范
+- 格式：`gitea.local.knowai/tobegold574/knowai-dev:主版本号.次版本号.修订号`
+- 示例：`gitea.local.knowai/tobegold574/knowai-dev:1.0.0`
+- 版本规则：
+  - 主版本号：不兼容的框架或依赖变更
+  - 次版本号：兼容性增强或批量依赖升级
+  - 修订号：小幅依赖更新或新增兼容依赖
+- `latest` 标签默认指向当前稳定版本（谨慎更新）
+
+## 全局依赖
+- 与Base镜像全局依赖一致
+- 新增开发依赖：
+  - typescript@^5.2.0
+  - eslint@^9.39.1
+  - @eslint/js@^9.39.1
+  - @typescript-eslint/parser@^8.46.3
+  - @typescript-eslint/eslint-plugin@^8.46.3
+  - vitest@^0.34.1
+  - @vitest/coverage-v8@^0.34.1
+  - @types/node@^20.0.0
+  - @types/lodash@^4.14.0
+
+## 更新记录
+
+### 2025-11-11
+- 新增开发依赖，推送1.0.0版本
+
+---
+*仅负责全局性依赖更新，业务功能在各功能分支独立开发，构建独立镜像*
\ No newline at end of file