specrails-desktop 2.32.0 → 2.34.0

package/docs/guide/ja/getting-started/3-adding-your-first-project.md

@@ -4,55 +4,36 @@
 
 ## プロジェクト追加ダイアログを開く
 
-ウェルカム画面で **最初のプロジェクトを追加** をクリックします（あとからなら、左サイドバーの **プロジェクトを追加** ボタンでも開けます）。小さなダイアログが表示されます。
+ようこそ画面の**最初のプロジェクトを追加**をクリックします（後からは左サイドバーの**プロジェクトを追加**ボタンでも構いません）。小さなダイアログが表示されます。
 
-## 内容を入力する
+## 詳細を入力する
 
-**プロジェクトフォルダ** *(必須)*
+**プロジェクトフォルダ** *（必須）*
 
-コードが入っているフォルダを specrails に指定します。デスクトップアプリでは、フォルダアイコンをクリックして視覚的に参照・選択するか、フルパスを貼り付けられます。指定するのはリポジトリのルート — コードと（通常は）`.git` ディレクトリを含むフォルダです。
+コードが入っているフォルダを specrails に指定します。デスクトップアプリではフォルダアイコンをクリックして視覚的に選ぶか、フルパスを貼り付けられます。リポジトリのルート — コードと（通常は）`.git` ディレクトリを含むフォルダ — を指定してください。
 
-**プロジェクト名** *(任意)*
+**プロジェクト名** *（任意）*
 
 サイドバーに表示される分かりやすいラベルです。空欄のままにすると、specrails はフォルダ名を使います。
 
-**プロバイダー**
+> 必要なツールが揃っているか、バックグラウンドで簡単なチェックが実行されます。必須のものが欠けていると**追加**ボタンは無効のままになり、**詳細情報**リンクが正確なインストールコマンドを示します。
 
-このプロジェクトで使う AI プロバイダーを選びます。specrails は、あなたのマシン上で検出したものを表示します。
+フォームはこれだけです — **追加**をクリックすれば完了です。
 
-- 🤖 **Claude**
-- ⚡ **Codex**
-- ✨ **Gemini**
+## AI プロバイダーは自動検出されます
 
-見つからなかったプロバイダーはグレーアウトされ、*not found* と表示されます。どれかをインストールしてサインインしたうえで、ダイアログを開き直してください。デフォルトでは利用可能なプロバイダーがすべて事前選択されていますが、使いたいものだけに絞り込むこともできます。複数選んだ場合は、**最初の** プロバイダーがプロジェクトのデフォルトになります。タスクごとの選択は、あとから行えます。
+もうプロバイダーを選ぶ必要はありません。specrails はマシンにインストールされたすべての AI CLI — **Claude**、**Codex**、**Gemini**、**Kimi** — を検出し、どのプロジェクトでも常にそのすべてを使えます。後から新しいプロバイダーをインストールすれば、次にアプリへ戻ったときに自動であらゆる場所に現れます。再セットアップも、プロジェクトごとの設定も不要です。インストール済みでも未ログインのプロバイダーには、セレクターに控えめな*未ログイン*バッジが表示されます。
 
-> 必要なツールがそろっているかを確認するため、バックグラウンドで簡単なチェックが走ります。何か欠かせないものが足りない場合は、**追加** ボタンが無効のままになり、**詳細情報** リンクが正確なインストールコマンドを案内します。
+## セットアップは静かに行われます
 
-**追加** をクリックして進みましょう。
+セットアップウィザードはありません。**追加**をクリックした瞬間にプロジェクトは登録され、サイドバーに現れます — すぐに開けます。バックグラウンドで specrails がプロジェクトの workspace を組み立てます（数秒、完全オフライン）。プロジェクト行の小さく点滅するドットが作業中を示し、すべて整うと自然に消えます。あるプロバイダーで失敗しても、プロジェクトは他のプロバイダーで動き続けます — 琥珀色のドットが現れ、クリックすると再試行します。
 
-## 数秒で終わるセットアップ
+## 何が、どこにインストールされるのか
 
-そのフォルダにすでに specrails が設定済みなら、これで完了です。プロジェクトが瞬時にサイドバーに現れます。
+セットアップは意図的に**非侵襲的**です。あなたのリポジトリは手つかずのまま。specrails のすべての成果物（エージェント定義、コマンド、プロファイル、ローカル設定）はホームディレクトリ配下のプロジェクトごとの workspace に置かれ、アプリに同梱された単一の共有フレームワークにリンクされます。リポジトリが変更されることはありません — アプリの更新時には、すべてのプロジェクトが新しいフレームワークを自動で、一度に受け取ります。
 
