Feat/iteration1 w1 foundation - #166

…undation

- 新增多模态问答及检索服务的 live E2E 测试用例，支持基于图像参数的功能验证
- 补充表格库的 chunk add/list/delete 闭环测试，验证了 field channel 的必填项和读写一致性
- 增加图片库 chunk list 的 metadata 验证，确保 image_url 数组和可见性标志存在
- 实现带覆盖重导功能的 doc import-oss 测试，确认覆盖后 fileId 变更及旧文件失效
- 编写自有 OSS Bucket 的幂等复用集合创建和获取测试，确保服务端的 tag-based 访问控制支持
- 在 gating 中添加对各类长驻知识库及服务环境变量的就绪检测函数

- 新增节点召回标记判断函数 nodesRecallMarker，避免误判 marker 出现位置
- 将所有相关轮询断言替换为基于 nodesRecallMarker 的更严格判断
- 调整删除测试中对误伤判断的断言逻辑，确保准确检测召回标记
- 扩展服务调优用例，增加描述和温度参数调优测试，验证配置持久化
- 添加通过配置文件更新 kb_search_configs 并校验嵌套配置修改生效
- 部署后验证发布版本配置正确包含所有调优项
- 更新流程注释与断言提示，提升测试用例可读性和覆盖度

- 调整smol-toml包版本位置
- 新增overrides字段，指向自定义vite和vitest包最新版本
- 保持其他依赖版本不变
- 确保包管理器锁文件一致性

- 在topic-routes中新增knowledge stats路由映射
- 在j2-content-ops测试中添加知识库统计命令调用
- 验证接口返回的存储限制和请求速率监控数据结构有效
- 记录存储限制和请求窗口数量作为测试备注
- 引入parseStdoutJson辅助函数解析JSON输出

- 支持上传参数中传入目录路径，递归扫描子目录下文件
- 自动忽略 node_modules、.git 等常见工具目录
- 不支持的文件格式不会报错，跳过并列表提示
- 上传时校验扩展名和大小限制，支持批量文件上传
- 输出中增加跳过的文件列表，verbose 模式下显示详细文件名
- 测试覆盖目录上传、文件跳过和空目录等场景
- 更新相关文档，说明新支持的目录上传功能及注意事项

…undation

- 将请求体中的 dataSource.fileIds 改为扁平结构的 docIds 字段
- 移除嵌套的 dataSource 对象，显式指定 sourceType 字段
- 更新相关单元测试以匹配新的请求参数格式和字段名称
- 在知识库删除测试中增加了导入结果和最终状态的断言，确保导入流程完整
- 新增校验导入文件在知识库文档列表中正确显示
- 调整测试中对请求体结构的断言逻辑以适配改动

- 在topic-routes测试文件中新增“knowledge doc list”步骤
- 该步骤用于验证导入的知识库文件是否可见
- 增强了知识库文件相关功能的测试覆盖率

- 移除未使用的完整文件名变量
- 使用文件名主干（去掉扩展名）进行文档匹配判断
- 更新断言提示信息以反映主干文件名匹配
- 提升测试对文档名称匹配的准确性与鲁棒性

- 在 knowledge doc delete 命令中添加异步删除的轮询验证，确保文档从服务器彻底移除
- 为 knowledge doc tag 添加标签设置后，独立调用 file get 验证标签正确应用
- 在知识库更新操作后，通过 info 命令独立验证更新是否成功保存
- 在文件删除和类别删除后，通过独立列表命令验证资源确实被清除
- 对知识块更新及排除标记修改，添加通过列表接口的内容验证步骤
- 对知识服务代理删除操作后，增加独立查询接口确保代理已彻底删除
- 补充 doc delete 备注，明确 doc_id 与 fileId 的区别及异步删除机制说明
- 增加 e2e 路由映射中缺失的 knowledge info 和 knowledge file get 命令支持

