SuperAPI AI 工具集

semble-setup

智能体与模型

查看项目

更新于 10-15 23:47

技能介绍

用途:管理 semble_code 语义代码检索 MCP 服务器的全生命周期,包括安装、审计、修复、更新、启用、重建索引与移除;模式与作用域从提示文本解析,不靠手输键值。

主要能力:接通后提供两个工具 mcp__semble_code__search(按意图、行为或名称找代码)与 mcp__semble_code__find_related(查已知位置的相邻代码)。两者都必须传 repo 参数(绝对项目根或显式 Git URL),永不自动推断;0.5.5 起还接受可选 content=code|docs|config|all。结果为 file_path、start_line、end_line、score 及可选内容,默认 top_k=5、max_snippet_lines=10。

使用方式:先运行只读状态脚本 semble-status.sh --section all --json 获取快照,再按解析出的模式调用 scripts/ 下对应脚本;空输入即 status,只读且不提问;安装在新会话前不可用,故安装会在 .claude/semble/state.json 写检查点并用 /brewcode:semble-setup resume 续跑。状态可用 JSON 字段 verdict、state.phase、mcp.state 等读取。

限制:无 watcher、无守护进程,不要报告守候进程在运行;首次冷缓存需下载嵌入模型(数百 MB),可能长达 600 秒,离线冷缓存会全部调用报错。.json/.json5/.csv/.tsv/.psv 被排除,.mdx/.txt 无归属,需改用 rg。无状态的 semble 裸调用会启动阻塞式 stdio 服务(0.5.3 及更早执行 --version 会挂起),须用 uvx --from 'semble[mcp]==0.5.5' semble --version 探测。semble install 写入的是未固定版本的服务器,本技能不运行它,已存在的会出现冲突报告而非自动移除。semble clear index 会清空共享缓存根下所有仓库与内容变体。Windows 不受支持;非 macOS/Linux 平台应仅打印警告并拒绝所有变更。该技能在 0.5.4 的实测采用与路由数据未在 0.5.5 复测,不应据此宣称效果。