本附录枚举检出目录中的每一个工作区包，并为每个包给出不超过一行的职责说明。请把它与架构概览和术语表配合阅读。
总体概览
- 共 276 个
package.json文件：- 258 个位于
packages/<组>/<包>/——其中 251 个是真正的工作区包，另有 7 个测试夹具清单位于packages/typert/generator/tests/fixtures/——分布于 51 个功能组（core、session、client、subagent……即每一个packages/<组>目录；自 rc.7 起新增了experimental与webhook）。 - 2 个应用入口，位于
apps/。 - 4 个原生条目，位于
native/landlock-run/（一个启动器包加三个按平台划分的二进制子包）。 - 9 个vendored 框架包，位于
vendor/。 - 0 个条目，位于
examples/——顶层目录已在上游被删除；其可运行的演示移至apps/cli/config/examples/{cordis,github-review,mcp-memory,schedule}，测试移至apps/cli/tests/profiles/{acp,headless,sdk}。 - 3 个额外清单：仓库根
package.json（@deepseek-ai/dsh-root）、website/（@deepseek-ai/website）与python/sdk-runtime/（dsh-python-runtime-closure；其 pyproject 为deepseek-harness-runtime-bin）。
- 258 个位于
- 命名约定：宿主包为
@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-*，实验性包则是@deepseek-ai/dsh-experimental-*。另有少量较新的包脱离了单纯的dsh-<名称>模式：@deepseek-ai/dsh-util-*工具分组（dsh-util-crypto、dsh-util-time、dsh-util-values、dsh-util-workspace-path），以及完全省略组别段的包（dsh-deque、dsh-authorization、dsh-file-reference、dsh-file-reference-local、dsh-win32-process）。
packages/core/* — 循环、作用域、注册表
| 包 | 职责 |
|---|---|
dsh-agent | Agent 接口、实时注册表、发起者作用域与 agent/* 事件词表 |
dsh-agent-loop | 驱动回合（turn）与步骤（step）的具体 agent-loop 插件 |
dsh-agent-default-model | Agent 入口共用的默认模型选择 |
dsh-agent-tool-presentation | 将某智能体的工具组合为 PTC 模式、原生或两者皆可 |
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-api-session-controller | 会话命令、历史流、实时控制状态、Agent/Session 身份策略；ctx.sessionController |
dsh-api-settings-controller | 经设置领域接缝的配置界面读写 |
dsh-api-workspace-controller | 工作区变更 + 完整的 Client 工作区投影 |
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-acp-app | 基于 base 的纯自动化 ACP stdio 应用；挂载 ACP 桥 |
dsh-base | 作为 profile bundle 的共享核心；每个 profile 的第一层补丁层 |
dsh-headless | 一次性 bundle：不包含 Host、HTTP 或浏览器层的直接 Agent/Session 运行器 |
dsh-sdk-app | 基于 base 的 SDK JSON-RPC stdio 应用 |
dsh-sdk-minimal | 不含 base 与 Web 的独立最小 SDK 应用 |
dsh-web-app | 浏览器界面 bundle：dsh-base 之上的 web 补丁层加运行时胶水 |
packages/client/* — web shell 与 UI（44 个包）
客户端包分为shell 内核（web、store、modules、connection、hmr、locale）与UI 功能插件（ui-*）。
| 包 | 职责 |
|---|---|
dsh-client-web | Web 启动内核：静态模块表、Cordis 加载器、无框架启动页、UI-renderer 交接；入口 AppWebEntry |
dsh-client-store | 无 React 依赖的 observable/快照存储原语 |
dsh-client-modules | 客户端模块系统：node 侧构筑 __DSH_BOOT__ 入口图，浏览器侧为懒加载 CJS 表 |
dsh-client-connection | 连线消费层：HTTP-上/WebSocket-下客户端，带重连 |
dsh-client-hmr | 仅开发的、面向脚本加载客户端入口的热重载驱动 |
dsh-client-locale | 语言环境插件：Host 支撑的中/英偏好与类型化字典 |
dsh-client-ui-primitives | 纯 React 原子：控件、图标、markdown、JSON 检查器 |
dsh-client-ui-slots | Slot 注册表纯核心：SlotMap 合并、register 组合 API |
dsh-client-ui-renderer | 把槽位数据绑定到 React，挂载组装好的应用；ctx.uiRenderer + SlotRegistry |
dsh-client-ui-session | 把 Session Controller 状态适配为标准 Slot 源/钩子 |
dsh-client-ui-theme | 主题插件：调色板引导、ThemeRuntime、--dsw-* 令牌 |
dsh-client-ui-brand-official | 用官方名称/标志填充通用浏览器品牌槽位 |
dsh-client-ui-layout | 三栏 AppFrame shell 插件，带拖拽手柄 |
dsh-client-ui-sidebar | 侧边栏插件：会话树、搜索、分组、状态点 |
dsh-client-ui-conversation | 目标无关的会话组装、shell、输入框、队列、视图导航——聊天目标/渲染已移至 ui-chat |
dsh-client-ui-chat | 聊天会话目标：节点定义、渲染器、详情界面 |
dsh-client-ui-commands | 客户端命令界面：全局目录缓存、/ source、命令 UI 种类 |
dsh-client-ui-input-trigger | 输入触发流水线：/ 与 @ 检测与候选菜单 |
dsh-client-ui-reference | 统一的 Web @file/@session 引用源 |
dsh-client-ui-model-selection | 模型选择 /model popupSelect |
dsh-client-ui-plan | 计划模式输入框控件，作用于计划投影 |
dsh-client-ui-goal | 停靠于输入框上方的会话目标 GoalBar |
dsh-client-ui-jobs | 会话顶栏的后台作业列表 |
dsh-client-ui-schedule | Web 会话顶栏中的只读活动提醒目录 |
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-approval | 呈现审批请求并返回用户决定；零运行时依赖 |
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-code-runtime-python | Node 宿主与 CPython 子进程之间的 fd-3 连线协议；Python 后端 |
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-file-reference | @file 提及发现 + 共用的提及语法；ctx.fileReferences |
dsh-file-reference-local | @file 提及的本地工作区补全提供者 |
dsh-session-reference | 跨会话快照引用与持久的不可信模型上下文 |
packages/credentials/*、packages/e2b/*
| 包 | 职责 |
|---|---|
dsh-credentials | 抽象凭据接缝（ctx.credentials） |
dsh-credentials-local | 基于文件的凭据提供者（$DSH_HOME/.env） |
dsh-authorization | 通过询问人类而取得凭据的插件自有流程；ctx.authorization |
dsh-e2b | 供提供者适配器共用的 E2B 沙箱生命周期 |
dsh-fs-e2b | E2B 文件系统实现 |
dsh-subprocess-e2b | E2B 子进程实现 |
packages/experimental/* — 原型，不随正式发布
整个组被排除在正式发布与 npm 发布之外：原型能力虽可在真实 harness 上运行，但不作稳定性承诺，也不得作为已发布产品的依赖。
| 包 | 职责 |
|---|---|
dsh-experimental-agent-team | Lead + 具名队友、持久邮箱、共享任务板；ctx.agentTeams |
dsh-experimental-agent-team-profile | Agent Teams 的源码检出 profile 层 |
dsh-experimental-agent-team-web-profile | Agent Teams 的源码检出 Web 层 |
dsh-experimental-client-ui-agent-team | Web 团队名册、任务板与队友导航 |
dsh-experimental-inspector | 跨领域 CDP 枢纽：Host 调试、Client Runtime 检视、网络捕获、Cordis 树 |
dsh-experimental-tool-agent-team | 十个模型工具：创建、发消息并协调队友 |
dsh-experimental-webworker-packer | 为浏览器 worker 预览构建 gzip 压缩的 VFS 镜像；库 + CLI |
dsh-experimental-webworker-runtime | 在专用浏览器 worker 内运行 harness 插件树 |
packages/extensions/*
| 包 | 职责 |
|---|---|
dsh-cordis-host-runner | 动态包定义注册表与 host 半边沙箱生命周期 |
dsh-cordis-client-runner | 双半边插件包的浏览器半边 |
dsh-tool-cordis | 自指式 cordis 工具集：检查运行时、挂载/释放模型编写的插件 |
dsh-client-ui-cordis | （列于 client 之下） |
dsh-client-ui-cordis位于packages/extensions/ui-cordis；为便于检索，在 client 与 extensions 两处交叉引用。
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-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 的设计孪生） |
dsh-deepseek-llm-api-extensions | 在官方 DeepSeek 请求上注册生命周期所有的顶层字段 |
dsh-plugin-package-inventory-deepseek | 向官方请求贡献当前活动的 Loader 包清单（dsh_plugin_packages） |
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 后端 |
dsh-session-log-deepseek | 将增量规范日志作为可选的官方 DeepSeek 元数据上传（dsh_session_log） |
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 工具，作用于执行器接缝 |
dsh-tool-pwsh-persistent | 基于 PTY 服务的属主隔离持久 PowerShell 会话工具 |
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-win32-process | 共用的 Win32 绑定：受限进程创建、stdio、Job、等待、清理 |
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-session-snapshot | 会话日志快照支持 + 面向 profile 驱动测试的协议适配器 |
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-util-crypto | 跨运行时 crypto.getRandomValues 的 RFC 9562 v4 UUID |
dsh-deque | 有界空位存储的均摊常数时间队列 |
dsh-home-paths | 共用文件系统路径助手（含 resolveDshHome） |
dsh-launch-environment | 记录每个值所属层级的不可变启动环境 |
dsh-native-command | 面向 OS 集成的零依赖无 shell execFile 运行器 |
dsh-output-retention | 有界保留原语（ItemRetainer/TextRetainer） |
dsh-util-time | 校验/规范化 IANA 时区 |
dsh-timeout | 超时/截止时间原语与 TimeReason 分类学 |
dsh-util-values | 校验/快照/比较/冻结无损 JSON 值 |
dsh-util-workspace-path | 浏览器安全的工作区路径/显示助手 |
packages/web/*
| 包 | 职责 |
|---|---|
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 工具 |
packages/webhook/* — 经校验的事件成为会话
产品级组（stable-API 预期），但没有任何随附 bundle 接入——由部署自行组合这些插件，例如通过 github-review 示例 overlay。
| 包 | 职责 |
|---|---|
dsh-webhook | Host ctx.webhookRuntime：规则注册表、回调生命周期、工作区支撑的会话创建 |
dsh-webhook-github | 签名 GitHub HTTP 适配器：ctx.webServer 上经 HMAC 校验的 POST 路由 → 分发 → 202 |
packages/workflow/*、packages/workspace/*
| 包 | 职责 |
|---|---|
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/* — 仓库内演示 spine
packages/examples/ 现在只有一个演示包；可运行的示例组合位于 apps/cli/config/examples/ 下，并由 apps/cli/tests/profiles/ 下的 profile 测试。
| 包 | 职责 |
|---|---|
dsh-agent-spine-demo | 带回退标题的默认无执行器/无 UI agent spine |
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 的计时器服务 |