DSH sidebar file-activity tab: records file reads/creates/modifies by the agent and the sidebar (including file ops hidden inside bash commands), per-session isolation, survives restarts, click a file for a floating preview (npm: `dsh-file-activity`).
Install
# from npm (prebuilt)
dsh plugin --profile web add dsh-file-activity
# from a prebuilt release tarball
dsh plugin --profile web add "https://github.com/baosfeng/my-dsh-plugins/releases/download/dsh-file-activity@v0.5.1/dsh-file-activity-0.5.1.tgz"
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:baosfeng/my-dsh-plugins#path:/plugins/dsh-file-activity
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
dsh-file-activity：DSH 侧边栏文件活动插件（宿主原生侧边栏扩展点，零第三方侧边栏依赖）——在右侧边栏新增「文件活动」页签，记录 agent 工具与插件自身路由的文件读取/新增/修改事件，提供最近访问（LRU）与文件统计（树形目录）两块视图，点击文件弹出浮窗预览。
功能
- 最近访问：按 LRU 记录文件读取/新增/修改事件（agent 工具读写 + 侧边栏打开/编辑保存），每会话最多 5 条、同一文件只出现一次（再次访问移到最前）；区块标题可折叠，点击文件弹出浮窗预览。
- 文件统计：按文件绝对路径组织成树形目录，每个文件显示「读取/新增/修改」次数与相对时间（悬停看完整时钟时间）；连续单子目录压缩为点号标签（
a/b/c→a.b.c），文件夹行可展开/收起。 - 默认启用：页签注册后默认开启，且每个会话首次打开时自动打开本页（开关见「配置」）。
- 浮窗预览：按后缀渲染——代码（宿主 CodeBlock 组件，取不到时退回纯文本
<pre>）/ Markdown（宿主官方渲染器）/ 图片 / PDF（浏览器原生查看器）/ 沙箱 HTML；点击窗外、按Esc或点×关闭，长内容窗内滚动。 - 工作区外文件也能预览：字节（图片 / PDF / HTML）与文本（Markdown / 代码）都先走插件自身媒体路由，按
(sessionId, path)授权（只放行本会话记录过的路径，未记录一律 403）；插件拒绝该路径时才回退宿主fs.read。 - 会话隔离：按会话分桶存储与展示，新建/切换会话立即显示该会话数据，DSH 重启后历史自动恢复。
- bash 命令文件触碰：解析 bash 工具调用里可静态确定的写 / 删操作（rm / touch / tee / mv / cp / install / sed -i）并计入；解析不确定的（
-t重定位、未知命令）不记录，git 等未映射命令不跟踪。
安装
💡 npm 安装（普通用户推荐）：
dsh plugin --profile web add dsh-file-activity --trust-lockfile——无需克隆本仓库；依赖自动级联安装（dsh-shared是唯一 dependencies，侧边栏能力全部来自宿主原生扩展点）。
# 方式一：dsh plugin（推荐）
git clone https://github.com/baosfeng/my-dsh-plugins.git
dsh plugin --profile web add link:<仓库路径>/plugins/dsh-file-activity
# 方式二：手动 —— 在 profile package.json dependencies 加
# "dsh-file-activity": "link:<仓库路径>/plugins/dsh-file-activity"
# 再 pnpm install，并在 cordis.patch.yml 加 id: file-activity / name: 'dsh-file-activity'
装完硬刷新浏览器（Cmd/Ctrl+Shift+R）。编辑 profile 的 cordis.patch.yml 会经 Cordis HMR 热挂载 server 端，无需重启 dsh web。
使用
- 入口：侧边栏「新标签页」（guide）菜单 → 文件活动，或会话开始自动打开。
- 点击任意文件行 → 浮窗预览，不打开侧边栏编辑器标签。
- 顶部「刷新」手动重载，「清空」删除当前会话全部记录。
- 资源上限：每会话路径 ≤ 300 / 全局 ≤ 20000 / 会话数 ≤ 64，超限按 LRU 淘汰最久未活动条目（非静默丢弃，写 warn 日志）；审计与写盘按增量追加 + 原子 compact，磁盘用量有界。
配置
无 profile 配置项（不读 cordis.patch.yml 的 config）；唯一开关是设置页 UI 偏好：
| 配置项 | 默认 | 作用 |
|---|---|---|
| 会话开始时自动打开（设置 → 插件 → 文件活动） | 开 | 每个会话首次打开时自动显示本页；关闭后仍可从侧边栏「新标签页」菜单手动打开 |
| 右侧边栏默认宽度（设置 → 插件 → 文件活动） | 20% | 启动时按此比例展开右侧边栏（10%–70%）；手动拖拽过宽度后本次运行不再覆盖 |
宽度偏好只在你尚未拖拽时生效（宿主自己给的 45% 默认值也算「已拖拽」之外的空档）。宿主右侧栏下限为 300px，窗口窄于约 1500px 时 20% 会被抬高到 300px——这是宿主 clamp，非本插件行为。
相关文档
→ 文件活动追踪模块文档 · CHANGELOG
Links
More in this category
yjh051108/dsh-routing-suite★ 7014
One repository, three parts: a runtime injector for DSH plugin packages (inject, hot-reload, unload, promote a dev staging tool to the front, route self-heal, plus a settings-page plugin manager that lists, unloads and drags folders in to internalize), a task-aware reasoning-mode router agent preset (router-standard / router-spec / router-react), and a graded two-level task protocol whose six tools (commit_star, lock_stage, revise_do, edit_plan, mark_task, redteam_verdict) pin task state to disk. The injector implementation ships in-tree, so the install carries its own behaviour rather than a dependency list.
strukto-ai/mirage#dsh★ 3682
Swaps the filesystem and bash providers for a mirage virtual workspace: file tools and shell commands run over mounted resources (RAM, S3, Redis, Slack, Gmail, Notion, Postgres) instead of the host disk, with per-mount read/write/exec modes, per-command sandbox routing (monty, pyodide, quickjs in process; docker, e2b, daytona remote), and installed CLIs (git, gh, slack, linear, ntn, gws, or one you register) as head words in the virtual terminal.
hust-open-atom-club/oh-dsh★ 322
Community distribution: TUI, desktop, and Web UI as one bundle with layered installation.
weijiafu14/pi2dsh★ 212
Pi Host ABI compatibility engine: after one install, unmodified Pi extensions from npm mount as native DSH plugins with `dsh plugin add <pi-package>`. Verified end to end on stock DSH with pi-mcp-adapter (full MCP manager: OAuth, resources, prompts, MCP Apps, elicitation, sampling), @tintinweb/pi-subagents, pi-code, pi-hermes-memory and pi-background-tasks; `pi2dsh inspect` reports a package's compatibility before installing.
Fishquito7/dsh-skill-mcp-panel★ 193
Manages DSH skills and MCP servers from the web settings: skill cards with hot enable/disable, workspace scopes, groups, batch migration and drag-and-drop import, plus stdio/HTTP MCP CRUD with connection tests, secret redaction and the unified dsh-panel CLI.
lire1131/dsh-undo-savepoint★ 179
Undo/redo & rollback system for DSH: every config change is auto-snapshotted; undo/redo/restore to any version from the WebUI or the offline CLI/GUI tools (works even when DSH fails to boot).
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.