第5章 工作台:会话、工作区、权限
会装不等于会用。这一章讲工作台的四条边界:会话、工作区、审批、计划,以及上下文被压缩后怎么恢复。
会话
一次会话是一段有连续上下文的工作记录。DSH 会把消息、工具调用、结果、计划记在会话日志里。好习惯:一个任务一个会话;任务切换开新会话;长任务定期总结;结束前留交接。
工作区
工作区是 Agent 的文件边界,决定它能读哪些文件、写哪些文件、命令在哪个目录执行、哪些路径是外面。建议:一个项目一个工作区;不要把密钥、客户隐私、磁盘根目录设为工作区;练习用专用目录;重要项目先 git init,让每次修改可回滚。
审批
当 Agent 要执行可能影响系统的操作(写文件、跑命令、访问外部资源)时,DSH 会按当前权限策略请求审批。审批不是麻烦,而是你唯一能踩刹车的地方。三个习惯:看命令(尤其 rm、del、git push --force、DROP TABLE、curl | bash);看范围(改哪个文件、工作区内还是外);看回滚(错了怎么恢复,有没有备份/commit)。
计划
复杂任务先让 Agent 出计划:
计划的价值不是好看,而是让你在成本最低的时候发现方向错误。
上下文压缩
长会话会触发上下文压缩:把早期内容折叠成摘要,腾出空间。副作用是细节可能丢失。应对:关键结论、文件路径、命令、决策写进项目里的 NOTES.md;压缩后让它复述“当前任务、已完成、待办、约束”;重要任务拆成多个阶段。
文件引用与 @
Web UI 通常可以用 @ 引用工作区文件,或把文件拖进对话。原则:能给文件就给文件,不要让 Agent 猜。
Profile
| profile | 用途 |
|---|---|
| web | 默认 Web UI |
| headless | 一次性命令行任务 |
| sdk / sdk-minimal | 给 Python SDK 嵌入 |
| acp | 编辑器/客户端集成 |
普通用户先用 web 即可。需要定制时再研究 cordis.patch.yml。
本章练习
为真实项目建工作区,git init 并提交一次;让 Agent 做只读体检;故意让它执行一个需要审批的命令;写一份 NOTES.md 记录目标、约束、常用命令。
《DeepSeek Harness 实战课》课程目录
面向应用者的 DeepSeek Harness 实战课:讲清 API、Agent、Harness 三者关系,带你安装 DSH、写出可验收任务、让 Agent 读文件改代码跑测试、接 MCP/插件、做定时任务,并划清安全边界