dsh-file-tracker 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-file-tracker 兼容性怎么样？

尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-file-tracker 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-file-tracker 还在维护吗？

GitHub 2 星。最近一次上游提交在 2026/10/25。

文件活动监视器 Mys12word/dsh-file-tracker

DeepSeek Harness

Mys12word6 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

dsh-file-tracker · 文件活动监视器

31.5/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/10/25 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add Mys12word/dsh-file-tracker

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：已验证

是什么

dsh 原生插件 · dev

装得上吗

本站已在 dsh 0.2.1-rc.2 下真实安装成功

非静态推断

L4 · 真实安装等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

活跃：最近一次提交在 6 天前

档位由哪些信号合成

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

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

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

可执行外部命令写入剪贴板(不计风险)发起外部网络请求

查看扫描证据（共 7 处，展示前 7 条）

执行外部命令来自配置/变量
lib/index.js:273
child = spawn(cmd, args, { detached: true, stdio: 'ignore', windowsHide: false });
执行外部命令固定命令
lib/index.js:287
const alt = spawn('explorer.exe', args, { detached: true, stdio: 'ignore', windowsHide: false });
发起网络请求
lib/client.js:339
fetch(url, { method: "POST", cache: "no-store" })
写入剪贴板
lib/client.js:378
navigator.clipboard.writeText(p).then(function () { toast("已复制：" + p); }, function () { toast("复制失败", true); });
发起网络请求
lib/client.js:587
var res = await fetch("/ft/events?sessionId=" + encodeURIComponent(cur) + "&after=" + afterSeq(), { cache: "no-store" });
发起网络请求
lib/client.js:613
var res = await fetch("/ft/sessions", { cache: "no-store" });
发起网络请求
lib/client.js:628
fetch("/ft/events?sessionId=" + encodeURIComponent(sid) + "&after=0", { cache: "no-store" })

扫描于 2026/11/1（0 天前） · 范围入口闭包 + 发布文件清单 · 来源 GitHub 仓库

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

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

DSH 插件：显示智能体改动过哪些文件和目录（目录视图 + 时间线）

README

由 DeepSeek 最新模型翻译生成

dsh-file-tracker · 文件活动监视器一个 DSH 双端插件：让智能体动过的文件，你当场就能看见。智能体说「我改好了」，到底改了哪几个文件？dsh-file-tracker 把每一轮里 write / edit / shell 调用碰过的路径抓出来，按「目录」和「时间线」两种视角摊开在 web GUI 里。不用翻日志，不用问它。 ··· → 文件活动 ┌──────────────────────────────┐ │ 动过的目录 │ 时间线 │ │ 📁 nvidia-driver/x64 2 次 │ │ 7za.exe 14:03:11 │ │ 📁 src 5 次 │ │ client.js 14:05:02 │ └──────────────────────────────┘ 它做什么宿主半边（Cordis host）监听 session/event 的 tool/call，把工具参数里的路径解析出来，按「会话 → 目录 → 文件」聚合，并逐行落盘。

展开完整文档（README 剩余 1 节）

dsh-file-tracker · 文件活动监视器

一个 DSH 双端插件：让智能体动过的文件，你当场就能看见。

智能体说「我改好了」，到底改了哪几个文件？dsh-file-tracker 把每一轮里 write / edit / shell 调用碰过的路径抓出来，按「目录」和「时间线」两种视角摊开在 web GUI 里。不用翻日志，不用问它。

··· → 文件活动 ┌──────────────────────────────┐ │ 动过的目录 │ 时间线 │ │ 📁 nvidia-driver/x64 2 次 │ │ 7za.exe 14:03:11 │ │ 📁 src 5 次 │ │ client.js 14:05:02 │ └──────────────────────────────┘

它做什么

宿主半边（Cordis host）监听 session/event 的 tool/call，把工具参数里的路径解析出来，按「会话 → 目录 → 文件」聚合，并逐行落盘。

| 识别方式 | 工具 | 置信度 |
| 精确参数解析 | write edit read read_image move copy delete glob grep ops_glob ops_grep | 1.0 |
| 命令串启发式 | pwsh powershell shell bash sh cmd terminal | 0.6（半透明徽章） |

客户端半边在 web GUI 里挂一个面板，两个视图：

- 动过的目录 — 每个被碰过的目录一行，带改动次数、最近一次动的文件与时间；点开看该目录下的文件明细。
- 时间线 — 逐条事件倒序，失败的调用标红点；点开看工具名与 turn/step 号。

徽章含义：

| 写 | 改 | 读 | 看 | 移 | 删 | 壳 |
| write | edit | read | glob/grep | move | delete | pwsh 等命令 |

