fsviewer
dsh web 的右侧文件管理器：目录树 + 文件预览（Markdown 渲染 / 源码），接管原生 details 右栏。
⚠️ 安全提示： 这是本机个人工具。host 半边通过 /fsviewer-api 路由直接用 Node fs 读取本机任意绝对路径，无任何鉴权（与 dsh 原生 browse 目录后端同级）。请勿在多用户或网络暴露的环境中使用。
目录
环境要求
- Node.js 18+
- 已安装并配置
web profile 的 dsh（DeepSeek Harness）
- 该 profile 以 pnpm 管理依赖
安装
- 获取插件源码（任选其一）：
- 把插件链接进 dsh 的 web profile。编辑
~/.dsh/profiles/web/package.json：
{
"dependencies": {
"fsviewer": "link:YOUR_PLUGIN_PATH"
},
"dsh": {
"profile": {
"bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "fsviewer"]
}
}
}
- 安装依赖（web profile 使用 pnpm）：
cd ~/.dsh/profiles/web && pnpm install
安装后请确认 node_modules/fsviewer 符号链接存在：ls node_modules/fsviewer
- 重启
dsh web：
dsh web
插件自带的 cordis.patch.yml 会经 dsh.bundle.patch 自动并入 profile 加载层，无需手动改动；更完整的安装与 browse 后端说明见 INSTALL.md。
使用
- 进入任一会话，点击顶部 Session log 导出按钮右边的「右侧栏」图标按钮，面板接管原生右侧
details 栏并滑入。
- 右侧文件树栏：点击 ▸ 展开目录、点击目录名进入；筛选框按名称过滤；拖拽左缘调整树栏宽度（120–320px），点文件夹图标可收起/展开树栏。
- 点击文件：左侧预览区渲染内容。Markdown 文件可切「查看源代码 / 渲染视图」；文本文件显示源码；二进制或超大文件给出提示并提供「⧉ 打开」用系统应用打开。
- 顶部「⧉ 打开」按钮用系统默认应用打开当前文件；「⤢」按钮在默认宽度（360px）与加宽（520px）间切换。
- 会话中点击文件引用（如工具产出的路径）会改道到本面板预览，而非弹出系统选择框。
- 再次点击顶部按钮（或面板内「打开文件」伪页签的 ×）收起面板；切换会话时自动收起。
功能特性
- 🗜 接管原生右栏：渲染在 dsh 原生
details 列内（priority -10 影子注册），与布局/主题一致；插件停用后原生工具详情自动恢复。
- 🌲 目录树 + 文件列表：host 路由真实列举目录与文件（含类型徽章、隐藏项标记），懒加载、名称筛选。
- 👁 文件预览：Markdown 用官方
MarkdownText 渲染并支持源码切换；文本显示源码；二进制 / 超大文件给出提示并提供系统打开。
- 📑 多文件页签：已打开文件以页签呈现，可切换 / 关闭。
- 📋 复制内容：预览区一键复制文件全文。
- 🧭 面包屑 + 智能默认根：默认根优先取当前会话工作目录（cwd），回退到最近 workspace；面包屑可回退。
- 🗂 按工作区彻底隔离：页签 / 文件树展开 / 树栏开关与宽度 / 浏览器页签 / 侧边聊天（含历史）均按
workspaceId 独立存储；切换工作区（侧边栏换会话、工作区选择器、存储装载）整体切换面板，原地恢复各自状态。
- 🖱 会话文件引用改道：拦截
workspaces.openPath，会话内点击文件直接在本面板预览。
- 🎨 明暗主题自适应：配色全部走 dsh 主题变量。
架构
插件由**浏览器端（client）**与 **host 端（Node）**两部分组成：
- Client（
src/client.js，经 npm run build 生成 lib/client.js）：由 dsh 浏览器模块图加载，注册顶部按钮与 details 面板；目录 / 文件数据通过同源 fetch 调用 host 路由。
- Host（
src/index.js，Cordis 插件入口）：通过官方 ctx.webServer.register 注册前缀路由 /fsviewer-api：
GET /fsviewer-api/list?path=<绝对路径> —— 列目录（目录 + 文件，含 type / hidden 标记，单目录最多 1000 项）GET /fsviewer-api/file?path=<绝对路径> —— 读文本文件（1MB 上限，前 8KB 含 NUL 判为二进制，超大文件截断并返回 truncated）
数据读取由 host 直接用 Node fs 完成，不依赖 dsh 的 browse 目录能力；仅「选择目录 / 系统打开」复用 dsh 的 workspaces 服务。
已知限制
- host 路由无鉴权，可读取本机任意绝对路径（见上方安全提示）。
- 单目录最多列举 1000 项，超出截断。
- 文件预览上限 1MB；超出部分截断显示，不返回二进制内容。
- 「选择目录」走 dsh 原生目录选择器，其行为受 profile 的 directory-picker 后端配置影响（详见 INSTALL.md）。
许可证
MIT
