cortex-ingest
知识库构建 ingest — 接受 GitHub/GitLab/Website URL 或 local dir 输入, 自动识别+路由到 项目/<host>/<owner>/<repo>/ (本地 git repo 当 github/gitlab 处理, 非 git → 项目/local/<name>/). 默认 --apply 调度抓取 (gh/git clone/WebFetch 混合) + 落盘 (--dry-run opt-in 仅出 JSON plan 预览).
Datos de origen
- Repositorio
- lazygophers/ccplugin
- Última actividad en el origen
- 18 de agosto de 2026 a las 13:16
- Idioma detectado de SKILL.md
- chino
- Estrellas
- 4
- Forks
- 1
Opciones de instalación
De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.
Revisa los archivos de origen
Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.
Explorador de archivos
7 archivosMostrando SKILL.md
SKILL.md
Instrucciones de origen · Vista previa de solo lectura- name
- cortex-ingest
- description
- 知识库构建 ingest — 接受 GitHub/GitLab/Website URL 或 local dir 输入, 自动识别+路由到 项目/<host>/<owner>/<repo>/ (本地 git repo 当 github/gitlab 处理, 非 git → 项目/local/<name>/). 默认 --apply 调度抓取 (gh/git clone/WebFetch 混合) + 落盘 (--dry-run opt-in 仅出 JSON plan 预览).
- argument-hint
- [--dry-run|--apply] <source>
- arguments
- [--dry-run|--apply] <来源>
- user-invocable
- true
- context
- fork
- agent
- cortex-ingest-worker
# cortex-ingest
外部资源 → vault `项目/` 模块构建器. 接受 4 类输入, 识别 + 路由 + 计划. 默认 `--apply` 调度抓取 + 落盘 (`--dry-run` opt-in 仅出 plan 预览).
> 破坏性提示：默认 `--apply` 会向 vault `项目/` 落盘；只想看路由不落盘时显式传 `--dry-run`。
## 后台执行段 (cortex-ingest-worker 执行)
本段由 `context: fork` 派 `cortex-ingest-worker` 后台跑：识别下方输入速查表中的来源形态，解析 git remote，按规则算目标路径，必要时用 gh/WebFetch 探查元信息，默认 `--apply` 调度抓取 + 落盘。
```bash
bash scripts/ingest.sh [--target <vault>] --source <url-or-path>
```
默认 `--apply`, target = `$HOME/.cortex`. worker 默认调度抓取 (gh / git clone / WebFetch 混合) + 落盘 (website 等仅 sub-agent 可抓的 `fetch_method` 标 `needs_main` 由主会话补抓)，把入库结果 (source / target_path / fetch_method / frontmatter) 作为报告返回主会话。落盘后调用 `cortex-lint` 校验。
仅预览 (不落盘) 时显式传 `--dry-run`：
```bash
bash scripts/ingest.sh --dry-run [--target <vault>] --source <url-or-path>
```
## 输入速查表 (按顺序识别, 先命中先用)
| # | 输入形态 | 识别 | 目标路径 |
| --- | --- | --- | --- |
| 1 | `https://github.com/<o>/<r>` 或 `git@github.com:<o>/<r>.git` | URL host = github.com | `项目/github.com/<o>/<r>/` |
| 2 | `https://gitlab.com/<o>/<r>` 或 ssh gitlab | URL host = gitlab.com | `项目/gitlab.com/<o>/<r>/` |
| 3 | 其他 `https://<domain>/...` | URL host | `项目/<domain>/_/<slug>/` |
| 4 | local dir + `.git/config` remote 指向 github/gitlab | 读 remote URL 递归识别 | 按 1/2 处理 |
| 5 | local dir 无 git 或无 remote | 目录存在 | `项目/local/<basename>/` |
落盘文件: `README.md` (frontmatter 用 cortex-schema `templates/project/<variant>.md`).
## 何时读哪个
| 任务 | 文件 |
| --- | --- |
| 查 GitHub 抓取详情 (gh CLI / WebFetch fallback) | `sources/github.md` |
| 查 GitLab 抓取详情 (glab / WebFetch) | `sources/gitlab.md` |
| 查 Website 抓取详情 (WebFetch + slug) | `sources/website.md` |
| 查 local dir 抓取 (含 git remote 检测 + 转向逻辑) | `sources/local.md` |
| 查输入识别算法 + 优先序 + git remote 解析 | `references/routing.md` |
| 查 CLI vs sub-agent 抓取流程 + dry-run/apply + 游标 | `references/workflow.md` |
## 入口
```bash
bash scripts/ingest.sh [--dry-run|--apply] [--target <vault>] --source <url-or-path>
```
默认 `--apply`, target = `$HOME/.cortex`. `--dry-run` (opt-in 预览) 输出 JSON plan (source / target_path / fetch_method / frontmatter_preview)，不落盘.
## 相关
- 路径权威: `cortex-schema` (`templates/project/<variant>.md`)
- 边界: 与 `cortex-extract` 互补 (ingest = 抓外部资源进 vault; extract = L4-inbox 内部分类)
- 校验: `cortex-lint`
Ver en GitHub