记忆系统-摘要

📂 开发相关 / 日常操作规范 2026-11-13 16:38:27

记忆系统摘要

你是 AI Agent?这是你接入本系统的第一份文档。读完本文即可理解全局结构,然后按需跳转到其他文档。
重要:进入记忆库的正确顺序是:阅读 记忆系统-Agent → 获取认证 → 阅读 记忆系统-摘要(本文) → 获取技能 → 执行操作。


阅读顺序(AI 必读)

进入记忆库的正确流程:

  1. 第一步 → 记忆系统-Agent:获取认证密码、了解触发场景、获取 AI Agent 注册列表和云 Skills 目录。必须先读本文档。
  2. 第二步 → 记忆系统-摘要(本文):系统全局地图、项目结构、存储规则。
  3. 第三步 → 按需阅读:
    • 记忆系统-使用方法 — 完整 API 手册
    • 记忆系统-操作规范 — 操作约束与规范
    • 记忆系统-文档规范 — 文档库维护与云备份
  4. 第四步 → 获取记忆树:GET /api/v1/memory/index 获取最新结构。

强制:AI 会话启动时,必须先通过 记忆系统-Agent 获取认证和 Skills 清单,然后阅读本文,才能进行任何记忆库操作。


系统简介

MemKV 是一个三级记忆知识库系统,采用 项目 → 分组 → 条目 的树形结构。

项目 值
服务地址 http://119.145.17.34:5001
API 前缀 /api/v1
树结构查询 GET /api/v1/memory/index
只读分享页 http://119.145.17.34:5001/readme
认证方式 Authorization: Bearer wswwsw1234(见 记忆系统-Agent)

密码不在本文。认证信息在 记忆系统-Agent 中。


云记忆库 Skills 目录

所有 AI Skill 存储在云记忆库,唯一本地 Skill 为 leon-memory-agent。完整清单见本文末「Skill 全量索引」与 开发相关 > Skills。


项目结构

信息记录

存储一切有关信息:账户、手机号、个人资料、公司信息、设备信息等

分组 用途 说明
个人-相关 个人信息,每个条目对应一个人 联系人资料、个人档案
投控-相关 投控公司信息,每个条目对应一系列公司信息 公司资料、投控相关数据
设备情况 设备信息汇总,每个条目对应一台设备或服务 设备密码、配置、部署信息
随手记 无合适归属的临时信息存放处 兜底分组,不属于以上分类的信息存这里

展示跳转

存储说明书和介绍材料,每个分组对应一个组织

分组 用途
TK-OA 投控OA相关说明材料
TK-知识库 投控知识库相关说明材料
TK-Studio 投控Studio相关说明材料
已并入 LZ Studio相关说明材料
Leon-Note Leon个人笔记与说明材料

个人文档【办公】

本地写作文案和材料的云备份,每个任务对应一个条目

分组 用途
操作规范 办公与知识库工作规范文档备份
投控-日常 投控日常文档备份
绿岛建设采购 绿岛建设采购相关文档备份
数据经济 数据经济相关文档备份

开发相关

开发相关的所有知识

分组 用途 说明
日常操作规范 记忆系统的使用说明,描述系统如何被 AI 和用户使用 含 6 个核心文档
开发-速查 开发中遇到的难题和解决方案 每次解决问题后在此记录,支持追加
Leon-Git 记录个人私有化 Git 仓库信息 每个仓库一个条目,命名 【组织】项目名称
Skills 各种任务的执行方式介绍 AI 需要学习控制手段时来此查询

杂项

无合适归属的内容兜底存放处

分组 用途
WebView应用 WebView 容器型 APK 应用发布

记忆存储规则

写入规则表

