Skip to main content

数据中心文件命令

kscli file 命令组，查看和删除数据中心的源文件

数据中心是知识库文件的存储层。文件通过 doc upload 或 doc import-oss 进入数据中心，再导入知识库，同一个文件可被多个知识库引用。本组共 3 个命令。 鉴权、业务空间 ID、全局参数、输出格式、二次确认等通用约定见 CLI 概述。以下示例默认已通过配置文件设置业务空间 ID。

kscli file list

列出数据中心某个分类下的文件。 
kscli file list --category-id <id> [flags]
参数
参数类型必填说明
--category-id <id>string是分类 ID，精确匹配。通过 category list 获取
--name <text>string否按文件名精确过滤，不含扩展名。例如查 a.md 传 a
--file-id <id>array否按文件 ID 精确过滤，可重复传入
--next-token <token>string否游标分页令牌，从上次输出获取
--max-result <n>number否每页条数
输出 
file-xxx  SUCCESS  intro.md  1024
next: --next-token eyJ...
quiet 模式每行输出一个文件 ID。json 模式返回完整结果。
--category-id 必须是真实的分类 ID，不接受字面量 default，传入字面量会返回空列表。通过 kscli category list 或 kscli file get 输出中的 category 字段获取真实 ID。
本命令使用游标分页，将输出末行提示的 --next-token <token> 传入下一次调用即可翻页。 --name 是精确匹配且不含扩展名，与 kb list --name 的模糊匹配行为不同。 示例 
# 列出分类下的文件
kscli file list --category-id cate-xxx

# 按文件名查找 report.pdf
kscli file list --category-id cate-xxx --name report

# 翻页
kscli file list --category-id cate-xxx --next-token eyJ...

kscli file get

查看数据中心文件的详情。 
kscli file get --file-id <id> [flags]
参数
参数类型必填说明
--file-id <id>string是数据中心文件 ID
输出 
id: file-xxx
name: intro.md
type: md
size: 1024
status: SUCCESS
parser: AUTO_SELECT
category: cate-xxx
uploaded: 2026-01-01T00:00:00Z
tags: project-a, draft
quiet 模式和 json 模式均返回完整 JSON 结果。 输出中的 category 字段可作为 file list --category-id 的入参。 示例 
kscli file get --file-id file-xxx

kscli file delete

从数据中心永久删除文件。 
kscli file delete --file-id <id> [flags]
参数
参数类型必填说明
--file-id <id>string是数据中心文件 ID
--yesswitch否跳过确认提示
输出 
deleted: file-xxx
quiet 模式无输出。json 模式返回完整结果。
删除不可恢复，且会影响所有引用该文件的知识库，相关文档索引随之失效。执行前建议确认哪些知识库引用了此文件。
与 doc delete 的区别：
命令作用范围源文件
kscli doc delete从单个知识库索引中移除文档保留
kscli file delete删除数据中心的源文件删除，影响所有引用它的知识库
示例 
# 交互确认后删除
kscli file delete --file-id file-xxx

# 跳过确认
kscli file delete --file-id file-xxx --yes