-まっさらなプロジェクトの場合は、短い **セットアップウィザード** が走ります。ステップは 3 つです。
+> **より深いセットアップを望むなら？** アプリはあえて高速なテンプレートインストールを既定にしています。AI で強化されたフロー（コードベース分析とカスタムエージェントペルソナ）が良ければ、ターミナルでプロジェクトフォルダから `npx specrails-core@latest init` を実行できます。
 
-1. **設定** — 選んだ各プロバイダーについて、基本的な内容を確認します。
-2. **インストール** — specrails がプロジェクトを自動でセットアップします。これは *クイック* インストールで、すぐに使えるテンプレートのエージェントが数秒のうちに配置されます。実行中の様子はライブログで確認できます。
-3. **完了** — すべて準備できたことを伝えるサマリーが表示されます。
+## 準備完了
 
-複数プロバイダーのプロジェクトでは、インストールがプロバイダーごとに 1 回ずつ順番に実行され、完了ステップにはそれぞれのカードが表示されます。
-
-## インストールされるもの
-
-セットアップは意図的に軽量で、**非侵襲的** です。specrails は、パイプラインが実行方法を把握できるよう、プロジェクトにごく少量の設定を追加します。
-
-- プロジェクトのエージェントプロファイルとローカル設定を収める `.specrails/` フォルダ。
-- Architect → Developer → Reviewer → Ship パイプラインを動かす、`.claude/agents/` 配下のエージェント定義。
-
-それだけです。specrails がセットアップ中にあなたのソースコードを書き換えることはありません。これらのファイルは、設定をチームと共有したければコミットしても安全です。
-
-> **もっと踏み込んだセットアップがしたい?** このアプリは、あえて高速なテンプレートインストールを採用しています。AI による拡張フロー（コードベースの分析やカスタムエージェントのペルソナ生成）がよければ、プロジェクトフォルダのターミナルで `npx specrails-core@latest init` を実行できます。
-
-## これで準備完了
-
-セットアップが終わると、specrails はあなたをプロジェクトのダッシュボードへ案内します。さあ、ツアーの時間です。[The dashboard tour](the-dashboard-tour) をご覧ください。
+**追加**をクリックした瞬間からプロジェクトのダッシュボードが使えます。さあツアーへ — [ダッシュボードツアー](the-dashboard-tour)をご覧ください。

package/docs/guide/ja/integrations/1-ai-providers.md

@@ -16,22 +16,17 @@ Specrails は特定の AI に縛られません。Claude、Codex、Gemini、Kimi
 4 つとも**デフォルトで有効**です。CLI が `PATH` にあれば表示されます。
 Kimi は `kimi --version` を確認し、`kimi login` を実行してください。
 
-## プロジェクトに 1 つのプロバイダーをインストールする
+## プロバイダーは自動検出されます
 
-プロジェクトを追加すると、セットアップウィザードがどのプロバイダーをインストールするか尋ねます。1 つ選んでインストールのステップを進めれば完了です。あとはそのプロジェクトがそのプロバイダーを*持っている*状態になり、それ以降は意識する必要はありません。スペック、レール、チャット、アナリティクスは、どれを選んでも同じように動きます。
+プロジェクトごとにプロバイダーを選ぶことはもうありません。specrails はマシンにインストールされたすべてのプロバイダー CLI を検出し、**すべて**のプロジェクトで常に**全部**を利用できるようにします。その上で各サーフェスがプロバイダーの公表するケイパビリティを確認します。Kimi の正確なマトリクスは[Kimi を使う](../../../kimi.md)を参照してください。
 
-使いたい CLI が Add Project に出てこない場合、ほとんどはその CLI がインストールされていないか、`PATH` 上にないのが原因です。インストールしてから Add Project を開き直してください。
+使いたいプロバイダーがどこにも現れない場合、ほぼ確実に CLI が未インストールか `PATH` にないためです。インストールしてログインし、アプリに戻ってください — ウィンドウのフォーカス時に検出が再実行され、プロバイダーは自動であらゆる場所に現れ、その workspace サーフェスもバックグラウンドで組み立てられます。インストール済みでも未ログインのプロバイダーは、エンジンセレクターに*未ログイン*バッジ付きで表示されます。
 
-## 1 つのプロジェクトに複数のプロバイダーをインストールする
+複数プロバイダーのマシンについて知っておくと良いこと：
 
