refactor(tui): 命令菜单/Activity/filepicker/progress 组件化并合并重复入口

.gitattributes

@@ -0,0 +1,12 @@
+# 统一仓库内常见文本文件为 LF，避免 Windows 下出现无意义的换行警告
+*.go text eol=lf
+*.md text eol=lf
+*.yml text eol=lf
+*.yaml text eol=lf
+go.mod text eol=lf
+go.sum text eol=lf
+.gitignore text eol=lf
+.gitattributes text eol=lf
+
+# 强制 scripts 目录下的 Shell 脚本始终使用 LF 换行符
+scripts/*.sh text eol=lf

.github/workflows/ci.yml

@@ -38,10 +38,11 @@ jobs:
         run: go test ./... -covermode=atomic -coverprofile=coverage.out
 
       - name: Upload coverage to Codecov
+        continue-on-error: true
         uses: codecov/codecov-action@v5
         with:
           files: ./coverage.out
           flags: unittests
-          fail_ci_if_error: true
+          fail_ci_if_error: false
         env:
           CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

.github/workflows/release.yml

@@ -25,7 +25,7 @@ jobs:
       - name: Set up Go
         uses: actions/setup-go@v5
         with:
-          go-version: '1.22' # 替换为 NeoCode 实际使用的 Go 版本
+          go-version-file: 'go.mod' # 💡 修复点 1：让 Action 自动跟随项目真实的 Go 版本
 
       - name: Run GoReleaser
         uses: goreleaser/goreleaser-action@v5
@@ -34,5 +34,5 @@ jobs:
           version: '~> v2'
           args: release --clean
         env:
-          # GitHub Actions 自动注入的 Token，用于发布 Release
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}       # 💡 修复点 2：补回本仓库的内置鉴权令牌
+          TAP_GITHUB_TOKEN: ${{ secrets.TAP_GITHUB_TOKEN }}

.gitignore

@@ -30,6 +30,8 @@ config.local.yaml
 
 # Local data
 data/
+.cache/
+.neocode/projects/**/.transcripts/
 
 # Editor/IDE
 .idea/

.goreleaser.yaml

@@ -1,4 +1,5 @@
 # .goreleaser.yaml
+project_name: neocode
 version: 2 # 必须声明为 v2 语法
 
 before:
@@ -44,4 +45,5 @@ changelog:
   filters:
     exclude:
       - '^docs:'
-      - '^test:'
+      - '^test:'
+

AGENTS.md

@@ -75,8 +75,12 @@
 - 导出标识符使用 `PascalCase`，未导出使用 `camelCase`。
 - 使用制表符缩进，尽量将单行控制在约 120 字符内。
 - 核心抽象上的导出类型、函数、接口应补充清晰注释，尤其是 `provider`、`runtime`、`tools`。
+- 在非测试文件中新增函数时，必须紧邻函数定义补充便于解读的注释，注释内容使用中文并以 UTF-8 编码保存；注释应说明函数职责、关键行为或上下文，避免空泛的模板化表述。
 - 避免硬编码路径、URL、模型名、超时、输出长度限制和环境差异项，优先通过配置、参数或具名常量注入。
+- 避免硬编码业务语义字符串或状态值（例如消息角色、事件类型、协议字段值）；如需复用，优先收敛到共享常量、类型或统一定义处。
 - 优先写清晰、可替换的实现，不要为了“未来可能需要”提前引入复杂泛化。
+- 不要擅自删除、改写或遗漏原有注释；若注释需要调整，应在理解原意后做等价更新，而不是直接移除。
+- 如果文件内容疑似乱码或编码异常，先尝试用其他编码方式查看和确认原文，再决定是否修改；未确认前不要擅自删除或重写相关内容。
 
 ## 7. 配置与安全规则
 - 配置文件默认路径为 `~/.neocode/config.yaml`。

README.md

@@ -1,61 +1,192 @@
 # NeoCode
-NeoCode 是一个基于 Go 和 Bubble Tea 构建的本地 Coding Agent MVP。它把 Provider 防腐层、工具调用闭环、本地会话持久化和沉浸式瀑布流 TUI 组合在一起，用于日常代码理解、修改和终端内协作。
 
