GEO Agent 使用手册 云擎星河 · 本地智能运营助手

GEO Agent Guide

技能市场

浏览 · 安装 · 扩展能力

技能市场

技能市场 是 GEO Agent 的能力目录与扩展中心：展示 系统内置技能（随安装包提供、已启用）与 Platform 下发的扩展技能包（可选安装 / 卸载）。安装后，对应能力可通过对话触发词或主流程自动调起。

功能入口

方式 说明
主对话侧栏 左下角 「技能市场」 按钮
直接访问 浏览器打开 http://127.0.0.1:8765/skills-market
返回对话 技能市场页左上角 「返回对话」

使用前请确认已 连接并登录 Platform（/setup）。未登录时无法安装平台扩展包；内置技能列表仍可浏览。

技能来源说明

来源 卡片标识 是否可卸载 说明
系统内置 「系统内置」蓝色标签 否 随 GEO Agent 安装包分发，含品牌建档、成文、发文 Skill 等核心能力
平台扩展 「平台下发」绿色标签 是（已安装后） 由云擎星河 Platform 统一发布，需在本机点击 安装 后生效
已安装 状态「已安装 · v版本号」 可卸载 扩展包已写入本机，对话中可按触发词使用

部分内置技能带 「自动调起」 标签，表示在成文 Worker 等后台流程中会自动执行，无需手动说触发词。

页面布局

┌─────────────────────────────────────────────┐
│  返回对话    技能市场                        │
├─────────────────────────────────────────────┤
│  [搜索框]              显示统计 / 分页信息   │
│  来源筛选：全部 | 系统内置 | 平台扩展 | …    │
│  分类筛选：全部分类 | 品牌建档 | 内容成文 | … │
├─────────────────────────────────────────────┤
│  ┌─────────┐ ┌─────────┐ ┌─────────┐       │
│  │ 技能卡片 │ │ 技能卡片 │ │ 技能卡片 │ …    │
│  └─────────┘ └─────────┘ └─────────┘       │
│           [ 上一页 ] 1 2 3 [ 下一页 ]        │
└─────────────────────────────────────────────┘
  • 每页显示 15 个 技能卡片，底部可翻页
  • 顶部 搜索框 可按技能名称、Tool、专员角色模糊搜索
  • 筛选与搜索可组合使用

筛选与搜索

来源筛选

选项 作用
全部来源 显示内置 + 平台扩展
系统内置 仅看安装包自带技能
平台扩展 仅看 Platform 下发的可安装包
已安装 仅看本机已安装的扩展包
可安装 平台有下发、但本机尚未安装的扩展包

分类 / 专员筛选

第二行筛选芯片包括：

  • 全部分类：品牌建档、知识策略、内容成文、媒体发文、数据分析等
  • 按专员：星河、维斯、文砚、云桥、子算等（与办公室专员对应）

点击芯片即可切换；再次点「全部分类」清除分类筛选。

技能卡片说明

每张卡片通常包含：

区域 内容
标题 技能名称
标签 负责专员、业务分类、系统内置/平台下发、自动调起、含 SKILL.md 等
绑定 Tool 技能关联的后端工具标识（供技术参考）
简介 技能做什么
如何使用 对话触发方式或流程说明
操作区 安装 / 卸载按钮，或「系统内置 · 已启用」

阅读 「如何使用」 可了解安装后如何在对话中唤起该技能。

安装平台扩展技能

适用于卡片状态为 「平台扩展 · 未安装」 的技能。

  1. 确认已登录 Platform，且账号具备有效 License（企业授权）
  2. 在技能市场找到目标技能，点击 「安装」
  3. 等待按钮显示「安装中…」；成功后状态变为 「已安装」
  4. 返回主对话，按卡片 「如何使用」 中的触发词试用（如特定口令或流程指令）

安装过程会：

  • 从 Platform 下载技能包（含 SKILL.md、schema.json 等）
  • 写入本机目录：%LOCALAPPDATA%\GEOAgent\data\skills\installed\{skill_key}\
  • 注册触发词与意图，立即生效（一般无需重启 Agent）

