civaapple-alt/mini-dsh

README 摘要

Mini-DSH: Cordis 极简架构实现与学习指南 本项目是一个极简版（Educational & Minimalist）的 DeepSeek Harness 架构实现，专门用于学习与验证 Cordis 框架的核心设计哲学： “Everything is a plugin”（一切皆插件） 。 📖 推荐必读学习指南 ： - 🚀 《从 CLI 启动到浏览器端动态插件加载全流程》 ：全流程时序图、 window. MINI BOOT 详解、 client-shell.js 运作机制与 DSH 源码对标！ - 🛡️ 《Capability Seam（能力接缝）与可移植执行世界深入指南》 ：Service Definition / Provider / Consumer 三元角色模型与本地/云端沙箱无感切换！ - 🧩 《预设配置体系指南：部署级 Profile vs 会话级 Preset 与 Include & Patch》 ：Cordis 作用域隔离（ ctx.isolate ）、多租户会话与全局增量补丁机制！ - 🔥 《Schemastery 配置校验与 HMR 实时热重载指南》 ：声明式 Schema 校验与文件变更实时热重载！ - 📝 《架构决策记录 (Agent Notes / ADRs)》 ：包含所有核心架构决策的中英文演进记录。 核心设计概念 1. 统一的插件模型（Cordis Plugin） ： - 所有的功能、服务、API 路由以及前端 UI 组件全部以 Cordis 插件（ apply(ctx, config) ）形式组织。 - 通过依赖注入（ ctx.inject(['server', 'slots']) ）实现插件之间的拓扑解耦与延迟挂载。 - 所有的注册与监听都封装在 ctx.effect() 中，支持干净的生命周期管理与销毁（Disposer）。 2. 配置驱动的 Profile 机制 ： - 通过 YAML 文件（如 profiles/web.yml 、 profiles/base.yml ）声明启用的插件及其配置参数。 - 切换 Profile 即切换系统能力，无需修改一行代码。 3. 前后端对称的插件组合架构（Host + Client-Web） ： - Host 端（Node.js） ： - 运行 Cordis Context。 - host-webserver 插件提供 ctx.server 基础 HTTP 服务。 - host-client-modules 插件自动扫描已加载插件的 package.json （带有 mini.client 字段），组装 window. MINI BOOT 启动图，并分发 /plugins/:id/client.js 。 - Client 端（浏览器 Web GUI） ： - 在…

分类