术语表
从零到懂 DSH,这些词先过一遍。每条给"一句话"与出处链接。
A：Z
ACP(Agent Client Protocol)
把 harness agent 暴露给程序化 client 的自动化传输(非人机交互层);跨进程子 Agent provider acp 走它。→ 子 Agent
Agent-default-model
各 Agent 入口共享的默认模型选择(ctx.agentDefaultModel),要求 { provider, model },web / headless / API 入口共用,可被会话内 Models 设置覆盖。→ 多模型
Attachment(附件)
ctx.attachments 持久化二进制附件缝:校验并原子提交不可变图片字节,会话日志只存 sha256: 引用与校验过的元数据。→ 附件
Bundle
自带 patch 的插件包,作为一层加入 profile。dsh.bundle.patch 声明。→ 插件解剖
Checkpoint(语义检查点)
session-checkpoint-policy 在模型请求前、工具外部副作用前、每个 step 边界强制落盘;拒绝即 fail-closed。→ 会话系统
Compaction(压缩)
压缩能力族:ctx.compaction 缝 + compaction-basic 后端,按 token 压力把最旧 surface 折叠成摘要,复用 KV cache。→ 上下文与 token
Cordis
DSH 的组合框架(vendor 化,仅发布为 @deepseek-ai/cordis),提供 Context、依赖注入、插件装载、事件。→ 架构
Credentials(凭据引用)
ctx.credentials 缝:配置只存引用、不存密钥,按操作解析;优先级 进程环境 > .credentials.yaml > 工作目录 .env > $DSH_HOME/.env。→ 凭据管理
Dual-face(客户端双面)
一个包同时有 node 半部 + 浏览器半部(dsh.client)。→ Web UI
E2B
实验性云沙箱 POC:把文件系统 + 子进程执行世界挪进 E2B Linux 沙箱,opt-in 不默认挂载。→ E2B 云沙箱
Feedback(反馈)
两个契约:/feedback 追加 log-only feedback/record 事件;消息反馈是绑单条 assistant 消息的可编辑评分侧车;都不进模型。→ 反馈
Guard(行为守卫)
packages/guard 两个自包含行为插件(repeat-tool-reminder / timeout-policy),盯无产出模式与每调用预算,非可替换 capability。→ 工具执行
Patch
cordis.patch.yml 里的叠层条目(insert / 按 id 覆盖),决定"哪层覆盖哪层"。→ 插件解剖
Persona
可组合的人格行,shadow 部署 persona。→ Agent 预设
Plan-mode(规划模式)
per-agent 规划协作状态 + 政策提示段(软指导),/plan 进入、exit_plan_mode 批准退出;不切换模型。→ 多模型
Preset(权限预设)
操作模式档(workspace-write / danger-full-access)+ approval。→ 权限
Preset(agent-presets)
每会话固定组合(agent.cordis.yml)。→ Agent 预设
Profile
$DSH_HOME/profiles/<name> 目录,装 bundle 层 + 用户 patch 层。→ 配置
Projection(会话投影)
ctx.sessionProjections 供 client 的整日志派生视图(当前 surface / 标题 / token 账目),fold 捷径、非权威。→ 会话系统
Scope(作用域)
context 分层(global / agent),决定可见性与遮蔽。→ 插件解剖
Seam(能力缝)
抽象能力接口(ctx.llm/ctx.tools/ctx.sandbox…),实现可换。→ 架构
Session / Turn / Step
会话 / 轮次 / 步骤 三级生命周期。→ 第一次会话
Session query(会话检索)
ctx.sessionQuery 会话检索缝:live/durable 日志的授权读取、关系轨迹、SQLite FTS5 搜索;session_search 工具默认不挂。→ 会话检索
Spill(溢出)
ctx.spillStore 工具输出溢出缝:超长明文落盘成会话作用域文件,模型侧换有界预览 + 定位符。→ 溢出存储
Surface
会话日志之上、模型看到的派生消息层。→ 会话
Token-meter(token 计量)
可重放计量单例 ctx.tokenMeter,固定启发式(4 字符/token + 结构开销)估算,压缩的判断依据。→ 上下文与 token
Tool
模型可调的能力(schema + output + execute)。→ 工具执行
极易混的一对
| 一对 | 说明 |
|---|---|
tools/* vs tool/* | Cordis 进程内通知(复数)vs 会话日志事件(单数)。→ 事件 |
| patch 层 vs settings 层 | 部署方静态配置 vs 用户运行时设置。→ 配置 |
| permission vs sandbox | 操作模式档 vs 命令执行边界。→ 权限 |
| plan-mode vs 多模型 | /plan 不改模型;多模型靠多 provider。→ 模型 |
| surface vs projection | 模型看到的派生消息层 vs client 的日志派生视图。→ 会话 |
| shell vs terminal | 一次性命令封装 vs 持久 owner 作用域交互终端会话。→ 子进程与终端 |
按需深读
每个词详细展开在对应页面;想按知识层级走,从 学习路径 开始。