参与开发
Usora 文档站技术栈、插件 monorepo 结构、检查命令和发布流程。
Usora 有两个相关仓库：D:\Usora 是插件源码，D:\usora-docs 是这个文档站。
文档站技术栈
文档站使用 Next.js 16、React 19、Fumadocs MDX、Fumadocs UI、Tailwind CSS v4、lucide-react 和 pnpm。内容位于 content/docs，导航顺序由 content/docs/meta.json 控制，MDX 配置在 source.config.ts。
pnpm dev
pnpm lint
pnpm build站点包含 /docs 文档路由、llms.txt/llms.mdx 机器可读路由，以及可选的 AI search/chat API。
插件仓库结构
D:\Usora 是 marketplace-style monorepo。marketplace 是 usora，插件 payload 是 foundry。
canonical plugin entry - 插件的规范入口文件
Skill instructions - 技能指令目录，存放 AI 助手的技能定义
MCP runtime - MCP 运行时代码，处理工具调用和协议实现
thin MCP entrypoint - 轻量级 MCP 入口脚本
session hooks - 会话钩子，用于拦截和扩展会话生命周期
Codex adapter - OpenAI Codex 适配器配置
CodeBuddy adapter - CodeBuddy 适配器配置
marketplace metadata template - marketplace 元数据模板
generated metadata - 自动生成的 marketplace 元数据
本地命令
插件仓库使用 Bun：
同步插件配置和元数据。编辑 plugins/foundry/plugin.json 后需要运行此命令。
检查项目健康状态、依赖完整性和配置一致性。
运行所有测试套件，包括 MCP tools、baseline、session compiler 等。
发布前的完整性检查，确保代码质量、类型安全和测试通过。
测试覆盖
核心测试在 D:\Usora\scripts：
测试 MCP 工具的正确性、参数验证和返回值格式
测试基线功能的稳定性和性能基准
测试会话编译器的各种边界情况和错误处理
测试模式索引的准确性、查询效率和更新机制
测试候选解析的优先级排序和冲突解决
测试技能生成和演化的完整生命周期
测试上下文预算管理和资源分配策略
测试数据迁移的完整性和回滚机制
测试运行时反馈循环和学习机制
测试治理策略的执行和权限控制
测试多主机协议的兼容性和故障转移