第5章 工作台:会话、工作区、权限

第 5 节 / 共 13 节 课程:DeepSeek Harness 实战课

会装不等于会用。这一章讲工作台的四条边界:会话、工作区、审批、计划,以及上下文被压缩后怎么恢复。

工作区(Agent 的文件边界)项目文件NOTES.mdGit 历史Agent 只能在这里读写审批门写/删/推送外部系统数据库/网络
图 5-1 工作区决定“能碰什么”,审批门决定“能不能真的动手”

本章共 7 节,另附练习,建议按顺序阅读:

会话

一次会话是一段有连续上下文的工作记录。DSH 会把消息、工具调用、结果、计划记在会话日志里。好习惯:一个任务一个会话;任务切换开新会话;长任务定期总结;结束前留交接。

工作区

工作区是 Agent 的文件边界,决定它能读哪些文件、写哪些文件、命令在哪个目录执行、哪些路径是外面。建议:一个项目一个工作区;不要把密钥、客户隐私、磁盘根目录设为工作区;练习用专用目录;重要项目先 git init,让每次修改可回滚。

审批

当 Agent 要执行可能影响系统的操作(写文件、跑命令、访问外部资源)时,DSH 会按当前权限策略请求审批。审批不是麻烦,而是你唯一能踩刹车的地方。三个习惯:看命令(尤其 rm、del、git push --force、DROP TABLE、curl | bash);看范围(改哪个文件、工作区内还是外);看回滚(错了怎么恢复,有没有备份/commit)。

计划

复杂任务先让 Agent 出计划:

先不要动手。请阅读相关文件,给出:
1) 你理解的验收标准;
2) 分步骤计划(每步用什么工具、产出什么);
3) 主要风险与回滚方案;
4) 需要我确认的问题。
我确认后再执行。

计划的价值不是好看,而是让你在成本最低的时候发现方向错误。

上下文压缩

长会话会触发上下文压缩:把早期内容折叠成摘要,腾出空间。副作用是细节可能丢失。应对:关键结论、文件路径、命令、决策写进项目里的 NOTES.md;压缩后让它复述“当前任务、已完成、待办、约束”;重要任务拆成多个阶段。

文件引用与 @

Web UI 通常可以用 @ 引用工作区文件,或把文件拖进对话。原则:能给文件就给文件,不要让 Agent 猜。

@src/main/java/cn/jssp/controller/ChapterController.java
这个接口最近变慢了。请先只读分析:
- 它调用了哪些 service/repository;
- 有没有一次性加载大字段;
- 给出 3 个可能的性能瓶颈,并标注证据所在行号。

Profile

profile用途
web默认 Web UI
headless一次性命令行任务
sdk / sdk-minimal给 Python SDK 嵌入
acp编辑器/客户端集成

普通用户先用 web 即可。需要定制时再研究 cordis.patch.yml。

本章练习

为真实项目建工作区,git init 并提交一次;让 Agent 做只读体检;故意让它执行一个需要审批的命令;写一份 NOTES.md 记录目标、约束、常用命令。