信息类型 存储位置 示例
个人资料 / 联系人 信息记录 > 个人-相关 记录某人的联系方式
公司信息 信息记录 > 投控-相关 记录投控公司的资料
设备与账户信息 信息记录 > 设备情况 设备密码、服务器配置
说明书 / 介绍材料 展示跳转 > 对应分组 产品说明书、技术文档
办公文档 / 任务归档 个人文档【办公】 > 对应分组 写作文案备份、合同
Git 仓库相关 开发相关 > Leon-Git 下条目 项目信息、API 接口、更新日志
开发问题速查 开发相关 > 开发-速查 踩坑记录、解决方案
操作规范 / 工作流 开发相关 > Skills 网络运维、Git 配置等
系统文档 / AI Agent 接入 开发相关 > 日常操作规范 记忆系统核心文档
无明确分类 信息记录 > 随手记 兜底:任何无法归类的内容

Git 条目命名规范

统一使用 【组织】项目名称 格式:
- 【LZ-TK-Station】Leon-Control → 投控组织项目
- 【已并入】Clothen-Button-Detection → 工作室项目
- 【LZ-WorkStation】LZ-Memory → 默认组织项目

组织分类:
- LZ-TK-Station:投控相关项目(TK = 投控)
- 已并入:工作室项目
n- LZ-WorkStation:不属于以上两类的项目

条目更新规则


AI 记住工作流

用户说"记住 X"
    ↓
GET /api/v1/memory/index 获取树结构
    ↓
分析信息类型,匹配上表分类
    ↓
有匹配 → 存入对应位置(已有条目则追加,无则新建)
    ↓
无匹配 → 存入 信息记录 > 随手记
    ↓
如有附件 → 先 POST /api/v1/attachment/upload 上传
         → 再 PUT /api/v1/item/update 在正文中记录附件信息

关键约束

  1. 使用 curl.exe / Python 而非 WebFetch:WebFetch 会自动升级 http→https,导致连接失败
  2. 禁止自建项目/分组:AI 只能创建条目,不能创建新的项目或分组(除非用户明确要求)
  3. PUT 更新是 Partial Update:只传需要变更的字段
  4. 中文 JSON 用文件传递:--data-binary @文件路径 避免编码问题
  5. 附件不重命名:上传附件时保持原始文件名不变
  6. AI Agent 唯一本地 Skill:本地 .trae/skills/ 仅有 leon-memory-agent(又称 Leon-Memkv)。所有其他 Skill 直接从云记忆库获取,AI 不应保留本地副本。

快速导航

我想... 去哪里
获取认证密码 记忆系统-Agent
了解云 Skills 列表 记忆系统-Agent > 5. 云记忆库 Skills 目录
了解 API 怎么调用 记忆系统使用方法
了解操作约束 记忆系统-操作规范
查 sudo 密码 信息记录 > 设备情况 > Leon-XiaoXinAir-14ARE
查项目信息 开发相关 > Leon-Git
查网络设备控制 开发相关 > Skills > 绿岛国际网络运维-Skill
查开发问题 开发相关 > 开发-速查
查已迁移的 Skill 开发相关 > Skills 分组(详见本文云 Skills 目录)
查办公文档 个人文档 > 对应分组
查说明书 展示跳转 > 对应分组
存临时信息 信息记录 > 随手记
维护文档库/云备份 记忆系统-文档规范
看完整树结构 GET /api/v1/memory/index

如果你是 AI Agent

  1. 读 记忆系统-Agent → 获取认证密码、触发场景、云 Skills 目录
  2. 读记忆系统-摘要(本文)→ 了解全局结构、存储规则
  3. GET /api/v1/memory/index → 获取最新树结构
  4. 按需阅读:记忆系统-使用方法、操作规范、文档规范
  5. 从云 Skills 获取所需 Skill → 在执行任务时动态加载

如果你是人类用户

浏览器访问 http://119.145.17.34:5001 登录后可可视化操作。


操作后同步规则(强制)

每次操作结束时,AI 必须执行以下同步动作,否则视为任务未完成。

触发条件

以下任一情况发生时,必须同步到记忆库:

情况 同步目标 示例
发现/获取了新的账户信息 信息记录 > 个人-相关 或 设备情况 新服务器密码、新平台账号
项目架构/部署发生变更 开发相关 > 项目管理 > 对应项目条目 新增端口、迁移服务器、更换域名
新建了服务/站点 开发相关 > 项目管理(新建条目) 部署了新系统
网络/设备配置变更 Leon-Note > 【投控】信息(设备)> 对应设备 IP 变更、新增虚拟机
开发中解决了问题 开发相关 > 开发-速查(追加或新建) 踩坑记录、解决方案
发现了新的待办事项 Leon-Note > 【投控】待办 用户提到的待办

