dsh-workspace-memories 1.2.1 → 1.2.2

package/README.md

@@ -26,6 +26,7 @@ This plugin closes that gap with a small, explicit memory loop whose default sto
 | Browse / create / edit / delete memory files | **Workspace Memory** sidebar panel (switch workspaces or the global scope via the selector) |
 | Ask the agent to remember something | Any session: "remember: …" → the agent calls `save_workspace_memory` |
 | Automatic recall | Every session gets the **global** memory (all workspaces) followed by its **workspace** memory injected into its system prompt |
+| Localized UI | The panel follows the app language in all eight DSH languages (中文 / English / 日本語 / Español / Français / Deutsch / Русский / Português), falling back to English for missing keys |
 
 Works in every built-in agent preset (Standard, PTC, Minimal, Creator): the tool is registered in the root composition, and global tools are visible to all presets unless a custom preset opts out with a `tools.restrict` allow list — add `save_workspace_memory` to that list if so.
 
@@ -33,6 +34,8 @@ Works in every built-in agent preset (Standard, PTC, Minimal, Creator): the tool
 
 The panel selector's top entry, **🌐 Global — every workspace**, addresses one cross-project memory directory at `~/.dsh/workspace-memory/_global/`. It is seeded once with a blank `preferences.md` template (persona, style, communication, formatting) and never overwritten after that. Global memory sorts **before** workspace memory in the prompt, so project notes read as overrides of personal preferences.
 
+Too lazy to fill four blank sections by hand? Just tell any session **"帮我配置全局偏好"** ("help me set up my global preferences") — the agent interviews you question by question and writes the file itself via `save_workspace_memory` with `scope: "global"`.
+
 ## Installation
 
 The package is plain JavaScript with no build step, so every install channel works:
@@ -85,9 +88,10 @@ dsh-workspace-memories/        # this plugin
 ├── cordis.patch.yml         #   plugin row declaration
 ├── index.js                 #   host: /api routes + prompt injection + the save tool
 ├── client.js                #   browser: sidebar entry + management panel
-├── locale/                  #   panel copy (en, zh)
+├── locale/                  #   panel copy + plugin-page meta, all eight DSH languages
 ├── icon.svg
