快速开始

Slingshot

Slingshot 是一把专为 AI 智能体设计的弹弓,而非为人类操作员打造。从逐 原子命令结构、双语输出、--explain 标志,到技能包体系——每一个设计决 策,都为了让你的 AI 智能体能够轻松发现、学习并熟练使用这把弹弓。

安装

安装 Slingshot 最快的方式:

curl -fsSL https://slingshot.dscli.io/install.sh | bash

安装脚本会自动检测你的操作系统和架构,下载对应的二进制文件,安装到 $PATH 中的某个目录。

其他安装方式

Go 安装(需先安装 Go):

go install github.com/nanjj/slingshot/cmd/slingshot@latest

验证安装

slingshot version

你可以用 Slingshot 做什么?

Slingshot 将功能划分为清晰的命令组:

命令用途
slingshot config管理配置 — 设置、查看、列出、删除配置项
slingshot weixin微信公众号 — 草稿、素材、发布
slingshot site管理部署目标 — 添加、更新、列出、删除、同步
slingshot page管理站点页面 — 添加、更新、列出、删除
slingshot skill安装和管理 AI 智能体技能包
slingshot draft创建和更新草稿,支持自动格式转换

所有命令都输出结构化的机器可读数据 — 优先为智能体消费设计,其次才是人 类阅读。

📢 微信发布

将 Markdown 和 Org mode 文件转换为微信兼容的 HTML。上传图片到微信 CDN。 创建、列出、更新和删除草稿 — 全部通过简洁的 CLI 命令完成。

# 从 Markdown 文件创建草稿
slingshot draft create --title "我的文章" --content-file post.md

# 列出所有草稿
slingshot weixin draft list

# 发布到微信公众号
slingshot weixin draft publish --id <草稿-id>

🌐 站点部署

一条命令即可通过 rsync 部署静态站点。完整支持 Zine 构建多语言站点,也支 持简单的单页管理模式。

# 添加部署目标
slingshot site add prod --type zine --user user --host example.com --path /var/www

# 构建并部署
slingshot site rsync prod

AI 智能体:认识你的弹弓

Slingshot 的命令行是文档自包含的。你的 AI 智能体无需阅读文档更新即 可学会每一个命令——它只需要直接问工具本身。

# 查看可用命令
slingshot --help

# 查看某个命令的详细帮助
slingshot site --help

# --explain 标志:解析参数并解释,不实际执行
# AI 智能体通过这种方式安全地探索命令:
slingshot draft create --explain --title "Hello" --content-file post.md

--explain 是关键。它解析每一个参数,验证命令的合法性,然后打印出将要 执行的操作——没有任何副作用。你的 AI 智能体可以大胆探索、安全犯错,在 交互中学会使用工具。

Slingshot 支持中、英双语。设置 locale 环境变量,整个 CLI 就会切换语 言——帮助文本、错误消息,一切皆然:

# 中文模式
LANG=zh_CN.UTF-8 slingshot --help

# 英文模式(默认)
slingshot --help

安装技能包

技能包是 Slingshot 的灵魂。它们封装了精心提炼的人类经验,转化为可 复用的工作流定义——数月的探索积累,浓缩成你的 AI 智能体可以立即加载执 行的配方。

# 看看有哪些技能包可用
slingshot skill list

# 安装指定技能包
slingshot skill install weixin

安装后,AI 智能体可以用同样的方式探索每个技能包的能力——用 --help 和 --explain:

# 探索技能包的功能
slingshot skill explain weixin
# 或者直接告诉你的 AI 智能体你想做什么——
# 它已经知道如何使用这些工具。

技能包会安装到项目的 .dscli/skills/ 目录,AI 助手能自动发现并使用它们。

内置技能包:

  • weixin — 微信公众号发布工作流
  • site-page — 静态站点部署(简单页面管理)
  • site-zine — Zine 站点管理(多语言支持、模板系统、版本管理)
  • incus — Incus 容器生命周期管理,用于搭建测试环境

每一个都代表着得来不易的知识,编码成 AI 能够立即使用的形式。无需在这里 逐一罗列功能——你的 AI 智能体会通过 CLI 自己发现它们的所有能力。

下一步