🔄 卡若AI 同步 2026-03-12 21:26 | 更新：运营中枢、运营中枢工作台 | 排除 >20MB: 11 个

2026-03-12 21:26:12 +08:00
parent e544eb2ce7
commit 641b78aeb9
17 changed files with 204 additions and 47 deletions
--- a/运营中枢/使用手册/README.md
+++ b/运营中枢/使用手册/README.md
@@ -81,6 +81,33 @@

 ---

+## 手册目录结构
+
+```
+运营中枢/使用手册/
+├── README.md                     ← 本文件（序 + 总目录）
+├── 卡若AI使用手册.md             ← 导航页
+├── 对话沉淀与优化规则.md
+├── images/                       ← 配图（与手册同步）
+│   ├── README.md                 ← 配图索引与引用章节
+│   ├── 人设架构图.png
+│   ├── 团队工作流程图.png
+│   ├── 卡若AI核心功能介绍流程图.png
+│   ├── 卡若AI_对话运转执行流程图.png
+│   ├── 卡若AI记忆系统v3架构流程图.png
+│   ├── 基因胶囊_概念与流程.png
+│   └── 基因胶囊_完整工作流程图.png
+├── 第一篇_认识卡若AI/
+├── 第二篇_快速入门/
+├── 第三篇_五行技能详解/
+├── 第四篇_运营中枢/
+├── 第五篇_卡若AI网站/
+├── 第六篇_进阶与扩展/
+└── 附录/
+```
+
+配图说明见 [images/README.md](images/README.md)。图片与手册一并提交、同步到 Gitea。
+
 ## 如何使用本手册

 - **新用户**：从第一篇开始顺序阅读，了解架构后看第二篇快速上手
--- a/运营中枢/使用手册/images/README.md
+++ b/运营中枢/使用手册/images/README.md
@@ -0,0 +1,14 @@
+# 使用手册配图
+
+> 本目录存放使用手册引用的架构图与流程图，与手册一起同步维护。  
+> 原始图源见 `卡若Ai的文件夹/图片/` 及 `图片索引.md`。
+
+| 文件名 | 说明 | 引用章节 |
+|:---|:---|:---|
+| 人设架构图.png | 运作流程 + 大总管与五行 + 成员与技能 | 第2章 架构总览 |
+| 团队工作流程图.png | 任务从输入到沉淀的完整流转 | 第2章 架构总览 |
+| 卡若AI核心功能介绍流程图.png | 五角色能力分布 | 第2章 架构总览 |
+| 卡若AI_对话运转执行流程图.png | 对话流程、启动、MAX Mode 三合一 | 第5章 第一次对话 |
+| 卡若AI记忆系统v3架构流程图.png | 四层记忆 + 检索顺序 + 自动化 Pipeline | 第15章 记忆系统 |
+| 基因胶囊_概念与流程.png | 基因胶囊四部分组成 | 第16章 基因胶囊 |
+| 基因胶囊_完整工作流程图.png | 内部流程 + 技能工厂联动 + 对外流通 | 第16章 基因胶囊 |
--- a/运营中枢/使用手册/images/人设架构图.png
+++ b/运营中枢/使用手册/images/人设架构图.png
--- a/运营中枢/使用手册/images/卡若AI_对话运转执行流程图.png
+++ b/运营中枢/使用手册/images/卡若AI_对话运转执行流程图.png
--- a/运营中枢/使用手册/images/卡若AI核心功能介绍流程图.png
+++ b/运营中枢/使用手册/images/卡若AI核心功能介绍流程图.png
--- a/运营中枢/使用手册/images/卡若AI记忆系统v3架构流程图.png
+++ b/运营中枢/使用手册/images/卡若AI记忆系统v3架构流程图.png
--- a/运营中枢/使用手册/images/团队工作流程图.png
+++ b/运营中枢/使用手册/images/团队工作流程图.png
--- a/运营中枢/使用手册/images/基因胶囊_完整工作流程图.png
+++ b/运营中枢/使用手册/images/基因胶囊_完整工作流程图.png
--- a/运营中枢/使用手册/images/基因胶囊_概念与流程.png
+++ b/运营中枢/使用手册/images/基因胶囊_概念与流程.png
--- a/运营中枢/使用手册/第一篇_认识卡若AI/02_架构总览.md
+++ b/运营中枢/使用手册/第一篇_认识卡若AI/02_架构总览.md
@@ -67,15 +67,27 @@

 ## 2.5 架构图

