本附录枚举检出目录中的每一个工作区包,并为每个包给出不超过一行的职责说明。请把它与架构概览和术语表配合阅读。
总体概览
- 共 245 个
package.json文件:- 219 个工作区包,位于
packages/<组>/<包>/(另有 7 个测试夹具清单位于packages/typert/generator/tests/fixtures/,使packages/树下共 226 个),分布于 49 个功能组(core、session、client、subagent……即每一个packages/<组>目录)。 - 2 个应用入口,位于
apps/。 - 4 个原生条目,位于
native/landlock-run/(一个启动器包加三个按平台划分的二进制子包)。 - 9 个vendored 框架包,位于
vendor/。 - 4 个条目,位于
examples/(一个 umbrella 清单加三个可运行的演示应用)。
- 219 个工作区包,位于
- 命名约定:宿主包为
@deepseek-ai/dsh-<名称>(如@deepseek-ai/dsh-agent、@deepseek-ai/dsh-session)。包要么表达一个能力接缝(seam)(一个抽象服务 + 它的ctx.<key>词表),要么表达它的提供者/消费者之一;三角色能力接缝模式常把它们拉成一个家族(dsh-fs+dsh-fs-local+dsh-fs-sandbox+dsh-tool-fs……)。vendored 的 Cordis 包被收在@deepseek-ai/cordis*名下,以免发布 harness 时占用上游名称。客户端 UI 包遵循@deepseek-ai/dsh-client-ui-*。
packages/core/* — 循环、作用域、注册表
| 包 | 职责 |
|---|---|
dsh-agent | Agent 接口、实时注册表、发起者作用域与 agent/* 事件词表 |
dsh-agent-loop | 驱动回合(turn)与步骤(step)的具体 agent-loop 插件 |
dsh-agent-default-model | Agent 入口共用的默认模型选择 |
dsh-agent-tool-presentation | 将某智能体的工具组合为 Code Mode、原生或两者皆可 |
dsh-scope | 作用域化注册原语(作用域标签、按作用域过滤的事件分发) |
dsh-session | 事件溯源(event-sourced)的 SessionEvent 存储 |
dsh-system-prompt | 系统提示小节与工具 schema 组装注册表 |
dsh-tools | 作用域化工具注册表与受守护的执行流水线 |
packages/acp/*、packages/api/*、packages/attachment/*
| 包 | 职责 |
|---|---|
dsh-acp | 面向自动化的 Agent Client Protocol 服务器,基于 JSON-RPC stdio |
dsh-api-gateway | Typert Remote Host 分发器与 Client API 端点 |
dsh-api-remotes | Remote BFF 组装与 Host Agent/Session 查找策略 |
dsh-attachment | 持久、不可变的附件存储接缝 |
dsh-attachment-local | 私有的、内容寻址的 $DSH_HOME 附件存储 |
packages/boot/* — 组合与启动层
| 包 | 职责 |
|---|---|
dsh-app-boot | 应用 bin 共用的启动胶水:.env 加载、fail-loud Loader 守卫、profile/bundle 组合、启动序列 |
dsh-cmdline | 从 dsh 启动器向注入 cmdlineArgs 的插件传递不可变的命令行 |
packages/bundle/* — profile bundle
| 包 | 职责 |
|---|---|
dsh-base | 作为 profile bundle 的共享核心;每个 profile 的第一层补丁层 |
dsh-headless | 一次性 bundle:不包含 Host、HTTP 或浏览器层的直接 Agent/Session 运行器 |
dsh-web-app | 浏览器界面 bundle:dsh-base 之上的 web 补丁层加运行时胶水 |
packages/client/* — web shell 与 UI(39 个包)
客户端包分为shell 内核(web、web-react、runtime、modules、connection、hmr、locale、schema-form)与UI 功能插件(ui-*)。
| 包 | 职责 |
|---|---|
dsh-client-web | Web shell 内核:bootWebShell、模块持有、两阶段启动、AppRoot 闸门 |
dsh-client-web-react | Shell 侧 React 胶水:createSlotRenderer、SessionProvider、useInvoke、uSES 桥 |
dsh-client-runtime | 客户端核心服务:SlotRegistry、SessionRuntime(作用域树 + 对象层) |
dsh-client-modules | 客户端模块系统:node 侧构筑 __DSH_BOOT__ 入口图,浏览器侧为懒加载 CJS 表 |
dsh-client-connection | 连线消费层:HTTP-上/WebSocket-下客户端,带重连 |
dsh-client-hmr | 仅开发的、面向脚本加载客户端入口的热重载驱动 |
dsh-client-locale | 语言环境插件:Host 支撑的中/英偏好与类型化字典 |
dsh-client-schema-form | 设置编辑器用的 schema/draft 模型层 |
dsh-client-ui-primitives | 纯 React 原子:控件、图标、markdown、JSON 检查器 |
dsh-client-ui-slots | Slot 注册表纯核心:SlotMap 合并、register 组合 API |
dsh-client-ui-theme | 主题插件:调色板引导、ThemeRuntime、--dsw-* 令牌 |
dsh-client-ui-layout | 三栏 AppFrame shell 插件,带拖拽手柄 |
dsh-client-ui-sidebar | 侧边栏插件:会话树、搜索、分组、状态点 |
dsh-client-ui-conversation | 会话领域:聊天流、输入框、busy-Enter 偏好 |
dsh-client-ui-commands | 客户端命令界面:全局目录缓存、/ source、命令 UI 种类 |
dsh-client-ui-input-trigger | 输入触发流水线:/ 与 @ 检测与候选菜单 |
dsh-client-ui-model-selection | 模型选择 /model popupSelect |
dsh-client-ui-plan | 计划模式输入框控件,作用于计划投影 |
dsh-client-ui-goal | 停靠于输入框上方的会话目标 GoalBar |
dsh-client-ui-jobs | 会话顶栏的后台作业列表 |
dsh-client-ui-subagent | 子智能体会话目录、续跑路由与 @ 引用 |
dsh-client-ui-tool | 工具调用树渲染器与按工具展示的槽位 |
dsh-client-ui-trajectory | 带交互式时序总览的轨迹事件账本 |
dsh-client-ui-attachment | 纯 React 附件原子:草稿横条、画廊、灯箱 |
dsh-client-ui-deliverables | 产出文件的回合尾部与可点击的文件引用 |
dsh-client-ui-settings | 设置领域基础插件与设置槽位契约 |
dsh-client-ui-settings-general | 常规设置小节、shell 触发器/顶栏 chrome、引导说明 |
dsh-client-ui-settings-plugins | 带功能所属标签页的插件设置小节 |
dsh-client-ui-settings-plugin-inventory | Cordis Loader 状态只读清单标签页 |
dsh-client-ui-settings-models | 模型设置与产品引导对话框 |
dsh-client-ui-skill | Web 技能引用与专属技能工具行 |
dsh-client-ui-workspace | 侧边栏中的工作区选择器插件 |
dsh-client-ui-directory-picker-browse | 应用内目录浏览界面 |
dsh-client-ui-directory-picker-native | 原生(OS 选择器)目录选择界面 |
dsh-client-ui-permission-presets | 权限界面,作用于权限投影 |
dsh-client-ui-user-questions | Web 端 ask_user_question 功能 |
dsh-client-ui-message-feedback | 逐条消息的反馈控件 |
dsh-client-ui-agent-preset | Agent 预设界面:默认项、会话席位、组合编辑器 |
dsh-client-ui-workflow-run | 持久 workflow-run 会话节点与成员展示 |
packages/code-runtime/*、packages/compaction/*、packages/context/*
| 包 | 职责 |
|---|---|
dsh-code-runtime | 抽象的代码执行接缝(ctx.codeRuntime) |
dsh-code-runtime-worker-thread | 代码执行接缝的 worker-thread 实现 |
dsh-compaction | 抽象的压缩服务接缝(ctx.compaction) |
dsh-compaction-basic | token 计驱动的压缩策略与 LLM 摘要后端 |
dsh-compaction-tool-result-pruner | 对工具结果表面节点做无模型的头/中/尾裁剪 |
dsh-command-compact | 面向人类的显式会话压缩斜杠命令 |
dsh-agent-instructions | 针对 AGENTS.md/CLAUDE.md 的工作区上下文加载器 |
dsh-time-context | 携带当前时间与耗时的选择性持久逐步骤上下文 |
dsh-tmux-context | 携带本智能体 tmux 窗格/窗口位置的选择性持久逐步骤上下文 |
dsh-session-reference | 跨会话快照引用与持久的不可信模型上下文 |
packages/credentials/*、packages/e2b/*、packages/extensions/*
| 包 | 职责 |
|---|---|
dsh-credentials | 抽象凭据接缝(ctx.credentials) |
dsh-credentials-local | 基于文件的凭据提供者($DSH_HOME/.env) |
dsh-e2b | 供提供者适配器共用的 E2B 沙箱生命周期 |
dsh-fs-e2b | E2B 文件系统实现 |
dsh-subprocess-e2b | E2B 子进程实现 |
dsh-cordis-host-runner | 动态包定义注册表与 host 半边沙箱生命周期 |
dsh-cordis-client-runner | 双半边插件包的浏览器半边 |
dsh-tool-cordis | 自指式 cordis 工具集:检查运行时、挂载/释放模型编写的插件 |
packages/feedback/*、packages/fs/*
| 包 | 职责 |
|---|---|
dsh-message-feedback | 生命周期绑定的逐消息评分与备注 sidecar |
dsh-command-feedback | 只记日志的会话反馈产生者与斜杠命令 |
dsh-fs | 抽象文件系统能力接缝(ctx.fs)+ fs/* 事件词表 |
dsh-fs-local | fs 接缝的本地文件系统实现 |
dsh-fs-sandbox | 沙箱强制的实现:按每次调用的沙箱模式围栏写入 |
dsh-fs-observation-policy | 观测状态、读前编辑、版本守卫的写/编辑策略插件 |
dsh-tool-fs | 面向模型的 fs 工具(read、write、edit) |
dsh-tool-fs-search | 面向模型的发现工具(glob、grep),基于 @vscode/ripgrep |
dsh-tool-str-replace-editor | 在 fs 服务上的查看/创建/字面替换/插行工具 |
packages/goal/*、packages/guard/*、packages/hooks/*
| 包 | 职责 |
|---|---|
dsh-goal | 事件溯源的同会话目标状态与生命周期服务 |
dsh-goal-round-driver | 竞争围栏的同会话目标回合驱动器 |
dsh-tool-goal | 带执行时权限检查的面向模型目标工具 |
dsh-command-goal | 面向人类的 /goal 斜杠命令 |
dsh-tool-call-timeout-policy | 在 exec.signal 上设置每次工具截止时间并返回 TOOL_TIMEOUT |
dsh-repeat-tool-reminder | 当智能体在相同工具调用上循环时给出建议性提醒 |
dsh-hook-protocol | 共用的 Claude Code / Codex hook 连线协议与匹配引擎 |
dsh-hooks-claude-code | 桥:在 Harness 截获接缝上运行 Claude Code hooks 配置 |
dsh-hooks-codex | 桥:在 Harness 接缝上运行 Codex hooks 配置 |
packages/host/* — web 服务器与选择器
| 包 | 职责 |
|---|---|
dsh-host-webserver | Web 路由注册插件:HTTP/upgrade 路由、index 注入、静态回退 |
dsh-host-frontend-static | Web shell 的 SPA dist 服务器 |
dsh-host-apiproxy | API 网关(ctx.apiProxy):fetch 载体对 + host 侧插件 |
dsh-host-plugin-inventory | 当前 Loader 插件状态的只读 Remote 投影 |
dsh-host-directory-picker | 抽象的工作区目录选择接缝(ctx.directoryPicker) |
dsh-host-directory-picker-auto | 启动时判断 host 情境的自适应选择器 |
dsh-host-directory-picker-browse | 目录选择接缝的应用内浏览后端 |
dsh-host-directory-picker-native | 目录选择接缝的原生 OS 选择器后端 |
packages/identity/*、packages/interaction/*
| 包 | 职责 |
|---|---|
dsh-anonymous-user-id | 遥测与反馈关联共用的匿名用户身份 |
dsh-user-questions | 抽象的用户提问接缝(ctx.userQuestions) |
dsh-tool-ask-user | 面向模型的 ask_user_question 工具 |
dsh-user-approval | 用户审批接缝(ctx.approval):一次性权限决策,默认 fail-closed |
dsh-permission-presets | 捆绑沙箱模式与审批策略旋钮的产品级 Permissions 选择器 |
dsh-commands | 插件私有的人类命令注册表 |
packages/jobs/*、packages/llm/*
| 包 | 职责 |
|---|---|
dsh-jobs | 面向长时工具工作的后台作业注册表(ctx.jobs) |
dsh-jobs-local | 作业注册表接缝的进程内本地实现 |
dsh-tool-jobs | 面向模型的作业控制工具(job_output、job_list、job_kill) |
dsh-llm | 提供者中立的 LLM 服务接口 |
dsh-llm-retry | 提供者路由的 LLM 请求重试策略 |
dsh-token-meter | 回放感知的 token 计量服务(ctx.tokenMeter) |
dsh-llm-deepseek | DeepSeek chat-completions 适配器 |
dsh-llm-pi-ai | 基于 pi-ai 的 DeepSeek 适配器(dsh-llm-deepseek 的设计孪生) |
packages/lsp/*、packages/mcp/*
| 包 | 职责 |
|---|---|
dsh-lsp | 抽象的 LSP 能力接缝(ctx.lsp) |
dsh-lsp-stdio | 通用 stdio 语言服务器提供者 |
dsh-tool-lsp | 面向模型的 lsp 工具:definition/references/implementation/hover |
dsh-mcp-client | MCP 客户端桥:连接服务器并注册其工具 |
packages/plan/*、packages/preset/*、packages/runtime-diagnostics/*
| 包 | 职责 |
|---|---|
dsh-plan-mode | 带直接斜杠命令的已记录每智能体计划模式 |
dsh-agent-presets | 从预设 cordis.yml 文件进行的逐会话智能体组合 |
dsh-persona | 组合编写的部署 persona 小节 |
dsh-invariants | 包自有运行时不变的注册服务 |
packages/sandbox/*
| 包 | 职责 |
|---|---|
dsh-sandbox | 抽象的进程沙箱接缝(ctx.sandbox)+ SandboxProvider 契约 |
dsh-sandbox-local | 本地后端:bwrap、landlock-run、macOS Seatbelt、Windows ACL——探测后 fail-closed |
dsh-sandbox-policy | 每次调用的沙箱模式解析器与当前模型上下文 |
dsh-sandbox-windows-acl | Windows ACL 写限制后端(受限令牌生成) |
packages/schedule/*、packages/sdk/*
| 包 | 职责 |
|---|---|
dsh-schedule | 智能体作用域的持久 after/at/fixed-rate 提醒 |
dsh-sdk-protocol | 共用连线协议:换行分隔的 JSON-RPC stdio 传输与具名类型 |
dsh-sdk-jsonrpc-server | 面向进程外 SDK 客户端的 Stdio JSON-RPC 服务器插件 |
dsh-sdk-client | 通过高级 turns API 驱动运行时子进程的 TypeScript 客户端 SDK |
packages/session/* — 事件日志及其投影
| 包 | 职责 |
|---|---|
dsh-session-persistence | 抽象的持久会话持久化接缝(ctx.sessionPersistence) |
dsh-session-persistence-jsonl | JSONL 持久会话持久化后端 |
dsh-session-persistence-sqlite | SQLite 持久会话持久化后端 |
dsh-session-projection | 会话投影接缝:类型表、提供者契约、ctx.sessionProjections |
dsh-session-projection-cache | 带冷读梯的持久逐会话投影检查点 |
dsh-session-checkpoint-policy | 模型请求与工具副作用前的语义持久性检查点 |
dsh-session-stats | 全日志会话计数与时长投影 |
dsh-session-title | 基于日志的会话标题服务与提供者注册表 |
dsh-session-title-llm | 标题提供者共用的 LLM 生成策略 |
dsh-session-title-first-prompt-llm | 首条消息的 LLM 标题提供者插件 |
dsh-session-title-all-prompts-llm | 全部用户消息的 LLM 标题提供者插件 |
dsh-session-telemetry | SessionTelemetryBackend 接缝:采集、投影、脱敏、移交 |
dsh-session-telemetry-otel | 遥测接缝的 OpenTelemetry 后端 |
packages/session-query/*
| 包 | 职责 |
|---|---|
dsh-session-query | 合并会话查询服务契约:读取、追踪、过滤 |
dsh-session-query-sqlite | 带 SQLite FTS5 搜索的具体后端 |
dsh-tool-session-query | 工作区授权的面向模型历史搜索/追踪/读取工具 |
dsh-session-log-export | Web 会话日志导出命令与下载对话框 |
packages/settings/*、packages/shell/*
| 包 | 职责 |
|---|---|
dsh-settings | 抽象的用户设置接缝(ctx.settings) |
dsh-settings-file | 基于文件的设置提供者(settings.yaml) |
dsh-shell | 抽象的 bash 执行器接缝(ctx.shell) |
dsh-shell-env | 与工具无关的管理式 DSH_* shell 环境注册表 |
dsh-bash-local | 本地子进程 bash 执行器提供者 |
dsh-bash-sandbox | 消费沙箱的 bash 执行器提供者 |
dsh-pwsh-local | 本地 PowerShell bash 执行器提供者 |
dsh-pwsh-sandbox | 消费沙箱的 PowerShell 执行器提供者 |
dsh-tool-bash | 面向模型的 bash 工具,支持后台作业与沙箱升级 |
dsh-tool-bash-persistent | 基于 PTY 服务的属主作用域持久 Bash 工具 |
dsh-tool-pwsh | 面向模型的 pwsh 工具,作用于执行器接缝 |
packages/skill/*、packages/spill/*
| 包 | 职责 |
|---|---|
dsh-skill | Agent 技能提供者注册表 |
dsh-skill-filesystem | 本地文件系统技能提供者 |
dsh-skill-badge | 捆绑的 dsh badge 技能提供者 |
dsh-tool-skill | 面向模型的技能加载工具 |
dsh-spill | 抽象的 spill 存储接缝(ctx.spillStore) |
dsh-spill-local | 本地文件系统 spill 存储(私有会话作用域文件) |
dsh-spill-policy | 用保留预览 + spill 文件路径替换过大工具结果 |
packages/storage/*
| 包 | 职责 |
|---|---|
dsh-storage | 存储枢纽(ctx.storage):具名后端注册表 + 挂载的数据形式设施 |
dsh-storage-domain | 领域数据形式:schema 校验、事件发射的 KV 领域 |
dsh-storage-json | JSON 文件 KV 存储后端 |
dsh-storage-sqlite | SQLite 存储后端(kv 面) |
packages/subagent/* — 委托
| 包 | 职责 |
|---|---|
dsh-subagent | 抽象子智能体接缝(ctx.subagents):具名提供者注册表 |
dsh-subagent-in-process-driver | 在 ctx.agents 上共用的进程内运行驱动 |
dsh-subagent-spawn-in-process | 进程内 spawn 后端:全新子智能体 |
dsh-subagent-fork-in-process | 进程内 fork 后端:用父日志前缀种子的子智能体 |
dsh-subagent-dsh-sdk | 进程外 SDK 后端:经 stdio JSON-RPC 的子运行时 |
dsh-subagent-acp | 进程外 ACP 后端:在派生子进程中的子智能体 |
dsh-subagent-claude-code | 基于 Agent SDK 的一次性 Claude Code 提供者 |
dsh-subagent-codex | 基于 app-server 协议的一次性 Codex 提供者 |
dsh-tool-subagent | 面向模型的委托工具,作用于 ctx.subagents |
dsh-tool-subagent-control | 全局具名的 send_message、interrupt_agent、list_agents |
dsh-tool-subagent-report | 面向子智能体的 report 工具 |
packages/subprocess/*、packages/terminal/*、packages/todo/*
| 包 | 职责 |
|---|---|
dsh-subprocess | 子进程接缝(ctx.subprocess):管理的进程组、受限输出、升级杀除 |
dsh-subprocess-local | 本地子进程实现 |
dsh-terminal | 持久 PTY 会话接缝(ctx.terminals) |
dsh-terminal-bash | 持久 shell PTY 后端 |
dsh-tool-terminal | 六个面向模型的持久 PTY 工具,带属主隔离 |
dsh-tool-todo | 面向模型的 todo_write 工具,作用于会话日志 |
packages/test-support/*
| 包 | 职责 |
|---|---|
dsh-loader-smoke | 面向无密钥 Loader 冒烟测试的共用子进程 + 直接 Agent 台架 |
dsh-agent-loop-testkit | 面向 agent-loop 测试的前置条件挂载 |
dsh-llm-replay | 面向无密钥快照测试的回放 LLM 插件 |
dsh-llm-mock-server | 可脚本化的 OpenAI 兼容 HTTP/SSE 故障服务器 |
dsh-client-test-runtime | jsdom 槽位测试运行时,带真实 Cordis 上下文与替身 |
dsh-acp-snapshot | ACP 测试套件:子进程启动器、快照台架、归一化器 |
packages/typert/*
| 包 | 职责 |
|---|---|
dsh-typert-protocol | 编译无关的 Remote 元数据与 Typert 提供者协议 |
dsh-typert-generator | TypeScript 分析器与模型驱动的 Typert 产物生成器 |
dsh-typert-registry | 生成的反射与 Zod schema 的运行时注册表 |
dsh-typert-loader | 生成的 Typert 贡献的 Loader 集成 |
packages/util/*
| 包 | 职责 |
|---|---|
dsh-atomic-write | 零依赖原子文件替换(writeFileAtomic) |
dsh-brand | 纯类型 Branded<B> 名义类型原语 |
dsh-home-paths | 共用文件系统路径助手(含 resolveDshHome) |
dsh-launch-environment | 记录每个值所属层级的不可变启动环境 |
dsh-native-command | 面向 OS 集成的零依赖无 shell execFile 运行器 |
dsh-output-retention | 有界保留原语(ItemRetainer/TextRetainer) |
dsh-timeout | 超时/截止时间原语与 TimeReason 分类学 |
packages/web/*、packages/workflow/*、packages/workspace/*
| 包 | 职责 |
|---|---|
dsh-web | 抽象的 web 访问接缝(ctx.web):搜索/抓取提供者注册表 |
dsh-web-fetch-http | 匿名的公开 HTTP(S) 抓取提供者 |
dsh-web-search-deepseek | 基于 DeepSeek 的搜索提供者(Anthropic 兼容 API) |
dsh-web-search-exa | 基于 Exa 的搜索提供者 |
dsh-web-search-perplexity | 基于 Perplexity 的搜索提供者 |
dsh-tool-web | 面向模型的 web_search / web_fetch 工具 |
dsh-workflow | 工作流能力接缝(ctx.workflowEngine)+ workflow/* 事件 |
dsh-workflow-worker-thread | worker-thread 工作流引擎,将 agent() 桥接到 ctx.subagents |
dsh-tool-workflow | 面向模型的工作流工具 |
dsh-tool-ralph | 面向模型的 fresh-agent Ralph 循环工具 |
dsh-workspace | 领域数据形式之上的工作区实体注册表(ctx.workspaceRegistry) |
packages/examples/* — 仓库内演示应用
| 包 | 职责 |
|---|---|
dsh-acp-demo | ACP 自动化服务器应用:agent spine + JSONL 持久化 + ACP 传输 |
dsh-agent-spine-demo | 带回退标题的默认无执行器/无 UI agent spine |
dsh-sdk-jsonrpc-demo | 为 stdio JSON-RPC SDK 运行时启动外部 Cordis 配置的 bin |
dsh-client-ui-cordis位于packages/extensions/ui-cordis;为便于检索,在下面的 extensions 段中列出。
apps/*
| 包 | 职责 |
|---|---|
dsh(CLI) | dsh CLI:profile 引导、插件管理、浏览器 UI 别名 |
dsh-web-frontend | Web 应用入口:在 dsh-client-web shell 之上做 Vite 构建;dist/ 由 dsh web 提供 |
native/landlock-run/* — Landlock 启动器家族
native/landlock-run 解析为四个包,共同发布一个供本地沙箱后端使用的 Linux Landlock 自限制-后执行启动器:
| 包 | 职责 |
|---|---|
@deepseek-ai/node-addon-landlock-run-workspace | 启动器包的 monorepo 工作区容器(自身无运行时职责) |
@deepseek-ai/node-addon-landlock-run | 解析、探测并沟通启动器 CLI 契约的 JS 接缝 |
@deepseek-ai/node-addon-landlock-run-linux-x64 | 面向 linux-x64 的预构建静态 musl 启动器二进制(按文件路径解析) |
@deepseek-ai/node-addon-landlock-run-linux-arm64 | 面向 linux-arm64 的预构建静态 musl 启动器二进制(按文件路径解析) |
vendor/* — vendored Cordis 框架家族
Cordis 框架及其基础库在 vendor/ 下 vendored,并以 @deepseek-ai 作用域发布,以免 harness 占用上游名称。参见 官方文档地图 中 docs/rescope.md 一条。
| 包 | 职责 |
|---|---|
@deepseek-ai/cordis | dsh 之下的插件元框架:服务、类型化事件、可逆 effect |
@deepseek-ai/cosmokit | 框架常用工具集 |
@deepseek-ai/cordis-plugin-group | cordis 的嵌套插件组 |
@deepseek-ai/cordis-plugin-hmr | cordis 的热模块替换插件 |
@deepseek-ai/cordis-plugin-include | 在 cordis 配置中包含文件 |
@deepseek-ai/cordis-plugin-loader | cordis 的插件加载器 |
@deepseek-ai/cordis-plugin-logger-console | cordis 的控制台日志导出器 |
@deepseek-ai/schemastery | 用于插件配置 schema 的类型驱动 schema 校验器 |
@deepseek-ai/cordis-plugin-timer | cordis 的计时器服务 |
examples/* — 可运行演示
三个独立的演示应用位于 examples/ 下,各自带有自己的 package.json。另有三个演示目录——examples/mcp-memory、examples/web-cordis、examples/web-schedule——是仅配置、无自带 package.json 的文件夹;examples/package.json 里的 dsh-examples umbrella 清单把它们 cordis.yml 的插件声明为 workspace:* 依赖。
| 包 | 职责 |
|---|---|
acp-agent-example | 可运行演示:基于 JSON-RPC stdio 的 ACP 自动化服务器 |
jsonrpc-agent-example | 无人值守的 JSON-RPC 编码智能体组合 |
headless-agent-example | 一次完整的 headless 编码智能体回合 |