-## 功能特性
-- 基于防腐层的 Provider 架构，当前支持 OpenAI 兼容流式接口，并为 Anthropic、Gemini 预留了扩展位置。
-- ReAct 风格的 runtime 主循环，能够读取模型输出、执行工具调用、回灌结果并继续推理。
-- 瀑布流终端界面，支持流式 transcript、内联工具事件、Slash Command 和会话侧边栏。
-- 本地 YAML 配置、`.env` 加载与并发安全的热更新能力。
-- 本地 JSON 会话持久化，不依赖远端服务即可恢复历史上下文。
-- 文件系统高级工具：读取、写入、搜索、Glob 探测和精准替换。
+> 基于 Go + Bubble Tea 的本地 Coding Agent
 
-## 环境要求
-- Go 1.21 及以上
-- 至少一个可用的模型 Provider API Key，例如 `OPENAI_API_KEY`
+NeoCode 是一个在终端中运行的 AI 编码助手，采用 ReAct（Reason-Act-Observe）循环模式，能够自主推理、调用工具并完成任务。
 
-## 快速开始
-1. 克隆仓库。
-2. 准备 Provider 的 API Key，可以通过环境变量或 NeoCode 托管的 `.env` 文件提供。
-3. 运行应用：
+## 核心特性
+
+- **流式输出** — 实时展示模型思考过程
+- **工具系统** — 文件操作、代码执行、搜索等内置工具
+- **内建 Provider 支持** — OpenAI、Gemini、OpenLL、Qiniu，模型列表支持动态发现与缓存
+- **终端原生体验** — 基于 Bubble Tea 的现代化 TUI
+
+## 一键安装
+
+NeoCode 提供了跨平台的一键安装脚本。无论你是哪种操作系统，只需在终端执行以下命令，脚本将自动探测系统架构、拉取最新 Release 产物并配置好环境变量：
 
+### 🍎 macOS / Linux
+打开终端（Terminal）并运行：
 ```bash
-go run ./cmd/neocode
+curl -fsSL https://raw.githubusercontent.com/1024XEngineer/neo-code/main/scripts/install.sh | bash
+```
+
+### Windows
+
+打开 PowerShell 并运行：
+
+
+
+```PowerShell
+irm https://raw.githubusercontent.com/pionxe/neo-code/main/scripts/install.ps1 | iex
 ```
 
-首次启动时，NeoCode 会在当前用户主目录下创建自己的托管目录、默认配置和会话存储结构。
 
-## Slash Command
-- `/set url <url>`：更新当前选中 Provider 的 Base URL。
-- `/set key <key>`：将当前 Provider 的密钥写入托管 `.env` 并立即重新加载。
-- `/model`：打开交互式模型选择列表。
 
-## 开发与验证
-在提交 Pull Request 前建议至少执行以下命令：
+## 快速开始
+
+### 环境要求
+
+- Go 1.21+
+- API Key（OpenAI 或 Google Gemini）
+
+### 安装与运行
 
 ```bash
-gofmt -w ./cmd ./internal
-go test ./...
+# 克隆仓库
+git clone https://github.com/yourusername/neocode.git
+cd neocode
+
+# 设置 API Key
+export OPENAI_API_KEY=your_key_here
+
+# 运行
+go run ./cmd/neocode
+```
+
+### 基本使用
+
+在 TUI 中输入自然语言指令，例如：
+
 ```
+帮我看看当前项目的目录结构
+创建一个 HTTP 服务器，监听 8080 端口
+分析 runtime.go 的主要逻辑
+```
+
+使用 slash 命令快速切换配置：
+
+- `/provider` — 切换内建模型提供商
+- `/model` — 切换模型
 
 ## 架构概览