-三张核心架构图存放在 `/Users/karuo/Documents/卡若Ai的文件夹/图片/`：
+三张核心架构图（存放在使用手册 `images/` 目录，与手册同步）：
+
+![人设架构图：运作流程 + 大总管与五行 + 成员与技能](../images/人设架构图.png)
+
+**图 2-1 人设架构图** — 运作流程、大总管与五行、成员与技能一览
+
+![团队工作流程图：任务从输入到沉淀的完整流转](../images/团队工作流程图.png)
+
+**图 2-2 团队工作流程图** — 任务从输入到沉淀的完整流转、运营中枢支撑
+
+![卡若AI核心功能介绍流程图：五角色能力分布](../images/卡若AI核心功能介绍流程图.png)
+
+**图 2-3 卡若AI核心功能介绍** — 五角色职责与能力分布

 | 图 | 说明 |
 |:---|:---|
-| `人设架构图.png` | 运作流程 + 大总管与五行 + 成员与技能 |
-| `团队工作流程图.png` | 任务从输入到沉淀的完整流转 |
-| `卡若AI核心功能介绍流程图.png` | 五角色能力分布 |
+| 人设架构图.png | 运作流程 + 大总管与五行 + 成员与技能 |
+| 团队工作流程图.png | 任务从输入到沉淀的完整流转 |
+| 卡若AI核心功能介绍流程图.png | 五角色能力分布 |

-详见 `运营中枢/参考资料/卡若AI架构说明.md`。
+更多说明见 `运营中枢/参考资料/卡若AI架构说明.md`。

 ---

--- a/运营中枢/使用手册/第二篇_快速入门/05_第一次对话.md
+++ b/运营中枢/使用手册/第二篇_快速入门/05_第一次对话.md
@@ -8,6 +8,10 @@

 每次对话遵循固定流程（强制）：

