# MEMORY.md - 全局记忆

本文件存储长期持久的重要信息，供所有会话继承和使用。

---

## 👤 用户信息

- **姓名**：Jerry Yan
- **ID**：5155645359
- **时区**：东八区（北京时间，UTC+8）
- **主要平台**：Telegram
  - 私聊：Telegram Bot (OpenClaw)
  - 群组：
    - **DataMate-Claw Coding 群** (`-1003879848304`)：DataMate 项目开发
    - **其他工作群** (`-5104596651`)：其他工作

---

## 💻 系统配置

### OpenClaw
- **版本**：2026.2.1
- **运行环境**：Local
- **工作目录**：`/root/.openclaw/workspace`
- **Gateway 端口**：18789

### 模型配置
- **主模型**：`zhipu/glm-4.7`
- **可用模型**：
  - `zhipu/glm-4.7` (智谱 GLM 4.7) - 主要模型，200K 上下文
  - `packy/claude-sonnet-4-5-20250929` (Claude Sonnet 4.5) - 推理模型，204K 上下文

### Memory（记忆系统）
- **Provider**：Local（本地 embeddings）
- **模型**：`hf:ggml-org/embeddinggemma-300M-GGUF/embeddinggemma-300M-Q8_0.gguf`
- **配置**：
  - Memory 搜索：已启用
  - 向量存储：已启用
  - 缓存：已启用
  - 会话记忆：已启用（实验性）
  - 同步：会话开始时、搜索时
- **文件结构**：
  - `MEMORY.md` - 全局长期记忆（本文件）
  - `memory/YYYY-MM-DD.md` - 每日记忆文件

### Git
- **版本**：2.43.0
- **状态**：已安装

### 其他工具
- **pipx**：已安装（用于管理 CLI 工具）
- **Codex CLI**：Codex Code CLI（代码分析和审核工具）
  - 文档：https://docs.codex.ai
  - Review 模式（代码审核）：
    - 基本用法：`codex review [PROMPT]`
    - 常用参数：
      - `--uncommitted`：审核未提交的更改（staged、unstaged、untracked）
      - `--title <TITLE>`：设置审核标题
      - `--commit <SHA>`：审核指定提交的更改
      - `--base <BRANCH>`：与指定基础分支对比
    - 使用场景：代码审核、问题发现、代码质量检查
    - 重要：`--uncommitted` 参数不能与 PROMPT 参数同时使用
    - 注意事项：不支持 `--skip-git-repo-check` 和 `--json` 选项（review 模式）
  - Exec 模式（非交互执行）：
    - 基本用法：`codex exec "指令"`
    - 使用场景：代码生成、文件编辑、自动化任务
  - 帮助命令：`codex help [COMMAND]`（如 `codex help review`）
- **kimi-cli**：Kimi Code CLI（代码分析和编辑工具）
  - 文档：https://www.kimi-cli.com/zh/
  - Print 模式（非交互运行）：
    - 基本用法：`kimi --print -p "指令"` 或 `echo "指令" | kimi --print`
    - 特点：非交互、自动审批（隐式启用 --yolo）、文本输出
    - 仅输出最终消息：`kimi --print -p "指令" --final-message-only` 或 `kimi --quiet -p "指令"`
    - JSON 格式：`kimi --print -p "指令" --output-format=stream-json`
    - 使用场景：CI/CD 集成、批量处理、工具集成
- **gemini-cli**：Gemini CLI（Google Gemini AI 命令行工具）
  - 文档：https://geminicli.com/docs/cli/headless/
  - Headless 模式（非交互运行）：
    - 基本用法：`gemini --prompt "query"` 或 `echo "query" | gemini`
    - 输出格式：`--output-format json`（JSON）或 `--output-format stream-json`（流式 JSONL）
    - 流式事件：init, message, tool_use, tool_result, error, result
    - 配置选项：`--model/-m`, `--debug/-d`, `--yolo/-y`, `--approval-mode`
    - 使用场景：代码审查、生成 commit 消息、API 文档、批量代码分析、日志分析、生成 release notes

---

## 🛠️ 可用工具列表

### 文件操作
- ✅ `read` - 读取文件内容
- ✅ `write` - 创建/覆盖文件（自动创建目录）
- ✅ `edit` - 精确编辑文件内容
- ❌ 删除文件 - 使用 `write` 清空或通过 exec 的 `rm`

