---

## 🕸️ 知识图谱索引

项目/系统/通道之间的关系图谱 → `memory/graph.json`
- **节点**：项目、系统、通道、基础设施（14个）
- **边**：uses/outputs/connects/feeds/notifies 等关系（18条）
- 新增项目时同步更新 graph.json
- 检索时可用 `memory_relations` 思路：先定位节点 → 沿边找关联

---

## 📌 近期重要更新（滚动7天，每次新增<=5条）

| 日期 | 更新内容 |
|------|----------|
| 06-21 | **装修知识库统一**：所有亭溪苑装修资料统一存入 decoration_project/DEVELOPMENT.md；收录小米全屋智能水电交底+地下室防潮四步法+现浇楼板施工标准 |
| 06-22 | **动速递项目启动+二期**：每月2期政策跟踪，首期素材汇编完成；二期新增8项发现（国务院城市更新十五五、工信部模数共振、浙江省524X、嘉兴Q1 GDP增速7.2%领跑全省） |
| 06-24 | **上海科创政策汇总+明珠计划详解**：整理10条上海创新政策；明珠计划完整申报指南（高峰/领军/菁英/工程师4类，20-700万资助） |
| 06-25 | **模型切换未完成**：主人要求主模型改为 `sensenova/deepseek-v4-flash` + 删除 `openrouter/auto`。session已切换，openclaw.json默认配置写入因工具异常失败，待手动改 |
| 06-28 | **每周记忆巡检**（06-21~06-28）：8条关键记忆，健康评分 8/10；模型配置问题持续第4天；_state清理释放~200KB |
| 07-02 | **5 个 cron job 修复 + 模型治理**：发现 isolated session 在 Mac 上间歇性卡死，所有 cron job 改为 main session + systemEvent 注入后稳定运行；删除了 4 个死模型；创建了 OpenRouter 免费模型自动监测脚本 |
| 07-20 | **灯具下单系统启动**：Phase 1 产品清单提取，从U盘 2018-2026 年销售合同提取产品数据，已出 77 个唯一产品 Excel（`~/Desktop/产品清单_待编码.xlsx`），2019-2022 年待补；项目文件夹 `lamp_ordering_system/` 已建 |

---

## 记忆系统原则(2026-03-19 更新)

### ⚠️ 记忆压缩规则(2026-03-19 新增)
- 删除/压缩记忆前**必须先跑 memory_search**确认内容分布
- 不能用"应该有"代替"确实有"--必须确认副本确实存在才能删
- **唯一存在的内容 = 绝不能删**(今晚BUG清单误删就是这个错误)
- 涉及删除操作时:memory_search → 确认副本存在 → 才动手

### ⚠️ 多层记忆结构(六层)
1. **MEMORY.md**:长期核心记忆(配置、项目索引、关键规则)-- **只记索引,不堆细节**
2. **known_issues.md**:已知问题清单(发现问题直接记这里,不在 MEMORY.md 堆)
3. **memory/YYYY-MM-DD.md**:每日日记(当天发生了什么,细节)
4. **项目文件夹/DEVELOPMENT.md**:每个项目的专属开发记录
5. **self-improving/learning.md**:跨任务可复用的经验教训(提炼层)
6. **self-improving/heartbeat-state.md**:最近一次维护状态

### 收敛规则
- MEMORY.md 只记**索引和配置**,细节分流到对应文档
- 项目开发记录 → 项目文件夹/DEVELOPMENT.md
- 已知问题 → known_issues.md(不堆 MEMORY.md)
- 只对今天排障有用 → 写当天 daily
- 半年后还值得看的结论 → 才写 MEMORY.md

### VPS 操作规则（2026-05-07 新增）
- **所有VPS上的安装、修改、写入操作必须先询问主人，禁止自作主张执行**
- 备份恢复范围：仅恢复 `octo v2`、`sec-pro`、`openclaw.json`，不恢复 `workspace/`

### 新建项目流程
1. 项目文件夹内建 `DEVELOPMENT.md`
2. MEMORY.md「📁 项目索引」表加一行