-同じプロジェクトに**複数**のプロバイダーをインストールできます — たとえば Claude *と* Gemini を一緒に、といった具合です。**Add Project** では、プロバイダーの一覧がチェックボックスになるので、使いたいものをすべてチェックしてください。最初に選んだものがそのプロジェクトの**プライマリ**（デフォルト）プロバイダーになり、残りは代替として使えるようになります。
-
-マルチプロバイダーのプロジェクトについて、知っておくとよいことがいくつかあります。
-
-- **プロバイダーが 1 つなら、これまでとまったく同じ挙動です。** プロジェクトにプロバイダーが 1 つしかなければ、プロバイダーの選択 UI はどこにも表示されません — アプリはすっきりシンプルなままです。
-- **UI は capability に従います。** Claude と Kimi はプロバイダー別の
-  profile に対応し、Codex と Gemini は legacy mode で実行します。
-- **プロバイダーの選択は作成後に固定されます。** このバージョンでは、プロジェクトを追加するときにプロバイダーを選び、あとから設定で変更することはできません。別の組み合わせが必要になったら、新しいプロジェクトを作成してください。
+- **プロバイダーが 1 つだけなら挙動は以前とまったく同じです。** 1 つしか検出されなければ、プロバイダーピッカーはどこにも表示されません — アプリはすっきりシンプルなままです。
+- **ケイパビリティがサイドバーを決めます。** 検出済みプロバイダーの少なくとも 1 つが対応していればセクションは表示され、その中のエンジン関連の操作は対応プロバイダーだけを提示します。Kimi はプロファイル、カスタムロール、Freestyle を公表しますが、強制可能なノーツール境界を要する構造化アクションは公表しません。
+- **何もロックされません。** プロバイダー CLI の追加や削除はすべてのプロジェクトに自動反映されます — 管理すべきプロジェクトごとのプロバイダー設定は存在しません。
 
 ## 呼び出しごとにプロバイダーを選ぶ
 

package/docs/guide/pt/getting-started/3-adding-your-first-project.md

@@ -4,55 +4,36 @@ Um projeto é apenas uma pasta no seu computador que contém uma base de código
 
 ## Abrir a janela Adicionar projeto
 
-Clique em **Adicionar o seu primeiro projeto** no ecrã de boas-vindas (ou, mais tarde, no botão **Adicionar projeto** na barra lateral esquerda). Aparece uma pequena janela.
+Clique em **Adicione o seu primeiro projeto** no ecrã de boas-vindas (ou no botão **Adicionar projeto** na barra lateral esquerda mais tarde). Aparece uma pequena janela.
 
-## Preencher os dados
+## Preencher os detalhes
 
 **Pasta do projeto** *(obrigatório)*
 
-Aponte o specrails para a pasta que contém o seu código. Na app de desktop pode clicar no ícone de pasta para navegar e escolhê-la visualmente, ou colar o caminho completo. Esta deve ser a raiz do seu repositório — a pasta que contém o seu código e (normalmente) um diretório `.git`.
+Indique ao specrails a pasta que contém o seu código. Na app de desktop pode clicar no ícone de pasta para navegar e escolher visualmente, ou colar o caminho completo. Deve ser a raiz do seu repositório — a pasta que contém o código e (normalmente) um diretório `.git`.
 
 **Nome do projeto** *(opcional)*
 
-Uma etiqueta amigável mostrada na barra lateral. Se a deixar em branco, o specrails usa o nome da pasta.
+Um rótulo amigável mostrado na barra lateral. Se deixar em branco, o specrails usa o nome da pasta.
 
-**Fornecedores**
+> Uma verificação rápida corre em segundo plano para confirmar que as ferramentas necessárias estão presentes. Se faltar algo essencial, o botão **Adicionar** fica desativado e uma ligação **Mais info** dá-lhe os comandos de instalação exatos.
 
-Escolha que fornecedor(es) de IA este projeto deve usar. O specrails mostra-lhe os que detetou na sua máquina:
+É todo o formulário — clique em **Adicionar** e está feito.
 
-- 🤖 **Claude**
-- ⚡ **Codex**
-- ✨ **Gemini**
+## Os fornecedores de IA são detetados automaticamente
 
-Os fornecedores que não encontrou aparecem a cinzento e marcados como *não encontrado* — instale e inicie sessão num deles e volte a abrir a janela. Por predefinição, todos os fornecedores disponíveis ficam pré-selecionados, mas pode desmarcar até ficar apenas com o que pretende. Se escolher mais do que um, o **primeiro** torna-se o fornecedor predefinido do projeto; mais tarde poderá escolher por tarefa.
+Já não escolhe fornecedores. O specrails deteta cada CLI de IA instalado na sua máquina — **Claude**, **Codex**, **Gemini**, **Kimi** — e todos os projetos podem usá-los todos, sempre. Se instalar um fornecedor novo mais tarde, ele aparece em todo o lado por si próprio na próxima vez que focar a app; sem reconfiguração, sem ajustes por projeto. Se um fornecedor estiver instalado mas sem sessão iniciada, o seu seletor mostra um distintivo subtil *Sem sessão iniciada*.
 
-> Uma verificação rápida corre em segundo plano para confirmar que as ferramentas necessárias estão presentes. Se faltar algo essencial, o botão **Adicionar** permanece desativado e uma ligação **Mais informações** dá-lhe os comandos de instalação exatos.
+## A configuração acontece em silêncio
 
