# 工具执行环境

本目录是 GoodBuddy“工具执行环境”功能的唯一文档入口。该功能为本机 SKILL 和本机
stdio MCP 提供明确、可诊断的 Node.js 与 Python 环境，同时允许专业用户选择自己维护的
解释器。

本功能不作用于 SSH Host 上的 GoodBuddy Agent、固定 Node、签名 Runtime、SKILL 或 MCP。
用户从设置中心的“能力与工具”进入，并在 `Skills`、`MCP`、`工具执行环境` 三个水平
Tab 之间切换。

[Obsidian 接入](../obsidian/README.md)复用本功能的 `LaunchEnvironmentProvider` 启动
随包交付的 MCPVault，不新增 Node 安装或下载源设置。生产组件自动化已覆盖真实 MCPVault
调用，Electron 托管 Node 离线冒烟仍待完成，具体见[验证记录](../obsidian/progress.md)。

## 文档导航

Local native Continue and DS Web clients now honor the current custom Node
selection. They require standard Node rather than Electron's Node mode; the
remaining managed fallback and validation are tracked in
[native client progress](../assistant-workbar/progress.md#2026-09-27-local-native-client-validation).

| 文档 | 权威职责 |
| --- | --- |
| [PRD](./prd.md) | 用户问题、产品目标、范围、需求和产品验收 |
| [User Stories](./user-stories.md) | 用户角色、使用场景和逐故事验收 |
| [功能逻辑](./logic-design.md) | 不变量、状态机、决策表、失败恢复和跨场景一致性 |
| [UI 设计](./ui-design.md) | 页面结构、组件、状态、文案和无障碍一致性 |
| [技术设计](./technical-design.md) | Main、Runtime、MCP、打包、生命周期和测试架构 |
| [功能进度](./progress.md) | 已完成、进行中、待实施、阻塞项和验证证据 |

## 术语

| 术语 | 定义 |
| --- | --- |
| 能力与工具 | 设置中心中统一承载 Skills、MCP 和工具执行环境的一级分类 |
| 工具执行环境 | GoodBuddy 在桌面所在设备上向本机 Runtime 和 stdio MCP 提供的工具命令环境 |
| GoodBuddy 托管 | 由 GoodBuddy 提供、验证并解析的 Node.js 或 Python |
| 自定义环境 | 用户从检测结果中选择或直接指定的外部解释器 |
| 工具下载源 | GoodBuddy 固定目录受管工具工件使用的原生地址或 OSS 镜像 |
| 工具就绪 | 解释器及配套命令通过真实诊断 |
| 能力依赖就绪 | 某个 SKILL 或 MCP 所需的第三方包和入口通过实际验证 |

## 文档维护规则

1. 产品范围只在 PRD 定义，其他文档链接引用。
2. 界面视觉和交互只在 UI 设计定义，并服从仓库根目录的
   [统一界面设计系统](../../../UI-DESIGN.md)。
3. 状态转换、优先级和冲突决策只在功能逻辑中定义。
4. 进度文档只记录已验证事实，不复制未来设计。
5. 技术实现变化先更新技术设计；用户行为变化同时更新 PRD、User Stories、功能逻辑和
   UI 设计。
6. 每次完成功能阶段后立即更新进度、验证命令和剩余阻塞项。