- 新增 Chunk 管理命令手册，涵盖添加、列出、更新、删除操作详解
- 新增数据中心集合与分类命令文档，介绍集合创建、查看，分类增删查等功能
- 新增文档管理命令，包含文档上传、导入 OSS、状态查询、删除及标签管理
- 新增数据中心文件管理文档，涵盖文件列表、详情查看、删除等命令说明
- 新增知识库管理命令手册，包含知识库创建、查看、更新、删除和监控
- 各命令均详细说明参数、输出格式及多模式支持（text/quiet/json）
- 提供丰富示例及注意事项，帮助用户正确使用相关命令

- 添加知识库列表、创建、删除及文件删除等命令路由
- 新增知识块、分类、文件相关参数的端到端测试，覆盖文件列表、分类列表、块新增更新及分页等功能
- 增加对知识文档状态上传、等待、轮询参数的实时测试及自清理逻辑
- 新增知识文档列表分页、过滤参数的E2E测试覆盖
- 扩展知识文档上传命令的轮询间隔参数测试，验证无错误
- 补充知识库删除命令的轮询间隔参数传递测试
- 增强知识库列表的分页、名称过滤测试用例
- 丰富知识服务命令的参数全覆盖测试，包括创建、更新、部署、删除及多版本描述等功能
- 添加知识检索命令的重新排序指令与过时参数的实时测试覆盖

- 在 headers.ts 中新增 OPEN_API_SOURCE 常量，作为静态的 OpenAPI 源标识
- 在 trackingHeaders 函数中添加 x-dashscope-openapisource 请求头
- 更新 client/index.ts 以导出 OPEN_API_SOURCE
- 在 instrumented-fetch.test.ts 中添加对应请求头的测试，确保其正确添加或省略
- 修改文档注释，明确 x-dashscope-openapisource 与 x-dashscope-source-config 的用途和区别

- 在请求和响应处理中新增 openApiSource 字段
- 更新 e2e 测试以包含 openApiSource 字段验证
- 确保请求头包含 x-dashscope-openapisource 信息
- 在测试数据中添加 openApiSource 的示例值 BailianCLI

- 修改时间参数说明，明确要求起止时间必须为过去时间
- 添加起始时间未来时报错机制，避免无意义查询
- 截断结束时间未来时间至当前时间，保障监控接口正确响应
- 添加测试覆盖，验证时间范围边界行为及错误处理
- 补充对应端到端测试路由映射，完善测试用例组织结构

- 为知识块添加和更新命令的读取内容文件函数添加了可选的inline flag参数
- 更新readUtf8TextFile以支持根据inline flag生成更友好的ENOENT错误提示
- 确保内容读取时使用严格的UTF-8编码解码方式
- 如果读取文件失败，提供文件路径和权限相关的详细错误信息
- 校验知识块内容长度时保持一致的错误处理逻辑

- 从文档中删除了 query-history 参数及示例
- 删除命令行接口中 query-history 相关 flag 定义
- 移除解析和传递 query-history 的逻辑代码
- 调整测试用例，去除对 query-history 的相关断言和测试
- 更新帮助文档，删除 query-history 相关说明和示例
- 精简接口类型定义，去除 query_history 字段

- 在file-get命令中，quiet模式下仅输出fileId，避免了多余的结果格式化
- 在kb-info命令中，quiet模式仅输出id，格式化输出逻辑得到简化
- 在kb-stats命令中，去除了quiet判断，确保非"text"格式下正确输出结果
- 在service-get命令中，quiet模式下只输出agent_id，格式化部分调整为独立判断
- 统一了各命令中针对quiet和format参数的处理流程，提升代码一致性和可读性

- 添加函数判断所有文档是否达到终止状态，防止服务器无限保持运行状态
- 修改失败信息函数，展示失败和成功文档详情，方便用户了解整体情况
- 调整轮询任务完成条件，新增所有文档终止状态判断，提升轮询准确性
- 改进轮询状态显示，增加失败文档数量与总计信息，清晰反馈任务进展

