@lijian-ui/dsh-file-manager 0.1.20

package/LICENSE

@@ -0,0 +1,38 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, dsh-web-ui contributors
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice,
+   this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors
+   may be used to endorse or promote products derived from this software
+   without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+
+---
+
+Attribution notice: this package is a re-implementation of the right-panel
+system of AionUi (iOfficeAI/AionUi, https://github.com/iOfficeAI/AionUi),
+licensed under the Apache License 2.0. Pixel measurements, layout parameters
+and interaction behavior were re-derived from AionUi v2.1.53 during research;
+no substantial portions of AionUi source code are copied. The upstream
+project's copyright and license remain with its authors.

package/README.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n.md): the git blob hash of each
+# side as of the last confirmed-consistent state. Both languages carry equal authority;
+# after editing either side, bring the other along and re-record with:
+#   node scripts/verify-docs.mjs --write <dir>
+README.md: f1a7fe1e4759e1cf24fa4e13092304417c5c5306
+README.zh.md: 6c599be2f2a408f2be327a6b4cc1b12e355c352c

package/README.md

@@ -0,0 +1,66 @@
+# dsh-file-manager — Right-panel file manager + `@` file references for the DSH web GUI
+
+[English](README.md) | 中文 ([README.zh.md](README.zh.md))
+
+> A plugin for the DeepSeek Harness desktop shell (`dsh web`): an **Explorer file panel + Preview panel** on the right of the chat area (a pixel-faithful re-implementation of FileManager, Apache-2.0 reference, not a copy), plus **`@` file references** in the composer (tree multi-select modal + in-composer chips with line numbers). Everything is driven by the real filesystem and real git — no mocks.
+
+## Features
+
+### Right panels
+
+- **Explorer (rightmost column)**: `Files / Changes` tabs.
+  - File tree: click to expand/collapse folders, open files; filename search on top (150ms debounce, click-to-locate).
+  - Git changes: real `git status` (porcelain v1 -z) with stage / unstage / discard (untracked → delete, tracked → restore; batch discard requires confirmation).
+  - Tree context menu: copy path, copy name, reveal in file manager, open with default app, rename, new file, new folder, delete (double-confirmed).
+  - Drag a file row into the composer to insert its relative path into the draft.
+- **Preview (second-right column)**: multi-tab preview for markdown / html / code / diff / csv / pdf / word / excel / ppt / image / text / url. Source/preview toggle, split editing (persisted ratio), save (mtime conflict detection), download, refresh, middle-click close, right-click batch close.
+- **Mermaid**: ```mermaid blocks in markdown preview render as charts; the runtime ships inside the plugin (same-origin, offline-capable, follows the theme).
+- Dark/light themes, per-project persisted preferences, master switch (Settings → Web UI plugins).
+
+### `@` file references (highlight)
+
+Typing `@` in the composer opens a **pi-desktop-style tree multi-select modal** (lazy directory tree + filename search + checkboxes):
+
+- Picked files/directories land as **in-composer chips** (green `</>` glyph + basename + line range); the reference text stays hidden and is only serialized to `@<relative-path>:<lines>` plain text on send.
+- **Line numbers**: a full-file reference carries the file's line count (`@path:1-N`); selecting a code range in the preview and clicking **Add to chat** produces a chip with just that range (`@path:start-end`).
+- Chips are native dsh reference objects (not text decoration): Backspace deletes the whole chip, copy/paste keeps semantics, submit serializes through the plugin's registered `file` reference codec.
+- Directory references use plain `@path/ ` text (no line concept).
+
+## Install
+
+```sh
+# From npm (once published)
+dsh plugin --profile web add @lijian-ui/dsh-file-manager
+
+# Direct link from this repo (dev/onboarding; lib/ is committed, clone-and-use)
+git clone https://github.com/lijian-ui/dsh-file-manager.git
+cd dsh-file-manager
+dsh plugin --profile web add link:$(pwd)
+```
+
+Restart `dsh web` after installing; open a project session to see the panels, and type `@` in the composer for file references.
+
+> The desktop shell (dsh-desktop) develops against this via a local symlink (`node_modules/@lijian-ui/dsh-file-manager → extensions/file-manager`); after editing the source, `npm run build` regenerates `lib/`, then restart dev.
+
+## Architecture
+
+- **Host half** (`src/index.ts` + `src/host/`): a cordis plugin exposing `/filemgr/*` HTTP routes — directory listing, file read (80k char text cap / image data URLs), write (mtime conflict detection), filename search, git status / stage / unstage / discard, and an SSE change stream. Every operation passes a **workspace gate** (realpath normalization + prefix check) and is **loopback-only**.
+- **Browser half** (`src/client/`): framework-free state core (`store.ts`), drag engine (`drag.ts`), DOM layout controller (`layout.ts` — appends panel tracks to the shell's 3-column grid), React components (explorer / scm / preview / picker).
+  - `picker/FilePickerModal.tsx` — the `@` tree multi-select modal (bridge + modal; opens on a bare `@` in the composer).
+  - `file-source.ts` — registers the `file` input-trigger source (codec only; inert in the trigger menu).
+  - `reference.ts` — chip insertion (`slash/input-insert-reference` bail; `@path:lines` serialization).
+  - `preview/selection.ts` — preview selection → line-range mapping.
+  - `styles/chip.module.css` — chip visuals (muted rounded pill + green `</>` glyph, global override of `[data-decoration="chip"]`).
+- **Workflow**: after editing, `npm run build` (regenerates `lib/`) AND a dev restart are both required — neither substitutes for the other.
+
+## Build
+
+```sh
+npm install
+npm run build      # tsc -b + tsdown → lib/
+npm run test       # vitest
+```
+
+## Attribution
+
+This project is a re-implementation of FileManager (iOfficeAI/FileManager, Apache-2.0): dimensions, colors, motion, and interaction parameters were measured from v2.1.53; the implementation is new code and does not reproduce upstream source. Upstream copyright belongs to the FileManager project; this project retains attribution per the Apache-2.0 license.

package/README.zh.md

@@ -0,0 +1,66 @@
+# dsh-file-manager — DSH Web GUI 右侧文件管理面板 + `@` 文件引用
+
+[English](README.md) | 中文
+
+> 为 DeepSeek Harness 桌面端（`dsh web`）开发的插件：聊天区右侧的 **Explorer 文件面板 + Preview 预览面板**（FileManager 风格，Apache-2.0 参考实现非抄录），以及输入框 **`@` 引用项目文件**（树形多选弹窗 + 输入框内胶囊 + 行号）。数据全部来自真实文件系统与真实 git 仓库，无 mock。
+
+## 功能
+
+### 右侧面板
+
+- **Explorer（最右栏）**：`文件 / 变更` 双 tab。
+  - 文件树：整行点击展开/收起目录、打开文件；顶部文件名搜索（150ms 防抖，点击结果定位到树）。
+  - Git 变更：读取真实 git status（porcelain v1 -z），支持 stage / unstage / discard（untracked 走删除、tracked 走 restore，批量放弃有确认）。
+  - 文件树右键菜单：复制路径、复制名称、在文件管理器中显示、用默认应用打开、重命名、新建文件、新建文件夹、删除（二次确认）。
+  - 拖拽文件行到聊天输入框，即把相对路径插入草稿。
+- **Preview（右二栏）**：多 tab 预览，支持 markdown / html / code / diff / csv / pdf / word / excel / ppt / 图片 / 文本 / url。源码/预览切换、分屏编辑（比例持久化）、保存（mtime 冲突检测）、下载、刷新、中键关闭、右键批量关闭。
+- **Mermaid 图表**：markdown 预览中的 ```mermaid 代码块渲染为图表，运行时打包在插件内（同源提供、离线可用、跟随主题）。
+- 明暗主题跟随、偏好按项目隔离持久化、总开关（设置 → Web UI 插件）。
+
+### `@` 文件引用（重点）
+
+在聊天输入框输入 `@` 打开 **pi-desktop 风格树形多选弹窗**（懒加载目录树 + 文件名搜索 + 复选框多选）：
+
+- 选中文件/目录 → 输入框内出现**胶囊**（绿色 `</>` 图标 + 文件名 + 行号），引用文字隐藏，发送时才还原为 `@相对路径:行号` 纯文本发给模型。
+- **行号**：文件引用自动携带整个文件的行数（`@path:1-N`）；在预览面板**选中代码片段**再点「添加到对话」，胶囊只携带选中区域的行号（`@path:start-end`）。
+- 胶囊是 dsh 原生引用对象（非文字装饰）：Backspace 整删、复制/粘贴保留语义、发送时经插件注册的 `file` 引用 codec 序列化。
+- 目录引用为 `@路径/` 纯文本（目录无行号概念）。
+
+## 安装
+
+```sh
+# 从 npm（发布后）
+dsh plugin --profile web add @lijian-ui/dsh-file-manager
+
+# 从仓库直接 link（开发/联调，clone 即可用，lib 已构建入库）
+git clone https://github.com/lijian-ui/dsh-file-manager.git
+cd dsh-file-manager
+dsh plugin --profile web add link:$(pwd)
+```
+
+安装后**重启 `dsh web`**，打开项目会话即可看到聊天区右侧面板；在输入框输入 `@` 体验文件引用。
+
+> 桌面壳（dsh-desktop）开发期以本地 symlink 联调：`node_modules/@lijian-ui/dsh-file-manager → extensions/file-manager`，源码改动后 `npm run build` 重新生成 `lib/`，重启 dev 生效。
+
+## 架构
+
+- **host 半区**（`src/index.ts` + `src/host/`）：cordis 插件，经 `/filemgr/*` HTTP 路由提供目录列举、文件读取（文本 80k 字符上限 / 图片 data URL）、写入（mtime 冲突检测）、文件名搜索、git status / stage / unstage / discard、SSE 变更流；所有操作过**工作区门卫**（realpath 规范化 + 前缀校验）且**仅限 loopback**。
+- **browser 半区**（`src/client/`）：框架无关状态核心（`store.ts`）、拖拽引擎（`drag.ts`）、DOM 布局控制器（`layout.ts`，向 shell 三栏 grid 追加面板轨道）、React 组件（explorer / scm / preview / picker）。
+  - `picker/FilePickerModal.tsx` — `@` 树形多选弹窗（bridge + modal，监听输入框裸 `@` 打开）。
+  - `file-source.ts` — 注册 `file` 输入触发 source（仅提供引用 codec，惰性菜单参与者）。
+  - `reference.ts` — 引用胶囊插入（`slash/input-insert-reference` bail，`@path:lines` 序列化）。
+  - `preview/selection.ts` — 预览选区 → 行号区间换算。
+  - `styles/chip.module.css` — 胶囊视觉（浅灰圆角 + 绿色 `</>` 图标，全局覆盖 `[data-decoration="chip"]`）。
+- **工作流约定**：改插件后必须 `npm run build`（重生成 `lib/`）再重启 dev，二者缺一不可。
+
+## 构建
+
+```sh
+npm install
+npm run build      # tsc -b + tsdown → lib/
+npm run test       # vitest
+```
+
+## 署名
+
+本项目是 FileManager（iOfficeAI/FileManager，Apache-2.0）右侧面板系统的复刻实现：尺寸、颜色、动效、交互参数来自对 v2.1.53 的实测调研，实现为全新代码，未大段抄录源码。上游版权归 FileManager 项目所有，本项目按 Apache-2.0 约定保留署名。

package/cordis.patch.yml

@@ -0,0 +1,13 @@
+# dsh-filemgr bundle patch: inserts the dual-face plugin row into the web
+# profile roster. Applied as a profile bundle layer (the `dsh.bundle.patch`
+# manifest field); install with
+# `dsh plugin --profile web add link:<repo>/packages/dsh-filemgr`.
+#
+# The row is a bare plugin by package name: the node half (exports ".") runs
+# in the host process (workspace-gated fs/git services + /filemgr routes),
+# and the `dsh.client` declaration in package.json makes the browser half
+# (exports "./client", served at /plugins/ui-dsh-filemgr/client.js) load
+# in the web GUI.
+- insert:
+    - id: ui-dsh-filemgr
+      name: '@lijian-ui/dsh-file-manager'