-- `internal/config`：负责 YAML 加载、`.env` 集成、默认值管理和并发安全更新。
-- `internal/provider`：将厂商特定的请求和流式响应抹平成统一领域模型。
-- `internal/runtime`：负责事件总线、ReAct loop、Provider 动态构建和会话持久化。
-- `internal/tools`：提供工具注册表以及各类具体工具实现。
-- `internal/tui`：负责终端交互体验，以及 runtime 事件到 Bubble Tea 消息的桥接。
+
+```
+┌─────────────────────────────────────────┐
+│              TUI (Bubble Tea)           │
+└────────────────┬────────────────────────┘
+                 │ Events
+┌────────────────▼────────────────────────┐
+│          Runtime (ReAct Loop)           │
+└────────┬───────────────────┬────────────┘
+         │                   │
+    ┌────▼─────┐        ┌────▼──────┐
+    │ Provider │        │   Tools   │
+    │  (LLM)   │        │ Registry  │
+    └──────────┘        └───────────┘
+```
+
+核心模块职责：
+
+- **`internal/config`** — 配置管理、环境变量、YAML 加载
+- **`internal/context`** — system prompt、消息裁剪与上下文构建
+- **`internal/provider`** — Provider 契约、驱动注册与通用领域类型
+- **`internal/provider/catalog`** — 模型发现、catalog 缓存与后台刷新
+- **`internal/provider/selection`** — provider/model 选择与配置同步
+- **`internal/provider/builtin`** — 内建 driver 注册
+- **`internal/runtime`** — ReAct 主循环、事件流、会话管理
+- **`internal/tools`** — 工具注册表与具体工具实现
+- **`internal/tui`** — 终端 UI、交互体验、事件桥接
+- **`internal/app`** — 应用装配与依赖注入
 
 ## 目录结构
