diff --git a/doc/log.md b/doc/log.md
new file mode 100644
index 0000000..32033da
--- /dev/null
+++ b/doc/log.md
@@ -0,0 +1,9 @@
+# 日志设计
+
+## 酷炫的终端
+
+1. 非 debug 模式模仿 devspace：
+    1. 支持不同级别
+    2. 不同颜色
+    3. 长时间操作有转圈动画
+2. debug 模式下为常见日志库行为，这里内部选用的是`go.uber.org/zap`
\ No newline at end of file