DeepSeek_Harness_从开机到拆开_120页_12mb

DeepSeek Harness 从开机到拆开 总结

核心内容

DeepSeek Harness（简称 dsh）是一个编码代理工具，允许用户在自己的机器上运行，执行任务如读写文件、运行命令等。它提供了一个灵活的框架，用户可以自行配置和扩展，包括选择工作区、模式切换、插件安装等。

dsh 的主要功能包括：

• 执行任务，如统计文件行数和字符数
• 提供详细的事件日志，记录模型的思考过程、工具调用和结果
• 支持多种模式（标准模式、PTC模式、极简模式、创造模式），每种模式有不同的功能和限制
• 提供权限控制和沙箱机制，确保操作安全

主要观点

1. 权限与安全
   dsh 默认只允许在工作区目录内进行读写操作，权限控制通过沙箱和审批策略实现。用户可以调整权限档位，从只读到完全放开，但切换模式必须在空白会话中进行。

2. 工作区机制
   工作区不是一个简单的文件夹，而是一个带有路径和编号的实体。它与模型的上下文注入有关，用户需要先选择工作区，再切换模式。

3. 模式选择
   四种模式在功能和使用场景上差异显著，标准模式是默认且最常用，适合大多数任务；PTC模式和极简模式适合更高级或更轻量的使用；创造模式允许用户自定义工具配置，但需注意风险。

4. 与Claude Code的兼容性
   dsh 支持部分Claude Code的技能和配置，但存在兼容性问题，如钩子配置、规则文件等需手动调整或配置。

5. 事件流与日志
   dsh 每次运行都会生成详细的事件日志，记录模型的思考、工具调用和结果。这些日志可被用户查看和分析，提供透明度和可追溯性。

6. 沙箱与操作系统级安全
   dsh 的沙箱机制是操作系统级的，通过文件访问限制和权限控制确保安全。它支持 macOS、Linux 和 Windows，但不同平台有不同的实现方式。

关键信息

1. 权限与沙箱

• 默认模式：工作区可写（只允许修改工作区内的文件）
• 权限档位：有只读、工作区可写、完全放开三种
• 审批策略：默认为“ask”（需要用户确认），可设置为“never”（不问直接拒绝）
• 操作系统级限制：通过系统机制限制文件访问，无法绕过

2. 模式详解

3. 与Claude Code的兼容性

• skill文件夹：直接可用，但需注意文件名大小写问题
• 钩子配置：需手动配置，Claude Code的钩子配置在dsh中不完全兼容
• MCP服务器：可使用，但需手动配置
• 会话记录：不兼容，需自行管理
• 自定义斜杠命令：不支持，dsh有固定命令

4. 事件日志与模型可见内容

• 日志记录：每次运行都会生成详细的事件日志，包含44种事件类型
• 模型可见内容：只有6行，包括用户消息、助手回复和工具结果
• 日志可读性：日志文件是压缩格式，可通过命令解压查看

5. 成本与计价

• 计价方式：按峰段计价，官方公告从2026年8月17日起生效
• 成本：一个任务平均约0.09元，一天运行100次约2.4元
• 成本明细：在§06中详细拆解，包括每项操作的费用

6. 安装与使用

• 安装命令：npx @deepseek-ai/dsh web，需注意安装包的缓存问题
• 权限文件：存储在~/.dsh/.credentials.yaml，权限为600
• 工作区配置：需手动选择，且模式切换需在空白会话中进行

结构说明

• 标准模式：适合大多数用户，功能全面，是默认选择
• PTC模式：适用于更复杂的任务，但需注意耗时
• 极简模式：适合轻量级任务，功能较少
• 创造模式：允许自定义工具配置，但需谨慎使用

其他注意事项

• 日志管理：日志存储在~/.dsh/sessions/目录下，可手动查看
• 依赖管理：部分功能需额外安装npm包，如钩子桥、子代理等
• 安全性：沙箱机制和权限控制确保操作安全，但需注意文档与实际的差异
• 兼容性：部分Claude Code功能在dsh中无法直接使用，需手动配置

结论

DeepSeek Harness 是一个功能强大但仍在快速迭代的编码代理工具，适合需要执行复杂任务的用户。它提供了详细的日志和权限控制，确保操作透明和安全。然而，部分功能与Claude Code存在兼容性问题，需用户自行配置。总体而言，它是一个值得尝试的工具，但需注意其仍在早期阶段，接口可能变化。