DeepSeek Harness学习手册
FIELD GUIDE   /   11

选一个工作区,文件会写到哪里?

把一次读书会的材料放在一个文件夹,只把这个文件夹选作工作区。同一个文件夹里可以开多个会话,例如一个整理纪要、另一个编写通知。

本篇目录 4 节
01

工作区、会话和文件是三件事

名称打开界面时你会看到什么真正存在哪里
工作区侧栏里可以选择的项目,例如「读书会」登记的是运行 Harness 那台电脑上的目录路径。文件仍在原来的磁盘目录。
会话同一工作区下的一段独立对话及其工具记录会话记录由 Harness 保存。同目录里的其他会话也可能修改这里的文件。
文件纪要、数据、代码、写完的草稿本地工具创建的文件可以用系统文件管理器打开。移除工作区登记不会删除磁盘上的文件。
02

从已有目录开始

  1. 先用系统文件管理器新建一个普通目录,例如「读书会」,在里面放一份可以交给模型处理的材料。项目无需先建 Git 仓库。
  2. 打开 Harness。若已经看见默认工作区,可从侧栏选「添加工作区」;若界面尚无选中的工作区,可从「选择工作区」进入,再添加目录。
  3. 选中含材料的那个目录。启动服务的目录和当前选择可能不同;远程服务选择的是服务所在机器的目录。查看当前名称和路径,再在该工作区内打开会话。
  4. 要求把纪要保存为工作区里的 meeting-summary.md。展开工具返回,核对实际路径,再用文件管理器打开该文件。只有一段聊天回复时,磁盘上未必已经有文件。
03

读、写和编辑分别做什么

随附配置会保护旧内容。改写已有文件前通常要先成功读取,读过之后若有其他程序改了文件,需要重新读取最新版本再改。这个检查与沙箱拒绝越界写入是不同原因。

工具动作适合的情况如何核对
read 读取先读取现有文本的一段或全部。长文件可能分段返回。核对结果开头的文件路径与行号。若有截断提示,再要求读取后续部分。
write 写入新建文本文件,或用新内容整体替换现有文件。第一次整理时给输出起个新文件名。工具返回创建或更新状态后,再打开成品。
edit 编辑只替换现有文件中的指定文字。确认定位的是哪一段。多个位置相同时需要缩小范围,或明确同意修改所有匹配项。
04

为什么选了一个小目录,仍可能看得到外面?

相对路径通常以当前会话的工作目录为起点。若会话起点是 project,meeting.txt 就是其中的文件,../outside/marker.txt 则指向上一级目录里的另一份文件。

工作区给默认工具提供操作起点,并参与写入边界判断。随附的文件工具允许读取当前系统账户能访问的其他路径。创建小工作区有助于控制日常写入范围;需要隔离私人文件时,可以在独立账户、容器或虚拟机里运行,并只提供必要材料。

project 中的会议文件和项目外同级 outside 目录之间的关系
图 4 会话从 project 开始。读取范围与写入范围要分别检验。

来源与延伸阅读

TAKE IT WITH YOU

把手册和练习材料带走

知识库方便查阅和备课,演示素材可用于跟做站内示例。