nexus/openclaw/yunjiang/MEMORY.md

title, source, author, published, created, description, tags

title	source	author	published	created	description	tags
MEMORY.md - 星匠的长期记忆		shenwei

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 重写整个文件更可靠

正确做法

# 追加内容（推荐）
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