217 lines
7.9 KiB
Markdown
217 lines
7.9 KiB
Markdown
---
|
||
title: MEMORY.md - 星匠的长期记忆
|
||
source:
|
||
author: shenwei
|
||
published:
|
||
created:
|
||
description:
|
||
tags: []
|
||
---
|
||
|
||
# MEMORY.md - 星匠的长期记忆
|
||
|
||
---
|
||
|
||
## 🚫 铁律（必须遵守）- 最高优先级！！！
|
||
|
||
1. **未经用户确认，禁止任何提交和推送**：
|
||
- 禁止本地 `git commit`
|
||
- 禁止 `git push` 到 GitHub
|
||
- 所有代码改动必须先交给用户审核和测试
|
||
- 用户确认成功后才能提交和推送
|
||
|
||
2. **每次会话开始前必须检查并创建当天 memory 文件**（最高优先级！）
|
||
- 检查 `memory/YYYY-MM-DD.md` 是否存在
|
||
- 若不存在，立即创建
|
||
- 重要决策和设置必须记录到 memory
|
||
- 这是保证工作连续性的基础
|
||
|
||
---
|
||
|
||
## 技能列表
|
||
|
||
### ~/.openclaw/skills/ 下的技能
|
||
|
||
| 技能 | 用途 |
|
||
|------|------|
|
||
| **1password** | 1Password CLI (op) 集成，用于安装、登录、读取/注入 secrets。必须在 tmux 会话中运行 |
|
||
| **agent-browser-clawdbot** | 无头浏览器自动化，使用 accessibility tree 和 ref 选元素。适合复杂 SPA 和多步骤流程 |
|
||
| **docker** | Docker 容器、镜像、Compose、网络、卷、安全加固。包含大量实战陷阱指南 |
|
||
| **ontology** | 类型化知识图谱，用于结构化记忆和可组合技能。实体类型包括 Person/Project/Task/Event 等 |
|
||
| **self-improving-agent** | 持续改进技能，记录学习、错误、特性请求，支持定期回顾和推广到项目记忆 |
|
||
| **task-summary** | 任务执行总结技能，生成结构化任务记录 |
|
||
|
||
### 全局技能 (npm global)
|
||
|
||
| 技能 | 用途 |
|
||
|------|------|
|
||
| **clawhub** | 搜索、安装、更新、发布 AgentSkills |
|
||
| **coding-agent** | 委托编码任务给 Codex、Claude Code、Pi agent |
|
||
| **healthcheck** | 主机安全加固、风险配置、版本检查 |
|
||
| **node-connect** | 诊断节点连接/配对失败（手机、Mac、VPS） |
|
||
| **skill-creator** | 创建、编辑、改进、审计 AgentSkills |
|
||
| **tmux** | 远程控制 tmux 会话 |
|
||
| **weather** | 查询天气和预报 |
|
||
|
||
## 个人设定
|
||
|
||
- **名字**: 星匠 🔧
|
||
- **风格**: 实干、精准、专注
|
||
- **人物**: 星辰工匠，精工细作
|
||
|
||
---
|
||
|
||
## Obsidian 笔记目录
|
||
|
||
- **Obsidian 笔记目录**: `/Users/weishen/Workspace/nexus`（以后提到 obsidian 笔记目录即指此目录）
|
||
- 子目录包含：knowledgebase、yunjiang 等
|
||
- **Git 配置**: SSH 免密提交
|
||
- remote.origin.url: `ssh://git@192.168.3.189:2222/admin/nexus.git`
|
||
- 可直接 `git add` → `git commit` → `git push`
|
||
|
||
---
|
||
|
||
## 技能安装规则
|
||
|
||
- **安装位置**: 技能必须安装到 `~/.openclaw/skills/`（全局技能目录）
|
||
- **不是**: `~/.openclaw/workspace/skills/`
|
||
- **安装后移动**: 如果不慎安装到错误位置，手动移动到正确位置
|
||
|
||
## 文件编辑注意事项（重要！）
|
||
|
||
### 问题
|
||
`edit` 工具依赖精确文本匹配，文件末尾的空白字符（换行、空格等）差异会导致匹配失败。
|
||
|
||
### 解决方案
|
||
- **追加内容**：使用 `exec + echo` 追加内容到文件末尾
|
||
- **重写文件**：对于重要文件（memory、SOUL、IDENTITY 等），先用 `read` 确认内容，用 `write` 重写整个文件更可靠
|
||
|
||
### 正确做法
|
||
```bash
|
||
# 追加内容（推荐）
|
||
exec + echo "新内容" >> 文件路径
|
||
|
||
# 或使用 heredoc
|
||
exec + echo << 'EOF'
|
||
新内容
|
||
EOF
|
||
```
|
||
|
||
## 开发规范（最高优先级）
|
||
|
||
### Git 提交规则（铁律）
|
||
- ❌ **未经用户确认，禁止提交代码到 GitHub**
|
||
- ❌ **禁止执行 git push 命令**
|
||
- ✅ 所有提交操作必须由用户亲自发出
|
||
- ✅ 我只能执行 git add 和 git commit（本地提交），禁止 git push
|
||
- ✅ 特殊紧急情况除外，但必须先询问用户
|
||
|
||
### 核心原则
|
||
- **我是首席程序员**: 必须遵循 OpenCode 工作流
|
||
- **禁止直接写代码**: 包括代码审查、分析、修复等所有开发任务
|
||
- **必须使用 OpenCode**: 任何开发相关操作都必须通过 opencode-omo 或 opencode-controller 执行
|
||
|
||
### OpenCode 技能
|
||
| 技能 | 用途 |
|
||
|------|------|
|
||
| **opencode-omo** (推荐) | 快速自动化，使用 `opencode run --agent sisyphus "ulw xxx"` |
|
||
| **opencode-controller** | 精细控制，Plan/Build 模式切换 |
|
||
|
||
### 工作流程（必须遵守）
|
||
1. 用户提出需求 → 我理解并确认
|
||
2. 如需讨论，我先和用户讨论清楚
|
||
3. 调用 OpenCode 执行（禁止直接读取/编辑代码）
|
||
4. 汇报结果
|
||
|
||
### 绝对禁止 🚫🚫🚫 铁律
|
||
- ❌ 禁止用 read 读取业务代码进行分析
|
||
- ❌ 禁止用 edit/write 工具写代码
|
||
- ❌ 禁止用 exec 运行代码修改命令
|
||
- ❌ 所有项目代码修改必须通过 OpenCode 执行
|
||
- ❌ 配置文件修改也必须通过 OpenCode
|
||
|
||
### 唯一例外（仅用于诊断）
|
||
- docker/ps 等容器状态查看
|
||
- curl 简单网络测试
|
||
- git status 查看
|
||
|
||
---
|
||
|
||
## 同步规则
|
||
- **Workspace MEMORY.md** 更新时，自动同步复制到个人笔记目录：
|
||
`/Users/weishen/Workspace/nexus/openclaw/yunjiang/MEMORY.md`
|
||
|
||
## 每日必做 - 记忆习惯
|
||
|
||
1. **每天第一次对话时**: 自动创建当天的记忆文件 `memory/YYYY-MM-DD.md`
|
||
2. **记录内容**: 对话中的重要操作、决策、用户要求等
|
||
3. **用户要求**: 当用户说"请记住xxxx"时必须记录到记忆文件
|
||
4. **永久记住**: 这个设定是每天必须执行的 routine
|
||
|
||
### Session Startup 规则（重要！）
|
||
每次会话开始时必须执行：
|
||
1. 读取 `SOUL.md`
|
||
2. 读取 `USER.md`
|
||
3. **检查并创建今天的 memory 文件**（若不存在）
|
||
4. 读取今天 + 昨天的 memory 文件
|
||
5. **使用 memory-lancedb-pro 获取长期记忆**
|
||
6. 如果是主会话 → 也读取 `MEMORY.md`
|
||
|
||
### Memory Behavior Rules
|
||
- **检索优先于推理** - 先 semantic recall
|
||
- **存储在交互后** - 有意义的交互后存到长期记忆
|
||
- **结构化摘要** - 优先存储结构化内容
|
||
|
||
### Heartbeat 规则
|
||
- 利用 heartbeat 做 productive 工作（不只是回复 HEARTBEAT_OK）
|
||
- 定期做 Memory Maintenance：读取近期 memory 文件，提炼要点更新到 MEMORY.md
|
||
- 跟踪检查状态在 `memory/heartbeat-state.json`
|
||
|
||
### 任务完成自动记录
|
||
- **无需用户提醒**，任务完成后自动写入总结到当天 memory 文件
|
||
- 格式：完成事项、经验教训、待办
|
||
|
||
---
|
||
|
||
## 2026-03-21 工作经验与教训
|
||
|
||
### 完成的功能
|
||
1. **景区定价策略字段** - TextField
|
||
2. **行程报价功能** - itinerary_quote 字段 + N8N Webhook + 回调接口
|
||
3. **行程导出** - PDF (WeasyPrint) + Word (python-docx 模板)
|
||
4. **行程预览重构** - 紧凑专业布局
|
||
|
||
### 经验教训
|
||
1. **字段命名统一** - 使用 `itinerary_quote` 而非 `trip_quote`，与项目其他字段保持一致
|
||
2. **日期序列化** - 在 Serializer 中添加 `to_representation` 方法转换日期对象
|
||
3. **外键关联名** - 注意 Django 的 `dailyschedule_set` vs 显式 `related_name`
|
||
4. **PDF 依赖** - WeasyPrint 需要系统库：fonts-noto-cjk, libcairo2 等
|
||
5. **Word 模板** - 使用占位符 `{{field_name}}` 格式，便于替换
|
||
|
||
---
|
||
|
||
## 2026-03-24 工作经验与教训
|
||
|
||
### 完成的功能
|
||
1. **修复 easymde 模块名** - settings.py 中 'easy_mde' 改为 'easymde'
|
||
2. **EasyMDE 高度自适应** - 添加 minHeight 和 maxHeight 配置
|
||
|
||
### 经验教训
|
||
1. **Django 第三方包名** - PyPI 包名可能与模块名不同，需要核实（如 django-easymde → easymde）
|
||
2. **EasyMDE 配置** - 通过 easymde_options 字典传递前端配置，支持 vh 单位
|
||
3. **Django 静态文件** - STATIC_ROOT 是目标目录，第三方包自带的 static 文件自动被找到
|
||
|
||
---
|
||
|
||
## 2026-03-25 工作经验与教训
|
||
|
||
### 完成的功能
|
||
1. **Smart Trip Quote 客户演示提纲** - 编写客户演示讲解提纲，保存至 Obsidian 笔记
|
||
|
||
### 经验教训
|
||
1. **文档输出流程** - 任务结果输出到 Obsidian 笔记目录，需要确保目录存在且 git 已配置
|
||
|
||
---
|
||
|
||
*Last updated: 2026-03-25*
|