feat: 新增 account 和 plan 目录

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-11 16:26:22 +08:00
parent 243a190124
commit 0cab33b16b
694 changed files with 161549 additions and 0 deletions

View File

@@ -0,0 +1,134 @@
---
name: platform-guide
description: "OpenAkita 平台使用指南:教你帮用户从 Agent Hub 和 Skill Store 搜索、安装 Agent 和 Skill"
system: true
category: Platform
---
# OpenAkita Platform Guide — AI 操作手册
> **核心原则**:当用户需要某种能力但本地没有时,你应该 **主动搜索平台**。
## 什么时候该用平台?
- 用户说"帮我找一个 XX Agent / 技能 / Skill"
- 用户需要某种能力但本地没有对应的技能
- 用户说"有没有现成的"、"市场上有吗"、"安装一个"
- 用户提到 Agent Hub、Skill Store、OpenAkita 平台
**注意**:平台是 **可选扩展**,离线时所有本地功能不受影响。
---
## Agent 安装三步走
当用户想从平台获取 Agent 时:
**第 1 步 — 搜索**
```
search_hub_agents(query="客服", category="customer_service")
```
- 查看返回的 Agent 列表,注意每个 Agent 的 `id`
**第 2 步 — 预览(推荐)**
```
get_hub_agent_detail(agent_id="the-agent-id")
```
- 查看描述、技能列表、评分、下载量
**第 3 步 — 安装**
```
install_hub_agent(agent_id="the-agent-id")
```
- 系统自动:下载包 → 解压技能 → 版本去重 → 注册 Agent → 热重载
- 安装后 Agent **立刻可用**
### 安装时发生了什么?
1. 下载 `.akita-agent`
2. 打包的技能 → `skills/custom/`(版本去重:本地有更新版就跳过)
3. 外部依赖技能 → 从原始 GitHub 仓库拉取到 `skills/community/`
4. 每个技能写入 `.openakita-origin.json` 追踪来源
5. Agent 配置注册到本地 → 技能自动重载
---
## Skill 安装三步走
当用户想从平台获取 Skill 时:
**第 1 步 — 搜索**
```
search_store_skills(query="翻译", trust_level="official")
```
- 注意 `trustLevel`official官方> certified认证> community社区
**第 2 步 — 预览(推荐)**
```
get_store_skill_detail(skill_id="the-skill-id")
```
- 查看描述、开源协议、GitHub Stars、评分
**第 3 步 — 安装**
```
install_store_skill(skill_id="the-skill-id")
```
- 从原始 GitHub 仓库直接克隆(非平台重新分发)
- 安装后技能 **立刻可用**
---
## 本地 Agent 导入导出(不需要平台)
```
list_exportable_agents() # 查看可导出的
export_agent(profile_id="my-agent", version="1.0.0") # 导出
inspect_agent_package(package_path="xxx.akita-agent") # 预览包
import_agent(package_path="xxx.akita-agent") # 导入
```
---
## 版本去重策略
| 场景 | 行为 |
|------|------|
| 本地有同名 skill 且版本 >= 新包中的版本 | **跳过**(保留本地更新版) |
| 新包中版本 > 本地版本 | **覆盖**(升级到新版) |
| 任一方无版本信息 | **覆盖**(安全起见) |
---
## 平台离线时的替代方案
| 需求 | 替代方式 |
|------|----------|
| 找 Agent | 用 `.akita-agent` 文件导入 |
| 找 Skill | `install_skill` 从 GitHub 直接装Setup Center 的 skills.sh 市场 |
| 共享 Agent | `export_agent` 导出文件分享 |
---
## 全部平台工具速查
| 工具 | 用途 |
|------|------|
| `search_hub_agents` | 搜索平台上的 Agent |
| `get_hub_agent_detail` | 查看 Agent 详情 |
| `install_hub_agent` | 安装 Agent 到本地 |
| `search_store_skills` | 搜索平台上的 Skill |
| `get_store_skill_detail` | 查看 Skill 详情 |
| `install_store_skill` | 安装 Skill 到本地 |
| `submit_skill_repo` | 提交 GitHub 仓库为新 Skill |
| `export_agent` | 导出本地 Agent |
| `import_agent` | 导入 Agent 包 |
| `list_exportable_agents` | 列出可导出的 Agent |
| `inspect_agent_package` | 预览 Agent 包内容 |
---
## 许可证合规
- 平台上的 Skill 从 **原始开源仓库** 拉取,非平台重新分发
- Agent 包可能含 `LICENSE-3RD-PARTY.md` 列出外部依赖
- 安装前应告知用户相关许可证
- 侵权联系zacon365@gmail.com