Files
modelstudioai__cli/README.md
T
zeyu.fz e1793e1f3a refactor(cli): 替换所有 kscli 命令为 bl CLI 命令
- README 文档中将管理面 CLI 名称由 kscli 改为 bl CLI
- 包描述与说明中更新 CLI 名称与对应命令用法
- 技能文档及其命令参考全面替换 kscli 为 bl
- 所有子命令示例和用法文档同步改为 bl 及对应子命令路径
- 更新服务发现命令由 kscli 改为 bl knowledge service list
- 更新鉴权说明改为 bl auth login 及相关配置命令
- 维护命令结构一致性,保证用户可无缝使用 bl 替代原 kscli
2026-08-21 00:19:29 +08:00

2.4 KiB
Raw Blame History

bailian-kb-dsh

阿里云百炼知识库能力的 DeepSeek Harness (dsh) 插件 bundle三个 API 直连模型工具(kb_service_list / kb_search / kb_chat+ bl CLI 管理面 skill。

设计文档:docs/specs/2026-08-15-bailian-kb-bundle-design.md · 实现计划:docs/plans/2026-08-15-bailian-kb-bundle.md

仓库结构

目录 职责
packages/tool-bailian-kb 插件包(同时是 dsh bundleConfig、KbClient、工具、skill、cordis.patch.yml、浏览器端配置页

安装dsh 用户)

dsh plugin --profile web add @ali/bailian-kb-dsh   # npm 发布后;本地开发用绝对/相对路径

安装后 CLI 自动把 bundle 加入 profile 的层栈,无需手改 YAML。

配置写入 ~/.dsh/.env

BAILIAN_WORKSPACE_ID=ws-xxx        # 必填:百炼工作空间 id
DASHSCOPE_API_KEY=sk-xxx           # 必填:也可放 ~/.dsh/.credentials.yaml

验证:dsh --profile web --dump-config 应能看到 tool-bailian-kb row。缺 BAILIAN_WORKSPACE_ID 时加载期直接报错fail loud不会静默跳过。

卸载:dsh plugin --profile web remove @ali/bailian-kb-dsh

开发

依赖 dsh 的运行时包(@deepseek-ai/dsh-tools 等)以 peerDependencies 声明、由 dsh 安装闭包在运行时提供;开发期通过 link: 指向同级的 ../deepseek-harness checkoutnpm registry 尚未发布完整 dsh 闭包)。

pnpm install
pnpm run test        # vitest 单元测试
pnpm run typecheck
pnpm run build       # tsc 产出 lib/

本地联调:只需 add 一次(包同时声明 dsh.bundle 和插件代码):

dsh plugin --profile dev add <本仓库>/packages/tool-bailian-kb

patch 文件受 HMR 监听。

Known Limitations

  • 无 keyless snapshot / e2e 基建:首版以单元测试 + 手动集成验收覆盖snapshot/e2e 依赖 dsh snapshot harness 对 out-of-tree bundle 的支持情况v0.2 跟进。
  • kb_chat 执行期无进展显示:服务端是分钟级 agentic loopUI 只有 pending → 完成两态;进展会话事件 + Web 渲染器的设计见 spec 附录 A等真实使用反馈再排期。
  • 服务清单单 scene 上限 100 条:超出部分靠 name_filter 收窄(结果带 truncated 提示)。