7.6 KiB
description, kind
| description | kind |
|---|---|
| DeepSeek Harness 包工作区：packages/ 下的 npm 包如何分组、每个组负责什么，以及约束它们的约定。 | package-group |
包
English | 中文
概述
harness 由 packages/ 下的 npm 包组装而成，按能力系列分组：会话与 agent 循环、面向模型的工具、shell 与文件系统执行、Web 访问、subagent 等等。把本页当作顶层地图使用：先找到拥有某能力的组，再打开其 README 查看包列表。每个包都以 @deepseek-ai/dsh-* 为作用域、只属于一个组；每个组的 README 都是该能力系列的权威包映射。
目录
包分组
每个包只属于一个组；新包加入现有组，新组则更新其自身 README 与本表。
| 组 | 职责 |
|---|---|
core/ |
产品 API 主干：会话、提示词、工具、agent 服务与具体循环 |
api/ |
Remote BFF 装配与 Typert RPC 网关 |
typert/ |
类型图生成、产物加载与运行时注册表 |
goal/ |
同会话 goal 的持久化与生命周期 |
schedule/ |
仅限会话内的定时后续操作 |
feedback/ |
人类反馈的采集与命令 |
identity/ |
共享匿名身份 |
llm/ |
LLM 能力系列：抽象服务 + 提供方适配器 |
e2b/ |
E2B 远程运行时提供方 |
subprocess/ |
子进程能力系列：Service Definition + 本地进程树提供方 |
shell/ |
Bash 能力系列：执行器 seam、本地实现、面向模型的工具 |
terminal/ |
持久 PTY 能力系列：限定所有者范围的会话、本地实现、面向模型的工具 |
code-runtime/ |
代码执行能力系列：Service Definition + worker 线程提供方 + Code Mode Consumer |
sandbox/ |
进程限制 seam；bwrap/Landlock/Seatbelt 后端 |
fs/ |
文件系统能力系列：seam、本地实现、面向模型的文件工具、发现工具 |
lsp/ |
LSP 能力系列：seam、通用 stdio 提供方和 lsp 工具 |
skill/ |
skill 能力系列：提供方注册表、本地提供方、面向模型的目录/loader |
compaction/ |
压缩能力系列：Service Definition + 基础提供方 + 命令 Consumer |
context/ |
模型可见请求上下文：workspace 指令、时间上下文、引用 |
subagent/ |
subagent 能力系列：提供方注册表约定和面向模型的委托工具 |
jobs/ |
通用后台任务运行时和面向模型的作业控制工具 |
experimental/ |
私有原型与内部专用插件 |
workflow/ |
工作流 seam、worker 线程引擎、面向模型的 workflow/ralph 工具 |
webhook/ |
已验证外部事件、受信规则与即发即弃 Workspace Session |
web/ |
Web 能力系列：seam、搜索/获取提供方、面向模型的 Web 工具 |
attachment/ |
持久附件标识、校验、本地内容寻址存储 |
spill/ |
spill 能力系列：存储 seam、本地实现、工具结果 spill 策略 |
todo/ |
面向模型的 todo_write 工具 |
plan/ |
Plan 协作状态，提供直接进入命令与经评审的退出 |
preset/ |
由 preset cordis.yml 按会话组装 agent |
guard/ |
循环卫生守卫：建议性重复调用提醒 + tools/execute 截止时间强制执行器 |
bundle/ |
可安装的 dsh --profile 补丁层 |
extensions/ |
agent 运行时自修改：实时插件/服务检查与模型所写挂载/卸载 |
hooks/ |
钩子桥接 + 共享的 Claude Code / Codex 线协议库 |
session/ |
持久会话数据平面：持久化 seam + 后端、投影 seam、基于日志的标题、会话上报 |
session-query/ |
会话检索系列：逻辑语料库、有界读取、血缘、语义过滤、SQLite 全文搜索 |
settings/ |
用户设置 seam + 基于文件的提供方 |
credentials/ |
凭据引用/记录 seam + 环境变量优先于 .env 的提供方 + 询问人类的授权 flow |
storage/ |
非会话存储中枢 + 后端 + 领域形式 |
workspace/ |
Workspace 实体 |
sdk/ |
进程外 SDK：JSON-RPC 协议与 TypeScript 客户端／服务器 |
acp/ |
仅面向自动化的 Agent Client Protocol 服务器 |
interaction/ |
人机协作平面：批准/交互 seam、权限预设、命令、询问用户的工具 |
boot/ |
共享的 app bin 启动粘合层 |
host/ |
web GUI 宿主半侧：API 网关 + HTTP 路由服务器 |
client/ |
web GUI 浏览器半侧：shell、协议层、对象服务、slot、ui-* 插件 |
examples/ |
供测试与自定义部署复用的组合包 |
test-support/ |
支持基础设施（testkit、不变式、回放、Loader 冒烟测试） |
runtime-diagnostics/ |
运行时诊断：按包归属的运行时不变式检查与报告 |
util/ |
组间共享的低层零依赖工具（Branded<B>、home/路径辅助函数、超时、留存） |
发布预期
大多数组是产品——稳定 API。例外：e2b/ 是 POC，experimental/ 不发布，examples/、test-support/、runtime-diagnostics/ 与 util/ 是兼容性预期较低的支持组。
依赖
依赖图由工具生成：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 约定
每个包 README 都覆盖用途、配置、扩展点与模型体验，列入模型无关省略允许清单的包除外。它还要包含 ## Known Limitations and Deferred Work，或列入其允许清单。包约定——导出、服务访问、不变式、测试——见 packages/AGENTS.md。
开发备注
维护者的工作上下文——点击展开
无。