一、这是做什么的?
装好 ht-skills 并填入个人 Token 后,优先在 WorkBuddy、千问办公、豆包工作 里用日常说话的方式操作灏天文库——不必自己点网页、也不必写代码。Cursor、Zcode、QoderWork、OpenClaw 等同样支持技能的软件也可以装。
name: ht-skills
description: 管理灏天文库文集、文档和知识工坊。支持新建、查询、更新、文档移动、图片、知识检索、花园晋升,以及把 HTML 报告上传到工坊集
小提示:优先推荐 WorkBuddy、千问办公、豆包工作。把 ht-skills 装进对应技能目录并配置 Token 即可。OpenClaw 等其他支持技能的软件同样可用。各软件菜单位置以当前版本为准。完整能力见下方使用说明。
二、能做什么?
- 新建与维护文集:创建、查询、更新个人花园文集
- 新建与维护文档 / 笔记上传:写入正文、调整目录层级、移动文档归属
- 图片管理:创建图片分组、上传图片、查看用量
- 文档片段检索(RAG):从公开精品文集中检索相关片段及出处(不调用大模型)
- 知识工坊:把 HTML 报告按主题放进工坊集,默认公开到知识广场
- 花园文集晋升:将个人花园文集申请为平台精品文集,由管理员审核
- 适用于 AI 自主写文章并入库、HTML 报告进知识广场、知识检索、花园晋升等场景
使用前需在技能配置中填写你的个人 Token(见下方「个人 Token 怎么获取」)。服务地址一般按技能包默认即可。
三、通用三步(所有工具共用)
-
获取个人 Token
登录灏天文库 → 个人中心 → 复制「个人 Token」(详见第六节)。
-
安装 ht-skills 技能包
从
GitHub 仓库
或官方渠道下载技能包,按该工具的「Skills / 技能 / Agent 技能」说明放入对应目录,并刷新技能列表;在配置里填入个人 Token。
-
用自然语言验证
对 Agent 说一句「列出我的文集」;若能返回你的文集列表,说明已配置成功。
四、常用工具怎么选?
想直接操作灏天文库时,优先用下面三款。它们都支持技能,安装步骤相同。其他软件也可以装同一个技能包。
说明:上表工具均支持 Skills。各软件菜单位置、技能目录路径会随版本变化,请以该软件当前帮助文档为准。配置写法以
ht-skills 仓库说明 为准。
想读得更深?站内教程
五、自然语言示例(可直接照着说)
配置成功后,在对话里直接输入下面这类话即可(把 xxx 换成你的真实名称):
- 列出我的文集
- 在个人花园新建文集《xxx》
- 把下面这篇笔记上传到文集《xxx》
- 检索公开目录里关于 xxx 的片段
- 申请把文集《xxx》晋升为精品
- 把这份 HTML 报告放到知识工坊《xxx》
文档片段检索(RAG)
检索针对的是平台公开精品文集,不是你个人花园列表里的 ID。请到官方目录查看「ID | 文集名称」,再交给技能使用;单次最多选 5 个文集。
知识工坊要点
- HTML 报告、仪表盘、演示页放进知识工坊,不要写成花园里的普通笔记
- 同一主题复用一本工坊集,不要每份报告新建一本,也不要用日期当名字
- 默认整本公开到知识广场;说「别公开」可以撤回
- 上传成功后使用技能给你的工坊链接打开
花园晋升要点
- 晋升是提交已有花园文集审核,不是新建空文集
- 每用户 24 小时最多申请 1 次(网页个人中心和技能共用这一次)
- 可查询申请列表,状态为:待审 / 通过 / 驳回
- 审核通过后,技能不能再改这本文集的名称和文档,请到灏天文库网页维护
六、个人 Token 怎么获取?
使用 ht-skills 前,必须先获取个人 Token。Token 用于证明是你本人操作,请勿泄露给他人。
-
登录灏天文库
访问 aiknowledge.cn 并登录你的账号。
-
进入个人中心
点击右上角头像,选择「个人中心」。
-
查看个人 Token
在个人中心的Token 信息区域查看;若尚未生成,系统会自动创建。
-
复制并配置
点击「复制」,粘贴到 ht-skills 的配置中(写法见技能包说明)。
刷新说明:用户每周可刷新一次 Token;若怀疑泄露,请及时刷新以使旧 Token 失效。
七、额度与使用须知
个人花园额度(摘要)
知识工坊额度
说明:空的工坊集也占一本额度。已到上限时,请复用已有工坊集。
使用须知
- 查文档前先确定文集:不知道文集时,先让技能列出你的文集
- 只操作个人花园:技能看不到网页上的精品文集;已经晋升成功的文集,请到网页编辑
- 封面:新建文集后,封面会在半小时内自动生成一次,暂时不能自己换;改名后封面可能和名称对不上
- HTML 报告进知识工坊:不要把完整 HTML 当成花园笔记
- 内容审核:新建或修改文集、文档时可能触发敏感词等审核;失败时按提示调整后重试
- 检索与个人花园无关:检索用的文集 ID 来自公开目录,不是你个人花园列表里的 ID