diff --git a/运营中枢/使用手册/README.md b/运营中枢/使用手册/README.md new file mode 100644 index 00000000..16205f5a --- /dev/null +++ b/运营中枢/使用手册/README.md @@ -0,0 +1,94 @@ +# 卡若AI 使用手册 + +> **版本**：2.0 | **更新**：2026-03-12 +> **维护者**：卡若AI（大总管） +> **说明**：本手册以「书」的形式组织，每篇一个文件夹，每章一个 .md 文件。新增功能或优化后按章节就近更新。 + +--- + +## 序 + +卡若AI 是卡若的个人数字管家与智能大总管。它不是一个单独的 App，而是一套**身份 + 团队 + 技能 + 规则**的体系，可以加载到任何 AI 平台（Cursor、Claude、ChatGPT、API 等）中运行。 + +本手册是卡若AI 的完整使用指南——从认识它的架构，到掌握 69 个技能的使用方法，再到卡若AI 网站的全部功能，以及进阶的外网调用、并行处理、技能开发等。 + +--- + +## 总目录 + +### 第一篇 · 认识卡若AI + +| 章 | 文件 | 内容 | +|:--|:---|:---| +| 第1章 | [什么是卡若AI](第一篇_认识卡若AI/01_什么是卡若AI.md) | 身份定义、核心理念、与其他 AI 的区别 | +| 第2章 | [架构总览](第一篇_认识卡若AI/02_架构总览.md) | 五行体系、分层结构、文件组织 | +| 第3章 | [团队与角色](第一篇_认识卡若AI/03_团队与角色.md) | 5 负责人 → 14 成员 → 69 技能的完整团队 | + +### 第二篇 · 快速入门 + +| 章 | 文件 | 内容 | +|:--|:---|:---| +| 第4章 | [启动与接入](第二篇_快速入门/04_启动与接入.md) | 各平台如何加载卡若AI、启动顺序 | +| 第5章 | [第一次对话](第二篇_快速入门/05_第一次对话.md) | 对话流程、触发词、示例 | +| 第6章 | [标准命令](第二篇_快速入门/06_标准命令.md) | 所有平台通用的固定动作 | + +### 第三篇 · 五行技能详解 + +| 章 | 文件 | 内容 | +|:--|:---|:---| +| 第7章 | [金组 · 卡资](第三篇_五行技能详解/07_金组_卡资.md) | 基础设施守护：存储、备份、NAS、服务器、数据库 | +| 第8章 | [水组 · 卡人](第三篇_五行技能详解/08_水组_卡人.md) | 信息流程调度：整理归档、规划、飞书、MCP | +| 第9章 | [木组 · 卡木](第三篇_五行技能详解/09_木组_卡木.md) | 产品内容创造：视频、逆向、项目模板、PPT | +| 第10章 | [火组 · 卡火](第三篇_五行技能详解/10_火组_卡火.md) | 技术研发优化：全栈开发、代码修复、本地模型 | +| 第11章 | [土组 · 卡土](第三篇_五行技能详解/11_土组_卡土.md) | 商业复制裂变：商业分析、基因胶囊、流量、财务 | + +### 第四篇 · 运营中枢 + +| 章 | 文件 | 内容 | +|:--|:---|:---| +| 第12章 | [执行流程与 MAX Mode](第四篇_运营中枢/12_执行流程与MAX_Mode.md) | 七步执行流程、深度思考、验证机制 | +| 第13章 | [复盘格式](第四篇_运营中枢/13_复盘格式.md) | 五块复盘（🎯📌💡📝▶）的固定规则 | +| 第14章 | [异常处理与红线](第四篇_运营中枢/14_异常处理与红线.md) | 9 类异常场景处理 + 3 条红线 | +| 第15章 | [记忆系统](第四篇_运营中枢/15_记忆系统.md) | 记忆路径、读写规则、检索顺序 | +| 第16章 | [基因胶囊](第四篇_运营中枢/16_基因胶囊.md) | 技能打包、继承、pack/unpack/list | +| 第17章 | [协同与 Pipeline](第四篇_运营中枢/17_协同与Pipeline.md) | 跨组协作、三大 Pipeline | + +### 第五篇 · 卡若AI 网站 + +| 章 | 文件 | 内容 | +|:--|:---|:---| +| 第18章 | [网站总览](第五篇_卡若AI网站/18_网站总览.md) | 定位、架构、技术栈 | +| 第19章 | [官网与控制台](第五篇_卡若AI网站/19_官网与控制台.md) | 所有页面功能说明 | +| 第20章 | [API 与部署](第五篇_卡若AI网站/20_API与部署.md) | 接口清单、部署方式、端口 | + +### 第六篇 · 进阶与扩展 + +| 章 | 文件 | 内容 | +|:--|:---|:---| +| 第21章 | [外网调用与 API 网关](第六篇_进阶与扩展/21_外网调用与API网关.md) | 外网化方案、网关配置、curl 调用 | +| 第22章 | [多线程并行处理](第六篇_进阶与扩展/22_多线程并行处理.md) | 1～6 线程并行、边界划分 | +| 第23章 | [技能开发与扩展](第六篇_进阶与扩展/23_技能开发与扩展.md) | SKILL.md 标准格式、技能工厂 | +| 第24章 | [端口与数据库管理](第六篇_进阶与扩展/24_端口与数据库管理.md) | 唯一 MongoDB、端口注册表 | + +### 附录 + +| 章 | 文件 | 内容 | +|:--|:---|:---| +| 附录 A | [全量技能速查表](附录/A_全量技能速查表.md) | 69 技能一览（编号 + 触发词 + 路径） | +| 附录 B | [常用命令与脚本](附录/B_常用命令与脚本.md) | Gitea 同步、飞书日志、Docker 等 | +| 附录 C | [FAQ](附录/C_FAQ.md) | 常见问题与解答 | +| 附录 D | [更新记录](附录/D_更新记录.md) | 手册版本变更日志 | + +--- + +## 如何使用本手册 + +- **新用户**：从第一篇开始顺序阅读，了解架构后看第二篇快速上手 +- **查技能**：直接翻第三篇对应组别，或查附录 A 速查表 +- **查规范**：翻第四篇运营中枢 +- **查网站功能**：翻第五篇 +- **开发者/进阶**：翻第六篇 + +## 手册维护规则 + +每次对话后如有技能新增/变更，按 [对话沉淀与优化规则](对话沉淀与优化规则.md) 更新对应章节，并在附录 D 追加更新记录。 diff --git a/运营中枢/使用手册/卡若AI使用手册.md b/运营中枢/使用手册/卡若AI使用手册.md index 366d00b4..8d6f86c0 100644 --- a/运营中枢/使用手册/卡若AI使用手册.md +++ b/运营中枢/使用手册/卡若AI使用手册.md @@ -1,292 +1,29 @@ -# 卡若AI 使用手册 +# 卡若AI 使用手册（导航页） -> **面向**：卡若本人及任何调用卡若AI 的平台（Cursor、Claude、API 等） -> **用途**：快速了解各板块功能、触发方式与典型用法；新增/变更技能后同步更新本手册。 -> **版本**：1.0 | **更新**：2026-03-01 -> **维护**：每次对话后可沉淀经验并优化本手册，见本目录 [对话沉淀与优化规则.md](对话沉淀与优化规则.md)。 +> **本文件已升级为导航页。完整使用手册请看 [README.md](README.md)。** +> +> 手册 v2.0 采用多文件书籍结构，每篇一个文件夹、每章一个 .md 文件。 --- -## 目录 +## 快速导航 -1. [总览与入口](#一总览与入口) -2. [金组 · 卡资（基础设施守护）](#二金组--卡资基础设施守护) -3. [水组 · 卡人（信息流程调度）](#三水组--卡人信息流程调度) -4. [木组 · 卡木（产品内容创造）](#四木组--卡木产品内容创造) -5. [火组 · 卡火（技术研发优化）](#五火组--卡火技术研发优化) -6. [土组 · 卡土（商业复制裂变）](#六土组--卡土商业复制裂变) -7. [运营中枢与规范](#七运营中枢与规范) -8. [附录：技能速查与更新记录](#附录技能速查与更新记录) +- **[总目录 · README.md](README.md)** ← 从这里开始 + +### 各篇入口 + +| 篇 | 入口 | 内容 | +|:--|:---|:---| +| 第一篇 | [认识卡若AI](第一篇_认识卡若AI/01_什么是卡若AI.md) | 身份、架构、团队 | +| 第二篇 | [快速入门](第二篇_快速入门/04_启动与接入.md) | 启动、对话、标准命令 | +| 第三篇 | [五行技能详解](第三篇_五行技能详解/07_金组_卡资.md) | 金/水/木/火/土 69 技能 | +| 第四篇 | [运营中枢](第四篇_运营中枢/12_执行流程与MAX_Mode.md) | 执行流程、复盘、记忆、胶囊 | +| 第五篇 | [卡若AI网站](第五篇_卡若AI网站/18_网站总览.md) | 官网、控制台、API、部署 | +| 第六篇 | [进阶与扩展](第六篇_进阶与扩展/21_外网调用与API网关.md) | 网关、并行、技能开发、端口 | +| 附录 | [速查表](附录/A_全量技能速查表.md) / [命令](附录/B_常用命令与脚本.md) / [FAQ](附录/C_FAQ.md) / [更新记录](附录/D_更新记录.md) | 参考 | --- -## 一、总览与入口 +## 维护规则 -### 小结 - -卡若AI 是卡若的个人数字管家与智能大总管，按「五行」分为 5 个负责人、14 名成员、60+ 技能。任何平台只需读 `BOOTSTRAP.md` 与 `SKILL_REGISTRY.md` 即可接入；需求通过触发词匹配到技能后，按对应 SKILL.md 执行。 - -### 1.1 身份与工作台 - -- **名字**：卡若AI -- **工作台**：`/Users/karuo/Documents/个人/卡若AI/`（本地路径） -- **启动入口**：`BOOTSTRAP.md` — 身份、团队、执行流程、标准命令 -- **技能查找**：`SKILL_REGISTRY.md` — 按触发词查 SKILL 路径 - -### 1.2 团队结构（五行） - -| 负责人 | 口号 | 成员 | 职责 | -|:---|:---|:---|:---| -| 卡资（金） | 稳了。 | 金仓、金盾 | 存储备份、数据安全、服务器与 NAS | -| 卡人（水） | 搞定了。 | 水溪、水泉、水桥 | 整理归档、规划拆解、平台对接（飞书/小程序/MCP 等） | -| 卡木（木） | 搞起！ | 木叶、木根、木果 | 视频内容、逆向分析、项目/PPT/档案模板 | -| 卡火（火） | 让我想想… | 火炬、火锤、火眼、火种 | 全栈/前端、代码修复、智能追问、本地模型 | -| 卡土（土） | 先算账。 | 土基、土砖、土渠、土簿 | 商业分析、技能复制/基因胶囊、流量、财务 | - -### 1.3 标准命令（所有平台通用） - -| 命令 | 触发方式 | 做什么 | -|:---|:---|:---| -| 技能查找 | 用户说需求 | 查 SKILL_REGISTRY → 读对应 SKILL.md → 执行 | -| 复盘 | 所有对话强制 | AI 回复一律用复盘形式，格式见 `卡若复盘格式_固定规则.md` | -| 沉淀 | 发现有价值经验 | 写入 `水溪_整理归档/经验库/待沉淀/` | -| 基因胶囊 | 打包/解包/继承能力 | 读土砖「基因胶囊」SKILL；pack/unpack/list | -| Gitea 同步 | 有文件变更时 | `bash 金仓/Gitea管理/脚本/自动同步.sh` | -| 对外输出 | 报告/复盘/图片 | 只写 `卡若Ai的文件夹/` 下对应子目录，见输出目录规范 | - ---- - -## 二、金组 · 卡资（基础设施守护） - -### 小结 - -负责存储、备份、服务器、NAS、Gitea、数据库、系统监控等基础设施；保证「稳了」。 - -### 2.1 金仓 · 存储备份 - -| 技能 | 触发词 | 一句话 | 小节说明 | -|:---|:---|:---|:---| -| 群晖NAS管理 | NAS、群晖、Docker | NAS 部署、容器、存储池管理 | 群晖设备与 Docker 容器、存储池的部署与日常维护。 | -| Gitea管理 | Gitea、推送、Git | 代码仓库同步与管理 | 本地仓库推送到 Gitea；自动同步脚本、推送记录见工作台。 | -| 磁盘清理 | 清理磁盘、释放空间 | 查找大文件、清理缓存 | 按目录/类型查找大文件，安全释放空间。 | -| 容灾备份 | 备份、灾备 | 定时备份、异地容灾 | 定时与异地备份策略与执行。 | -| 照片分类 | 照片整理、相册 | 照片去重、按时间/地点分类 | 照片去重与按时间、地点归档。 | -| 分布式算力管控 | 算力、PCDN、节点 | 节点部署、收益监控 | PCDN 等算力节点部署与收益查看。 | -| 服务器管理 | 宝塔、部署、SSL | 宝塔面板、域名、证书 | 宝塔、域名解析、SSL 证书配置。 | -| 系统监控 | 系统状态、杀进程 | CPU/内存/磁盘实时监控 | 本机/服务器状态查看与进程管理。 | -| iPhone/iCloud/局域网/微信/数据库/文件整理 | 见 SKILL_REGISTRY | 设备备份、iCloud 优化、局域网扫描、微信分析、DB 维护、文件整理 | 各专项的备份、优化、分析、整理能力。 | - -### 2.2 金盾 · 数据安全 - -| 技能 | 触发词 | 一句话 | 小节说明 | -|:---|:---|:---|:---| -| 存客宝 | 存客宝、cunkebao | 存客宝系统维护 | 存客宝相关环境、部署与日常维护。 | -| 远程环境一键部署 | 远程部署、装Clash | 远程服务器环境配置 | 远程机 Clash 等环境一键配置。 | -| 数据库管理(安全) | 数据库、备份数据 | 数据库安全与备份 | 数据库备份与安全策略。 | -| 微信管理(安全) | 微信数据库解析 | 微信数据库解密与分析 | 微信 DB 解密与数据分析。 | -| Vercel部署 / 个人档案生成器 | Vercel、v0 / 个人档案 | Vercel v0 部署 / 安全视角个人档案 | 部署流水线与个人档案生成。 | - ---- - -## 三、水组 · 卡人（信息流程调度） - -### 小结 - -负责整理归档、规划拆解、平台对接（飞书、小程序、MCP、Excel 等）；保证「搞定了」。 - -### 3.1 水溪 · 整理归档 - -| 技能 | 触发词 | 一句话 | 小节说明 | -|:---|:---|:---|:---| -| 文件整理 | 整理文件、外置硬盘 | 文件分类、去重、归档 | 大规模文件按规则分类、去重与归档。 | -| 文档清洗 | PDF转Markdown | PDF/Word 转结构化 Markdown | 将 PDF/Word 转为可编辑的 Markdown。 | -| 对话归档 | 归档今日对话 | AI 对话记录收集与归类 | 按日或按主题收集、归类对话。 | -| 项目调研 | 项目调研、平台分析、A群、聊天记录清理、按项目归档等 | 平台分析/项目调研/各 APP 资料统一归档 | 调研资料、群聊、对话按项目归档到 开发/7.项目调研。 | -| 自动记忆管理 | 记忆、存入记忆 | 长期记忆写入与检索 | 重要信息写入长期记忆并支持检索。 | - -### 3.2 水泉 · 规划拆解 - -| 技能 | 触发词 | 一句话 | 小节说明 | -|:---|:---|:---|:---| -| 需求拆解与计划制定 | 需求拆解、任务分析 | 大需求拆成可执行步骤 | 把大需求拆成可执行子任务与顺序。 | -| 任务规划 | 任务规划、制定计划 | 制定执行计划与排期 | 排期与里程碑规划。 | - -### 3.3 水桥 · 平台对接 - -| 技能 | 触发词 | 一句话 | 小节说明 | -|:---|:---|:---|:---| -| 飞书管理 | 飞书日志、写入飞书、卡若飞书日志、日志运营报表登记 | 飞书日志/文档自动化 | 一键写日志、月份路由、TNTWF 规范；Wiki 子文档、**统一文章上传**（MD→飞书，同名更新、表格/配图）。 | -| 智能纪要 | 会议纪要、飞书妙记、妙记下载、指定场次、批量下载妙记 | 会议录音→纪要；飞书妙记下载 | 会议转纪要；飞书妙记单条/批量下载。 | -| 小程序管理 | 小程序、微信小程序 | 微信小程序发布与维护 | 小程序版本与发布管理。 | -| Soul创业实验 | Soul 文章、派对写文章、第9章、运营报表、派对填表/纪要 | 写作+上传+运营报表统一入口 | Soul 相关写作、上传与派对报表一条龙。 | -| Soul派对运营报表 | 运营报表、派对填表、派对截图填表发群、本月运营数据 | 派对截图+TXT→飞书报表→发群 | 派对数据填表、发飞书群。 | -| MCP 搜索与连接 | MCP、找MCP、连接MCP、MCP安装、查MCP | 搜索 MCP→生成配置→写入 Cursor 等 | 发现并安装 MCP 到 Cursor/Claude。 | -| Excel表格与日报 | Excel写飞书、CSV写飞书、日报图表发飞书 | 本地 Excel/CSV→飞书表格→日报图表 | 表格与日报上飞书。 | -| 卡猫复盘 / 接收短信 | 卡猫复盘、婼瑄复盘 / 接收短信、接码、拿短信 | 复盘到卡猫群 / 英国临时号收短信 | 复盘发卡猫群；receivesms 取号与抓短信。 | - ---- - -## 四、木组 · 卡木（产品内容创造） - -### 小结 - -负责视频、逆向、项目与内容模板（PPT、档案、画图等）；保证「搞起」。 - -### 4.1 木叶 · 视频内容 - -| 技能 | 触发词 | 一句话 | 小节说明 | -|:---|:---|:---|:---| -| 视频切片 | 视频剪辑、切片发布、切片动效包装、片头片尾、批量封面 | 长视频切片+字幕+发布；联动动效包装 | 切片、字幕、片头片尾与批量封面。 | -| 抖音视频解析 | 抖音链接、抖音解析、抖音下载、抖音无水印 | 链接→解析→文案+无水印下载 | 根据抖音链接解析并下载。 | -| 抖音发布 | 抖音发布、抖音登录、抖音上传、腕推抖音 | OAuth 登录+上传/发布；可对接腕推/存客宝 | 抖音开放平台发布流程。 | - -### 4.2 木根 · 逆向分析 - -| 技能 | 触发词 | 一句话 | 小节说明 | -|:---|:---|:---|:---| -| 网站逆向分析 | 逆向分析、模拟登录 | 网站 API 分析、SDK 生成 | 分析网站接口与生成调用方式。 | - -### 4.3 木果 · 项目模板 - -| 技能 | 触发词 | 一句话 | 小节说明 | -|:---|:---|:---|:---| -| 项目生成 / 开发模板 | 生成项目、五行模板 / 创建项目、初始化模板 | 按五行模板生成项目 / 前后端模板库 | 新项目脚手架与模板选择。 | -| 个人档案生成器 / 卡若个人介绍 | 个人档案、档案生成 / 卡若介绍、个人介绍、卡若人设 | 个人介绍档案 / 卡若人设（PPT/短文/一页纸） | 生成个人或卡若介绍内容。 | -| PPT制作 | PPT、做PPT、制作PPT、汇报PPT | python-pptx 创建/编辑 .pptx | 自动生成或编辑 PPT，输出到报告目录。 | -| Next AI Draw | next ai draw、AI画图、架构图、流程图 | AI 生成 draw.io/Mermaid 图，与 PPT 联动 | 画架构图、流程图。 | -| 前端生成 | 前端生成、UI | 快速生成前端页面 | 按描述生成前端界面。 | - ---- - -## 五、火组 · 卡火（技术研发优化） - -### 小结 - -负责全栈/前端、代码修复、追问、本地模型与知识类能力；保证「让我想想」后有结果。 - -### 5.1 火炬 · 全栈消息 - -| 技能 | 触发词 | 一句话 | 小节说明 | -|:---|:---|:---|:---| -| 全栈开发 | 卡若AI官网、官网开发、全站开发、开发文档、1～10 | 全栈+官网/全站+开发文档 1～10 | 官网与全站开发、开发文档编写与维护。 | -| 前端开发 | 前端开发、毛玻璃、神射手风格、毛狐狸风格、苹果毛玻璃 | 苹果毛玻璃风格+前端标准 | 官网/全站前端风格与标准。 | -| 消息中枢 | WhatsApp、Telegram | 多平台消息聚合 | 多 IM 平台消息汇总。 | -| 读书笔记 / 文档清洗 | 拆解这本书、五行拆书 / 文档清洗、PDF转MD | 五行拆书 / 批量文档格式转换 | 读书拆解与文档格式转换。 | -| 开发文档操控 | 开发文档操控、1～10文档、网站开发文档 | 按 1～10 操控任意站开发文档 | 多站开发文档统一维护。 | -| 上帝之眼 / 量化/对话归档 | 监控、上帝之眼 / 量化、交易 / 对话归档 | 全局监控与看板 / 量化与回测 / 技术对话归档 | 监控、量化与归档能力。 | -| 本地项目启动 | 本地运行、启动玩值电竞、指定端口、Docker部署、同步到Docker | 按端口表启动；Docker 部署与同步 | 本机服务与 Docker 部署、更新同步。 | - -### 5.2 火锤 · 代码修复 - -| 技能 | 触发词 | 一句话 | 小节说明 | -|:---|:---|:---|:---| -| 代码修复 | 代码修复、Bug | 定位 Bug 并修复 | 根据报错或现象定位并改代码。 | - -### 5.3 火眼 · 智能追问 - -| 技能 | 触发词 | 一句话 | 小节说明 | -|:---|:---|:---|:---| -| 智能追问 | 追问模式、需求澄清 | 通过追问澄清模糊需求 | 在需求不清时主动追问并收敛。 | - -### 5.4 火种 · 知识模型 - -| 技能 | 触发词 | 一句话 | 小节说明 | -|:---|:---|:---|:---| -| 读书笔记(模型) / 本地模型 | 五行拆书 / ollama、qwen、本地AI | 本地模型辅助拆书 / Ollama 等本地部署 | 本地模型与拆书结合。 | -| 本地代码库索引 | 本地索引、本地搜索、不上传云端 | 本地 embedding 与语义检索 | 代码库本地索引与检索。 | -| 卡若日记写作 | 日记、写日记 | 每日日记自动生成 | 按模板生成日记。 | - ---- - -## 六、土组 · 卡土（商业复制裂变） - -### 小结 - -负责商业分析、技能复制与基因胶囊、流量、财务；保证「先算账」可落地。 - -### 6.1 土基 · 商业分析 - -| 技能 | 触发词 | 一句话 | 小节说明 | -|:---|:---|:---|:---| -| 商业工具集 | 商业分析、竞品 | 竞品分析、商业画布 | 竞品与画布类分析。 | - -### 6.2 土砖 · 技能复制 - -| 技能 | 触发词 | 一句话 | 小节说明 | -|:---|:---|:---|:---| -| 技能工厂 | 创建技能、生成Skill | 批量创建/复制 SKILL | 按模板批量生成或复制技能文档。 | -| 基因胶囊 | 基因胶囊、打包技能、解包胶囊、继承能力、查胶囊、pack-all | Skill 打包为可遗传胶囊，pack/unpack/list | 将 Skill 打包成胶囊、解包继承、列表查询。 | - -### 6.3 土渠 · 流量招商 - -| 技能 | 触发词 | 一句话 | 小节说明 | -|:---|:---|:---|:---| -| 流量自动化 | 刷流量、SEO | SEO、流量投放自动化 | 流量与 SEO 相关自动化。 | -| 手机流量自动操作 | 手机自动化、AutoGLM | 手机 App 自动化操作 | 手机端自动化与引流。 | - -### 6.4 土簿 · 财务管理 - -| 技能 | 触发词 | 一句话 | 小节说明 | -|:---|:---|:---|:---| -| 财务管理 / 公司财务 / 家庭财务 | 财务、报表、银行 / 公司财务、芸归喜、卡卡猫 / 家庭财务、鲨鱼记账 | 收支与报表 / 公司收支与工资表 / 家庭收支 | 统一财务、公司、家庭分账与报表。 | -| 商业工具集(财务) | 商业分析 | 财务视角的商业分析 | 从财务角度做商业分析。 | - ---- - -## 七、运营中枢与规范 - -### 小结 - -运营中枢提供协同规范、参考资料、工作台、技能控制台与 Pipeline；所有对话须遵守复盘、输出目录、异常处理与红线。 - -### 7.1 协同与流程 - -| 内容 | 路径 | 小节说明 | -|:---|:---|:---| -| 协同规范 | `运营中枢/协同规范.md` | 多成员、跨组协作时的分工与约定。 | -| 执行流程与 MAX Mode | BOOTSTRAP 第四、五节 | 先思考并展示拆解→执行→验证→复盘；可 1～6 线程并行。 | -| Pipeline 执行清单 | `运营中枢/参考资料/Pipeline执行清单.md` | 新项目上线、内容发布、日常运维等步骤与 SKILL 路径。 | - -### 7.2 参考资料（必守） - -| 文档 | 用途 | -|:---|:---| -| 卡若复盘格式_固定规则.md | 每轮/每步结尾完整复盘格式（🎯📌💡📝▶）。 | -| 输出目录规范.md | 报告/复盘/图片/导出只写 `卡若Ai的文件夹/` 下对应子目录。 | -| 卡若AI异常处理与红线.md | 未匹配推荐技能、API 失败重试、多技能合并、三条红线。 | -| 卡若AI架构说明.md | 带图的架构说明。 | -| 本目录 [对话沉淀与优化规则.md](对话沉淀与优化规则.md) | 每次对话后如何沉淀、如何更新本手册与 Skill。 | - -### 7.3 工作台与技能控制 - -| 内容 | 路径 | 小节说明 | -|:---|:---|:---| -| 当前任务看板 | `运营中枢/工作台/当前任务看板.md` | 跨组/接续任务时查看上下文。 | -| 技能控制台 | `运营中枢/工作台/01_技能控制台.md` | 技能配置、安装、删除、掌管人登记。 | -| Gitea 推送记录 | `运营中枢/工作台/gitea_push_log.md` | 自动同步脚本的推送结果。 | -| 端口登记 | 工作台 端口登记 SKILL | 本机/Docker 端口统一登记，防冲突。 | - ---- - -## 附录：技能速查与更新记录 - -### 技能速查 - -- **按触发词查技能**：直接打开 `SKILL_REGISTRY.md` 搜索触发词，找到对应 SKILL 路径后阅读执行。 -- **按板块查**：本手册第二～六章按金/水/木/火/土列出各技能与小节说明。 -- **基因胶囊**：全量胶囊清单与用法见 `卡若Ai的文件夹/导出/基因胶囊/README_基因胶囊导出说明.md` 或 `gene_capsule.py list`。 - -### 手册更新记录 - -| 日期 | 变更说明 | -|:---|:---| -| 2026-03-01 | 初版：目录、五组+运营中枢章节、各节小结；与 SKILL_REGISTRY 对齐（65 技能）。 | -| 2026-02-22 | 使用手册独立目录：主手册与对话沉淀与优化规则迁至 `运营中枢/使用手册/`，与参考资料分离。 | - -### 新增/变更技能时的手册更新 - -1. 在 `SKILL_REGISTRY.md` 中新增或修改技能行。 -2. 在本手册对应章节（第二～六章）的表格中新增或修改一行，填写「技能、触发词、一句话、小节说明」。 -3. 若新增板块或负责人，在「总览与入口」和对应新章中补充。 -4. 在「附录 · 手册更新记录」中追加一行变更说明与日期。 -5. 对话后按本目录《对话沉淀与优化规则》做沉淀与优化。 +每次有技能新增/变更时，按 [对话沉淀与优化规则](对话沉淀与优化规则.md) 更新对应章节。 diff --git a/运营中枢/使用手册/对话沉淀与优化规则.md b/运营中枢/使用手册/对话沉淀与优化规则.md index b7912e52..f77806a3 100644 --- a/运营中枢/使用手册/对话沉淀与优化规则.md +++ b/运营中枢/使用手册/对话沉淀与优化规则.md @@ -1,7 +1,7 @@ # 卡若AI 使用手册 · 对话沉淀与优化规则 -> **强制**：每次对话结束后，除完成「复盘」外，须按本规则做**沉淀**与**使用手册优化**（若有适用项）。 -> **版本**：1.0 | **更新**：2026-03-01 +> **强制**：每次对话结束后，除完成「复盘」外，须按本规则做**沉淀**与**使用手册优化**（若有适用项）。 +> **版本**：2.0 | **更新**：2026-03-12 --- @@ -18,57 +18,63 @@ 若本次对话中有**可复用经验**（新踩坑、新解法、配置要点、与某 Skill 相关的实操结论等）： -1. **写入**：`02_卡人（水）/水溪_整理归档/经验库/待沉淀/` -2. **命名**：`YYYY-MM-DD_主题或技能名_简短描述.md` +1. **写入**：`02_卡人（水）/水溪_整理归档/经验库/待沉淀/` +2. **命名**：`YYYY-MM-DD_主题或技能名_简短描述.md` 3. **内容建议**：问题背景、做法、结果、适用场景、相关 Skill 或文档路径。 ### 2.2 技能与注册表更新 若本次对话中**新增了技能**或**变更了某技能**（触发词、路径、能力描述）： -1. **SKILL_REGISTRY.md**：新增或修改对应技能行（触发词、路径、一句话）。 -2. **对应 SKILL.md**：新增则新建并写全；变更则修改步骤、用法、注意点。 +1. **SKILL_REGISTRY.md**：新增或修改对应技能行（触发词、路径、一句话）。 +2. **对应 SKILL.md**：新增则新建并写全；变更则修改步骤、用法、注意点。 3. **技能控制台**（若有）：按 `运营中枢/工作台/01_技能控制台.md` 做配置/登记。 --- ## 三、使用手册优化（有条件执行） -在**同一轮对话收尾**或**后续一次专门维护**中，按下列情况更新《卡若AI使用手册》： +在**同一轮对话收尾**或**后续一次专门维护**中，按下列情况更新使用手册： + +> **手册 v2.0 为多文件书籍结构**，总目录在 `README.md`，每篇一个子文件夹，每章一个 .md。 | 情况 | 动作 | |:---|:---| -| 新增了技能 | 在手册第二～六章对应组的表格中**新增一行**（技能、触发词、一句话、小节说明）；附录「手册更新记录」追加一行。 | -| 某技能触发词/职责变更 | 在手册对应章节表格中**修改该行**；必要时改「小节说明」；附录追加更新记录。 | -| 新增了板块或负责人 | 在「一、总览与入口」与对应新章中**补充**；附录追加更新记录。 | -| 运营中枢新增/变更规范或文档 | 在「七、运营中枢与规范」中**补充或修改**；附录追加更新记录。 | -| 本次对话产出了手册某节的更准确描述 | 直接**替换**该节「小节说明」或相关段落；附录追加更新记录。 | +| 新增了技能 | 在**第三篇对应组章节**（第7～11章）的技能表中新增一行；在**附录 A 速查表**中新增；**附录 D 更新记录**追加一行 | +| 某技能触发词/职责变更 | 修改**第三篇对应章节**的表格行；**附录 A** 同步修改；**附录 D** 追加更新记录 | +| 新增了板块或负责人 | 在**第3章（团队与角色）**和**对应新章**中补充；**附录 D** 追加 | +| 运营中枢新增/变更规范 | 在**第四篇对应章节**（第12～17章）中补充或修改；**附录 D** 追加 | +| 网站功能新增/变更 | 在**第五篇对应章节**（第18～20章）中补充或修改；**附录 D** 追加 | +| 本次对话产出了更准确描述 | 直接替换对应章节段落；**附录 D** 追加 | ### 3.1 手册文件位置 -- **主手册**：`运营中枢/使用手册/卡若AI使用手册.md` +- **总目录**：`运营中枢/使用手册/README.md` +- **导航页**：`运营中枢/使用手册/卡若AI使用手册.md` - **本规则**：`运营中枢/使用手册/对话沉淀与优化规则.md` +- **各章节**：`运营中枢/使用手册/第X篇_XXX/XX_章节名.md` +- **附录**：`运营中枢/使用手册/附录/` -### 3.2 附录更新记录格式 +### 3.2 更新记录格式 -在手册文末「附录 · 手册更新记录」表格中追加： +在 `附录/D_更新记录.md` 表格中追加： ```text -| YYYY-MM-DD | 变更说明（如：新增 xx 技能；更新第 x 章 xx 小节）。 | +| YYYY-MM-DD | vX.X | 变更说明（如：新增 xx 技能到第8章；更新第19章控制台说明）| ``` --- ## 四、流程小结（每次对话结尾检查） -1. **复盘**：已按 `运营中枢/参考资料/卡若复盘格式_固定规则.md` 输出完整复盘块。 -2. **沉淀**：若有可复用经验 → 已写入 `经验库/待沉淀/`；若涉及技能新增/变更 → 已更新 SKILL_REGISTRY 与对应 SKILL.md。 -3. **手册**：若有技能/板块/规范新增或变更，或手册某节需更正 → 已更新 `运营中枢/使用手册/卡若AI使用手册.md` 对应处并追加附录更新记录。 +1. **复盘**：已按 `运营中枢/参考资料/卡若复盘格式_固定规则.md` 输出完整复盘块。 +2. **沉淀**：若有可复用经验 → 已写入 `经验库/待沉淀/`；若涉及技能新增/变更 → 已更新 SKILL_REGISTRY 与对应 SKILL.md。 +3. **手册**：若有技能/板块/规范/网站功能新增或变更 → 已更新对应章节并追加附录 D 更新记录。 4. **Gitea**：若有文件变更 → 执行 `bash 01_卡资（金）/金仓_存储备份/Gitea管理/脚本/自动同步.sh`（单文件 >20MB 不提交）。 --- ## 五、与 BOOTSTRAP / 总索引 的衔接 -- **标准命令**（BOOTSTRAP 第六节）已包含「沉淀」；本规则把「使用手册优化」与「每次对话」明确绑定。 +- **标准命令**（BOOTSTRAP 第六节）已包含「沉淀」；本规则把「使用手册优化」与「每次对话」明确绑定。 - **总索引** 中已增加「使用手册」入口，便于任何 AI 或用户找到手册与本规则。 diff --git a/运营中枢/使用手册/第一篇_认识卡若AI/01_什么是卡若AI.md b/运营中枢/使用手册/第一篇_认识卡若AI/01_什么是卡若AI.md new file mode 100644 index 00000000..3a2d3a27 --- /dev/null +++ b/运营中枢/使用手册/第一篇_认识卡若AI/01_什么是卡若AI.md @@ -0,0 +1,54 @@ +# 第1章 · 什么是卡若AI + +> 返回 [总目录](../README.md) + +--- + +## 1.1 一句话定义 + +**卡若AI 是卡若的个人数字管家与智能大总管。** + +它不是一个独立的 App 或网站，而是一套可以加载到任何 AI 平台中运行的「身份 + 团队 + 技能 + 规则」体系。 + +## 1.2 核心理念 + +| 理念 | 说明 | +|:---|:---| +| **五行分工** | 按金、水、木、火、土划分五大职能域，各司其职 | +| **技能驱动** | 69 个标准化技能（SKILL.md），按触发词匹配、按步骤执行 | +| **平台无关** | 任何 AI（Cursor、Claude、ChatGPT、API）读 BOOTSTRAP.md 即可接入 | +| **自我进化** | 每次对话后沉淀经验、更新技能，越用越聪明 | + +## 1.3 与其他 AI 的关系 + +卡若AI **不替代** ChatGPT、Claude 或 Cursor，而是**运行在它们之上**： + +``` +用户 → 任何 AI 平台 → 加载卡若AI 规则 → 按五行团队分工执行 +``` + +- 在 **Cursor** 中：`.cursor/rules/` 自动加载，无需额外配置 +- 在 **其他 AI** 中：对话开头粘贴 BOOTSTRAP.md 内容即可 +- 通过 **API**：调用 `POST https://kr-ai.quwanzhi.com/v1/chat` + +## 1.4 能做什么 + +卡若AI 覆盖五大领域的 69 项能力： + +- **基础设施**：NAS、服务器、备份、数据库、系统监控 +- **信息流程**：文件整理、飞书自动化、MCP 搜索、运营报表 +- **内容创造**：视频切片、多平台分发、PPT、架构图 +- **技术研发**：全栈开发、代码修复、本地模型、项目启动 +- **商业裂变**：商业分析、基因胶囊、流量自动化、财务管理 + +## 1.5 核心文件 + +| 文件 | 作用 | +|:---|:---| +| `BOOTSTRAP.md` | 唯一启动入口：身份、团队、流程、规则 | +| `SKILL_REGISTRY.md` | 技能注册表：69 技能按触发词查找 | +| `总索引.md` | 架构全貌与目录导航（参考用） | + +--- + +> 下一章：[第2章 · 架构总览](02_架构总览.md) diff --git a/运营中枢/使用手册/第一篇_认识卡若AI/02_架构总览.md b/运营中枢/使用手册/第一篇_认识卡若AI/02_架构总览.md new file mode 100644 index 00000000..979517a8 --- /dev/null +++ b/运营中枢/使用手册/第一篇_认识卡若AI/02_架构总览.md @@ -0,0 +1,82 @@ +# 第2章 · 架构总览 + +> 返回 [总目录](../README.md) | 上一章 [第1章](01_什么是卡若AI.md) + +--- + +## 2.1 分层架构 + +``` +┌─────────────────────────────────────────────┐ +│ 用户（卡若本人） │ +├─────────────────────────────────────────────┤ +│ AI 平台层（Cursor / Claude / API） │ +├─────────────────────────────────────────────┤ +│ 卡若AI 规则层（BOOTSTRAP + 规则） │ +├─────────────────────────────────────────────┤ +│ 大总管（任务理解 → 分配 → 验证） │ +├──────┬──────┬──────┬──────┬──────────────────┤ +│ 金 │ 水 │ 木 │ 火 │ 土 │ +│ 卡资 │ 卡人 │ 卡木 │ 卡火 │ 卡土 │ +├──────┴──────┴──────┴──────┴──────────────────┤ +│ 运营中枢（协同 / 记忆 / 规范 / 工具） │ +├─────────────────────────────────────────────┤ +│ 基础设施（NAS / 服务器 / 数据库 / Git） │ +└─────────────────────────────────────────────┘ +``` + +## 2.2 五行体系 + +五行不只是命名，它定义了**职责边界**和**优先级顺序**： + +| 行 | 负责人 | 口号 | 职责域 | 优先级 | +|:--|:---|:---|:---|:--:| +| 金 | 卡资 | 稳了。 | 基础设施守护 | 1（最高） | +| 水 | 卡人 | 搞定了。 | 信息流程调度 | 2 | +| 木 | 卡木 | 搞起！ | 产品内容创造 | 3 | +| 火 | 卡火 | 让我想想… | 技术研发优化 | 4 | +| 土 | 卡土 | 先算账。 | 商业复制裂变 | 5 | + +多技能匹配时按 **金 → 水 → 木 → 火 → 土** 优先级执行。 + +## 2.3 任务流转 + +``` +用户输入 → 大总管理解 → 查 SKILL_REGISTRY 匹配技能 + → 按五行优先级分配给负责人 → 负责人派给成员 + → 成员读 SKILL.md 执行 → 验证结果 → 交付 + 复盘 + → 经验沉淀到参考资料 / 经验库 +``` + +## 2.4 目录结构 + +``` +卡若AI/ +├── BOOTSTRAP.md ← 启动入口 +├── SKILL_REGISTRY.md ← 技能注册表 +├── 总索引.md ← 架构参考 +├── 01_卡资（金）/ ← 金组技能目录 +├── 02_卡人（水）/ ← 水组技能目录 +├── 03_卡木（木）/ ← 木组技能目录 +├── 04_卡火（火）/ ← 火组技能目录 +├── 05_卡土（土）/ ← 土组技能目录 +└── 运营中枢/ ← 共享支撑（规范/工具/工作台） +``` + +每个技能以 `SKILL.md` 为执行文件，放在对应成员目录下。 + +## 2.5 架构图 + +三张核心架构图存放在 `/Users/karuo/Documents/卡若Ai的文件夹/图片/`： + +| 图 | 说明 | +|:---|:---| +| `人设架构图.png` | 运作流程 + 大总管与五行 + 成员与技能 | +| `团队工作流程图.png` | 任务从输入到沉淀的完整流转 | +| `卡若AI核心功能介绍流程图.png` | 五角色能力分布 | + +详见 `运营中枢/参考资料/卡若AI架构说明.md`。 + +--- + +> 下一章：[第3章 · 团队与角色](03_团队与角色.md) diff --git a/运营中枢/使用手册/第一篇_认识卡若AI/03_团队与角色.md b/运营中枢/使用手册/第一篇_认识卡若AI/03_团队与角色.md new file mode 100644 index 00000000..2f86447e --- /dev/null +++ b/运营中枢/使用手册/第一篇_认识卡若AI/03_团队与角色.md @@ -0,0 +1,72 @@ +# 第3章 · 团队与角色 + +> 返回 [总目录](../README.md) | 上一章 [第2章](02_架构总览.md) + +--- + +## 3.1 团队全景 + +``` +卡若AI（大总管） +├── 卡资（金）── 金仓（存储备份）、金盾（数据安全） +├── 卡人（水）── 水溪（整理归档）、水泉（规划拆解）、水桥（平台对接） +├── 卡木（木）── 木叶（视频内容）、木根（逆向分析）、木果（项目模板） +├── 卡火（火）── 火炬（全栈消息）、火锤（代码修复）、火眼（智能追问）、火种（知识模型） +└── 卡土（土）── 土基（商业分析）、土砖（技能复制）、土渠（流量招商）、土簿（财务管理） +``` + +**统计**：5 负责人 → 14 成员 → 69 技能 + +## 3.2 各组职责 + +### 金组 · 卡资 — 基础设施守护 + +保证底层稳定：NAS、服务器、Gitea、备份、数据库、系统监控、设备管理。 + +- **金仓**（存储备份）：NAS 管理、Gitea、磁盘清理、容灾备份、照片分类、算力管控、服务器、系统监控、iPhone/iCloud/局域网/微信/数据库/文件整理（14 技能） +- **金盾**（数据安全）：存客宝、远程部署、数据库安全、微信安全、Vercel 部署、个人档案（7 技能） + +### 水组 · 卡人 — 信息流程调度 + +管理信息流转：归档、规划、飞书、MCP、运营报表、短信。 + +- **水溪**（整理归档）：文件整理、文档清洗、对话归档、项目调研、自动记忆管理（5 技能） +- **水泉**（规划拆解）：需求拆解、任务规划（2 技能） +- **水桥**（平台对接）：飞书管理、智能纪要、小程序、Soul 创业实验、运营报表、MCP、Excel 日报、卡猫复盘、接收短信（9 技能） + +### 木组 · 卡木 — 产品内容创造 + +负责内容生产：视频、逆向、模板、PPT、画图。 + +- **木叶**（视频内容）：视频切片、抖音解析、抖音/B站/视频号/小红书/快手发布、多平台分发（8 技能） +- **木根**（逆向分析）：网站逆向分析（1 技能） +- **木果**（项目模板）：项目生成、开发模板、个人档案、PPT 制作、AI Draw、卡若个人介绍、前端生成（7 技能） + +### 火组 · 卡火 — 技术研发优化 + +技术核心：全栈、修复、追问、知识模型。 + +- **火炬**（全栈消息）：全栈开发、前端开发、全栈测试、消息中枢、读书笔记、文档清洗、开发文档操控、上帝之眼、量化交易、对话归档、本地项目启动（11 技能） +- **火锤**（代码修复）：代码修复（1 技能） +- **火眼**（智能追问）：智能追问（1 技能） +- **火种**（知识模型）：读书笔记、本地模型、本地代码库索引、卡若日记写作（4 技能） + +### 土组 · 卡土 — 商业复制裂变 + +管商业与财务：分析、复制、流量、记账。 + +- **土基**（商业分析）：商业工具集（1 技能） +- **土砖**（技能复制）：技能工厂、全站捆绑分销体系、基因胶囊（3 技能） +- **土渠**（流量招商）：流量自动化、手机流量自动操作（2 技能） +- **土簿**（财务管理）：财务管理、公司财务、家庭财务、商业工具集（4 技能） + +## 3.3 分配规则 + +1. 用户说需求 → 大总管按关键词匹配技能 +2. 按 金→水→木→火→土 优先级分配 +3. 负责人派给对应成员 → 成员读 SKILL.md 执行 +4. 用户可用 `@成员名` 指定（如 `@火炬 全栈开发`） + +--- + +> 下一篇：[第二篇 · 快速入门](../第二篇_快速入门/04_启动与接入.md) diff --git a/运营中枢/使用手册/第三篇_五行技能详解/07_金组_卡资.md b/运营中枢/使用手册/第三篇_五行技能详解/07_金组_卡资.md new file mode 100644 index 00000000..1d18e1ed --- /dev/null +++ b/运营中枢/使用手册/第三篇_五行技能详解/07_金组_卡资.md @@ -0,0 +1,51 @@ +# 第7章 · 金组 · 卡资 — 基础设施守护 + +> 返回 [总目录](../README.md) | 口号："稳了。" + +--- + +## 7.1 职责概述 + +金组负责一切基础设施：存储、备份、服务器、NAS、数据库、网络、设备管理、数据安全。保证底层稳定，让其他四组无后顾之忧。 + +## 7.2 金仓 · 存储备份（14 技能） + +| 编号 | 技能 | 触发词 | 做什么 | +|:--|:---|:---|:---| +| G01 | 群晖NAS管理 | NAS、群晖、Docker | NAS 部署、Docker 容器、存储池，内网 192.168.1.201 | +| G02 | Gitea管理 | Gitea、推送、Git | 代码仓库同步，自动同步脚本 | +| G03 | 磁盘清理 | 清理磁盘、释放空间 | 按目录/类型查大文件，安全释放 | +| G04 | 容灾备份 | 备份、灾备 | 定时与异地备份策略 | +| G05 | 照片分类 | 照片整理、相册 | 照片去重、按时间/地点归档 | +| G06 | 分布式算力管控 | 算力、PCDN、节点 | PCDN 节点部署与收益监控 | +| G07 | 服务器管理 | 宝塔、部署、SSL | 宝塔面板、域名、证书配置 | +| G08 | 系统监控 | 系统状态、杀进程 | CPU/内存/磁盘实时监控 | +| G09 | iPhone管理 | iPhone备份、连接 | iPhone 数据备份与同步 | +| G10 | 局域网控制 | 设备管理、局域网扫描 | 局域网设备发现与管理 | +| G11 | iCloud管理 | iCloud优化、排除目录 | iCloud 空间优化 | +| G12 | 微信管理 | 微信分析、RFM | 微信数据分析与标签管理 | +| G13 | 数据库管理 | MySQL、清理数据库 | 数据库日常维护与优化 | +| G14 | 文件整理 | 整理文件、外置硬盘 | 大规模文件分类整理 | + +## 7.3 金盾 · 数据安全（7 技能） + +| 编号 | 技能 | 触发词 | 做什么 | +|:--|:---|:---|:---| +| G15 | 存客宝 | 存客宝、cunkebao | 存客宝系统环境维护 | +| G16 | 远程环境一键部署 | 远程部署、装Clash | 远程服务器环境一键配置 | +| G17 | 数据库管理(安全) | 数据库、备份数据 | 数据库备份与安全策略 | +| G18 | 微信管理(安全) | 微信数据库解析 | 微信 DB 解密与分析 | +| G19 | Vercel部署 | Vercel、v0 | Vercel/v0 一键部署流水线 | +| G19b | 存客宝副本管理 | 存客宝副本、副本代码 | 存客宝副本代码与开发文档管理 | +| G20 | 个人档案生成器 | 个人档案 | 安全视角个人档案生成 | + +## 7.4 使用场景 + +- "NAS 上的 Docker 容器挂了" → G01 群晖NAS管理 +- "服务器 SSL 证书过期" → G07 服务器管理 +- "磁盘快满了" → G03 磁盘清理 +- "把代码推到 Gitea" → G02 Gitea管理 + +--- + +> 下一章：[第8章 · 水组 · 卡人](08_水组_卡人.md) diff --git a/运营中枢/使用手册/第三篇_五行技能详解/08_水组_卡人.md b/运营中枢/使用手册/第三篇_五行技能详解/08_水组_卡人.md new file mode 100644 index 00000000..85b1b41d --- /dev/null +++ b/运营中枢/使用手册/第三篇_五行技能详解/08_水组_卡人.md @@ -0,0 +1,52 @@ +# 第8章 · 水组 · 卡人 — 信息流程调度 + +> 返回 [总目录](../README.md) | 口号："搞定了。" + +--- + +## 8.1 职责概述 + +水组管理信息的流转与调度：文件整理、文档清洗、对话归档、需求拆解、任务规划、飞书对接、运营报表、MCP 搜索等。保证信息清清爽爽。 + +## 8.2 水溪 · 整理归档（5 技能） + +| 编号 | 技能 | 触发词 | 做什么 | +|:--|:---|:---|:---| +| W01 | 文件整理 | 整理文件、外置硬盘 | 大规模文件按规则分类、去重、归档 | +| W02 | 文档清洗 | PDF转Markdown | PDF/Word 转结构化 Markdown | +| W03 | 对话归档 | 归档今日对话 | AI 对话记录收集与归类 | +| W03a | 项目调研 | 项目调研、平台分析、聊天记录清理 | 调研资料按项目归档到 开发/7.项目调研 | +| W04 | 自动记忆管理 | 记忆、存入记忆 | 长期记忆写入与检索 | + +## 8.3 水泉 · 规划拆解（2 技能） + +| 编号 | 技能 | 触发词 | 做什么 | +|:--|:---|:---|:---| +| W05 | 需求拆解与计划制定 | 需求拆解、任务分析 | 大需求拆成可执行步骤 | +| W06 | 任务规划 | 任务规划、制定计划 | 排期与里程碑规划 | + +## 8.4 水桥 · 平台对接（9 技能） + +| 编号 | 技能 | 触发词 | 做什么 | +|:--|:---|:---|:---| +| W07 | 飞书管理 | 飞书日志、写入飞书 | 一键写日志、文档上传、Token 管理 | +| W08 | 智能纪要 | 会议纪要、飞书妙记 | 会议录音转纪要，飞书妙记下载 | +| W09 | 小程序管理 | 小程序、微信小程序 | 微信小程序发布与维护 | +| W10 | Soul创业实验 | Soul文章、第9章 | 写作+上传+运营报表统一入口 | +| W11 | Soul派对运营报表 | 运营报表、派对填表 | 派对截图→飞书报表→发群 | +| W11a | Soul发到素材库 | 成片发飞书、切片发飞书 | 成片→飞书内容看板 | +| W12 | MCP搜索与连接 | MCP、找MCP、装MCP | 搜索 5000+ MCP 服务器→生成配置→写入 Cursor/Claude | +| W13 | Excel表格与日报 | Excel写飞书、CSV写飞书 | 本地 Excel/CSV→飞书表格→日报图表 | +| W14 | 卡猫复盘 | 卡猫复盘、婼瑄复盘 | 婼瑄目录→复盘→飞书+卡猫群 | +| W15 | 接收短信 | 接收短信、接码 | receivesms.co 英国临时号收短信 | + +## 8.5 使用场景 + +- "帮我写今天的飞书日志" → W07 飞书管理 +- "把这个 PDF 转成 Markdown" → W02 文档清洗 +- "帮我找一个能操作数据库的 MCP" → W12 MCP 搜索 +- "帮我把运营数据填到飞书报表" → W11 运营报表 + +--- + +> 下一章：[第9章 · 木组 · 卡木](09_木组_卡木.md) diff --git a/运营中枢/使用手册/第三篇_五行技能详解/09_木组_卡木.md b/运营中枢/使用手册/第三篇_五行技能详解/09_木组_卡木.md new file mode 100644 index 00000000..bad077a0 --- /dev/null +++ b/运营中枢/使用手册/第三篇_五行技能详解/09_木组_卡木.md @@ -0,0 +1,51 @@ +# 第9章 · 木组 · 卡木 — 产品内容创造 + +> 返回 [总目录](../README.md) | 口号："搞起！" + +--- + +## 9.1 职责概述 + +木组负责内容生产与产品模板：视频切片与多平台分发、网站逆向、项目脚手架、PPT、架构图、个人介绍等。 + +## 9.2 木叶 · 视频内容（8 技能） + +| 编号 | 技能 | 触发词 | 做什么 | +|:--|:---|:---|:---| +| M01 | 视频切片 | 视频剪辑、切片发布、片头片尾 | 长视频→切片+字幕+动效包装 | +| M01b | 抖音视频解析 | 抖音链接、抖音下载 | 链接→解析→文案+无水印下载 | +| M01c | 抖音发布 | 抖音发布、抖音上传 | 纯 API 视频上传发布 | +| M01d | B站发布 | B站发布、bilibili发布 | API 分片上传发布 | +| M01e | 视频号发布 | 视频号发布、微信视频号 | 腾讯云 API 上传发布 | +| M01f | 小红书发布 | 小红书发布、RED发布 | 逆向 creator API 发布 | +| M01g | 快手发布 | 快手发布、kuaishou发布 | 逆向 cp.kuaishou.com 发布 | +| M01h | 多平台分发 | 一键分发、全平台发布 | 一键分发到 5 平台，支持定时排期 | + +## 9.3 木根 · 逆向分析（1 技能） + +| 编号 | 技能 | 触发词 | 做什么 | +|:--|:---|:---|:---| +| M02 | 网站逆向分析 | 逆向分析、模拟登录 | 网站 API 分析与 SDK 生成 | + +## 9.4 木果 · 项目模板（7 技能） + +| 编号 | 技能 | 触发词 | 做什么 | +|:--|:---|:---|:---| +| M03 | 项目生成 | 生成项目、五行模板 | 按五行模板生成新项目 | +| M04 | 开发模板 | 创建项目、初始化模板 | 前后端项目模板库 | +| M05 | 个人档案生成器 | 个人档案、档案生成 | 自动生成个人介绍档案 | +| M06 | 前端生成 | 前端生成、UI | 快速生成前端页面 | +| M07 | PPT制作 | PPT、做PPT、汇报PPT | python-pptx 创建/编辑 .pptx | +| M08 | Next AI Draw | AI画图、架构图、流程图 | AI 生成 draw.io/Mermaid 图表 | +| M09 | 卡若个人介绍 | 卡若介绍、个人介绍 | PPT/短文/一页纸个人介绍 | + +## 9.5 使用场景 + +- "帮我把这个长视频切片并发到全平台" → M01 + M01h +- "帮我做一份汇报 PPT" → M07 PPT制作 +- "画一张系统架构图" → M08 Next AI Draw +- "分析一下这个网站的登录接口" → M02 网站逆向 + +--- + +> 下一章：[第10章 · 火组 · 卡火](10_火组_卡火.md) diff --git a/运营中枢/使用手册/第三篇_五行技能详解/10_火组_卡火.md b/运营中枢/使用手册/第三篇_五行技能详解/10_火组_卡火.md new file mode 100644 index 00000000..22fc26ce --- /dev/null +++ b/运营中枢/使用手册/第三篇_五行技能详解/10_火组_卡火.md @@ -0,0 +1,68 @@ +# 第10章 · 火组 · 卡火 — 技术研发优化 + +> 返回 [总目录](../README.md) | 口号："让我想想…" + +--- + +## 10.1 职责概述 + +火组是技术核心：全栈开发、前端、测试、消息系统、代码修复、智能追问、本地模型与知识库。 + +## 10.2 火炬 · 全栈消息（11 技能） + +| 编号 | 技能 | 触发词 | 做什么 | +|:--|:---|:---|:---| +| F01 | 全栈开发 | 官网开发、全站开发、开发文档 | 按 1～10 文档体系做全栈项目 | +| F01a | 前端开发 | 前端开发、毛玻璃、苹果毛玻璃 | 苹果毛玻璃风格 + 前端标准 | +| F01b | 全栈测试 | 功能测试、回归测试、E2E测试 | 五维测试：前端/后端/DB/脚本/发布 | +| F02 | 消息中枢 | WhatsApp、Telegram | 多平台消息聚合 | +| F03 | 读书笔记 | 拆解这本书、五行拆书 | 五行框架拆书 | +| F04 | 文档清洗 | 文档清洗、PDF转MD | 批量文档格式转换 | +| F09 | 开发文档操控 | 开发文档操控、1～10文档 | 按 1～10 操控任意站开发文档 | +| F10 | 上帝之眼 | 监控、上帝之眼 | 全局监控与数据看板 | +| F11 | 量化交易 | 量化、交易 | 量化策略与回测 | +| F12 | 对话归档 | 对话归档 | 技术对话归档 | +| F22 | 本地项目启动 | 本地运行、Docker部署、指定端口 | 按端口表启动，Docker 部署与同步 | + +### 全栈开发体系说明 + +全栈开发采用 **1～10 开发文档体系**： + +``` +1、需求 → 2、架构 → 3、原型 → 4、前端 → 5、接口 +→ 6、后端 → 7、数据库 → 8、部署 → 9、手册 → 10、项目管理 +``` + +每个项目一套文档，支持调研→生成→更新的全生命周期。 + +## 10.3 火锤 · 代码修复（1 技能） + +| 编号 | 技能 | 触发词 | 做什么 | +|:--|:---|:---|:---| +| F05 | 代码修复 | 代码修复、Bug | 根据报错定位 Bug 并修复 | + +## 10.4 火眼 · 智能追问（1 技能） + +| 编号 | 技能 | 触发词 | 做什么 | +|:--|:---|:---|:---| +| F06 | 智能追问 | 追问模式、需求澄清 | 需求不清时主动追问收敛 | + +## 10.5 火种 · 知识模型（4 技能） + +| 编号 | 技能 | 触发词 | 做什么 | +|:--|:---|:---|:---| +| F07 | 读书笔记(模型) | 五行拆书 | 本地模型辅助拆书 | +| F08 | 本地模型 | ollama、qwen、本地AI | Ollama/Qwen 本地部署 | +| F21 | 本地代码库索引 | 本地索引、本地搜索 | 本地 embedding 语义检索 | +| F13 | 卡若日记写作 | 日记、写日记 | 按模板生成每日日记 | + +## 10.6 使用场景 + +- "帮我开发一个新网站" → F01 全栈开发 +- "这段代码报错了帮我修" → F05 代码修复 +- "帮我把项目部署到 Docker" → F22 本地项目启动 +- "需求不太清楚帮我梳理" → F06 智能追问 + +--- + +> 下一章：[第11章 · 土组 · 卡土](11_土组_卡土.md) diff --git a/运营中枢/使用手册/第三篇_五行技能详解/11_土组_卡土.md b/运营中枢/使用手册/第三篇_五行技能详解/11_土组_卡土.md new file mode 100644 index 00000000..7ea78ace --- /dev/null +++ b/运营中枢/使用手册/第三篇_五行技能详解/11_土组_卡土.md @@ -0,0 +1,61 @@ +# 第11章 · 土组 · 卡土 — 商业复制裂变 + +> 返回 [总目录](../README.md) | 口号："先算账。" + +--- + +## 11.1 职责概述 + +土组管商业与财务：竞品分析、技能复制与基因胶囊、分销体系、流量自动化、公司与家庭财务。 + +## 11.2 土基 · 商业分析（1 技能） + +| 编号 | 技能 | 触发词 | 做什么 | +|:--|:---|:---|:---| +| E01 | 商业工具集 | 商业分析、竞品 | 竞品分析、商业画布 | + +## 11.3 土砖 · 技能复制（3 技能） + +| 编号 | 技能 | 触发词 | 做什么 | +|:--|:---|:---|:---| +| E02 | 技能工厂 | 创建技能、生成Skill | 批量创建/复制 SKILL | +| E02a | 全站捆绑分销体系 | 全站捆绑、分销体系 | 30天捆绑+分销可复用方案 | +| E07 | 基因胶囊 | 打包技能、解包胶囊、继承能力 | Skill 打包为可遗传胶囊 | + +### 基因胶囊简介 + +基因胶囊是卡若AI 的技能遗传机制：将验证过的 Skill 打包成可传递的能力单元。 + +``` +pack：SKILL → 基因胶囊（含策略+环境指纹+审计记录+资产ID） +unpack：基因胶囊 → 还原为 SKILL +list：查看所有已打包胶囊 +``` + +详见 [第16章 · 基因胶囊](../第四篇_运营中枢/16_基因胶囊.md)。 + +## 11.4 土渠 · 流量招商（2 技能） + +| 编号 | 技能 | 触发词 | 做什么 | +|:--|:---|:---|:---| +| E03 | 流量自动化 | 刷流量、SEO | SEO 与流量投放自动化 | +| E04 | 手机流量自动操作 | 手机自动化、AutoGLM | 手机 App 自动化操作 | + +## 11.5 土簿 · 财务管理（4 技能） + +| 编号 | 技能 | 触发词 | 做什么 | +|:--|:---|:---|:---| +| E05 | 财务管理 | 财务、报表、银行 | 综合收支与报表 | +| E05a | 公司财务 | 公司财务、芸归喜、卡卡猫 | 公司收支、月度报表、工资表 | +| E05b | 家庭财务 | 家庭财务、鲨鱼记账 | 家庭收支（与公司分离） | +| E06 | 商业工具集(财务) | 商业分析 | 财务视角的商业分析 | + +## 11.6 使用场景 + +- "分析一下这个竞品的商业模式" → E01 商业工具集 +- "帮我把这个技能打包成胶囊" → E07 基因胶囊 +- "帮我看看公司这个月的收支" → E05a 公司财务 + +--- + +> 下一篇：[第四篇 · 运营中枢](../第四篇_运营中枢/12_执行流程与MAX_Mode.md) diff --git a/运营中枢/使用手册/第二篇_快速入门/04_启动与接入.md b/运营中枢/使用手册/第二篇_快速入门/04_启动与接入.md new file mode 100644 index 00000000..f9d3f73b --- /dev/null +++ b/运营中枢/使用手册/第二篇_快速入门/04_启动与接入.md @@ -0,0 +1,59 @@ +# 第4章 · 启动与接入 + +> 返回 [总目录](../README.md) | 上一章 [第3章](../第一篇_认识卡若AI/03_团队与角色.md) + +--- + +## 4.1 启动顺序（Boot Sequence） + +每次新对话开始，卡若AI 按以下顺序加载： + +| 步骤 | 读什么 | 为什么 | +|:--:|:---|:---| +| 1 | `BOOTSTRAP.md` | 身份、团队、流程、规则 | +| 2 | `SKILL_REGISTRY.md`（热技能优先） | 查找用户需求对应的技能 | +| 3 | 对应 SKILL.md | 拿到具体执行指令 | +| 4 | 在对话中展示思考与拆解 | 让用户看到完整思考过程 | + +**启动瘦身**：步骤 2 优先只加载 🔴 热技能（≤8 个）的触发词+路径，未命中再懒加载其余。 + +## 4.2 各平台接入方式 + +### Cursor（自动） + +`.cursor/rules/karuo-ai.mdc` 自动加载，指向 BOOTSTRAP.md。正常对话即可，无需额外配置。 + +### 其他 AI（粘贴） + +对话开头粘贴 BOOTSTRAP.md 全文，再附上 SKILL_REGISTRY.md 作为技能库。AI 即可按卡若团队分工和流程执行。 + +### API 调用（HTTP） + +```bash +curl -s -X POST "https://kr-ai.quwanzhi.com/v1/chat" \ + -H "Content-Type: application/json" \ + -d '{"prompt":"你的问题"}' | jq -r '.reply' +``` + +## 4.3 工作台路径 + +- **本地工作台**：`/Users/karuo/Documents/个人/卡若AI/` +- **记忆文件**：`/Users/karuo/Documents/个人/1、卡若：本人/记忆.md` +- **对外输出**：`/Users/karuo/Documents/卡若Ai的文件夹/` + +## 4.4 热技能（启动时预加载） + +| 编号 | 技能 | 触发词示例 | +|:--|:---|:---| +| F01 | 全栈开发 | 官网开发、全站开发 | +| F01b | 全栈测试 | 功能测试、回归测试 | +| W07 | 飞书管理 | 飞书日志、写入飞书 | +| W08 | 智能纪要 | 飞书妙记、会议纪要 | +| G02 | Gitea管理 | Gitea、推送 | +| F05 | 代码修复 | Bug、代码修复 | +| G08 | 系统监控 | 系统状态、杀进程 | +| W12 | MCP 搜索 | MCP、找MCP | + +--- + +> 下一章：[第5章 · 第一次对话](05_第一次对话.md) diff --git a/运营中枢/使用手册/第二篇_快速入门/05_第一次对话.md b/运营中枢/使用手册/第二篇_快速入门/05_第一次对话.md new file mode 100644 index 00000000..3713be2b --- /dev/null +++ b/运营中枢/使用手册/第二篇_快速入门/05_第一次对话.md @@ -0,0 +1,59 @@ +# 第5章 · 第一次对话 + +> 返回 [总目录](../README.md) | 上一章 [第4章](04_启动与接入.md) + +--- + +## 5.1 对话流程 + +每次对话遵循固定流程（强制）： + +``` +输入需求 + ↓ +深度思考（结合五行全部能力） + ↓ +在对话中展示：思考结果 + 任务拆解 + 执行计划 + ↓ +执行（可 1～6 线程并行） + ↓ +反复验证（至少两轮） + ↓ +交付 + 强制复盘（🎯📌💡📝▶） +``` + +## 5.2 触发词使用 + +直接用自然语言描述需求即可，卡若AI 会自动匹配技能： + +| 你说 | 卡若AI 做 | +|:---|:---| +| "帮我写今天的飞书日志" | 匹配 W07 飞书管理 → 执行写入脚本 | +| "这个 Bug 帮我修一下" | 匹配 F05 代码修复 → 定位并修复 | +| "帮我把视频切片发到各平台" | 匹配 M01h 多平台分发 → 一键分发 | +| "分析一下这个竞品" | 匹配 E01 商业工具集 → 竞品分析 | +| "帮我找一个 MCP 服务" | 匹配 W12 MCP 搜索 → 搜索并安装 | + +也可以用 `@成员名` 指定：如 `@火炬 帮我做全栈开发`。 + +## 5.3 示例对话 + +**用户**：帮我整理一下桌面上的文件 + +**卡若AI**： +1. **思考**：文件整理属于水组（卡人）→ 水溪（整理归档）→ W01 文件整理 +2. **拆解**：① 扫描桌面文件 ② 按类型分类 ③ 移动到对应目录 ④ 生成清单 +3. **执行**：按步骤操作 +4. **复盘**：🎯 目标·结果·达成率 → 📌 过程 → 💡 反思 → 📝 总结 → ▶ 下一步 + +## 5.4 对话结束时 + +每次对话收尾会自动执行： +- **复盘**：完整五块复盘 +- **经验沉淀**：有价值的写入经验库 +- **Gitea 同步**：有文件变更时自动推送 +- **手册更新**：有技能变更时更新对应章节 + +--- + +> 下一章：[第6章 · 标准命令](06_标准命令.md) diff --git a/运营中枢/使用手册/第二篇_快速入门/06_标准命令.md b/运营中枢/使用手册/第二篇_快速入门/06_标准命令.md new file mode 100644 index 00000000..4c2e19ee --- /dev/null +++ b/运营中枢/使用手册/第二篇_快速入门/06_标准命令.md @@ -0,0 +1,42 @@ +# 第6章 · 标准命令 + +> 返回 [总目录](../README.md) | 上一章 [第5章](05_第一次对话.md) + +--- + +## 6.1 所有平台通用命令 + + +| 命令 | 触发方式 | 做什么 | +| ------------ | -------- | ------------------------------------ | +| **技能查找** | 用户说任何需求 | 查 SKILL_REGISTRY → 读对应 SKILL.md → 执行 | +| **复盘** | 所有对话强制 | 每轮/每步结尾输出完整复盘块（🎯📌💡📝▶） | +| **沉淀** | 发现有价值经验 | 写入 `水溪_整理归档/经验库/待沉淀/` | +| **基因胶囊** | 打包/解包/继承 | `gene_capsule.py pack/unpack/list` | +| **Gitea 同步** | 有文件变更 | `bash 金仓/Gitea管理/脚本/自动同步.sh` | +| **Pipeline** | "新项目上线"等 | 按 Pipeline 执行清单逐步执行 | +| **对外输出** | 报告/图片/导出 | 只写 `卡若Ai的文件夹/` 对应子目录 | + + +## 6.2 Cursor 特有命令 + + +| 命令 | 说明 | +| ------ | ------------------------------------- | +| 每日对话收集 | 每天首次对话时执行 `collect_chat_daily.py` | +| 飞书今日日志 | 直接执行 `write_today_three_focus.py`，不询问 | +| MD 预览 | 所有 .md 用 Markdown Preview Enhanced 打开 | +| 终端命令 | AI 直接执行，不输出让用户复制 | + + +## 6.3 常规操作原则 + +- **优先命令行**：能用命令完成的不手动 +- **先搜后做**：执行前搜索是否有现成脚本/流程 +- **不重复造轮子**：有现成的直接用 +- **不反复提问**：能判断的自动执行，不问"是否执行" + +--- + +> 下一篇：[第三篇 · 五行技能详解](../第三篇_五行技能详解/07_金组_卡资.md) + diff --git a/运营中枢/使用手册/第五篇_卡若AI网站/18_网站总览.md b/运营中枢/使用手册/第五篇_卡若AI网站/18_网站总览.md new file mode 100644 index 00000000..0861b4bf --- /dev/null +++ b/运营中枢/使用手册/第五篇_卡若AI网站/18_网站总览.md @@ -0,0 +1,52 @@ +# 第18章 · 网站总览 + +> 返回 [总目录](../README.md) + +--- + +## 18.1 定位 + +卡若AI 网站是卡若AI 的**对外展示入口与管理控制台**。官网负责展示与说明，控制台负责技能管理、流程编排、网关配置等。 + +**与主仓库的关系**：官网是门面与说明书，主仓库（`/Users/karuo/Documents/个人/卡若AI/`）是大脑与执行环境。 + +## 18.2 技术栈 + +| 层 | 技术 | +|:---|:---| +| 框架 | Next.js 14（App Router） | +| 前端 | React 18、Tailwind CSS、Lucide Icons | +| 数据 | SQLite（当前）/ MongoDB（扩展） | +| 构建 | `output: standalone`，Docker 容器化 | + +## 18.3 访问地址 + +| 环境 | 地址 | +|:---|:---| +| 内网 | `http://192.168.1.201:3102` | +| 外网 | `http://open.quwanzhi.com:3102` | +| API 网关 | `https://kr-ai.quwanzhi.com` | + +## 18.4 架构分层 + +``` +用户（浏览器） + ↓ +官网前端（marketing pages）+ 控制台前端（console） + ↓ +Next.js API Routes + ↓ +SQLite / MongoDB + ↓ +主仓库（技能同步）+ 外网网关（可选） +``` + +## 18.5 项目路径 + +- **代码**：`/Users/karuo/Documents/开发/3、自营项目/卡若ai网站/` +- **开发文档**：`开发文档/`（1～10 目录体系） +- **部署**：Docker → NAS → frp 外网 + +--- + +> 下一章：[第19章 · 官网与控制台](19_官网与控制台.md) diff --git a/运营中枢/使用手册/第五篇_卡若AI网站/19_官网与控制台.md b/运营中枢/使用手册/第五篇_卡若AI网站/19_官网与控制台.md new file mode 100644 index 00000000..c99694b7 --- /dev/null +++ b/运营中枢/使用手册/第五篇_卡若AI网站/19_官网与控制台.md @@ -0,0 +1,45 @@ +# 第19章 · 官网与控制台 + +> 返回 [总目录](../README.md) | 上一章 [第18章](18_网站总览.md) + +--- + +## 19.1 官网页面 + +| 路径 | 页面 | 功能 | +|:---|:---|:---| +| `/` | 首页 | 居中对话区 + 底部输入框，直接与卡若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` | 平台治理 | 接口开关 + 限流 + 基因胶囊配置 | + +## 19.3 官网与控制台的区别 + +| 维度 | 官网 | 控制台 | +|:---|:---|:---| +| 受众 | 所有访客 | 管理员 | +| 权限 | 无需登录（只读） | 需登录（读写） | +| 接口 | 只调只读 API | 可调所有 CRUD | +| 作用 | 展示、说明、入口 | 配置、管理、运维 | + +--- + +> 下一章：[第20章 · API 与部署](20_API与部署.md) diff --git a/运营中枢/使用手册/第五篇_卡若AI网站/20_API与部署.md b/运营中枢/使用手册/第五篇_卡若AI网站/20_API与部署.md new file mode 100644 index 00000000..d821488d --- /dev/null +++ b/运营中枢/使用手册/第五篇_卡若AI网站/20_API与部署.md @@ -0,0 +1,76 @@ +# 第20章 · API 与部署 + +> 返回 [总目录](../README.md) | 上一章 [第19章](19_官网与控制台.md) + +--- + +## 20.1 主要 API 分类 + +### 技能中心 + +| 方法 | 路径 | 说明 | +|:---|:---|:---| +| GET/POST | `/api/skills` | 获取/新增技能 | +| GET/PUT/DELETE | `/api/skills/:id` | 单条 CRUD | +| POST | `/api/skills/sync` | 从主仓库同步 | +| POST | `/api/skills/ai-tidy` | AI 整理技能信息 | +| POST | `/api/skills/ai-add` | AI 生成新技能 | + +### 流程与任务 + +| 方法 | 路径 | 说明 | +|:---|:---|:---| +| GET/POST | `/api/workflows` | 流程 CRUD | +| POST | `/api/workflows/:id/run` | 执行流程 | +| GET/POST | `/api/tasks` | 任务队列 | + +### 网关与对话 + +| 方法 | 路径 | 说明 | +|:---|:---|:---| +| POST | `/api/chat` | 首页对话接口 | +| POST | `/api/gateway/chat` | 统一 LLM 出口（兼容 OpenAI） | +| GET | `/api/gateway/models` | 可用模型列表 | +| POST | `/api/gateway/switch` | 切换主用网关 | + +### 认证与平台 + +| 方法 | 路径 | 说明 | +|:---|:---|:---| +| POST | `/api/auth/login` | 登录 | +| GET | `/api/auth/me` | 当前用户 | +| GET/PUT | `/api/users` | 用户管理 | +| GET/POST/PUT | `/api/platform/*` | 接口配置、限流、基因胶囊 | + +## 20.2 部署方式 + +### Docker 容器化部署 + +```bash +docker build --platform linux/amd64 -t karuo-site:latest . +docker save karuo-site:latest | gzip > karuo-site.tar.gz +# 传输到 NAS +scp karuo-site.tar.gz nas:/volume1/docker/ +# NAS 上加载运行 +docker load < karuo-site.tar.gz +docker run -d --name karuo-site -p 3102:3000 \ + -v karuo-site-data:/app/.runtime karuo-site:latest +``` + +### 端口与网络 + +| 项目 | 部署端口 | 说明 | +|:---|:--:|:---| +| 卡若AI网站 | 3102 | Docker 容器 → NAS | +| frp 外网 | 3102 | 外网 → NAS 3102 | +| API 网关 | 8000 | 宝塔服务器 | + +### 数据持久化 + +- Docker volume `karuo-site-data` → `/app/.runtime` +- 数据库文件：`.runtime/karuo-app.db`（SQLite） +- 扩展可迁移到 MongoDB `karuo_site` 库 + +--- + +> 下一篇：[第六篇 · 进阶与扩展](../第六篇_进阶与扩展/21_外网调用与API网关.md) diff --git a/运营中枢/使用手册/第六篇_进阶与扩展/21_外网调用与API网关.md b/运营中枢/使用手册/第六篇_进阶与扩展/21_外网调用与API网关.md new file mode 100644 index 00000000..d54f9d4d --- /dev/null +++ b/运营中枢/使用手册/第六篇_进阶与扩展/21_外网调用与API网关.md @@ -0,0 +1,73 @@ +# 第21章 · 外网调用与 API 网关 + +> 返回 [总目录](../README.md) + +--- + +## 21.1 外网化方案 + +让卡若AI 可从外网访问，任意终端用「一句话/一个命令」调用卡若AI。 + +### 架构 + +``` +外部（其他 AI / 用户） + │ HTTP POST /chat + ▼ +卡若AI 网关（FastAPI） + · 加载 BOOTSTRAP + SKILL_REGISTRY + · 匹配技能 → 读 SKILL.md + · 调用 LLM 生成回复（含复盘） + │ + ▼ 部署在宝塔服务器 +外网域名：https://kr-ai.quwanzhi.com +``` + +## 21.2 调用方式 + +### curl 命令 + +```bash +curl -s -X POST "https://kr-ai.quwanzhi.com/v1/chat" \ + -H "Content-Type: application/json" \ + -d '{"prompt":"你的问题"}' | jq -r '.reply' +``` + +### 在 Cursor 中集成 + +``` +当用户说「用卡若AI」时： +POST https://kr-ai.quwanzhi.com/v1/chat +Body: {"prompt": "<用户问题>"} +将 reply 字段展示给用户。 +``` + +### 部门 key 认证 + +| 接口 | 说明 | +|:---|:---| +| `POST /v1/chat` | 带 `X-Karuo-Api-Key` 发送对话 | +| `GET /v1/skills` | 查看当前部门允许的技能 | +| `GET /v1/health` | 健康检查（无需 key） | + +## 21.3 网关配置 + +- 网关代码：`运营中枢/scripts/karuo_ai_gateway/` +- 配置文件：`config/gateway.yaml` +- 新增部门：`python tools/generate_dept_key.py --tenant-id xxx` + +### 轮询与故障切换 + +| 网关 | Base URL | +|:---|:---| +| KaruoGateway | `http://localhost:8000` | +| OpenAI | `https://api.openai.com/v1` | +| OpenRouter | `https://openrouter.ai/api/v1` | +| 通义千问 | `https://dashscope.aliyuncs.com/compatible-mode/v1` | +| 智增增 | `https://api.zhizengzeng.com/v1` | + +按队列逐个尝试，失败自动切下一个。 + +--- + +> 下一章：[第22章 · 多线程并行处理](22_多线程并行处理.md) diff --git a/运营中枢/使用手册/第六篇_进阶与扩展/22_多线程并行处理.md b/运营中枢/使用手册/第六篇_进阶与扩展/22_多线程并行处理.md new file mode 100644 index 00000000..d3f859e5 --- /dev/null +++ b/运营中枢/使用手册/第六篇_进阶与扩展/22_多线程并行处理.md @@ -0,0 +1,50 @@ +# 第22章 · 多线程并行处理 + +> 返回 [总目录](../README.md) | 上一章 [第21章](21_外网调用与API网关.md) + +--- + +## 22.1 概述 + +当任务可拆为多个相对独立的子任务时，卡若AI 可启用 **1～6 个并行线程**同时处理。 + +## 22.2 启用条件 + +- 任务可拆为多个**相互独立**的子任务 +- 子任务之间**无强顺序依赖** +- 由卡若AI 划定各子任务的边界与归属域 + +## 22.3 边界划分方式 + +| 划分方式 | 说明 | +|:---|:---| +| 按五行/成员 | 金（存储）、水（整理）、木（内容）、火（技术）、土（商业） | +| 按技能域 | 每个子任务对应一个 SKILL | +| 按产出/目标 | 不同线程负责不同文档/模块/数据 | + +## 22.4 流程 + +``` +任务输入 + ↓ +卡若AI 拆解 → 划定边界 + ↓ +并行派发 1～6 个子任务 + ↓ +各线程在各自边界内独立判断、独立处理 + ↓ +汇总结果 → 去重 → 合并 + ↓ +验证 → 复盘 +``` + +## 22.5 平台差异 + +| 平台 | 并行方式 | +|:---|:---| +| Cursor | 使用 mcp_task 一次派发多个子任务 | +| 其他 | 用显式「子任务 1/2/…」顺序执行，标注可并行域 | + +--- + +> 下一章：[第23章 · 技能开发与扩展](23_技能开发与扩展.md) diff --git a/运营中枢/使用手册/第六篇_进阶与扩展/23_技能开发与扩展.md b/运营中枢/使用手册/第六篇_进阶与扩展/23_技能开发与扩展.md new file mode 100644 index 00000000..7b58641a --- /dev/null +++ b/运营中枢/使用手册/第六篇_进阶与扩展/23_技能开发与扩展.md @@ -0,0 +1,64 @@ +# 第23章 · 技能开发与扩展 + +> 返回 [总目录](../README.md) | 上一章 [第22章](22_多线程并行处理.md) + +--- + +## 23.1 SKILL.md 标准格式 + +每个技能的 SKILL.md 遵循以下结构： + +```yaml +--- +name: 技能名称 +description: 一句话说明 +triggers: 关键词1、关键词2 +owner: 所属成员名 +group: 所属负责人（金/水/木/火/土） +version: "1.0" +updated: "YYYY-MM-DD" +--- +``` + +正文结构： + +```markdown +# 技能名称 + +## 能做什么（Capabilities） +## 怎么用（Usage） +## 执行步骤（Steps） +## 相关文件（Files） +## 依赖（Dependencies） +``` + +## 23.2 新增技能流程 + +1. **创建 SKILL.md**：按标准格式写在对应成员目录下 +2. **登记 SKILL_REGISTRY**：在注册表中新增一行 +3. **登记技能控制台**：`运营中枢/工作台/01_技能控制台.md` +4. **更新使用手册**：在对应章节新增技能说明 +5. **可选：基因胶囊**：`gene_capsule.py pack` 打包 + +也可用 **E02 技能工厂** 批量创建。 + +## 23.3 技能热度管理 + +| 热度 | 定义 | 加载策略 | +|:--|:---|:---| +| 🔴 热 | 近 30 天使用 ≥3 次 | 启动时预加载 | +| 🟡 温 | 近 30 天使用 1～2 次 | 命中后加载 | +| ⚪ 冷 | 30 天未使用 | 按需全量读取 | + +热度可通过 `运营中枢/工作台/skill_heat_log.md` 统计。 + +## 23.4 技能文件存放规则 + +- 技能目录放在对应成员下：`0X_卡X（X）/成员名_职责/技能名/SKILL.md` +- 脚本放在技能目录的 `脚本/` 子目录 +- 参考资料放在 `references/` 子目录 +- Skill 目录禁止 >20MB 文件 + +--- + +> 下一章：[第24章 · 端口与数据库管理](24_端口与数据库管理.md) diff --git a/运营中枢/使用手册/第六篇_进阶与扩展/24_端口与数据库管理.md b/运营中枢/使用手册/第六篇_进阶与扩展/24_端口与数据库管理.md new file mode 100644 index 00000000..8e8972fe --- /dev/null +++ b/运营中枢/使用手册/第六篇_进阶与扩展/24_端口与数据库管理.md @@ -0,0 +1,65 @@ +# 第24章 · 端口与数据库管理 + +> 返回 [总目录](../README.md) | 上一章 [第23章](23_技能开发与扩展.md) + +--- + +## 24.1 唯一 MongoDB 约定 + +所有新生成的数据一律放在**唯一 MongoDB 实例**： + +| 项目 | 值 | +|:---|:---| +| 容器名 | `datacenter_mongodb` | +| 宿主机端口 | **27017** | +| 分组 | datacenter | +| 数据目录 | `/Users/karuo/数据库/mongodb/data` | + +### 库用途 + +| 库名 | 用途 | +|:---|:---| +| `karuo_site` | 卡若AI网站（官网 + 控制台） | +| `wanzhi_esports` | 玩值电竞 | +| `KR` / `KR_*` | 神射手 | + +**禁止**新建 MongoDB 实例或使用非 27017 端口。 + +## 24.2 端口注册表 + +所有项目端口统一登记在 `运营中枢/工作台/项目与端口注册表.md`，部署前必查防重复。 + +### 主要端口 + +| 项目 | 部署端口 | 开发端口 | +|:---|:--:|:--:| +| 卡若AI网站 | 3102 | 3102 | +| 玩值电竞App | 3001 | 3001 | +| 神射手 | 3117 | 3117 | +| 存客宝 Web | 3100 | 3100 | +| 触客宝 Web | 3101 | 3101 | +| Soul 创业实验 | 3000 | 3002 | +| OpenClaw 网关 | 18789/18790 | — | +| n8n | 5678 | — | +| 万推 | 8000 | 8001 | + +### Docker 分组 + +| 分组 | 包含 | +|:---|:---| +| datacenter | MongoDB、Qdrant 等数据库 | +| website | 卡若AI网站、玩值电竞等应用 | + +website 组通过 `datacenter_network` 连接数据库。 + +## 24.3 端口冲突处理 + +端口冲突时：先结束占用端口的进程，再部署，不改用其他端口。 + +## 24.4 更新规则 + +项目、端口、启动命令或部署流程有变更时，必须同步更新端口注册表。 + +--- + +> 附录：[附录 A · 全量技能速查表](../附录/A_全量技能速查表.md) diff --git a/运营中枢/使用手册/第四篇_运营中枢/12_执行流程与MAX_Mode.md b/运营中枢/使用手册/第四篇_运营中枢/12_执行流程与MAX_Mode.md new file mode 100644 index 00000000..90c12e12 --- /dev/null +++ b/运营中枢/使用手册/第四篇_运营中枢/12_执行流程与MAX_Mode.md @@ -0,0 +1,69 @@ +# 第12章 · 执行流程与 MAX Mode + +> 返回 [总目录](../README.md) + +--- + +## 12.1 MAX Mode（默认行为） + +卡若AI 每次被调用时**均以 MAX Mode 运行**，无需单独开启： + +- **思考更深**：多角度、边界情况、风险与回退 +- **拆解更细**：子步骤、依赖、顺序写清，带精确路径和命令 +- **技能联动**：执行前检查是否有联动子技能 +- **验证更严**：至少两轮验证 +- **复盘更全**：五块齐全，可带数据和引用 + +## 12.2 执行七步法（强制） + +### 第一步：深度思考 + 展示拆解（强制） + +接到任务后**必须先思考**，结合五行全部能力想清楚：目标、该谁干、怎么干、卡在哪。 + +**必须在对话中展示**： +1. **思考结果**：调研后的结论 +2. **任务拆解**：1、2、3… 的细粒度步骤 +3. **执行计划**：精确路径、命令、预期 + +### 第二步：执行 + +先搜索本仓库和网上是否有现成方案，有则直接用；否则查 SKILL_REGISTRY → 读 SKILL.md → 按步骤执行。 + +### 第三步：反复验证（至少两轮） + +结果是否与目标匹配？匹配则交付；不匹配则回溯→搜索→再思考→再执行，循环直到达成。 + +### 第四步：强制复盘 + +所有对话的回复一律用复盘形式收尾，详见 [第13章](13_复盘格式.md)。 + +## 12.3 流程图 + +``` +输入 → 思考（深度+拆解+计划）→ 展示 → 执行（可并行 1～6 线程）→ 验证 + ↑ │ + └── 不匹配：回溯 → 搜索 → 再思考 → 再执行 ──────────────────────┘ + ↓ + 匹配 → 交付 + 复盘 +``` + +## 12.4 思考展示格式 + +```markdown +## 思考与拆解 +[目标、该谁干、怎么干、卡点——详细文字] + +## 任务拆解 +1. 第一步… +2. 第二步… + +## 执行计划 +[路径 / 命令 / 预期] + +## 执行 +[按计划动手] +``` + +--- + +> 下一章：[第13章 · 复盘格式](13_复盘格式.md) diff --git a/运营中枢/使用手册/第四篇_运营中枢/13_复盘格式.md b/运营中枢/使用手册/第四篇_运营中枢/13_复盘格式.md new file mode 100644 index 00000000..9f1d097d --- /dev/null +++ b/运营中枢/使用手册/第四篇_运营中枢/13_复盘格式.md @@ -0,0 +1,63 @@ +# 第13章 · 复盘格式 + +> 返回 [总目录](../README.md) | 上一章 [第12章](12_执行流程与MAX_Mode.md) + +--- + +## 13.1 核心规则 + +**卡若AI 所有对话的 AI 回复一律采用「复盘形式」**，只有一种格式：完整复盘，每轮/每步均以完整复盘块收尾。 + +## 13.2 五块结构 + +| 块 | 图标 | 内容 | 要求 | +|:--|:--:|:---|:---| +| 目标·结果·达成率 | 🎯 | 做什么、结果如何、达成百分比 | 整行 ≤30 字 | +| 过程 | 📌 | 1、2、3 分点简述执行过程 | 不用表格 | +| 反思 | 💡 | 可复用点、改进点 | 1～3 点 | +| 总结 | 📝 | 一两句结论或经验 | 简洁 | +| 下一步执行 | ▶ | 结合项目目标的后续动作 | 关联未完成项 | + +## 13.3 格式要求 + +- **标题**：`[卡若复盘]（YYYY-MM-DD HH:mm）`，日期时间必填 +- **日期时间**用 Markdown 粗体，不用 HTML 标签 +- **复盘块内不用表格** +- 每块用小图标标识（🎯📌💡📝▶） + +## 13.4 示例 + +```markdown +**[卡若复盘]（2026-03-12 10:30）** + +🎯 目标·结果·达成率 +完善使用手册架构 · 已完成6篇24章 · 100% + +📌 过程 +1. 分析现有手册结构，确认缺失内容 +2. 设计6篇24章目录结构 +3. 逐章编写并建立导航链接 + +💡 反思 +1. 多文件结构比单文件更易维护 +2. 每章独立可以按需更新而不影响其他章节 + +📝 总结 +使用手册从 v1.0 升级到 v2.0 书籍结构，覆盖全部功能。 + +▶ 下一步执行 +- 持续按对话沉淀规则更新手册 +- 有新技能时同步更新对应章节 +``` + +## 13.5 可选扩展块 + +| 块 | 图标 | 何时用 | +|:--|:--:|:---| +| 扫描 | 📡 | 涉及扫描任务时 | +| 决策链 | 🔀 | 有关键决策时 | +| 各角色观点 | 👥 | 跨组协作时 | + +--- + +> 下一章：[第14章 · 异常处理与红线](14_异常处理与红线.md) diff --git a/运营中枢/使用手册/第四篇_运营中枢/14_异常处理与红线.md b/运营中枢/使用手册/第四篇_运营中枢/14_异常处理与红线.md new file mode 100644 index 00000000..a9c7dce0 --- /dev/null +++ b/运营中枢/使用手册/第四篇_运营中枢/14_异常处理与红线.md @@ -0,0 +1,42 @@ +# 第14章 · 异常处理与红线 + +> 返回 [总目录](../README.md) | 上一章 [第13章](13_复盘格式.md) + +--- + +## 14.1 异常处理规则 + +| 场景 | 处理方式 | +|:---|:---| +| 未匹配到技能 | 推荐 2～3 个相关技能；仍不行则从 GitHub/网上学习扩展 | +| SKILL 路径存在但文件不存在 | 降级为无该技能，走通用流程 | +| 外部 API 失败 | 自动搜索解决方案，循环重试直到成功 | +| 同一句触发多技能 | 合并执行，不让用户选择 | +| 漏复盘 | 发现后必须补发 | +| 对话 ≥20 轮 | 压缩前 10 轮为摘要，保留最近 10 轮 | +| 跨组某组无响应 | 跳过该组，大总管裁决，复盘标注 | +| Pipeline 某步重试 2 次仍失败 | 标记降级，跳过继续（非强依赖时） | +| 单步超时 | 允许异步继续，不中断 | + +## 14.2 三条红线（禁止） + +| # | 红线 | 说明 | +|:--:|:---|:---| +| 1 | **不改变卡若AI 整体结构** | 不新建与五行并列的独立功能目录 | +| 2 | **不导致电脑无法启动** | 不破坏系统启动、关键配置 | +| 3 | **不删除重大文件** | 删除前必须备份确认 | + +## 14.3 API 容错 + +卡若AI 网关启用接口队列容错： + +- 使用 `OPENAI_API_BASES` 配置接口队列（逗号分隔） +- 单接口失败自动切换下一接口 +- 全部失败：触发邮件告警 + 返回降级回复 +- 告警冷却时间默认 300 秒 + +详见 `.cursor/rules/api-failover-stability.mdc`。 + +--- + +> 下一章：[第15章 · 记忆系统](15_记忆系统.md) diff --git a/运营中枢/使用手册/第四篇_运营中枢/15_记忆系统.md b/运营中枢/使用手册/第四篇_运营中枢/15_记忆系统.md new file mode 100644 index 00000000..d07ec4ba --- /dev/null +++ b/运营中枢/使用手册/第四篇_运营中枢/15_记忆系统.md @@ -0,0 +1,56 @@ +# 第15章 · 记忆系统 + +> 返回 [总目录](../README.md) | 上一章 [第14章](14_异常处理与红线.md) + +--- + +## 15.1 唯一记忆源 + +**路径**：`/Users/karuo/Documents/个人/1、卡若：本人/记忆.md` + +单文件、无子目录。每次对话开始自动读取，作为长期记忆与偏好参考。 + +## 15.2 记忆检索顺序（强制） + +当需要查找信息时，按以下顺序： + +``` +① 当日工作台 CURRENT_STATE.md + ↓ +② 任务结果卡 structured/tasks/YYYY-MM-DD.md + ↓ +③ 长期记忆 记忆.md + ↓ +④ 结构化摘要 daily_digest.md + agent_results.json + ↓ +⑤ 对话归档 + ↓ +⑥ 历史归档 archive/ +``` + +## 15.3 写入规则 + +| 规则 | 说明 | +|:---|:---| +| 写什么 | 长期有价值信息：偏好、规则、目标、人脉、原则、读书笔记 | +| 格式 | 每条 1～2 行，带时间戳 `[HH:MM]`，按日期分组 | +| 禁止 | 不写密码/密钥/Token；不随意改删已有条目 | +| 去重 | 同一天相同条目不重复写入 | +| 冲突检测 | 写入前执行 `python memory_conflict_check.py "内容"` | + +## 15.4 与卡若人设联动 + +调动记忆时以**卡若角色**参与——不是冷调取数据，而是用卡若的立场、语气和判断理解运用记忆。记忆与 `1、卡若：本人/` 下的个人档案联动。 + +## 15.5 记忆分类 + +记忆以标签区分，统一写在同一文件： + +- `[工具]`：工具使用经验 +- `[原则]`：长期原则与规则 +- `[人脉]`：人际关系与联系 +- `[项目]`：项目进展与里程碑 + +--- + +> 下一章：[第16章 · 基因胶囊](16_基因胶囊.md) diff --git a/运营中枢/使用手册/第四篇_运营中枢/16_基因胶囊.md b/运营中枢/使用手册/第四篇_运营中枢/16_基因胶囊.md new file mode 100644 index 00000000..973876b9 --- /dev/null +++ b/运营中枢/使用手册/第四篇_运营中枢/16_基因胶囊.md @@ -0,0 +1,57 @@ +# 第16章 · 基因胶囊 + +> 返回 [总目录](../README.md) | 上一章 [第15章](15_记忆系统.md) + +--- + +## 16.1 什么是基因胶囊 + +基因胶囊是卡若AI 的**技能遗传机制**：将验证过的 Skill 打包成可传递、可继承的能力单元。 + +**公式**：基因胶囊 = 策略（SKILL）+ 环境指纹 + 审计记录 + 资产 ID + +## 16.2 三个操作 + +| 操作 | 命令 | 说明 | +|:---|:---|:---| +| **pack** | `gene_capsule.py pack ` | 将 Skill 打包为胶囊 | +| **unpack** | `gene_capsule.py unpack ` | 胶囊还原为 Skill | +| **list** | `gene_capsule.py list` | 查看所有已打包胶囊 | +| **pack-all** | `gene_capsule.py pack-all` | 全量打包所有 Skill | + +## 16.3 胶囊结构 + +```yaml +version: "1.0" +capsule_id: "sha256:..." +manifest: + name: 技能名称 + description: 一句话说明 + triggers: [触发词列表] + owner: 归属成员 + group: 归属负责人 + skill_path: 原始 SKILL 路径 +skill_content: | + (SKILL.md 原文) +created_at: "2026-03-12T10:00:00" +updated_at: "2026-03-12T10:00:00" +``` + +**资产 ID 计算**：`capsule_id = "sha256:" + SHA256(skill_path + skill_content 前 8192 字符)` + +## 16.4 存储位置 + +| 位置 | 说明 | +|:---|:---| +| `卡若Ai的文件夹/导出/基因胶囊/` | 本地导出目录 | +| `05_卡土（土）/土砖_技能复制/基因胶囊/capsule_index.json` | 胶囊索引 | + +## 16.5 使用场景 + +- 迁移到新 AI 环境时：打包→传输→解包 +- 给其他项目复制能力：pack → 拷贝 → unpack +- 能力审计：查看每个胶囊的来源与版本 + +--- + +> 下一章：[第17章 · 协同与 Pipeline](17_协同与Pipeline.md) diff --git a/运营中枢/使用手册/第四篇_运营中枢/17_协同与Pipeline.md b/运营中枢/使用手册/第四篇_运营中枢/17_协同与Pipeline.md new file mode 100644 index 00000000..6f7a1a8e --- /dev/null +++ b/运营中枢/使用手册/第四篇_运营中枢/17_协同与Pipeline.md @@ -0,0 +1,71 @@ +# 第17章 · 协同与 Pipeline + +> 返回 [总目录](../README.md) | 上一章 [第16章](16_基因胶囊.md) + +--- + +## 17.1 协同规范 + +### 架构层级 + +大总管（卡若AI）→ 组长（五行负责人）→ 成员（14 人） + +### 四种协作模式 + +| 模式 | 说明 | 适用场景 | +|:---|:---|:---| +| 串行流水线 | A → B → C 逐步传递 | 有强依赖的任务 | +| 并行委派 | 同时分发多个子任务 | 相互独立的子任务 | +| 计划者-执行者 | 水泉拆解，成员执行 | 需求拆解后分工 | +| Pipeline | 长流程自动化 | 标准化流程 | + +### 文件写入权 + +各技能目录仅归属成员可写。跨组通过任务交接单协作，不直接改对方文件。 + +### 跨组收敛 + +2 组以上参与时：各组出「观点 + 依据 + 置信度」，轮次讨论，大总管裁决。 + +## 17.2 三大 Pipeline + +### Pipeline A · 新项目上线 + +``` +土基（商业分析）→ 水泉（需求拆解）→ 木果（项目生成） +→ 火炬（全栈开发）→ 火锤（代码修复）→ 金仓（部署） +→ 水溪（归档）→ 土砖（基因胶囊，可选） +``` + +### Pipeline B · 内容发布 + +``` +木叶（视频切片）→ 火炬/水溪（文档清洗） +→ 土渠（流量投放）→ 水溪（归档） +``` + +### Pipeline C · 日常运维 + +``` +金仓（系统监控）→ 金仓（磁盘清理） +→ 金仓（容灾备份）→ 水溪（归档日志） +``` + +### 失败处理 + +1. 某步失败 → 本步重试 1 次 +2. 仍失败 → 回退上一步，检查输入后再试 1 次 +3. 再失败 → 停止 Pipeline，向用户汇报 + +## 17.3 工作台与控制台 + +| 工具 | 路径 | 用途 | +|:---|:---|:---| +| 当前任务看板 | `运营中枢/工作台/当前任务看板.md` | 查看进行中的任务 | +| 技能控制台 | `运营中枢/工作台/01_技能控制台.md` | 技能配置、安装、登记 | +| Gitea 推送记录 | `运营中枢/工作台/gitea_push_log.md` | 同步记录 | +| 端口登记 | `运营中枢/工作台/端口登记/SKILL.md` | 端口防冲突 | + +--- + +> 下一篇：[第五篇 · 卡若AI 网站](../第五篇_卡若AI网站/18_网站总览.md) diff --git a/运营中枢/使用手册/附录/A_全量技能速查表.md b/运营中枢/使用手册/附录/A_全量技能速查表.md new file mode 100644 index 00000000..99a1d39e --- /dev/null +++ b/运营中枢/使用手册/附录/A_全量技能速查表.md @@ -0,0 +1,117 @@ +# 附录 A · 全量技能速查表 + +> 返回 [总目录](../README.md) | 69 技能 · 14 成员 · 5 负责人 + +--- + +## 金组 · 卡资（21 技能） + +| # | 技能 | 成员 | 触发词 | +|:--|:---|:---|:---| +| G01 | 群晖NAS管理 | 金仓 | NAS、群晖、Docker | +| G02 | Gitea管理 | 金仓 | Gitea、推送、Git | +| G03 | 磁盘清理 | 金仓 | 清理磁盘、释放空间 | +| G04 | 容灾备份 | 金仓 | 备份、灾备 | +| G05 | 照片分类 | 金仓 | 照片整理、相册 | +| G06 | 分布式算力管控 | 金仓 | 算力、PCDN、节点 | +| G07 | 服务器管理 | 金仓 | 宝塔、部署、SSL | +| G08 | 系统监控 | 金仓 | 系统状态、杀进程 | +| G09 | iPhone管理 | 金仓 | iPhone备份、连接 | +| G10 | 局域网控制 | 金仓 | 设备管理、局域网扫描 | +| G11 | iCloud管理 | 金仓 | iCloud优化、排除目录 | +| G12 | 微信管理 | 金仓 | 微信分析、RFM | +| G13 | 数据库管理 | 金仓 | MySQL、清理数据库 | +| G14 | 文件整理 | 金仓 | 整理文件、外置硬盘 | +| G15 | 存客宝 | 金盾 | 存客宝、cunkebao | +| G16 | 远程环境一键部署 | 金盾 | 远程部署、装Clash | +| G17 | 数据库管理(安全) | 金盾 | 数据库、备份数据 | +| G18 | 微信管理(安全) | 金盾 | 微信数据库解析 | +| G19 | Vercel部署 | 金盾 | Vercel、v0 | +| G19b | 存客宝副本管理 | 金盾 | 存客宝副本、副本代码 | +| G20 | 个人档案生成器 | 金盾 | 个人档案 | + +## 水组 · 卡人（16 技能） + +| # | 技能 | 成员 | 触发词 | +|:--|:---|:---|:---| +| W01 | 文件整理 | 水溪 | 整理文件、外置硬盘 | +| W02 | 文档清洗 | 水溪 | PDF转Markdown | +| W03 | 对话归档 | 水溪 | 归档今日对话 | +| W03a | 项目调研 | 水溪 | 项目调研、平台分析 | +| W04 | 自动记忆管理 | 水溪 | 记忆、存入记忆 | +| W05 | 需求拆解与计划制定 | 水泉 | 需求拆解、任务分析 | +| W06 | 任务规划 | 水泉 | 任务规划、制定计划 | +| W07 | 飞书管理 | 水桥 | 飞书日志、写入飞书 | +| W08 | 智能纪要 | 水桥 | 会议纪要、飞书妙记 | +| W09 | 小程序管理 | 水桥 | 小程序、微信小程序 | +| W10 | Soul创业实验 | 水桥 | Soul文章、第9章 | +| W11 | Soul派对运营报表 | 水桥 | 运营报表、派对填表 | +| W11a | Soul发到素材库 | 水桥 | 成片发飞书 | +| W12 | MCP搜索与连接 | 水桥 | MCP、找MCP | +| W13 | Excel表格与日报 | 水桥 | Excel写飞书 | +| W14 | 卡猫复盘 | 水桥 | 卡猫复盘、婼瑄复盘 | +| W15 | 接收短信 | 水桥 | 接收短信、接码 | + +## 木组 · 卡木（16 技能） + +| # | 技能 | 成员 | 触发词 | +|:--|:---|:---|:---| +| M01 | 视频切片 | 木叶 | 视频剪辑、切片发布 | +| M01b | 抖音视频解析 | 木叶 | 抖音链接、抖音下载 | +| M01c | 抖音发布 | 木叶 | 抖音发布、抖音上传 | +| M01d | B站发布 | 木叶 | B站发布、bilibili | +| M01e | 视频号发布 | 木叶 | 视频号发布 | +| M01f | 小红书发布 | 木叶 | 小红书发布 | +| M01g | 快手发布 | 木叶 | 快手发布 | +| M01h | 多平台分发 | 木叶 | 一键分发、全平台发布 | +| M02 | 网站逆向分析 | 木根 | 逆向分析、模拟登录 | +| M03 | 项目生成 | 木果 | 生成项目、五行模板 | +| M04 | 开发模板 | 木果 | 创建项目、初始化模板 | +| M05 | 个人档案生成器 | 木果 | 个人档案、档案生成 | +| M06 | 前端生成 | 木果 | 前端生成、UI | +| M07 | PPT制作 | 木果 | PPT、做PPT | +| M08 | Next AI Draw | 木果 | AI画图、架构图 | +| M09 | 卡若个人介绍 | 木果 | 卡若介绍、个人介绍 | + +## 火组 · 卡火（17 技能） + +| # | 技能 | 成员 | 触发词 | +|:--|:---|:---|:---| +| F01 | 全栈开发 | 火炬 | 官网开发、全站开发 | +| F01a | 前端开发 | 火炬 | 前端开发、毛玻璃 | +| F01b | 全栈测试 | 火炬 | 功能测试、回归测试 | +| F02 | 消息中枢 | 火炬 | WhatsApp、Telegram | +| F03 | 读书笔记 | 火炬 | 拆解这本书 | +| F04 | 文档清洗 | 火炬 | 文档清洗、PDF转MD | +| F05 | 代码修复 | 火锤 | 代码修复、Bug | +| F06 | 智能追问 | 火眼 | 追问模式、需求澄清 | +| F07 | 读书笔记(模型) | 火种 | 五行拆书 | +| F08 | 本地模型 | 火种 | ollama、qwen | +| F09 | 开发文档操控 | 火炬 | 开发文档操控 | +| F10 | 上帝之眼 | 火炬 | 监控、上帝之眼 | +| F11 | 量化交易 | 火炬 | 量化、交易 | +| F12 | 对话归档 | 火炬 | 对话归档 | +| F13 | 卡若日记写作 | 火种 | 日记、写日记 | +| F21 | 本地代码库索引 | 火种 | 本地索引、本地搜索 | +| F22 | 本地项目启动 | 火炬 | 本地运行、Docker部署 | + +## 土组 · 卡土（10 技能） + +| # | 技能 | 成员 | 触发词 | +|:--|:---|:---|:---| +| E01 | 商业工具集 | 土基 | 商业分析、竞品 | +| E02 | 技能工厂 | 土砖 | 创建技能、生成Skill | +| E02a | 全站捆绑分销体系 | 土砖 | 全站捆绑、分销体系 | +| E07 | 基因胶囊 | 土砖 | 打包技能、解包胶囊 | +| E03 | 流量自动化 | 土渠 | 刷流量、SEO | +| E04 | 手机流量自动操作 | 土渠 | 手机自动化、AutoGLM | +| E05 | 财务管理 | 土簿 | 财务、报表 | +| E05a | 公司财务 | 土簿 | 公司财务、芸归喜 | +| E05b | 家庭财务 | 土簿 | 家庭财务、鲨鱼记账 | +| E06 | 商业工具集(财务) | 土簿 | 商业分析 | + +## 工作台 + +| # | 技能 | 触发词 | +|:--|:---|:---| +| G21 | 端口登记 | 端口登记、端口注册 | diff --git a/运营中枢/使用手册/附录/B_常用命令与脚本.md b/运营中枢/使用手册/附录/B_常用命令与脚本.md new file mode 100644 index 00000000..00a35e82 --- /dev/null +++ b/运营中枢/使用手册/附录/B_常用命令与脚本.md @@ -0,0 +1,83 @@ +# 附录 B · 常用命令与脚本 + +> 返回 [总目录](../README.md) + +--- + +## Gitea 同步 + +```bash +bash 01_卡资（金）/金仓_存储备份/Gitea管理/脚本/自动同步.sh +``` + +每次对话有文件变更时自动执行，单文件 >20MB 不提交。 + +## 飞书今日日志 + +```bash +python 02_卡人（水）/水桥_平台对接/飞书管理/脚本/write_today_three_focus.py +``` + +直接执行不询问，写入三件事 + 未完成事项。 + +## 基因胶囊 + +```bash +python 05_卡土（土）/土砖_技能复制/基因胶囊/gene_capsule.py pack +python 05_卡土（土）/土砖_技能复制/基因胶囊/gene_capsule.py unpack +python 05_卡土（土）/土砖_技能复制/基因胶囊/gene_capsule.py list +python 05_卡土（土）/土砖_技能复制/基因胶囊/gene_capsule.py pack-all +``` + +## 每日对话收集 + +```bash +python 02_卡人（水）/水溪_整理归档/记忆系统/collect_chat_daily.py +``` + +每天首次对话时执行一次。 + +## 记忆冲突检测 + +```bash +python 02_卡人（水）/水溪_整理归档/记忆系统/memory_conflict_check.py "要写入的内容" +``` + +写入长期记忆前执行。 + +## 日历去重 + +```bash +osascript 02_卡人（水）/水桥_平台对接/飞书管理/脚本/calendar_remove_dupes_today_and_future.applescript +``` + +## 卡若AI 网关 + +```bash +cd 运营中枢/scripts/karuo_ai_gateway +uvicorn main:app --host 0.0.0.0 --port 8000 +``` + +## Docker 项目部署 + +```bash +docker compose up -d --build +``` + +部署后须用 `--build` 保证使用本地最新代码。 + +## Cursor 缓存清理 + +```bash +bash 运营中枢/参考资料/scripts/clear_cursor_cache.sh +``` + +Cursor 闪退或卡顿时执行。 + +## 外网调用卡若AI + +```bash +curl -s -X POST "https://kr-ai.quwanzhi.com/v1/chat" \ + -H "Content-Type: application/json" \ + -d '{"prompt":"你的问题"}' | jq -r '.reply' +``` diff --git a/运营中枢/使用手册/附录/C_FAQ.md b/运营中枢/使用手册/附录/C_FAQ.md new file mode 100644 index 00000000..5f5fae84 --- /dev/null +++ b/运营中枢/使用手册/附录/C_FAQ.md @@ -0,0 +1,55 @@ +# 附录 C · FAQ + +> 返回 [总目录](../README.md) + +--- + +## 关于卡若AI + +**Q：卡若AI 是什么？** +A：卡若的个人数字管家与智能大总管。一套「身份+团队+69技能+规则」的体系，可加载到任何 AI 平台运行。 + +**Q：和 ChatGPT / Claude / Cursor 是什么关系？** +A：卡若AI 运行在它们之上。它不替代这些平台，而是为它们加载一套团队分工与技能规则。 + +**Q：5 个角色、14 个成员、69 技能是什么意思？** +A：5 个负责人（金/水/木/火/土）下挂 14 个成员，每人若干技能。按触发词在 SKILL_REGISTRY 中查找。 + +--- + +## 关于使用 + +**Q：没有 Cursor 能用吗？** +A：可以。把 BOOTSTRAP.md 和 SKILL_REGISTRY.md 给任意 AI 作上下文即可；也可通过外网 API 调用。 + +**Q：怎么用卡若AI？** +A：用自然语言说需求即可。卡若AI 自动匹配技能执行。也可用 `@成员名` 指定。 + +**Q：外网怎么调用？** +A：`POST https://kr-ai.quwanzhi.com/v1/chat`，Body 为 `{"prompt":"问题"}`。 + +--- + +## 关于网站 + +**Q：卡若AI网站和主仓库的关系？** +A：网站是门面与说明书（展示+控制台），主仓库是大脑与执行环境（规则+技能）。 + +**Q：网站能直接"用"卡若AI 吗？** +A：首页和 `/chat` 可以对话，但完整能力需在 Cursor 等中加载 BOOTSTRAP 执行。 + +**Q：网站技术栈？** +A：Next.js 14 + React 18 + Tailwind CSS + SQLite/MongoDB。 + +--- + +## 关于运维 + +**Q：部署在哪？** +A：Docker 容器部署在群晖 NAS，通过 frp 暴露外网端口 3102。 + +**Q：数据库用什么？** +A：唯一 MongoDB 实例（`datacenter_mongodb:27017`），网站用 `karuo_site` 库。 + +**Q：怎么更新手册？** +A：有技能新增/变更时，更新对应章节并在附录 D 追加更新记录。 diff --git a/运营中枢/使用手册/附录/D_更新记录.md b/运营中枢/使用手册/附录/D_更新记录.md new file mode 100644 index 00000000..38f0e4b8 --- /dev/null +++ b/运营中枢/使用手册/附录/D_更新记录.md @@ -0,0 +1,25 @@ +# 附录 D · 更新记录 + +> 返回 [总目录](../README.md) + +--- + +## 手册版本变更日志 + +| 日期 | 版本 | 变更说明 | +|:---|:--:|:---| +| 2026-03-12 | v2.0 | 手册重构为多文件书籍结构：6篇24章+4附录；按篇分子文件夹，每章独立 .md；覆盖全部架构、69技能、网站功能、运营规范、进阶用法 | +| 2026-03-01 | v1.0 | 初版：单文件，目录+五组+运营中枢章节，与 SKILL_REGISTRY 对齐 | +| 2026-02-22 | — | 使用手册独立目录：主手册与对话沉淀规则迁至 `运营中枢/使用手册/` | + +--- + +## 更新规则 + +新增/变更技能或功能时： + +1. 在对应章节（第7～11章）更新技能表格 +2. 如涉及运营规范变更，更新第四篇对应章节 +3. 如涉及网站功能变更，更新第五篇对应章节 +4. 在本表追加一行变更记录 +5. 同步更新 `SKILL_REGISTRY.md` 和 `01_技能控制台.md` diff --git a/运营中枢/工作台/gitea_push_log.md b/运营中枢/工作台/gitea_push_log.md index 1f24572a..69ddaf0c 100644 --- a/运营中枢/工作台/gitea_push_log.md +++ b/运营中枢/工作台/gitea_push_log.md @@ -308,3 +308,4 @@ | 2026-03-12 12:26:12 | 🔄 卡若AI 同步 2026-03-12 12:26 | 更新：水桥平台对接、运营中枢工作台 | 排除 >20MB: 11 个 | | 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 个 | diff --git a/运营中枢/工作台/代码管理.md b/运营中枢/工作台/代码管理.md index c67bdec8..26dd099f 100644 --- a/运营中枢/工作台/代码管理.md +++ b/运营中枢/工作台/代码管理.md @@ -311,3 +311,4 @@ | 2026-03-12 12:26:12 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-12 12:26 | 更新：水桥平台对接、运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) | | 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) |