-Clique em **Adicionar** para continuar.
+Não há assistente de configuração. No momento em que clica em **Adicionar**, o projeto fica registado e aparece na barra lateral — pode abri-lo de imediato. Em segundo plano, o specrails monta o workspace do projeto (poucos segundos, totalmente offline): um pequeno ponto a pulsar na linha do projeto mostra que está a trabalhar, e desaparece quando tudo está pronto. Se algo falhar para um fornecedor, o projeto continua a funcionar com os restantes — aparece um ponto âmbar e clicar nele tenta de novo.
 
-## Uma configuração que corre em segundos
+## O que é instalado — e onde
 
-Se a pasta já tiver o specrails configurado, está concluído — o projeto aparece instantaneamente na sua barra lateral.
+A configuração é deliberadamente **não invasiva**: o seu repositório permanece intacto. Todos os artefactos do specrails (definições de agentes, comandos, perfis, definições locais) vivem num workspace por projeto sob o seu diretório home, ligado a uma única instalação partilhada do framework que vem com a app. O seu repo nunca é modificado — e quando a app é atualizada, todos os projetos recebem o novo framework automaticamente, de uma vez.
 
-Se for um projeto novo, corre um breve **assistente de configuração**. Tem três passos:
+> **Prefere a configuração profunda?** A app inclui de propósito a instalação rápida com templates. Se preferir o fluxo enriquecido por IA (análise da base de código e personas de agentes personalizadas), pode executar `npx specrails-core@latest init` a partir da pasta do projeto num terminal.
 
-1. **Configurar** — confirme o essencial para cada fornecedor que escolheu.
-2. **Instalar** — o specrails prepara o projeto automaticamente. Esta é a instalação *rápida*: agentes de template prontos a usar, instalados em segundos. Vai ver um log em direto enquanto corre.
-3. **Concluído** — um resumo a confirmar que está tudo pronto.
+## Já está dentro
 
-Num projeto com vários fornecedores, a instalação corre uma vez por fornecedor, um a seguir ao outro, e o passo Concluído mostra um cartão para cada um.
-
-## O que é instalado
-
-A configuração é deliberadamente leve e **não invasiva**. O specrails acrescenta uma pequena quantidade de configuração ao seu projeto para que o pipeline saiba como funcionar:
-
-- Uma pasta `.specrails/` que contém os perfis de agentes e as definições locais do seu projeto.
-- Definições de agentes em `.claude/agents/` que dão vida ao pipeline Arquiteto → Developer → Revisor → Ship.
-
-E é só isto — o specrails não reescreve o seu código-fonte durante a configuração, e estes ficheiros podem ser incluídos no commit sem problemas, caso queira partilhar a configuração com a sua equipa.
-
-> **Prefere a configuração aprofundada?** A app traz de propósito a instalação rápida por templates. Se preferir o fluxo enriquecido por IA (análise da base de código e personas de agentes personalizadas), pode executar `npx specrails-core@latest init` a partir da pasta do projeto num terminal.
-
-## Está dentro
-
-Assim que a configuração terminar, o specrails leva-o diretamente para o dashboard do seu projeto. É hora do tour — veja [O tour pelo dashboard](the-dashboard-tour).
+O painel do projeto fica disponível no momento em que clica em **Adicionar**. Hora da visita guiada — veja [A visita ao painel](the-dashboard-tour).

package/docs/guide/pt/integrations/1-ai-providers.md

@@ -16,22 +16,30 @@ capabilities exigidas pelo seu contrato.
 Os quatro estão **ativados por omissão**. O provider aparece quando o CLI está
 no `PATH`; para Kimi, confirme `kimi --version` e execute `kimi login`.
 
