> **来源：[研报客](https://pc.yanbaoke.cn)** ```markdown # 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 存在一定的兼容性限制，但其灵活性和可扩展性使其成为一个值得深入探索的工具。在使用过程中，需注意权限设置、模式切换顺序、路径处理等细节，以确保顺利运行。 ```