🔗 PicSee URL缩短器的技巧
 
A. 基于CLI 代理技能 为了 图片查看 --通过二维码生成、点击分析和链接管理缩短URL。
适用于任何支持agent Skills标准或可以运行shell命令的AI代理。
______________________________________________________________________
🌟 特性
- 双模式操作 --未经身份验证（基本缩写）和经过身份验证（完全管理），具有自动检测功能
- URL缩短+二维码 --创建短链接并立即生成二维码（300x300px，可定制）
- 可视化分析 --总点击量、唯一点击量、每日趋势和图表生成
- 安全令牌存储 --AES-256-CBC加密，带盐密钥派生（随机32字节盐+主机名+用户名→ SHA-256）。令牌从不以明文形式存储
- 链路管理 --搜索、筛选（标签、星号、关键字）、编辑和删除
- 最小依赖性 --只需要Node.js>=18（使用内置模块，运行时不需要额外的npm包）
- 代理技能标准 --兼容25+AI代理和开发工具
______________________________________________________________________
⚙️ 安装
克劳德代码
cp -r picsee-short-link ~/.claude/skills/picsee-short-link然后调用 /picsee-short-link 或者让克劳德自动发现它。
爪集
clawhub install picsee-short-link或浏览： https://clawhub.ai/PicSeeInc/picsee-short-link
铁匠铺
通过Smithery注册表安装：
npx @smithery/cli install picsee/short-link或浏览： https://smithery.ai/skills/picsee/short-link
claude.ai
将技能文件夹上传到 定制→ 技能.Claude将在相关时自动调用它。
光标
将技能文件夹放置在 .cursor/skills/:
cp -r picsee-short-link .cursor/skills/picsee-short-linkOpenAI 代码专家
将技能文件夹放置在 .codex/skills/:
cp -r picsee-short-link .codex/skills/picsee-short-link直接命令行界面
任何具有shell访问权限的代理都可以直接调用CLI：
node /path/to/picsee-short-link/cli/dist/cli.js shorten "https://example.com"
node /path/to/picsee-short-link/cli/dist/cli.js shorten "https://example.com" --slug mylink --tags seo,marketing
node /path/to/picsee-short-link/cli/dist/cli.js list --limit 10
node /path/to/picsee-short-link/cli/dist/cli.js help______________________________________________________________________
🤖 支持的平台
此技能遵循 代理技能开放标准，它得到了以下支持：
| 平台 | 如何安装 | 工作原理 |
|---|---|---|
| 克劳德代码 | cp -r picsee-short-link ~/.claude/skills/ | 自动发现，调用 /picsee-short-link |
| claude.ai | 上传自定义中的技能文件夹→ 技能 | 相关时自动调用 |
| 开爪 | clawhub install picsee-short-link | 通过SKILL.md自动发现 |
| 光标 | 地点在 .cursor/skills/ | 由代理自动发现 |
| VS代码副本 | 地点在 .github/skills/ | Copilot自动发现 |
| OpenAI 代码专家 | 地点在 .codex/skills/ | 自动发现 |
| 双子星命令行工具 | 地点在 .gemini/skills/ | 自动发现 |
| 任何壳剂 | 指向CLI路径 | node cli/dist/cli.js shorten "..." |
看 agentskills.io 网站 查看支持平台的完整列表。
______________________________________________________________________
🧩 命令
| 命令 | 描述 | 身份验证 |
|---|---|---|
shorten | 创建一个 pse.is 带有可选自定义slug、标签、UTM和预览元数据的短链接 | 可选 |
analytics | 点击统计数据——总计、唯一和每日细分 | 必填 |
chart | 获取分析并生成可视化每日点击趋势的图表URL | 必填 |
list | 使用过滤器（标签、关键字、星号、日期范围）列出和搜索链接历史记录 | 必填 |
edit | 更新目标URL、slug、标题、描述、标签、过期时间（高级计划） | 必填 |
delete | 删除短链接 | 必填 |
recover | 恢复已删除的短链接 | 必填 |
qr | 为任何短链接生成二维码URL | 否 |
auth | 在本地验证并加密PicSee API令牌 | 否 |
auth-status | 检查当前身份验证状态 | 否 |
______________________________________________________________________
🔑 认证
# Store your PicSee API token (encrypted locally)
node /path/to/picsee-short-link/cli/dist/cli.js auth
# Check auth status
node /path/to/picsee-short-link/cli/dist/cli.js auth-status获取您的令牌： picsee.io → 阿凡达→ 设置→ API → 复制令牌。
______________________________________________________________________
🔒 安全
| 方面 | 细节 |
|---|---|
| 存储 | ~/.openclaw/.picsee_token （加密令牌）+ ~/.openclaw/.picsee_salt （随机盐） |
| 加密 | AES-256-CBC，每次写入随机IV |
| 导出密钥 | SHA-256(random-32byte-salt + hostname + "-" + username) --salt只生成一次，即使主机名/用户名已知，密钥也无法预测 |
| 文件权限 | 0600 在令牌和盐文件上（仅限所有者读/写） |
______________________________________________________________________
📁 项目结构
picsee-short-link/
├── SKILL.md # Agent Skills definition (open standard)
├── cli/ # CLI Tool (TypeScript)
│ ├── src/
│ │ ├── cli.ts # CLI entry point + command definitions
│ │ ├── api.ts # PicSee REST API client
│ │ └── keychain.ts # AES-256-CBC token storage
│ ├── dist/ # Compiled output
│ ├── package.json
│ └── tsconfig.json
├── references/ # API documentation
├── README.md # This file
└── _meta.json # ClawHub registry metadata______________________________________________________________________
📖 资源
- PicSee网站： https://picsee.io
- API文件： https://picsee.io/developers/docs/public-api.html
- 代理技能规范： https://agentskills.io
______________________________________________________________________
📄 许可证
麻省理工学院