docs: update README and SPEC for v0.4.0 features

Author: yeasy

README.md

@@ -52,6 +52,12 @@ Pin specific versions with `skill@v1.0` syntax. Track exact commits in `ask.lock
 ### 📊 Progress Tracking
 Real-time progress bars during installation and updates. Clear feedback on what's happening.
 
+### 🔌 Offline Mode
+Use `--offline` flag to work without network. Search uses cached results; perfect for air-gapped environments.
+
+### ⏱️ Performance Benchmarking
+Run `ask benchmark` to measure CLI performance (cold/hot search, config loading).
+
 ---
 
 ## 🚀 Quick Start
@@ -105,6 +111,9 @@ ask skill list                # View installed skills
 | `ask repo remove <name>` | Remove a source |
 | **Shell Completion** | |
 | `ask completion <shell>` | Generate completion script |
+| **Utilities** | |
+| `ask benchmark` | Run performance benchmarks |
+| `--offline` | Global flag: run without network |
 
 ---
 

README_zh.md

@@ -52,6 +52,12 @@
 ### 📊 进度追踪
 安装和更新过程中实时显示进度条。清晰反馈当前操作状态。
 
+### 🔌 离线模式
+使用 `--offline` 标志无需网络即可工作。搜索使用缓存结果，适用于无网络环境。
+
+### ⏱️ 性能基准测试
+运行 `ask benchmark` 测量 CLI 性能（冷/热搜索、配置加载）。
+
 ---
 
 ## 🚀 快速开始
@@ -103,6 +109,10 @@ ask skill list                # 查看已安装技能
 | `ask repo list` | 列出技能来源 |
 | `ask repo add <url>` | 添加自定义来源 |
 | `ask repo remove <名称>` | 移除来源 |
+| **工具命令** | |
+| `ask benchmark` | 运行性能基准测试 |
+| `ask completion <shell>` | 生成 shell 补全脚本 |
+| `--offline` | 全局标志：无网络模式 |
 
 ---
 

SPEC.md

@@ -36,9 +36,11 @@ ASK 是一个用于管理 AI Agent 技能的命令行工具，类似于 Homebrew
 
 ### 待实现功能 ⏳
 
-无（v0.3.0 建议功能）:
-- [ ] 性能基准测试
-- [ ] 离线模式
+v0.4.0 已实现:
+- [x] 性能基准测试 (`ask benchmark`)
+- [x] 离线模式 (`--offline`)
+
+v0.5.0 建议功能:
 - [ ] 插件系统
 
 ---
@@ -254,5 +256,6 @@ ask/
 
 | 日期 | 版本 | 变更 |
 |------|------|------|
+| 2026-01-16 | 0.4.0 | 新增离线模式 (`--offline`) 和性能基准测试 (`ask benchmark`) |
 | 2026-01-15 | 0.2.0 | CLI 重构：技能命令移至 `ask skill` 子命令；技能安装路径改为 `.agent/skills/`；新增 OpenAI 等默认仓库 |
 | 2026-01-15 | 0.1.0 | 初始版本，基本功能实现 |