-## Instalar um provider para um projeto
-
-Quando adiciona um projeto, o assistente de configuração pergunta qual ou quais providers instalar. Escolha um, avance pelo passo de instalação e está feito. A partir daí o projeto simplesmente *tem* esse provider — nunca mais precisa de pensar nisso. Specs, rails, chat e analytics funcionam todos da mesma forma, independentemente do que escolheu.
-
-Se um CLI que quer não aparecer em Adicionar Projeto, é quase sempre porque o CLI não está instalado ou não está no seu `PATH`. Instale-o e volte a abrir Adicionar Projeto.
-
-## Instalar vários providers num só projeto
-
-Pode instalar **mais do que um** provider no mesmo projeto — por exemplo Claude *e* Gemini. Em **Adicionar Projeto**, a lista de providers passa a ser um conjunto de caixas de seleção; marque tudo o que quiser. O primeiro que selecionar torna-se o provider **primário** (por omissão) do projeto; os restantes ficam disponíveis como alternativas.
-
-Algumas coisas que vale a pena saber sobre projetos multi-provider:
-
-- **Com um só provider, tudo se comporta exatamente como antes.** Se um projeto tiver apenas um provider, nunca verá um seletor de provider em lado nenhum — a app mantém-se limpa e simples.
-- **As capabilities controlam a UI.** Claude e Kimi suportam perfis separados
-  por provider; Codex e Gemini usam modo legacy.
-- **A escolha de providers fica fixada após a criação.** Nesta versão escolhe os seus providers quando adiciona o projeto e não podem ser alterados mais tarde nas Definições. Se precisar de uma combinação diferente, isso é um projeto novo.
+## Os providers são detetados automaticamente
+
+Nunca escolhes providers por projeto. O specrails deteta cada CLI de provider
+instalado na tua máquina e disponibiliza **todos** a **todos** os projetos,
+sempre. Cada superfície verifica depois as capacidades anunciadas pelo
+provider. Vê [Usar o Kimi](../../../kimi.md) para a matriz exata do Kimi.
+
+Se um provider que queres não aparece em lado nenhum, é quase sempre porque o
+CLI não está instalado ou não está no teu `PATH`. Instala-o, inicia sessão e
+volta à app — a deteção corre de novo ao focar a janela e o provider aparece
+por si próprio em todo o lado, com a sua superfície de workspace montada em
+segundo plano. Um provider instalado mas sem sessão iniciada continua a
+aparecer, com um distintivo *Sem sessão iniciada* nos seletores de motor.
+
+Algumas coisas úteis sobre máquinas multi-provider:
+
+- **Um único provider comporta-se exatamente como antes.** Se só um for detetado, nunca verás um seletor de provider — a app mantém-se limpa e simples.
+- **As capabilities comandam a barra lateral.** Uma secção é visível quando pelo
+  menos um provider detetado a suporta; lá dentro, as ações por motor só
+  oferecem os providers capazes. O Kimi anuncia perfis, roles personalizados e
+  Freestyle; não anuncia ações estruturadas que exijam uma fronteira sem
+  ferramentas aplicável.
+- **Nada fica bloqueado.** Instalar ou remover um CLI de provider atualiza todos
+  os projetos automaticamente — não há definição de provider por projeto para gerir.
 
 ## Escolher um provider a cada invocação
 

package/docs/guide/zh/getting-started/3-adding-your-first-project.md

@@ -2,57 +2,38 @@
 
 一个项目其实就是你电脑上存放某个代码库的文件夹。我们来连接一个吧。
 
-## 打开“添加项目”对话框
+## 打开"添加项目"对话框
 
-在欢迎界面点击 **添加你的第一个项目**（之后也可以点击左侧边栏里的 **添加项目** 按钮）。会弹出一个小对话框。
+在欢迎页面点击**添加你的第一个项目**（之后也可以点击左侧边栏的**添加项目**按钮）。会出现一个小对话框。
 
-## 填写详情
+## 填写信息
 
-**项目文件夹** *(必填)*
+**项目文件夹** *（必填）*
 
-把 specrails 指向存放你代码的文件夹。在桌面应用里，你可以点击文件夹图标来可视化浏览选择，也可以直接粘贴完整路径。这应该是你仓库的根目录——也就是那个包含你的代码、并且（通常）有一个 `.git` 目录的文件夹。
+告诉 specrails 存放代码的文件夹。在桌面应用中，你可以点击文件夹图标进行可视化选择，或直接粘贴完整路径。它应该是仓库的根目录 — 包含代码和（通常）`.git` 目录的那个文件夹。
 
-**项目名称** *(可选)*
+**项目名称** *（可选）*
 
-显示在侧边栏里的友好标签。如果留空，specrails 会用文件夹名。
+显示在侧边栏中的友好名称。留空时 specrails 会使用文件夹名。
 
-**提供商**
+> 后台会快速检查所需工具是否齐全。如果缺少必要工具，**添加**按钮将保持禁用，**更多信息**链接会给出确切的安装命令。
 
-选择这个项目要使用哪个（些）AI 提供商。specrails 会把它在你机器上检测到的那些展示给你：
+整个表单就这些 — 点击**添加**即可。
 
-- 🤖 **Claude**
-- ⚡ **Codex**
-- ✨ **Gemini**
+## AI 提供商自动检测
 
-没找到的提供商会变灰，并标注为 *未找到*——安装并登录其中一个，然后重新打开对话框即可。默认情况下，所有可用的提供商都会被预选中，但你可以取消勾选，只留下想要的那个。如果你选了不止一个，**第一个** 会成为项目的默认提供商；之后你可以按任务来选择。
+你不再需要选择提供商。specrails 会检测你机器上安装的每个 AI CLI — **Claude**、**Codex**、**Gemini**、**Kimi** — 且每个项目始终可以使用它们全部。之后安装新的提供商，下次回到应用时它会自动出现在所有地方；无需重新配置，无需按项目设置。如果某个提供商已安装但未登录，其选择器会显示一个不显眼的*未登录*标记。
 
