npm install

# 启动服务
./scripts/server.sh start

# 查看状态
./scripts/server.sh status

# 查看日志
./scripts/server.sh logs

# 停止服务
./scripts/server.sh stop

# 重启服务
./scripts/server.sh restart

node src/servers/index.js

{
  "mcpServers": {
    "trae-memory": {
      "command": "node",
      "args": [
        "/path/to/trae-memory/src/servers/index.js"
      ],
      "cwd": "/path/to/trae-memory",
      "env": {
        "NODE_ENV": "production",
        "AUTO_RECORD": "true",
        "CONTEXT_THRESHOLD": "0.8",
        "TOKEN_ESTIMATION": "true"
      }
    }
  }
}

// 自动调用
log_input({
  input: "你的输入内容",
  source: "builder", // 或 "chat", "terminal"
  project: "项目名称",
  files: ["相关文件路径"],
  estimatedTokens: 100
})

// 记录完整对话
log_chat({
  user_input: "用户问题",
  assistant_response: "助手回复",
  conversation_id: "会话ID",
  metadata: {
    source: "chat",
    project: "项目名称",
    files: ["file1.js", "file2.js"],
    tokens: 150
  }
})

// 获取最近5条记录
get_history({ limit: 5 })

// 获取最近10条记录
get_history({ limit: 10 })

// 根据当前上下文恢复相关记忆
recall({
  query: "React组件优化",
  project: "my-react-app",
  includeCompleted: false,
  limit: 10
})

// 检查Context状态
context({ action: "check" })

// 重置Context
context({ action: "reset" })

// 优化Context
context({ 
  action: "optimize",
  tokenCount: 50000,
  maxTokens: 128000
})

// 创建任务
tasks({
  action: "create",
  taskData: {
    title: "实现用户登录功能",
    description: "添加JWT认证和用户验证",
    status: "pending",
    priority: "high",
    project: "web-app",
    tags: ["authentication", "security"]
  }
})

// 更新任务
tasks({
  action: "update",
  taskId: "task_id_here",
  taskData: {
    status: "completed"
  }
})

// 查看任务列表
tasks({
  action: "list",
  filters: {
    status: "pending",
    priority: "high"
  }
})

// 获取任务统计
tasks({ action: "stats" })

// 查看文件状态
files({ action: "status" })

// 清理旧文件（30天前的文件）
files({ 
  action: "clean",
  days: 30
})

// 归档所有数据
files({ action: "archive" })

// 优化文件（只保留最近100条记录）
files({ 
  action: "optimize",
  maxFiles: 100
})

// 保存设置
save_setting({
  key: "theme",
  value: "dark"
})

// 读取设置
get_setting({ key: "theme" })

# 查看帮助
./scripts/server.sh

# 启动服务（后台运行）
./scripts/server.sh start

# 查看详细状态
./scripts/server.sh status

# 实时监控日志
./scripts/server.sh monitor

# 查看最近日志
./scripts/server.sh logs

# 重启服务
./scripts/server.sh restart

# 停止服务
./scripts/server.sh stop

data/
├── history.json      # 对话历史记录
├── settings.json     # 用户设置
├── context.json      # Context状态
├── tasks.json        # 任务列表
├── session.json      # 会话信息
└── archive/          # 归档文件夹
    ├── backup_2024-10-31.json
    └── history_archive_*.json

# 手动备份
cp -r data/ backup_$(date +%Y%m%d)/

# 使用内置归档功能
# 通过 manage_files({ action: "archive" }) 调用

# 启动时显示详细日志
DEBUG=* node src/servers/index.js

# 或使用脚本监控
./scripts/server.sh monitor

trae-memory/
├── src/
│   ├── servers/
│   │   └── index.js          # 主服务器文件
│   ├── config/
│   │   └── timezone.js       # 时区配置
│   └── utils/                # 工具函数
├── data/                     # 数据存储目录
│   ├── history.json         # 对话历史
│   ├── session.json         # 会话信息
│   ├── context.json         # 上下文数据
│   ├── settings.json        # 用户设置
│   └── tasks.json           # 任务列表
├── config/                   # 配置示例
├── scripts/                  # 工具脚本
└── package.json

[
  {
    "timestamp": "2024-01-01T12:00:00.000Z",
    "user": "用户输入内容",
    "assistant": "助手回复内容"
  }
]

{
  "language": "zh-CN",
  "theme": "dark",
  "auto_save": true
}

npm test

npm run diagnose

npm run verify

chmod 755 data/
chmod 644 data/*.json