🔄 卡若AI 同步 2026-03-04 19:37 | 更新：运营中枢参考资料、运营中枢工作台 | 排除 >20MB: 11 个

2026-03-04 19:37:12 +08:00
parent 867e1229ed
commit 88a3a18fbe
7 changed files with 326 additions and 6 deletions
--- a/运营中枢/参考资料/Cursor_API获取与使用说明.md
+++ b/运营中枢/参考资料/Cursor_API获取与使用说明.md
@@ -0,0 +1,90 @@
+# Cursor API 获取与使用说明
+
+> 整理自 Cursor 官方文档（api.cursor.com / cursor.com/docs），便于在卡若AI 内查阅。  
+> 更新：2026-03-04
+
+---
+
+## 一、两种「API」含义
+
+| 含义 | 说明 | 获取/配置入口 |
+|------|------|----------------|
+| **Cursor 自家 API** | 用 API Key 调用 Cursor 提供的接口（团队管理、分析、AI 代码追踪、Cloud Agents 等） | 见下文「二、创建 Cursor API Key」 |
+| **Cursor 里配置的第三方 API** | 在 Cursor 里填 OpenAI / Anthropic / 自建网关等 Key，让 Cursor 用你的 Key 调模型 | **Cursor → Settings → API Keys** |
+
+---
+
+## 二、创建 Cursor API Key（Cursor 自家接口）
+
+- **Base URL**：`https://api.cursor.com`
+- **认证方式**：Basic Authentication（用户名 = API Key，密码留空）
+
+### 1. Admin API & AI Code Tracking API（团队管理、AI 代码追踪）
+
+- **适用**：Enterprise 团队
+- **创建步骤**：
+  1. 打开 [cursor.com/dashboard](https://cursor.com/dashboard)
+  2. 进入 **Settings** 标签 → **Advanced** → **Admin API Keys**
+  3. 点击 **Create New API Key**
+  4. 给 Key 起名（如 "Usage Dashboard"）
+  5. **创建后立即复制**：Key 只显示一次，格式类似 `key_xxxxxxxx...`
+
+### 2. Analytics API（团队使用与 AI 指标）
+
+- **适用**：Enterprise 团队
+- **创建**：在 [团队设置页](https://cursor.com/settings) 生成 API Key
+
+### 3. Cloud Agents API（云端 AI 编程 Agent，Beta）
+
+- **适用**：Beta，所有计划可用
+- **创建**：[Cursor Dashboard → Integrations](https://cursor.com/dashboard?tab=integrations) 创建 API Key
+
+---
+
+## 三、调用示例（Basic Auth）
+
+```bash
+# 使用 curl（Key 作为用户名，密码为空）
+curl -X GET "https://api.cursor.com/analytics/ai-code/commits?startDate=7d&endDate=now&page=1&pageSize=100" \
+  -u YOUR_API_KEY:
+```
+
+或设置请求头：
+
+```bash
+Authorization: Basic $(echo -n "YOUR_API_KEY:" | base64)
+```
+
+---
+
+## 四、主要 API 与限制（摘要）
+
+| API | 用途 | 可用范围 | 限流（约） |
+|-----|------|----------|------------|
+| Admin API | 成员、设置、用量、支出 | Enterprise | 20 次/分钟（部分端点 250） |
+| Analytics API | 团队用量、AI 指标、DAU、模型使用 | Enterprise | 100/50 次/分钟 |
+| AI Code Tracking API | 按 commit/change 追踪 AI 生成代码 | Enterprise | 20 次/分钟/端点 |
+| Cloud Agents API | 创建与管理 AI 编程 Agent | Beta（全计划） | 标准限流 |
+
+- 限流触发会返回 **429**，需做退避重试。
+- 详细端点与参数见：[Cursor API 总览](https://cursor.com/docs/api.md)、[AI Code Tracking](https://cursor.com/docs/account/teams/ai-code-tracking-api)、[Admin API](https://cursor.com/docs/account/teams/admin-api)。
+
+---
+
+## 五、在 Cursor 里配置「自己的模型 API」（第三方 Key）
+
+若目的是让 **Cursor 使用你自己的 OpenAI / Claude / 网关**，而不是调用 Cursor 的接口：
+
+1. 打开 **Cursor → Settings（设置）→ API Keys**
+2. 填写对应服务的 Base URL 与 API Key（如 OpenAI、Anthropic、OpenRouter、或卡若AI 网关 `http://localhost:8000`）
+3. 保存后，Cursor 会用这些 Key 请求模型，用量与计费走你的账号
+
+卡若AI 网关在 Cursor 中的配置方式见：`运营中枢/scripts/karuo_ai_gateway/README.md`（Cursor API Keys 填网关地址与 Key）。
+
+---
+
+## 六、相关文档
+
+- Cursor API 总览：https://cursor.com/docs/api.md  
+- 卡若AI 网关与多接口配置：`运营中枢/参考资料/API网关与常用AI配置说明.md`  
+- 账号与 API 索引：`运营中枢/工作台/00_账号与API索引.md`
--- a/运营中枢/参考资料/Cursor闪退排查_20260304.md
+++ b/运营中枢/参考资料/Cursor闪退排查_20260304.md
@@ -0,0 +1,55 @@
+# Cursor 自动关闭问题 · 日志分析与处理记录
+
+**日期**：2026-03-04  
+**现象**：Cursor 经常莫名自动关闭。  
+**原则**：不关闭硬件加速，保留视频/剪辑等所需能力，从根因入手。
+
+---
+
+## 一、日志结论与根因
+
+- **日志路径**：`~/Library/Application Support/Cursor/logs/`（按会话分目录，如 `20260304T190511`）
+- **直接表现**：
+  1. **渲染进程崩溃（code 5）**：`CodeWindow: renderer process gone (reason: crashed, code: 5)`，随后主进程未捕获异常 `Render frame was disposed before WebFrameMain could be accessed`，导致整个应用退出。
+  2. **Agent 分析 SQLite 报错**：`[AgentAnalyticsOperationsMainService] Error ... SQLITE_ERROR: cannot start a transaction within a transaction`（嵌套事务），在「存储 AI code hashes / marking commits as scored」时反复出现，可能加剧不稳定。
+  3. **窗口无响应**：`CodeWindow: detected unresponsive` 后有时恢复，有时被关掉。
+  4. **ptyHost 心跳超时**：`No ptyHost heartbeat after 6 seconds`，终端相关进程偶发无响应。
+
+- **根因（社区与日志综合）**：
+  - **code 5** 在 macOS 上多与 **V8/JS 内存（OOM）**、GC 压力、以及 **macOS mach port 通知失败** 有关，不一定与 GPU 驱动有关；硬件加速已保留，不通过关闭它来规避。
+  - **AgentAnalyticsOperationsMainService** 的嵌套事务是 Cursor 端 bug，需等官方修复或通过清理该服务数据缓解。
+
+---
+
+## 二、已做处理（不限制功能）
+
+1. **保持硬件加速开启**  
+   - `~/.cursor/argv.json` 中 **未** 启用 `disable-hardware-acceleration`，视频/剪辑相关能力不受影响。
+
+2. **本机已有设置**  
+   - `cursor.general.enableCodebaseIndexing": false` 已关闭，减轻后台索引压力。
+
+---
+
+## 三、建议操作（不关功能、从根因缓解）
+
+- **减轻内存压力**：少开不需要的窗口/工作区、关掉不用的标签页；大项目可考虑单独开一个 Cursor 窗口，避免单进程负载过大。
+- **清理缓存（可选）**：完全退出 Cursor 后删除  
+  `~/Library/Application Support/Cursor/GPUCache`  
+  以及必要时  
+  `~/Library/Application Support/Cursor/Cache`  
+  再重新打开，避免旧缓存加重 OOM。
+- **向 Cursor 官方反馈**：把闪退时间段的 `main.log`（含 code 5、Render frame disposed、AgentAnalytics SQLITE_ERROR）提交到 [Cursor Forum](https://forum.cursor.com) 或官方支持，便于他们修 code 5 与 SQLite 嵌套事务。
+- **保持 Cursor 更新**：当前 2.6.11，后续版本可能修复上述问题。
+
+若官方或社区后续提供「增加 JS 堆大小」等 argv 支持，再在 `argv.json` 中按文档配置，无需关闭硬件加速。
+
+---
+
+## 四、日志位置速查
+
+| 内容       | 路径 |
+|------------|------|
+| 主进程日志 | `~/Library/Application Support/Cursor/logs/<会话目录>/main.log` |
+| 窗口日志   | 同上目录下 `window1/`、`window2/` 等 |
+| 启动参数   | `~/.cursor/argv.json` |
--- a/运营中枢/参考资料/v0_API对接说明.md
+++ b/运营中枢/参考资料/v0_API对接说明.md
@@ -49,17 +49,27 @@

 ### 1. cURL

+**英文或简单内容**（可直接内联）：
+
 ```bash
 curl -X POST "https://api.v0.dev/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 你的V0_API_KEY" \
-  -d '{
-    "model": "v0-1.5-md",
-    "messages": [{"role": "user", "content": "写一个 React 按钮组件"}],
-    "max_tokens": 2048
-  }'
+  -d '{"model":"v0-1.5-md","messages":[{"role":"user","content":"Hello"}],"max_tokens":2048}'
 ```

+**含中文等非 ASCII 时**：若在 shell 里用 `-d '...中文...'` 易出现 500，请二选一：
+
+- **方式 A**：请求体写入 UTF-8 文件，用 `-d @文件` 发送：
+  ```bash
+  echo '{"model":"v0-1.5-lg","messages":[{"role":"user","content":"你好"}],"max_tokens":256}' > req.json
+  curl -X POST "https://api.v0.dev/v1/chat/completions" \
+    -H "Content-Type: application/json; charset=utf-8" \
+    -H "Authorization: Bearer 你的V0_API_KEY" \
+    -d @req.json
+  ```
+- **方式 B**：在 JSON 里用 Unicode 转义（如 `\u4f60\u597d` 表示「你好」），再内联 `-d '...'`。
+
 ### 2. JavaScript / Node（fetch）

 ```javascript
--- a/运营中枢/工作台/00_账号与API索引.md
+++ b/运营中枢/工作台/00_账号与API索引.md
@@ -1,7 +1,7 @@
 # 卡若 账号与 API 索引（明文存储）

 > 本机及项目内、**本机服务器、网站**的账号、密码、API、Secret **明文集中存放**，方便日后调取。  
-> 最后更新：2026-01-29
+> 最后更新：2026-03-04

 ---

@@ -60,6 +60,14 @@
 | 模型 | `claude-opus` |


+### n8n（本机工作流 API）
+| 项 | 值 |
+|----|-----|
+| 实例地址 | http://localhost:5678 |
+| API Key（JWT） | `eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJlOWM2NjFjNS1iZGE2LTRiNjctYmYxNi1iYTA3MDUzYmY2NTIiLCJpc3MiOiJuOG4iLCJhdWQiOiJwdWJsaWMtYXBpIiwianRpIjoiOThiNWQ4OWQtMjA1ZS00NDVhLWE0OGEtYWMzYzMyMmQzYmZmIiwiaWF0IjoxNzcyNjE2NzgxfQ.UU34FESy9AAzsZc2_NCv_kDLN3xZrFO5JAKMMHCyW2w` |
+| 请求头 | `X-N8N-API-KEY: <上表 JWT>` |
+| 说明 | 本机 n8n 工作流 Public API 认证；用于创建工作流、执行工作流等，详见 n8n 文档 API 章节 |
+
 ### Gitea（CKB NAS 自建 Git）
 | 项 | 值 |
 |----|-----|
@@ -150,6 +158,16 @@
 | 存客宝 | 42.194.245.239 | 2核16G 50M | 私域银行业务 | https://42.194.245.239:9988 |
 | kr宝塔 | 43.139.27.93 | 2核4G 5M | Node 项目主力 | https://43.139.27.93:9988 |

+### 阿猫/婼瑄 MacBook（SSH）
+
+| 项 | 值 |
+|----|-----|
+| 主机 | `macbook.quwanzhi.com` |
+| 端口 | `22203` |
+| 账号 | `kr` |
+| 密码 | `key123456` |
+| 连接命令 | `ssh -p 22203 kr@macbook.quwanzhi.com` |
+
 ### SSH 登录（root）

 | 项 | 值 |
--- a/运营中枢/工作台/gitea_push_log.md
+++ b/运营中枢/工作台/gitea_push_log.md
@@ -223,3 +223,4 @@
 | 2026-03-04 17:03:17 | 🔄 卡若AI 同步 2026-03-04 17:03 | 更新：卡木、运营中枢工作台 | 排除 >20MB: 11 个 |
 | 2026-03-04 17:09:09 | 🔄 卡若AI 同步 2026-03-04 17:09 | 更新：卡木、运营中枢工作台 | 排除 >20MB: 11 个 |
 | 2026-03-04 17:22:38 | 🔄 卡若AI 同步 2026-03-04 17:22 | 更新：卡木、运营中枢工作台 | 排除 >20MB: 11 个 |
+| 2026-03-04 17:30:38 | 🔄 卡若AI 同步 2026-03-04 17:30 | 更新：卡木、运营中枢工作台 | 排除 >20MB: 11 个 |
--- a/运营中枢/工作台/代码管理.md
+++ b/运营中枢/工作台/代码管理.md
@@ -226,3 +226,4 @@
 | 2026-03-04 17:03:17 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-04 17:03 | 更新：卡木、运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
 | 2026-03-04 17:09:09 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-04 17:09 | 更新：卡木、运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
 | 2026-03-04 17:22:38 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-04 17:22 | 更新：卡木、运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
+| 2026-03-04 17:30:38 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-04 17:30 | 更新：卡木、运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
--- a/运营中枢/工作台/阿猫Mac配置与健康分析_20260304.md
+++ b/运营中枢/工作台/阿猫Mac配置与健康分析_20260304.md
@@ -0,0 +1,145 @@
+# 阿猫 MacBook 配置与健康分析报告
+
+> 检查时间：2026-03-04  
+> 主机：macbook.quwanzhi.com:22203，用户 kr
+
+---
+
+## 一、硬件与系统配置
+
+| 项目 | 信息 |
+|------|------|
+| **CPU** | Intel Core i5-8279U @ 2.40GHz |
+| **内存** | 8 GB RAM |
+| **硬盘** | 251 GB 固态（APPLE SSD AP0256M），PCI-Express，APFS |
+| **系统** | macOS 15.7.4（Build 24G517） |
+| **电池** | 86%，当前接电源（AC），未在充电 |
+| **本机 IP** | 192.168.0.9（局域网）；另有 ham0 25.30.239.48（疑为 Tailscale/内网穿透） |
+
+---
+
+## 二、整机角色与用途（推断）
+
+- **主要使用者**：阿猫（婼瑄），当前常用账号 **kr**。
+- **用途**：
+  - 远程办公/协同：SSH 接入（macbook.quwanzhi.com:22203）、飞书（Lark/Feishu）、Cursor 安装器已挂载。
+  - 与卡若协同：iCloud 同步「婼瑄」目录（含卡若AI 等），用于卡猫复盘、文档协作。
+  - 日常：桌面有首页/账号备忘等文件，Downloads 有飞书安装包；浏览器相关缓存（Google Updater）。
+- **多账号**：本机存在多个用户账号（见下），可能为历史或双人使用。
+
+---
+
+## 三、账号与硬盘使用情况
+
+### 3.1 本机用户列表
+
+| 用户 | 主目录占用 | 说明 |
+|------|------------|------|
+| **kr** | 约 32 GB | 当前 SSH 与日常使用账号，阿猫主用 |
+| **karuo_1** | 约 21 GB | 占比较大，用途需确认（是否为卡若历史账号或备份） |
+| **karuo** | 约 5.5 GB | 另一账号 |
+| **kr1** | 0 B | 空主目录 |
+| **clipboard** | 0 B | 空主目录 |
+| **Shared** | 约 202 MB | 共享文件夹 |
+
+### 3.2 磁盘整体使用（关键）
+
+| 卷/分区 | 总容量 | 已用 | 可用 | 使用率 |
+|---------|--------|------|------|--------|
+| **系统卷 /** | 233 Gi | 10 Gi | 18 Gi | 37% |
+| **数据卷 /System/Volumes/Data** | 233 Gi | **196 Gi** | **18 Gi** | **92%** |
+| 预引导 Preboot | 233 Gi | 2.6 Gi | 18 Gi | 13% |
+| 虚拟机 VM | 233 Gi | 5.0 Gi | 18 Gi | 22% |
+| 挂载镜像 Cursor Installer | 1.5 Gi | 1.0 Gi | 416 Mi | 73% |
+| 挂载镜像 飞书 Feishu | 1.6 Gi | 1.4 Gi | 281 Mi | 84% |
+
+**结论**：**数据卷已用约 92%，仅剩约 18 GB 可用**，空间紧张，是当前最需要关注的问题。
+
+### 3.3 当前用户 kr 目录占用
+
+| 路径 | 占用 |
+|------|------|
+| **~/Library** | 约 22 GB（应用支持、缓存、iCloud、飞书等） |
+| ~/Downloads | 约 2.6 GB |
+| ~/Desktop | 约 27 MB（约 13 个文件） |
+| ~/Documents | 约 12 KB |
+| ~/Movies | 约 12 KB |
+| ~/.Trash | 0 B |
+
+### 3.4 系统级占用
+
+| 路径 | 占用 |
+|------|------|
+| /Applications | 约 11 GB |
+| /Library | 约 13 GB |
+
+### 3.5 大文件/大目录（>500MB，用户可见部分）
+
+- `~/Library/Application Support/Google/GoogleUpdater/crx_cache/`（浏览器扩展缓存）
+- `~/Library/Application Support/LarkShell/update/`（飞书更新包）
+- `~/Library/Application Support/LarkShell/sdk_storage/`（飞书 SDK 资源）
+- `~/Library/Mobile Documents/com~apple~CloudDocs/婼瑄/卡若AI/.git/objects/pack/`（iCloud 同步的卡若AI 仓库）
+- `~/Library/Mobile Documents/.Trash/karuo-ai/`（iCloud 废纸篓内旧仓库）
+- `~/Downloads/Feishu-darwin_x64-7.56.5-signed.dmg`
+- `~/Downloads/Feishu-darwin_x64-7.52.7-signed.dmg`
+
+---
+
+## 四、可能存在的问题与风险
+
+### 4.1 磁盘空间不足（高）
+
+- **现象**：数据卷使用率约 **92%**，仅剩约 **18 GB**。
+- **风险**：系统更新、应用更新可能失败；临时文件与缓存易占满，导致卡顿、无法写入、iCloud 同步异常。
+- **建议**：
+  - 清理 **kr** 的 ~/Downloads（如两个飞书 DMG 安装包可删）。
+  - 清理 **kr/Library/Caches**、**LarkShell/update** 中不需要的更新包与缓存。
+  - 检查 **karuo_1**（21 GB）是否仍需保留，可归档或删除不用账号的数据。
+  - 清空 iCloud 废纸篓（含 .Trash 里的 karuo-ai），并确认婼瑄/卡若AI 仅保留必要版本与分支，减少 .git 体积。
+  - 卸载不需要的应用程序；若 Cursor/飞书 已安装完成，可推出并删除桌面上的安装镜像（.dmg）。
+
+### 4.2 内存偏小（中）
+
+- **现象**：8 GB 内存，macOS 15 + 飞书 + 浏览器 + 多任务时易触发交换（swap）。
+- **表现**：多开应用时可能变慢、卡顿。
+- **建议**：尽量少同时开大应用；必要时关闭不用的浏览器标签或应用；若长期用作主力机，可考虑升级内存（若机型支持）。
+
+### 4.3 多用户与重复数据（中）
+
+- **现象**：存在 kr、karuo_1、karuo、kr1、clipboard 多个账号，其中 **karuo_1** 占约 21 GB。
+- **风险**：重复或历史数据占用空间，且不易管理。
+- **建议**：确认 karuo_1 / karuo 是否仍在使用；若不用，可归档后删除账号或迁移数据到外置盘/云端后再删。
+
+### 4.4 挂载的安装镜像（低）
+
+- **现象**：当前挂载了「Cursor Installer」和「飞书 Feishu」两个 .dmg。
+- **风险**：占用盘符与少量空间，若长期不弹出可能被误当作“外接盘”。
+- **建议**：若 Cursor 与飞书已安装完成，在 Finder 中推出这两个镜像并删除原 .dmg 文件（如 Downloads 里飞书安装包）。
+
+### 4.5 登录项与安全
+
+- **现象**：当前用户 **kr** 未发现登录项（未配置开机自启应用）。
+- **说明**：无异常；若需开机自启某应用，可在「系统设置 → 登录项」中配置。
+
+### 4.6 近期使用与稳定性
+
+- **最近重启**：2026-02-27 11:26 有一次重启。
+- **当前状态**：用户 **kr** 自 3 月 2 日 14:00 起持续登录（console），未见系统日志中明显报错片段。
+- **结论**：近期无异常重启或明显崩溃迹象，主要风险在磁盘与内存压力。
+
+---
+
+## 五、总体结论与优先建议
+
+| 优先级 | 问题 | 建议 |
+|--------|------|------|
+| **P0** | 数据卷仅剩约 18 GB，使用率 92% | 立即清理：Downloads 安装包、飞书/Lark 缓存与更新包、Caches；评估 karuo_1 与 iCloud 废纸篓/大 .git |
+| **P1** | 8 GB 内存 | 控制同时运行的应用数量；中长期可考虑升级内存 |
+| **P2** | 多用户与 21 GB 的 karuo_1 | 确认用途后归档或删除不用账号数据 |
+| **P2** | 挂载的 Cursor/飞书 DMG | 安装完成后推出并删除 .dmg 释放空间与界面 |
+
+**一句话**：这台阿猫的 MacBook 主要用来远程办公、飞书协作和与卡若的 iCloud/卡若AI 协同；当前最需要做的是**给数据盘腾出空间**（清理到至少 25% 以上可用更稳妥），并适当控制多任务以减轻 8 GB 内存压力。
+
+---
+
+*报告依据：SSH 远程执行 system_profiler、diskutil、df、du、vm_stat、last、部分 log 与目录扫描结果。*