+![卡若AI 对话运转执行流程图](../../images/卡若AI_对话运转执行流程图.png)
+
+**图 5-1 对话运转执行流程图** — 启动加载、思考展示、执行验证、复盘沉淀
+
 ```
 输入需求
  ↓
--- a/运营中枢/使用手册/第五篇_卡若AI网站/19_官网与控制台.md
+++ b/运营中枢/使用手册/第五篇_卡若AI网站/19_官网与控制台.md
@@ -6,40 +6,47 @@

 ## 19.1 官网页面

-| 路径 | 页面 | 功能 |
-|:---|:---|:---|
-| `/` | 首页 | 居中对话区 + 底部输入框，直接与卡若AI 对话；可展开团队与执行流程面板 |
-| `/skills` | 能力一览 | 技能卡片画廊，按金/水/木/火/土筛选 + 搜索 |
-| `/about` | 关于 | 五行团队卡片 + 统计数据 + 可实现范围 |
-| `/usage` | 使用指南 | 7 步垂直时间线：登录→配置→编排→文档→任务→网关→闭环 |
-| `/faq` | 常见问题 | 手风琴式 FAQ 展开 |
-| `/contact` | 联系 | 表单 + 系统状态卡片 |
-| `/chat` | 对话 | 完整对话界面，v0 风格，快捷 prompt 气泡 |
-| `/gene-capsule` | 基因胶囊 | 概念说明 + 已上线胶囊下载列表 |
+
+| 路径              | 页面   | 功能                                    |
+| --------------- | ---- | ------------------------------------- |
+| `/`             | 首页   | 居中对话区 + 底部输入框，直接与卡若AI 对话；可展开团队与执行流程面板 |
+| `/skills`       | 能力一览 | 技能卡片画廊，按金/水/木/火/土筛选 + 搜索              |
+| `/about`        | 关于   | 五行团队卡片 + 统计数据 + 可实现范围                 |
+| `/usage`        | 使用指南 | 7 步垂直时间线：登录→配置→编排→文档→任务→网关→闭环         |
+| `/faq`          | 常见问题 | 手风琴式 FAQ 展开                           |
+| `/contact`      | 联系   | 表单 + 系统状态卡片                           |
+| `/chat`         | 对话   | 完整对话界面，v0 风格，快捷 prompt 气泡             |
+| `/gene-capsule` | 基因胶囊 | 概念说明 + 已上线胶囊下载列表                      |
+

 ## 19.2 控制台页面

-| 路径 | 页面 | 功能 |
-|:---|:---|:---|
-| `/console` | 总览 | 4 张统计卡 + 7 模块入口 + 最近 5 条任务 |
-| `/console/login` | 登录 | 居中卡片 + 渐变 Logo |
-| `/console/skills` | 技能配置 | 列表/分类、编辑、AI 整理、AI 新增、从主仓库同步 |
-| `/console/workflows` | 流程编排 | 步骤可视化 + 一键执行 |
-| `/console/tasks` | 任务控制台 | 状态色点 + 复盘记录 |
-| `/console/docs` | 文档操控 | 调研/生成/更新按钮 |
-| `/console/gateway` | API 网关 | 主备网关区分 + 一键切换 |
-| `/console/users` | 账号权限 | 角色 badge + inline 编辑 |
-| `/console/platform` | 平台治理 | 接口开关 + 限流 + 基因胶囊配置 |
+
+| 路径                   | 页面     | 功能                          |
+| -------------------- | ------ | --------------------------- |
+| `/console`           | 总览     | 4 张统计卡 + 7 模块入口 + 最近 5 条任务  |
+| `/console/login`     | 登录     | 居中卡片 + 渐变 Logo              |
+| `/console/skills`    | 技能配置   | 列表/分类、编辑、AI 整理、AI 新增、从主仓库同步 |
+| `/console/workflows` | 流程编排   | 步骤可视化 + 一键执行                |
+| `/console/tasks`     | 任务控制台  | 状态色点 + 复盘记录                 |
+| `/console/docs`      | 文档操控   | 调研/生成/更新按钮                  |
+| `/console/gateway`   | API 网关 | 主备网关区分 + 一键切换               |
+| `/console/users`     | 账号权限   | 角色 badge + inline 编辑        |
+| `/console/platform`  | 平台治理   | 接口开关 + 限流 + 基因胶囊配置          |
+

 ## 19.3 官网与控制台的区别

-| 维度 | 官网 | 控制台 |
-|:---|:---|:---|
-| 受众 | 所有访客 | 管理员 |
-| 权限 | 无需登录（只读） | 需登录（读写） |
-| 接口 | 只调只读 API | 可调所有 CRUD |
-| 作用 | 展示、说明、入口 | 配置、管理、运维 |
+
+| 维度  | 官网       | 控制台       |
+| --- | -------- | --------- |
+| 受众  | 所有访客     | 管理员       |
+| 权限  | 无需登录（只读） | 需登录（读写）   |
+| 接口  | 只调只读 API | 可调所有 CRUD |
+| 作用  | 展示、说明、入口 | 配置、管理、运维  |
+

 ---

 > 下一章：[第20章 · API 与部署](20_API与部署.md)
+
--- a/运营中枢/使用手册/第四篇_运营中枢/15_记忆系统.md
+++ b/运营中枢/使用手册/第四篇_运营中枢/15_记忆系统.md
@@ -4,13 +4,28 @@

 ---

-## 15.1 唯一记忆源
+## 15.1 四层记忆架构（v3）
+
+记忆系统采用**四层架构**：短期（STM）+ 当日工作台（CURRENT_STATE）+ 长期（LTM）+ 结构化（Structured）。
+
+![卡若AI记忆系统v3架构流程图](../../images/卡若AI记忆系统v3架构流程图.png)
+
+**图 15-1 记忆系统 v3 架构** — 四层记忆 + 检索顺序 + 自动化 Pipeline
+
+| 层级 | 存储位置 | 说明 |
+|:---|:---|:---|
+| **短期记忆（STM）** | Cursor/平台 对话上下文 | 单次对话有效，由平台自动管理 |
+| **当日工作台** | `记忆系统/CURRENT_STATE.md` | 每次对话启动时优先读取；可覆盖更新；字段：今日目标/进行中/阻塞/下一步≤3 |
+| **长期记忆（LTM）** | `个人/1、卡若：本人/记忆.md` | 长期偏好、规则、人脉、原则；**单文件、无子目录** |
+| **结构化记忆** | `记忆系统/structured/` | 技能索引、Agent 成果、每日摘要、任务结果卡、冲突检测报告等 |
+
+## 15.2 唯一记忆源（长期）

 **路径**：`/Users/karuo/Documents/个人/1、卡若：本人/记忆.md`

 单文件、无子目录。每次对话开始自动读取，作为长期记忆与偏好参考。

-## 15.2 记忆检索顺序（强制）
+## 15.3 记忆检索顺序（强制）

 当需要查找信息时，按以下顺序：

@@ -28,7 +43,7 @@
 ⑥ 历史归档 archive/
 ```