执行流程

操作结束前
    ↓
回顾本次操作涉及的信息变化
    ↓
有新账户/密码/配置 → 更新 信息记录 对应条目
有项目变更 → 更新 开发相关 > 项目管理 对应条目
有新问题解决 → 追加到 开发相关 > 开发-速查
    ↓
确认同步完成 → 任务结束

禁止事项


迁入内容(来自 记忆系统-Agent,2026-10-25)

查询优先级

  1. 开发相关 > 开发-速查 — 具体问题解决方案
  2. 开发相关 > Skills — 系统性角色能力
  3. 记忆库搜索 — 关键词匹配
  4. 外部搜索 — 最后选择

Skills 与 开发-速查 区别

任务成果回写(默认执行)

工作内容 回写位置
设备/网络变更 信息记录 > 设备情况 > 对应条目
代码改动/部署 开发相关 > Leon-Git > 对应项目
项目功能/接口变更 开发相关 > 项目管理 > 对应项目条目(更新最新特性+接口)
需要用到的知识 / 需要记录的知识(开发知识、踩坑、技术要点) 开发相关 > 开发-速查
通用能力沉淀 开发相关 > Skills
临时存储(临时文件/未分类临时内容) 个人文档 > 【日常】TMP
临时展示 / 文件下载链接 Leon-File-Host-Skill:上传到文件中转站并返回访问链接

格式:## YYYY-MM-DD 任务概述 → 关键改动/结论 → 踩坑记录

临时展示与文件下载链接(Leon-File-Host-Skill 强制,2026-09-15)

AI 需要临时展示内容(素材/成品预览展示)或需要向用户提供文件下载链接时,
一律通过 开发相关 > Skills > Leon-File-Host-Skill 挂载与返回访问链接:

  1. 调用文件中转站 POST /api/upload(或 batch-upload)上传文件到 http://192.168.11.70:5222
  2. 向用户返回 预览链接 /f/<stored_name> 与 下载链接 /d/<stored_name>
  3. 确认无需保留后 POST /api/delete 清理,避免堆积

临时展示 / 文件下载一律走 Leon-File-Host-Skill,不再通过记忆库附件或其他方式中转文件下载。
Markdown/报告类产物可用同一接口 POST /api/markdown-to-pdf 直接生成 PDF 并返回下载链接(含 mermaid 图表)。

记忆库结构速览

项目 用途 何时访问
Skill Skill 的知识卡片(内容层),每个 Skill 一个分组 读 Skill 详情时(先读 00-总索引)
开发相关 开发知识(Skills 指引层 / 日常操作规范 / 开发-速查) 开发任务时
信息记录 账户、手机号、个人资料、公司信息、设备信息 需要个人信息或设备信息时
展示跳转 说明书和介绍材料 需要查阅说明书时
个人文档【办公】 本地写作文案和材料的云备份 需要查阅文档备份时
Leon-Note 项目汇总、设备信息、运维记录 查询项目或设备时

Skill 全量索引(自动维护;各 Skill 详情已下沉至 Skill 项目的知识卡片,清单见 知识卡片索引_card)

唯一清单:开发相关 > Skills(27 个指引)+ 开发相关 > 日常操作规范(7 个系统级)。
增删改 Skill 必须同步本表与 memory/index;体积列便于判断是否需要 search 定位后再按章节读取。

