# GEO Wiki Agent Skill 使用指南 > 让 AI Agent 帮你自动管理知识库，一句话发布文章 --- ## 🎯 什么是 Agent Skill？ Agent Skill 是 GEO Wiki 提供的 AI Agent 集成能力，让 AI Agent 能够通过 CLI 或 API 直接管理知识库。 **核心能力**： - 📝 智能内容生成 - 🏷️ 自动分类标签 - 🌍 多语言同步 - 🎨 排版优化 - 📊 SEO/GEO 优化 --- ## 🚀 快速开始 ### Step 1：登录 Wiki ```bash geo login --url http://localhost:3002 --user admin --pass Admin123 ``` ### Step 2：发布文档 ```bash # 从文件发布 geo doc create --file ./article.md --category tech # AI 自动生成并发布 geo llm generate --title "产品介绍" --category products ``` ### Step 3：验证发布 ```bash geo doc list --category tech ``` --- ## 📋 智能分类规则 Agent 应根据以下规则自动分类文档： ### 分类映射 | 内容类型 | 分类 slug | 标签 | |----------|-----------|------| | 产品规格书 | `can-motion` | 产品, 技术规格 | | 产品说明书 | `can-motion` | 产品, 使用手册 | | 协议转换器 | `protocol-adapter` | 协议, 转换器 | | 示例代码 | `code-examples` | 代码, 示例 | | 快速入门 | `support` | 快速入门, 教程 | | 常见问题 | `faq` | FAQ, 问题解答 | | 技术教程 | `support` | 教程, 技术 | ### 标签生成规则 ```yaml # 根据内容自动生成标签 tags: - 产品型号（如 UIM342） - 技术特性（如 CAN-bus, closed-loop） - 应用场景（如 工业自动化） - 内容类型（如 教程, 规格书） ``` --- ## 🎨 排版规范 ### 文档结构模板 ```yaml --- title: 文档标题 slug: url-friendly-slug category: 分类slug tags: [标签1, 标签2] author: admin description: 20字以上的描述 language: zh notice: "💡 本页面的提示信息" schema: type: TechArticle datePublished: YYYY-MM-DD dateModified: YYYY-MM-DD --- # 文档标题 > 一句话摘要 --- ## 产品概述 ## 核心特性 ## 技术规格 ## 应用场景 ## 示例代码 ## 相关文档 --- *最后更新: YYYY-MM-DD | 版本: v2.9.0* ``` ### Notice 自动生成规则 根据文档内容自动生成 notice： | 内容类型 | Notice 模板 | |----------|-------------| | 产品文档 | "📋 本页面包含 {产品型号} 的详细技术规格" | | 教程文档 | "💡 本教程需要 {前置条件}，预计 {时间} 完成" | | FAQ | "❓ 常见问题解答，点击展开查看详细答案" | | 代码示例 | "💻 本页面包含可直接运行的示例代码" | | 安全提示 | "⚠️ 重要安全提示，请仔细阅读后再操作" | --- ## 🔧 CLI 命令参考 ### 文档管理 ```bash # 创建文档 geo doc create -f ./doc.md -c category -T "tag1,tag2" # 更新文档 geo doc update --slug doc-slug -f ./updated.md # 删除文档 geo doc delete --slug doc-slug # 列出文档 geo doc list --category products --json # 获取单个文档 geo doc get --slug doc-slug ``` ### 分类管理 ```bash # 创建分类 geo category create --name "分类名" --slug category-slug # 列出分类 geo category list --json ``` ### AI 功能 ```bash # AI 生成文档 geo llm generate --title "标题" --category cat --lang zh # AI 翻译文档 geo llm translate --slug doc-slug --target-lang en # AI 优化文档 geo llm optimize --slug doc-slug --mode replace ``` --- ## 📊 完整工作流示例 ### 场景：批量导入产品文档 ```bash #!/bin/bash # 批量导入产品文档 # 登录 geo login --url http://localhost:3002 --user admin --pass Admin123 # 创建分类（如不存在） geo category create --name "产品文档" --slug products # 批量发布 for f in ./products/*.md; do echo "发布: $f" geo doc create -f "$f" -c products -T "产品文档,导入" done # 验证 geo doc list --category products --json ``` ### 场景：多语言同步 ```bash #!/bin/bash # 发布中文文档后自动翻译为英文 # 发布中文版 geo doc create -f ./doc-zh.md -c products # 翻译为英文 geo llm translate --slug doc-slug --target-lang en # 验证 geo doc get --slug doc-slug --lang en ``` --- ## 🤖 Agent 集成配置 ### Claude Code / OpenClaw ```json { "tools": { "geo-wiki": { "command": "geo", "args": ["--url", "http://localhost:3002"] } } } ``` ### 环境变量配置 ```bash export GEO_URL=http://localhost:3002 export GEO_USER=admin export GEO_PASS=Admin123 ``` --- ## 📚 API 参考 ### 认证 ```bash # 登录获取 Cookie curl -X POST http://localhost:3002/api/v1/auth/login \ -H "Content-Type: application/json" \ -d '{"username":"admin","password":"Admin123"}' \ -c cookies.txt ``` ### 文档操作 | 功能 | 方法 | 路径 | |------|------|------| | 列出文档 | GET | `/api/v1/docs` | | 获取文档 | GET | `/api/v1/docs/:slug` | | 创建文档 | POST | `/api/v1/admin/docs` | | 更新文档 | PUT | `/api/v1/admin/docs/:slug` | | 删除文档 | DELETE | `/api/v1/admin/docs/:slug` | | 搜索文档 | GET | `/api/v1/docs/search?q=keyword` | ### AI 功能 | 功能 | 方法 | 路径 | |------|------|------| | AI 生成 | POST | `/api/v1/llm/generate` | | AI 翻译 | POST | `/api/v1/llm/translate` | | AI 优化 | POST | `/api/v1/llm/optimize` | | AI 分析 | POST | `/api/v1/llm/analyze` | --- ## ❓ 常见问题 **Q: Agent Skill 需要额外付费吗？** A: 不需要。Agent Skill 是 GEO Wiki 的内置功能，免费使用。 **Q: 支持哪些 AI Agent？** A: 支持所有兼容 CLI 或 API 调用的 Agent。 **Q: 如何处理 CSRF 问题？** A: 使用 Cookie 认证时，CSRF token 会自动处理。如遇问题，请重新登录获取新的 Cookie。 --- ## 🚀 下一步 1. **体验 Agent Skill** → 在本地启动 GEO Wiki 试试 2. **阅读 CLI 文档** → 完整命令参考 3. **阅读 AI 能力** → 了解 AI 生成和优化功能 --- *最后更新: 2026-05-26 | 版本: v2.9.0*