右键跳转文件夹

在面板的任意一行上点右键，会弹出上下文菜单：

- 在文件夹中显示 — 文件条目：打开系统文件管理器并选中该文件；目录条目：直接打开该目录。
- 复制路径 — 把该条记录对应的绝对路径复制到剪贴板。

打开动作由宿主执行（POST /ft/open），客户端只上报事件的 fseq：

- 路径不由客户端指定。宿主从自己的事件簿里按 fseq 反查真实路径，客户端无法借此打开任意路径。
- 沿用与 DSH 官方相同的 Explorer 调用约定（file:// URI + 非 ASCII 还原 + 逗号/等号转义）。
- 文件若已被移动或删除，自动退回打开它所在的目录。
- 结果以轻提示反馈（成功 / 路径不存在 / 找不到系统文件管理器）。

需要系统 PATH 里存在 C:\Windows（explorer.exe 所在目录）。缺失时菜单会提示「找不到系统文件管理器」。

安装

前置：DSH Desktop，Node ≥ 22。

git clone https://github.com/Mys12word/dsh-file-tracker "$HOME\.dsh\plugins\dsh-file-tracker"
powershell -NoProfile -ExecutionPolicy Bypass -File "$HOME\.dsh\plugins\dsh-file-tracker\install-profile.ps1"

脚本只做三件事，都可手动完成：

1. 往配置档 package.json 的 dependencies 写 "dsh-file-tracker": "link:<插件绝对路径>"
2. 往 dsh.profile.bundles 数组里加 dsh-file-tracker
3. 在 ~/.dsh/profiles/<profile>/node_modules/ 建 junction

完全退出并重启 DSH Desktop 后生效。 只刷新页面不够——bundle 列表在启动时读取。

数据面 API

同源 HTTP，loopback 信任栅栏：非 127.0.0.1 Host 或跨站 Origin 一律 403。

| 端点 | 说明 |
| GET /ft/events?sessionId=<id>&after=<fseq> | 增量拉事件，after 为游标 |
| GET /ft/summary?sessionId=<id> | 目录聚合视图 |
| GET /ft/sessions | 会话列表（含 cwd、标题） |

数据文件

~/.dsh/file-tracker/events.jsonl — 追加式 JSONL，单行一条：

{"fseq":387,"sid":"session-…","cwd":"C:\\…","tool":"pwsh","turn":13,"step":1,"kind":"shell","file":"nvidia-driver/x64","dir":"nvidia-driver","conf":0.6} 超过 8 MB 自动截断，保留最近 1000 行。删掉整个 ~/.dsh/file-tracker/ 目录即可重置，不影响任何其他功能。

设计要点

- fail-open：每条事件的解析、每个客户端 DOM 副作用都包在 try/catch 里。插件自身出问题绝不打断宿主 turn，也绝不弄白你的界面。
- 壳类是启发式：它只回答「大概动了哪个目录」，别拿它当审计证据。要精确就让工具用 file_path 参数。
- 配色自持：不依赖宿主的语义令牌（那些令牌在浮层里对比度很低），面板自带 --ftt-* 调色板，按当前界面背景亮度自动选亮/暗，并用 MutationObserver 跟随主题切换。
- 零配置：没有设置项，装完就有。

已知限制

- 面板锚定当前对话的会话。从侧边栏其他会话行打开，看到的仍是当前会话的事件（v1 行为）。
- 目录/路径是从命令原文里抠出来的，所以注册表键（HKLM:\…）、URL 之类偶尔也会入列——那是智能体敲过的字面串，不代表真的碰了文件系统。
- 只记录当前进程生命周期内新发生的事件，不回溯历史会话的事件流（历史 JSONL 仍在磁盘上）。

FAQ

「壳」是什么意思？ shell 类事件的缩写徽章——这次操作是执行命令，不是读写文件，所以它带的路径是启发式猜出来的（0.6 置信度，半透明显示）。

为什么面板里出现了 HKLM:\SYSTEM\…？ 同上：那是命令文本里的字面路径，被「壳类」启发式抓到了。它可能只是 Get-ItemProperty 在读注册表。

面板为什么不刷新？ 宿主侧 webServer 不可用时会退化为「只收集不路由」，重启后自动补齐。客户端每 1.2 s 轮询一次，失败退避到 4 s。

开发

node --check lib/index.js
node --check lib/client.js
node test/client.test.mjs # 19 项断言
node test/host.test.mjs # 24 项断言

客户端是 vanilla DOM（不引 React），打包契约：window.__ModuleLoader__.load({ id, factory }) 的 factory 返回值本身就是模块体，apply / inject 必须在顶层，文件以 return module.exports; 结尾。

License

MIT