别再当代码打字员！玩转字节 Trae AI 编程超神指南：从‘无脑生成’到‘总包监理’，四大实战暗坑、MCP/Rules 终极调优与零依赖三端自愈沙箱

# 人工交互执行
.\trae_workspace_toolkit_windows11.ps1

# Agent 无人值守自动化执行
.\trae_workspace_toolkit_windows11.ps1 -AgentMode -TargetDir .

# ==============================================================================
# Trae AI Workspace & MCP Diagnostic Toolkit (Windows 11 / PowerShell 7+)
# Mode 1: Interactive Manual Inspection & Self-Healing
# Mode 2: Unattended Agent Automation (-AgentMode)
# Zero external dependencies (Uses native PowerShell & standard Python3)
# ==============================================================================
param(
    [switch]$AgentMode,
    [string]$TargetDir = "."
)

Set-StrictMode -Version Latest
$ErrorActionPreference = "Stop"

$ResolvedTarget = (Resolve-Path $TargetDir).Path
if (-not $AgentMode) {
    Write-Host "[TRAE-TOOLKIT] Initializing workspace scan in: $ResolvedTarget" -ForegroundColor Cyan
}

$Results = [ordered]@{
    TargetDir = $ResolvedTarget
    TraeIgnoreCreated = $false
    RulesConfigured = @()
    McpConfigured = $false
    Status = "OK"
}

function Invoke-EnsureTraeIgnore {
    param([string]$Dir)
    $IgnorePath = Join-Path $Dir ".traeignore"
    $IgnoreTemplate = @"
# Trae Context Ignore File - Enforce Clean Token Budget
.git/
.svn/
node_modules/
venv/
.venv/
env/
dist/
build/
out/
target/
*.pyc
__pycache__/
*.log
*.tmp
.DS_Store
Thumbs.db
.env
.env.*
*.key
*.pem
*.cert
*.lock
"@
    if (-not (Test-Path $IgnorePath)) {
        Set-Content -Path $IgnorePath -Value $IgnoreTemplate -Encoding utf8
        if (-not $AgentMode) {
            Write-Host "[+] Generated standard .traeignore for token security." -ForegroundColor Green
        }
        $Results.TraeIgnoreCreated = $true
    }
}

function Invoke-EnsureTraeRules {
    param([string]$Dir)
    $RulesDir = Join-Path $Dir ".trae\rules"
    if (-not (Test-Path $RulesDir)) {
        New-Item -ItemType Directory -Path $RulesDir -Force | Out-Null
    }

    $Rule1 = Join-Path $RulesDir "01-architecture-invariants.md"
    $Rule1Content = @"
---
alwaysApply: true
description: "Enforce architectural invariants, strict types, and non-destructive modifications"
---
# Architecture & Safety Invariants

1. Do NOT delete or comment out existing production business logic without explicit user instruction.
2. Maintain strict typing (e.g. TypeScript interfaces, Python type annotations). Avoid 'any' types.
3. Modular Boundary: Keep business controllers thin; isolate domain logic in services.
4. Always verify file paths and directory existence before creating new files.
"@
    if (-not (Test-Path $Rule1)) {
        Set-Content -Path $Rule1 -Value $Rule1Content -Encoding utf8
        $Results.RulesConfigured += "01-architecture-invariants.md"
    }

    $Rule2 = Join-Path $RulesDir "02-testing-guardrails.md"
    $Rule2Content = @"
---
applyTo: "*.{ts,tsx,js,jsx,py,go,rs}"
description: "Require automated test execution and regression assertions before marking tasks complete"
---
# Testing & Verification Guardrails

1. Every newly introduced feature or critical bug fix must have a corresponding automated test.
2. Before finishing a Builder/SOLO task, run project test suite via terminal.
3. If tests fail, analyze error logs systematically rather than blind guess patching.
"@
    if (-not (Test-Path $Rule2)) {
        Set-Content -Path $Rule2 -Value $Rule2Content -Encoding utf8
        $Results.RulesConfigured += "02-testing-guardrails.md"
    }

    $Rule3 = Join-Path $RulesDir "03-git-safety.md"
    $Rule3Content = @"
---
applyTo: "*"
description: "Prevent secret leaks and ensure atomic conventional commits"
---
# Git & Secret Safety Guidelines

1. Never commit API keys, private tokens, passwords, or internal network endpoints.
2. Stage only intentional diffs; do not run 'git add .' indiscriminately.
3. Adhere to Conventional Commits: feat(...), fix(...), refactor(...), chore(...).
"@
    if (-not (Test-Path $Rule3)) {
        Set-Content -Path $Rule3 -Value $Rule3Content -Encoding utf8
        $Results.RulesConfigured += "03-git-safety.md"
    }

    if (-not $AgentMode) {
        Write-Host "[+] Verified .trae/rules directory with standard guardrails." -ForegroundColor Green
    }
}

