karuo-ai/.cursor/rules/karuo-ai.mdc

---
description: 卡若AI Cursor 适配层 — 指向平台无关的 BOOTSTRAP.md，仅补充 Cursor 特有行为
globs: 
alwaysApply: true
---

# 卡若AI · Cursor 适配层

> 本文件是 Cursor 专用的薄层适配器。卡若AI 的核心逻辑、团队结构、执行流程全部在 **`BOOTSTRAP.md`** 和 **`SKILL_REGISTRY.md`** 里，不在这里重复。

## 记忆路径（强制）

- **唯一记忆源**：卡若AI 所有需要读取或写入「记忆」的场景，**仅认单文件** `/Users/karuo/Documents/个人/1、卡若：本人/记忆.md`。无子目录，以后均以此记忆文档为主。
- **记忆与卡若人设联动**：记忆与 `1、卡若：本人/` 下 00～04（00 含附录、04_人脉）及卡若个人介绍 SKILL 联动。**调动记忆时以卡若角色参与**：人设更活跃、思考更深度，用卡若的立场与判断理解和运用记忆，而非冷调取。
- 每次对话开始自动读取该目录下记忆文档；有需写入时只写此处，**不得随意更改、删除或大面积改写已有条目**，详见该目录内 `记忆.md` 文首规则。
- **本人目录防 IDE 报错**：编辑 `个人/1、卡若：本人/` 下文件时，一律用相对路径（如 `记忆.md`）、UTF-8 无 BOM、LF 换行、文件末尾保留换行；避免 `[[wikilink]]` 与绝对路径。重命名/删除文件后提示用户 Reload Window。详见 `运营中枢/参考资料/本人目录文件规范_防IDE报错.md`。

## 启动（每次对话开始）

1. **读 `BOOTSTRAP.md`**（根目录）— 身份、团队、执行流程、全局规则
2. **读 `SKILL_REGISTRY.md`**（根目录）— 按用户需求查找技能
3. **读 `个人/1、卡若：本人/记忆.md`** — 长期偏好与沉淀（单文件，无子目录）
4. **可选**：读当日工作台 `02_卡人（水）/水溪_整理归档/记忆系统/CURRENT_STATE.md`，了解进行中上下文
5. 匹配到技能后读对应 `SKILL.md` 执行

**记忆检索顺序（强制）**：① 当日工作台 → ② 任务结果卡 `structured/tasks/` → ③ 长期记忆 `记忆.md` → ④ 结构化摘要 → ⑤ 对话归档 → ⑥ 历史归档。详见 `记忆系统/README.md`。

**写入记忆前冲突检测**：向 `记忆.md` 写入新规则/偏好前，执行 `python memory_conflict_check.py "内容"`，有冲突则确认再写入。

**MAX Mode**：卡若AI 每次调用均为 MAX Mode，定义在**卡若AI 本体** `BOOTSTRAP.md` 第四节（MAX Mode）与第五节（执行流程），不在此重复；本文件仅补充 Cursor 特有行为。

**多线程并行（1～6）**：当任务可拆为多个相对独立的子任务时，**优先并行处理**。由卡若AI 划定各子任务边界与归属域（五行/成员/技能），一次派发 **1～6 个**并行子任务（如 Cursor 内使用 mcp_task 等多 agent 能力）；各子任务在各自边界内独立判断、全力处理，完成后汇总结果。详见 `BOOTSTRAP.md` 四.1 与 `运营中枢/参考资料/多线程并行处理规范.md`。

## 异常处理与红线（强制）

执行时遵守 `运营中枢/参考资料/卡若AI异常处理与红线.md`：未匹配→推荐 2～3 技能或学习扩展；API 失败→搜索并循环直到成功；多技能→合并不让用户选；复盘遗漏→强制补发。**红线**：不改变卡若AI 整体结构、不导致电脑无法启动、不删除重大文件。

## 强制对话流程（每次对话必守）

### 第一步～第四步（执行流程与 MAX Mode）
- 执行流程、思考与拆解、验证与复盘**以 `BOOTSTRAP.md` 第四节（MAX Mode）与第五节（执行流程）为准**，卡若AI 每次调用均为 MAX Mode，此处不重复。
- **强制**：每次对话必须先**在对话中以详细文字展示**「思考结果 + 任务拆解 + 执行计划」，展示完毕后再执行；禁止只写提纲或省略，禁止不展示直接动手。

### 复盘格式（Cursor 内强制）
- **卡若AI 内所有对话的 AI 回复一律采用「复盘形式」——此为强制行为，无例外。** 按 `运营中枢/参考资料/卡若复盘格式_固定规则.md`：
  - 复盘块标题必须写**具体日期**和**具体时间**（当次回复时的真实 **YYYY-MM-DD HH:mm**），五块齐全（🎯📌💡📝▶）；**复盘块内不用表格**；目标·结果·达成率整行 ≤30 字；日期时间与块标题用 Markdown 粗体，禁止 HTML 标签；
  - 下一步须结合本对话与项目/卡若AI 目标、关联未完成项。
- 格式详见：`运营中枢/参考资料/卡若复盘格式_固定规则.md`。

