DeepSeek Harness: 第一次使用

┌──────────────────────────────────────────────────┐
│ [标准 ▼]  [deepseek-chat ▼]  ⚙️  📋  ❓  │
└──────────────────────────────────────────────────┘
  ↑模式选择   ↑模型选择   ↑设置 ↑日志 ↑帮助

┌─────────────────────────────────────────┐
│ 👤 Alice                                │
│ 帮我分析当前目录下的项目结构             │
├─────────────────────────────────────────┤
│ 🤖 Agent                                │
│ 🔍 Using tool: search                   │
│   → Searching in /home/alice/project... │
│ ✅ Found 15 files                       │
│                                         │
│ 这个项目是一个 Express.js 应用，         │
│ 主要结构如下：                           │
│ - src/routes/ — 路由定义                 │
│ - src/models/ — 数据模型                 │
│ - src/middleware/ — 中间件               │
└─────────────────────────────────────────┘

# 工作区决定了 Agent 的"视野"
/home/alice/project     ← Agent 只能看到这个目录下的文件
├── src/
├── package.json
└── README.md

📂 Select Workspace
┌──────────────────────────────────────┐
│ ○ /home/alice/project               │
│ ○ /home/alice/another-repo          │
│ ● Enter custom path...              │
└──────────────────────────────────────┘

# 通过环境变量预设工作区
export DSH_WORKSPACE="/home/alice/my-project"

# 或在 Web UI 中点击设置 → Workspace → Change

你好，请帮我分析这个项目的代码质量

🤖 Agent: 我来帮你分析这个项目。

🔍 Using tool: search
  → Pattern: *
  → Path: /home/alice/project
  → Max depth: 3

🔍 Using tool: file_edit (read)
  → File: package.json
  → Action: read

📊 分析结果：

1. 技术栈：
   - 运行时：Node.js 20.x
   - 框架：Express 4.18
   - 数据库：PostgreSQL (pg 8.12)
   - 测试：Jest 29.x

2. 目录结构：
   src/
   ├── routes/    — 8 个路由文件
   ├── models/    — 5 个数据模型
   ├── middleware/ — 3 个中间件
   └── utils/     — 工具函数

3. 建议：
   - 缺少 TypeScript 类型定义
   - 建议添加 src/services/ 层分离业务逻辑

│                                      │
│ 🔍 search                            │
│ ├─ Status: ✅ Complete               │
│ ├─ Duration: 0.3s                    │
│ └─ Files found: 23                   │
│                                      │
│ 📄 file_edit (read)                  │
│ ├─ Status: ✅ Complete               │
│ ├─ Duration: 0.1s                    │
│ └─ File: package.json (1.2KB)        │
│                                      │
│ 📊 Total tools: 2                    │
│ 📊 Total time: 0.4s                  │
└──────────────────────────────────────┘

// 工具执行流水线伪代码
async function executeTool(tool, params) {
  // 1. pre-execute：校验 + 审批
  await preExecute(tool, params);
  
  // 2. execute：实际执行
  const result = await tool.execute(params);
  
  // 3. post-execute：记录日志
  await postExecute(tool, params, result);
  
  return result;
}

┌─ ⚠️ Approval Required ───────────────────┐
│                                            │
│ Agent wants to:                            │
│ 📝 Edit file: src/index.ts                 │
│                                            │
│ Changes:                                   │
│ - Line 12: Add import statement            │
│ - Line 45: Modify error handler            │
│                                            │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐    │
│ │  ✅ Allow │ │ 🔁 Always│ │  ❌ Deny │    │
│ └──────────┘ └──────────┘ └──────────┘    │
└────────────────────────────────────────────┘

# dsh.config.yaml
approval:
  # 文件读取：始终允许
  file_read: always
  
  # 文件编辑：需要审批
  file_edit: ask
  
  # Shell 命令：根据危险等级
  shell:
    safe_commands: always     # ls, cat, grep 等
    unsafe_commands: ask      # rm, chmod, sudo 等
    dangerous_commands: deny  # rm -rf /, dd 等
  
  # 搜索操作：始终允许
  search: always

# 设置沙箱模式
export DSH_SANDBOX=strict    # 最安全
export DSH_SANDBOX=permissive # 默认
export DSH_SANDBOX=off        # 不推荐

👤 Alice: 在 src/routes/ 下新建 health.ts，添加一个 /health GET 接口，
        返回 { status: "ok", timestamp: Date.now() }

🤖 Agent: 我来帮你创建健康检查接口。

📝 Using tool: file_edit
  → Action: create
  → Path: src/routes/health.ts
  → Content: 
    import { Router } from 'express';
    const router = Router();
    router.get('/health', (_req, res) => {
      res.json({ status: 'ok', timestamp: Date.now() });
    });
    export default router;

⚠️ Approval Required: Create file src/routes/health.ts
  → [Alice 点击 Allow]

✅ File created: src/routes/health.ts

接下来需要将这个路由注册到 app.ts 中：

📝 Using tool: file_edit
  → Action: edit
  → Path: src/app.ts
  → Changes: 
    + import healthRouter from './routes/health';
    + app.use('/health', healthRouter);

⚠️ Approval Required: Edit file src/app.ts
  → [Alice 点击 Allow]

✅ File edited: src/app.ts

完成！健康检查接口已添加。访问 GET /health 即可测试。

┌─ Tool Panel ────────────────────────┐
│ 📝 file_edit (create)                │
│ ├─ Path: src/routes/health.ts        │
│ ├─ Status: ✅ Approved & Complete    │
│ └─ Duration: 0.2s                    │
│                                      │
│ 📝 file_edit (edit)                  │
│ ├─ Path: src/app.ts                  │
│ ├─ Changes: +2 lines                 │
│ ├─ Status: ✅ Approved & Complete    │
│ └─ Duration: 0.1s                    │
└──────────────────────────────────────┘

左侧会话列表 → 点击 + 按钮 → 新建会话

![会话管理](images/zh/dsh-9.webp)

会话自动命名（基于首次对话内容），也可手动重命名。

// 每个 SessionEvent 自动持久化
interface SessionEvent {
  type: 'user_message' | 'agent_message' | 'tool_call' | 'tool_result' | 'approval';
  timestamp: number;
  data: Record<string, unknown>;
}