-## 15.3 写入规则
+## 15.4 写入规则

 | 规则 | 说明 |
 |:---|:---|
@@ -38,11 +53,11 @@
 | 去重 | 同一天相同条目不重复写入 |
 | 冲突检测 | 写入前执行 `python memory_conflict_check.py "内容"` |

-## 15.4 与卡若人设联动
+## 15.5 与卡若人设联动

 调动记忆时以**卡若角色**参与——不是冷调取数据，而是用卡若的立场、语气和判断理解运用记忆。记忆与 `1、卡若：本人/` 下的个人档案联动。

-## 15.5 记忆分类
+## 15.6 记忆分类标签

 记忆以标签区分，统一写在同一文件：

@@ -51,6 +66,25 @@
 - `[人脉]`：人际关系与联系
 - `[项目]`：项目进展与里程碑

+## 15.7 自动化脚本
+
+| 脚本 | 用途 | 频率 |
+|:---|:---|:---|
+| `collect_chat_daily.py` | 每日对话归档（幂等去重 + 脱敏） | 每日 |
+| `collect_daily.py` | 扫描当日活跃 Agent，生成摘要 | 每日 |
+| `weekly_optimize.py` | SKILL 质量审计 + 经验库整理 + 日日志归档 | 每周 |
+| `memory_watchdog.py` | 记忆系统健康巡检 | 每 2 小时 |
+| `memory_conflict_check.py` | **写入长期记忆前冲突检测** | 写入前 |
+
+脚本路径：`02_卡人（水）/水溪_整理归档/记忆系统/`。详见该目录下 `README.md`。
+
+## 15.8 任务结果卡
+
+- **目录**：`structured/tasks/`
+- **格式**：子任务/并行线程完成后追加到 `structured/tasks/YYYY-MM-DD.md`
+- **字段**：goal / boundary / acceptance / key_actions / artifact_paths / status / next_step
+- **用途**：仅记录结果，不记录过程；检索时优先于对话归档
+
 ---

 > 下一章：[第16章 · 基因胶囊](16_基因胶囊.md)
--- a/运营中枢/使用手册/第四篇_运营中枢/16_基因胶囊.md
+++ b/运营中枢/使用手册/第四篇_运营中枢/16_基因胶囊.md
@@ -4,22 +4,73 @@

 ---

-## 16.1 什么是基因胶囊
+## 16.1 一句话理解（普通用户）
+
+**基因胶囊** = 把 AI 学会的「本事」打成一个小包，可以存起来、传给别人、或者以后直接拿来用。就像「技能卡」：学会一次，到处复用。
+
+## 16.2 概念与四部分组成

 基因胶囊是卡若AI 的**技能遗传机制**：将验证过的 Skill 打包成可传递、可继承的能力单元。

