DeepSeek Harness: 初回利用と基本操作

┌──────────────────────────────────────────────────┐
│ [Standard ▼]  [deepseek-chat ▼]  ⚙️  📋  ❓  │
└──────────────────────────────────────────────────┘
    ↑モード選択     ↑モデル選択       ↑設定  ↑ログ ↑ヘルプ

┌─────────────────────────────────────────┐
│ 👤 Alice                                │
│ Help me analyze the project structure   │
│ in the current directory                │
├─────────────────────────────────────────┤
│ 🤖 Agent                                │
│ 🔍 Using tool: search                   │
│   → Searching in /home/alice/project... │
│ ✅ Found 15 files                       │
│                                         │
│ This project is an Express.js app.      │
│ Main structure:                         │
│ - src/routes/ — Route definitions       │
│ - src/models/ — Data models             │
│ - src/middleware/ — 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 で：Settings → Workspace → Change

Placeholder for user input

🤖 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                  │
└──────────────────────────────────────┘

// Tool execution pipeline pseudocode
async function executeTool(tool, params) {
  // 1. pre-execute: validation + approval
  await preExecute(tool, params);
  
  // 2. execute: actual execution
  const result = await tool.execute(params);
  
  // 3. post-execute: log recording
  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                    │
└──────────────────────────────────────┘

左のセッション一覧 → + ボタンをクリック → 新しいセッション

セッションは自動的に名前が付けられ（最初の会話内容に基づく）、手動で名前の変更も可能です。

// Each SessionEvent is automatically persisted
interface SessionEvent {
  type: 'user_message' | 'agent_message' | 'tool_call' | 'tool_result' | 'approval';
  timestamp: number;
  data: Record<string, unknown>;
}