You've already forked DataMate
添加 Codex Code CLI 的使用说明,包括: - Review 模式(代码审核) - Exec 模式(非交互执行) - 常用参数和注意事项 - 使用场景说明 记录位置:MEMORY.md > 其他工具
225 lines
7.2 KiB
Markdown
225 lines
7.2 KiB
Markdown
# 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 完成后进行审核和提交
|
|
|
|
|