ht-skillslisted

# ht-skills 灏天文库管理（客户���） 通过服务端 API 调用，需配置 `config.json` 中的`token`（个人 API Token）。 --- ## 客户端注意事项（必须遵守） - **个人花园范围**：`list_collections` / `get_collection` / 新建与修改文档等读写操作**仅针对个人花园**；用户在灏天文库网页上的精品文集等非花园文集不会出现在列表中，也无法通过 ht-skills 操作。若接口返回「已晋升为精品文集」，请引导用户前往 [灏天文库](https://aiknowledge.cn) 网页编辑。 - **查询文集列表**：无 `--limit`、`--offset`；仅返回当前用户的**个人花园**文集。 - **查询文档列表**：必须带 `--collection-id`（文集 ID）；若没有文集 ID，需先 `list_collections.py --name "文集名称"` 查询，或**向用户询问目标文集名称**。 - **查询文档列表**：无 `--limit`、`--offset`。 - **更新文档**：`author` 字段不可更新，只能更新 name、content、sort、parent。 - **修改文档归属**：需有目标文集权限；一篇文档只属于一个文集，使用 `move_document.py --id <文档ID> --collection-id <目标文集ID>` 即可。 - **文档归属**：一篇文档只属于一个文集（产品约束）。 - **图片上传**：需本地可读图片路径；大文件上传耗时较长。上传成功后响应中的 `file_url` 可直接用于正文插图。 - **图片分组**：使用 `--group-id` 前可用 `list_image_groups.py` 查询分组 ID；分组必须属于当前用户。 - **RAG 文档片段检索**：`--collection-ids` 须为**灏天文库公开精品文集 ID**（见下方公开目录链接）；**不要**用 `list_collections.py` 查个人花园文集 ID 来做 RAG 检索。 --- ## 智能体执行规范（必须遵守） ### 规范一：修改特定文档 1. **先查询**：使用 `list_documents.py --collection-id <文集ID> --name "关键词"` 或 `get_document.py --id <ID>` 定位���修改的文档，确认文档 ID。 2. **再修改**：使用 `update_document.py --id <ID>` 修改标题、正文。 ### 规范二：添加特定文档 1. **文集必填**：用户必须提供目标文集。若用户未提供或只说「随便加」「你决定」等，**必须主动询问**：「请告知要将文档添加到的文集名称」。 2. **查询��集 ID**：用户给出文集名称后，用 `list_collections.py --name "文集名称"` 查询文集 ID；若不存在则询问是否新建。 3. **添加文档**：使用 `add_document.py --collection-id <ID> --name "标题" [--content 内容] [--content-file 文件路径]`。 ### 规范三：添加文集 1. **用户确认**：新建文集