-**公式**：基因胶囊 = 策略（SKILL）+ 环境指纹 + 审计记录 + 资产 ID
+**公式**：基因胶囊 = **策略（SKILL）** + **环境指纹** + **审计记录** + **资产 ID**

-## 16.2 三个操作
+![基因胶囊概念与流程](../../images/基因胶囊_概念与流程.png)
+
+**图 16-1 基因胶囊概念与流程** — 四部分组成与继承校验
+
+| 部分 | 说明 |
+|:---|:---|
+| **策略** | SKILL.md 完整内容（触发词、步骤、脚本路径） |
+| **环境指纹** | Python 版本、平台、依赖（继承时校验兼容性） |
+| **审计记录** | 最近复盘的「目标·结果·达成率」或执行摘要 |
+| **资产 ID** | SHA-256 哈希，内容变则 ID 变，用于去重与溯源 |
+
+## 16.3 三个操作（程序员）

 | 操作 | 命令 | 说明 |
 |:---|:---|:---|
-| **pack** | `gene_capsule.py pack <skill_path>` | 将 Skill 打包为胶囊 |
-| **unpack** | `gene_capsule.py unpack <capsule_path>` | 胶囊还原为 Skill |
-| **list** | `gene_capsule.py list` | 查看所有已打包胶囊 |
+| **pack** | `gene_capsule.py pack <skill_path>` | Skill → 胶囊 JSON（导出到本地目录） |
+| **unpack** | `gene_capsule.py unpack <capsule_path>` | 胶囊 JSON → Skill（继承到指定目录） |
+| **list** | `gene_capsule.py list` | 查看本地所有胶囊（名称、ID、创建时间） |
 | **pack-all** | `gene_capsule.py pack-all` | 全量打包所有 Skill |

