@michengai/dsh-archive-manager 1.2.7 → 1.3.0

package/README.pt.md

@@ -0,0 +1,233 @@
+<p align="center">
+  <img src="assets/branding/dsh-banner-en.webp" alt="DSH Archive Manager" width="100%">
+</p>
+
+<div align="center">
+
+  # DSH Archive Manager
+
+  **Gerenciamento seguro de sessões arquivadas no DeepSeek Harness**
+
+  [简体中文](README.zh-CN.md) · [English](README.en.md) · [日本語](README.ja.md) · [Español](README.es.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Русский](README.ru.md) · [Português](README.pt.md)
+
+  [Histórico de alterações](CHANGELOG.md) · [Apache-2.0](LICENSE)
+
+  [![Licença: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
+  [![Pacote npm](https://img.shields.io/npm/v/%40michengai%2Fdsh-archive-manager.svg?label=npm%20package)](https://www.npmjs.com/package/@michengai/dsh-archive-manager)
+  [![Downloads npm](https://img.shields.io/npm/dt/%40michengai%2Fdsh-archive-manager.svg?label=npm%20downloads)](https://www.npmjs.com/package/@michengai/dsh-archive-manager)
+  [![DSH Web Plugin](https://img.shields.io/badge/DSH%20Web-Plugin-0f766e.svg)](https://github.com/MichengAI/dsh-archive-manager)
+  [![Compatível com DSH até 0.2.2-rc.1](https://img.shields.io/badge/DSH-up%20to%200.2.2--rc.1-2563eb.svg)](#requisitos-prévios)
+</div>
+
+> DSH Archive Manager é um plugin mantido pela comunidade para o DeepSeek Harness (DSH), não sendo um produto oficial da DeepSeek AI.
+
+Este documento refere-se à versão **1.3.0**. Consulte o [registro de alterações](CHANGELOG.md) para detalhes.
+
+## Visão geral
+
+Guarde conversas inativas de forma segura e recupere-as quando precisar, mantendo suas listas diárias de tarefas organizadas.
+
+- **Visualização dupla e acesso direto na barra lateral**: Um ícone dedicado na barra lateral principal abre um painel centralizado de **960 px** para sessões arquivadas e não arquivadas, eliminando limitações de rolagem em janelas estreitas.
+- **Gerenciamento completo do ciclo de vida**: Arquive conversas individuais, espaços de trabalho inteiros com um clique, lotes entre projetos, e restaure ou retome sessões diretamente.
+- **Clique com o botão direito em toda a linha da barra lateral**: Clique com o botão direito em qualquer área de uma linha de espaço de trabalho ou sessão para abrir o menu de ações. Linhas não agrupadas ou em branco mantêm o menu nativo do sistema.
+- **Estrela de favoritos estável e convivência com pontos de status (#90, #92)**: Estrela padronizada em 16×16 px com sobreposição absoluta no slot inicial para eliminar deslocamentos no título. Durante tarefas em execução ou aguardando aprovação, o ponto de status do host permanece 100% visível enquanto a estrela se adapta em um emblema compacto de 10 px no canto inferior direito.
+- **Menu de ações rápidas do espaço de trabalho**: Copie o caminho da pasta, abra a pasta diretamente no Explorador de Arquivos do Windows ou Finder do macOS e arquive sessões com um clique.
+- **Mover sessões entre espaços de trabalho**: Transfira conversas entre espaços de trabalho por meio de um submenu dinâmico ao passar o mouse, com congelamento seguro de processos, reescrita atômica e proteção para caracteres especiais em sistemas NTFS.
+- **Cartões de acordeão unificados e linhas ultracompactas de 40 px**: Grupos organizados em gavetas integradas estilo Skills Manager (cabeçalho de 38 px) e linhas de 40 px para duplicar a densidade de informações.
+- **Caixas de seleção nativas em modo escuro**: Componentes que seguem estritamente as especificações do host com `accent-color` nativo, integrando-se perfeitamente com temas escuros e estados ativos.
+- **Janelas modais opacas sem transparências e acessibilidade localizada**: Montagem direta no `body` (`portalToBody`) com fundo sólido e desfoque para evitar sobreposição de textos. Rótulos de acessibilidade completos para o botão de fechar (`common.close`).
+- **ID de seção padronizado e coexistência (#91)**: ID registrado como `archive-manager` com proteção em tempo de execução (`try/catch`), garantindo convivência pacífica com plugins de terceiros.
+- **Barra de ferramentas adaptativa em linha única**: Usa o componente nativo `Input` com ícone de pesquisa oficial e contorno verde ao focar. Reúne busca, menu de exibição e ordenação, filtro de projetos e seletor de datas em uma única linha.
+- **Busca em texto completo e menu estilo Codex**: Busca que cobre títulos e histórico de mensagens (usuário e assistente). Menu com duas seções para alternar entre todas ou apenas favoritas e ordenar resultados.
+- **Seletor DateRange com popover leve de calendário**: Substitui o elemento nativo de data para eliminar inversão de cores e perda de foco no modo escuro (#74). Exibe o intervalo em uma linha com botão de limpeza, predefinições rápidas, 8 idiomas para dias e meses e navegação por teclado WAI-ARIA.
+- **Limpeza automática de sessões inativas**: Defina um limite de dias para detectar conversas ociosas, protegendo automaticamente tarefas em execução, perguntas interativas e favoritos, com opção de desfazer imediata (Undo).
+- **Exclusão física definitiva**: Eliminação física completa de registros, linhas de cache e índices, com relatório detalhado de erros e nova tentativa por item.
+- **Detecção e limpeza de subagentes órfãos**: Identificação de subagentes cujas sessões principais foram excluídas externamente, exibindo o espaço ocupado no disco e permitindo a liberação física em um clique.
+- **Bloqueio corporativo via configuração Cordis e suporte a proxy reverso**: Suporte a bloqueio completo nas configurações do Cordis (`updater: false` ou `onlineUpdate: false`) e resolução dinâmica de endpoints via `document.baseURI`.
+
+## Reconstrução manual de cache de lista (#88)
+
+Ao abrir o Archive Manager, verificam-se apenas os cabeçalhos e as projeções em cache oficiais para sessões normais nos espaços de trabalho registrados, listas não agrupadas e arquivos (excluindo sessões de canais de mensagens instantâneas `im:`). Se houver cache ausente ou incompatível, um cartão de reparo é exibido para ler os registros um a um em modo somente leitura e reconstruir as projeções com o `coldSnapshot` oficial em `session_projcache`.
+
+## Limpeza de subagentes órfãos
+
+Se uma sessão principal for removida externamente, subagentes podem permanecer no disco. O Archive Manager os identifica no painel do Organizador e permite a exclusão física segura.
+
+## Busca e pré-visualização
+
+- As abas «Arquivadas» e «Não arquivadas» compartilham a busca por título e conteúdo, filtro de projetos, favoritos, filtro de datas e ordenação por data de criação.
+- A pré-visualização renderiza tabelas Markdown, citações e blocos de código com identificação de remetente, ou permite ver o texto original destacado.
+- A busca processa lotes de até 20 sessões consecutivas com consulta de até 200 caracteres, excluindo ferramentas, anexos, raciocínios e mensagens do sistema.
+
+## Capturas de tela
+
+### 1. Gerenciamento de sessões arquivadas (Cartões de acordeão e modo escuro)
+Busque, marque como favorita, visualize, restaure e limpe em **Configurações → Sessões arquivadas → Arquivadas**:
+
+![Arquivadas: filtros compartilhados, favoritos e linhas compactas](assets/screenshots/archived-sessions.webp)
+
+Alterne para **Não arquivadas** para recomendações de limpeza inteligente e arquivamento por projeto:
+
+![Não arquivadas: limpeza inteligente e arquivamento por projeto](assets/screenshots/unarchived-sessions.webp)
+
+### 2. Painel centralizado de 960 px no espaço de trabalho principal
+Abra um painel completo de 960 px diretamente a partir da barra lateral principal:
+
+![Painel principal: acesso dedicado na barra lateral com visualização de 960 px](assets/screenshots/main-view-panel.webp)
+
+### 3. Clique com o botão direito na barra lateral e submenu em cascata
+Clique com o botão direito em qualquer linha da barra lateral para abrir menus de contexto e transferir sessões:
+
+| Ações do espaço de trabalho | Mover sessão entre projetos |
+| :---: | :---: |
+| <img src="assets/screenshots/workspace-context-menu.webp" alt="Workspace Actions Menu" width="100%"> | <img src="assets/screenshots/session-move-menu.webp" alt="Move Session Menu" width="100%"> |
+
+## Instalação
+
+Requer um ambiente funcional do DeepSeek Harness (exemplo com o perfil `web`):
+
+### Instalação assistida por agente
+Envie este comando para um assistente com acesso ao terminal da sua máquina:
+
+```text
+Instale a versão mais recente do @michengai/dsh-archive-manager no meu perfil web do DSH usando o registro oficial do npm, verifique a ativação e explique como recarregar.
+```
+
+### Instalação manual
+
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$OutputEncoding = [System.Text.Encoding]::UTF8
+dsh plugin --profile web add @michengai/dsh-archive-manager@latest --registry=https://registry.npmjs.org/
+```
+
+Reinicie o DSH Web e atualize a página no navegador (`Ctrl+Shift+R`). Abra **Configurações → Sessões arquivadas** para começar.
+
+- **Compatibilidade com o host**: Linha DeepSeek Harness `0.2.x` completa (`>=0.2.0-rc.1 <0.3.0-0`), verificada em todas as versões candidatas (`0.2.0-rc.1` a `0.2.2-rc.1`).
+- Versões anteriores a `0.2.0-rc.1` não são mais suportadas. Para ambientes `0.1.x`, instale a versão `1.0.20`.
+
+## Configuração do plugin
+
+Disponível em:
+> **Barra lateral → Plugins → Clique em `Archive Manager`**
+
+### 1. Localização do atalho (`entryLocation`)
+- **Ambos os locais (`both`)**: Mostra o ícone na barra lateral esquerda e mantém a opção em **Configurações → Sessões arquivadas**.
+- **Apenas barra lateral (`sidebar`)**: Mostra o ícone na barra lateral e remove o item das configurações para uma interface mais limpa.
+- **Apenas configurações (`settings`)** (Padrão): Mantém a barra lateral desobstruída e permite o acesso por **Configurações → Sessões arquivadas**.
+
+### 2. Política de atualizações online (`onlineUpdate` / `updater`)
+- Em ambientes corporativos ou restritos, as atualizações podem ser bloqueadas via arquivo de configuração do Cordis:
+  ```yaml
+  updater: false # ou onlineUpdate: false
+  ```
+  Isso desativa completamente o mecanismo de atualização no momento da inicialização.
+
+## Guia de utilização
+
+| Ação | Como fazer |
+| --- | --- |
+| **Arquivar uma conversa** | Abra o menu contextual da sessão na barra lateral e escolha **Arquivar sessão** |
+| **Arquivar espaço de trabalho** | Abra o menu do espaço de trabalho e selecione **Arquivar sessão** |
+| **Buscar e filtrar** | Abra **Configurações → Sessões arquivadas** ou clique em **Arquivar** na barra lateral |
+| **Calendário interativo** | Clique no seletor de data para abrir o popover com navegação completa por teclado |
+| **Pré-visualização rápida** | Clique em um resultado ou em **Mais → Pré-visualização rápida** para ler sem restaurar |
+| **Ajustar ordenação** | Ordene por recentemente arquivadas, data de atualização, criação ou título |
+| **Restaurar conversa** | Clique no ícone de restaurar na linha, ou em **Mais → Restaurar e abrir** |
+| **Arquivar grupo inteiro** | Em **Não arquivadas**, use o menu **…** do grupo para arquivar todas as conversas |
+| **Marcar como favorita** | Clique no ícone de estrela da linha para marcá-la como favorita |
+| **Limpar conversas inativas** | Em **Não arquivadas**, defina os dias de inatividade para pré-visualizar e arquivar |
+| **Copiar ID da sessão** | Selecione **Copiar ID da sessão** no menu **Mais** |
+| **Limpar subagentes órfãos** | Identifique e remova subagentes órfãos no painel do Organizador |
+| **Desfazer arquivamento** | Restaure as sessões arquivadas no lote atual a partir da notificação |
+| **Exclusão permanente** | Selecione as sessões, clique em Excluir e confirme a remoção física dos registros e índices |
+
+### Favoritos e limpeza de inativos
+
+Grupos de projetos compactos podem ser recolhidos. Estrelas e ícones de restaurar/arquivar aparecem à direita; os menus de sessões arquivadas incluem «Restaurar e abrir» e «Excluir».
+
+- Use a estrela em qualquer uma das abas e o menu «Apenas favoritas» para encontrar conversas importantes. Os favoritos persistem no host após arquivamento, restauração ou troca de navegador.
+- Em «Não arquivadas», informe um limite de 1 a 36.500 dias de ociosidade para pré-visualizar os candidatos nos filtros atuais. É possível desmarcar candidatos individualmente antes de confirmar. Favoritos, o chat atual, sessões em execução (incluindo subagentes) e interações pendentes são protegidos automaticamente.
+- Operações em lote exibem o progresso e a contagem de sucessos, itens ignorados e falhas. Um erro não interrompe os demais; apenas os itens com falha são repetidos.
+- **Desfazer este arquivamento** restaura as sessões arquivadas pelo lote atual. Essa ação fica disponível apenas enquanto a página de gerenciamento atual permanecer aberta. A exclusão permanente não pode ser desfeita.
+
+### Visualizar e continuar conversas arquivadas
+
+A navegação nativa permite inspecionar e retomar conversas arquivadas:
+
+- **Clique no título da sessão**: abre a conversa nativa no DSH para visualizar mensagens, anexos e detalhes de ferramentas. Continue conversando mantendo a sessão arquivada.
+- **Mais → Restaurar e abrir**: desarquiva a conversa e a abre imediatamente para retomar as atividades.
+
+## Compatibilidade da API de busca (para integradores)
+
+A API oficial é `workspaceRegistry.searchSessionContent({ sessionIds, query })`, abrangendo sessões arquivadas e não arquivadas. Aceita de 1 a 20 IDs de sessão e uma busca de 1 a 200 caracteres. A estrutura de retorno é `{ items: [{ sessionId, seq, snippet }], failures: [{ sessionId, message }] }`.
+
+`searchArchivedContent` permanece como o ponto de entrada herdado somente para arquivos. Ambos usam a conexão Typert do host existente e o limite de autorização.
+
+## Atualizações
+
+Execute novamente o comando de instalação acima no seu perfil DSH ativo para atualizar o plugin. Em ambientes empresariais, as atualizações podem ser bloqueadas via configuração Cordis.
+
+## Perguntas frequentes (FAQ)
+
+### O que acontece com os caches históricos do plugin após a atualização?
+
+O plugin não substitui a tabela oficial de projeções em cache nem varre ou migra caches de versões legadas. Abrir a lista de arquivamento não relê registros completos para preencher dados ausentes. Os históricos de sessão pertencem ao host, que reconstrói as projeções sob demanda.
+
+**Uma sessão inativa sem entrada oficial no cache pode aparecer inicialmente sem título na lista; apenas recarregar a lista não garante sua reconstrução.** A abertura do registro recupera o título e a restauração como sessão ativa permite ao fluxo de gravação nativo persistir o cache. Arquivos de cache antigos permanecem intocados. Consulte o [registro de alterações](CHANGELOG.md) para detalhes.
+
+### Por que o atalho não aparece após a instalação?
+Reinicie o DSH Web e force o recarregamento da página (`Ctrl+Shift+R`). Verifique se instalou o plugin no perfil correto.
+
+### Qual a diferença entre arquivar e excluir?
+Arquivar oculta a conversa permitindo recuperá-la posteriormente. **A exclusão definitiva é irreversível** e remove os dados fisicamente do disco.
+
+### Posso usar junto com o Codex UI?
+Sim. O [Codex UI](https://github.com/MichengAI/dsh-codex-ui) mantém sua barra lateral e visual característicos, e o Archive Manager continua totalmente funcional em **Configurações → Sessões arquivadas**.
+
+### Coexistência com outros plugins de arquivamento
+O plugin registra-se sob o ID de seção `archive-manager`, coexistindo de forma independente e harmoniosa com outros complementos de arquivamento.
+
+## Instalar a partir do código fonte
+
+<details>
+<summary>Expandir para desenvolvimento ou testes de alterações não publicadas</summary>
+
+Execute os comandos a seguir no diretório de sua escolha:
+
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$OutputEncoding = [System.Text.Encoding]::UTF8
+
+git clone https://github.com/MichengAI/dsh-archive-manager.git
+Set-Location .\dsh-archive-manager
+pnpm install --frozen-lockfile
+pnpm build
+dsh plugin --profile web add .
+```
+
+Após a instalação, reinicie o DSH Web e atualize o navegador. O código-fonte em [src](src) utiliza TypeScript rigoroso. O GitHub e o npm contêm a pasta `lib` compilada pronta para execução.
+
+</details>
+
+## Ecossistema de produtos DSH
+
+Para uma bancada de trabalho no desktop, baixe o [DSH Codex Desktop](https://github.com/MichengAI/dsh-codex-desktop/releases). Em instalações existentes do [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness), você pode adicionar os plugins conforme necessário:
+
+| Plugin | Funcionalidades principais |
+| --- | --- |
+| [Codex UI](https://github.com/MichengAI/dsh-codex-ui) | Organização de projetos, busca de tarefas e navegação no histórico do chat |
+| [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) | Escolha e ativação de agentes especialistas |
+| [Skills Manager](https://github.com/MichengAI/dsh-skills-manager) | Descoberta, ativação, criação e importação de habilidades locais |
+| [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) | Busca, restauração e exclusão física de conversas arquivadas |
+| [IM Connect](https://github.com/MichengAI/dsh-im-connect) | Envio de tarefas e recebimento de respostas via aplicativos de mensagens |
+| [Automation](https://github.com/MichengAI/dsh-automation) | Agendamento de tarefas recorrentes e monitoramento de execuções |
+| [BTW](https://github.com/MichengAI/dsh-btw) | Perguntas paralelas sem interromper a tarefa principal |
+| [Simplify](https://github.com/MichengAI/dsh-simplify) | Uso do `/simplify` para refinar código alterado no Git |
+| [PUA](https://github.com/MichengAI/dsh-pua) | Incentivo ao agente para diagnosticar causas de falha e verificar antes de concluir |
+| [Code Review](https://github.com/MichengAI/dsh-code-review) | Revisão independente de código com `/review` na conversa atual |
+| [Codex Pet](https://github.com/MichengAI/dsh-codex-pet) | Notificações e aprovação de ferramentas por meio de um pet de desktop |
+
+## Licença
+
+Distribuído sob a [Licença Apache 2.0](LICENSE).

package/README.ru.md

@@ -8,7 +8,9 @@
 
   **Безопасное управление архивированными сессиями в DeepSeek Harness**
 
-  [English](README.md) · [简体中文](README.zh-CN.md) · [История изменений](CHANGELOG.md) · [Apache-2.0](LICENSE)
+  [简体中文](README.zh-CN.md) · [English](README.en.md) · [日本語](README.ja.md) · [Español](README.es.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Русский](README.ru.md) · [Português](README.pt.md)
+
+  [История изменений](CHANGELOG.md) · [Apache-2.0](LICENSE)
 
   [![Лицензия: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
   [![npm package](https://img.shields.io/npm/v/%40michengai%2Fdsh-archive-manager.svg?label=npm%20package)](https://www.npmjs.com/package/@michengai/dsh-archive-manager)
@@ -87,15 +89,12 @@
 
 *Скриншоты демонстрируют ключевые панели, полноразмерное представление и нативные контекстные меню в формате WebP без потерь.*
 
-## Предварительные требования
-
-- Рабочая установка [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web с доступным `dsh` в терминале.
-- Поддерживаемые версии DSH: все RC ветки `0.2.x` (`0.2.0-rc.1`, `0.2.0-rc.2`, `0.2.1-rc.1`–`0.2.1-rc.5`) и последняя alpha (`0.2.2-alpha.3`). Промежуточные alpha внутри линии RC не поддерживаются, устанавливайте RC или самую новую alpha. Более ранние хосты отклоняются проверкой версии, и плагин не запускается. Существующие архивы и избранное сохраняются. Для `0.1.x` установите `1.0.20`.
-- Node.js версии `^22.19.0 || >=24.0.0`. Для установки из исходников также требуется pnpm.
-
 ## Установка
 
-В примерах используется профиль `web`. Замените его на тот профиль, который вы действительно используете.
+Требуется рабочая установка [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web с доступным `dsh` в терминале. В примерах используется профиль `web`. Замените его на тот профиль, который вы действительно используете.
+
+- Поддерживаемые версии DSH: все RC ветки `0.2.x` (`0.2.0-rc.1`, `0.2.0-rc.2`, `0.2.1-rc.1`–`0.2.1-rc.5`, `0.2.2-rc.1`).
+- Более ранние хосты (до `0.2.0-rc.1`) отклоняются проверкой версии. Для `0.1.x` установите `1.0.20`.
 
 ### Попросите агента установить
 
@@ -118,6 +117,23 @@ dsh plugin --profile web add @michengai/dsh-archive-manager@latest --registry=ht
 
 Перезапустите DSH Web, затем жёстко обновите браузер (`Ctrl+Shift+R`). Откройте **Настройки → Архив сессий**, чтобы начать работу.
 
+## Настройки плагина
+
+Доступно в:
+> **Боковая панель → Плагины → Нажмите `Archive Manager`**
+
+### 1. Местоположение входа (`entryLocation`)
+- **Все расположения (`both`)**: Отображать значок в левой боковой панели и сохранять пункт в **Настройки → Архив сессий**.
+- **Только боковая панель (`sidebar`)**: Отображать значок в боковой панели и скрыть пункт из настроек для упрощения интерфейса.
+- **Только настройки (`settings`)** (По умолчанию): Минималистичная боковая панель с доступом через **Настройки → Архив сессий**.
+
+### 2. Политика онлайн-обновления (`onlineUpdate` / `updater`)
+- В корпоративных или изолированных средах обновления можно заблокировать в конфигурации Cordis:
+  ```yaml
+  updater: false # или onlineUpdate: false
+  ```
+  После настройки модуль обновления полностью отключается при запуске сервера.
+
 ## Использование
 
 | Цель | Действие |
@@ -135,6 +151,8 @@ dsh plugin --profile web add @michengai/dsh-archive-manager@latest --registry=ht
 | Очистить подагентов-сирот | Обнаружить и физически удалить оставшиеся подагенты в панели организации |
 | Архивировать по проектам | Переключитесь на **Незаархивированные**, выберите сессии в разных проектах, затем нажмите **Архивировать** и подтвердите |
 | Массовое восстановление или удаление | Выберите чаты и используйте массовые действия или меню проекта; отдельных кнопок «Восстановить всё» / «Удалить всё» нет |
+| **Отменить архивацию** | Восстановить сессии, архивированные текущим пакетом, прямо из уведомления |
+| **Постоянное удаление** | Выбрать сессии, нажать «Удалить» и подтвердить физическое удаление журналов и индексов |
 
 Страница открывается на вкладке **Архив**, справа — **Незаархивированные**. Переключение вкладок сбрасывает выбор; смена поиска или фильтра проекта сохраняет его. Проверьте скрытое число выбранных перед массовым действием или сначала очистите выбор.
 
@@ -167,7 +185,7 @@ dsh plugin --profile web add @michengai/dsh-archive-manager@latest --registry=ht
 
 ## Обновления
 
-Нажмите **Check for updates** в заголовке страницы управления архивом (кнопка пока на английском). Среды DSH CLI или Desktop с поддержкой автоматического обновления могут обновиться напрямую; другие среды дают ручную команду для текущего профиля. Можно также перевыполнить команду установки выше.
+Для обновления плагина выполните команду установки выше в соответствующем профиле DSH. В средах с повышенными требованиями к безопасности обновления могут контролироваться через конфигурацию Cordis (`updater: false` или `onlineUpdate: false`).
 
 ## Частые вопросы
 

package/README.zh-CN.md

@@ -8,7 +8,9 @@
 
   **在 DeepSeek Harness 中安全管理已归档会话**
 
-  [English](README.md) · [Русский](README.ru.md) · [更新日志](CHANGELOG.zh-CN.md) · [Apache-2.0](LICENSE)
+  [简体中文](README.zh-CN.md) · [English](README.en.md) · [日本語](README.ja.md) · [Español](README.es.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Русский](README.ru.md) · [Português](README.pt.md)
+
+  [更新日志](CHANGELOG.zh-CN.md) · [Apache-2.0](LICENSE)
 
   [![许可证：Apache-2.0](https://img.shields.io/badge/许可证-Apache--2.0-blue.svg)](LICENSE)
   [![npm package](https://img.shields.io/npm/v/%40michengai%2Fdsh-archive-manager.svg?label=npm%20package)](https://www.npmjs.com/package/@michengai/dsh-archive-manager)
@@ -41,7 +43,7 @@
 - **永久彻底清理**：确认后永久删除不再需要的会话，彻底清除物理日志、索引与缓存，支持错误项独立重试。
 - **无主孤儿子代理检测与物理清理**：自动探测母会话已被外部物理删除的残留子代理，在会话整理中直观展示空间占用并支持一键物理释放。
 - **设置页 ID 规范与第三方插件共存（#91）**：设置页注册 ID 调整为团队统一规范的 `archive-manager` 并带 fail-soft 运行时保护，支持与社区第三方归档插件和平共存。
-- **可控在线更新与反向代理适配**：提供独立在线更新开关与企业级宿主配置硬锁定；原生适配反代子路径前缀部署。
+- **企业级宿主配置锁定与反向代理适配**：支持企业级 Cordis 宿主安全锁定；原生适配反代子路径前缀部署。
 
 ## 手动重建列表缓存（#88）
 
@@ -116,7 +118,7 @@ $OutputEncoding = [System.Text.Encoding]::UTF8
 dsh plugin --profile web add @michengai/dsh-archive-manager@latest --registry=https://registry.npmjs.org/
 ```
 
-安装后重启 DSH Web，并刷新页面（或按 `Ctrl+Shift+R` 硬刷新浏览器），打开「设置 → 归档会话」即可使用。更新时可点击「检查更新」，或重新执行安装命令。
+安装后重启 DSH Web，并刷新页面（或按 `Ctrl+Shift+R` 硬刷新浏览器），打开「设置 → 归档会话」即可使用。更新时重新执行安装命令即可。
 
 - 宿主支持范围：DeepSeek Harness `0.2.x` 全系列（`>=0.2.0-rc.1 <0.3.0-0`），已在 `0.2.x` 的全部 RC（`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-rc.1`～`0.2.1-rc.5`、`0.2.2-rc.1`）上验证。同一 RC 线中间的 alpha 不在支持范围内，请使用 RC 或最新 alpha。
 - 不再支持 `0.2.0-rc.1` 之前的早期宿主，遇到 `0.3.0` 代际破坏性更新时将被版本门安全拦截。仍在使用 `0.1.x` 的用户请安装插件 `1.0.20`。
@@ -140,17 +142,12 @@ dsh plugin --profile web add @michengai/dsh-archive-manager@latest --registry=ht
   - 切换为「仅设置」关闭侧栏时安全注销侧栏槽位（若当前正停留在归档大面板，会自动安全切回默认视图，防止悬空和白屏）；
   - 向后完全兼容旧版 `sidebarEntry` 配置（`true` 自动映射为 `both`，`false` 自动映射为 `settings`）。
 
-### 2. 在线更新 (`onlineUpdate` / `updater`)
-- **默认状态**：开启（`true`）
-- **功能说明**：控制是否允许在线检查并安装归档管理器的新版本。
-- **生效效果**：
-  - **界面联动**：关闭开关后，归档管理面板标题旁的「检查更新」按钮与版本提示徽标将即时隐藏，无需刷新页面；开启后自动恢复展示；
-  - **接口安全拦截**：关闭后，服务端的更新路由对任何版本检查和安装请求均返回 `HTTP 403` 禁用状态，彻底杜绝在插件内安装未审核版本；
-  - **宿主/平台级锁定**：面向精选插件索引（如 VibeDev）或企业安全合规环境，支持直接在 Cordis 配置文件（bundle patch）中声明，无需进入界面手动配置：
-    ```yaml
-    updater: false # 或 onlineUpdate: false
-    ```
-    配置生效后，更新器在启动时即被完全禁用，更新入口隐藏，详情页在线更新开关置灰。宿主锁定优先于本地配置中的用户选择，界面不能解除锁定；宿主移除锁定后，重新按已保存的用户选择生效。
+### 2. 在线更新策略 (`onlineUpdate` / `updater`)
+- **配置说明**：面向精选插件索引或企业安全合规环境，支持通过 Cordis 配置文件（bundle patch）进行安全管控：
+  ```yaml
+  updater: false # 或 onlineUpdate: false
+  ```
+  配置生效后，更新器在启动时即被完全禁用，服务端更新接口自动返回禁用状态，杜绝在环境中安装未审核的外部版本。
 
 ## 使用指南
 
@@ -202,7 +199,7 @@ dsh plugin --profile web add @michengai/dsh-archive-manager@latest --registry=ht
 
 ## 更新
 
-在归档管理页标题处点击「检查更新」。支持自动更新的 DSH CLI 或 Desktop 环境可直接更新；其他环境会提供适用于当前 profile 的手动命令。也可重新执行上面的安装命令。
+在对应 profile 中重新执行上面的安装命令即可完成插件更新。在需要安全合规管控的环境下，可通过 Cordis 配置禁用更新器。
 
 ## 常见问题