AI IDE / Agent 连接灏天文库 - ht-skills 全景指南

一、这是做什么的？

装好 ht-skills 并填入个人 Token 后，你可以在 WorkBuddy、QwenWork、QoderWork、Cursor、Zcode、OpenClaw 等均已支持 Skills 的 AI Coding / Work Agent 软件里，用日常说话的方式操作灏天文库——不必自己点网页、也不必写代码。

name: ht-skills
description: 管理灏天文库文集和文档，支持新建、查询、更新、文档移动、知识检索与花园晋升申请

小提示：WorkBuddy、QwenWork、QoderWork、Cursor、Zcode、OpenClaw 都支持 Skills。把 ht-skills 装进对应技能目录并配置 Token 即可连接文库；OpenClaw 为官方已验证宿主，安装步骤见专项指南。各软件菜单位置以当前版本为准。

二、能做什么？

新建与维护文集：创建、查询、更新个人花园文集
新建与维护文档 / 笔记上传：写入正文、调整目录层级、移动文档归属
图片管理：创建图片分组、上传图片、查看用量
文档片段检索（RAG）：从公开精品文集中检索相关片段及出处（不调用大模型）
花园文集晋升：将个人花园文集申请为平台精品文集，由管理员审核
适用于 AI 自主写文章并入库、知识检索增强、花园晋升等场景

使用前需在技能配置中填写你的个人 Token（见下方「个人 Token 怎么获取」）。服务地址一般按技能包默认即可。

三、通用三步（所有工具共用）

获取个人 Token
登录灏天文库 → 个人中心 → 复制「个人 Token」（详见第六节）。
安装 ht-skills 技能包
从 GitHub 仓库或官方渠道下载技能包，按该工具的「Skills / 技能 / Agent 技能」说明放入对应目录，并刷新技能列表；在配置里填入个人 Token。
用自然语言验证
对 Agent 说一句「列出我的文集」；若能返回你的文集列表，说明已配置成功。

OpenClaw 用户请看更细的四步安装： OpenClaw 连接灏天文库专项指南 →

四、常用工具怎么选？

这些工具都支持 Skills，不是互相取代，而是各有侧重。想直接操作灏天文库时，在任意一款里装好 ht-skills 即可；选工具时看你日常更常写代码、记记忆，还是跑技能平台。

工具	类型	适合谁	与灏天文库
OpenClaw 官方推荐	技能运行平台	想用自然语言管理文库、同步与发布的人	支持 Skills；ht-skills 原生宿主，官方已验证
Cursor	AI 编程编辑器	写代码、方案探索、对话沉淀知识	支持 Skills；安装 ht-skills 后可用自然语言入库
WorkBuddy	AI 记忆协作	长期项目、跨会话连续工作	支持 Skills；安装 ht-skills，记忆与文库联动
Zcode	AI 计划型智能体	复杂任务先做结构化计划再执行	支持 Skills；安装 ht-skills，计划成果可直接入库
QwenWork	AI Work Agent	习惯通义生态、用 Agent 干活的人	支持 Skills；按第三节通用步骤安装 ht-skills
QoderWork	AI Work Agent	用 Agent 驱动日常编码与知识工作的人	支持 Skills；按第三节通用步骤安装 ht-skills

说明：上表工具均支持 Skills。各软件菜单位置、技能目录路径会随版本变化，请以该软件当前帮助文档为准。配置写法以 ht-skills 仓库说明为准。

想读得更深？站内教程

五、自然语言示例（可直接照着说）

配置成功后，在对话里直接输入下面这类话即可（把 xxx 换成你的真实名称）：

列出我的文集
在个人花园新建文集《xxx》
把下面这篇笔记上传到文集《xxx》
检索公开目录里关于 xxx 的片段
申请把文集《xxx》晋升为精品

文档片段检索（RAG）

检索针对的是平台公开精品文集，不是你个人花园列表里的 ID。请到官方目录查看「ID | 文集名称」，再交给技能使用；单次最多选 5 个文集。

灏天文库文集完整目录公开 →

花园晋升要点

晋升是提交已有花园文集审核，不是新建空文集
每用户 24 小时最多申请 1 次
可查询申请列表，状态为：待审 / 通过 / 驳回

六、个人 Token 怎么获取？

使用 ht-skills 前，必须先获取个人 Token。Token 用于证明是你本人操作，请勿泄露给他人。

登录灏天文库
访问 aiknowledge.cn 并登录你的账号。
进入个人中心
点击右上角头像，选择「个人中心」。
查看个人 Token
在个人中心的Token 信息区域查看；若尚未生成，系统会自动创建。
复制并配置
点击「复制」，粘贴到 ht-skills 的配置中（写法见技能包说明）。

前往个人中心获取 Token →

刷新说明：用户每周可刷新一次 Token；若怀疑泄露，请及时刷新以使旧 Token 失效。

七、额度与使用须知

个人花园额度（摘要）

限制项	普通用户	会员
文集数量	按等级 6/8/12/16/24/36	基础数 × 2
每文集文档数	50 篇	150 篇
每文档字数	20,000 字	50,000 字

使用须知

查文档前先确定文集：不知道文集时，先让技能列出你的文集
数据范围：普通用户只能看到和操作自己账号下的文集与文档
内容审核：新建或修改文集、文档时可能触发敏感词等审核；失败时按提示调整后重试
RAG 与个人花园无关：检索用的文集 ID 来自公开目录，不是你个人花园列表里的 ID