-## 16.3 胶囊结构
+## 16.4 完整工作流（含技能工厂联动）
+
+![基因胶囊完整工作流程图](../../images/基因胶囊_完整工作流程图.png)
+
+**图 16-2 基因胶囊完整工作流** — 内部流程 + 技能工厂联动 + 未来对外流通
+
+- **卡若AI 内部**：用户需求 → 查 SKILL → 执行 → 复盘；经验有价值 → 经验库 → 可打包为胶囊
+- **技能工厂联动**：创建 Skill 前先 list 查胶囊，有匹配则 unpack 继承；创建 Skill 后可 pack 打包
+- **未来流通**：可选上传 EvoMap Market，全球 Agent 继承
+
+### 流程图（Mermaid）
+
+```mermaid
+flowchart TB
+    subgraph internal["卡若AI 内部流程"]
+        A1[用户需求/任务] --> A2{查 SKILL_REGISTRY}
+        A2 --> A3[读 SKILL.md 执行]
+        A3 --> A4[执行完成 + 复盘]
+        A4 --> A5{经验有价值?}
+        A5 -->|是| A6[写入经验库/待沉淀]
+        A5 -->|否| A7[结束]
+        A6 --> A8{要打包为胶囊?}
+    end
+    subgraph capsule["基因胶囊 核心流程"]
+        B1[pack: Skill 转 胶囊JSON] --> B2[导出目录 + 说明文档]
+        B2 --> B3[list: 查看本地胶囊]
+        B3 --> B4{需要继承?}
+        B4 -->|是| B5[unpack: 胶囊 转 Skill]
+        B4 -->|否| B6[保留备用]
+        B5 --> B7[写入对应成员目录]
+        B7 --> B8[更新 SKILL_REGISTRY]
+    end
+    A8 -->|是| B1
+    A8 -->|否| A7
+```
+
+## 16.5 胶囊结构（YAML）

 ```yaml
 version: "1.0"
@@ -39,18 +90,23 @@ updated_at: "2026-03-12T10:00:00"

 **资产 ID 计算**：`capsule_id = "sha256:" + SHA256(skill_path + skill_content 前 8192 字符)`

-## 16.4 存储位置
+## 16.6 存储与导出位置

 | 位置 | 说明 |
 |:---|:---|
-| `卡若Ai的文件夹/导出/基因胶囊/` | 本地导出目录 |
+| `卡若Ai的文件夹/导出/基因胶囊/` | 本地导出目录，每技能独立子目录 |
 | `05_卡土（土）/土砖_技能复制/基因胶囊/capsule_index.json` | 胶囊索引 |

-## 16.5 使用场景
+## 16.7 怎么用（普通用户）
+
+说「打包技能」「解包胶囊」「基因胶囊」「继承能力」等触发词，卡若AI 会按对应 Skill 执行。也可让 AI「把这个技能打成胶囊」或「继承某某胶囊」。
+
+## 16.8 使用场景

 - 迁移到新 AI 环境时：打包→传输→解包
 - 给其他项目复制能力：pack → 拷贝 → unpack
 - 能力审计：查看每个胶囊的来源与版本
+- 技能工厂创建新 Skill 前：先 list 查是否有可继承胶囊

 ---

--- a/运营中枢/使用手册/附录/D_更新记录.md
+++ b/运营中枢/使用手册/附录/D_更新记录.md
@@ -8,6 +8,7 @@

 | 日期 | 版本 | 变更说明 |
 |:---|:--:|:---|
+| 2026-03-12 | v2.1 | 配图与结构完善：新增 images/ 目录，同步人设/团队/核心功能/对话运转/记忆系统v3/基因胶囊概念与完整流程图共 7 张图；第2章架构总览、第5章第一次对话、第15章记忆系统、第16章基因胶囊写入图片引用与完整说明（四层记忆、自动化脚本、基因胶囊全功能介绍与 Mermaid 流程图）；README 增加手册目录结构与配图说明 |
 | 2026-03-12 | v2.0 | 手册重构为多文件书籍结构：6篇24章+4附录；按篇分子文件夹，每章独立 .md；覆盖全部架构、69技能、网站功能、运营规范、进阶用法 |
 | 2026-03-01 | v1.0 | 初版：单文件，目录+五组+运营中枢章节，与 SKILL_REGISTRY 对齐 |
 | 2026-02-22 | — | 使用手册独立目录：主手册与对话沉淀规则迁至 `运营中枢/使用手册/` |
--- a/运营中枢/工作台/gitea_push_log.md
+++ b/运营中枢/工作台/gitea_push_log.md
@@ -309,3 +309,4 @@
 | 2026-03-12 16:42:12 | 🔄 卡若AI 同步 2026-03-12 16:42 | 更新：Cursor规则、水桥平台对接、水溪整理归档、卡木、总索引与入口、运营中枢工作台 | 排除 >20MB: 11 个 |
 | 2026-03-12 20:17:25 | 🔄 卡若AI 同步 2026-03-12 20:17 | 更新：水桥平台对接、运营中枢参考资料、运营中枢工作台 | 排除 >20MB: 11 个 |
 | 2026-03-12 20:45:24 | 🔄 卡若AI 同步 2026-03-12 20:45 | 更新：水桥平台对接、运营中枢工作台 | 排除 >20MB: 11 个 |
+| 2026-03-12 20:55:40 | 🔄 卡若AI 同步 2026-03-12 20:55 | 更新：运营中枢、运营中枢工作台 | 排除 >20MB: 11 个 |
--- a/运营中枢/工作台/代码管理.md
+++ b/运营中枢/工作台/代码管理.md
@@ -312,3 +312,4 @@
 | 2026-03-12 16:42:12 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-12 16:42 | 更新：Cursor规则、水桥平台对接、水溪整理归档、卡木、总索引与入口、运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
 | 2026-03-12 20:17:25 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-12 20:17 | 更新：水桥平台对接、运营中枢参考资料、运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
 | 2026-03-12 20:45:24 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-12 20:45 | 更新：水桥平台对接、运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
+| 2026-03-12 20:55:40 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-12 20:55 | 更新：运营中枢、运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |