包
August 20, 2026 · View on GitHub
English | 中文
npm scope 为 @deepseek-ai/dsh-*；Cordis Service 子类和函数插件通过 ctx.effect()、ctx.on() 或 ctx.waterfall() 注册。规则见包与根规则。
层级结构
包按组置于 packages/<group>/<pkg>/；包名仍为 @deepseek-ai/dsh-<pkg>。组 README 负责包／ctx 键映射。
| 组 | 职责 | 发布预期 |
|---|---|---|
core/ | 产品 API 主干：会话、提示词、工具、agent（智能体）服务与具体循环 | 产品：稳定 API |
api/ | Remote BFF 装配与 Typert RPC 网关 | 产品：稳定 API |
typert/ | 类型图生成、产物加载与运行时注册表 | 产品：稳定 API |
goal/ | 同会话 goal 的持久化与生命周期 | 产品：稳定 API |
schedule/ | 仅限会话内的定时后续操作 | 产品：稳定 API |
feedback/ | 人类反馈 | 产品：稳定 API |
identity/ | 共享匿名身份 | 产品：稳定 API |
llm/ | LLM（大语言模型）能力系列：抽象服务 + 提供方适配器 | 产品：稳定 API |
e2b/ | E2B 提供方 | POC |
subprocess/ | 子进程能力系列：Service Definition + 本地进程树提供方 | 产品：稳定 API |
shell/ | Bash 能力系列：执行器 seam、本地实现、面向模型的工具 | 产品：稳定 API |
terminal/ | 持久 PTY 能力系列：限定所有者范围的会话、本地实现和面向模型的工具 | 产品：稳定 API |
code-runtime/ | 代码执行能力系列：Service Definition + worker 线程提供方 + Code Mode Consumer | 产品：稳定 API |
sandbox/ | 进程限制 seam；bwrap/Landlock/Seatbelt 后端 | 产品：稳定 API |
fs/ | 文件系统能力系列：seam、本地实现、面向模型的文件工具、由 bash 支持的发现工具 | 产品：稳定 API |
lsp/ | LSP 能力系列：seam、通用 stdio 提供方和 lsp 工具 | 产品：稳定 API |
skill/ | skill（技能）能力系列：提供方注册表、本地提供方和面向模型的目录／loader | 产品：稳定 API |
compaction/ | 压缩（compaction）能力系列：Service Definition + 基础提供方 + 命令 Consumer | 产品：稳定 API |
context/ | 模型可见请求上下文，包括 workspace 指令和时间上下文 | 产品：稳定 API |
subagent/ | subagent 能力系列：提供方注册表约定和面向模型的委托工具 | 产品：稳定 API |
jobs/ | 通用后台任务运行时和面向模型的 job_* 控制工具 | 产品：稳定 API |
experimental/ | 私有原型与内部专用插件 | 不发布 |
workflow/ | 工作流 seam、worker 线程引擎和面向模型的 workflow/ralph 工具 | 产品：稳定 API |
web/ | Web 能力系列：seam、搜索／获取提供方实现和面向模型的 Web 工具 | 产品：稳定 API |
attachment/ | 持久附件标识、校验、本地内容寻址存储 | 产品：稳定 API |
spill/ | spill 能力系列：存储 seam、本地实现、工具结果 spill 策略 | 产品：稳定 API |
todo/ | 面向模型的 todo_write 工具 | 产品：稳定 API |
plan/ | Plan 协作状态，提供直接进入命令与经评审的退出 | 产品：稳定 API |
preset/ | 由 preset cordis.yml 按会话组装 agent | 产品：稳定 API |
guard/ | 循环卫生守卫：建议性重复调用提醒 + tools/execute 截止时间强制执行器 | 产品：稳定 API |
bundle/ | 可安装的 dsh --profile 补丁层 | 产品：稳定 API |
extensions/ | agent 运行时自修改：实时插件／服务检查和模型所写插件挂载／卸载（设计） | 产品：稳定 API |
hooks/ | 钩子桥接 + 共享的 Claude Code／Codex 线协议库 | 产品：稳定 API |
session/ | 持久会话数据平面：持久化 seam + JSONL/SQLite 后端、投影 seam、基于日志的标题、会话上报 | 产品：稳定 API |
session-query/ | 会话检索系列：逻辑语料库、有界读取、血缘、事件关系、语义过滤和 SQLite 全文搜索 | 产品：稳定 API |
settings/ | 用户设置 seam + 基于文件的提供方 | 产品：稳定 API |
credentials/ | 凭据引用/记录 seam + 环境变量优先于 .env 的提供方 + 授权 flow | 产品：稳定 API |
storage/ | 非会话存储中枢 + 后端 + 领域形式 | 产品：稳定 API |
workspace/ | Workspace 实体 | 产品：稳定 API |
sdk/ | 进程外运行时 SDK：JSON-RPC 协议、TypeScript 客户端和服务器插件 | 产品：稳定 API |
acp/ | 仅面向自动化的 ACP（Agent Client Protocol）服务器 | 产品：稳定 API |
interaction/ | 人机协作平面：批准／交互 seam、权限预设、命令、询问用户的工具 | 产品：稳定 API |
boot/ | 共享的 app bin 启动粘合层 | 产品：稳定 API |
host/ | web GUI 宿主半侧：API 网关 + HTTP 路由服务器 | 产品：稳定 API |
client/ | web GUI 浏览器半侧：shell、协议层、对象服务、slot、ui-* 插件 | 产品：稳定 API |
examples/ | 演示组合包（agent-spine + CLI（命令行界面）/ACP/JSON-RPC bin），由叶节点加载 | 支持：示例基础设施 |
test-support/ | 支持基础设施（testkit、不变式、回放、Loader 冒烟测试） | 支持：兼容性预期较低 |
util/ | 组间共享的低层零依赖工具（Branded<B>、Harness home／路径辅助函数、超时、留存） | 支持：小型、稳定、无 harness 依赖 |
新包加入现有组；新组更新其 README 和此表。
依赖
依赖图由工具生成：docs/module-graph.md（pnpm run gen-module-graph，CI 中有新鲜度门禁）。
扩展插件依赖 Service Definition，绝不依赖具体提供方。 dsh-agent-loop 可替换；UI、钩子和工具插件使用 dsh-agent。包括 dsh-agent-spine-demo 在内的组合包可以依赖主干插件。能力会将需要独立演进的 Service Definition／Service Provider／Consumer 角色分离；详见能力 seam。
包 README 覆盖用途、API、扩展点和模型体验；列入模型无关省略允许清单的包除外。它们还要包含 ## Known Limitations and Deferred Work，或列入其允许清单。