🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI

侧栏文件树 Fallen0543/dsh-sidebar-files

DeepSeek Harnessv0.1.0
Fallen054380 天前有提交已提供中文文档扫描:含敏感能力

在侧边栏浏览工作区文件并一键发给 Agent

32.8/100
综合分
3
GitHub 星标
111
npm 周下载
—/5
用户评分

数据截至 2026/9/19 · 周下载取自 npm 全网(含 CI / 镜像),非本站安装数;综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎
dsh plugin --profile web add dsh-sidebar-files
npm 源 · dsh-sidebar-files 的发布者账号已校验与本仓库一致

状态速览

判定依据:实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态
信任档位:仅索引
是什么
dsh 原生插件 · browser
装得上吗
静态安装检查通过
未做真实安装
L4 · 真实安装等级说明 →
安全吗
本站尚未对该插件做风险分级
暂未覆盖,不等同于无风险
还在维护吗
更新放缓:最近一次提交在 80 天前
档位由哪些信号合成

本站实装验证(真实安装 L4 覆盖全站;L5 为运行时冒烟或实机截图,覆盖范围小于 L4) · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。

验证判据与等级说明 →
社区实装还没有人打卡 · 装过的第一个就是你
安装兼容性检查✓ 自动检查通过
展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

✓npm 包dsh-sidebar-files @ 0.1.0
✓Node 引擎要求 ^22.19.0 || >=24.0.0 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明

验证方式:npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/17 16:43:26

安全扫描自动 · 静态分析源码
v2.7.0
🔵 扫描:含敏感能力尚无人工评估
展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力:执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量(至少其一)。这是能力清单,不是危险判定——具体能力项与证据见下方,安装前请自行判断是否需要。

读写/删除本地文件发起外部网络请求
查看扫描证据(共 5 处,展示前 5 条)
  • 读取本地文件
    lib/index.js:49
    const opening = opendir(target);
  • 读取本地文件
    lib/index.js:111
    isDirectory: (await stat(path)).isDirectory()
  • 发起网络请求
    src/client/index.ts:83
    const response = await fetch(`${ROUTE_PREFIX}/list?path=${encodeURIComponent(path)}`, { signal })
  • 读取本地文件
    src/list.ts:88
    const opening = opendir(target)
  • 读取本地文件
    src/list.ts:131
    return { name: candidate.name, path, hidden, isDirectory: (await stat(path)).isDirectory() }
扫描于 2026/11/3(0 天前) · 范围 入口闭包 + 全包扫描 · 来源 npm 发布包

静态扫描只反映源码中出现的调用,不构成安全背书;人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块
@deepseek-ai/dsh-client-ui-slots@deepseek-ai/cordis@deepseek-ai/dsh-client-locale@deepseek-ai/dsh-client-runtime@deepseek-ai/dsh-client-ui-primitives@deepseek-ai/dsh-client-ui-sidebar@deepseek-ai/dsh-host-webserver
给这个插件打分还没有人投票↓
用户评分
还没有人投票,来当第一个

界面预览

3 张 · 点击查看大图

功能亮点

  • 侧栏浏览工作区文件
  • 懒加载文件树
  • 一键发送给Agent

DeepSeek Harness 侧边栏文件树插件:会话/文件标签栏 + 懒加载文件树,按扩展名显示彩色图标,支持复制路径、发送给智能体。

README

