快速开始

登录后进入控制台的「Keys」页面，点击「生成密钥」。密钥用于 API 鉴权， 请妥善保存，不要提交到代码仓库。

在编辑器的 MCP 配置文件中加入以下内容，把 LOCUS_TOKEN 换成上一步生成的密钥。 各编辑器的配置文件位置见 集成页面。

{
  "mcpServers": {
    "locus": {
      "command": "npx",
      "args": ["-y", "locus-code-mcp"],
      "env": {
        "LOCUS_BASE_URL": "https://ace.panrun.me/relay",
        "LOCUS_TOKEN": "<控制台生成的密钥>"
      }
    }
  }
}

重启编辑器后，AI 助手就可以调用 locus_mcp_search 工具， 用自然语言检索你的代码库。首次请求成功后，可以在控制台的「请求日志」里看到记录。

与 MCP 方式相同：在控制台的「Keys」页面生成密钥。下一步会把它存进 Windows 凭据管理器，不需要写进任何配置文件。

Skill 单独维护在 zj0808/locus-skill，克隆到本地后，把目录放到 AI 助手读取 Skill 的位置（例如 Claude Code 的 .claude/skills/）。下文的 SKILL_DIR 指这个目录里包含 SKILL.md 的那一层。

git clone https://github.com/zj0808/locus-skill.git

两种方式，任选其一。

方式 A：环境变量（最简单）

设置 ACE_API_KEY 就能直接检索，不需要执行登录命令。 适合 CI、容器，或者不想把密钥写进系统凭据的场景。

$env:ACE_API_KEY = "<控制台生成的密钥>"
$env:ACE_BASE_URL = "https://ace.panrun.me/relay"

上面只在当前终端会话内有效。想让新开的终端也生效，写成用户级环境变量：

# 写入用户级环境变量，新开的终端都生效
[Environment]::SetEnvironmentVariable("ACE_API_KEY", "<控制台生成的密钥>", "User")

注意：读的是进程环境变量，不是项目里的 .env 文件——放一个 .env 到目录里不会被加载。

方式 B：登录命令（存进系统凭据）

执行下面的命令，会打开控制台并在终端里安全地提示输入密钥， 密钥保存在 Windows 凭据管理器（目标名 Ace.Locus.ApiKey）， 不落到任何配置文件。已经有密钥时用 auth set-key 直接设置， 不打开浏览器；用 auth status 查看当前状态。

pwsh -NoProfile -File "SKILL_DIR/scripts/ace.ps1" auth login

两者同时存在时 ACE_API_KEY 优先。

AI 助手会在需要查找代码时自动调用这个 Skill，你也可以直接执行：

pwsh -NoProfile -File "SKILL_DIR/scripts/ace.ps1" search `
  --query "校验用户邮箱并返回布尔值的函数" `
  --project-path "backend" `
  --max-turns 2

常用参数与 locus_mcp_search 一致：--project-path、--path-filter、--max-turns 1..5、--max-results 1..30、--result-mode complete|focused、--tree-depth 1..6、--exclude-path（可重复）。查看索引状态用 index-status，加 --refresh 触发刷新。

默认 API 地址是 https://ace.panrun.me/relay，保存在 %APPDATA%\Ace\config.json，属于非敏感配置。需要长期改用其他地址时执行 ace.ps1 config set base-url URL；临时覆盖用环境变量 ACE_BASE_URL。