| 项目 | 开发文件 | 状态 |
|------|---------|------|
| **Capability Evolver** | `./evolver/README.md` | 进行中 |
| **JSEN Plastic B2B网站** | `./jsen_project/README.md` | 进行中 |
| **OctoQuant 量化系统** | `./DEVELOPMENT.md` | 空仓Idle（最后交易2026-03-26，NAV ¥94,251） |
| **Thi-Pro** | `/Volumes/Mac E/thi-pro/DEVELOPMENT.md` | 监控v2+watchdog✅，风控骨架搭建中，规则注册器可扩展设计 |
| **价值捕手** | `~/stock_analyzer/DEVELOPMENT.md` | VPS运行, Yahoo Finance数据源 |
| **stock_analyzer_v2** | `~/stock_analyzer_v2/SPEC.md` | 🆕 刚完成，akshare数据源，Mac/VPS双版本 |
| **TradingAgents-CN** | 端口3000(前端)/8000(后端) | 已配置登录(admin/admin123) |
| **启动页** | `http://localhost:8899/launcher.html` | 聚合4个入口 |
| **VPS 部署项目** | `./vps_project/DEVELOPMENT.md` | 进行中 |
| **动速递（政策跟踪）** | `./policy_report/DEVELOPMENT.md` | 🆕 每月2期，6月22日首期素材汇编完成 |
| **玩客云 OpenWrt** | `memory/2026-06-07.md` | 蓝蓝定制版 2023.11.23 / 1GB RAM / IP:192.168.5.200 / SSH: root+密码Lanlan1 / p910nd打印✅ / OpenClash✅ / Docker空跑 / opkg源挂了 |
| **叠墅装修项目** | `./decoration_project/DEVELOPMENT.md` | 亭溪苑21-1-101下叠装修方案深化中；60万预算完整方案已出（MD+HTML已上传VPS）；**图纸迭代至v6**（v3方向修正→v4手绘布局→v5含尺寸→v6按谢总CAD图纸重画，1F:7952×13417，2F:6745×9854，B1/B2:8904×10814）；在线链接v6：https://share.xpang-ai.com/txy-211101/平面图_21-1-101_v6_xie.html；智能家居方案（Aqara+米家+N100小主机+NAS+监控）；VPS文件统一存 `/share/txy-211101/`；飞牛NAS已装HA 2026.5.3（192.168.5.5:8123） |
| **舅舅离婚诉讼案** | `./legal_cases/舅舅离婚诉讼/DEVELOPMENT.md` | **📌 一审一庭已开（2026-07-20），法官未判；二审准备中**；9 份材料同步 VPS `/share/legal_cases/`；总览页 https://share.xpang-ai.com/legal_cases/index.html (admin/18)；微信入口 https://share.xpang-ai.com/legal_cases/wechat.html；1989 建房审批表已到手（婚前财产铁证）；张木根现年 68 周岁（1957-08-19）；女方7.20表态3点（感情好、分1.75亩、补偿10万）均已被反驳 |
| **Claw Code 学习笔记** | `./research/claw-code-study-20260402.md` | P1 完成, P2 待继续 |
| **cc-haha 研究** | `research/cc-haha-*-v1*.md` | 升级路线图 v1.2 待收敛 |
| **经验教训库** | `./self-improving/learning.md` | 进行中 |
| **灯具采购下单系统** | `lamp_ordering_system/` | 嘉善众齐灯具商行，Phase 1 产品清单提取中（77个产品，2019-2022待补） |
| **模型治理专题** | `./memory/topics/model-governance.md` | 🆕 已建立，含6层排查清单（defaults/agent/session/skill/subagent/provider），删除付费模型后必查 |

---

## 🔑 关键配置

### 飞书
- **main 账号**: appId/cli_xxx, 绑定 main agent
- **stock 账号**: 绑定 stock-agent, allowFrom 包含主人 open_id
- **Wiki Space**: 7605470145867156708, 每日晨报父节点 SIs9w0dFzijGi9kh0SlcOvwFnqb
- ⚠️ 多通道配置时 cron 必须指定 delivery.channel

### 邮箱
| 邮箱 | 用途 |
|------|------|
| xpang-ai@qq.com (授权码: qopitogviwnzbcie) | 小小胖专用,IMAP/SMTP |
| chent90s@163.com | 主人邮箱,接收晨报/周报（**4/17起已暂停邮件发送**） |

### 钉钉
| 姓名 | UserID | 备注 |
|------|--------|------|
| 小涛 | 02552841041220691 | 主人 |
| 小欢 | 2442593606661252 | 老婆 |

> **钉钉连接方式（2026-04-12更新）：** Stream模式（AppKey+Secret）已连接；但npm install被SIGKILL中断，**依赖未装完**，需手动完成：`cd dingtalk-connector && npm install && openclaw gateway restart`后再测。webhook token已废弃。
> 通道名:`dingtalk-connector`(⚠️ 勿用 dingtalk)

### 搜索引擎
1. **Brave Search** - 通用搜索,API Key: BSAsynbe7mv_klmHmjhFcEZu07FsigL
2. **Tavily** - AI优化搜索,保存在 credentials/tavily.env

### 大模型配置
| 平台 | 模型 | 备注 |
|------|------|------|
| **Mac main** | `openai-codex/gpt-5.4` | 2026-04-08 从 MiniMax 切换 |
| **Mac codex** | `openai-codex/gpt-5.3-codex` | 代码任务 fallback |
| **VPS** | `openai-codex/gpt-5.4` | OAuth 已配置(2026-04-25) |
| **VPS fallback** | `minimax/MiniMax-M2.7` → `openrouter/elephant-alpha` → `openrouter/nvidia/nemotron-3-super-120b-a12b:free` | 2026-04-25 更新 |
| **SenseNova** | `sensenova/deepseek-v4-flash` + `sensenova/sensenova-6.7-flash-lite` + `sensenova/sensenova-u1-fast` | 🆕 2026-05-29 接入，全部免费，base: token.sensenova.cn/v1；**imageModel**: `sensenova/sensenova-6.7-flash-lite`（2026-06-20 配置） |

---

## 👤 主人偏好

- **股票提及**:必须同时给代码+全名(如:603501豪威集团)
- **消息风格**:正常不主动发消息,有异常才通知
- **沟通风格**:简洁直接,不啰嗦
- **安全**:涉及外部操作(邮件/社交)必须确认
- **记忆策略**:采用半主动记忆,重复问题/付费权限事故/SOP/长期偏好主动沉淀到专题或索引
- **长期投资偏好**(2026-05-31):重点关注**中兴通讯(000063)**+**豪威集团(603501)**长期持有，同时对存储/半导体蓝筹股感兴趣（待出详细研究报告）
- **case 记录规则**:用户明确说是一个 case,或明确要求后续持续完善/记忆的事项,应单独建立专属 case 文件夹与 `DEVELOPMENT.md`; 外层结构尽量统一规整,内容可按案件/项目类型自适应

---

## ⚠️ 绝对禁止

- ❌ `openclaw gateway install` - 会重置 LaunchAgent plist
- ❌ `openclaw doctor --fix` - 可能重置配置
- ❌ 任何修改飞书配置的操作
- 原因:这些操作会重置密钥配置,导致环境变量丢失

---

## 🔧 运维 SOP

### memory_search 架构(2026-05-29 更新)
**✅ 当前架构**:
- **主引擎**:`provider: "local"` + node-llama-cpp + **embeddinggemma**(Mac本地,完全免费)
  - 模型:`~/.node-llama-cpp/models/hf_ggml-org_embeddinggemma-300m-qat-Q8_0.gguf`(313MB)
  - 配置路径:`agents.defaults.memorySearch.local.modelPath`
- **兜底**:OpenAI text-embedding-3-small(收钱,尽量不触发)

**⚠️ 已移除**:Ollama 已于 2026-05-29 完全删除，不再作为 fallback。

**验证 local provider 可用**:
```bash
node-llama-cpp inspect gguf ~/.node-llama-cpp/models/hf_ggml-org_embeddinggemma-300m-qat-Q8_0.gguf
```

### memory_search 故障排查
| 症状 | 修复 |
|------|------|
| `fetch failed` | 检查 node-llama-cpp:`node-llama-cpp --version`,确认模型文件存在 |
| `model not found` | local 模型路径错误 → 检查 `agents.defaults.memorySearch.local.modelPath` |
| local 失败 | 检查 node-llama-cpp 和模型文件 |
| Cannot find package | `ln -sf /usr/local/lib/node_modules/node-llama-cpp /usr/local/lib/node_modules/openclaw/node_modules/` |

**⚠️ 禁止改 config 里的 model 名,禁止删 node-llama-cpp**
**⚠️ 查配置路径**:`python3 -c "import json; d=json.load(open('/Users/yuhuan/.openclaw/openclaw.json')); print(json.dumps(d['agents']['defaults']['memorySearch'], indent=2))"`

### 飞书群 @无反应
- 根因:飞书插件启动时 bot info probe 超时,open_id=unknown
- 修复:重启 Gateway:`openclaw gateway restart`

### Cron 防复发规则
- 一个任务只做一件事
- 先 smoke test 再上重任务
- 高峰期减少大 prompt
- 钉钉只用 `dingtalk-connector`

### 密钥管理
- Gateway 密钥通过 launchd plist 的 EnvironmentVariables 注入
- 配置文件用 `${VAR_NAME}` 引用
- ⚠️ Mac 上 openclaw.json 含大量明文密钥(OpenRouter/NVIDIA/Brave Search/Feishu/钉钉),应逐步改为环境变量引用

---

## 📊 量化系统摘要
> 详见 `./DEVELOPMENT.md` / `OctoQuant_README.md` / `docs/OctoQuant_使用指南.md`
- 初始资金 ¥100,000 / 当前空仓 ¥94,251.70
- 线A(17只全自动) / 线B(候选确认) / 告警飞书 Bot
- 交易平台 v3.2: 4板块 + AI多角色报告

---

## 🔍 模式检测（Pattern Detection）

`scripts/memory_pattern_detect.py` — 扫描 daily files 高频主题
- `--days 14 --report`：输出 TOP 10 主题报告
- `--update`：写入 `memory/topics/patterns.json`
- 借鉴 agentmemory 的 memory_patterns，基于关键词权重评分
- **触发时机**：心跳维护时 / 记忆压缩前 / 周日整理
- 反复出现的主题（score≥5 且跨天）→ 应沉淀到 `memory/topics/`

## 🧠 跨Agent学习原则
- GPT5.4 拍板定位 / M2.7 日常值班
- 交接必须包含：成果、新问题、优先级、文档更新
- 详见 `self-improving/learning.md`