若安装失败，请查看卡片下方红色提示或页面顶部错误条。

卸载平台扩展技能

仅 平台扩展且已安装 的技能可卸载；系统内置技能不可卸载。

  1. 找到状态为 「已安装」 的扩展技能
  2. 点击 「卸载」
  3. 确认后等待完成；卡片恢复为 「未安装」

卸载会删除本机技能包文件并取消触发词注册；Platform 侧可重新安装。

安装后如何使用

扩展技能安装后，常见使用方式：

类型 说明 示例
对话触发 在输入框说出 schema.json / SKILL.md 中配置的触发词 见卡片「如何使用」
流程技能 安装后接入主流程某一步（route_mode: flow） 按流程面板或专员指引操作
说明类 仅返回使用说明（route_mode: info） 说出触发词查看帮助
自动调起 成文 Worker 等后台自动执行 无需手动操作

部分技能有 前置步骤（如须先完成品牌录入、上传图片）。未满足时，专员会提示先完成对应 GEO 流程步骤。

系统内置技能（无需安装）

以下能力随 Agent 安装即可用，在技能市场中标记为 系统内置 · 已启用：

  • 品牌建档向导、知识拓扑、命题策略、批量成文计划
  • 媒体发文编排、各平台发文 Skill（知乎、百家号等）
  • 文章数据调研、FAQ 生成、Schema JSON-LD 等成文增强（部分为自动调起）
  • AI 收录诊断、买家画像矩阵等

日常 GEO 主流程 不安装任何扩展包 也可完成；技能市场主要用于 查看说明 与 安装 Platform 新发的实验/增值能力。

权限与网络要求

条件 说明
登录 Platform 安装 / 卸载扩展包必须已短信登录
有效 License 企业授权；无 License 时可能无法拉取或安装平台技能
网络可达 Platform 拉取技能目录与安装包需访问配置的 Platform 地址
本机写权限 技能包写入 %LOCALAPPDATA%\GEOAgent\data\；若权限不足会提示改用用户目录安装

页面顶部若出现黄色/红色提示 「Platform 扩展技能未加载」，表示目录接口失败或当前无已发布技能，内置技能仍可正常使用。

存储位置与安全

  • 内置技能：随 Agent 程序目录分发（geo_agent/skills/）
  • 已安装扩展：%LOCALAPPDATA%\GEOAgent\data\skills\installed\{skill_key}\
  • 安装记录：%LOCALAPPDATA%\GEOAgent\data\skills\installed_index.json（示例路径，以实际为准）

技能包为 Markdown / JSON 配置，不含您的品牌正文或发文密码；卸载即删除本机副本。

常见问题

平台扩展显示为 0？

  1. 确认 Platform 后台已 发布 对应技能（非草稿）
  2. 确认 Agent 连接的 Platform 与后台一致（测试环境与生产环境数据不同步时常见）
  3. 筛选 「平台扩展」 单独查看

点击安装提示未登录？

前往 /setup 完成 Platform 连接与短信登录后重试。

安装失败 / HTTP 502？

  • 检查网络与 Platform 地址是否正确
  • 确认 License 有效
  • 查看 %LOCALAPPDATA%\GEOAgent\data\logs\agent.log

安装成功但对话无反应？

  1. 阅读卡片 「如何使用」 中的准确触发词
  2. 确认是否满足 前置流程（如品牌资料、图片）
  3. 部分技能为 自动调起，仅在成文等 Worker 中生效

能否离线使用已安装技能？

已安装的扩展包文件在本机，但部分能力仍依赖 Platform API 或本机模型 KEY；完全离线场景以技能说明为准。

与「使用教程」链接的区别？

  • 技能市场：浏览全部技能目录、安装扩展包、查看 Tool 与触发词
  • 使用教程（侧栏）：打开本 GEO Agent 使用手册（agent-guide）系统说明

相关阅读