-> 后台会做一次快速检查，确认所需的工具都在。如果缺少某个关键工具，**添加** 按钮会保持禁用状态，并通过 **更多信息** 链接给出确切的安装命令。
+## 配置在后台静默完成
 
-点击 **添加** 继续。
+不再有设置向导。点击**添加**的那一刻，项目即注册完成并出现在侧边栏中 — 你可以立即打开它。specrails 会在后台组装项目的 workspace（几秒钟，完全离线）：项目行上一个轻微闪烁的小点表示正在工作，一切就绪后它会自然消失。如果某个提供商的组装失败，项目仍可使用其他提供商 — 会出现一个琥珀色圆点，点击即可重试。
 
-## 几秒钟就跑完的设置
+## 安装了什么 — 以及安装在哪里
 
-如果该文件夹已经配置好了 specrails，那你就齐活了——项目会立刻出现在侧边栏里。
+配置刻意做到**非侵入式**：你的仓库保持原样。所有 specrails 产物（代理定义、命令、配置文件、本地设置）都放在你 home 目录下的项目专属 workspace 中，链接到随应用一起分发的单一共享框架安装。你的仓库永远不会被修改 — 应用更新时，所有项目会自动、一次性地获得新框架。
 
-如果这是个全新的项目，会运行一个简短的**设置向导**。它分三步：
+> **想要深度配置？** 应用有意默认提供快速模板安装。如果你偏好 AI 增强流程（代码库分析和定制代理角色），可以在终端里从项目文件夹运行 `npx specrails-core@latest init`。
 
-1. **配置**——为你选择的每个提供商确认基本信息。
-2. **安装**——specrails 自动完成项目设置。这是*快速*安装：开箱即用的模板 agent，几秒内就位。运行过程中你会看到实时日志。
-3. **完成**——一份汇总，确认一切就绪。
+## 你已就绪
 
-对于多提供商项目，安装会按提供商逐个运行，一个接一个，“完成”这一步会为每个提供商显示一张卡片。
-
-## 会安装些什么
-
-设置刻意做得很轻量，而且**不侵入**。specrails 只往你的项目里加入少量配置，好让流水线知道该怎么运行：
-
-- 一个 `.specrails/` 文件夹，存放项目的 agent profile 和本地设置。
-- `.claude/agents/` 下的 agent 定义，为“架构师 → 开发者 → 评审员 → 交付”这条流水线提供支撑。
-
-仅此而已——设置过程中 specrails 不会改写你的源代码，而且这些文件可以放心提交，如果你想和团队共享这份配置的话。
-
-> **想要深度设置？** 应用刻意默认采用快速模板安装。如果你更想要 AI 增强流程（代码库分析与自定义 agent 人设），可以在终端里、从你的项目文件夹运行 `npx specrails-core@latest init`。
-
-## 你进来了
-
-设置一结束，specrails 就会把你带进项目的仪表盘。是时候逛一圈了——参见[仪表盘导览](the-dashboard-tour)。
+点击**添加**的那一刻，项目仪表盘即已可用。是时候参观一下了 — 参见[仪表盘导览](the-dashboard-tour)。

package/docs/guide/zh/integrations/1-ai-providers.md

@@ -15,22 +15,17 @@ Specrails 并不绑定某一个 AI。Claude、Codex、Gemini 和 Kimi 都是一
 四家都是**默认启用**的。CLI 在 `PATH` 上就会显示。Kimi 请先确认
 `kimi --version`，再运行 `kimi login`。
 
-## 为一个项目安装单个提供方
+## 提供方自动检测
 
-添加项目时，setup 向导会问你想安装哪个（哪些）提供方。选一个，点完安装步骤，就搞定了。从那以后，这个项目就直接*拥有*了这个提供方——你再也不用去操心它。规格、rail、聊天和分析，无论你选了哪一个，用起来都一样。
+你永远不需要按项目挑选提供方。specrails 会检测你机器上安装的每个提供方 CLI，并让**所有**项目始终可以使用**全部**提供方。之后各个界面会检查提供方声明的能力。Kimi 的确切能力矩阵参见[使用 Kimi](../../../kimi.md)。
 
-如果你想要的某个 CLI 没有出现在 Add Project 里，原因几乎总是它没安装、或不在你的 `PATH` 上。装好它，再重新打开 Add Project 即可。
+如果你想要的提供方哪里都没出现，几乎总是因为该 CLI 未安装或不在 `PATH` 中。安装并登录后切回应用 — 检测会在窗口获得焦点时重新运行，该提供方会自动出现在所有地方，其项目 workspace 也会在后台组装完成。已安装但未登录的提供方仍会出现，只是在引擎选择器上带有*未登录*标记。
 
-## 为同一个项目安装多个提供方
+关于多提供方机器的几点说明：
 
