AIWiki — 你的跨 IDE 知识管家

当用户在对话中说 push to aiwiki（或 保存到 aiwiki、push this to aiwiki、把上面这个方案 push to aiwiki、记到 aiwiki 等），将当前对话中最近的讨论、方案、代码片段自动提取并保存为知识卡片。

核心工作流

1. 存入知识

触发词: push to aiwiki / save to aiwiki / push this to aiwiki / 把xxx push to aiwiki / 记录这个到 aiwiki / 记到 aiwiki / remember this in aiwiki / 存到 aiwiki

执行步骤:

1. 取当前对话中最近一轮的问答/讨论内容作为素材
2. 将素材作为 stdin 传给 scripts/extract.py，提取 title / tags / source / content_md
3. 将 extract.py 输出的 JSON 通过管道传给 scripts/push.py
4. 输出 push 结果（条目 ID、远程路径、标题、标签）

命令模板:

echo '<素材文本>' | python aiwiki/scripts/extract.py | python aiwiki/scripts/push.py

2. 检索知识

触发词: search aiwiki / 搜一下 aiwiki / 查 aiwiki / 问 aiwiki / what does aiwiki have about / find in aiwiki

执行步骤:

1. 运行 python aiwiki/scripts/search.py — 它内部会先增量同步再检索
2. 将搜索结果展示给用户（标题、标签、文件路径）

3. 浏览与管理

| 触发词 | 命令 | 说明 |

|--------|------|------|

| aiwiki list / aiwiki recent | 读取 ~/.aiwiki/mirror/ 最近修改的 10 个文件 | 列出最近知识 |

| aiwiki config / aiwiki setup | python aiwiki/scripts/config.py | 交互配置存储后端 |

| aiwiki sync | python aiwiki/scripts/pull.py | 手动增量同步 |

| aiwiki sync --full | python aiwiki/scripts/pull.py --full | 全量同步 |

| aiwiki sync up / sync to remote | python aiwiki/scripts/syncup.py | 推送本地新文件到远程 |

| aiwiki status | 读取 ~/.aiwiki/sync_state.json | 查看同步状态 |

支持的 AI Agent / IDE

> 所有 Agent 共享同一套本地镜像 ~/.aiwiki/mirror/，知识互通。

| Agent / IDE | 状态 | 说明 |

|-------------|------|------|

| Codex | ✅ 已测试 | OpenAI Codex CLI & Desktop |

| OpenClaw | ✅ 已测试 | 开源 AI 编程助手 |

| Claude Code | ⚪ 待测试 | Anthropic Claude Code |

| OpenCode | ✅ 已测试 | 开源 AI 编程助手 |

| Hermes | ✅ 已测试 | AI 编程助手 |

| Cursor | ⚪ 待测试 | AI-first IDE |

| Windsurf | ⚪ 待测试 | AI-first IDE |

| Copilot Chat | ⚪ 待测试 | GitHub Copilot |

| Cline | ⚪ 待测试 | VS Code AI 插件 |

| 通义灵码 | ⚪ 待测试 | 阿里通义灵码 |

存储类型

用户通过 aiwiki config 选择存储后端。所有适配器统一接口：connect / push / pull / list_files / list_since

| 适配器 | 状态 | 协议 | 说明 |

|--------|------|------|------|

| local | ✅ 已测试 | 本地目录 | 默认，数据在 ~/.aiwiki/remote/ |

| aliyundrive | ✅ 已测试 | 阿里云盘 v2 API | 需 refresh_token，秒传支持 |

| webdav | ⚪ 待测试 | WebDAV | 坚果云 / NextCloud / ownCloud |

| s3_oss | ⚪ 待测试 | S3 兼容 | 阿里云 OSS / AWS S3 / MinIO |

| ftp | ⚪ 待测试 | FTP | 标准文件传输 |

| email | ✅ 已测试 | SMTP | 网易企业邮箱等，发件即存储 |

| mqtt | ⚪ 待测试 | MQTT | 发布到 Broker，订阅者处理 |

| baidupan | ✅ 已测试 | 百度网盘 API | 需 access_token |

| tianyi | ⚠ RSA登录(需设备校验) | 天翼云盘 API | 代码完成，待浏览器 Cookie 认证 |

| wpscloud | ⚠ list-files 已修复 | WPS 开放平台 | 改用 search-files，待全流程复测 |

配置文件: ~/.aiwiki/config.json

本地镜像: ~/.aiwiki/mirror/（多 IDE 共享）

同步状态: ~/.aiwiki/sync_state.json

数据格式

每条知识对应一个 Markdown 文件，带 YAML frontmatter:

---
id: 20260607-143022-a1b2c3
title: "Docker 网络配置技巧"
tags: ["docker", "networking"]
source: codex
created: "2026-06-07T14:30:22+08:00"
---
知识内容...

远程目录结构按日期分层: /aiwiki/YYYY/MM/DD/{id}.md