千鹿AI - 千鹿Skill

千鹿Skill 是千鹿AI（qianlu.net）官方推出的 Agent Skill，让任意支持
Skill/工具调用的 AI Agent（Claude、Codex、Cascade 等）都能调用千鹿AI 的能力：登录千鹿
账号、素材管理、千鹿AI 生图、千鹿AI 生视频、算力查询等，全部通过自然语言对话完成，无需
用户了解任何底层实现细节。

🔗 访问千鹿AI 官网 qianlu.net 了解更多产品能力、注册账号、
查看会员与算力价格。

使用过程中有任何问题，欢迎扫码加入企微交流群，详见文末「加入交流群」。

千鹿Skill 包含内容

SKILL.md — 千鹿Skill 技能描述、Agent 调用规范与安全约束
agents/openai.yaml — OpenAI/Codex 平台适配
references/commands.md — 千鹿AI 能力的底层命令参考（供 Agent 内部调用，非最终用户使用）
references/credit-rules.md — 千鹿AI 算力规则说明
scripts/ — Windows/macOS/Linux 安装脚本

在 Agent 中安装千鹿Skill

把下面这句话直接发给你的 Agent（Claude、Codex、Cascade 等），即可完成千鹿Skill 的安装：

帮我安装这个 Agent Skill：https://github.com/hkstarry2019-hue/QianluSkill.git

安装完成后，Agent 即可读取到千鹿Skill 的技能描述，获得调用千鹿AI 各项能力的入口。

首次安装后，只需在对话中让 Agent 按提示完成一次初始化（详见 scripts/install.md），
即可开始使用；支持 Windows / macOS / Apple Silicon / Linux 全平台。初始化完成后
重启 Agent 会话，即可直接用自然语言使用千鹿AI 的各项能力。

尚未注册千鹿账号？前往 qianlu.net 免费注册后即可登录使用。

在 Agent 中使用千鹿Skill

安装千鹿Skill 后，无需了解任何底层实现细节，直接用自然语言与 Agent 对话即可，例如：

「帮我登录一下千鹿账号」
「查看我的千鹿账户信息和算力余额」
「用千鹿AI 生成一张站在月球上的橘猫图片」
「把这张图的背景换成星空」（图生图）
「用千鹿AI 生成一段海浪拍打沙滩的视频，16:9，10秒」
「让这张图动起来」（图生视频）
「把这个文件上传到千鹿素材库」
「这次生成大概要消耗多少算力」

千鹿Skill 会自动为 Agent 选择合适的千鹿AI 模型与参数、处理任务提交与状态跟踪、并在算力
不足或需要升级会员时引导用户前往对应页面，全程无需用户关心具体实现。开发者或需要精确
控制模型参数的高级用户，可参考 references/commands.md 中的底层命令说明。

架构说明

本仓库是千鹿Skill 的 Skill 层（技能描述 + 安装脚本），负责告诉 Agent 如何理解和调用
千鹿AI 的各项能力。实际的千鹿AI 调用由千鹿官方提供的执行组件完成，所有操作都通过统一、
可控的方式与千鹿AI 后端交互，Skill 不直接访问底层接口。

┌─────────────────────────────────────────────┐
│           千鹿Skill (本仓库, MIT)             │
│  SKILL.md + references + scripts             │
│  告诉 Agent 如何调用千鹿AI 能力               │
└──────────────────┬──────────────────────────┘
                   │ 调用
                   ▼
┌─────────────────────────────────────────────┐
│           千鹿AI 执行组件                     │
│  登录 / 上传 / 生图 / 生视频                  │
└──────────────────┬──────────────────────────┘
                   │ HTTPS + Bearer Token
                   ▼
┌─────────────────────────────────────────────┐
│           千鹿AI 后端 OpenAPI                 │
└─────────────────────────────────────────────┘

千鹿Skill 本身以 MIT 协议开源；千鹿AI 执行组件由千鹿官方分发，其使用受千鹿服务条款约束。

信任模型与安全说明

组件	开源？	你能审计什么
SKILL.md / references	✅ MIT 开源	Agent 调用逻辑、安全约束、口径规范
安装脚本 (scripts/)	✅ MIT 开源	下载源、SHA-256 校验、安装流程

千鹿Skill 在 Agent 调用层面实施了以下安全约束：

登录凭证存储在用户本地目录，不以明文存储密码
所有网络请求通过 HTTPS + Bearer Token 加密传输
Agent 只通过千鹿Skill 规定的方式调用千鹿AI，不绕过安全约束直接操作后端（详见
SKILL.md 安全约束章节）
安装脚本对下载的组件进行 SHA-256 校验

故障排查

问题	解决方案
提示未识别到千鹿AI 相关能力	重启 Agent 会话使千鹿Skill 生效，或参考 `scripts/install.md` 重新完成初始化
PowerShell 执行策略阻止脚本	执行 `Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass` 后重试（仅限当前进程，不影响系统策略）
macOS 提示"无法验证开发者"	在系统设置 → 隐私与安全性中点击"仍要打开"
SHA-256 校验失败	重新执行安装脚本，或检查网络是否被代理/防火墙拦截
更新千鹿Skill 后功能仍为旧版	参考 `scripts/install.md` 中"整目录替换"章节完成完整更新

加入交流群

使用千鹿Skill 过程中遇到任何问题，欢迎扫码添加企业微信加入交流群，官方团队会在群内答疑：

千鹿AI 企微交流群二维码

更多产品信息、教程与动态请访问千鹿AI 官网：qianlu.net。

安全披露

如发现安全漏洞，请不要在 GitHub Issues 中公开提交。请发送邮件至安全团队 [email protected]（附带 PoC 和影响说明），我们会在收到后 72 小时内响应。

License

MIT，详见 LICENSE。

MIT 许可证仅适用于本 Skill 仓库（SKILL.md、references、scripts 等）。千鹿AI CLI执行组件由千鹿官方分发，不受此许可证管辖。