aicskills

package module
v0.4.0 Latest Latest
Warning

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

Go to latest
Published: Nov 2, 2026 License: MIT Imports: 9 Imported by: 0

README

aic-skills

AIC 官方技能内容仓。技能 = SKILL.md + 可选包根 manifest.json、ui/、api/、tables/

  • 普通资源;设备侧能力另有 src/。Go embed 携带包内容:随平台 aic 构建分发,pod 只内嵌官方 预装包(browser/cua)用于启动定版;设备程序源码随包入库,设备自行构建或直接用发行包附带的预编译程序。

中文 | English

内建技能

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

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

边界

  • 说明、UI 与云端 API 由平台发布和使用;技能本身没有 installed / enabled / 进程 / 服务状态。
  • 包根 manifest.json 使用 schema 1:ui.pages 以不带 .html 的包内页面路径为 ID,值当前仅 desc;host 声明设备服务(run / url / protocol / idle_timeout),流内嵌于所属服务且仅含 address_env。设备程序源码放在 src/;仓内不带二进制、构建产物或 provider / SDK。
  • 有状态软件经设备侧 commands install 登记成 vsh 根命令:browser/cua 由 pod 启动定版预装 (发行包附带预编译 bin/<name>),blender 与第三方包同形态经 commands install 安装(包内自带 服务或启动器);owner 自登记服务用 commands add 或设备 commands 配置段接入。
  • 技能页面入口与 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(browser/cua 由 pod 启动定版); 其余包由设备用 commands install <id> 拉取,并按各包 SKILL.md 安装依赖;需要包内程序时才自行编译 bin/<name>(预装包用发行包附带的预编译程序,无需 Go 工具链)。

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/src command
mytool —— 最小 MCP stdio 服务:由 Pod 启动并长期保持连接。
mytool —— 最小 MCP stdio 服务:由 Pod 启动并长期保持连接。
templates/device/src command
mytool —— 最小 MCP stdio 服务:由 Pod 启动并长期保持连接。
mytool —— 最小 MCP stdio 服务:由 Pod 启动并长期保持连接。
cua
src command
Command cua 启动官方 cua-driver 的 MCP 服务。
Command cua 启动官方 cua-driver 的 MCP 服务。
hello
scripts command
A standalone native CLI example.
A standalone native CLI example.
Package manifest 是包根 manifest.json(schema 1)的唯一权威解析器。
Package manifest 是包根 manifest.json(schema 1)的唯一权威解析器。

Jump to

Keyboard shortcuts

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