dsh-linked-workspace 0.5.12 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.6.0 — 2026-11-05
+
+- **Document editing in the content panel** for Markdown, PDF, DOCX, XLSX and PPTX, on both local and remote files.
+  - Markdown: raw editing, rendered preview, export to PDF.
+  - DOCX: paragraph and table text editing (styles are preserved at paragraph level; rich inline formatting may be simplified).
+  - XLSX: sheet tabs and editable cell grid; formulas and untouched styles are preserved.
+  - PPTX: slide navigation and text-frame editing.
+  - PDF: page navigation, rotate/delete page, title/author metadata; page images are rendered by PyMuPDF.
+- New document files can be created from the directory context menu (`.md`, `.pdf`, `.docx`, `.xlsx`, `.pptx`).
+- A small Python bridge (`scripts/doc_tool.py`) implements the format-specific read/write/create operations. Python 3 with `python-docx`, `openpyxl`, `python-pptx` and `PyMuPDF` is required for Office/PDF operations; Markdown works without them.
+- Runs on both local folders and remote linked/directories (remote files are downloaded, processed and uploaded atomically).
+
+## 0.5.13 — 2026-11-05
+
+- The linked-workspace directory panel can now be resized by dragging the divider; double-click the divider to reset to 300 px. The width is persisted.
+- The local directory tree now refreshes silently every 4 seconds (and on window focus), so newly created local subdirectories appear without a manual refresh; expanded folders are reloaded in place.
+
 ## 0.5.12 — 2026-11-04
 
 - Published as **dsh-linked-workspace** on npm (public).

package/README.en.md

@@ -28,6 +28,18 @@ The plugin takes over the directory-selection hole used by the DSH sidebar and e
 1. **Local workspace**: enter or browse for a local directory (C:/D:/E: drive chips on Windows), set a workspace name, then create a normal DSH workspace.
 2. **Linked workspace**: SSH host + remote folder + local folder + optional mirror. Creating it also registers the local folder as a DSH workspace. The local directory is **not** pre-populated with `.local`/`.remote`; those are created lazily when mirroring or transfers need them.
 
+### Document editing
+
+The content panel now edits **Markdown / PDF / DOCX / XLSX / PPTX** files on both local and remote sides:
+
+- **Markdown**: raw editing, rendered preview, export to PDF.
+- **DOCX**: edit paragraph and table text; paragraph styles are kept, complex inline formatting may be simplified.
+- **XLSX**: switch sheets and edit a cell grid; untouched formulas and styles are preserved.
+- **PPTX**: navigate slides and edit text frames.
+- **PDF**: page navigation, rotate/delete pages, and title/author metadata; pages are rendered by PyMuPDF.
+- Create blank documents from the directory context menu by using one of these extensions.
+- Office/PDF operations need Python 3 with `python-docx`, `openpyxl`, `python-pptx` and `PyMuPDF`; Markdown does not. Set `DSH_OFFICE_PYTHON` to choose an interpreter.
+
 ### Right-sidebar entries
 
 - **Linked workspace directory**: appears only in sessions of a linked workspace, and opens the linked workspace bound to that session. Remote and local files are editable.
@@ -82,7 +94,13 @@ The remote side is not modified by mirroring. The `linked_workspace` tool suppor
 
 ## Installation
 
+```bash
+dsh plugin --profile web add dsh-linked-workspace
 ```
+
+Install from source (development):
+
+```bash
 dsh plugin --profile "$DSH_PROFILE" add "file:$PWD/dsh-linked-workspace"
 ```
 
@@ -99,6 +117,10 @@ Old “Remote directories” tabs are restored after refresh through hidden lega
 
 See [CHANGELOG.md](CHANGELOG.md) for the full version history.
 
+### 0.5.13
+
+The directory panel divider is draggable (double-click resets to 300 px; width persists). The local tree refreshes silently every 4 seconds and on window focus, so new local subdirectories appear without a manual refresh.
+
 ## Releases and marketplace updates
 
 - The npm package is `dsh-linked-workspace`. To release, bump `package.json` and push a `v*` tag; `.github/workflows/release.yml` runs `npm publish --access public` (set an `NPM_TOKEN` repository secret).

package/README.md

@@ -29,6 +29,18 @@
 
 > 左侧工作区行不再带 `⇄` 标题前缀：插件用一份按 `data-row-key` 定位的样式表，把联动工作区行的宿主文件夹图标替换成**链环图标**（普通本地工作区不受影响）。这是对宿主行结构的唯一 DOM 级适配；如果 DSH 以后更改行结构，选择器会自然失配并回退到原来的文件夹图标，不破坏其他功能。
 
+### 文档创建与编辑
+
+文件内容面板现在支持 **Markdown / PDF / DOCX / XLSX / PPTX**（本地与远程文件均可）：
+
+- **Markdown**：原始文本编辑、渲染预览、导出 PDF。
+- **DOCX**：按段落与表格编辑文字；保留段落样式，复杂行内格式可能被简化。
+- **XLSX**：工作表切换与单元格网格编辑；未修改的公式与样式保留。
+- **PPTX**：幻灯片切换与文本框编辑。
+- **PDF**：翻页、旋转/删除页面、编辑标题/作者元数据；页面由 PyMuPDF 渲染。
+- 在目录右键「新建文件」中输入支持的扩展名即可创建对应空白文档。
+- Office/PDF 操作需要 Python 3 及 `python-docx`、`openpyxl`、`python-pptx`、`PyMuPDF`；Markdown 不依赖 Python。可通过 `DSH_OFFICE_PYTHON` 指定解释器。
+
 ### 右侧栏入口
 
 - **联动工作区目录**：只在联动工作区的会话中出现；点开后绑定该会话对应的联动工作区（不会打开另一个联动工作区），可编辑远程与本地文件。

package/docs/API.md

@@ -16,6 +16,16 @@ Codes: `BAD_REQUEST`, `NOT_FOUND`, `SSH_CONNECT`, `AUTH_FAILED`,
 `HOST_KEY_MISMATCH`, `TIMEOUT`, `FS_NOT_FOUND`, `FS_PERMISSION`, `FS_IS_DIR`,
 `FS_NOT_DIR`, `FS_TOO_LARGE`, `CONFLICT`, `INTERNAL`.
 
+## Document APIs
+
+| Method | Params | Result |
+| --- | --- | --- |
+| `docs.read` | `{ path, linkedId?, workspaceId? }` | kind-specific document model |
+| `docs.write` | `{ path, data, expectedMtime?, linkedId?, workspaceId? }` | `{ kind, path, size, mtime }` |
+| `docs.create` | `{ path, kind?, linkedId?, workspaceId? }` | `{ kind, path, size, mtime }` |
+| `docs.mdPreview` | `{ path, text?, linkedId?, workspaceId? }` | `{ kind, html }` |
+| `docs.mdPdf` | `{ path, text?, linkedId?, workspaceId? }` | `{ kind: "pdf", path, size, mtime }` |
+
 ## Records
 
 ```ts