怎样使用这篇速查
- 使用浏览器的页面查找功能，直接搜索术语。
- 需要准确含义时，先看专业解释。
- 仍然觉得抽象时，再看生活化说明。
- 准备修改权限、安装扩展或发布程序包前，再阅读对应的详细指南。
模型、Agent 与 Harness
| 概念 | 专业解释 | 生活化说明 |
|---|---|---|
| AI 模型 | 根据输入生成文本、代码或其他输出的统计系统。模型本身不会自动获得电脑访问权限。 | 生活化理解：模型是坐在桌前思考的人；桌子、工具、钥匙和记录都由系统的其他部分提供。 |
| Agent | 把模型与指令、上下文、工具和执行循环组合起来，能够分多步完成目标的运行角色。 | 生活化理解：它不只回答一次，而是可以先查看、再操作、检查结果，然后继续完成任务。 |
| Agent Harness | 协调模型、工具、上下文、权限、会话和交互界面的软件环境。 | 生活化理解：它是工作人员周围那套受管理的工作台，决定有哪些工具、哪些门上锁，以及日志记录什么。 |
| Provider | 把模型接入 Harness 的服务或适配器，并处理请求格式和认证方式。 | 生活化理解：同一个工作台可以接入不同的供电方，但每一方都有自己的账户和连接规则。 |
| Tool | Agent 可以请求调用的具名能力，例如读取文件、修改文字、运行命令或搜索资料。 | 生活化理解：Tool 是工具柜里的具体工具。工具出现在清单中，不代表可以不经批准随意使用。 |
| Context | 当前模型请求可以看到的信息，包括指令、选定的历史、文件和工具结果。 | 生活化理解：Context 是这次判断时摊在桌面上的资料，不等于系统会永久记住发生过的一切。 |
工作怎样组织起来
| 概念 | 专业解释 | 生活化说明 |
|---|---|---|
| Workspace | 为任务选定的项目位置，其中的文件和命令构成主要工作边界。 | 生活化理解：它是交给工作人员使用的某个房间，不是整栋楼的通行证。 |
| Session | 一条持续工作线的持久记录，包含消息、模型输出、工具活动和状态。 | 生活化理解：它是项目日志，让你稍后回来时仍能看懂讨论过什么、做过什么。 |
| Turn | 一次用户输入触发的完整响应周期，其中可能包含多个模型和工具步骤。 | 生活化理解：你在服务台提出一次请求，工作人员可能需要完成多个内部动作，才给出最终结果。 |
| Step | Turn 内的一次模型请求，以及随后产生的工具调用。 | 生活化理解：Step 是清单上的一个步骤，Turn 则是这次请求从开始到结束的完整过程。 |
| Plugin | 可以加载到 Harness 中的软件单元，用来提供服务、事件、工具、界面部件或其他行为。 | 生活化理解：它是经过许可后加入工作台的模块，例如一台新机器或一块新控制面板。 |
| Profile | 决定哪些 bundle、插件和配置层一起启动的具名组合。 | 生活化理解：它是针对某类工作保存的一整套工作台配置。DeepSeek Harness 提供 web 和 headless 模板。 |
| Skill | 由指令和辅助资源组成的可复用工作方法，教 Agent 完成一个边界明确的流程。 | 生活化理解：它是一张经过审核的操作流程卡，负责指导做法，但不会暗中增加电脑权限。 |
| Runtime | 任务实际运行时使用的软件进程、依赖版本、配置和操作环境。 | 生活化理解：菜谱可以完全相同，实际厨房却可能不同。验证必须在真正会使用的厨房里完成。 |
| Diff | 用结构化方式显示文件或文字在两个状态之间有哪些差异，本身不会自动采用其中任何一个状态。 | 生活化理解：它是一张把改动行标出来的前后对照表。阅读 diff 不等于接受这些修改。 |
| Hook | 为某个事件配置的触发机制，会在事件之前、之后或发生过程中运行指定动作。 | 生活化理解：它像连接了固定响应的门铃。响应可能执行代码，所以要检查来源和权限。 |
| MCP | Model Context Protocol，让 Agent 或 Harness 通过 MCP server 连接外部工具与数据的一套标准协议。 | 生活化理解：它是工作台连接另一项服务的标准接口。接口能够接上，不代表服务天然可信。 |
| Cloud | 位于本机之外的远程运行环境，拥有自己的文件、凭据、网络、持久化和计费边界。 | 生活化理解：它像租用另一栋楼里的工作间。交付任务前要检查钥匙、存储、费用和清理规则。 |
权限与安全
| 概念 | 专业解释 | 生活化说明 |
|---|---|---|
| Permission | 说明某项操作可以执行、必须拒绝，还是需要在运行时作出决定的规则。 | 生活化理解：它是门上的通行名单。只在文字里要求谨慎，并不等于真正设置了门禁。 |
| Approval | 某项具体操作继续之前，由人或策略作出的允许决定。 | 生活化理解：工作人员走到上锁的柜子前，需要先询问你，得到同意后才能拿钥匙。 |
| Sandbox | 限制进程某些行为影响的技术边界，实际覆盖范围取决于平台和配置。 | 生活化理解：它是一块有围栏的工作区。仍要确认围栏限制的是文件、网络、进程，还是只覆盖其中一部分。 |
| Credential | 向模型提供方、服务、仓库或其他受保护系统证明身份的秘密信息。 | 生活化理解：它相当于钥匙或银行卡。应放进指定设置或秘密存储，不能写进聊天内容和项目文件。 |
| 最小权限 | 只授予当前任务确实需要的访问能力，并且只保留必要的时间。 | 生活化理解：访客只需要会议室钥匙时，不应把整栋楼的万能钥匙交给他。 |
| Rollback | 变更失败或不再需要时，把系统恢复到此前已验证状态的预备操作。 | 生活化理解：替换任何东西之前，先保存上一份可用版本，并写清楚返回路线。 |
界面与外观
| 概念 | 专业解释 | 生活化说明 |
|---|---|---|
| 语义 Token | 按用途命名的设计值，例如背景或强调色，而不是直接固定为某个颜色。 | 生活化理解：它相当于“墙面漆”或“警示灯”这样的用途标签，不同 Theme 可以为同一用途提供不同颜色。 |
| Theme | 一组协调一致的语义外观值，通常同时覆盖浅色与深色模式，但不改变产品结构。 | 生活化理解：它更换房间的配色和照明方案，但墙体与家具位置保持不变。 |
| Full Skin | DSH Themes 的一种发布类别，在更严格证据规则下组合语义值、受控图片和生成样式。 | 生活化理解：它会同时调整配色、照明和部分装饰。Full Skin 是 DSH Themes 格式，不是 DeepSeek Harness 官方原生格式。 |
| UI Extension | 改变或增加界面工作流程的扩展，而不只是提供外观数值。 | 生活化理解：它会增加控制面板或工作区域，所以它的行为和权限与外观同样重要。 |
| Transport | 在 Web 界面与正在运行的 Harness 进程之间传递请求、事件和状态的连接。 | 生活化理解：它是控制室与工作台之间的传送通道。页面能显示，不代表这条通道一定已经连通。 |
程序包与验证
| 概念 | 专业解释 | 生活化说明 |
|---|---|---|
| Package | 把代码、元数据、资源或配置作为一个整体进行安装的带版本发布单元。 | 生活化理解：它是密封的商品盒。只看货架上的名称，不能证明这个具体盒子里装了什么。 |
| Artifact | 实际被下载、安装、测试或发布的精确构建文件，例如某一个确定的程序包归档。 | 生活化理解：它是已经送到手里的实物盒子，不是目录中的商品介绍。 |
| SHA-256 | 为制品全部字节计算的加密摘要，可作为稳定的文件指纹。 | 生活化理解：指纹一致说明两个文件的字节相同，但不能单独证明内容安全或素材权利合格。 |
| Sidecar | 与制品分开存放的机器可读记录，用来描述身份、兼容性、摘要或证据引用。 | 生活化理解：它是随盒附带的检查卡。检查卡和盒子本身必须相互对应。 |
| Attestation | 说明检查了什么、在哪个环境检查、使用哪些精确输入以及结果如何的受控记录。 | 生活化理解：它是一份注明日期和对象的检查报告。另一版本的报告不能证明眼前这个项目已经通过。 |
| 认证基线 | 某个项目完成规定验证流程时所使用的精确 Harness 版本和证据集合。 | 生活化理解：上游软件可能已经更新，但完成检查的版本仍然较旧。“更新”和“已认证”是两件不同的事。 |
遇到仍然看不懂的术语怎么办
- 01
找到完整术语
复制原文中的完整写法；如果带有产品名称，也要一起保留。
- 02
判断它属于哪一层
确认它说的是智能、工作组织、权限、界面，还是验证。
- 03
核对具体产品含义
同一个词在 DeepSeek Harness、Pi、Codex 或其他工具中可能有更具体的含义。
- 04
遇到高风险操作先暂停
如果术语关系到访问权限、凭据、安装或删除，应先阅读对应指南或官方来源。
从刚刚查到的概念继续学习
阅读一手官方资料
DeepSeek Harness v0.1.1-rc.2 发布页核对本文采用的上游发布标签与源码提交。DeepSeek Harness RC.2 README阅读固定版本的产品定义、开发者预览边界与 Web UI 启动路径。DeepSeek Harness RC.2 架构核对固定版本的插件、Profile、bundle、工具和会话模型。DeepSeek Harness RC.2 Web UI 指南核对固定版本的模型设置、工作区选择、首个任务与审批行为。DeepSeek Harness 权限预设了解 sandbox mode 与 approval policy 如何组合，以及真正的执行边界位于何处。DeepSeek Harness Skills 子系统核对发现、提供方、身份、加载与调用边界。
常见问题
修改前需要了解的事项
关于格式、兼容性、证据与回滚的简明说明。
这篇指南核实哪些范围？
本指南覆盖：DeepSeek Harness rc.2 架构与 Web UI 术语；DSH Themes 发布与界面外观术语；专业解释与简短生活化说明相互对应
我应该先做什么？
你不需要背下这些术语。遇到看不懂的词时，先读专业解释确认准确含义，再看生活化说明，把它和熟悉的事物联系起来。
最需要记住的边界是什么？
类比可以帮助理解，但不能代替产品的精确行为。涉及权限、沙箱、凭据和兼容性时，应以实际配置和验证证据为准。
继续学习
查看验证证据并继续操作
对比已发布制品，或返回安装文档。