### 系统命令
- ✅ `exec` - 执行 shell 命令（已配置 node host）
- ✅ `process` - 管理后台进程

### 网络
- ✅ `web_search` - 网页搜索（Brave API）
- ✅ `web_fetch` - 获取网页内容
- ✅ `browser` - 控制浏览器

### 消息与通信
- ✅ `message` - 发送消息（Telegram）
- ✅ `sessions_*` - 创建/管理子会话、跨会话通信
- ✅ `cron` - 定时任务和提醒

### 记忆
- ✅ `memory_search` - 语义搜索记忆内容
- ✅ `memory_get` - 读取记忆文件

### 设备控制
- ⚠️ `nodes` - 需要 paired nodes（当前无）
- ⚠️ `canvas` - 需要 node 设备
- ⚠️ `camera` - 需要 node 设备

### 其他
- ✅ `tts` - 文本转语音
- ✅ `agents_list` - 列出可用代理
- ✅ `session_status` - 显示会话状态
- ✅ `gateway` - 重启、更新配置

---

## 🎯 技能与能力

### 编程语言
Python, JavaScript, Java, C++, Go, Rust, SQL, TypeScript 等

### Web 开发
HTML/CSS, React, Vue, Node.js, 前端框架

### 数据处理
- 数据分析与可视化
- 算法设计与实现
- 数据库查询与优化

### DevOps
- Docker 容器化
- Git 版本控制
- CI/CD 流程

### 内容创作
- 多语言翻译
- 文章和文案撰写
- 内容总结和改写

### 浏览器控制
- 打开网页并获取内容
- 截图查看页面状态
- 点击、填写表单等交互操作
- 支持两种模式：
  - **chrome**：接管已连接的 Chrome 浏览器
  - **openclaw**：使用独立的隔离浏览器

---

## 📂 项目信息

### DataMate 项目
**状态**：活跃项目，持续优化中
**位置**：`/root/.openclaw/workspace/Code/DataMate/`
**Git 分支**：`lsf`
**技术栈**：Spring Boot + React + FastAPI + MySQL

**工作目录结构**：
```
Code/DataMate/
├── backend/              # Java 后端（Spring Boot + MyBatis-Plus）
├── frontend/             # React + TypeScript 前端
├── runtime/              # Python 运行时（FastAPI + SQLAlchemy）
├── scripts/              # 构建脚本
└── deployment/           # 部署配置
```

> **注意**：详细的工作日志、提交记录、待办事项请查看每日记忆文件（如 `memory/2026-02-03.md`）

---

## 🔧 重要配置与操作

### OpenClaw 配置文件
- **位置**：`/root/.openclaw/openclaw.json`
- **修改方式**：通过 `gateway config.get/set` 或直接编辑

### 工作目录
- **路径**：`/root/.openclaw/workspace`
- **Code 项目**：`Code/DataMate/`
- **Memory 文件**：`memory/` 和 `MEMORY.md`

### Git 仓库
- **当前版本**：2.43.0
- **主要用途**：代码版本控制

---

## 📝 重要决策与偏好

### 包管理最佳实践
- ✅ 使用虚拟环境安装 Python 包（`python3 -m venv`）
- ✅ 使用 pipx 安装 CLI 工具
- ⚠️ 避免使用 `--break-system-packages` 除非必要
- ⚠️ 优先使用 `apt install python3-xxx` 而非 pip

### Memory 配置偏好
- ✅ 使用本地 embeddings 模型（隐私、免费）
- ✅ 已清理 AiHubMix 配置（不再使用）

### 代码工作流
- **角色分工**：
  - ✅ **kimi-cli**：负责代码分析和编辑实现（默认）
  - ✅ **我**：负责最后的代码审核和提交代码
- **工作流程**：
  1. 用户提出需求
  2. kimi-cli 分析代码并实现（使用 `-y` 参数自动确认）
  3. 我审核修改的代码
  4. 我提交代码到 Git 仓库
- **注意事项**：
  - 未特殊提及时，所有编辑代码分析工作让 kimi-cli 做
  - 我只在用户明确要求或 kimi-cli 完成后进行审核和提交