-你可以把**不止一个**提供方装进同一个项目——比如同时用 Claude *和* Gemini。在 **Add Project** 里，提供方列表会变成一组复选框；想要哪些就勾哪些。你勾选的第一个会成为这个项目的**主**（默认）提供方，其余的则作为备选可用。
-
-关于多提供方项目，有几点值得了解：
-
-- **只有一个提供方时，行为和以前完全一样。** 如果一个项目只有单个提供方，你在任何地方都不会看到提供方选择器——应用保持干净、简单。
-- **UI 由 capability 驱动。** Claude 和 Kimi 支持按提供方隔离的
-  profile；Codex 和 Gemini 使用 legacy mode。
-- **提供方在创建后就锁定了。** 在这个版本里，你在添加项目时选定提供方，之后无法再从 Settings 更改。如果你需要不同的组合，那就新建一个项目。
+- **只有一个提供方时行为与从前完全一致。** 只检测到一个提供方时，你不会在任何地方看到提供方选择器 — 应用保持干净简洁。
+- **能力决定侧边栏。** 只要至少一个已检测的提供方支持某个版块，它就可见；版块内与引擎相关的操作只会提供有能力的提供方。Kimi 声明了配置文件、自定义角色和 Freestyle；不声明需要可强制执行的无工具边界的结构化操作。
+- **没有任何锁定。** 安装或移除某个提供方 CLI 会自动更新所有项目 — 不存在需要管理的按项目提供方设置。
 
 ## 按调用逐个选择提供方
 

package/docs/internals/project-builder.md

