使用说明
当地游乐场
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.
