2026DeepSeekHarness橙皮书-从开机到拆开_120页_12mb

DeepSeek Harness 从开机到拆开 总结

核心内容概览

《DeepSeek Harness 从开机到拆开》是一份对 DeepSeek Harness v0.1 开发者预览版的实测文档，记录了从安装、运行、权限管理到工具使用等全过程。本文档为非官方文档，基于作者在本地的真实体验，揭示了产品在实际运行中的一些特性、限制与实测细节。

主要观点

• DeepSeek Harness 是一个编码 agent：它能读写文件、执行命令、调用工具、甚至能生成代码。
• 它是一个可拆解的框架：用户可以像拼乐高一样，自由替换或添加功能模块。
• 没有「删除会话」功能：会话记录只能归档或重命名，不能删除。
• 权限管理是核心：通过三档沙箱和审批策略控制模型行为。
• 模式选择影响功能：四个模式分别对应不同的使用场景和能力范围。
• 与 Claude Code 兼容性有限：部分配置和功能不能直接迁移，需重新设置。
• 日志记录完整：包括模型可见内容和不可见的系统信息，便于回溯和审计。
• 文档与实际存在差异：部分内容在官方文档中未说明，需通过实测了解。

关键信息

1. 安装与运行

• 安装命令：npx @deepseek-ai/dsh web
• 安装包大小：约 342MB，且会缓存，多次运行时无需重复下载。
• 首次运行体验：21.9 秒内完成文件扫描与统计，生成 report.md。
• 工作区概念：不是文件夹，而是系统维护的项目目录，包含路径、名称、会话账本、创建与更新时间。
• 权限管理：
  • 默认模式：workspace-write，只允许修改工作区内的内容。
  • 沙箱机制：操作系统级限制，如 macOS 的 sandbox-exec、Linux 的 bubblewrap、Windows 的受限令牌。
  • 审批策略：默认为 ask，模型执行越界操作前会弹窗询问。
• 模式切换限制：只能在空白会话中切换，且不能在运行中更改。
• 模式简介：
  • 标准模式：默认模式，包含 25 个工具，适合绝大多数用户。
  • PTC 模式：标准模式的扩展，但默认不启用，需手动配置。
  • 极简模式：仅保留基本工具，适合跑分测试。
  • 创造模式：用于自定义 agent 预设，有风险。

2. 与 Claude Code 的兼容性

• 技能文件夹：~/.agents/skills 可直接使用，而 ~/.claude/skills 默认不可见。
• 钩子配置：Claude Code 的 hooks.json 部分功能无法直接迁移，需重新配置。
• MCP 服务：支持连接外部工具，但需手动配置。
• 子代理功能：可将任务外包给 Claude Code，无需 API key。
• 自定义命令：不支持，仅提供 6 条默认命令。

3. 日志与会话追踪

• 日志记录：包含 44 种事件类型，其中只有 3 种（用户消息、模型消息、工具结果）为模型可见。
• 日志结构：记录了每一步操作、工具调用、审批状态、沙箱模式等。
• 会话文件路径：~/.dsh/sessions/，压缩格式为 .jsonl.zstd。
• 日志可解压查看：使用 zstd -dc 解压并结合 Python 脚本可读取详细内容。

4. 安全与隐私

• 数据传输：模型会读取用户提供的文件内容，但不会保存。
• 遥测默认关闭：仅在审批时使用。
• 匿名编号：首次认证后生成，用于追踪请求，无法关闭。
• 凭据管理：存储在 ~/.dsh/.credentials.yaml，权限为 0600，仅本人可读。
• 安全限制：模型无法读取凭据文件，即使权限开放。

5. 模式与工具调用

• 工具调用记录：在日志中详细记录了模型调用的工具、参数、结果。
• 工具调用行为：模型在调用工具前会进行推理，但默认不会显示过程。
• 工具清单：模型在运行时会动态生成，包含 25 个工具，如文件读写、命令执行、技能调用等。

6. 其他注意事项

• 文件路径问题：中文路径在 Windows 上可能被截断，需注意。
• 安装包问题：部分依赖未随主程序安装，需单独安装。
• 模式切换顺序：先选工作区，再选模式，否则会被重置为标准模式。
• 日志与模型可见内容：模型只能看到部分日志内容，其余为系统记录。

附录

• 文档更新频繁：接口和配置可能随时变化，需关注官方仓库。
• 实测与文档差异：部分内容需通过实际操作验证，如钩子配置、技能名称等。
• 安装包版本问题：需注意安装命令的版本号，避免安装旧版本。
• 安全性：默认沙箱限制模型行为，防止越界操作。

总结

DeepSeek Harness 是一个功能强大、可配置的编码 agent，适合开发者进行任务自动化。其权限管理、模式选择和日志记录机制提供了较高的安全性和可追溯性。尽管与 Claude Code 存在一定的兼容性限制，但其灵活性和可扩展性使其成为一个值得深入探索的工具。在使用过程中，需注意权限设置、模式切换顺序、路径处理等细节，以确保顺利运行。