@@ -245,12 +245,17 @@ Launching the already committed M1/M2+ tickets is ordinary Batch rail
 execution and can use Kimi.
 
 - **Launch Milestone 1** (`client/src/lib/milestone-launch.ts`
-  `launchMilestone`): gather `M1`-labeled `todo` tickets → `POST /rails`
-  (server allocates the lowest free index) → `PUT /rails/:i/tickets` → `POST
-  /rails/:i/launch {mode:'batch-implement'}` (the server maps the bare mode to
-  the batch factory loop: worktree isolation + ask-first PR). Offered on the
-  Builder done screen and the sidebar entry; existing 409 guards surface as
-  toasts.
+  `launchMilestone`): gather `M1`-labeled `todo` tickets → chunk into groups
+  of ≤ `MAX_TICKETS_PER_RAIL` (3) → per chunk: `POST /rails` (server allocates
+  the lowest free index; rails named `M1 · <k>` when the milestone needs more
+  than one) → `PUT /rails/:i/tickets` → `POST /rails/:i/launch
+  {mode:'batch-implement'}` (the server maps the bare mode to the batch
+  factory loop: worktree isolation + ask-first PR). The launch route rejects
+  any rail carrying more than 3 specs (`rail_ticket_cap_exceeded`), so the cap
+  holds for every launch door. A failure before anything launched surfaces as
+  a typed reason; a mid-batch failure keeps the launched rails and reports the
+  skipped rest (`skippedCount` → partial-launch toast). Offered on the Builder
+  done screen and the sidebar entry; existing 409 guards surface as toasts.
 - **Sidebar re-entry** (`BuilderSidebarEntry`, mounted in
   `ProjectRightSidebar` + `AgentWorkspaceSidebar`): visible iff
   `GET /api/projects/:id/blueprint` (project-router) returns a blueprint

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specrails-desktop",
-  "version": "2.32.0",
+  "version": "2.34.0",
   "license": "MIT",
   "repository": {
     "type": "git",

package/server/dist/ai-invocations.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InvalidSurfaceError = void 0;
 exports.recordInvocation = recordInvocation;
+exports.sumInvocationCostForRuns = sumInvocationCostForRuns;
 exports.updateTicketIdForConversation = updateTicketIdForConversation;
 exports.listInvocationsForConversation = listInvocationsForConversation;
 exports.getTicketSpendingSummary = getTicketSpendingSummary;
@@ -45,6 +46,40 @@ function recordInvocation(db, input) {
     ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
   `).run(input.id, input.project_id, input.provider, input.surface, input.surface_ref_id ?? null, input.ticket_id ?? null, input.conversation_id ?? null, input.model ?? null, input.status, input.started_at, input.finished_at ?? null, input.duration_ms ?? null, input.duration_api_ms ?? null, input.tokens_in ?? null, input.tokens_out ?? null, input.tokens_cache_read ?? null, input.tokens_cache_create ?? null, input.total_cost_usd ?? null, input.total_cost_usd_estimated ? 1 : 0, input.num_turns ?? null, input.session_id ?? null, input.loop_run_id ?? null);
 }
+/**
+ * Total AI spend attributable to a set of implementation runs, for the PR-body
+ * cost footer. A "run" id is either a loop_runs row id (loop AI-step/decider
+ * invocations link via `loop_run_id`) or a QueueManager job id (rows with
+ * surface='job' and `surface_ref_id` = the id, plus the merge-orchestrator's
+ * `<jobId>:merge:<step>` sub-rows). Failed/aborted rows count — they billed
+ * real tokens. Returns null when no priced rows match, so callers can omit
+ * the footer instead of printing $0.00 for legacy runs.
+ */
+function sumInvocationCostForRuns(db, runIds) {
+    const ids = [...new Set(runIds.filter((id) => typeof id === 'string' && id.length > 0))];
+    if (ids.length === 0)
+        return null;
+    const placeholders = ids.map(() => '?').join(', ');
+    const mergePrefixes = ids.map(() => `surface_ref_id LIKE ? ESCAPE '\\'`).join(' OR ');
+    const rows = db.prepare(`SELECT total_cost_usd, total_cost_usd_estimated FROM ai_invocations
+     WHERE total_cost_usd IS NOT NULL
+       AND (loop_run_id IN (${placeholders})
+            OR surface_ref_id IN (${placeholders})
+            OR ${mergePrefixes})`).all(...ids, ...ids, ...ids.map((id) => `${escapeLikePattern(id)}:merge:%`));
+    if (rows.length === 0)
+        return null;
+    let totalUsd = 0;
+    let estimated = false;
+    for (const row of rows) {
+        totalUsd += row.total_cost_usd;
+        if (row.total_cost_usd_estimated === 1)
+            estimated = true;
+    }
+    return { totalUsd, estimated };
+}
+function escapeLikePattern(value) {
+    return value.replace(/[\\%_]/g, (ch) => `\\${ch}`);
+}
 function updateTicketIdForConversation(db, conversationId, ticketId) {
     const result = db.prepare(`UPDATE ai_invocations SET ticket_id = ? WHERE conversation_id = ? AND ticket_id IS NULL`).run(ticketId, conversationId);
     return result.changes;

package/server/dist/blueprint-commit.js

@@ -101,7 +101,7 @@ function createBlueprintCommitRunner(deps) {
         hasCore: deps.io?.hasCore ?? offline_assemble_1.canAssembleProject,
         mkdir: deps.io?.mkdir ?? ((dir) => fs_1.default.mkdirSync(dir, { recursive: true })),
         exec: deps.io?.exec ?? execCli,
-        assemble: deps.io?.assemble ?? (async (opts) => (0, offline_assemble_1.assembleProjectOffline)(opts)),
+        assemble: deps.io?.assemble ?? (async (opts) => { await (0, offline_assemble_1.assembleProjectOffline)(opts); }),
         writePair: deps.io?.writePair ?? blueprint_render_1.writeBlueprintPair,
         mutateTickets: deps.io?.mutateTickets ?? ((filePath, fn) => { (0, ticket_store_1.mutateStore)(filePath, fn); }),
         registerProject: deps.io?.registerProject ??

package/server/dist/desktop-db.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.setProjectProvidersMirror = setProjectProvidersMirror;
 exports.getDesktopDbPath = getDesktopDbPath;
 exports.initDesktopDb = initDesktopDb;
 exports.listProjects = listProjects;
@@ -51,11 +52,31 @@ function parseProviders(raw, primary) {
     }
     return [primary];
 }
+// Detected-set mirror (global-core-zero-friction). When the app-level
+// detection singleton has a snapshot, every project row READS its `providers`
+// as the machine's detected set (wire compat: the column keeps existing, but no
+// longer gates anything) and its `provider` as the derived primary (stored
+// primary while still detected → claude → fixed preference order). Null
+// supplier (startup, unit tests) = legacy row behaviour, byte-identical.
+let _detectedMirrorSupplier = null;
+function setProjectProvidersMirror(fn) {
+    _detectedMirrorSupplier = fn;
+}
+const PRIMARY_PREFERENCE = ['claude', 'codex', 'gemini', 'kimi'];
 function mapProjectRow(raw) {
     if (!raw)
         return undefined;
     const provider = (raw.provider ?? 'claude');
-    return { ...raw, provider, providers: parseProviders(raw.providers, provider) };
+    const stored = parseProviders(raw.providers, provider);
+    const detected = _detectedMirrorSupplier?.();
+    if (Array.isArray(detected) && detected.length > 0) {
+        const mirrored = detected;
+        let primary = mirrored.includes(provider) ? provider : undefined;
+        if (!primary)
+            primary = PRIMARY_PREFERENCE.find((p) => mirrored.includes(p)) ?? mirrored[0];
+        return { ...raw, provider: primary, providers: [...mirrored] };
+    }
+    return { ...raw, provider, providers: stored };
 }
 // ─── Desktop DB path ──────────────────────────────────────────────────────────
 function getDesktopDbPath() {