本地开发环境工具

Local Playground是一个桌面优先的单页面应用,用于集中管理Azure OpenAI聊天、线程范围的MCP服务器和线程范围的技能。

  • by anaregdesign
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 anaregdesign/simple-mcp-client

使用说明

当地游乐场

Local Playground 是一个桌面优先的SPA,用于在一个地方使用Azure OpenAI聊天、线程范围的MCP服务器和线程范围的技能。

快速开始

git clone https://github.com/anaregdesign/local-playground.git
cd local-playground
npm install
npm run dev

打开 http://localhost:5173.

如果需要登录,请在使用聊天、项目发现或部署选择之前从应用程序完成Azure身份验证。

应用程序做什么

  • Playground:聊天执行和每回合运行时可见性
  • Threads:线程生命周期、指令编辑和存档线程还原
  • MCP Servers:保存了配置文件管理和线程范围的MCP连接
  • Skills:安装了技能发现和注册表支持的技能工作流
  • Settings:Azure身份验证、项目/部署选择和应用程序级首选项

贡献者基线

贡献者架构的真实来源是:

重构后修复错误的当前工作区UI行为基线:

下没有有意竞争的架构迁移文档 docs/architecture/持久的建筑规则 AGENTS.md 以及技能;基线文档仅记录当前UI行为。

稳定贡献者规则:

  • app/lib 按层组织,而不是按特殊特征根组织
  • 共享客户端/服务器解析和契约逻辑属于 app/lib/contracts/
  • 独立于框架的模型行为属于 app/lib/domain/
  • 仅服务器集成属于 app/lib/server/infrastructure/
  • 路由模块应保持精简,并将可重用逻辑委托给 app/lib/server/usecase/ 和 app/lib/server/infrastructure/
  • Prisma词汇是真理的命名来源
  • 仍保留在代码库中的旧前缀不应复制到新名称中
  • npm run architecture:check 是一个严格的零发现门,而不是基线漂移检查

运行时模型

  • 该应用程序是一个SPA client 运行时所有权。
  • 线程状态是主要的持久单位:元数据、指令、消息、MCP连接、操作日志和技能选择。
  • 交互状态首先存在于运行时,并作为持久快照持久化。
  • Azure身份验证使用 DefaultAzureCredential.
  • 地方发展可以利用 /mcp/debug 用于调试和数据库检查。

开发命令

npm run dev
npm run architecture:check
npm run typecheck:core
npm run test:core
npm run quality:gate

桌面包装:

npm run desktop:dev
npm run desktop:start
npm run desktop:package

桌面构建将相同的React Router SPA封装在Electron中。没有单独的桌面渲染器shell。 desktop:start 在启动生产shell之前重建Electron的本机依赖关系。安装程序通过以下方式构建和重建本机依赖关系 electron-builder.

截图