Kandev 是一款开源的 AI 看板与开发环境（AI Kanban & Development Environment），支持编排多个 AI Agent、审查代码变更并自动开 PR。它的插件市场（Plugin Marketplace）内置在应用内，无需手动下载 tarball，即可一键安装语音输入、Slack 集成、Bitbucket 集成等插件，并可随时更新与卸载。本指南带你从零完成 Kandev 插件市场的浏览、安装、配置与更新全流程，新手也能快速上手。

Kandev 插件市场是什么：免配置的一键安装入口

插件市场是 Kandev 内置的精选插件目录，入口位于侧边栏Settings > Plugins，无需任何 feature flag 即可使用。它默认启用官方源（由维护者逐条审核入库），同时支持添加团队/企业内部源，目录会自动合并展示。

市场页分两个标签页：

• Browse：跨所有已启用源的合并目录，支持按名称搜索、按分类过滤、按星数/更新时间排序；
• Installed：本实例已安装的插件列表，提供启用/禁用/卸载/更新操作。

每张插件卡片会展示名称、简介、作者、分类、最新版本号与来源仓库。点击Install即可走与 URL 安装完全相同的校验流水线：先校验包内checksums.txt完整性，再解析manifest.yaml，最后解压到~/.kandev/plugins/并启动插件进程——全程无需接触命令行。

3步完成一键安装：搜索、点击、即用

以安装Voice Mode（语音输入）插件为例：

1. 打开Settings > Plugins > Browse，在搜索框输入voice；
2. 点击卡片上的Install，等待校验与启动完成，卡片变为Installed；
3. 插件即刻生效：聊天输入框旁出现麦克风按钮，支持浏览器语音、浏览器内 Whisper、服务端 Whisper 三种引擎，Cmd/Ctrl+Shift+M快捷呼出，覆盖任务聊天、Quick Chat、新建任务等全部输入场景。

官方目录当前收录了语音、Slack、Bitbucket 等 16 个插件，常用的一览如下：

热门插件效果预览：语音、Slack、Bitbucket 与状态监控

Bitbucket 插件安装后，Kandev 左侧会新增 Bitbucket 面板，可按仓库/状态过滤 Pull Requests，并直接从 PR 行一键创建任务：

Provider Usage 插件则在顶栏以彩色徽章显示各供应商用量，悬停展开周限额与 5 小时窗口详情：

插件更新管理：Check for updates 与可选自动更新

Installed 标签页每行都会标注当前版本与Latest v<version>，版本落后一眼可见。顶部工具栏提供：

• Check for updates：清空市场缓存并重新拉取最新版本号（页面每 5 分钟才缓存一次索引，无需频繁刷新）；
• Sync：单独动作，只用于核对本地插件目录与注册记录，不访问市场。

当市场出现新版本时，对应行会出现Update to v主色按钮，点击后按正常流水线重装新版本。Kandev 的更新从不自动执行，始终等待显式点击；如果你希望省心，可打开Automatically update plugins总开关（默认关闭），并配合每行的 Auto-update 开关做单插件级覆盖，禁用或报错中的插件永远不会被自动升级。

旁路安装：用 URL 或 .tar.gz 安装市场外插件

如果目标插件不在已配置目录中（例如内部开发的私有插件），旁路安装始终可用：打开Settings > Plugins > Install plugin，选择From URL粘贴包地址，或切到Upload file直接拖入.tar.gz。该路径在断网或关闭全部市场源时依然有效，且执行与一键安装相同的完整性校验。

配置插件参数：表单化设置与密钥自动掩码

点击任意已安装插件行右侧的Settings（或点击插件名称进入详情页），即可打开该插件的专属配置页。插件在 manifest 中声明的config_schema会自动生成表单字段：

• 标记为secret的字段（如 API token）在 UI 中只显示掩码占位符，不会明文回显，重新提交不变的内容也不会改写已存密钥；
• 保存配置会自动重启插件进程使新配置生效，无需手动 Disable/Enable；
• 详情页同时展示 Manifest 信息（id、版本、签名状态、声明的 capabilities 与 Webhooks），方便确认权限范围。

进阶玩法：团队源与发布自己的插件

• 添加团队源：Browse 标签页点击Sources，填入名称与一个能返回index.json的 URL 即可，企业内插件目录将并入 Browse 页；源不可达时只标记为降级，不影响其他源。官方源带Official徽标且不可移除，同 id 插件以先配置的源为准。
• 发布到官方目录：遵循"一插件一仓库"模型，将插件打包为<id>-<version>.tar.gz发布为 Release 资产，再向 plugin-registry/plugins.yaml 提交一条指向你仓库的记录，经维护者审核合并后即上架。

安全须知与常见问题

🔒只装你信任的插件：插件以后端进程权限运行，原生 UI 与宿主共享应用上下文，因此安装、启用、卸载均为管理员级操作，且安装/更新永远是显式动作，不存在后台静默安装。

Q：插件安装后显示 error 怎么办？用Enable重试即可拉起进程；失败原因会以内联单行诊断展示在列表中，诊断里对 token 等敏感值已自动脱敏。

Q：更新失败会破坏现有版本吗？不会。Kandev 保留新旧两个解压版本作为回滚目标，只有新版本确认运行后才会清理旧版本。

Q：市场连不上还能管理插件吗？可以。Installed 页的启用/禁用/卸载始终可用，页头会说明源不可达的原因。

📚 延伸阅读：

• 市场使用与发布：docs/public/plugins-marketplace.md
• 插件安装流水线与安全模型：docs/public/plugins.md
• 插件开发指南：docs/public/plugins-authoring.md
• 市场数据契约：docs/specs/plugins/requirements/marketplace.md
• 语音插件拆分背景：docs/specs/plugins/requirements/voice-extraction.md