mesalogo
f81f342cde
Add composer shortcuts for local Continue and OpenCode terminals and the official DeepSeek Harness Web client, using the current project and model bridge. Manage browser service reuse, stop actions and terminal cleanup. Upgrade DeepSeek Harness to 0.1.7-rc.2 and Cordis to 4.0.4. Include the coordinated IPC handler extraction and related tests and documentation. Remote native-client coordinator wiring, managed Node consolidation, Ask MCP mappings and full desktop/package acceptance remain unfinished; this commit records the implemented local workflow and supporting SSH groundwork. Validation: typecheck and lint passed; 267 focused tests passed and 5 skipped. No new real-provider calls were made for this commit. Prior real-model evidence and remaining acceptance work are documented in the feature progress files. Release note: 本地项目选择 Continue 或 OpenCode 后，可从输入框下方打开原生终端；选择 DS 后，可打开使用当前项目和模型的官方 Web 客户端。客户端使用独立会话，DS 网页关闭后服务继续运行，可在 GoodBuddy 中停止；远程入口尚未完成。
53 lines
3.0 KiB
Markdown
53 lines
3.0 KiB
Markdown
# 工具执行环境
|
|
|
|
本目录是 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. 每次完成功能阶段后立即更新进度、验证命令和剩余阻塞项。
|