内容
# AndroidAgenticWiki
[](https://www.npmjs.com/package/android-agentic-wiki)
一个用于安卓开发的 Git 支持的知识图谱和模型上下文协议（MCP）服务器。
标准的大型语言模型（LLM）缺乏对快速发展的安卓生态系统的实时感知。**AndroidAgenticWiki** 通过作为一个“长期记忆”库来弥补这一空白。通过使用 MCP 将此仓库连接到您的 IDE，您的 AI 代理可以访问本地约束，这些约束覆盖了通用训练数据和工作区特定的规则以及官方的谷歌标准，从而消除了废弃 API 的幻觉。
## 📦 已包含内容（开箱即用）
您获得的不仅仅是一个空的文件夹结构。这个知识库预加载了高级架构约束：
- **构建规则（`build_constraints.md`）：** 强制使用 AGP 9.2.0+、Compose BOM 2026.04.01 和严格的声明式设置（禁止使用旧的 `kotlin-android` 插件）。
- **UI 标准（`ui_standards.md`）：** 强制使用稳定的 Material 3、边缘到边缘执行和 Compose `Modifier.graphicsLayer` 性能规则。
- **架构（`architecture.md`）：** 教导代理根据项目结构自动检测和强制执行严格的 Clean Architecture、MVVM 或 MVI 模式。
- **清理的蓝图：** `koin_di.md`、`mvvm_state.md`、`room3_configuration.md` 和 `design_md_implementation.md` 的可操作模板。
- **谷歌安卓技能：** 通过 Git 子模块与官方的 `android/skills` 仓库自动同步，以获取权威的导航、性能和 UI 指导。
## 🧠 架构
这个大脑使用两个组件在同一个本地文件夹上同时运行：
1. **MCP 服务器（后端）：** 作为进入 Android Studio AI 的无头桥接。您可以通过 **Tolaria** （专用桌面应用程序）或通过 **Node.js** 原生运行它。
2. **Obsidian（GUI 和数据通道）：** 作为您的可选可视化工具。您使用它来查看知识图谱并直接从网络剪辑新的安卓文档到知识库中。
---
> ⚠️ **重要警告：请勿下载 ZIP 文件**
> 此仓库依赖 Git 子模块来同步官方的谷歌安卓技能。如果您使用 GitHub 的“下载 ZIP”功能，`external_skills/` 目录将完全为空，AI 代理将无法正确路由。**您必须使用 `npx` 命令或通过 Git 克隆安装。**
## 🚀 安装指南
### 1. 初始化知识库
**最简单的方法（一键安装 via npx）：**
只需在终端中运行以下命令。它将自动下载仓库，初始化谷歌技能子模块，并自动配置您的 AI 助手（Claude、Gemini CLI、Codex）：
```bash
npx android-agentic-wiki@latest
```
**替代方法（手动 Git 克隆）：**
如果您更喜欢手动克隆：
```bash
git clone https://github.com/trinadhthatakula/AndroidAgenticWiki.git
cd AndroidAgenticWiki
git submodule update --init --recursive
npm install
npm run setup
```
### 2. 选择 MCP 服务器路径
**选项 A：Tolaria（推荐 macOS）**
1. 下载并安装 [Tolaria](https://github.com/refactoringhq/tolaria/releases)。
2. 在 Tolaria 中打开此仓库文件夹作为知识库。
3. 打开 Tolaria 的命令面板并搜索“设置外部 AI 工具”以复制您的唯一 MCP 服务器命令路径。
**选项 B：原生 Node.js（Windows / Linux / CLI 首选）**
此仓库充当其自己的 MCP 服务器。
1. 确保 [Node.js](https://nodejs.org/) （v18+）已安装在您的机器上。
2. 在克隆仓库的根目录中打开终端并运行 `npm install`。
3. 测试服务器，运行 `npm run mcp`。 *（您可以在验证它启动后使用 Ctrl+C 停止它）。*
### 3. IDE 集成和配置
您可以使用我们的自动设置脚本、UI 配置或手动配置将知识图谱连接到您的 AI 助手，具体取决于您的客户端。
**方法 A：自动设置（Claude Desktop、Claude Code、Gemini CLI、Codex）**
如果您使用 `npx create-android-agentic-wiki` 安装了知识库，您的 IDE 已 **自动配置**。
如果您手动克隆了仓库，您可以在克隆仓库的根目录中运行设置脚本：
```bash
npm run setup
```
*（这会自动配置 `claude_desktop_config.json`、`~/.claude.json`、`~/.gemini/settings.json` 和 `~/.codex/config.toml`）。*
**方法 B：UI 配置（Android Studio / IntelliJ）**
1. 打开 **设置**（Windows/Linux）或 **首选项**（macOS）。
2. 导航到 **插件** > **AI** > **MCP 服务器**。
3. 点击 **添加服务器** (+)。
4. **名称：** `AndroidAgenticWiki`
5. **可执行文件/命令：** `npx`
6. **参数：** `-y @modelcontextprotocol/server-filesystem /absolute/path/to/your/AndroidAgenticWiki`
*（关键：用克隆仓库的实际绝对路径替换路径）。*
7. 重启 AI 助手。
**方法 C：手动配置（Cursor、自定义客户端）**
如果您的 AI 客户端使用 JSON 配置文件（例如 `claude_desktop_config.json`），请将以下块复制并粘贴到您的 `mcpServers` 对象中。
*记得用您的实际本地路径替换 `/absolute/path/to/your/AndroidAgenticWiki`。*
```json
{
"mcpServers": {
"android-agentic-wiki": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/absolute/path/to/your/AndroidAgenticWiki"
]
}
}
}
```
对于 **Codex** （`~/.codex/config.toml`），使用：
```toml
[mcp_servers."android-agentic-wiki"]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/absolute/path/to/your/AndroidAgenticWiki"]
```
### 4. 配置数据通道（Obsidian）
1. 下载 [Obsidian](https://obsidian.md/) 并打开 `AndroidAgenticWiki` 文件夹作为知识库。
2. 安装 [Obsidian Web Clipper](https://obsidian.md/clipper) 浏览器扩展。
3. 在 Web Clipper 设置中，前往 **模板** > **默认**。
4. 将 **文件夹** 位置设置为 `inbox`。
5. 添加新属性：名称 = `status`，值 = `unprocessed`。
---
## 🤖 您的第一个提示
连接后，在 Android Studio 中打开 AI 聊天并触发路由引擎：
> *"根据我的 AndroidAgenticWiki 中的 `AGENTS.md` 路由，使用 MVVM 蓝图和 Koin DI 约束创建一个新的用户配置文件功能。"*
## 📥 知识库学习（摄入工作流）
此仓库不是一个静态模板；它是一个自我更新的系统。您可以直接“教导”您的代理新的安卓概念、库或架构模式，而无需自己编写 Markdown。
当发布新的安卓功能、库更新或架构博客文章时：
1. **剪辑知识：** 使用 Obsidian Web Clipper 将原始的 Medium 文章或 Android Developer 文档直接保存到您的 `/inbox` 文件夹中。
2. **触发大脑：** 打开 Android Studio 并告诉您的连接代理： *"在我的 inbox 中对未处理的文档执行 `workflows/ingest_docs.md` 中的运行手册。"*
3. **观察它学习：** 代理将自主阅读文章，提取严格的工程规则，更新您的 `build_constraints.md` 或 `ui_standards.md`，在 `/blueprints/` 中编写新的代码蓝图，并存档原始文档。
**结果：** 下次您要求代理构建功能时，它将原生使用它刚刚学习的新架构。
## ⚠️ 免责声明
此仓库中提供的规则和蓝图是现代高性能安卓开发的强烈意见模板。每个团队都不同。强烈建议您 fork 此仓库并修改 `/rules/` 和 `/blueprints/` 目录，以完美匹配您自己的技术栈和组织标准。
