怎样使用这篇速查
- 使用浏览器的页面查找功能，直接搜索术语。
- 需要准确含义时，先看专业解释。
- 仍然觉得抽象时，再看生活化说明。
- 准备修改权限、安装扩展或发布程序包前，再阅读对应的详细指南。
模型、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 官方原生格式。 |
| Plugin | 改变或增加 Harness 工作流程的插件，而不只是提供外观数值。 | 生活化理解：它会增加控制面板或工作区域，所以它的行为和权限与外观同样重要。 |
| Transport | 在 Web 界面与正在运行的 Harness 进程之间传递请求、事件和状态的连接。 | 生活化理解：它是控制室与工作台之间的传送通道。页面能显示，不代表这条通道一定已经连通。 |
程序包与验证
| 概念 | 专业解释 | 生活化说明 |
|---|---|---|
| Package | 把代码、元数据、资源或配置作为一个整体进行安装的带版本发布单元。 | 生活化理解：它是密封的商品盒。只看货架上的名称，不能证明这个具体盒子里装了什么。 |
| Artifact | 实际被下载、安装、测试或发布的精确构建文件，例如某一个确定的程序包归档。 | 生活化理解：它是已经送到手里的实物盒子，不是目录中的商品介绍。 |
| SHA-256 | 为制品全部字节计算的加密摘要，可作为稳定的文件指纹。 | 生活化理解：指纹一致说明两个文件的字节相同，但不能单独证明内容安全或素材权利合格。 |
| Sidecar | 与制品分开存放的机器可读记录，用来描述身份、兼容性、摘要或证据引用。 | 生活化理解：它是随盒附带的检查卡。检查卡和盒子本身必须相互对应。 |
| Attestation | 说明检查了什么、在哪个环境检查、使用哪些精确输入以及结果如何的受控记录。 | 生活化理解：它是一份注明日期和对象的检查报告。另一版本的报告不能证明眼前这个项目已经通过。 |
| 认证基线 | 某个项目完成规定验证流程时所使用的精确 Harness 版本和证据集合。 | 生活化理解：上游软件可能已经更新，但完成检查的版本仍然较旧。“更新”和“已认证”是两件不同的事。 |
遇到仍然看不懂的术语怎么办
- 01
找到完整术语
复制原文中的完整写法；如果带有产品名称，也要一起保留。
- 02
判断它属于哪一层
确认它说的是智能、工作组织、权限、界面，还是验证。
- 03
核对具体产品含义
同一个词在 DeepSeek Harness、Pi、Codex 或其他工具中可能有更具体的含义。
- 04
遇到高风险操作先暂停
如果术语关系到访问权限、凭据、安装或删除，应先阅读对应指南或官方来源。
从刚刚查到的概念继续学习
动手练习：从读取文件到核对一次修改
用一份小库存表把术语和实际操作连起来：读取文件、核对计算、修改一个值，再检查哪些状态被保存。准备一个空的练习文件夹，并按快速上手指南配置 Harness Web 的工作区和模型。
text
item,quantity,unit_price
tea,3,12
mug,2,25
bag,1,18- 01
选对工作区
选择包含 inventory.csv 的文件夹。工作区提供操作的工作目录；仅选择这个目录，并不等于建立了文件系统或网络沙盒。
- 02
确认当前运行设置
查看本会话使用的模型和权限预设。profile 决定加载的插件与配置，它不是工作区文件夹，也不是一段保存的聊天记录。
- 03
发送读取任务
复制下方提示词，展开实际的文件读取调用和返回结果，逐行对照本地文件。只看到一段流畅回答，不能证明文件真的被读取过。
text
读取当前工作区的 inventory.csv，逐项列出 quantity × unit_price 和小计，再给出总额。说明实际读取的文件路径，保持文件不变。如果无法读取，请指出缺少的工具或权限，不要编造文件内容。应得到 tea 小计 36、mug 小计 50、bag 小计 18，总额为 104。这里核对的是计算结果，不是给模型能力打分。如果不一致，分别检查原始行、乘法和加法。
| 概念 | 专业解释 | 生活化说明 |
|---|---|---|
| 工作区 | 存放 inventory.csv 的文件夹。 | 对照界面选中的路径和工具调用使用的路径。 |
| 模型与工具 | 模型提出读取请求，已注册的工具执行读取并返回内容或错误。 | 查看实际调用及返回值，不要把最终回答当作执行日志。 |
| 上下文 | 工具返回的 CSV 可以进入下一次模型请求。 | 文件变更后要求重新读取；上一次工具结果可能已过时。 |
| 轮次与步骤 | 提交的请求开启一个轮次，其中可能包含多次模型请求和工具调用。 | 数一数真实发生的调用，不要把一条用户消息等同于一次模型请求。 |
| 会话 | 这段持续的对话记录已完成的消息和工具活动。 | 重新打开同一会话，查看此前的读取记录；这和恢复文件是两件事。 |
再区分文件修改与会话历史
text
只把 inventory.csv 中 tea 的 quantity 从 3 改为 4。重新读取保存后的文件，展示确切改动的行，并重新计算所有小计与总额。其他数据行保持不变。保存后的行应为 tea,4,12，总额应为 116。请自己打开文件，与第一段示例对照。重新打开或分支一个会话，不会自动撤销文件修改；要回到初始示例，应明确把该行恢复为 tea,3,12，再核对总额 104。如果使用 Git，先查看差异，再决定恢复哪些内容。
- 没有工具调用或提示文件不存在：先检查工作区和文件名，不要通过开放全部权限来掩盖路径错误。
- 操作被阻止：阅读实际的批准或沙盒错误及其指出的范围。profile 名称和提示词中的“只读”都不是技术执行约束。
- 修改后仍回答 104：让它重新读取当前文件，检查是否沿用了会话里的旧结果。
阅读一手官方资料
DeepSeek Harness v0.1.3-alpha.1 发布页核对本文采用的上游发布标签与源码提交。DeepSeek Harness Alpha README阅读固定版本的产品定义、开发者预览边界与 Web UI 启动路径。DeepSeek Harness Alpha 架构核对固定版本的插件、Profile、bundle、工具和会话模型。DeepSeek Harness Alpha Web UI 指南核对固定版本的模型设置、工作区选择、首个任务与审批行为。DeepSeek Harness 权限预设了解 sandbox mode 与 approval policy 如何组合，以及真正的执行边界位于何处。DeepSeek Harness Skills 子系统核对发现、提供方、身份、加载与调用边界。
常见问题
修改前需要了解的事项
关于格式、兼容性、证据与回滚的简明说明。
这篇指南核实哪些范围？
本指南覆盖：DeepSeek Harness alpha.1 架构与 Web UI 术语；DSH Themes 发布与界面外观术语；专业解释与简短生活化说明相互对应
我应该先做什么？
遇到陌生术语，先查定义，再用生活化例子理解。想亲手试一试，可以跟着文末的 inventory.csv 练习，完成读取文件、核对总额、修改一个值和恢复文件。
最需要记住的边界是什么？
类比可以帮助理解，但不能代替产品的精确行为。涉及权限、沙箱、凭据和兼容性时，应以实际配置和验证证据为准。
profile 就是文件系统沙盒吗？
不是。profile 组合配置和插件；文件系统与进程隔离由实际执行器和沙盒配置决定。
回答正确就能证明工具真的执行了吗？
不能。需要查看实际调用、返回内容，并自行检查文件。预期总额用于交叉核对，不能单独证明文件访问。
重新打开旧会话，会把文件恢复成旧版本吗？
不会。会话历史与工作区文件是两种状态。先查看当前文件，需要恢复时再执行明确且经过检查的文件操作。
继续学习
查看验证证据并继续操作
对比已发布制品，或返回安装文档。