技能介绍

你在解决什么问题

在多个 AI IDE 或 Agent 里反复讨论方案、贴代码片段时，上下文往往随会话结束而丢失；换工具或隔天再查，只能靠记忆或翻聊天记录。AIWiki（本技能）把「把刚才这段记下来」变成可重复的命令式工作流：用自然语言触发词从当前对话最近一轮抽取素材，落成带 YAML frontmatter 的 Markdown 知识卡片，并写入统一的本地镜像目录。

技能如何工作

存入知识：识别 push to aiwiki、记到 aiwiki 等触发词后，将最近问答作为 stdin 交给 scripts/extract.py 生成 title / tags / source / content_md，再管道到 scripts/push.py 完成写入，并回显条目 ID、远程路径、标题与标签。

检索与同步：search aiwiki 等触发词会运行 scripts/search.py（内部先增量同步再检索），返回标题、标签与文件路径。浏览侧支持 aiwiki list 读 ~/.aiwiki/mirror/ 最近文件；aiwiki sync / sync --full 对应 pull.py 增量或全量拉取；sync up 用 syncup.py 推送本地新文件。存储后端通过 aiwiki config 选择，适配器统一 connect / push / pull / list_files / list_since 接口，已测包括 local、aliyundrive、email、baidupan 等。

多 Agent 共享同一套 ~/.aiwiki/mirror/，远程按 /aiwiki/YYYY/MM/DD/{id}.md 分层；token 可通过 token_manager 与 vault 子命令做健康检查、刷新与备份恢复。

适用边界与注意点

抽取范围默认是最近一轮讨论，不是整段长会话自动归档；需要更完整记录时要明确说明或分次 push。
部分存储适配器（WebDAV、S3、FTP、MQTT 等）文档标注为待测或需额外认证（如天翼云盘 RSA、WPS 全流程复测），上线前应在你的环境里跑通 config 与 sync。
Cursor、Claude Code 等 IDE 在兼容表里为待测试，行为以你本地 Agent 是否允许执行上述 Python 脚本为准。

截图预览

使用场景

在 Codex 里敲定接口改造步骤后，说「记到 aiwiki」，把最近一轮讨论保存成卡片，次日换到 OpenCode 用 search aiwiki 找回上下文。
排查依赖版本冲突时对话里试了几种修复写法，用 push to aiwiki 把最终可运行片段和取舍理由写成条目备查。
在新机器或新 Agent 里开工前执行 aiwiki sync，从已配置的本地目录或云盘 remote 增量拉回 ~/.aiwiki/mirror/ 再检索。
通过 aiwiki config 接入阿里云盘或网易 SMTP 存储后，把当前会话方案 push 出去，在另一台设备 pull 后按标题标签继续编辑。