SlideBlocks
本页目录

安装 SlideBlocks Skill

一次安装，让受支持的本地 coding agents 共用 SlideBlocks 官方 Skill；无需账户即可检索公开 Catalog，并获取精确版本的已发布 Artifact。

一次安装到你的本地 Agents

安装器会下载官方 ZIP、校验哈希、保留一份受管软件包，并把检测到的受支持本地 Agent 接入；不会覆盖无关文件。

curl -fsSL https://staging.inteliway.tech/skill/install.sh | sh -s -- --site https://staging.inteliway.tech --api https://api.staging.inteliway.tech
命令不可用？手动导入 ZIP

手动导入 ZIP 时校验

仅当你的 Agent 支持导入 Skill ZIP 时使用。下载后，在本页选择该文件完成校验；文件只在浏览器本地读取，不会上传。

  1. 下载 Skill ZIP

  3. 选择文件后自动校验。

查看 SHA-256 详情
软件包版本
0.12.0
官方 SHA-256
23963e2f0f65b347fefb9878051fc11523e7848a89882a369be0411a96fa1371
本地文件 SHA-256
尚未计算

安装说明

查看所需的本地工具、受管安装位置，以及安装完成后的快速验证。

  • Node.js 22.12 或更高版本。
  • curl 与 unzip。
  • 用于 SHA-256 校验的 shasum 或 sha256sum。

一份受管安装，多个 Agent 共用

新安装会把一份已校验的软件包放在 $HOME/.agents/skills/slideblocks。电脑上已经存在的受支持宿主只会获得安全、受管的发现链接；已有的 SlideBlocks 受管安装则继续沿用原位置。

一条命令会识别受支持的本地 Agent，包括 Codex、Claude Code、Cursor、Gemini CLI、GitHub Copilot、OpenCode、Roo、Trae、Windsurf、CodeBuddy 和 WorkBuddy，并把它们连接到同一份已校验的 Skill。

客户端命令

安装器会把命令入口放在 $HOME/.local/bin/slideblocks；如果 Shell 找不到它，请把该目录加入 PATH。

export PATH="$HOME/.local/bin:$PATH"

验证客户端

安装完成后，确认命令入口可用，并能输出客户端版本。

slideblocks --version

安装后直接获取 Artifact

Skill 与网站读取同一份公开 Catalog；已发布 Prompt 和可用源码包安装后即可获取，连接账户是可选项。

  1. 检索并查看公开 Catalog

    无需账户即可检索；获取前再查看一个结果，确认它当前的版本与内容 Hash。

    slideblocks catalog search "时间线" slideblocks catalog show <artifact-id>

  2. 获取一个精确 Artifact

    保存精确 Prompt 和可用的同版本源码 ZIP；客户端会自动建立私有的匿名交付上下文。

    slideblocks artifact get <artifact-id> --variant default \ --prompt ./artifact-prompt.txt --source ./source.zip

  3. 按需把交付绑定到账户

    只有希望把已发布 Artifact 的交付绑定到可撤销账户 Session 时才运行设备授权。它不会扩大当前已发布 Catalog，也不会为 CLI 开启 Creator、投稿、私有、未公开或管理能力。

    slideblocks login

默认匿名使用，账户连接可选

第一次获取时，API 会签发不透明的匿名上下文，客户端自动使用同一请求重试。该上下文仅保存在权限为 0600 的 ~/.config/slideblocks/config.json，不包含 Prompt 或源码字节。

  • 获取已发布 Prompt 与源码不需要账户。
  • 修改网站或 API 地址会清除匿名上下文和账户 Token。
  • 可选设备授权只为同一条已发布 Artifact 交付路径创建可撤销的账户 Session。

控制精确 Artifact 输出

Artifact ID、版本、内容 Hash 和 Prompt 变体是一组不可拆分的坐标。需要交给 Agent 使用时，请明确指定私有输出文件。

  1. Prompt 与源码文件

    --prompt 把已解锁 Prompt 写入指定文件；--source 下载同一版本的源码 ZIP，校验字节数与 SHA-256，并以 0600 权限保存。

    slideblocks artifact get <artifact-id> --prompt ./artifact-prompt.txt --source ./source.zip

  2. 获取历史版本

    历史请求必须同时提供语义版本号和精确的 SHA-256 内容 Hash；只提供其中一项会被客户端拒绝。

    slideblocks artifact get <artifact-id> --version 1.2.3 --hash sha256:<64-hex-digest>

  3. 已有输出文件

    客户端默认拒绝替换 Prompt 或源码文件。只有明确选择覆盖该命名文件时，才添加 --force。

    slideblocks artifact get <artifact-id> --prompt ./artifact-prompt.txt --force

  4. 机器可读输出属于私有内容

    --json 按设计包含已解锁 Prompt。仅在私有进程中使用，不要把输出粘贴或上传到共享日志。

管理已安装的 Skill

  1. 检查

    查看已安装 Skill 版本、API 地址、可选账户连接和客户端兼容性。

    slideblocks status

  2. 升级

    获取当前官方安装包，校验完成后才替换已安装目录。0.1.x 客户端需先更新一次，才能免登录获取已发布内容。

    slideblocks skill update

  3. 断开连接

    logout 会先撤销可选的远端 Session，再删除本地账户 Token；匿名获取已发布 Artifact 仍然可用。logout --local 只在离线时删除本地账户 Token。

    slideblocks logout slideblocks logout --local

  4. 卸载

    如存在当前设备 Session，则先撤销它；随后移除已安装 Skill 和本地客户端配置，同时保留你的演示项目。

    slideblocks skill uninstall

处理交付错误

根据错误代码采取下一步，不要把“没有源码包”误判成暂时的下载失败。

SOURCE_UNAVAILABLE所选版本没有源码包

去掉 --source，使用同一个精确 Artifact 请求获取 Prompt。只有确实需要可编辑源码时才选择其他已发布 Artifact；重复下载不会生成源码包。

CLIENT_UPGRADE_REQUIRED已安装客户端不再兼容

更新 Skill，确认新的客户端版本，再重试原来的精确 Artifact 请求。

slideblocks skill update slideblocks --version

安装包内容与权限

可分发内容只包含稳定工作流、公开规则、校验器和交付客户端；它不是私有仓库的副本。

交付方式
官方 ZIP
完整性
SHA-256 校验
Artifact 身份
ID · 版本 · Hash
  • 通过 Skill 使用已发布 Catalog、Prompt 和源码交付不需要账户。
  • 连接账户是可选项，只会改变交付主体和源码能力；不会扩大当前已发布 Artifact 集合。
  • 安装包不包含私有 Prompt、源码包、账户 Secret 或内部路径。
一键安装会做什么？

你不需要另外下载校验文件或 Shell 脚本；一键安装器会在修改任何 Skill 位置前完成以下检查。

  • 从命令中显示的同一个 SlideBlocks 站点下载官方 Skill ZIP。
  • 在安装前核对 ZIP 的 SHA-256；不匹配时立即停止。
  • 只维护一份受管 Skill，连接已识别的 Agent 宿主；激活失败时自动回滚。