Skill 分类 用途 体积 更新时间 路径
Cloudflare-Tunnel-Skill 运维安全 Cloudflare Tunnel 隧道建立:quick/API命名隧道+DNS+systemd+限速结论 3.4k 2026-10-19 开发相关/Skills/Cloudflare-Tunnel-Skill
软件形式规范-Skill 界面规范 入口等待区/门禁UI形式规范:设计语言+3变体+静态资源MIME 2.9k 2026-10-15 开发相关/Skills/软件形式规范-Skill
TempPad-Skill 办公与交付 TempPad 多页面 Markdown 临时工作区:页面/空间/图片/归档/一键下载,全套 API 与运维 0.8k 2026-09-28 开发相关/Skills/TempPad-Skill
视频剪辑-Skill 办公与交付 剪映 AI 自动化剪辑:文案/配音/字幕/配乐/特效/录屏/Web动效/导出全流程 6 cards 2026-11-08 开发相关/Skills/视频剪辑-Skill
企业官网制作-Skill 开发流程 企业官网/落地页/产品展示站制作全流程 0.8k 2026-09-28 12:15 开发相关/Skills/企业官网制作-Skill
AI-Novel-Platform-Skill AI与模型 AI 辅助中文小说创作平台的完整使用指南,包括部署信息、API 接口、卡片类型、数据库 Sc… 0.8k 2026-09-28 12:15 开发相关/Skills/AI-Novel-Platform-Skill
网络运维整合-Skill 运维安全 网络运维整合:路由器/交换机/防火墙/WAF/VPN/反代/Safe/SecOps/公网入口… 2.7k 2026-09-28 12:15 开发相关/Skills/网络运维整合-Skill
项目管理-Skill 规范 项目存储/管理/更新全流程:注册、更新、归档、命名规范 0.7k 2026-09-28 12:15 开发相关/Skills/项目管理-Skill
软件全流程开发-Skill 开发流程 全流程6阶段+§4.11打包执行器(APK/exe双轨)+浏览器中转站Browser-Rel… 3.3k 2026-09-28 12:14 开发相关/Skills/软件全流程开发-Skill
ZY-OA开发整合-Skill 开发流程 致远OA A8N 二次开发整合:CAP4修复/表格样式/流程调整/REST/流程控制 + O… 2.2k 2026-09-28 12:14 开发相关/Skills/ZY-OA开发整合-Skill
网络漏洞挖掘-Skill 运维安全 网络漏洞挖掘:侦察+强制验证+截图+TempPad沉淀;含漏洞检查报告(原 网络安全漏洞检查… 2.4k 2026-09-28 12:14 开发相关/Skills/网络漏洞挖掘-Skill
流量分发-Skill 运维安全 流量分发/代理编排:多链路与负载策略;含局域网联网代理(原 局域网联网代理-Skill) 0.8k 2026-09-28 12:14 开发相关/Skills/流量分发-Skill
办公-Skill 办公与交付 办公能力总纲:B站字幕提取 + 办公工具集(原 LZ-Office-Skill,.70:52… 0.9k 2026-09-28 12:14 开发相关/Skills/办公-Skill
TikTok-Hub-Skill 办公与交付 TikTok 多账号图文推送/文章批量同步;Chrome多profile池+复用Browser-Relay,P0 未跑通 1.2k 2026-09-28 开发相关/Skills/TikTok-Hub-Skill
开发台账-Skill 规范 项目开发台账:接手项目先读台账接进度,开发后回写改动/决策/验证/待办 0.9k 2026-10-12 开发相关/Skills/开发台账-Skill
自我改进-Skill 规范 踩坑记录、Pattern-Key 去重、Maintenance 重验、经验晋升 0.8k 2026-10-12 开发相关/Skills/自我改进-Skill
Leon-File-Host-Skill 办公与交付 AI 文件中转站使用指南:用 Leon-File-Host(192.168.11.70:52… 0.8k 2026-09-28 12:06 开发相关/Skills/Leon-File-Host-Skill
设备管理-Skill 规范 设备信息统一管理:存储位置、命名规范、DHCP注册、SSH配置、查询方法 0.8k 2026-09-28 12:06 开发相关/Skills/设备管理-Skill
运维激活-Skill 运维安全 激活中心/运维激活管控:两版部署+心跳校验+跨平台导入手册+排障 0.8k 2026-09-22 16:33 开发相关/Skills/运维激活-Skill
信创数据库-Skill 运维安全 华为openGauss/PostgreSQL信创数据库安装、配置、使用指南 0.8k 2026-09-17 02:00 开发相关/Skills/信创数据库-Skill
Cloudflare-MCP-Skill 运维安全 Cloudflare MCP:KV/R2/D1/Workers/DO/Queues/AI全栈… 0.8k 2026-09-16 18:29 开发相关/Skills/Cloudflare-MCP-Skill
VM参考-Skill 运维安全 虚拟机参考手册:ESXi集群+VirtualBox+ZY-OA+克隆规范+网络配置+MCP节… 1.9k 2026-09-15 07:52 开发相关/Skills/VM参考-Skill
Git-Skill 开发流程 Git 项目规范:项目概括 + 仓库信息 + 修改日志 0.7k 2026-09-02 09:02 开发相关/Skills/Git-Skill
记忆系统-Agent 规范 AI Agent 接入指南:认证、触发场景、Agent列表、Skills目录、临时展示/文件… 32.2k 2026-09-28 12:14 开发相关/日常操作规范/记忆系统-Agent
动态漫剧本-Skill 规范 指引层(卡片清单见 Skill > 动态漫剧本) 0.7k 2026-10-12 开发相关/Skills/动态漫剧本-Skill
AI-Token-管理-Skill 规范 指引层(卡片清单见 Skill > AI-Token-管理) 2.1k 2026-10-12 开发相关/Skills/AI-Token-管理-Skill
记忆系统-摘要 规范 AI 必读入口:进入流程·系统结构·Skills目录·存储规则 6.5k 2026-09-28 12:14 开发相关/日常操作规范/记忆系统-摘要
记忆系统-使用方法 规范 完整 API 手册(curl + Python 示例) 2.5k 2026-09-01 21:40 开发相关/日常操作规范/记忆系统-使用方法
记忆系统-操作规范 规范 sudo 规范、写入规则、删除规则、AI 偏好 3.7k 2026-09-02 17:55 开发相关/日常操作规范/记忆系统-操作规范
记忆系统-文档规范 规范 本地文档库与云记忆的映射规范及备份规则 1.9k 2026-09-01 21:40 开发相关/日常操作规范/记忆系统-文档规范
OA-表单覆盖-Skill 办公与交付 OA 表单覆盖展示:选表单记录贴覆盖、双模式切换(70:8512 sidecar) 0.8k 2026-10-26 开发相关/Skills/OA-表单覆盖-Skill
OA-SSO独立服务-Skill 开发流程 独立SSO认证服务:票据签验/whoami/闸门/管理控制台(70机8510常驻) 0.8k 2026-10-25 开发相关/Skills/OA-SSO独立服务-Skill
知识学习-Skill 办公与交付 学习资料采集与打印手册制作:目录发现/抓取转MD/DOCX+PDF合订本/渲染配图 1.5k 2026-11-14 开发相关/Skills/知识学习-Skill

说明:开发相关 > Skills 分组 20 个 + 日常操作规范 5 个系统级 Skill 已合并为上表一张,遵循单一事实源。
维护责任:以本表为 Skill 唯一清单;分组下新增/移动/删除 Skill 时,必须同步本表与各条目 references(双向、去重)。

说明:原"## 云记忆库 Skills 目录"中"系统级 Skill/运维 Skill/开发 Skill"三张分类表已合并为上表一张;保留 5 个系统级 Skill 中的 3 个代表性条目(记忆系统-Agent、记忆系统-摘要、记忆系统-文档规范),另外 2 个(记忆系统-使用方法、记忆系统-操作规范)由 记忆系统-Agent 的 references 字段引用,遵循单一事实源原则不再重复列。
2026-09-26 新增:办公-Skill(LZ-Office 文档解析服务的AI Agent 调用手册)。
维护责任:以本表为 Skill 唯一清单;当分组下新增/移动/删除 Skill 时,必须同步更新本表与 references 字段。

> 2026-09-15 整合:ZYOA-排障SOP-Skill→并入 ZY-OA开发整合-Skill;补天违规红线与处置标准-Skill→并入 网络漏洞挖掘-Skill;leon-memkv→并入 开发相关 > 项目管理>MemKV记忆库;虚拟机复制-Skill→并入 VM参考-Skill。

记忆库管理策略总纲(2026-09-15 增补)

本总纲是记忆库管理的核心策略与知识,AI 与人类共同遵守。概要版固化于 开发相关 > 项目管理 > MemKV记忆库 > 记忆库管理规范,此处为操作侧细化。

A. 存储分区(记录该放哪,杜绝随手乱丢)

记录类型 落点 判断标准
需要用到的知识 / 需要记录的知识 开发相关 > 开发-速查 以后还会查 → 知识化沉淀
临时存储(临时文件/未分类内容) 个人文档 > 【日常】TMP 中间产物、草稿、暂存 → 到此即可
项目信息(特性/接口/改动/进度) 开发相关 > 项目管理 > 对应项目条目 属于某个项目 → 进项目条目
通用能力沉淀 开发相关 > Skills 可复用的系统性能力 → 建 Skill
设备/网络变更 信息记录 > 设备情况 > 对应条目 设备相关
代码改动/部署 开发相关 > Leon-Git > 对应项目 代码仓

已废弃:信息记录 > 随手记(2026-09-15 删除)。临时内容一律进【日常】TMP。

B. Skill 项目管理策略(避免重复、避免碎片化)

  1. 先搜后建:创建新 Skill 前,memory search/search 现有 Skills,确认无同类项再建。
  2. 同域合并:同一主题的多个 Skill 优先合并为一个大 Skill(如 ZYOA-排障SOP→ZY-OA开发整合、虚拟机复制→VM参考、补天红线→网络漏洞挖掘、leon-memkv→MemKV记忆库),避免碎片化重复条目。
  3. 删除即清引用:Skill 合并/删除后,同步从其他条目 references 字段移除已删条目名(曾留 ZYOA-排障SOP 等残留引用,须 PUT references 修正)。
  4. 清单一致性:增删改 Skill 时必须同步四处——① 本文件「Skill 全量索引」表 ② 知识卡片索引_card ③ Skill 项目下对应分组 ④ 条目 references(双向、去重)。

C. 知识记录策略(开发-速查)

  1. 统一格式:## YYYY-MM-DD 任务概述 → 关键改动/结论 → 踩坑记录。
  2. 一题一条:可独立复用的一次知识(踩坑/部署/要点)单存一条,标题带日期便于检索(如 xxx-修复-20260915)。
  3. 可升级则升级:某知识反复用到且具备系统性 → 升级为 Skill;临时草稿在【日常】TMP 整理后按需转存或删除。

D. 项目记录策略(项目管理)

  1. 每项目一条:项目信息统一在 开发相关 > 项目管理 使用已有条目或新建一条,不允许散落多处。
  2. 持续更新同一条目:项目推进的每次改动/里程碑都追加 ## YYYY-MM-DD 任务概述 段到该条目,保持其始终反映最新状态,即是唯一长期档案。
  3. AI 开发任务强制:见「AI 开发项目强制规范」——开发前加载「软件全流程开发-Skill」(只读指引层,再按指引读 1~3 张卡片,不要通读),开发后记录更新到对应项目条目。
  4. 新增/上传 Skill 强制:见「知识卡片体系 §4」五步流程——建分组 → 拆卡片 → 建指引条目 → 三处登记。

E. 避免重复 / 防碎片 通用要点

  1. 创建/更新条目前先 search 关键字,命中即更新而非新建。
  2. 同义字形:Chinese item_name 用 codepoint 校验(记忆系统-Agent 第二字 chr(0x5FC6)),防 Unicode 近似字建重复条目。
  3. summary 与 md_content 同步维护;references 保持双向引用且不指向已删条目。
  4. 判断存储位置不确定时 → 查本总纲 A 分区表,临时性质模糊 → 【日常】TMP。

更新: 2026-09-28(新增「软件全流程开发-Skill」为浏览器类工作统一入口,强制规范 1.5;新增「办公-Skill」为办公类能力总索引)

📎 附件 (2)

Pasted image
77.7 kB • image.png
下载
1.docx
18.2 kB
下载