-└── selftest.mjs             #   host-logic self-test: node selftest.mjs
+├── selftest.mjs             #   host-logic self-test: node selftest.mjs
+└── scripts/i18n-test.mjs    #   client dictionary check (8 languages, key sets, placeholders)
 ```
 
 Safety constraints: the browser panel can only address registered workspaces by `workspaceId` (no arbitrary host paths); file names are strictly validated (no path separators, `..`, whitespace, or control characters); one file is capped at 1 MiB; prompt injection truncates each file to 32K characters and caps at 20 files.
@@ -95,7 +99,7 @@ Safety constraints: the browser panel can only address registered workspaces by
 ## Development
 
 - Install with a `link:` dependency (local-path install does this): editing `client.js` hot-reloads in the page via the client HMR receiver; editing `index.js` (host code) requires a DSH restart to load the new module generation.
-- Run the self-test: `node selftest.mjs` (mocks the plugin context; covers routes, prompt rendering, tool writes, and validation failures).
+- Run the self-test: `node selftest.mjs` (mocks the plugin context; covers routes, prompt rendering, tool writes, and validation failures); `node scripts/i18n-test.mjs` checks the eight-language dictionaries (key sets, placeholders).
 - Runtime checks: host entry `include:workspace-memory` should be `active`; the client slot `sidebar.panellist` should list a `workspace-memory` occupant; `save_workspace_memory` should appear in the tool list.
 
 ## License

package/README.zh.md

@@ -26,6 +26,7 @@ DSH 的 Agent 跨会话是无状态的：一个会话"学到"的东西——项
 | 浏览 / 新建 / 编辑 / 删除记忆文件 | 侧栏「工作区记忆」面板（可切换工作区或全局范围） |
 | 让 Agent 记住事情 | 任意会话直接说「记住：…」→ Agent 调用 `save_workspace_memory` |
 | 记忆自动生效 | 每个会话的系统提示先携带**全局**记忆（所有工作区通用），再携带**工作区**记忆 |
+| 界面多语言 | 面板跟随应用语言，完整支持 DSH 八国语言（中/英/日/西/法/德/俄/葡），缺键回退英文 |
 
 所有内置 Agent 预设（标准、PTC、极简、创造）均可用：工具注册在根组合，全局工具默认对所有预设可见。唯一例外是自定义预设使用 `tools.restrict` 白名单（`allow: [...]`）的情况——把 `save_workspace_memory` 加进白名单即可。
 
@@ -33,6 +34,8 @@ DSH 的 Agent 跨会话是无状态的：一个会话"学到"的东西——项
 
 面板下拉里第一项「🌐 全局（所有工作区通用）」对应跨项目记忆目录 `~/.dsh/workspace-memory/_global/`。首次使用时自动种入一份空白模板 `preferences.md`（人格、风格、沟通、格式四节，带注释提示），此后绝不覆盖用户修改。注入顺序上全局记忆排在工作区记忆**前面**，工作区里的项目笔记即是对个人偏好的覆盖。
 
+懒得自己填？在任意会话直接说「**帮我配置全局偏好**」——Agent 会逐个问你几个问题，然后用 `save_workspace_memory`（`scope: "global"`）自动写好。
+
 ## 安装
 
 本包为纯 JavaScript、无构建步骤，所有安装渠道都可用：
@@ -83,9 +86,10 @@ dsh-workspace-memories/       # 本插件
 ├── cordis.patch.yml      #   插件行声明
 ├── index.js              #   宿主：/api 路由 + 记忆注入 + 写记忆工具
 ├── client.js             #   浏览器：侧栏入口 + 管理面板
-├── locale/               #   面板文案（中/英）
+├── locale/               #   面板文案 + 插件页 meta，八国语言齐全
 ├── icon.svg
-└── selftest.mjs          #   宿主逻辑自测：node selftest.mjs
+├── selftest.mjs          #   宿主逻辑自测：node selftest.mjs
+└── scripts/i18n-test.mjs #   客户端字典校验（8 语言键集 / 占位符一致）
 ```
 
 安全约束：浏览器面板只能按 `workspaceId` 操作已注册工作区（无法触达任意宿主路径）；文件名严格校验（拒绝路径分隔符、`..`、空白与控制字符）；单文件上限 1 MiB；注入提示时单文件截取前 32K 字符、最多 20 个文件。
@@ -93,7 +97,7 @@ dsh-workspace-memories/       # 本插件
 ## 开发与调试
 
 - 以 `link:` 方式安装时（本地路径安装即是）：改 `client.js`（界面）经客户端 HMR 即时生效；改 `index.js`（宿主）需重启 DSH 加载新模块。
-- 自测：`node selftest.mjs`（模拟插件上下文，覆盖路由、注入渲染、工具写入与校验失败）。
+- 自测：`node selftest.mjs`（模拟插件上下文，覆盖路由、注入渲染、工具写入与校验失败）；`node scripts/i18n-test.mjs`（八国语言键集与占位符一致性）。
 - 运行时检查：宿主条目 `include:workspace-memory` 应为 `active`；客户端 slot `sidebar.panellist` 应有 `workspace-memory` 占用项；`save_workspace_memory` 应出现在工具列表中。
 
 ## 许可证

package/client.js

