@michengai/dsh-archive-manager 1.2.8 → 1.3.0

package/README.fr.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
+
+  **Gestion sécurisée des sessions archivées dans 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)
+
+  [Journal des modifications](CHANGELOG.md) · [Apache-2.0](LICENSE)
+
+  [![Licence : Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
+  [![Paquet npm](https://img.shields.io/npm/v/%40michengai%2Fdsh-archive-manager.svg?label=npm%20package)](https://www.npmjs.com/package/@michengai/dsh-archive-manager)
+  [![Téléchargements 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)
+  [![Compatible DSH jusqu'à 0.2.2-rc.1](https://img.shields.io/badge/DSH-up%20to%200.2.2--rc.1-2563eb.svg)](#prérequis)
+</div>
+
+> DSH Archive Manager est un plugin maintenu par la communauté pour DeepSeek Harness (DSH), et n'est pas un produit officiel de DeepSeek AI.
+
+Ce document décrit la version **1.3.0**. Consultez le [journal des modifications](CHANGELOG.md) pour les détails des versions publiées.
+
+## Vue d'ensemble
+
+Mettez de côté vos conversations inactives et retrouvez-les au besoin, pour une liste de travail claire et aérée.
+
+- **Double vue et accès direct dans la barre latérale** : Une icône dédiée dans la barre latérale principale ouvre une vue spacieuse et centrée de **960 px** pour les sessions archivées et non archivées, éliminant les contraintes des boîtes de dialogue étroites.
+- **Gestion complète du cycle de vie** : Archivez des conversations individuelles, des espaces de travail complets en un clic, des lots multi-projets, et restaurez ou reprenez des sessions directement.
+- **Clic droit sur toute la ligne de la barre latérale** : Faites un clic droit n'importe où sur une ligne d'espace de travail ou de session pour ouvrir le menu d'actions. Les lignes non groupées ou vierges laissent passer le menu contextuel natif en toute sécurité.
+- **Étoile de favori stable et coexistence avec les pastilles d'état (#90, #92)** : Taille d'étoile standardisée à 16×16 px en superposition absolue pour éliminer tout décalage du titre. Pendant les tâches actives ou les demandes d'approbation, la pastille d'état de l'hôte reste 100 % visible tandis que l'étoile se convertit en badge compact de 10 px en bas à droite.
+- **Menu d'actions rapides d'espace de travail** : Copiez le chemin du dossier, ouvrez directement l'emplacement dans l'Explorateur Windows ou le Finder macOS, et archivez toutes les sessions associées en un clic.
+- **Déplacement de sessions entre espaces de travail** : Transférez des sessions d'un espace de travail à un autre via un sous-menu au survol, avec mise en veille des processus, réécriture atomique et protection NTFS pour les sessions de messagerie.
+- **Cartes accordéon unifiées et lignes ultra-compactes de 40 px** : Organisation des projets avec des cartes à tiroir intégrées de style Skills Manager (en-tête de 38 px) et lignes réduites à 40 px pour doubler la densité d'information.
+- **Cases à cocher natives en mode sombre** : Composants conformes aux spécifications de l'hôte utilisant `accent-color` pour une intégration harmonieuse avec les thèmes sombres et les sélections actives.
+- **Modales opaques sans transparence parasite et accessibilité localisée** : Montage direct sur `body` (`portalToBody`) avec fond opaque et flou pour empêcher le texte en arrière-plan d'apparaître en transparence. Libellés d'accessibilité complets pour le bouton de fermeture (`common.close`).
+- **Identifiant de section standardisé et coexistence (#91)** : Enregistré sous l'ID `archive-manager` avec protection contre les pannes à l'exécution (`try/catch`), assurant une parfaite coexistence avec les plugins tiers d'archivage.
+- **Barre d'outils adaptative sur une seule ligne** : Utilise le composant natif `Input` avec l'icône de recherche officielle et une bordure verte au focus. Regroupe sur une seule ligne la recherche, le menu d'affichage et de tri, le filtre par projet et le sélecteur de dates.
+- **Recherche plein texte et menu composite de style Codex** : Recherche automatique couvrant les titres et le corps des messages (utilisateur et assistant). Menu à deux volets pour filtrer (toutes / favoris uniquement) et trier les résultats.
+- **Sélecteur DateRange léger avec popover calendrier** : Remplace l'élément de date natif pour éviter les inversions de couleur en mode sombre (#74). Affichage en une ligne avec bouton d'effacement, préréglages rapides, traduction des jours et des mois dans les 8 langues officielles et navigation complète au clavier WAI-ARIA.
+- **Nettoyage automatique des sessions inactives** : Définissez un seuil d'inactivité en jours pour détecter les conversations dormantes, en protégeant automatiquement les tâches en cours, les invites interactives et les favoris, avec annulation immédiate (Undo).
+- **Suppression définitive physique** : Élimination complète des journaux physiques, lignes de cache et index avec rapport d'erreurs et réessai par élément.
+- **Détection et nettoyage des sous-agents orphelins** : Détection des sous-agents résiduels dont la session mère a été supprimée, calcul de l'espace disque occupé et libération physique en un clic.
+- **Verrouillage d'entreprise via configuration Cordis et compatibilité proxy inverse** : Possibilité de désactiver complètement le composant de mise à jour dans le fichier de configuration Cordis (`updater: false` ou `onlineUpdate: false`) et résolution dynamique des points de terminaison avec `document.baseURI`.
+
+## Reconstruction manuelle du cache de liste (#88)
+
+L'ouverture de l'Archive Manager vérifie uniquement les en-têtes et les projections en cache officielles pour les sessions froides dans les espaces de travail enregistrés, listes non groupées et archives (en excluant les sessions spéciales `im:`). Si un cache est manquant ou incompatible, une carte de réparation s'affiche pour relire les journaux un à un en lecture seule et régénérer les projections via `coldSnapshot` dans `session_projcache`.
+
+## Nettoyage des sous-agents orphelins
+
+Lorsqu'une session mère est supprimée hors de DSH, des sous-agents peuvent rester orphelins sur le disque. L'Archive Manager les repère dans le panneau d'organisation et permet de les effacer de manière sécurisée.
+
+## Recherche et prévisualisation
+
+- Les onglets « Archivées » et « Non archivées » partagent la recherche par titre et contenu, le filtre de projet, les favoris, le filtre de dates et le tri par date de création.
+- La prévisualisation affiche les tableaux Markdown, citations et blocs de code avec les étiquettes de rôle, ou permet de basculer vers le texte source avec mise en surbrillance.
+- La recherche lit des lots séquentiels d'au plus 20 sessions pour une requête de 200 caractères maximum, en excluant les outils, pièces jointes, raisonnements et messages système.
+
+## Captures d'écran
+
+### 1. Gestion des sessions archivées (Cartes accordéon et mode sombre)
+Recherchez, marquez comme favori, prévisualisez, restaurez et nettoyez dans **Paramètres → Sessions archivées → Archivées** :
+
+![Archivées : filtres partagés, favoris et lignes compactes](assets/screenshots/archived-sessions.webp)
+
+Basculez vers **Non archivées** pour des suggestions de nettoyage intelligent et l'archivage par projet :
+
+![Non archivées : nettoyage intelligent et archivage par projet](assets/screenshots/unarchived-sessions.webp)
+
+### 2. Panneau centralisé de 960 px dans l'espace de travail principal
+Ouvrez un panneau complet de 960 px directement depuis la barre latérale principale :
+
+![Panneau principal : accès direct depuis la barre latérale](assets/screenshots/main-view-panel.webp)
+
+### 3. Clic droit natif et sous-menu en cascade dans la barre latérale
+Faites un clic droit sur n'importe quelle ligne de la barre latérale pour ouvrir les menus contextuels et déplacer des sessions :
+
+| Actions d'espace de travail | Déplacer une session entre projets |
+| :---: | :---: |
+| <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%"> |
+
+## Installation
+
+Nécessite un environnement DeepSeek Harness opérationnel (exemple avec le profil `web`) :
+
+### Installation par un agent
+Transmettez cette commande à un agent disposant d'un accès terminal sur votre machine :
+
+```text
+Installez la dernière version de @michengai/dsh-archive-manager dans mon profil web DSH depuis le registre officiel npm, vérifiez l'activation et indiquez comment recharger.
+```
+
+### Installation manuelle
+
+```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/
+```
+
+Redémarrez DSH Web et rechargez la page du navigateur (`Ctrl+Shift+R`). Ouvrez **Paramètres → Sessions archivées** pour commencer.
+
+- **Compatibilité hôte** : Série DeepSeek Harness `0.2.x` complète (`>=0.2.0-rc.1 <0.3.0-0`), validée sur toutes les versions candidates (`0.2.0-rc.1` à `0.2.2-rc.1`).
+- Les versions antérieures à `0.2.0-rc.1` ne sont plus prises en charge. Pour `0.1.x`, installez la version `1.0.20`.
+
+## Configuration du plugin
+
+Accessible via :
+> **Barre latérale → Plugins → Cliquez sur `Archive Manager`**
+
+### 1. Emplacement du raccourci (`entryLocation`)
+- **Partout (`both`)** : Affiche l'icône dans la barre latérale gauche et conserve l'entrée dans **Paramètres → Sessions archivées**.
+- **Barre latérale uniquement (`sidebar`)** : Affiche l'icône dans la barre latérale et retire l'entrée des paramètres pour un panneau allégé.
+- **Paramètres uniquement (`settings`)** (Défaut) : Garde la barre latérale sobre et conserve l'accès depuis **Paramètres → Sessions archivées**.
+
+### 2. Politique de mise à jour (`onlineUpdate` / `updater`)
+- En entreprise ou environnement sous contrôle strict, les mises à jour peuvent être verrouillées via la configuration Cordis :
+  ```yaml
+  updater: false # ou onlineUpdate: false
+  ```
+  Le gestionnaire de mise à jour est alors entièrement désactivé au démarrage du serveur.
+
+## Guide d'utilisation
+
+| Action | Description |
+| --- | --- |
+| **Archiver une discussion** | Ouvrez le menu de la session dans la barre latérale et choisissez **Archiver la session** |
+| **Archiver un espace de travail** | Ouvrez le menu de l'espace de travail et choisissez **Archiver la session** (confirmation sur place) |
+| **Rechercher et filtrer** | Ouvrez **Paramètres → Sessions archivées** ou cliquez sur **Archiver** dans la barre latérale. La recherche couvre titres et contenus |
+| **Calendrier interactif** | Cliquez sur la gélule de date pour ouvrir le popover avec navigation complète au clavier |
+| **Aperçu rapide** | Cliquez sur un résultat ou dans **Plus → Aperçu rapide** pour lire sans restaurer |
+| **Modifier le tri** | Triez par date d'archivage récent, date de mise à jour, de création ou titre |
+| **Restaurer une discussion** | Cliquez sur l'icône de restauration de la ligne, ou sur **Plus → Restaurer et ouvrir** |
+| **Archiver un groupe entier** | Dans **Non archivées**, utilisez le menu **…** du groupe pour archiver toutes les sessions |
+| **Ajouter aux favoris** | Cliquez sur l'icône d'étoile de la ligne pour l'épingler en favori |
+| **Nettoyer les sessions inactives** | Dans **Non archivées**, indiquez le nombre de jours d'inactivité pour prévisualiser et archiver |
+| **Copier l'ID de session** | Sélectionnez **Copier l'ID de session** dans le menu **Plus** |
+| **Nettoyer les sous-agents orphelins** | Identifiez et supprimez les sous-agents sans session mère dans le panneau d'organisation |
+| **Annuler cet archivage** | Restaurez les sessions archivées dans le lot actuel depuis la notification |
+| **Suppression définitive** | Sélectionnez des sessions, choisissez Supprimer et confirmez l'effacement physique des journaux et index |
+
+### Favoris et nettoyage des sessions inactives
+
+Les groupes de projets compacts peuvent être repliés. Les étoiles et les icônes de restauration/archivage s'affichent sur la droite ; les menus des sessions archivées comprennent « Restaurer et ouvrir » et « Supprimer ».
+
+- Utilisez l'étoile sur l'un ou l'autre onglet et le menu « Favoris uniquement » pour retrouver les discussions importantes. Les favoris restent enregistrés sur l'hôte après archivage, restauration ou changement de navigateur.
+- Dans « Non archivées », indiquez un seuil d'inactivité de 1 à 36 500 jours pour prévisualiser les candidats sous les filtres actuels. Vous pouvez désélectionner des éléments individuellement avant de confirmer. Les favoris, le chat actif, les sessions en cours d'exécution (y compris sous-agents) et les interactions en attente sont automatiquement protégés.
+- Les opérations par lots rapportent la progression et le décompte des réussites, éléments ignorés et échecs. Un échec n'arrête pas le reste du traitement ; seuls les éléments en échec sont réessayés.
+- **Annuler cet archivage** restaure les sessions archivées par le lot actuel. Cette action n'est accessible que tant que la page de gestion actuelle reste ouverte. La suppression définitive ne peut pas être annulée.
+
+### Consulter et poursuivre les conversations archivées
+
+La navigation native permet de lire et de reprendre les discussions :
+
+- **Cliquez sur le titre de la session** : ouvre la conversation native DSH pour consulter les messages, pièces jointes et détails d'outils. Continuez à chatter tout en conservant la session archivée.
+- **Plus → Restaurer et ouvrir** : désarchive la session et l'ouvre directement pour reprendre le travail.
+
+## Compatibilité de l'API de recherche (pour intégrateurs)
+
+L'API canonique est `workspaceRegistry.searchSessionContent({ sessionIds, query })`, couvrant les sessions archivées et non archivées. Fournissez de 1 à 20 identifiants de session et une requête non vide de 1 à 200 caractères. Le format de retour est `{ items: [{ sessionId, seq, snippet }], failures: [{ sessionId, message }] }`.
+
+`searchArchivedContent` reste le point d'entrée hérité pour les archives uniquement. Tous deux utilisent la connexion Typert de l'hôte existant et la limite d'autorisation.
+
+## Mises à jour
+
+Réexécutez la commande d'installation ci-dessus dans votre profil DSH actif pour mettre à jour le plugin. En entreprise, les mises à jour peuvent être verrouillées via la configuration Cordis.
+
+## FAQ
+
+### Qu'advient-il des anciens caches du plugin après la mise à jour ?
+
+Le plugin ne remplace pas la table de cache officielle des projections et ne scanne ni ne migre les anciens caches du plugin. Ouvrir la liste d'archives ne relit pas les journaux complets pour combler les entrées manquantes. Les journaux de session appartiennent à l'hôte, qui reconstruit les projections dérivées à la demande.
+
+**Une session froide sans entrée de cache officielle peut initialement apparaître sans titre dans la liste ; rafraîchir la liste seule ne garantit pas sa régénération.** Ouvrir le journal permet de récupérer le titre et restaurer la session comme active permet au chemin d'écriture natif d'enregistrer le cache. Les anciens fichiers de cache restent intacts. Consultez le [journal des modifications](CHANGELOG.md) pour plus de précisions.
+
+### Pourquoi l'entrée n'apparaît-elle pas après installation ?
+Redémarrez DSH Web et forcez le rechargement de votre navigateur (`Ctrl+Shift+R`). Vérifiez que le plugin est bien installé dans le profil actif.
+
+### Quelle est la différence entre archiver et supprimer ?
+L'archivage range la discussion pour pouvoir la consulter ou la restaurer plus tard. **La suppression définitive est irréversible** et efface physiquement les journaux sur le disque.
+
+### Est-ce compatible avec Codex UI ?
+Oui. [Codex UI](https://github.com/MichengAI/dsh-codex-ui) conserve son apparence et ses interactions dans la barre latérale, et l'Archive Manager reste accessible dans **Paramètres → Sessions archivées**.
+
+### Coexistence avec d'autres plugins d'archivage
+Le plugin utilise l'identifiant de section `archive-manager`, ce qui lui permet de coexister de manière transparente avec d'autres extensions d'archivage.
+
+## Installation depuis les sources
+
+<details>
+<summary>Déplier pour le développement ou tester des modifications non publiées</summary>
+
+Exécutez ces commandes dans le répertoire de votre choix :
+
+```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 .
+```
+
+Après installation, redémarrez DSH Web et rechargez la page. Le code source dans [src](src) utilise TypeScript strict. GitHub et npm contiennent tous deux le répertoire `lib` prêt à l'emploi.
+
+</details>
+
+## Écosystème de produits DSH
+
+Pour un poste de travail complet, téléchargez [DSH Codex Desktop](https://github.com/MichengAI/dsh-codex-desktop/releases). Pour [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness), ajoutez les plugins selon vos besoins :
+
+| Plugin | Capacités principales |
+| --- | --- |
+| [Codex UI](https://github.com/MichengAI/dsh-codex-ui) | Organisation des projets, recherche de tâches et navigation dans les messages |
+| [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) | Sélection et invocation d'agents spécialistes |
+| [Skills Manager](https://github.com/MichengAI/dsh-skills-manager) | Recherche, activation, création et importation de compétences locales |
+| [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) | Recherche, restauration et nettoyage physique des discussions archivées |
+| [IM Connect](https://github.com/MichengAI/dsh-im-connect) | Envoi de tâches et réception de réponses via vos messageries préférées |
+| [Automation](https://github.com/MichengAI/dsh-automation) | Planification de tâches récurrentes et suivi des exécutions |
+| [BTW](https://github.com/MichengAI/dsh-btw) | Questions annexes sans interrompre la tâche principale |
+| [Simplify](https://github.com/MichengAI/dsh-simplify) | Utilisation de `/simplify` pour perfectionner le code modifié dans Git |
+| [PUA](https://github.com/MichengAI/dsh-pua) | Incitation de l'agent à persévérer et vérifier ses résultats avant de conclure |
+| [Code Review](https://github.com/MichengAI/dsh-code-review) | Revue de code indépendante avec `/review` directement dans la discussion |
+| [Codex Pet](https://github.com/MichengAI/dsh-codex-pet) | Notifications et approbations d'outils via un compagnon de bureau |
+
+## Licence
+
+Distribué sous [Licence Apache 2.0](LICENSE).

package/README.ja.md

@@ -0,0 +1,239 @@
+<p align="center">
+  <img src="assets/branding/dsh-banner-en.webp" alt="DSH Archive Manager" width="100%">
+</p>
+
+<div align="center">
+
+  # DSH Archive Manager
+
+  **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)
+
+  [更新履歴](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)
+  [![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)
+  [![DSH 対応バージョン 0.2.2-rc.1 まで](https://img.shields.io/badge/DSH-up%20to%200.2.2--rc.1-2563eb.svg)](#前提条件)
+</div>
+
+> DSH Archive Manager はコミュニティによって保守されている DeepSeek Harness（DSH）向けプラグインであり、DeepSeek AI 公式の製品ではありません。
+
+本文書は **1.3.0** を対象としています。過去の変更履歴は [CHANGELOG.md](CHANGELOG.md) をご覧ください。
+
+## 機能概要
+
+一時的に使わない会話を整理して保管し、必要な時にいつでも復元。日常のタスクリストを常に整理された状態に保ちます。
+
+- **二重ビューとプライマリサイドバーエントリ**：ホストのメインサイドバーに常駐する専用ナビゲーションアイコンから、**960px 中央寄せのワークスペースビュー** を展開。「アーカイブ済み」と「未アーカイブ」の大型パネルを快適に操作でき、狭いダイアログのスクロール制約から解放されます。
+- **フルライフサイクル管理**：個別セッションのアーカイブ、ワークスペース全体のワンクリックアーカイブ、プロジェクト横断の一括アーカイブ、個別・一括の復元と直接オープンを完全サポート。
+- **サイドバー全行右クリック操作**：サイドバーのワークスペース行やセッション行の任意の余白を右クリックして専用操作メニューを呼び出し可能。未分類や未保存の行ではシステム標準の右クリックが安全に機能し、誤操作を防ぎます。
+- **ブレなし星標配置と状態ドットの完全共存 (#90, #92)**：お気に入り星標を標準の 16×16px に揃え、ホストの先頭スロットに絶対配置で重ね合わせることでタイトルの横ブレを解消。セッション実行中や承認待ちの際も、ホストの状態ドットを完全に表示したまま星標が右下 10px のバッジに自動縮退し、カスタムスキン環境でも美しく調和します。
+- **ワークスペースクイック操作メニュー**：サイドバーのワークスペースメニューから「フォルダパスをコピー」「フォルダを開く」（Windows Explorer または macOS Finder を直接起動）、「セッションをアーカイブ」を素早く実行。
+- **ワークスペース間のセッション移動**：ホバーで開くカスケードサブメニューからセッションを別のワークスペースへ移動可能。実行中プロセスの静穏化、アトミックなファイル書き換え、投影キャッシュの即時ウォームアップ、NTFS コロン安全性を備えています。
+- **一体型アコーディオンカードと 40px 超コンパクト行**：Skills Manager と同等の統合型ドロワーカード（38px ヘッダー）でプロジェクトグループを統一。セッション行の高さを 40px に凝縮し、情報密度を倍増させました。
+- **ホストネイティブなダークモードチェックボックス**：ホストの標準 Checkbox 仕様と `accent-color` に準拠し、ダーク背景とブランドブルーのチェック状態に完璧に調和。
+- **背面透け防止モーダルと多言語アクセシビリティ**：大型プレビューダイアログを `body` 直下（`portalToBody`）にマウントし、遮光背景とすりガラスぼかしで背面の文字透けを防止。全言語対応の閉じるボタンアクセシビリティラベル（`common.close`）を提供。
+- **標準化されたセクション ID と共存保護 (#91)**：設定ページの登録 ID をチーム統一仕様の `archive-manager` に改定し、フェイルソフトなランタイム保護を導入。サードパーティ製アーカイブプラグインと安全に共存可能。
+- **洗練された単一行適応型ツールバー**：ホスト標準の `Input` 原語、公式検索アイコン、緑色フォーカス枠を採用し、残りの幅を適応的に拡張。検索ボックス、表示・ソートメニュー、プロジェクト絞り込み、日付範囲を一行にスマートに配置。
+- **全文検索と Codex 風複合メニュー**：タイトルと会話本文（ユーザーおよびアシスタントのメッセージ）の両方を網羅する検索。セッション絞り込み（すべて／お気に入りのみ）と並び替えをチェックマーク付きの Codex 風メニューに統合。
+- **軽量 DateRange カプセルとカレンダーポップオーバー**：ネイティブ日付入力を完全に刷新し、ダークモードの反転やフォーカス喪失を解決 (#74)。単一行カプセルで選択範囲を表示し、クリアボタン、クイックプリセット、全 8 言語の曜日・月表示、WAI-ARIA キーボード操作（矢印、Home/End、PageUp/Down、月跨ぎ補正）を完備。
+- **アイドルセッションの自動整理**：経過日数を指定して長期間活動のないセッションを検出。実行中タスク、対話プロンプト、お気に入りを自動保護し、即時取り消し（Undo）にも対応。
+- **完全物理削除**：不要なトランスクリプト、キャッシュ行、インデックスを物理的に完全消去。失敗した項目は個別に再試行可能。
+- **孤立サブエージェントの検出と解放**：親セッションが外部から物理削除されて残された孤立サブエージェントを自動検出し、ディスク使用量を表示してワンクリックで物理解放。
+- **企業向け Cordis 宿主設定ロックとリバースプロキシ対応**：Cordis 設定ファイル（bundle patch）によるセキュリティ完全ロックをサポート。プレフィックスを除去するリバースプロキシ配下でも `document.baseURI` により自動的にエンドポイントを解決。
+
+## 手動リストキャッシュ再構築 (#88)
+
+アーカイブマネージャーを開くと、登録済みワークスペース、未分類リスト、アーカイブ内の通常のコールドセッションのヘッダーと公式キャッシュ投影のみをチェックし、IM チャンネルセッション（`im:`）は除外されます。キャッシュが欠落または非互換の場合、あるいはタイトル投影が利用できない場合にのみ修復カードが表示されます。クリックすると読み取り専用ハンドルを介してログを 1 つずつ読み取り、公式 `coldSnapshot` で投影を再構築して `session_projcache` に保存します。
+
+古いプラグイン領域のスキャン、JSON コピー、セッション/エージェントの起動、モデルの呼び出しは一切行わず、アーカイブやスケジュールも変更しません。実行中のセッションはスキップされ、失敗した項目は個別に再試行できます。完了後は公式セッションリストが更新され、候補が再確認されます。
+
+## 孤立サブエージェントのクリーンアップ
+
+親セッションが外部ツールやホストによって削除された場合、残された孤立サブエージェントがディスク上に残ることがあります。アーカイブマネージャーの「整理」パネルでこれらの孤立セッションを検出し、ディスク占有容量を計算してワンクリックで物理削除できます。
+
+## 検索とプレビュー
+
+- 「アーカイブ済み」と「未アーカイブ」の両タブで、タイトル/本文検索、プロジェクト絞り込み、お気に入り、更新日フィルター、作成日ソートを共有。どちらのタブからでもスターの付け外しが可能です。
+- 検索はタイトルだけでなく会話本文（ユーザーとアシスタントのメッセージ）も自動的に対象とします。日付フィルターはユーザー現地の終日を含み、プロジェクトやお気に入りと組み合わせて絞り込めます。
+- 一致した箇所にはスニペットとハイライトが表示されます。「アーカイブ済み」ではスニペットまたは「詳細 → クイックプレビュー」をクリックして復元せずに文脈を確認でき、「未アーカイブ」ではクリックして会話を直接開きます。
+- プレビューは Markdown の表、引用、コードブロックをロールラベル付きでレンダリングします。ハイライトを確認したい場合は原文表示に切り替え可能です。最新の最大 8 件のメッセージ、または最初の一致箇所の前後を表示します。1 メッセージあたり最大 2,000 UTF-16 コードユニットで安全に切り詰めます。
+- 検索クエリは最大 200 文字、1 バッチあたり最大 20 セッションを順次読み取ります。ツール、添付ファイル、推論、システムメッセージ、プラグイン挿入データは除外されます。
+- 永続的な全文インデックスは保持しないため、長大なセッションが多い場合はプロジェクトや日付で絞り込んでから検索してください。
+
+## スクリーンショット
+
+### 1. アーカイブ設定管理（アコーディオンカードとダークモードチェックボックス）
+「設定 → アーカイブセッション → アーカイブ済み」で、統合ドロワーカード、40px 超コンパクト行、ネイティブダークモードチェックボックスを使用して検索、お気に入り、プレビュー、復元、クリーンアップを実行：
+
+![アーカイブ済み: 共有検索フィルター、お気に入り、コンパクト行](assets/screenshots/archived-sessions.webp)
+
+「未アーカイブ」に切り替えると、長期間活動のないセッションの整理提案、ワンクリックアーカイブ、プロジェクト一括操作が利用可能：
+
+![未アーカイブ: スマートアイドル整理とプロジェクト一括アーカイブ](assets/screenshots/unarchived-sessions.webp)
+
+### 2. 中央寄せフルスクリーンワークスペースパネル（サイドバー直通エントリ）
+サイドバーエントリを有効にすると、メインサイドバーから直接 960px 中央寄せのフル機能ワークスペースパネルを展開：
+
+![メインワークスペースパネル: 専用サイドバーエントリと 960px 中央寄せ表示](assets/screenshots/main-view-panel.webp)
+
+### 3. ネイティブサイドバー全行右クリックとカスケードメニュー
+プライマリサイドバーのワークスペース行またはセッション行を直接右クリックして、操作メニューおよびワークスペース間セッション移動のサブメニューを開く：
+
+| ワークスペース操作（フォルダを開く/パスをコピー） | ワークスペース間のセッション移動（カスケードサブメニュー） |
+| :---: | :---: |
+| <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%"> |
+
+## インストール手順
+
+DeepSeek Harness 環境が必要です。以下の例では `web` プロファイルを使用しています。環境に合わせて調整してください。
+
+### エージェントに依頼してインストール
+お使いのコンピュータでターミナルコマンドを実行できるエージェントに次のプロンプトを送信してください：
+
+```text
+公式 npm レジストリから最新の @michengai/dsh-archive-manager を DSH の web プロファイルにインストールし、アクティベーションを確認してリロード手順を説明してください。
+```
+
+### 手動でインストール
+
+```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/
+```
+
+インストール後、DSH Web を再起動し、ブラウザでページを更新（または `Ctrl+Shift+R` でハードリフレッシュ）してください。「設定 → アーカイブセッション」を開いて利用を開始します。更新時は同じインストールコマンドを再実行するだけです。
+
+- **ホスト対応範囲**：DeepSeek Harness `0.2.x` 全シリーズ（`>=0.2.0-rc.1 <0.3.0-0`）。全 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`）で検証済みです。
+- `0.2.0-rc.1` 未満の旧バージョンホストはサポート終了しました。`0.1.x` をご利用の場合はプラグイン `1.0.20` をご利用ください。
+- **リバースプロキシ対応**：`/app/dsh/` などのサブパス配下に配置されたリバースプロキシ構成にも完全対応。API エンドポイントはページのベース URI（`document.baseURI`）に基づいて動的に解決されます。
+
+## プラグイン設定
+
+DSH 標準のプラグイン設定に準拠しています：
+> **サイドバー → プラグイン → `Archive Manager` をクリック**（ホストの `plugins.bundle.config` スロット）
+
+### 1. エントリ表示位置 (`entryLocation`)
+- **すべての場所 (`both`)**：左サイドバーにアイコンを表示し、「設定 → アーカイブセッション」の項目も維持します。
+- **サイドバーのみ (`sidebar`)**：左サイドバーにアイコンを表示し、設定ページの項目を登録解除して設定画面をスッキリさせます。
+- **設定のみ (`settings`)**（デフォルト）：左サイドバーを最小限に保ち、「設定 → アーカイブセッション」からアクセスします。
+
+### 2. オンライン更新ポリシー (`onlineUpdate` / `updater`)
+- **設定方法**：企業のセキュリティコンプライアンス環境などでは、Cordis 設定ファイル（bundle patch）から更新を無効化できます：
+  ```yaml
+  updater: false # または onlineUpdate: false
+  ```
+  設定すると起動時にアップデータが無効化され、未検証の外部バージョンがインストールされるのを防ぎます。
+
+## 使用ガイド
+
+| 操作 | 手順 |
+| --- | --- |
+| **単一会話をアーカイブ** | サイドバーのセッションメニューから **セッションをアーカイブ** を選択 |
+| **ワークスペース全体をアーカイブ** | ワークスペースメニューから **セッションをアーカイブ** を選択（インプレース確認が表示されます） |
+| **検索と絞り込み** | **設定 → アーカイブセッション** またはサイドバーの **アーカイブ** をクリック。タイトルと本文を網羅して検索。Codex 風メニューで表示とソートを切り替え |
+| **カレンダー操作** | 日付カプセルをクリックして軽量カレンダーを開く。全期間・プリセット対応。矢印・Home/End・PageUp/Down による完全なキーボード操作 |
+| **クイックプレビュー** | 一致スニペットまたは **詳細 → クイックプレビュー** をクリックして復元せずに内容を確認 |
+| **並び順の調整** | 最近アーカイブした順、更新日時、作成日時、タイトル順でソート |
+| **会話の復元** | 行の復元アイコンをクリック。**詳細 → 復元して開く** で直接再開 |
+| **グループ全体を一括アーカイブ** | **未アーカイブ** でグループの **…** メニューから全チャットのアーカイブを確認 |
+| **お気に入り登録** | 行の星標アイコンをクリック。表示メニューからスター付きのみに絞り込み可能 |
+| **アイドルチャットの整理** | **未アーカイブ** でアイドル日数を入力。実行中やお気に入りは自動保護され、候補を確認して実行 |
+| **セッション ID をコピー** | **詳細** メニューから **セッション ID をコピー** を選択 |
+| **孤立サブエージェントの整理** | 整理パネルで孤立サブエージェントを検出して物理削除 |
+| **アーカイブの取り消し** | アーカイブ直後の通知から本バッチでアーカイブされたセッションを一括復元 |
+| **完全削除** | セッションを選択して削除を実行。ログ、キャッシュ、インデックスを物理的に完全消去 |
+
+### お気に入りとアイドル整理
+
+コンパクトなプロジェクトグループは折りたたみ可能です。スターや復元・アーカイブアイコンが右側に配置され、アーカイブされたセッションのメニューには「復元して開く」と「削除」が含まれます。
+
+- タブを問わずスターアイコンと「お気に入りのみ」ドロップダウンを使用して重要なチャットをすばやく見つけられます。お気に入りはアーカイブ、復元、ブラウザ変更をまたいでホスト側に永続化されます。
+- 「未アーカイブ」では、1〜36,500 日のアイドル日数を指定して現在のフィルター下で候補をプレビューできます。確認前に個別の候補のチェックを外すことも可能です。お気に入り、現在のチャット、実行中セッション（サブエージェントを含む）、承認待ちタスクは自動的に保護されます。
+- 一括アーカイブ、復元、削除は進捗と成功・スキップ・失敗件数を表示します。一部が失敗しても全体の処理は停止せず、失敗項目のみを再試行できます。
+- **アーカイブの取り消し（Undo）** は、現在のバッチでアーカイブされたセッション（再試行成功分を含む）を復元します。この操作は現在の管理ページを開いている間のみ有効で、更新や終了を行うとクリアされます。完全削除は取り消せません。
+
+### アーカイブされた会話の閲覧と継続
+
+ネイティブな会話ナビゲーションにより、アーカイブ状態を維持したまま過去のログを閲覧・継続できます：
+
+- **セッションタイトルをクリック**：ネイティブ DSH 会話を開き、メッセージ、添付ファイル、ツール実行詳細を確認。アーカイブ状態を保ったままチャットを継続できます。
+- **詳細 → 復元して開く**：セッションのアーカイブを解除し、アクティブなワークスペースで作業を再開します。
+
+## 検索 API の互換性（インテグレーター向け）
+
+正式な API は `workspaceRegistry.searchSessionContent({ sessionIds, query })` であり、アーカイブ済みと未アーカイブの両方のセッションを網羅します。1〜20 件のセッション ID と 1〜200 文字の空でないクエリを指定します。重複する ID は自動的に除外されます。戻り値の形式は `{ items: [{ sessionId, seq, snippet }], failures: [{ sessionId, message }] }` です。個別の読み取り失敗は `failures` に記録され、不正な入力はリクエスト自体が拒否されます。
+
+`searchArchivedContent` は従来のアーカイブ専用レガシーエントリとして引き続き利用可能です。いずれも既存のホスト Typert 接続と認証境界を使用し、追加の HTTP エンドポイントや認証設定は不要です。
+
+## 更新
+
+アクティブな DSH プロファイルで上記のインストールコマンドを再実行するだけで更新が完了します。企業のセキュリティポリシーなどで更新を制限したい環境では、Cordis 設定を介してアップデータを無効化できます。
+
+## よくある質問
+
+### 旧バージョンからアップグレードした後、過去のキャッシュはどうなりますか？
+
+本プラグインは公式の投影キャッシュテーブルを置き換えることはなく、古いプラグインキャッシュのスキャンや移行も行いません。アーカイブリストを開いても完全なログを読み直したり、欠落したキャッシュを補填するために公式投影を書き戻したりすることはありません。セッションログはホストが管理し、ホストが必要に応じてタイトルなどの派生投影をオンデマンドで再構築します。
+
+**公式キャッシュが存在しないコールドセッションは、リスト上で一時的にタイトルが表示されない場合がありますが、リストの再読み込みだけで再構築されるとは限りません。** ログを開くことでタイトルが復元され、セッションをアクティブとして復元することでネイティブな書き込みパスを通じてキャッシュが保存されます。過去の古いプラグインキャッシュファイルはそのまま保持され、自動的に読み込まれたり削除されたりすることはありません。詳細は [更新履歴](CHANGELOG.md) をご確認ください。
+
+### インストールしたのにエントリが表示されません
+DSH Web を再起動し、ブラウザをスーパーリロード（`Ctrl+Shift+R`）してください。使用中のプロファイルに正しくインストールされたかご確認ください。
+
+### アーカイブと削除の違いは何ですか？
+アーカイブは後から復元できるように一時的に会話を片付ける操作です。**完全削除は取り消すことができず**、セッションログや添付ファイルも物理的に削除されます。削除時は確認ダイアログが表示されます。
+
+### Codex UI と併用できますか？
+はい。[Codex UI](https://github.com/MichengAI/dsh-codex-ui) の外観とサイドバー操作を維持したまま、**設定 → アーカイブセッション** からスムーズに利用できます。
+
+### 他のアーカイブプラグインとの共存について
+本プラグインは設定セクション ID `archive-manager` を使用して登録されます。他のセッションアーカイブプラグインがインストールされていても独立して共存・動作します。
+
+## ソースコードからのインストール
+
+<details>
+<summary>未リリースの改修や開発検証を行う場合は展開してください</summary>
+
+任意のディレクトリで以下のコマンドを実行します：
+
+```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 .
+```
+
+インストール後、DSH Web を再起動し、ブラウザをリフレッシュしてください。ソースコードは [src](src) 配下にあり、TypeScript Strict モードで管理されています。GitHub と npm の双方にビルド済みの `lib` が含まれています。
+
+</details>
+
+## DSH 製品エコシステム
+
+デスクトップ作業環境には [DSH Codex Desktop](https://github.com/MichengAI/dsh-codex-desktop/releases) をご利用ください。既存の [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 環境には、各プラグインの README に従って個別に追加できます：
+
+| プラグイン | 主な機能 |
+| --- | --- |
+| [Codex UI](https://github.com/MichengAI/dsh-codex-ui) | プロジェクトと会話の整理、タスク検索、メッセージナビゲーション |
+| [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) | 各種専門家エージェントの選択と召喚 |
+| [Skills Manager](https://github.com/MichengAI/dsh-skills-manager) | ローカルスキルの検索、有効化、作成、インポート |
+| [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) | アーカイブされた会話の検索、復元、物理クリーンアップ |
+| [IM Connect](https://github.com/MichengAI/dsh-im-connect) | 各種メッセージングアプリを介したタスクの送信と受信 |
+| [Automation](https://github.com/MichengAI/dsh-automation) | 定期タスクのスケジュール管理と実行結果の確認 |
+| [BTW](https://github.com/MichengAI/dsh-btw) | メインタスクを中断せずに横から質問できるサイドチャット |
+| [Simplify](https://github.com/MichengAI/dsh-simplify) | `/simplify` で Git の変更内容に基づきコードをリファクタリング |
+| [PUA](https://github.com/MichengAI/dsh-pua) | エージェントに失敗原因の調査と完了前検証を促す |
+| [Code Review](https://github.com/MichengAI/dsh-code-review) | `/review` で独立したコードレビューを依頼し、現在のチャットでレポートを受信 |
+| [Codex Pet](https://github.com/MichengAI/dsh-codex-pet) | デスクトップペットを通じて会話通知を確認し、ツールの承認や質問に応答 |
+
+## ライセンス
+
+[Apache License 2.0](LICENSE) の下で提供されています。

package/README.md

@@ -8,7 +8,9 @@
 
   **在 DeepSeek Harness 中安全管理已归档会话**
 
-  [English](README.en.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 配置禁用更新器。
 
 ## 常见问题