跳转至

在 Claude Code 里用 Dosi 插件

Claude Code 能用上插件的全部功能:dosi 的 MCP 工具、各个 skill、钩子,还有它独有的 界面(状态栏、/dosi 和血缘面板)。插件在所有 Agent 里都能做什么,见 Dosi 插件。

安装

在 Claude Code 提示符里输入:

/plugin marketplace add Datus-ai/dosi-plugins
/plugin install dosi@dosi-plugins

然后运行 /reload-plugins,或者开一个新会话。Claude Code 2.1.275 及以上版本可以 一行完成:/plugin install dosi --marketplace Datus-ai/dosi-plugins。在 shell 里:

$ claude plugin marketplace add Datus-ai/dosi-plugins
$ claude plugin install dosi@dosi-plugins

确认装好了

打开一个项目目录,开一个会话。第一次会话会在后台下载 dosi,等十秒左右,然后:

  • /mcp 里能看到 plugin:dosi:dosi 已连接。服务随会话启动,并且跟着 dosi/model.yaml 走:模型还没建时它也能启动,模型写出来后自动加载。
  • /dosi 显示当前连接、模型及其是否通过校验,以及下一步做什么。

然后直接问数据问题。Claude 会通过 dosi 的工具回答,dosi 自己的调用不弹权限确认。

只有 Claude Code 才有的

这些都不改变 Claude 读到的内容,没有它们每一步照样能完成。

  • 状态栏:项目的实时状态,比如 dosi · duckdb:local · 3 ds · 8 metrics · ontology 3。
  • /dosi:当前连接、模型,数据集、指标、维度各有多少,ontology,以及下一步。 /dosi metrics 列出每个指标和它的说明。
  • /dosi lineage [指标]:打开一个面板,画出指标是由什么算出来的,或者有哪些 东西依赖某张表。按 h 还会写出一份 HTML 页面。
  • 结果表格:dosi 的结果显示成表格,下面注明来源和行数,点一下就能看 SQL。 命令失败时显示错误、原因和下一步该做什么。
  • 功能建议:问过几个问题后,插件会提议看血缘,之后再提议构建 ontology,各提一次。

更新和卸载

$ claude plugin marketplace update dosi-plugins
$ claude plugin update dosi@dosi-plugins

重启 Claude Code 后加载新版本。dosi 本身单独升级:在对话里说“升级 dosi”。

卸载插件:/plugin uninstall dosi@dosi-plugins,它下载的 dosi 也会一起删除。

排错

现象 解决办法
Plugin "dosi" not found in any marketplace Claude Code 版本低于 2.1.275,用两行的安装方式
/mcp 里 plugin:dosi:dosi 显示失败 会话启动时第一次下载还没完成。在 /mcp 里重连,或者开新会话
Claude 在 shell 里跑 dosi,没用工具 装的是不带 MCP 服务的旧版插件,按上面的方法更新