feat: 更新版本至0.0.14并重构存储路径结构

重构存储路径从项目内.bar/迁移到~/.bar/目录
新增GlobalBarDir()和ProjectID()函数
移除.gitignore检查逻辑
添加路径相关单元测试
更新CHANGELOG.md和文档
改进release.sh脚本支持版本管理

Author: echoVic

CHANGELOG.md

@@ -0,0 +1,81 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.0.13] - 2026-02-01
+
+### Changed
+- Web UI 改进
+
+## [0.0.12] - 2026-02-01
+
+### Fixed
+- 修复 wrapped 命令退出时关闭 Web UI
+
+## [0.0.11] - 2026-02-01
+
+### Fixed
+- 修复 wrapped 命令退出后保持 Web UI 运行
+
+## [0.0.10] - 2026-02-01
+
+### Changed
+- `bar wrap` 默认启用 Web UI
+
+### Fixed
+- 修复 `bar wrap --ui` 的 URL 格式
+
+## [0.0.9] - 2026-02-01
+
+### Added
+- `bar wrap` 新增 `--ui` 参数
+
+## [0.0.8] - 2026-02-01
+
+### Changed
+- Web UI v2 重新设计（Split View + Monaco Editor）
+
+## [0.0.7] - 2026-02-01
+
+### Added
+- Web UI 任务审计界面
+
+## [0.0.6] - 2026-02-01
+
+### Fixed
+- 修复 release 脚本中 cmd/bar 文件强制添加
+
+## [0.0.5] - 2026-02-01
+
+### Added
+- `bar wrap` 自动初始化并创建任务
+
+## [0.0.4] - 2026-02-01
+
+### Added
+- `bar update` 命令
+- `bar version` 命令
+
+## [0.0.3] - 2026-02-01
+
+### Added
+- 任务启动时自动初始化 BAR
+
+## [0.0.2] - 2026-02-01
+
+### Added
+- `bar wrap` 命令，支持交互式 Agent
+- curl 安装脚本
+- GitHub Pages 短链接安装
+
+## [0.0.1] - 2026-02-01
+
+### Added
+- 初始实现 Blade Agent Runtime (BAR)
+- 核心功能：任务管理、diff/apply、workspace 管理
+- CLI 命令：init, task, run, diff, apply, rollback, status, log
+- Policy 引擎
+- 单元测试

cmd/bar/init.go

@@ -3,13 +3,11 @@ package main
 import (
 	"os"
 	"path/filepath"
-	"strings"
 
 	"github.com/spf13/cobra"
 
 	"github.com/user/blade-agent-runtime/internal/core/config"
 	"github.com/user/blade-agent-runtime/internal/core/task"
-	utillog "github.com/user/blade-agent-runtime/internal/util/log"
 	utilpath "github.com/user/blade-agent-runtime/internal/util/path"
 )
 
@@ -45,7 +43,6 @@ func initCmd() *cobra.Command {
 				return err
 			}
 			app.Logger.Info("Initialized BAR in %s", app.BarDir)
-			checkGitignore(app.RepoRoot, app.Logger)
 			return nil
 		},
 	}
@@ -104,7 +101,6 @@ func initAppWithAutoInit() (*App, error) {
 	if err != nil {
 		return nil, err
 	}
-	checkGitignore(repoRoot, app.Logger)
 	return app, nil
 }
 
@@ -131,20 +127,5 @@ func ensureBarInit(app *App) error {
 		return err
 	}
 	app.Logger.Info("Initialized BAR in %s", app.BarDir)
-	checkGitignore(app.RepoRoot, app.Logger)
 	return nil
 }
-
-func checkGitignore(repoRoot string, logger *utillog.Logger) {
-	path := filepath.Join(repoRoot, ".gitignore")
-	data, err := os.ReadFile(path)
-	if err != nil {
-		logger.Info("Tip: Add '.bar/' to your .gitignore")
-		return
-	}
-
-	content := string(data)
-	if !strings.Contains(content, ".bar/") && !strings.Contains(content, ".bar") {
-		logger.Info("Tip: Add '.bar/' to your .gitignore")
-	}
-}

cmd/bar/update.go