function Invoke-EnsureLocalMcp {
    param([string]$Dir)
    $McpDir = Join-Path $Dir ".trae\mcp"
    if (-not (Test-Path $McpDir)) {
        New-Item -ItemType Directory -Path $McpDir -Force | Out-Null
    }

    $McpServerScript = Join-Path $McpDir "local_audit_mcp.py"
    $ServerCode = @'
import sys, json

def send_response(res):
    payload = json.dumps(res, ensure_ascii=False)
    sys.stdout.write(f"Content-Length: {len(payload.encode('utf-8'))}\r\n\r\n{payload}")
    sys.stdout.flush()

def main():
    while True:
        header = sys.stdin.readline()
        if not header:
            break
        if header.lower().startswith("content-length:"):
            length = int(header.split(":")[1].strip())
            sys.stdin.readline()
            body = sys.stdin.read(length)
            req = json.loads(body)
            req_id = req.get("id")
            method = req.get("method")
            if method == "initialize":
                send_response({"jsonrpc": "2.0", "id": req_id, "result": {"protocolVersion": "2024-11-05", "capabilities": {"tools": {}}, "serverInfo": {"name": "local-trae-audit", "version": "1.0.0"}}})
            elif method == "tools/list":
                send_response({"jsonrpc": "2.0", "id": req_id, "result": {"tools": [{"name": "audit_workspace", "description": "Audit local workspace health", "inputSchema": {"type": "object", "properties": {}}}]}})
            elif method == "tools/call":
                send_response({"jsonrpc": "2.0", "id": req_id, "result": {"content": [{"type": "text", "text": "Trae local workspace audit: PASSED. Zero stdio contamination."}]}})
            else:
                send_response({"jsonrpc": "2.0", "id": req_id, "result": {}})

if __name__ == "__main__":
    main()
'@
    Set-Content -Path $McpServerScript -Value $ServerCode -Encoding utf8
    $Results.McpConfigured = $true
    if (-not $AgentMode) {
        Write-Host "[+] Generated zero-dependency local stdio MCP server template." -ForegroundColor Green
    }
}

Invoke-EnsureTraeIgnore -Dir $ResolvedTarget
Invoke-EnsureTraeRules -Dir $ResolvedTarget
Invoke-EnsureLocalMcp -Dir $ResolvedTarget

if ($AgentMode) {
    Write-Host (ConvertTo-Json $Results -Compress)
} else {
    Write-Host "`n======================================================" -ForegroundColor Green
    Write-Host "  TRAE WORKSPACE HARDENING COMPLETED SUCCESSFULLY     " -ForegroundColor Green
    Write-Host "======================================================" -ForegroundColor Green
    Write-Host "- .traeignore: Token pollution prevented."
    Write-Host "- .trae/rules/: 3 production guardrail files active."
    Write-Host "- .trae/mcp/: Zero-dependency stdio server created."
}

# 赋予执行权限
chmod +x trae_workspace_toolkit_ubuntu2604.sh

# 人工交互执行
./trae_workspace_toolkit_ubuntu2604.sh

# Agent 无人值守自动化执行
./trae_workspace_toolkit_ubuntu2604.sh --agent-mode --target-dir .

#!/usr/bin/env bash
# ==============================================================================
# Trae AI Workspace & MCP Diagnostic Toolkit (Ubuntu 26.04 LTS / Bash)
# Mode 1: Interactive Manual Inspection & Self-Healing
# Mode 2: Unattended Agent Automation (--agent-mode)
# Zero external dependencies (Uses native Bash & standard Python3)
# ==============================================================================
set -euo pipefail

AGENT_MODE=0
TARGET_DIR="."

