mirror of
https://github.com/deepseek-ai/deepseek-harness.git
synced 2026-08-29 04:26:38 +00:00
Tianyi Cui
f0f9b294dd
Document dsh as the only application launcher across architecture, CLI, SDK, app-boot, Python package, contributor, tutorial, and example references. Explain explicit home selection, profile and patch precedence, persistent external plugin installation, the Node-free runtime path, and the absence of complete-config or ~/.dsh fallbacks. Record the Python profile-runtime decision and update the active naming, installed-wheel, and SEA packaging notes with precise supersession. Regenerate the configuration catalog and module graph after deleting the carrier, update both reviewed languages and pairing records, and classify the retained standalone Cordis files as lower-level test fixtures rather than launch interfaces.
7.7 KiB
7.7 KiB
包
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、本地进程树提供方与共享 Win32 进程库 | 产品：稳定 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 |
webhook/ |
已验证外部事件、规则与 fire-and-forget Workspace Session | 产品：稳定 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/ |
供可运行示例使用的可复用演示组合包 | 支持：示例基础设施 |
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，或列入其允许清单。