核心Cordis 元框架DSH 的底层是 Cordis 元框架其定位是 时空可组合性元框架目前版本为 v4.0.0 - rc.8采用 MIT 协议由 DeepSeek AI 团队工程师 shigma 维护。“时空可组合性”概念源于 Cordis 团队的学术论文论文提出两个维度的形式化时间可组合性是指组件被移除时其副作用能被完全撤销空间可组合性是指组件能声明并对其他组件的状态变化做出响应。通俗来讲Cordis 只关注插件的加载、卸载和依赖关系。每个插件通过 ctx 上下文提供服务通过 inject 声明依赖通过类型化事件通信emit 观察、waterfall 包装、parallel 和 serial 控制执行顺序。注册是可逆的副作用卸载时自动清理。这表明 DSH 的根基是学术级别的插件框架而非随意拼凑的“插件系统”。架构分层DSH 的架构文档类似操作系统设计文档系统分为几个层次。最底层是 dsh - base包含模型适配器、工具注册表、持久化、沙箱和审批策略、设置、凭据、遥测这是每个 profile 的第一层。上面是 dsh - web - app浏览器界面或 dsh - headless无服务器的单次运行器。profile 是命名的插件组合一个 profile 列出它依赖的 bundlebundle 是 Cordis 配置行和代码的分发格式。配置通过 patch 机制叠加即每个 bundle 的配置、profile 的 patch、home 目录的 patch、命令行 --patch 参数按顺序应用到空白的 entry 列表上。用户可随时运行 dsh --profile web --dump-config 查看当前完整的插件树然后用 patch 替换其中任何一行。核心 packageDSH 的 monorepo 包含 68 个 package覆盖 Agent 系统的各个环节Package职责core/session仅追加的会话事件日志core/system - prompt提示词和工具 schema 组装core/tools作用域工具注册表与执行管线core/agentAgent 接口与注册表core/agent - loop默认的 Agent 驱动实现llm/llm消息与流词汇适配器接口Seam能力替换的设计精髓DSH 最优雅的设计是 seam能力缝合点的概念一个 seam 有三个角色Service Definition声明接口、Service Provider实现它、Consumer使用它。文件系统和子进程的 provider 共享同一个执行世界将它们的 provider 指向远程沙箱Bash、PTY 和 LSP 会一同跟着过去无需为每个工具编写单独的 provider 适配这就是“替换一个 provider 就能改变整个产品”的含义。四种运行模式DSH 提供四种预设模式每种加载不同的插件组合标准模式是完整的工具组合适用于日常使用PTC 模式是程序化工具调用Programmatic Tool Calling由模型生成一段代码来组合多轮工具调用极简模式仅保留一个 shell 工具和一个文件编辑工具用于最小环境下的模型基准测试创造模式可以检查当前运行时、在内存中试验 Cordis 插件并据此组合和创作新的模式。会话日志与事件溯源DSH 的会话日志采用仅追加append - only设计模型看到的一切系统提示词、思维链、工具调用与结果、子 Agent 调度、每一次上下文注入都会被记录。架构文档明确指出“Model - visible means logged.” 任何到达模型请求的信息都必须能从日志中重建运行时有一个断言来保证这一点。恢复、分叉、检索与回放共享同一份事件流fork 一个会话只需 ctx.sessions.fork(source, boundary, childSessionId)即从日志中的某个时间点分支创建一个新的子会话。事件系统事件就是扩展点DSH 把事件分为三个域会话事件是追加到日志的持久事实重新加载后仍然存在Agent 事件agent/*携带活跃 Agent 引用用于观察或拦截进行中的工作能力事件无需导入循环即可向某个 seam 附加策略和适配器。开始使用安装方式简单有 Node.js 就能运行npx deepseek - ai/dsh web默认启动在 http://127.0.0.1:3080。源码安装则按 git clone - pnpm install - pnpm build - pnpm dsh web 的路径进行。