diff --git a/docs-site/src/content/docs/fr/reference/cli/lifecycle.md b/docs-site/src/content/docs/fr/reference/cli/lifecycle.md index 152108fd88..ca3a347be0 100644 --- a/docs-site/src/content/docs/fr/reference/cli/lifecycle.md +++ b/docs-site/src/content/docs/fr/reference/cli/lifecycle.md @@ -194,10 +194,10 @@ Une confirmation UAC peut être nécessaire. Une priorité déjà normale ou hau | Sous-commande | Action | | --- | --- | -| aucune | Installe et démarre le service s’il est absent ; sinon, actualise et redémarre le service existant. Une définition Task Scheduler Windows saine est réutilisée ; une définition obsolète peut être réenregistrée et nécessiter une élévation. | +| aucune | Installe et démarre le service s’il est absent ; sinon, applique `repair` au service existant. Une définition Task Scheduler Windows saine est réutilisée ; une définition obsolète peut être réenregistrée et nécessiter une élévation. | | `install` | Crée et démarre le service. L’enregistrement exige une élévation sous Windows. | -| `repair` | Actualise sur place un service installé et le redémarre. Une définition Task Scheduler Windows saine est réutilisée ; une définition obsolète peut être réenregistrée et nécessiter une élévation. | -| `restart` | Alias de `repair`. | +| `repair` | Actualise sur place un service installé. Sous macOS, le gestionnaire n’est rechargé que lorsque quelque chose a changé : une tâche saine et inchangée continue donc de s’exécuter et la réparation n’est pas une interruption. Sous Linux et Windows, le service est redémarré ; une définition Task Scheduler Windows saine est réutilisée, tandis qu’une définition obsolète peut être réenregistrée et nécessiter une élévation. | +| `restart` | La même actualisation, avec un redémarrage garanti sur toutes les plateformes. Sous macOS, une tâche inchangée déjà chargée est relancée (kickstart) sur place. N’est pas un alias de `repair`. | | `start` | Démarre un service installé. | | `stop` | Arrête le service et rétablit le fonctionnement natif de Codex. | | `status` | Affiche les diagnostics du service et du proxy, ainsi que les chemins des journaux. | diff --git a/docs-site/src/content/docs/ja/reference/cli/lifecycle.md b/docs-site/src/content/docs/ja/reference/cli/lifecycle.md index ee7604688b..1efe28a080 100644 --- a/docs-site/src/content/docs/ja/reference/cli/lifecycle.md +++ b/docs-site/src/content/docs/ja/reference/cli/lifecycle.md @@ -195,10 +195,10 @@ Windows タスク スケジューラでインストールするサービスは |サブコマンド |アクション | | --- | --- | -|なし |未インストールなら作成して開始し、既存なら更新して再起動します。正常な Windows タスク スケジューラ定義は再利用しますが、古い定義は再登録され、昇格が必要になる場合があります。 | +|なし |未インストールなら作成して開始し、既存なら `repair` を実行します。正常な Windows タスク スケジューラ定義は再利用しますが、古い定義は再登録され、昇格が必要になる場合があります。 | | `install` |サービスを作成して開始します。 | -| `repair` | 既存のサービスを更新して再起動します。正常な Windows タスク スケジューラ定義は再利用しますが、古い定義は再登録され、昇格が必要になる場合があります。 | -| `restart` | `repair` の別名です。 | +| `repair` | インストール済みのサービスをその場で更新します。macOS では変更があった場合のみマネージャーをリロードするため、正常で変更のないジョブはそのまま実行され続け、repair は障害になりません。Linux と Windows ではサービスを再起動します。正常な Windows タスク スケジューラ定義は再利用しますが、古い定義は再登録され、昇格が必要になる場合があります。 | +| `restart` | 同じ更新を行い、すべてのプラットフォームで必ず再起動します。macOS では変更がなくすでにロードされているジョブはその場で kickstart されます。`repair` の別名ではありません。 | | `start` |インストールされているサービスを開始します。 | | `stop` |サービスを停止し、ネイティブ Codex を復元します。 | | `status` |サービスとプロキシの診断とログ パスをレポートします。 | diff --git a/docs-site/src/content/docs/ko/reference/cli/lifecycle.md b/docs-site/src/content/docs/ko/reference/cli/lifecycle.md index 2cac37ed24..b2b006d95b 100644 --- a/docs-site/src/content/docs/ko/reference/cli/lifecycle.md +++ b/docs-site/src/content/docs/ko/reference/cli/lifecycle.md @@ -107,7 +107,7 @@ dedicated-provider history도 포함됩니다. 상태를 백업하고 이 전체 status와 `ocx doctor`는 현재 CLI와 실행 중인 프록시의 버전을 비교합니다. CLI가 더 새로우면 원하는 최신 설치로 프록시를 재시작하십시오. 백그라운드 서비스라면 `ocx service restart`를 -실행합니다. 버전 불일치는 서비스 정의를 그대로 두기 때문에 `ocx service repair`는 아무것도 +실행합니다. macOS에서는 버전 불일치가 서비스 정의를 바이트 단위로 그대로 두기 때문에 `ocx service repair`는 아무것도 reload하지 않고 예전 프로세스가 계속 서비스합니다. 프록시가 더 새로우면 CLI를 업그레이드하거나 `PATH`가 원하는 설치를 가리키도록 수정하십시오. 이 진단은 서비스를 복구하거나 요청 허용 여부를 바꾸지 않습니다. @@ -283,8 +283,8 @@ Windows 작업 스케줄러로 설치하는 서비스는 보통 프로세스 우 | --- | --- | | 없음 | 서비스가 없으면 설치하고 시작하며, 이미 있으면 `repair`를 수행합니다. 정상인 Windows 작업 스케줄러 정의는 재사용하지만, 오래된 정의는 다시 등록되어 관리자 권한 승인이 필요할 수 있습니다. | | `install` | 서비스를 생성하고 시작합니다. | -| `repair` | 설치된 서비스를 제자리에서 새로 고치고, 바뀐 것이 있을 때만 관리자를 reload합니다. macOS에서 정상이고 변경이 없는 작업은 그대로 실행된 채 남으므로 repair가 장애가 되지 않습니다. 정상인 Windows 작업 스케줄러 정의는 재사용하지만, 오래된 정의는 다시 등록되어 관리자 권한 승인이 필요할 수 있습니다. | -| `restart` | 같은 갱신이지만 항상 재시작합니다. macOS에서 변경이 없고 이미 로드된 작업은 제자리에서 kickstart됩니다. `repair`의 별칭이 아닙니다. | +| `repair` | 설치된 서비스를 제자리에서 새로 고칩니다. macOS에서는 바뀐 것이 있을 때만 launchd를 reload하므로, 정상이고 변경이 없는 작업은 그대로 실행된 채 남아 repair가 장애가 되지 않습니다. Linux와 Windows에서는 서비스를 재시작합니다. 정상인 Windows 작업 스케줄러 정의는 재사용하지만, 오래된 정의는 다시 등록되어 관리자 권한 승인이 필요할 수 있습니다. | +| `restart` | 같은 갱신을 수행하며 모든 플랫폼에서 반드시 재시작합니다. macOS에서 변경이 없고 이미 로드된 작업은 제자리에서 kickstart됩니다. `repair`의 별칭이 아닙니다. | | `start` | 설치된 서비스를 시작합니다. | | `stop` | 서비스를 중지하고 기본 Codex를 복원합니다. | | `status` | 서비스와 프록시 진단, 로그 경로를 보고합니다. | diff --git a/docs-site/src/content/docs/reference/cli/lifecycle.md b/docs-site/src/content/docs/reference/cli/lifecycle.md index 32ff382d69..5616772c3b 100644 --- a/docs-site/src/content/docs/reference/cli/lifecycle.md +++ b/docs-site/src/content/docs/reference/cli/lifecycle.md @@ -125,7 +125,7 @@ are left in place. Status and `ocx doctor` compare this CLI's version with the running proxy. If the CLI is newer, restart the proxy using the intended current installation; for a background service, run -`ocx service restart` — a version skew leaves the service definition byte-identical, so +`ocx service restart`. On macOS, a version skew leaves the service definition byte-identical, so `ocx service repair` would reload nothing and keep the old process serving. If the proxy is newer, upgrade the CLI or resolve `PATH` to the intended installation. These diagnostics do not repair the service or change whether requests are allowed. @@ -388,8 +388,8 @@ Definitions installed before this change still carry the old versioned paths and themselves — once the old executable is deleted, no opencodex code runs to fix it. Run `ocx service repair` once after upgrading; after that, each service start follows the launcher. An already-running proxy is not replaced by an external upgrade: when the installed CLI is newer -than the running proxy, run `ocx service restart` so the new build serves. `repair` is not enough -there: the definition did not change, and a repair that changes nothing reloads nothing. +than the running proxy, run `ocx service restart` so the new build serves. On macOS, `repair` is not +enough there: the definition did not change, and a repair that changes nothing reloads nothing. If the proxy is newer instead, check the CLI installation and `PATH` as described under [`ocx status`](#ocx-status---json). @@ -397,8 +397,8 @@ If the proxy is newer instead, check the CLI installation and `PATH` as describe | --- | --- | | none | Install and start when absent; otherwise `repair` the existing service. A healthy Windows scheduler definition is reused; a stale definition may be re-registered and require elevation. | | `install` | Create and start the service. Registers it, which on Windows needs elevation. | -| `repair` | Refresh an installed service in place, reloading the manager only when something changed — so on macOS a healthy, unchanged job keeps running and the repair is not an outage. A healthy Windows scheduler definition is reused; a stale definition may be re-registered and require elevation. | -| `restart` | The same refresh, but it always restarts. On macOS an unchanged, already-loaded job is kickstarted in place. Not an alias of `repair`. | +| `repair` | Refresh an installed service in place. On macOS, the manager is reloaded only when something changed, so a healthy, unchanged job keeps running and the repair is not an outage. On Linux and Windows, the service is restarted; a healthy Windows scheduler definition is reused, while a stale definition may be re-registered and require elevation. | +| `restart` | The same refresh and a guaranteed restart on every platform. On macOS an unchanged, already-loaded job is kickstarted in place. Not an alias of `repair`. | | `start` | Start an installed service. | | `stop` | Stop the service and restore native Codex. | | `status` | Report service and proxy diagnostics plus log paths. | diff --git a/docs-site/src/content/docs/ru/reference/cli/lifecycle.md b/docs-site/src/content/docs/ru/reference/cli/lifecycle.md index 4de2c64624..b4a11b55f0 100644 --- a/docs-site/src/content/docs/ru/reference/cli/lifecycle.md +++ b/docs-site/src/content/docs/ru/reference/cli/lifecycle.md @@ -99,7 +99,7 @@ ocx eject back Status и `ocx doctor` сравнивают версии текущего CLI и работающего прокси. Если CLI новее, перезапустите прокси из нужной актуальной установки. Для фоновой службы используйте -`ocx service repair` (`ocx service restart` — её псевдоним). Если новее прокси, обновите CLI +`ocx service restart`. В macOS рассинхронизация версий оставляет определение службы байт-в-байт неизменным, поэтому `ocx service repair` ничего не перезагрузит и старый процесс продолжит обслуживание. Если новее прокси, обновите CLI или исправьте `PATH`, чтобы он указывал на нужную установку. Диагностика не ремонтирует службу и не меняет разрешение запросов. @@ -279,10 +279,10 @@ unit**, Windows **Task Scheduler**), которая автоматически | Подкоманда | Действие | | --- | --- | -| none | Установить и запустить службу, если её нет; иначе обновить и перезапустить существующую службу. Исправная конфигурация Windows Task Scheduler используется повторно; устаревшая может быть перерегистрирована и потребовать повышения прав. | +| none | Установить и запустить службу, если её нет; иначе выполнить `repair` для существующей службы. Исправная конфигурация Windows Task Scheduler используется повторно; устаревшая может быть перерегистрирована и потребовать повышения прав. | | `install` | Создать и запустить службу. | -| `repair` | Обновить установленную службу на месте и перезапустить её. Исправная конфигурация Windows Task Scheduler используется повторно; устаревшая может быть перерегистрирована и потребовать повышения прав. | -| `restart` | Псевдоним команды `repair`. | +| `repair` | Обновить установленную службу на месте. В macOS менеджер перезагружается только при наличии изменений, поэтому исправная неизменённая задача продолжает работать и обновление не является простоем. В Linux и Windows служба перезапускается; исправная конфигурация Windows Task Scheduler используется повторно, а устаревшая может быть перерегистрирована и потребовать повышения прав. | +| `restart` | То же обновление с гарантированным перезапуском на всех платформах. В macOS неизменённая, уже загруженная задача перезапускается на месте (kickstart). Не псевдоним команды `repair`. | | `start` | Запустить уже установленную службу. | | `stop` | Остановить службу и восстановить native Codex. | | `status` | Показать диагностику службы и прокси, а также пути к логам. | diff --git a/docs-site/src/content/docs/tr/reference/cli/lifecycle.md b/docs-site/src/content/docs/tr/reference/cli/lifecycle.md index ca59f39db9..2462ab5eb8 100644 --- a/docs-site/src/content/docs/tr/reference/cli/lifecycle.md +++ b/docs-site/src/content/docs/tr/reference/cli/lifecycle.md @@ -293,10 +293,10 @@ UAC onayı gerekebilir. Zaten normal veya yüksek öncelik ayarlanmışsa yalnı | Alt komut | Eylem | | --- | --- | -| none | Servis yoksa kurup başlatın; varsa yenileyip yeniden başlatın. Sağlıklı bir Windows Task Scheduler tanımı yeniden kullanılır; eski bir tanım yeniden kaydedilebilir ve yükseltme gerektirebilir. | +| none | Servis yoksa kurup başlatın; varsa mevcut servise `repair` uygulayın. Sağlıklı bir Windows Task Scheduler tanımı yeniden kullanılır; eski bir tanım yeniden kaydedilebilir ve yükseltme gerektirebilir. | | `install` | Servisi oluşturun ve başlatın. Kaydeder, bu da Windows'ta yükseltme gerektirir. | -| `repair` | Kurulu bir servisi yerinde yenileyin ve yeniden başlatın. Sağlıklı bir Windows Task Scheduler tanımı yeniden kullanılır; eski bir tanım yeniden kaydedilebilir ve yükseltme gerektirebilir. | -| `restart` | `repair` komutunun takma adıdır. | +| `repair` | Kurulu bir servisi yerinde yenileyin. macOS'ta yönetici yalnızca bir şey değiştiğinde yeniden yüklenir; böylece sağlıklı, değişmemiş bir iş çalışmaya devam eder ve yenileme bir kesinti olmaz. Linux ve Windows'ta servis yeniden başlatılır; sağlıklı bir Windows Task Scheduler tanımı yeniden kullanılır, eski bir tanım ise yeniden kaydedilebilir ve yükseltme gerektirebilir. | +| `restart` | Aynı yenileme ve her platformda garantili yeniden başlatma. macOS'ta değişmemiş, zaten yüklü bir iş yerinde kickstart edilir. `repair` komutunun takma adı değildir. | | `start` | Kurulu bir servisi başlatın. | | `stop` | Servisi durdurun ve yerel Codex'i geri yükleyin. | | `status` | Servis ve proxy tanılamalarını artı günlük yollarını bildirin. | diff --git a/docs-site/src/content/docs/zh-cn/reference/cli/lifecycle.md b/docs-site/src/content/docs/zh-cn/reference/cli/lifecycle.md index 2c5e3a4915..5dc4f17e6b 100644 --- a/docs-site/src/content/docs/zh-cn/reference/cli/lifecycle.md +++ b/docs-site/src/content/docs/zh-cn/reference/cli/lifecycle.md @@ -180,10 +180,10 @@ Windows 任务计划程序安装使用普通进程优先级（`Priority=4`）。 | 子命令 | 操作 | | --- | --- | -| none | 服务不存在时安装并启动；已存在时刷新并重启。正常的 Windows 任务计划程序定义会复用；过时定义可能会重新注册并需要提升权限。 | +| none | 服务不存在时安装并启动；已存在时执行 `repair`。正常的 Windows 任务计划程序定义会复用；过时定义可能会重新注册并需要提升权限。 | | `install` | 创建并启动服务。 | -| `repair` | 就地刷新已安装的服务并重启。正常的 Windows 任务计划程序定义会复用；过时定义可能会重新注册并需要提升权限。 | -| `restart` | `repair` 的别名。 | +| `repair` | 就地刷新已安装的服务。在 macOS 上，仅当有变更时才重新加载管理器，因此正常且未变更的任务会继续运行，repair 不会造成中断。在 Linux 和 Windows 上会重启服务；正常的 Windows 任务计划程序定义会复用，过时定义可能会重新注册并需要提升权限。 | +| `restart` | 执行相同的刷新，并在所有平台上保证重启。在 macOS 上，未变更且已加载的任务会就地 kickstart。不是 `repair` 的别名。 | | `start` | 启动已安装的服务。 | | `stop` | 停止服务并恢复原生 Codex。 | | `status` | 报告服务和代理诊断信息及日志路径。 | diff --git a/docs-site/src/content/docs/zh-tw/reference/cli/lifecycle.md b/docs-site/src/content/docs/zh-tw/reference/cli/lifecycle.md index 117133bc18..1daa98203d 100644 --- a/docs-site/src/content/docs/zh-tw/reference/cli/lifecycle.md +++ b/docs-site/src/content/docs/zh-tw/reference/cli/lifecycle.md @@ -174,10 +174,10 @@ Windows 工作排程器安裝使用一般處理程序優先順序（`Priority=4` | 子指令 | 動作 | | --- | --- | -| 無 | 服務不存在時安裝並啟動；已存在時重新整理並重啟。正常的 Windows 工作排程器定義會沿用；過時的定義可能會重新註冊並需要提高權限。 | +| 無 | 服務不存在時安裝並啟動；已存在時執行 `repair`。正常的 Windows 工作排程器定義會沿用；過時的定義可能會重新註冊並需要提高權限。 | | `install` | 建立並啟動服務。註冊它，在 Windows 上需要提高權限。 | -| `repair` | 就地重新整理已安裝的服務並重啟它。正常的 Windows 工作排程器定義會沿用；過時的定義可能會重新註冊並需要提高權限。 | -| `restart` | `repair` 的別名。 | +| `repair` | 就地重新整理已安裝的服務。在 macOS 上，僅在有變更時才重新載入 launchd，因此正常且未變更的工作會繼續執行，repair 不會造成中斷。在 Linux 和 Windows 上會重啟服務；正常的 Windows 工作排程器定義會沿用，過時的定義可能會重新註冊並需要提高權限。 | +| `restart` | 執行相同的重新整理，並在所有平台上保證重啟。在 macOS 上，未變更且已載入的工作會就地 kickstart。不是 `repair` 的別名。 | | `start` | 啟動已安裝的服務。 | | `stop` | 停止服務並還原原生 Codex。 | | `status` | 回報服務與代理診斷及日誌路徑。 |