@@ -79,7 +79,190 @@ window.__ModuleLoader__.load({
       'error.generic': '操作失败。',
     }
 
-    const fallback = (key) => en[key] || key
+    const ja = {
+      'panel.title': 'ワークスペースメモリ',
+      'panel.subtitle': 'ワークスペースごとのメモリファイル。デフォルトでは DSH データディレクトリに保存され、プロジェクトフォルダーの外にあるため、サーバー設定などの機密ローカル情報が誤ってコミットされることはありません。このワークスペースのすべてのセッションに注入されます。',
+      'workspace.label': 'メモリの範囲',
+      'workspace.none': 'ワークスペースはまだ登録されていません。',
+      'workspace.global': '🌐 グローバル（すべてのワークスペース）',
+      'action.refresh': '更新',
+      'action.new': '新規ファイル',
+      'action.save': '保存',
+      'action.delete': '削除',
+      'action.confirmDelete': '削除を確認',
+      'action.cancel': 'キャンセル',
+      'action.create': '作成',
+      'list.loading': '読み込み中…',
+      'list.empty': 'メモリファイルはまだありません',
+      'list.emptyHint': '.md ファイルを作成して、このワークスペースのメモ、規約、決定事項を記録しましょう。',
+      'list.error': 'メモリファイルの読み込みに失敗しました。',
+      'new.nameLabel': 'ファイル名',
+      'new.placeholder': '例: architecture.md',
+      'new.invalid': '英字、数字、ドット、アンダースコア、ハイフンが使用できます。.md 拡張子がない場合は自動で付加されます。',
+      'editor.hint': '左側のメモリファイルを選択するか、新規作成してください。',
+      'editor.placeholder': 'Markdown でメモリの内容を書きます…',
+      'editor.dirty': '未保存の変更があります',
+      'editor.readonlyMissing': 'このファイルはディスク上に存在しなくなりました。',
+      'notice.saved': '保存しました。',
+      'notice.created': '作成しました。',
+      'notice.deleted': '削除しました。',
+      'error.generic': '操作に失敗しました。',
+    }
+
+    const es = {
+      'panel.title': 'Memoria del espacio de trabajo',
+      'panel.subtitle': 'Archivos de memoria por espacio de trabajo, guardados por defecto en el directorio de datos de DSH — fuera de la carpeta del proyecto, por lo que las configuraciones de servidor y otras notas locales sensibles nunca se confirman por error. Se inyectan en cada sesión del espacio de trabajo.',
+      'workspace.label': 'Ámbito de la memoria',
+      'workspace.none': 'Aún no hay ningún espacio de trabajo registrado.',
+      'workspace.global': '🌐 Global — todos los espacios de trabajo',
+      'action.refresh': 'Actualizar',
+      'action.new': 'Nuevo archivo',
+      'action.save': 'Guardar',
+      'action.delete': 'Eliminar',
+      'action.confirmDelete': 'Confirmar eliminación',
+      'action.cancel': 'Cancelar',
+      'action.create': 'Crear',
+      'list.loading': 'Cargando…',
+      'list.empty': 'Aún no hay archivos de memoria',
+      'list.emptyHint': 'Crea un archivo .md para guardar notas, convenciones y decisiones de este espacio de trabajo.',
+      'list.error': 'No se pudieron cargar los archivos de memoria.',
+      'new.nameLabel': 'Nombre del archivo',
+      'new.placeholder': 'p. ej., architecture.md',
+      'new.invalid': 'Se admiten letras, números, punto, guion bajo y guion; la extensión .md se añade automáticamente si falta.',
+      'editor.hint': 'Selecciona un archivo de memoria a la izquierda o crea uno nuevo.',
+      'editor.placeholder': 'Escribe el contenido de la memoria en Markdown…',
+      'editor.dirty': 'Cambios sin guardar',
+      'editor.readonlyMissing': 'Este archivo ya no existe en el disco.',
+      'notice.saved': 'Guardado.',
+      'notice.created': 'Creado.',
+      'notice.deleted': 'Eliminado.',
+      'error.generic': 'La operación falló.',
+    }
+
+    const fr = {
+      'panel.title': 'Mémoire de l’espace de travail',
+      'panel.subtitle': 'Fichiers de mémoire par espace de travail, stockés par défaut dans le répertoire de données de DSH — en dehors du dossier du projet, afin que les configurations serveur et autres notes locales sensibles ne soient jamais validées par erreur. Ils sont injectés dans chaque session de l’espace de travail.',
+      'workspace.label': 'Portée de la mémoire',
+      'workspace.none': 'Aucun espace de travail n’est encore enregistré.',
+      'workspace.global': '🌐 Global — tous les espaces de travail',
+      'action.refresh': 'Actualiser',
+      'action.new': 'Nouveau fichier',
+      'action.save': 'Enregistrer',
+      'action.delete': 'Supprimer',
+      'action.confirmDelete': 'Confirmer la suppression',
+      'action.cancel': 'Annuler',
+      'action.create': 'Créer',
+      'list.loading': 'Chargement…',
+      'list.empty': 'Aucun fichier de mémoire pour le moment',
+      'list.emptyHint': 'Créez un fichier .md pour conserver les notes, conventions et décisions de cet espace de travail.',
+      'list.error': 'Échec du chargement des fichiers de mémoire.',
+      'new.nameLabel': 'Nom du fichier',
+      'new.placeholder': 'p. ex. architecture.md',
+      'new.invalid': 'Lettres, chiffres, point, tiret bas et tiret admis ; l’extension .md est ajoutée automatiquement si elle manque.',
+      'editor.hint': 'Sélectionnez un fichier de mémoire à gauche, ou créez-en un nouveau.',
+      'editor.placeholder': 'Rédigez le contenu de la mémoire en Markdown…',
+      'editor.dirty': 'Modifications non enregistrées',
+      'editor.readonlyMissing': 'Ce fichier n’existe plus sur le disque.',
+      'notice.saved': 'Enregistré.',
+      'notice.created': 'Créé.',
+      'notice.deleted': 'Supprimé.',
+      'error.generic': 'L’opération a échoué.',
+    }
+
+    const de = {
+      'panel.title': 'Arbeitsbereichs-Speicher',
+      'panel.subtitle': 'Speicherdateien pro Arbeitsbereich, standardmäßig im DSH-Datenverzeichnis gespeichert — außerhalb des Projektordners, sodass Serverkonfigurationen und andere lokale sensible Notizen nie versehentlich committet werden. Sie werden in jede Session des Arbeitsbereichs injiziert.',
+      'workspace.label': 'Speicherbereich',
+      'workspace.none': 'Es ist noch kein Arbeitsbereich registriert.',
+      'workspace.global': '🌐 Global — alle Arbeitsbereiche',
+      'action.refresh': 'Aktualisieren',
+      'action.new': 'Neue Datei',
+      'action.save': 'Speichern',
+      'action.delete': 'Löschen',
+      'action.confirmDelete': 'Löschung bestätigen',
+      'action.cancel': 'Abbrechen',
+      'action.create': 'Erstellen',
+      'list.loading': 'Wird geladen…',
+      'list.empty': 'Noch keine Speicherdateien',
+      'list.emptyHint': 'Erstellen Sie eine .md-Datei, um Notizen, Konventionen und Entscheidungen für diesen Arbeitsbereich festzuhalten.',
+      'list.error': 'Speicherdateien konnten nicht geladen werden.',
+      'new.nameLabel': 'Dateiname',
+      'new.placeholder': 'z. B. architecture.md',
+      'new.invalid': 'Buchstaben, Ziffern, Punkt, Unterstrich und Bindestrich sind erlaubt; die Erweiterung .md wird bei Bedarf automatisch ergänzt.',
+      'editor.hint': 'Wählen Sie links eine Speicherdatei aus oder erstellen Sie eine neue.',
+      'editor.placeholder': 'Speicherinhalt in Markdown schreiben…',
+      'editor.dirty': 'Ungespeicherte Änderungen',
+      'editor.readonlyMissing': 'Diese Datei existiert nicht mehr auf dem Datenträger.',
+      'notice.saved': 'Gespeichert.',
+      'notice.created': 'Erstellt.',
+      'notice.deleted': 'Gelöscht.',
+      'error.generic': 'Vorgang fehlgeschlagen.',
+    }
+
+    const ru = {
+      'panel.title': 'Память рабочей области',
+      'panel.subtitle': 'Файлы памяти для каждой рабочей области по умолчанию хранятся в каталоге данных DSH — вне папки проекта, поэтому конфигурации серверов и другие локальные заметки никогда не попадут в коммит по ошибке. Они инъецируются в каждую сессию рабочей области.',
+      'workspace.label': 'Область памяти',
+      'workspace.none': 'Пока не зарегистрировано ни одной рабочей области.',
+      'workspace.global': '🌐 Глобально — все рабочие области',
+      'action.refresh': 'Обновить',
+      'action.new': 'Новый файл',
+      'action.save': 'Сохранить',
+      'action.delete': 'Удалить',
+      'action.confirmDelete': 'Подтвердить удаление',
+      'action.cancel': 'Отмена',
+      'action.create': 'Создать',
+      'list.loading': 'Загрузка…',
+      'list.empty': 'Файлов памяти пока нет',
+      'list.emptyHint': 'Создайте .md-файл, чтобы хранить заметки, соглашения и решения для этой рабочей области.',
+      'list.error': 'Не удалось загрузить файлы памяти.',
+      'new.nameLabel': 'Имя файла',
+      'new.placeholder': 'например, architecture.md',
+      'new.invalid': 'Допускаются буквы, цифры, точка, подчёркивание и дефис; расширение .md добавляется автоматически, если оно отсутствует.',
+      'editor.hint': 'Выберите файл памяти слева или создайте новый.',
+      'editor.placeholder': 'Запишите содержимое памяти в Markdown…',
+      'editor.dirty': 'Есть несохранённые изменения',
+      'editor.readonlyMissing': 'Этот файл больше не существует на диске.',
+      'notice.saved': 'Сохранено.',
+      'notice.created': 'Создано.',
+      'notice.deleted': 'Удалено.',
+      'error.generic': 'Операция не удалась.',
+    }
+
+    const pt = {
+      'panel.title': 'Memória do espaço de trabalho',
+      'panel.subtitle': 'Arquivos de memória por espaço de trabalho, salvos por padrão no diretório de dados do DSH — fora da pasta do projeto, para que configurações de servidor e outras notas locais sensíveis nunca sejam commitadas por engano. São injetados em cada sessão do espaço de trabalho.',
+      'workspace.label': 'Escopo da memória',
+      'workspace.none': 'Nenhum espaço de trabalho registrado ainda.',
+      'workspace.global': '🌐 Global — todos os espaços de trabalho',
+      'action.refresh': 'Atualizar',
+      'action.new': 'Novo arquivo',
+      'action.save': 'Salvar',
+      'action.delete': 'Excluir',
+      'action.confirmDelete': 'Confirmar exclusão',
+      'action.cancel': 'Cancelar',
+      'action.create': 'Criar',
+      'list.loading': 'Carregando…',
+      'list.empty': 'Ainda não há arquivos de memória',
+      'list.emptyHint': 'Crie um arquivo .md para guardar anotações, convenções e decisões deste espaço de trabalho.',
+      'list.error': 'Falha ao carregar os arquivos de memória.',
+      'new.nameLabel': 'Nome do arquivo',
+      'new.placeholder': 'ex.: architecture.md',
+      'new.invalid': 'Use letras, dígitos, ponto, sublinhado ou hífen; a extensão .md é adicionada automaticamente quando ausente.',
+      'editor.hint': 'Selecione um arquivo de memória à esquerda ou crie um novo.',
+      'editor.placeholder': 'Escreva o conteúdo da memória em Markdown…',
+      'editor.dirty': 'Alterações não salvas',
+      'editor.readonlyMissing': 'Este arquivo não existe mais no disco.',
+      'notice.saved': 'Salvo.',
+      'notice.created': 'Criado.',
+      'notice.deleted': 'Excluído.',
+      'error.generic': 'A operação falhou.',
+    }
+
+    /** All eight DSH languages, registered with the host locale runtime. */
+    const DICT = { zh, en, ja, es, fr, de, ru, pt }
+
+    const fallback = (key) => en[key] || zh[key] || key
 
     /**
      * Call one Host-half route and unwrap its envelope.
@@ -233,10 +416,28 @@ window.__ModuleLoader__.load({
      * @param {{ t?: (key: string) => string }} props - framework props; `t` is bound to this plugin's namespace.
      */
     function WorkspaceMemoryPanel(props) {
-      const t = typeof props.t === 'function' ? props.t : fallback
       const injected = props.__ctx
       const workspacesStore = injected.workspaces && injected.workspaces.list
       const sessionsStore = injected.sessions && injected.sessions.list
+      const localeRuntime = injected.locale
+
+      // Re-render whenever the active UI language changes so every label
+      // re-resolves against the new locale (regional tags like zh-CN are
+      // normalized by the host runtime's own fallback chain: active → en).
+      const localeRevision = useSyncExternalStore(
+        localeRuntime && typeof localeRuntime.subscribe === 'function'
+          ? localeRuntime.subscribe.bind(localeRuntime)
+          : () => () => {},
+        localeRuntime && typeof localeRuntime.getSnapshot === 'function'
+          ? () => localeRuntime.getSnapshot()
+          : () => null,
+      )
+      const t = (key) => {
+        void localeRevision
+        if (typeof props.t === 'function') return props.t(key)
+        if (localeRuntime && typeof localeRuntime.translate === 'function') return localeRuntime.translate(NS, key)
+        return fallback(key)
+      }
 
       const workspaceSnapshot = useSyncExternalStore(
         workspacesStore ? workspacesStore.subscribe.bind(workspacesStore) : () => () => {},
@@ -546,7 +747,7 @@ window.__ModuleLoader__.load({
     return {
       inject: ['slots', 'locale', 'workspaces', 'sessions'],
       apply(ctx) {
-        ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'workspace-memory: dictionaries')
+        ctx.effect(() => ctx.locale.register(NS, DICT), 'workspace-memory: dictionaries')
         const t = ctx.locale.bind(NS)
         // The slot system injects registered components rather than passing the
         // plugin context, so the panel reads its stores through one prop.

package/locale/de.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Arbeitsbereichs-Speicher",
+    "description": "Fügt ein Seitenleisten-Panel hinzu, das die Speicherdateien jedes Arbeitsbereichs auflistet und verwaltet. Die Dateien werden standardmäßig im DSH-Datenverzeichnis gespeichert und ergänzen Dateien wie AGENTS.md."
+  }
+}

package/locale/es.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Memoria del espacio de trabajo",
+    "description": "Añade un panel lateral que enumera y gestiona los archivos de memoria adjuntos a cada espacio de trabajo, guardados por defecto en el directorio de datos de DSH como complemento de archivos como AGENTS.md."
+  }
+}

package/locale/fr.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Mémoire de l’espace de travail",
+    "description": "Ajoute un panneau latéral qui liste et gère les fichiers de mémoire attachés à chaque espace de travail, stockés par défaut dans le répertoire de données de DSH en complément de fichiers comme AGENTS.md."
+  }
+}

package/locale/ja.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "ワークスペースメモリ",
+    "description": "サイドバーパネルを追加し、各ワークスペースに紐づくメモリファイルを一覧・管理します。ファイルは既定で DSH データディレクトリに保存され、AGENTS.md などのファイルを補完します。"
+  }
+}

package/locale/pt.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Memória do espaço de trabalho",
+    "description": "Adiciona um painel lateral que lista e gerencia os arquivos de memória anexados a cada espaço de trabalho, salvos por padrão no diretório de dados do DSH como complemento de arquivos como o AGENTS.md."
+  }
+}

package/locale/ru.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Память рабочей области",
+    "description": "Добавляет панель боковой колонки со списком файлов памяти каждой рабочей области и управлением ими. Файлы по умолчанию хранятся в каталоге данных DSH и дополняют такие файлы, как AGENTS.md."
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-workspace-memories",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "Per-workspace persistent memory for DeepSeek Harness: a sidebar panel to manage Markdown memory files, automatic injection into every session of the workspace, and an agent tool to save new memories",
   "type": "module",
   "license": "MIT",