knowuv-skill-set

为 AI Agent 提供的技能集合，基于 knowuv.com API，赋予 Agent 短链管理、表单收集等能力。

技能列表

1. URL Shortener（短链管理）

目录：skills/url-shortener/

通过 KnowUV ShortLink API 对短链进行完整的增删改查操作。

主要功能：

• 创建短链（支持 A/B 分流、设置过期时间）
• 列出 / 查询短链
• 更新短链（目标 URL、标签、状态等）
• 删除短链（支持批量）
• 查看访问日志（PV 明细：IP、城市、设备、来源等）
• 查看流量图表（24 小时 / 7 天 / 30 天等多维度统计）
• 列出可用域名

插件支持：

插件	说明
filterCrawler	过滤爬虫 / 机器人
requirePassword	访问密码验证
phoneNumberVerification	手机号短信验证
fillForm	访前填写表单
restrictionRules	按国家 / 城市 / IP 限制访问
burnAfterReading	阅后即焚（限定访问次数）
forceToWechat	强制在微信内打开

认证：读取 config.ini 中的 USER_TOKEN，或访问 https://knowuv.com/JZfdJ 获取。

---

2. Form Manager（表单管理）

目录：skills/form-manager/

将 AI 生成的落地页与 KnowUV 后端连接，实现真实的客户数据收集与管理。

主要功能：

• 提交表单数据（SubmitForm）
• 列出所有表单（ListForm）
• 查看表单提交记录（ListSubmitFormDetail）
• 获取最新提交（GetLatestSubmitFormDetail）
• 删除表单或单条提交记录

典型场景：

• 夏令营 / 活动报名页
• 产品候补名单收集
• 课程招生落地页
• 任意需要收集用户信息的 HTML 页面

工作流：

1. 为落地页选择一个表单名称（如 summer-camp-2024）
2. 在 HTML 表单的提交处理器中注入 SubmitForm 请求
3. 调用 GetLatestSubmitFormDetail 验证测试提交是否成功
4. 在管理后台 https://knowuv.com/admin/internal/form_structure 浏览和导出数据

认证：读取 config.ini 中的 USER_ID 和 USER_TOKEN，或访问上述管理后台获取。

---

安装

npx skills

需要先安装 Node.js，然后运行：

# 安装到当前项目（可提交到 git，方便团队共享）
npx skills add dusty-cjh/knowuv-skill-set

# 全局安装（对本机所有项目生效）
npx skills add dusty-cjh/knowuv-skill-set --global

许可证

LICENSE