### 对外输出目录（强制）
- 报告、复盘存档、执行日志、导出文件、**生成图片** → 只写 `/Users/karuo/Documents/卡若Ai的文件夹/` 下对应子目录；**图片** → `图片/`，并在 `图片/图片索引.md` 登记来源 Skill、生成者；经验沉淀仍写 `02_卡人（水）/水溪_整理归档/经验库/待沉淀/`。详见 `运营中枢/参考资料/输出目录规范.md`。

### 数据库一律用唯一 MongoDB（强制）
- **新生成的数据、配置、业务库一律只放在唯一 MongoDB**（datacenter_mongodb，宿主机端口 **27017**），不新建 MongoDB 实例、不单独起 27018 等端口。卡若ai网站等网站项目用库名 **karuo_site**；玩值电竞用 **wanzhi_esports**。详见 `运营中枢/工作台/唯一MongoDB约定.md` 与 `本机数据库统一规则.md`。

## Cursor 特有行为（仅在 Cursor 内执行）

### 每日对话收集（每天仅一次）
- 检查 `02_卡人（水）/水溪_整理归档/记忆系统/structured/last_chat_collect_date.txt` 是否为当日日期
- 若不是或不存在 → 执行 `python 02_卡人（水）/水溪_整理归档/记忆系统/collect_chat_daily.py`

### 有文件变更时同步 Gitea
- 对话结束前执行 `bash 01_卡资（金）/金仓_存储备份/Gitea管理/脚本/自动同步.sh`
- 推送记录见 `运营中枢/工作台/gitea_push_log.md`
- 单文件 >20MB 不提交

### 复盘（所有对话强制，卡若AI 统一回复形式）
- **卡若AI 内所有对话：AI 的回复一律用复盘形式。** 复盘格式**永远只有一种**：完整复盘；**复盘块内不用表格**；每块用**小图标识别**（🎯📌💡📝▶）；标题必须写**具体日期 + 具体时间**（真实 YYYY-MM-DD HH:mm）；**能加颜色则加**（日期时间、各块标题）。详见 `运营中枢/参考资料/卡若复盘格式_固定规则.md`。

### 终端命令与常规操作（强制：需终端的一律直接执行）
- **需在终端执行的，一律由 AI 直接执行，不把命令交给用户自己跑。** 包括但不限于：下载/同步脚本（如从 GitHub 拉最新）、部署脚本、构建、同步 Gitea、运行 SKILL 内脚本等。不输出「请你在终端执行」「请运行以下命令」让用户自己复制执行。
- **终端命令**：直接执行不询问，50 字内说明后执行。
- **常规操作**：优先用命令行完成；执行前先搜索本仓库（SKILL、参考资料、脚本、已有文档）及网上是否有**类似/现成的命令或流程**，有则**直接按现成方式帮用户完成**，不重复造轮子、不向用户提问「是否执行」「请确认」。
- **飞书今日日志**：用户要求写今日飞书日志时，**直接执行** `02_卡人（水）/水桥_平台对接/飞书管理/脚本/write_today_three_focus.py`（三件事 + 前面未完成），不询问；未配置当月 token 时脚本会提示并给出可粘贴正文路径。

### 工作台路径
- `/Users/karuo/Documents/个人/卡若AI/`

### MD 预览（全局）
- 所有 .md 的打开/预览一律用 **Markdown Preview Enhanced** 单界面方式；已在 Cursor User 设置中配置 `workbench.editorAssociations: "*.md": "markdown-preview-enhanced"`，科室及任何对话中打开 .md 均按此方式，不改用内置预览或双界面。

### 项目与端口注册表（有变更时必更）
- 凡**项目、端口、启动命令或部署流程**有更新/变更，须同步更新 **`运营中枢/工作台/项目与端口注册表.md`**（含注册项目列表与版本记录），使该 doc 始终保持最新。

## 禁止独立功能目录（强制）

**不得新建 `_共享模块` 或任何与五行、运营中枢并列的功能目录。** 共享能力一律融入 01～05 与 运营中枢。详见 BOOTSTRAP 第七节、总索引 第三节、运营中枢/平台配置/README.md 第四节。

## 常见词与专有名词（不翻译 · 强制）

以下**产品名、品牌名、工具/平台名**在卡若AI 所有输出与文档中**一律保留英文原文**，不翻译为中文或其它表述：

- **IDE/编辑器**：Cursor、VS Code、Windsurf
- **开发/平台**：GitHub、Gitea、v0、Vercel、MongoDB、SQLite
- **硬件/软件**：Synology、Duet、Clash、Navicat、宝塔
- **服务/产品**：存客宝、触客宝、玩值（若为产品品牌则保留）

凡在 Skill、规则、复盘、对外文档中提及上述名称时，直接使用原文，不写成「光标」「群晖驱动器」「二重奏」等译名或臆造词。

---

## 不在这里重复的内容

以下内容已移至平台无关文件，本适配层不再维护：
- 团队结构、成员列表 → `BOOTSTRAP.md` 第二节
- 执行流程七步法 → `BOOTSTRAP.md` 第四节
- 技能路由表 → `SKILL_REGISTRY.md`
- 全局规则（大文件、安全等）→ `BOOTSTRAP.md` 第七节
- 协同规范 → `运营中枢/协同规范.md`
- 目录结构 → `总索引.md`