while [[ $# -gt 0 ]]; do
  case "$1" in
    --agent-mode|--headless)
      AGENT_MODE=1
      shift
      ;;
    --target-dir|-t)
      TARGET_DIR="$2"
      shift 2
      ;;
    *)
      TARGET_DIR="$1"
      shift
      ;;
  esac
done

TARGET_DIR="$(cd "$TARGET_DIR" && pwd)"

log_info() {
  if [[ $AGENT_MODE -eq 0 ]]; then
    echo -e "\033[1;36m[TRAE-TOOLKIT]\033[0m $*"
  fi
}

log_success() {
  if [[ $AGENT_MODE -eq 0 ]]; then
    echo -e "\033[1;32m[+]\033[0m $*"
  fi
}

# 1. Ensure .traeignore
TRAE_IGNORE="$TARGET_DIR/.traeignore"
IGNORE_CREATED="false"
if [[ ! -f "$TRAE_IGNORE" ]]; then
  cat << 'EOF' > "$TRAE_IGNORE"
# Trae Context Ignore File - Enforce Clean Token Budget
.git/
.svn/
node_modules/
venv/
.venv/
env/
dist/
build/
out/
target/
*.pyc
__pycache__/
*.log
*.tmp
.DS_Store
Thumbs.db
.env
.env.*
*.key
*.pem
*.cert
*.lock
EOF
  log_success "Generated standard .traeignore for token security."
  IGNORE_CREATED="true"
fi

# 2. Ensure .trae/rules/
RULES_DIR="$TARGET_DIR/.trae/rules"
mkdir -p "$RULES_DIR"

RULE1="$RULES_DIR/01-architecture-invariants.md"
if [[ ! -f "$RULE1" ]]; then
  cat << 'EOF' > "$RULE1"
---
alwaysApply: true
description: "Enforce architectural invariants, strict types, and non-destructive modifications"
---
# Architecture & Safety Invariants

1. Do NOT delete or comment out existing production business logic without explicit user instruction.
2. Maintain strict typing (e.g. TypeScript interfaces, Python type annotations). Avoid 'any' types.
3. Modular Boundary: Keep business controllers thin; isolate domain logic in services.
4. Always verify file paths and directory existence before creating new files.
EOF
fi

RULE2="$RULES_DIR/02-testing-guardrails.md"
if [[ ! -f "$RULE2" ]]; then
  cat << 'EOF' > "$RULE2"
---
applyTo: "*.{ts,tsx,js,jsx,py,go,rs}"
description: "Require automated test execution and regression assertions before marking tasks complete"
---
# Testing & Verification Guardrails

1. Every newly introduced feature or critical bug fix must have a corresponding automated test.
2. Before finishing a Builder/SOLO task, run project test suite via terminal.
3. If tests fail, analyze error logs systematically rather than blind guess patching.
EOF
fi

RULE3="$RULES_DIR/03-git-safety.md"
if [[ ! -f "$RULE3" ]]; then
  cat << 'EOF' > "$RULE3"
---
applyTo: "*"
description: "Prevent secret leaks and ensure atomic conventional commits"
---
# Git & Secret Safety Guidelines

1. Never commit API keys, private tokens, passwords, or internal network endpoints.
2. Stage only intentional diffs; do not run 'git add .' indiscriminately.
3. Adhere to Conventional Commits: feat(...), fix(...), refactor(...), chore(...).
EOF
fi
log_success "Verified .trae/rules directory with standard guardrails."

# 3. Ensure Local Stdio MCP Template
MCP_DIR="$TARGET_DIR/.trae/mcp"
mkdir -p "$MCP_DIR"
MCP_SCRIPT="$MCP_DIR/local_audit_mcp.py"

cat << 'EOF' > "$MCP_SCRIPT"
import sys, json

def send_response(res):
    payload = json.dumps(res, ensure_ascii=False)
    sys.stdout.write(f"Content-Length: {len(payload.encode('utf-8'))}\r\n\r\n{payload}")
    sys.stdout.flush()

def main():
    while True:
        header = sys.stdin.readline()
        if not header:
            break
        if header.lower().startswith("content-length:"):
            length = int(header.split(":")[1].strip())
            sys.stdin.readline()
            body = sys.stdin.read(length)
            req = json.loads(body)
            req_id = req.get("id")
            method = req.get("method")
            if method == "initialize":
                send_response({"jsonrpc": "2.0", "id": req_id, "result": {"protocolVersion": "2024-11-05", "capabilities": {"tools": {}}, "serverInfo": {"name": "local-trae-audit", "version": "1.0.0"}}})
            elif method == "tools/list":
                send_response({"jsonrpc": "2.0", "id": req_id, "result": {"tools": [{"name": "audit_workspace", "description": "Audit local workspace health", "inputSchema": {"type": "object", "properties": {}}}]}})
            elif method == "tools/call":
                send_response({"jsonrpc": "2.0", "id": req_id, "result": {"content": [{"type": "text", "text": "Trae local workspace audit: PASSED. Zero stdio contamination."}]}})
            else:
                send_response({"jsonrpc": "2.0", "id": req_id, "result": {}})

if __name__ == "__main__":
    main()
EOF
chmod +x "$MCP_SCRIPT"
log_success "Generated zero-dependency local stdio MCP server template."

if [[ $AGENT_MODE -eq 1 ]]; then
  python3 -c "import json, sys; print(json.dumps({'status': 'OK', 'target_dir': sys.argv[1], 'traeignore_created': sys.argv[2] == 'true', 'rules_count': 3, 'mcp_configured': True}))" "$TARGET_DIR" "$IGNORE_CREATED"
else
  echo ""
  echo -e "\033[1;32m======================================================\033[0m"
  echo -e "\033[1;32m  TRAE WORKSPACE HARDENING COMPLETED SUCCESSFULLY     \033[0m"
  echo -e "\033[1;32m======================================================\033[0m"
  echo "- .traeignore: Token pollution prevented."
  echo "- .trae/rules/: 3 production guardrail files active."
  echo "- .trae/mcp/: Zero-dependency stdio server created."
fi

# 赋予执行权限
chmod +x trae_workspace_toolkit_macos27.zsh

# 人工交互执行
./trae_workspace_toolkit_macos27.zsh

# Agent 无人值守自动化执行
./trae_workspace_toolkit_macos27.zsh --agent-mode --target-dir .

#!/usr/bin/env zsh
# ==============================================================================
# Trae AI Workspace & MCP Diagnostic Toolkit (macOS 27 Native / Zsh)
# Mode 1: Interactive Manual Inspection & Self-Healing
# Mode 2: Unattended Agent Automation (--agent-mode)
# Zero external dependencies (Uses native Zsh & standard Python3)
# ==============================================================================
set -e

AGENT_MODE=0
TARGET_DIR="."

while [[ $# -gt 0 ]]; do
  case "$1" in
    --agent-mode|--headless)
      AGENT_MODE=1
      shift
      ;;
    --target-dir|-t)
      TARGET_DIR="$2"
      shift 2
      ;;
    *)
      TARGET_DIR="$1"
      shift
      ;;
  esac
done

TARGET_DIR="$(cd "$TARGET_DIR" && pwd)"

log_info() {
  if [[ $AGENT_MODE -eq 0 ]]; then
    print -P "%F{cyan}[TRAE-TOOLKIT]%f $*"
  fi
}

log_success() {
  if [[ $AGENT_MODE -eq 0 ]]; then
    print -P "%F{green}[+]%f $*"
  fi
}

# 1. Ensure .traeignore
TRAE_IGNORE="$TARGET_DIR/.traeignore"
IGNORE_CREATED="false"
if [[ ! -f "$TRAE_IGNORE" ]]; then
  cat << 'EOF' > "$TRAE_IGNORE"
# Trae Context Ignore File - Enforce Clean Token Budget
.git/
.svn/
node_modules/
venv/
.venv/
env/
dist/
build/
out/
target/
*.pyc
__pycache__/
*.log
*.tmp
.DS_Store
Thumbs.db
.env
.env.*
*.key
*.pem
*.cert
*.lock
EOF
  log_success "Generated standard .traeignore for token security."
  IGNORE_CREATED="true"
fi

# 2. Ensure .trae/rules/
RULES_DIR="$TARGET_DIR/.trae/rules"
mkdir -p "$RULES_DIR"

RULE1="$RULES_DIR/01-architecture-invariants.md"
if [[ ! -f "$RULE1" ]]; then
  cat << 'EOF' > "$RULE1"
---
alwaysApply: true
description: "Enforce architectural invariants, strict types, and non-destructive modifications"
---
# Architecture & Safety Invariants

1. Do NOT delete or comment out existing production business logic without explicit user instruction.
2. Maintain strict typing (e.g. TypeScript interfaces, Python type annotations). Avoid 'any' types.
3. Modular Boundary: Keep business controllers thin; isolate domain logic in services.
4. Always verify file paths and directory existence before creating new files.
EOF
fi

RULE2="$RULES_DIR/02-testing-guardrails.md"
if [[ ! -f "$RULE2" ]]; then
  cat << 'EOF' > "$RULE2"
---
applyTo: "*.{ts,tsx,js,jsx,py,go,rs}"
description: "Require automated test execution and regression assertions before marking tasks complete"
---
# Testing & Verification Guardrails

1. Every newly introduced feature or critical bug fix must have a corresponding automated test.
2. Before finishing a Builder/SOLO task, run project test suite via terminal.
3. If tests fail, analyze error logs systematically rather than blind guess patching.
EOF
fi

RULE3="$RULES_DIR/03-git-safety.md"
if [[ ! -f "$RULE3" ]]; then
  cat << 'EOF' > "$RULE3"
---
applyTo: "*"
description: "Prevent secret leaks and ensure atomic conventional commits"
---
# Git & Secret Safety Guidelines

1. Never commit API keys, private tokens, passwords, or internal network endpoints.
2. Stage only intentional diffs; do not run 'git add .' indiscriminately.
3. Adhere to Conventional Commits: feat(...), fix(...), refactor(...), chore(...).
EOF
fi
log_success "Verified .trae/rules directory with standard guardrails."

# 3. Ensure Local Stdio MCP Template
MCP_DIR="$TARGET_DIR/.trae/mcp"
mkdir -p "$MCP_DIR"
MCP_SCRIPT="$MCP_DIR/local_audit_mcp.py"

cat << 'EOF' > "$MCP_SCRIPT"
import sys, json

def send_response(res):
    payload = json.dumps(res, ensure_ascii=False)
    sys.stdout.write(f"Content-Length: {len(payload.encode('utf-8'))}\r\n\r\n{payload}")
    sys.stdout.flush()

def main():
    while True:
        header = sys.stdin.readline()
        if not header:
            break
        if header.lower().startswith("content-length:"):
            length = int(header.split(":")[1].strip())
            sys.stdin.readline()
            body = sys.stdin.read(length)
            req = json.loads(body)
            req_id = req.get("id")
            method = req.get("method")
            if method == "initialize":
                send_response({"jsonrpc": "2.0", "id": req_id, "result": {"protocolVersion": "2024-11-05", "capabilities": {"tools": {}}, "serverInfo": {"name": "local-trae-audit", "version": "1.0.0"}}})
            elif method == "tools/list":
                send_response({"jsonrpc": "2.0", "id": req_id, "result": {"tools": [{"name": "audit_workspace", "description": "Audit local workspace health", "inputSchema": {"type": "object", "properties": {}}}]}})
            elif method == "tools/call":
                send_response({"jsonrpc": "2.0", "id": req_id, "result": {"content": [{"type": "text", "text": "Trae local workspace audit: PASSED. Zero stdio contamination."}]}})
            else:
                send_response({"jsonrpc": "2.0", "id": req_id, "result": {}})

if __name__ == "__main__":
    main()
EOF
chmod +x "$MCP_SCRIPT"
log_success "Generated zero-dependency local stdio MCP server template."

if [[ $AGENT_MODE -eq 1 ]]; then
  python3 -c "import json, sys; print(json.dumps({'status': 'OK', 'target_dir': sys.argv[1], 'traeignore_created': sys.argv[2] == 'true', 'rules_count': 3, 'mcp_configured': True}))" "$TARGET_DIR" "$IGNORE_CREATED"
else
  print ""
  print -P "%F{green}======================================================%f"
  print -P "%F{green}  TRAE WORKSPACE HARDENING COMPLETED SUCCESSFULLY     %f"
  print -P "%F{green}======================================================%f"
  print "- .traeignore: Token pollution prevented."
  print "- .trae/rules/: 3 production guardrail files active."
  print "- .trae/mcp/: Zero-dependency stdio server created."
fi