+
 ```text
 .
-|-- cmd/neocode
-|-- docs
-|-- internal/app
-|-- internal/config
-|-- internal/provider
-|-- internal/runtime
-|-- internal/tools
-`-- internal/tui
+├── cmd/neocode          # CLI 入口
+├── docs                 # 架构与设计文档
+│   ├── guides           # 使用指南
+│   └── *.md             # 设计文档
+├── internal
+│   ├── app              # 应用装配
+│   ├── config           # 配置管理
+│   ├── context          # 上下文构建
+│   ├── provider         # Provider 契约与驱动注册
+│   │   ├── builtin      # 内建 driver 注册
+│   │   ├── catalog      # 模型发现与缓存
+│   │   └── selection    # provider/model 选择服务
+│   ├── runtime          # ReAct 循环与事件流
+│   ├── tools            # 工具系统
+│   └── tui              # 终端 UI
+└── README.md
+```
+
+## 文档
+
+- **[配置指南](docs/guides/configuration.md)** — Provider 策略、配置文件、环境变量
+- **[扩展 Provider](docs/guides/adding-providers.md)** — 如何添加新的模型提供商
+- **[架构设计](docs/neocode-coding-agent-mvp-architecture.md)** — 整体架构与设计理念
+- **[事件流](docs/runtime-provider-event-flow.md)** — Runtime 与 Provider 的事件交互
+
+## 开发
+
+```bash
+# 格式化代码
+gofmt -w ./cmd ./internal
+
+# 运行测试
+go test ./...
+
+# 编译
+go build ./...
 ```
 
 ## 当前状态
-NeoCode 目前聚焦于 MVP 闭环：本地对话、工具调用、Session 持久化和终端交互体验。当前版本正在继续向“高质量开源项目”标准收敛，重点补强文档、测试覆盖率和工具能力。
+
+NeoCode 正处于 MVP 阶段，核心闭环已可用：
+
+✅ 用户输入 → Agent 推理 → 工具调用 → 结果返回 → UI 展示
+
+正在持续迭代中，重点关注：
+
+- 📚 文档完善
+- 🧪 测试覆盖率
+- 🛠️ 工具能力扩展
+- 🔧 稳定性与性能
+
+
+
+## 自动化发版指南
+
+NeoCode 已经集成了 GoReleaser 与 GitHub Actions 的全自动化 CI/CD 流水线。
+
+**作为项目维护者，发布新版本时绝对不需要在本地手动编译或打包二进制文件。** 只需要通过 Git 打一个语义化版本标签（Tag）即可触发全自动构建：
+
+1. **确保主分支代码已就绪**：所有新特性和 Bug 修复均已合并至 `main` 分支。
+
+2. **在本地打上版本标签**（版本号必须以 `v` 开头，如 `v0.1.0`）：
+
+   ```Bash
+   git tag v0.1.0
+   ```
+
+3. **将标签推送到远程仓库**：
+
+   ```Bash
+   git push origin v0.1.0
+   ```
+
+**发布流水线说明：** 推送到远程后，GitHub Actions 会自动接管，整个过程通常耗时 1~2 分钟：
+
+- 自动读取 `.goreleaser.yaml` 配置。
+- 执行跨平台（Windows/macOS/Linux）与多架构（amd64/arm64）的静态交叉编译。
+- 自动将编译产物打包压缩（`.tar.gz` 和 `.zip`），并计算 SHA256 校验和。
+- 自动在项目的 Releases 页面创建一个全新的发版记录，并将所有压缩包作为资产（Assets）挂载上去。
+
+## License
+
+MIT
+
+## Manual Compact
+
+NeoCode 支持通过 `/compact` 手动压缩当前会话上下文。配置项见 `docs/guides/configuration.md`，流程和摘要约定见 `docs/context-compact.md`。

cmd/neocode/main.go

@@ -5,7 +5,7 @@ import (
 	"fmt"
 	"os"
 
-	"github.com/dust/neo-code/internal/app"
+	"neo-code/internal/app"
 )
 
 func main() {

docs/config-management-detail-design.md

@@ -7,25 +7,26 @@
 - 向运行中的系统提供并发安全的配置读写能力
 
 ## 核心类型
-- `Config`：顶层应用配置，包含 Provider 列表、当前选中 Provider、当前模型、工作目录、Shell 和循环限制等信息
-- `ProviderConfig`：单个 Provider 的配置项，包括 Base URL、默认模型和 API Key 环境变量名
+- `Config`：顶层应用配置，运行时包含 Provider 列表、当前选中 Provider、当前模型、工作目录、Shell 和循环限制等信息
+- `ProviderConfig`：单个 Provider 的内建定义，包括 Base URL、默认模型、实例级模型列表和 API Key 环境变量名
 - `Manager`：使用 `sync.RWMutex` 保护的配置访问器与修改器
 - `Loader`：对 YAML 文件和托管 `.env` 文件的文件系统封装
 
 ## 环境变量策略
-- YAML 只保存 `api_key_env`，不保存真实密钥。
+- YAML 不保存 `api_key_env`，只保存 `selected_provider`、`current_model` 和通用运行配置。
 - `Loader.LoadEnvironment` 会尝试加载当前工作目录下的 `.env` 和 NeoCode 托管目录中的 `.env`。
 - `ProviderConfig.ResolveAPIKey` 在真正发起请求前通过 `os.Getenv` 读取密钥。
 
 ## 运行时更新
 - TUI 只能通过 `ConfigManager.Update` 修改配置。
-- 修改 Base URL 时只更新当前选中 Provider，并立即持久化。
-- 修改 API Key 时写入托管 `.env`，然后重新加载环境变量并刷新配置快照。
-- 修改模型时，同时更新 `current_model` 和当前 Provider 的 `model` 字段，保持状态一致。
+- TUI 只负责切换当前 Provider 和当前模型，不直接修改 Provider 元数据。
+- `base_url`、`api_key_env`、`driver` 和 `models` 由代码内建定义提供，不从 YAML 读写。
+- 修改模型时，只更新 `current_model`；当前 Provider 的 `model` 仍表示默认模型，`models` 负责描述该实例可选模型列表。
 
 ## 默认值治理
-- 默认 Provider 名称、URL、模型和环境变量名统一定义在 `internal/config/model.go` 中。
-- 内建模型目录也收口在 `config` 包中，避免 TUI 自己维护一套零散的临时常量。
+- 默认 Provider 名称、URL、默认模型、模型列表和环境变量名统一由内建 Provider 定义提供。
+- `Loader` 在加载旧配置时会丢弃 `providers` / `provider_overrides`，重新回到“YAML 只保存选择状态”的最小结构。
+- Provider 的可选模型目录属于实例配置，进入运行时 `Config` 后再提供给 TUI 和 runtime，避免 TUI 或 driver 自己维护一套零散常量。
 
 ## 安全约束
 - 读操作统一走 `Get`，并返回拷贝后的配置快照。