- 在知识库创建成功日志中添加请求ID信息
- 确保导入作业失败消息中包含请求追踪数据
- 改进日志详细程度，方便问题排查

- 说明 --doc-id 在实际使用中为必需，避免服务器返回 HTTP 500 错误
- 明确指出应使用 doc list 命令中的文档级别 ID，拒绝使用 chunk list 中的每行 doc_id
- 新增说明向图片类型文档添加文本块会触发服务器错误，建议使用文本类型文档
- 对帮助文档中相关描述和备注进行了同步更新，增强使用指导性和准确性

- 新增同步Flash ASR模型请求流程，支持单音频文件识别
- 实现了对同步Flash模型不支持异步标志及参数的限制校验
- 异步文件转录模型支持单文件URL上传和语言参数细化
- 优化异步和同步鉴权域显示，丰富根帮助和分组帮助提示
- speech recognize增加dry-run测试覆盖多种识别场景
- free-tier自动停用功能优化，改用统一轮询函数处理批量请求
- 统一轮询逻辑，支持console和telemetry接口的异步任务完成判定
- 规范输出格式和错误提示，增强用户调试体验
- 版本升级到1.14.3，更新示例参数和模型ID引用

- 移除 collection-get 命令中对 fileConnectorConfig 字段的输出
- 文档中补充说明 getConnector 不返回 storeType、regionId、bucketName 等字段
- 更新类型定义，去除 RagConnectorInfo 中的 fileConnectorConfig 字段
- 明确这些字段只在创建连接时请求体中传入，查询时不可读取

- 修改表格/图片知识库必须提供`--doc-id`的描述，更准确表达要求
- 调整CLI命令文档中过期或不准确信息，说明集合删除暂不支持
- 更新chunk添加命令中`--doc-id`的说明，强调对所有知识库类型均必需
- 精简chunk删除命令备注，明确批量操作自动分批处理
- 优化文档删除命令描述，强调删除异步传播及输出行为
- 修正文档状态命令中错误提示用词，更清晰表达
- 文件列表命令修改说明，明确默认分类ID不解析
- 知识库信息命令删除过时备注，突出索引设置不可变
- 服务删除命令简洁描述幂等性和权限要求
- 服务列表命令调整对场景参数的描述，明确必传要求

- 将 category-list、file-list、service-list 等命令参数的描述更新为强调“精确匹配”
- file-list 命令中 --name 参数改为匹配不含扩展名的精确文件名，并在备注中补充说明
- kb-stats 命令严格校验时间格式，增强无效格式报错及提示
- 丰富知识相关测试用例，增加对不存在 ID 的服务端错误传递和非零退出的正向断言
- 优化知识文档上传测试，支持跳过 node_modules/.git 文件夹及显示被跳过文件详情
- 修正知识搜索及聊天流程中未发布版本号引发的服务器拒绝场景测试
- 更新知识模块命令文档，补充参数要求和用法提示，提升用户指引明确度

…undation

- 新增知识库管理命令实现创建、查询、更新、删除等功能
- 支持文档上传、本地目录扫描及OSS导入，覆盖完整文档生命周期
- 增加检索与问答服务的管理及部署操作
- 实现文档切片管理，支持添加、列表、更新和删除功能
- 引入数据中心管理命令，管理类目、文件和数据集
- 检索和问答支持指定服务版本参数，方便调试和版本控制
- 所有知识库命令同步支持kscli工具，提供更短命令路径
- 移除无效参数`bl knowledge search --query-history`，建议改用聊天命令传递历史
- 请求增加静态OpenAPI来源标识请求头，改进后台渠道归因
- 添加知识库端到端测试套件，覆盖多条使用场景
- 版本号统一更新至1.16.0，文档同步更新相关版本信息

- 增加--dry-run参数的测试用例
- 验证在dry-run模式下无支持文件的退出码和错误信息
- 确保无支持文件时正确返回错误码2