@@ -16,7 +16,7 @@ const (
 	repoOwner      = "echoVic"
 	repoName       = "blade-agent-runtime"
 	installURL     = "https://echovic.github.io/blade-agent-runtime/install.sh"
-	currentVersion = "0.0.13"
+	currentVersion = "0.0.14"
 )
 
 func updateCmd() *cobra.Command {

docs-md/architecture.md docs/architecture.mddocs-md/architecture.md renamed to docs/architecture.md

@@ -0,0 +1,93 @@
+# 存档目录迁移：从 `.bar` 到 `~/.bar`
+
+## 背景
+
+原设计将存档目录放在项目内的 `.bar/`，存在以下问题：
+1. 每个项目都需要在 `.gitignore` 中添加 `.bar/`
+2. 不符合常见 CLI 工具的惯例（如 `~/.npm`, `~/.cargo`, `~/.docker`）
+3. workspaces 使用 git worktree 会在项目内创建大量副本
+
+## 设计决策
+
+### 方案对比
+
+| 方案 | 结构 | 优点 | 缺点 |
+|------|------|------|------|
+| A: Hash 映射 | `~/.bar/repos/<hash>/` | 绝对唯一 | 不直观，需要额外映射文件 |
+| B: 项目名分组 | `~/.bar/projects/<name>/` | 直观可读 | 同名项目冲突 |
+| C: 项目名+Hash | `~/.bar/projects/<name>-<hash4>/` | 直观且唯一 | 名称稍长 |
+
+**最终选择方案 C**：`<项目名>-<路径SHA256前4位>`，兼顾可读性和唯一性。
+
+## 新目录结构
+
+```
+~/.bar/
+├── config.yaml                          # 全局配置（可选）
+└── projects/
+    └── <project_name>-<hash4>/          # 如 "blade-agent-runtime-a3f2"
+        ├── state.json
+        ├── tasks/
+        │   └── <task_id>/
+        │       ├── task.json
+        │       ├── ledger.jsonl
+        │       └── artifacts/
+        └── workspaces/
+            └── <task_id>/
+```
+
+**命名规则**: `<项目目录名>-<路径SHA256前4位>`
+- 例如: `/Users/bytedance/Documents/GitHub/blade-agent-runtime` → `blade-agent-runtime-a3f2`
+
+## 修改文件清单
+
+| 文件 | 修改内容 |
+|------|----------|
+| `internal/util/path/path.go` | 新增 `GlobalBarDir()` 返回 `~/.bar`；新增 `ProjectID(repoRoot)` 生成 `name-hash4` |
+| `cmd/bar/root.go` | 修改 `initApp()` 使用新的 barDir 路径 |
+| `cmd/bar/init.go` | 移除 `.gitignore` 检查逻辑 |
+| `internal/core/config/model.go` | 调整默认 policy 路径 |
+
+## 具体修改
+
+### 1. `internal/util/path/path.go`
+```go
+func GlobalBarDir() string {
+    home, _ := os.UserHomeDir()
+    return filepath.Join(home, ".bar")
+}
+
+func ProjectID(repoRoot string) string {
+    name := filepath.Base(repoRoot)
+    hash := sha256.Sum256([]byte(repoRoot))
+    return fmt.Sprintf("%s-%x", name, hash[:2]) // 前4位hex
+}
+
+func BarDir(repoRoot string) string {
+    return filepath.Join(GlobalBarDir(), "projects", ProjectID(repoRoot))
+}
+```
+
+### 2. `cmd/bar/init.go`
+- 删除 `checkGitignore()` 函数及其调用
+
+### 3. `internal/util/path/path_test.go`
+新增单元测试覆盖：
+- `TestGlobalBarDir` - 验证返回 `~/.bar`
+- `TestProjectID` - 验证格式为 `<项目名>-<4位hash>`
+- `TestProjectID_Uniqueness` - 验证不同路径生成不同 ID
+- `TestProjectID_Consistency` - 验证相同路径生成相同 ID
+- `TestBarDir` - 验证完整路径结构
+- `TestFindRepoRoot` - 验证 git 仓库根目录查找
+- `TestEnsureDir` - 验证递归创建目录
+
+## 迁移影响
+
+### 用户侧
+- 无需再修改 `.gitignore`
+- 所有项目的存档统一管理在 `~/.bar/`
+- 可通过 `ls ~/.bar/projects/` 查看所有项目
+
+### 开发侧
+- `BarDir()` 函数签名不变，调用方无需修改
+- 新增 `GlobalBarDir()` 和 `ProjectID()` 供其他模块使用