aicskills

package module
v0.3.5 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 30, 2026 License: MIT Imports: 9 Imported by: 0

README

aic-skills

AIC 官方技能内容仓。技能 = SKILL.md + 可选 ui/、api/、tables/、cli/ + 普通资源; Go embed 携带静态内容与设备程序源码,随平台(aic)与设备端(aic-pod)构建分发。

中文 | English

内建技能

技能 版本 形态
browser 1.2.0 说明 + UI:设备侧自带 Chrome 的 CDP 通道(AI 工具 + 实时画面 + 人工交互)
cua 1.1.1 说明 + UI:官方 cua-driver(0.33.2)MCP 的远程查看与控制
blender 0.3.1 说明:设备上的 Blender 直连(看场景 / 渲染 / 执行 Python)
create 1.0.4 手册 + 模板 + 介绍页:AIC 扩展作者手册(云端/界面/设备三端)与给人看的扩展能力介绍页
office_studio 1.0.4 说明 + UI:Office 文档工作台
drawio 1.0.3 说明 + UI:DrawIO 绘图工作台
ppt_studio 1.0.4 说明 + UI:PPT 工坊
video_studio 1.0.3 说明 + UI:视频工坊
play_with_ai 1.0.4 说明 + UI:与 AI 对弈的多游戏台(五子棋 / 象棋)
vhtml 0.5.1 说明:vhtml 前端框架指南
hello 1.0.1 示例:普通原生 CLI

builtin_embed.go 的 embed 列表是唯一的发布面——目录存在但不在列表里 就不会发布。

边界

  • 说明、UI 与云端 API 由平台发布和使用;技能本身没有 installed / enabled / 进程 / 服务状态。
  • 普通 CLI 与脚本按说明原生执行,由用户自行下载安装;cli/ 则可包含设备服务 manifest.json 与程序源码。仓内不带二进制、构建产物或 provider / SDK。
  • 有状态软件经 vtools 注册成设备服务命令:Browser/CUA 使用 MCP,Blender 使用 vtools/tcp。 官方内嵌清单由 Pod 启动时读取;第三方服务由设备 mcp.servers 配置,用户包的自动安装与注册链路尚未开放。
  • 技能页面入口与 HTTP 包服务同段:/skills/cloud/{id}(对齐 /fs/cloud——裸入口加载包内 ui/index.html,同段又是包服务);子页 /skills/cloud/{id}/{page},详情与管理 /skills/detail/cloud/{id} (按 role 自动分派;成员 /members、数据 /data)。页面用 url_prefix / $mod.scoped 定位资源,不要硬编码平台地址。 注意 fs 工具路径仍是 /skills/{id}/...(与 URL 不同段,勿混用)。

消费方式

平台侧由 aic 的 skills.builtin 维护事件定版:首装整包落盘并建行(id = 包名、属主 system、公开)。事件指纹由「包名 + 内嵌 version」组成;指纹变化触发执行,管理员也可强制重跑。 执行时不再比较行版本,而是把全部内嵌包无条件整目录原子交换并全量刷新行元数据;因此内容变更必须 bump 对应技能版本以改变指纹。设备端共用同一份 embed,无需下载。

go get github.com/veypi/aic-skills@latest

测试

go test ./...                # 嵌入清单、元数据、版本、打包

cd browser/ui && npm test    # 页面测试(零依赖,node --test)
cd cua/ui && npm test
cd play_with_ai/ui && npm test

# 根 Go 测试同时覆盖两个真实 MCP 示例(initialize + tools/call)
GOWORK=off go test ./...

版本面

  • 模块版本:VERSION 与 tag vX.Y.Z,变更见 CHANGELOG.md—— Go 依赖面,消费方(aic 与 aic-pod)据此解析。
  • 技能版本:各 SKILL.md frontmatter 的 version:——内容版本,也是 skills.builtin 指纹的组成部分;内容变更必须 bump 以触发自动定版(事件执行后无条件覆盖,不做版本大小比较)。

贡献者与 AI 代理须知(契约与不变量)见 AGENTS.md;文档地图见 docs/index.md。

许可

MIT(LICENSE)。

Documentation

Overview

Package aicskills embeds the official static skill catalog for cloud publication.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Frontmatter

func Frontmatter(doc []byte) (name, version string)

Frontmatter 读 SKILL.md frontmatter 顶层 name/version(`---` 围栏内 无缩进 `key: value`;不引 yaml 依赖,只取两个标量键)。宽松提取,仅供 内嵌场景取版本真相(本包 Version);aic 侧 完整契约走 skillhub parseSkillMD(yaml KnownFields 严格解析),两端各取 所需——frontmatter 字段契约真相 = aic docs/reference/skill.md §1。

func List

func List() []string

List 内建包名(嵌入根下的目录名 = 包名 = 注册表 id)。按名排序,遍历稳定。

func Open

func Open(name string) (fs.FS, error)

Open 包目录子树(只读;name 须为 List 成员)。

func Version

func Version(name string) string

Version 包版本(SKILL.md frontmatter version 标量;无 = "")。

func Zip

func Zip(name string) ([]byte, error)

Zip creates a content archive with paths relative to the skill root.

Types

This section is empty.

Directories

Path Synopsis
browser
src command
Command browser serves a thin Chrome DevTools Protocol channel as an MCP service.
Command browser serves a thin Chrome DevTools Protocol channel as an MCP service.
create
examples/device_tool/cli command
mytool —— 最小 MCP stdio 服务:由 Pod 启动并长期保持连接。
mytool —— 最小 MCP stdio 服务:由 Pod 启动并长期保持连接。
templates/device/cli command
mytool —— 最小 MCP stdio 服务:由 Pod 启动并长期保持连接。
mytool —— 最小 MCP stdio 服务:由 Pod 启动并长期保持连接。
hello
scripts command
A standalone native CLI example.
A standalone native CLI example.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL