refactor(tui): add core command status and workspace helpers

README.md

@@ -94,7 +94,8 @@ go run ./cmd/neocode
 - **`internal/provider/catalog`** — 模型发现、catalog 缓存与后台刷新
 - **`internal/provider/selection`** — provider/model 选择与配置同步
 - **`internal/provider/builtin`** — 内建 driver 注册
-- **`internal/runtime`** — ReAct 主循环、事件流、会话管理
+- **`internal/runtime`** — ReAct 主循环与事件流编排（不直接承载会话存储实现；不再导出会话模型与存储类型）
+- **`internal/session`** — 会话模型、会话存储抽象与 JSON 持久化实现（统一对外暴露 `Session` / `Summary` / `Store`）
 - **`internal/tools`** — 工具注册表与具体工具实现
 - **`internal/tui`** — 终端 UI、交互体验、事件桥接
 - **`internal/app`** — 应用装配与依赖注入
@@ -116,6 +117,7 @@ go run ./cmd/neocode
 │   │   ├── catalog      # 模型发现与缓存
 │   │   └── selection    # provider/model 选择服务
 │   ├── runtime          # ReAct 循环与事件流
+│   ├── session          # 会话模型与持久化
 │   ├── tools            # 工具系统
 │   └── tui              # 终端 UI
 └── README.md

docs/context-compact.md

@@ -19,6 +19,7 @@ context:
     manual_strategy: keep_recent
     manual_keep_recent_messages: 10
     max_summary_chars: 1200
+    micro_compact_disabled: false
 ```
 
 - `manual_strategy`
@@ -27,6 +28,11 @@ context:
   在 `keep_recent` 模式下保留最近消息数量，并按 tool call 与 tool result 的原子块整体保留。
 - `max_summary_chars`
   控制 compact summary 的最大字符数。
+- `micro_compact_disabled`
+  控制是否关闭默认启用的读时 micro compact；设为 `true` 时会回退为仅 trim、不清理旧 tool result。
+
+新增工具时，micro compact 策略不再由 `context` 层静态白名单维护，而是由 `internal/tools` 中的工具实现声明。
+默认情况下，已注册工具都会参与 micro compact；只有显式声明保留历史结果的工具才会跳过旧结果清理。
 
 ## 执行链路
 

docs/guides/configuration.md

@@ -315,6 +315,7 @@ context:
     manual_strategy: keep_recent
     manual_keep_recent_messages: 10
     max_summary_chars: 1200
+    micro_compact_disabled: false
 ```
 
 ### 字段说明
@@ -324,5 +325,8 @@ context:
 | `context.compact.manual_strategy` | string | `keep_recent` | 手动 `/compact` 策略，可选 `keep_recent` / `full_replace` |
 | `context.compact.manual_keep_recent_messages` | int | `10` | `keep_recent` 模式下保留最近 N 条消息；会按 tool call 与 tool result 的原子块整体保留 |
 | `context.compact.max_summary_chars` | int | `1200` | compact summary 最大字符数 |
+| `context.compact.micro_compact_disabled` | bool | `false` | 是否关闭默认启用的读时 micro compact；设为 `true` 可快速回退到仅 trim、不做旧工具结果清理 |
+
+新增工具默认会参与 micro compact；如果某个工具的历史结果必须保留，需要在 `internal/tools` 的工具实现中显式声明保留策略。
 
 更多行为说明见 [context-compact.md](../context-compact.md)。

docs/guides/mcp-configuration.md

@@ -0,0 +1,62 @@
+# MCP 配置指南（stdio）
+
+本文档说明如何在 NeoCode 中通过配置注册 MCP server，并验证 `mcp.<server>.<tool>` 能力是否可用。
+
+## 配置位置
+
+在 `~/.neocode/config.yaml` 中添加 `tools.mcp.servers`：
+
+```yaml
+tools:
+  mcp:
+    servers:
+      - id: docs
+        enabled: true
+        source: stdio
+        version: v1
+        stdio:
+          command: node
+          args:
+            - ./mcp-server.js
+          workdir: ./mcp
+          start_timeout_sec: 8
+          call_timeout_sec: 20
+          restart_backoff_sec: 1
+        env:
+          - name: MCP_TOKEN
+            value_env: MCP_TOKEN
+```
+
+## 字段说明
+
+- `id`：server 稳定标识，用于工具命名空间（`mcp.<id>.<tool>`）。
+- `enabled`：是否启用该 server；仅 `true` 的 server 会在启动时注册。
+- `source`：传输类型，当前仅支持 `stdio`。
+- `version`：可选版本字段，用于可观测和后续策略命中。
+- `stdio.command`：启动命令（必填，启用时）。
+- `stdio.args`：启动参数列表。
+- `stdio.workdir`：子进程工作目录，支持相对路径（相对主 `workdir` 解析）。
+- `stdio.start_timeout_sec` / `call_timeout_sec` / `restart_backoff_sec`：可选秒级超时与重试参数。
+- `env`：传给 MCP 子进程的环境变量列表。
+  - 每项必须配置 `value` 或 `value_env` 其中之一。
+  - 推荐使用 `value_env` 引用系统环境变量，避免在 YAML 中写明文敏感信息。
+
+## 启动行为
+
+- 启动阶段会注册所有 `enabled: true` 的 server。
+- 注册后会执行一次 `tools/list` 初始化工具快照。
+- 若启用的 server 注册失败，启动会报错并中止（fail-fast）。
+
+## 功能测试建议
+
+1. 启动应用后让 Agent 列出工具：
+   - `请先列出你当前可用工具的完整名称。`
+2. 检查是否存在 `mcp.docs.<tool>`。
+3. 发起一次明确调用：
+   - `请调用 mcp.docs.search，参数 {\"query\":\"hello\"}，并返回工具结果。`
+
+若返回 `tool not found`，优先检查：
+- `enabled` 是否为 `true`；
+- `stdio.command` 是否可执行；
+- `env.value_env` 对应环境变量是否存在；
+- MCP server 是否支持 `tools/list`。