重要前提
安装AI Skills的关键前提是:必须科学上网,且开启TUN模式,这一点至关重要,直接决定安装能否顺利完成,在此郑重提醒三遍:科学上网,科学上网,科学上网。查看完整安装教程 →
ov-add-data by volcengine/openviking
npx skills add https://github.com/volcengine/openviking --skill ov-add-dataadd-resourceov add-resource 命令将外部资源导入到 OpenViking 的上下文数据库中——支持本地文件、目录、URL 和远程仓库。资源会自动进行语义分析处理,并组织在 viking://resources/ 命名空间下。
导入本地文件或 URL:
# 从 github 或 gitlab 或 git 地址添加代码仓库
ov add-resource https://github.com/volcengine/OpenViking
ov add-resource https://code.xxxx.org/viking/viking
ov add-resource git@code.xxxx.org:viking/viking.git
# 从 URL 添加文件
ov add-resource https://arxiv.org/pdf/2602.09540
ov add-resource https://raw.githubusercontent.com/volcengine/OpenViking/main/README.md
# 从本地文件系统添加文件
ov add-resource ./docs/api-spec.md
ov add-resource ./team_building.jpg
ov add-resource /User/volcengine/Documents/profile.pdf
ov add-resource /User/volcengine/Documents/project.docx
# 从本地文件系统添加 zip 文件(将在服务器上解压)
ov add-resource ./docs-of-project.zip
# 从本地文件系统添加目录
ov add-resource /User/volcengine/Photo/Travels/2026/ --include "*.jpg,*.jpeg,*.png"
ov add-resource /User/volcengine/Documents/OV项目设计文档/
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
添加元数据以指导处理:--reason 和 --instruction 将在未来支持。
添加资源可能耗时较长(例如几分钟),语义处理可以是异步的。使用 --wait 等待处理完成。
# 等待直到语义处理完成
ov add-resource ./docs --wait
# 带超时等待(单位:秒)
ov add-resource https://example.com/docs --wait --timeout 60
# 发送后即忘(默认,不带 --wait)
ov add-resource ./docs
如果你使用发送后即忘模式,命令将在资源在服务器上完全下载/上传后返回,然后 CLI 将返回导入资源的根 URI。要检查资源的状态,可以使用 ov ls 或 ov tree 来列出根 URI 或 viking://resources/ 下的资源。
默认情况下,资源被导入到 viking://resources/ 下。使用 --to 或 --parent 来指定目标 URI。
# 数据将被导入为 viking://resources/2026/2026-01-01/,该路径在导入前不应存在
ov add-resource /User/volcengine/Photo/Travels/2026/2026-01-01/ --to "viking://resources/2026/2026-01-01/"
# 数据将被导入到 viking://resources/2026 下,该路径应存在且是一个目录
ov add-resource /User/volcengine/Photo/Travels/2026/2026-01-02/ --parent "viking://resources/2026/"
返回导入资源的根 URI,例如:
root_uri viking://resources/2026/2026-01-01
~/.openviking/ovcli.confadd-memoryov add-memory 命令添加持久化记忆——将文本和结构化对话转换为 OpenViking 上下文数据库中可搜索、可检索的记忆。使用 ov add-memory --help 获取最新用法。
在纯文本模式和多轮对话模式之间明智选择。多轮对话模式可以包含更复杂的见解,让 openviking 处理记忆提取。
一个简单的字符串被存储为一条 user 消息:
ov add-memory "用户的名字是 Bob,他于 2025-01-08 参加了全球黑客马拉松,并获得了冠军。"
一个 {role, content} 对象的 JSON 数组,用于存储完整的对话交换:
ov add-memory '[
{"role": "user", "content": "我喜欢旅行。给我一些从北京到上海的交通选择。"},
{"role": "assistant", "content": "你可以乘坐火车、大巴或飞机。火车最快,但需要提前预订。大巴更便宜,但需要等待。飞机最贵,但一天中的任何时间都可以到达。"},
{"role": "user", "content": "我更喜欢火车。我喜欢在火车上观光。你能给我火车时刻表吗?"},
< ... 更多关于时刻表和购票需要记忆的对话 ... >
]'
返回提取的记忆数量:
memories_extracted 1
在一次调用中分组相关的记忆,而不是多次小调用:
ov add-memory '[
{"role": "user", "content": "关于 ov_cli Rust crate 的关键事实"},
{"role": "assistant", "content": "1. 运行速度比 python cli 快\n2. 使用 HttpClient 连接 openviking 服务器\n3. 输出格式支持表格和 JSON 模式\n4. 配置位于 ~/.openviking/ovcli.conf"}
]'
~/.openviking/ovcli.confadd-skillov add-skill 命令向 OpenViking 添加智能体能力——支持 SKILL.md 文件、MCP 工具定义和原始技能内容。技能会自动处理并组织在 viking://agent/skills/ 命名空间下,使其可被智能体发现和使用。
从带有 YAML 前置元数据的单个 SKILL.md 文件导入:
# 从单个 SKILL.md 文件添加
ov add-skill ./skills/my-skill/SKILL.md
# 从包含 SKILL.md 的目录添加(包含辅助文件)
ov add-skill ./skills/my-skill/
语义处理是异步进行的。使用 --wait 阻塞直到完成:
# 等待直到语义处理完成
ov add-skill ./skills/my-skill/ --wait
# 带超时等待(单位:秒)
ov add-skill ./skills/my-skill/ --wait --timeout 60
# 发送后即忘(默认,不带 --wait)
ov add-skill ./skills/my-skill/
返回已添加技能的 URI,例如:
uri viking://agent/skills/my-skill/
技能使用带有 YAML 前置元数据的 Markdown:
---
name: skill-name
description: 技能的简要描述
allowed-tools:
- Tool1
- Tool2
tags:
- tag1
- tag2
---
当从目录添加时,目录中的所有文件都作为辅助文件包含:
# 目录结构:
# ./skills/code-runner/
# ├── SKILL.md
# ├── helper.py
# └── templates/
# └── script.py
ov add-skill ./skills/code-runner/
# helper.py 和 templates/ 都被包含
~/.openviking/ovcli.conf每周安装量
49
代码仓库
GitHub 星标数
19.4K
首次出现
2026年3月10日
安全审计
安装于
kimi-cli49
gemini-cli49
amp49
cline49
github-copilot49
codex49
AI界面设计评审工具 - 全面评估UI/UX设计质量、检测AI生成痕迹与优化用户体验
58,500 周安装
Grove Auth 集成指南:为 Grove 项目添加 Heartwood 身份验证
60 周安装
变色龙适配(chameleon-adapt):Grove引擎智能UI主题与组件自适应工具
60 周安装
用户故事设置教程 - 使用fullstackrecipes MCP服务器快速配置用户故事开发环境
60 周安装
Python PDF处理指南:合并、拆分、提取文本表格与创建PDF文件教程
61 周安装
Anthropic Claude技能开发指南:创建高效可组合AI技能的最佳实践
61 周安装
多指标交易信号生成器:使用RSI、MACD、布林带等7大技术指标分析,提供置信度与风险管理
61 周安装