一、ht-skills 是什么?
name: ht-skills
description: 管理灏天文库文集、文档和知识工坊。支持新建、查询、更新、文档移动、图片、知识检索、花园晋升,以及把 HTML 报告上传到工坊集
ht-skills 是灏天文库的技能包。优先装在 WorkBuddy、千问办公、豆包工作。Cursor、Zcode、QoderWork、OpenClaw 等支持技能的软件也可以用。配置个人 Token 后即可:
- 新建与维护文集:创建、查询、更新个人花园文集
- 新建与维护文档:写入正文、调整目录层级、移动文档归属
- 图片管理:创建图片分组、上传图片、查看用量
- 知识工坊:把 HTML 报告按主题放进工坊集,默认公开到知识广场
- 文档片段检索:从公开精品文集中检索相关片段及出处(不调用大模型)
- 花园文集晋升:将个人花园文集申请为平台精品文集,由管理员审核
- 适用于 AI 自主写文章并入库、HTML 报告进知识广场、知识检索、花园晋升等场景
使用前需在技能配置中填写你的个人 Token(见下方「个人 Token 怎么获取」)。服务地址一般按技能包默认即可,无需改动。
二、怎么安装?
WorkBuddy、千问办公、豆包工作都走下面四步。其他支持技能的软件同样适用,菜单位置以该软件当前帮助为准。
-
获取 ht-skills 技能包
从官方渠道获取安装包,也可以从
GitHub 仓库下载。
-
安装到办公软件
按该软件的「技能」说明,把技能包放到技能目录,并刷新技能列表。优先安装到 WorkBuddy、千问办公或豆包工作。
-
填写个人 Token
在技能配置中填入你的个人 Token(见下方获取方式)。配置文件写法以技能包内说明为准。
-
验证是否可用
说一句「列出我的文集」;若能返回你的文集列表,说明已配置成功。
三、知识工坊(HTML 报告)
把做好的 HTML 报告、仪表盘、演示页放进知识工坊。不要写成花园里的普通笔记。
怎么放
-
先定一本工坊集
同一主题用同一本,例如「充电站分析」。不要每份报告新建一本,也不要用日期当名字。
-
默认公开
创建或上传后,整本会出现在知识广场。你说「别公开」,技能会把它收回,外人看不到。某一页也可以先当草稿。
-
用工坊链接打开
上传成功后,技能给你的是工坊链接。把这个链接发给自己或别人,不要用文件直链。
额度:免费 20 本工坊集、30 页、一共 50MB;会员 80 本、200 页、一共 300MB。空的工坊集也占一本。到上限后请复用已有工坊集。
四、文档片段检索
从灏天文库公开精品文集中检索与问题相关的文档片段及出处,不调用大模型,适合给 AI 提供参考资料。
文集 ID 从哪里获取?
检索针对的是平台公开精品文集。请到官方目录查看「ID | 文集名称」,再把需要的 ID 交给技能使用:
注意:技能里「列出我的文集」只能看到你自己的个人花园,不能代替上面的公开目录。做检索时请以上述链接为准。单次最多选择 5 个文集。
五、花园文集晋升申请
把已经写好的个人花园文集,申请晋升为平台精品文集。管理员审核通过后,文集会进入精品展示。
说明:晋升不是新建文集,而是提交已有花园文集审核;请确保文集内已有文档内容。审核通过后,技能不能再改这本文集的名称和文档,请到灏天文库网页维护。提交前请确认内容已定稿。
推荐流程
-
先确认还能不能申请
每用户 24 小时最多申请 1 次(网页个人中心和技能共用这一次)。可先让技能查询当前额度。
-
确认目标文集
用「列出我的文集」找到要晋升的文集,并确认其中已有文档。
-
提交申请
告诉技能要晋升哪本文集,可附带简短申请说明。
-
查看进度
可查询申请列表,状态为:待审 / 通过 / 驳回。
六、使用须知
- 查文档前先确定文集:不知道文集时,先让技能列出你的文集
- 只操作个人花园:技能看不到网页上的精品文集;已经晋升成功的文集,请到网页编辑
- 可改内容:花园文档可改标题、正文、排序与目录层级。作者名不能改
- 封面:新建文集后,封面会在半小时内自动生成一次,暂时不能自己换;改名后封面可能和名称对不上
- HTML 报告进知识工坊:不要把完整 HTML 当成花园笔记
- 内容审核:新建或修改文集、文档时可能触发敏感词等审核;失败时按提示调整后重试
- 检索与个人花园无关:检索用的文集 ID 来自公开目录,不是你个人花园列表里的 ID
七、额度说明
个人花园相关能力会根据用户等级和会员状态限制用量。
个人花园
| 限制项 |
说明 |
与等级 / 会员的关系 |
| 文集数量 |
可创建的个人花园文集数量上限 |
按等级头衔对应 6/8/12/16/24/36 个;
会员 = 基础数 × 2
|
| 每文集文档数 |
单个文集内最大文档数 |
普通用户:50 篇 / 会员:150 篇 |
| 每文档字数 |
单篇文档最大字符数 |
普通用户:20,000 字 / 会员:50,000 字 |
等级与基础文集数
| 等级范围 |
头衔 |
基础文集数 |
| Lv.1-4 | 新手 | 6 |
| Lv.5-9 | 入门 | 8 |
| Lv.10-19 | 进阶 | 12 |
| Lv.20-29 | 资深 | 16 |
| Lv.30-49 | 专家 | 24 |
| Lv.50+ | 大师 | 36 |
说明:会员可建文集数 = 基础文集数 × 2。升级等级或开通会员可提升额度。
知识工坊
八、个人 Token 怎么获取?
使用 ht-skills 前,必须先获取个人 Token。Token 用于证明是你本人操作,请勿泄露给他人。
-
登录灏天文库
访问 aiknowledge.cn 并登录你的账号。
-
进入个人中心
点击右上角头像,选择「个人中心」。
-
查看个人 Token
在个人中心的Token 信息区域查看;若尚未生成,系统会自动创建。
-
复制并配置
点击「复制」,粘贴到 ht-skills 的配置中(写法见技能包说明)。
刷新说明:用户每周可刷新一次 Token;若怀疑泄露,请及时刷新以使旧 Token 失效。