由 DeepSeek 最新模型翻译生成
dsh-sidebar-files npm version License: MIT 为 DeepSeek Harness 提供侧边栏文件树插件:在左侧边栏加入 会话 / 文件 标签栏,并在工作区内联渲染按需懒加载的文件树 —— 支持按扩展名区分的彩色图标、复制路径、发送给 Agent 阅读等操作。 侧边栏中的文件标签 悬停文件行即可使用两个操作 —— 复制路径 与 发给 Agent 读: 复制路径发给 Agent 读 插件状态。 已针对发布版 harness(0.1.0-rc.6,web profile)构建并验证。插件完全以树外 bundle 运行:Node 端通过自身的 HTTP 路由提供目录列表,浏览器端负责渲染文件树。无需修改核心代码。 功能特性 - 会话 / 文件标签栏:注入到「新建会话」按钮下方(宽侧边栏)。文件树内嵌渲染在侧边栏区域中 —— 与 harness 自带浏览界面的呈现方式一致。 - 按需懒加载:按需拉取单个目录层级(打开时拉取工作区根目录,首次展开时拉取子目录),通过插件自身的 GET /dsh-sidebar-files/list?path=… 路由实现,网络开销只跟随实际展开的内容。 - 按扩展名图标:为常见扩展名(ts/js/json/yml/yaml/css/html/md/ico/png/zip/log/…
展开完整文档(README 剩余 1 节)
dsh-sidebar-files

npm version
License: MIT

为 DeepSeek Harness 提供侧边栏文件树插件:在左侧边栏加入 会话 / 文件 标签栏,并在工作区内联渲染按需懒加载的文件树 —— 支持按扩展名区分的彩色图标、复制路径、发送给 Agent 阅读等操作。

侧边栏中的文件标签

悬停文件行即可使用两个操作 —— 复制路径 与 发给 Agent 读:

复制路径发给 Agent 读

插件状态。 已针对发布版 harness(0.1.0-rc.6,web profile)构建并验证。插件完全以树外 bundle 运行:Node 端通过自身的 HTTP 路由提供目录列表,浏览器端负责渲染文件树。无需修改核心代码。

功能特性

- 会话 / 文件标签栏:注入到「新建会话」按钮下方(宽侧边栏)。文件树内嵌渲染在侧边栏区域中 —— 与 harness 自带浏览界面的呈现方式一致。
- 按需懒加载:按需拉取单个目录层级(打开时拉取工作区根目录,首次展开时拉取子目录),通过插件自身的 GET /dsh-sidebar-files/list?path=… 路由实现,网络开销只跟随实际展开的内容。
- 按扩展名图标:为常见扩展名(ts/js/json/yml/yaml/css/html/md/ico/png/zip/log/…)提供 47 个品牌风格图标,另有通用文档图标兜底。图标路径数据来自 Material Icon Theme(MIT,© Material Extensions 2025)—— 见 LICENSE。
- 默认隐藏项:以点开头的名称、node_modules、.git 默认过滤;「显示隐藏项」开关可将其显示。node_modules/.git 在开关打开前始终保持隐藏。
- 行操作(悬停显示):复制路径(带 1 秒「已复制」反馈)、将文件发送给当前会话的 Agent(入队的「请读取该文件」提示)。
- 健壮的降级方案:若未来 shell 的侧边栏结构无法识别,插件会自动降级为底部操作按钮 + 居中弹窗,而不是标签栏 —— 绝不会白屏。
- 双语支持(中文 / English),跟随 harness 的本地化。

安装

需要 dsh CLI(npm i -g @deepseek-ai/dsh)和 pnpm。

什么是 profile? profile 是 harness 的一种可运行组合 —— 一个带独立插件集的具名实例。profile 存放在 $DSH_HOME/profiles/ 下(例如 ~/.dsh/profiles/web)。--profile 告诉 dsh CLI 要操作哪个实例;请把 换成你自己的名字(最常见的例子是 web)。

在任意目录 —— 从 npm 安装已发布版本
dsh plugin --profile web add dsh-sidebar-files

如果这个名字的 profile 还不存在,命令会在首次使用时自动初始化。用同一个 profile 名重启 harness,侧边栏即出现 会话 / 文件 标签:

dsh --profile web

如果 profile 是全新创建的,请先添加 web 应用 bundle:dsh plugin --profile web add @deepseek-ai/dsh-web-app@0.1.0-rc.6(或直接使用 CLI 自带的 web profile 模板)。

备选安装方式

本地检出或预构建 tarball(无需 registry):

dsh plugin --profile web add ./dsh-sidebar-files # 本地检出(使用 prepare 构建)
dsh plugin --profile web add ./dsh-sidebar-files-0.1.0.tgz # 预构建 tarball

从 GitHub(github:Fallen0543/dsh-sidebar-files)安装会拉取源码;包的 prepare 脚本随后会从源码自包含地构建 lib/(无需 monorepo 检出)。pnpm ≥10 默认拒绝运行 git 依赖的 prepare 脚本,需要先将其加入白名单 —— 将 pnpm 打印的包键复制到 profile 的 pnpm-workspace.yaml:

allowBuilds:
dsh-sidebar-files: true

然后重新执行 add。请只信任来源可信的包,并建议固定提交(github:Fallen0543/dsh-sidebar-files#)。从 npm 或 tarball 安装则无需任何构建授权。

开发

pnpm install
pnpm test # 单元测试:列表逻辑、侧边栏宿主探测/注入、面板行为
pnpm run typecheck
pnpm run build # lib/index.js(Node)+ lib/client.js(浏览器 bundle)

浏览器 bundle 是 CommonJS 闭包工厂产物(window.__ModuleLoader__.load({…})),harness 的平台模块保持外部引用,因此可通过 Web shell 的模块表加载;CSS modules 使用 lightningcss 编译。

工作原理

- cordis.patch.yml 插入一行宿主配置(id: sidebar-files)以挂载 Node 端。
- Node 端(src/index.ts)注册 Web 服务器路由前缀 /dsh-sidebar-files;GET /list?path= 列出单层目录(目录优先、再文件;最多前 1000 项)并返回 { path, entries, truncated } —— 错误返回 400 及机器可读错误码。
- 浏览器端(dsh.client 声明,./client 导出)先注册到 harness 的 sidebar.footer.action 槽位,然后在运行时从自身的触发按钮向上定位侧边栏列,注入「会话 / 文件」标签栏和内联文件树区域(见 src/client/sidebar-host.ts)。当 shell 结构无法识别时,由底部按钮 + 弹窗兜底。
- 活动工作区路径从会话/工作区存储推导(当前会话所属工作区,否则最近工作区,否则第一个),通过选择器钩子实现,与 harness 自带浏览界面完全一致。

许可证

MIT —— 见 LICENSE。文件类型图标字形衍生自 Material Icon Theme(MIT,© Material Extensions 2025);署名与版权声明保留在 src/client/file-type-icons.tsx 中。
预览分享卡片长什么样 ↓Fallen0543/dsh-sidebar-files
分享 · DeepSeek Harness Hub
Fallen0543/dsh-sidebar-files

在侧边栏浏览工作区文件并一键发给 Agent

这是你的仓库?认领条目

回到顶部