# 示例：Linux
curl -LO https://github.com/liu-ethan/golem/releases/latest/download/golem-linux-amd64
chmod +x golem-linux-amd64
sudo mv golem-linux-amd64 /usr/local/bin/golem

git clone https://github.com/liu-ethan/golem.git
cd golem
go build -o golem ./cmd/golem

./scripts/build-release.sh v0.1.0 dist

provider:
  base_url: "https://api.anthropic.com"          # DeepSeek: https://api.deepseek.com/anthropic
  api_key: "${ANTHROPIC_API_KEY}"
  model: "claude-sonnet-4-5"
  context_limit: 200000

defaults:
  approval: ask-before-edit    # plan | ask-before-edit | ask | edit-automatically
  sandbox: workspace-write     # workspace-write | danger-full-access

memory:
  layer2_session_threshold: 3
  bm25_top_k: 5
  compact_batch_size: 10
  compact_threshold: 0.8

cd my-project          # 此处即为 project_root
golem                  # 启动 TUI
golem -version         # 查看版本
golem --approval plan  # 只读探索模式

用户输入
  ↓
[会话管理层]
  ├── 读取历史会话（SQLite）
  ├── BM25 检索相关记忆片段（memory_facts 表）
  └── 注入 system prompt（user_profile.md + top-K 记忆）
  ↓
[Agent 主循环]
  ↓
  LLM API（Streaming SSE，goroutine + channel）
  ↓
  解析 tool_use 块
  ↓
[权限规则层]          ← 仅 bash；deny > ask > allow，先于审批层
  ├── deny 命中 → 直接拒绝，不弹框
  └── allow/ask 命中 → 进入审批层
  ↓
[审批交互层]          ← plan / ask-before-edit / ask / edit-automatically
  ↓
[沙箱 / 路径校验]      ← bash：namespace fork；文件工具：project_root 内
  ↓
  工具执行（循环直到无 tool_use）
  ↓
最终回答输出
  ↓
[记忆提取层]
  └── 会话结束同步提取 → SQLite；每 3 次会话触发 Layer 2 合并 → user_profile.md

Layer 0 · Working Memory
  当前会话 message history
  context 达 80% 自动压缩

Layer 1 · Episodic Memory
  会话结束提取 3–5 条事实
  BM25 检索 top-K 注入

Layer 2 · Semantic Memory
  每 3 次会话合并 → .golem/user_profile.md
  始终注入 system prompt

# ~/.golem/rules.yaml
rules:
  - action: allow
    pattern: "go *"
  - action: allow
    pattern: "git *"
  - action: ask
    pattern: "curl *"
  - action: deny
    pattern: "rm -rf *"
  - action: deny
    pattern: "wget *"

priority: deny > ask > allow

golem                                      # 启动 TUI，新建会话
golem --resume <session-id>                # 恢复历史（也可用 /sessions）
golem --approval ask-before-edit           # 指定审批模式
golem --sandbox workspace-write            # 指定沙箱模式
golem "帮我读一下 main.go 并总结"           # headless 模式
golem sessions list                        # CLI 列会话
golem sessions delete <id>                 # 删除会话
golem skill install github:user/repo/name  # 安装 Skill

golem/
├── cmd/golem/              # CLI 入口
├── internal/
│   ├── llm/                # LLMClient 接口与 Streaming 实现 + prompts/
│   ├── agent/              # Agent 主循环与 tool_use 分发
│   ├── tools/              # 内置工具集
│   ├── approval/           # 审批交互模式
│   ├── rules/              # YAML 权限规则引擎
│   ├── sandbox/            # Linux Namespace 沙箱
│   ├── session/            # SQLite 会话持久化
│   ├── memory/             # 三层记忆系统 + BM25 检索
│   ├── skills/             # Skill 加载与安装
│   ├── testutil/           # 跨包共享测试辅助
│   ├── integration/        # 端到端集成测试
│   └── tui/                # Bubble Tea TUI
├── scripts/
│   └── build-release.sh    # 多平台交叉编译
├── assert/                 # README / 主页截图素材
├── .github/workflows/      # CI + Release
└── .golem/                 # 项目级配置（运行时）
    ├── config.yaml
    ├── rules.yaml
    ├── user_profile.md
    └── data/golem.db

# 运行测试
go test ./...

# 静态检查
go vet ./...

# 构建
go build ./cmd/golem

# 本地打 Release 包
./scripts/build-release.sh v0.1.0-test dist

git tag v0.1.0
git push origin v0.1.0