blade-code 0.0.7 → 0.0.9

package/README.md

@@ -52,6 +52,15 @@
 
 ---
 
+## 📖 文档
+
+- **[完整文档](docs/index.md)** - 文档中心导航
+- **[用户文档](docs/public/README.md)** - 安装、配置、使用指南
+- **[开发者文档](docs/development/README.md)** - 架构设计、技术实现
+- **[贡献指南](docs/contributing/README.md)** - 参与开源贡献
+
+---
+
 ## 🚀 快速开始
 
 ### ⚡ 零安装试用
@@ -260,6 +269,8 @@ blade --agents '{"reviewer": {"model": "qwen-max"}}' "审查代码"
 
 ### 安全与权限
 
+Blade 提供强大的三级权限控制系统（allow/ask/deny）：
+
 ```bash
 # 跳过权限检查（危险）
 blade --dangerouslySkipPermissions "执行命令"
@@ -278,6 +289,30 @@ blade --permissionMode acceptEdits "修改代码"  # 自动接受编辑
 blade --addDir /path/to/dir "访问目录"
 ```
 
+**权限配置示例** (`.blade/settings.json`):
+```json
+{
+  "permissions": {
+    "allow": [
+      "Read(file_path:**/*.ts)",
+      "Grep",
+      "Glob"
+    ],
+    "ask": [
+      "Write",
+      "Edit",
+      "Bash(command:npm *)"
+    ],
+    "deny": [
+      "Read(file_path:.env)",
+      "Bash(command:rm -rf *)"
+    ]
+  }
+}
+```
+
+详见 [权限系统指南](docs/public/configuration/permissions.md)
+
 ### IDE 集成
 
 ```bash
@@ -397,13 +432,19 @@ Blade Code 采用现代化的扁平化架构设计：
 
 ```
 src/
-├── agent/          # Agent 核心逻辑
+├── agent/          # Agent 核心逻辑和控制器
 ├── cli/            # CLI 配置和中间件
-├── commands/       # 命令处理器
-├── config/         # 配置管理
-├── tools/          # 工具系统
-├── ui/             # UI 组件（基于 Ink）
-├── services/       # 共享服务
+├── commands/       # CLI 命令定义和处理
+├── config/         # 统一配置管理（双文件系统）
+├── tools/          # 工具系统（含执行管道）
+│   ├── builtin/    # 内置工具
+│   ├── execution/  # 6阶段执行管道
+│   ├── registry/   # 工具注册中心
+│   └── validation/ # 参数验证
+├── ui/             # UI 组件和界面（基于 Ink）
+├── services/       # 共享服务层
+├── prompts/        # 提示模板管理
+├── mcp/            # MCP 协议实现
 └── utils/          # 工具函数
 ```
 
@@ -414,6 +455,9 @@ src/
 - 🎨 **React for CLI**：基于 Ink 的现代化 UI
 - 🔧 **TypeScript**：完整类型支持
 - ✅ **全面测试**：单元、集成、E2E 测试覆盖
+- 🔒 **6阶段执行管道**：Discovery → Validation → Permission → Confirmation → Execution → Formatting
+- 🛡️ **三级权限控制**：allow/ask/deny 精细化权限管理
+- 🎯 **双配置文件系统**：config.json（基础配置） + settings.json（行为配置）
 
 ---