dsh-file-activity 0.5.7 → 0.5.9

package/CHANGELOG.md

@@ -2,6 +2,56 @@
 
 本文件记录 dsh-file-activity 的所有版本变更。格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.5.9] - 2026-09-13
+
+### 变更
+
+- chore: 项目全面优化和完善
+- fix(dsh-file-activity): #266 侧边栏席位按宿主空 props 契约加载，面板打开即刷新 + 补 guide 菜单入口 (#268)
+- chore(release): #198 dsh-shared 0.1.4 + 消费方 peerDeps 同步 + 文档收口 (#254)
+- refactor(file-activity): #187 批 2 迁移到宿主原生侧边栏 API（移除 better-sidebar，含实测证据） (#249)
+- #184 依赖升级：矩阵脚本 + A 档落地 + jscpd 解锁 + dependabot 覆盖插件目录 (#235)
+- perf(scripts): #188 优化 pre-push 校验耗时（并发 6 + 收窄退化 + 补 D + file-activity 测试提速） (#234)
+- fix(dsh-file-activity): #197 写放大 3665× 与状态无界 (#207)
+- fix(release): 批量提交信息 header 控制在 commitlint 限制内
+- feat(ts): 第四轮 JS→TS 迁移（5 个插件，server + client 全量）
+
+## [Unreleased]
+
+### 修复
+
+- fix(dsh-file-activity): #266 侧边栏「文件活动」面板打开后永远显示「暂无文件活动记录」（P0）——
+  宿主渲染 `sidebar.right.pane.tab` 席位时 owner props 是**空对象**
+  （`renderSlot(seat, {}, {hookContext})`），可见性只在注入的 `useTabInfo()` 里；
+  旧守卫只读 `props.visible`（恒为 `undefined`）→ 守卫恒真 → 面板打开后既不首载也不轮询
+  （`POLL_MS` 失效），只有手点「刷新」才有数据。现按宿主真实契约取
+  `useTabInfo().tab.visible`（取不到时退回可见：宁可多轮询一个面板，也不能空白），
+  切回页签/展开侧边栏立即重新加载并重启轮询，宿主判定不可见时不轮询（省资源）。
+  同一 issue 的关联项：
+  - B：「新标签页」菜单补 guide 入口（`sidebarRightTabs.register({guide:[…]})`）——此前页签关闭后
+    无法从 UI 重新打开（auto-open 每浏览器标签只跑一次）；
+  - C：HTML 预览按 README 承诺落地为**沙箱 iframe**（此前 `viewerOf()` 无 html 分支，
+    `.html` 落到文本渲染器、显示为代码块 `.dfa-fp-code`）：iframe
+    `sandbox="allow-scripts allow-forms"` + 媒体路由响应头
+    `Content-Security-Policy: sandbox allow-scripts allow-forms`（两层都不含
+    `allow-same-origin`，直接打开该 URL 同样受限）；
+  - D：删除客户端挂载探针（此前每次页面加载都往状态文件写一条
+    `sessionId="__probe__", path="mounted"` 的幽灵记录，累计 9 行、重启后仍在），
+    并在加载时剔除历史残留（#197「状态有界」）。
+- fix(dsh-file-activity): #197 写放大 3,665× 与状态无界（P0）——
+  落盘改为 JSON Lines 增量 append（落盘字节 ≈ 事件本体字节）+ 按状态体积自适应的原子 compact；
+  新增三维入口上限（会话/每会话路径/全局路径）与 LRU 淘汰（淘汰计数 + warn 可见，非静默丢弃）；
+  compact 快照显式传 `minIntervalMs`/`maxBytes` 护栏；旧全量 JSON 快照自动兼容并改写。
+  实测：单条新事件落盘 789,780 B → 68 B（11,614×↓）；稳态每事件 2,104 B → 63 B（33×↓）；
+  密集流投影 44.18 MB/小时 → 1.94 MB/小时（22.8×↓）；内存条目与状态文件均有界。
+  本插件并入 `scripts/resource-smoke.mjs` 写放大门禁（此前仅覆盖 observability）。
+
+## [0.5.8] - 2026-09-10
+
+### 变更
+
+- feat(ts): 第四轮 JS→TS 迁移（5 个插件，server + client 全量）
+
 ## [0.5.7] - 2026-09-07
 
 ### 变更

package/README.md

@@ -1,7 +1,5 @@
 # dsh-file-activity
 
-[![插件生态](https://img.shields.io/badge/插件生态-topic%20dsh--better--sidebar-4d6bfe)](https://github.com/topics/dsh-better-sidebar)
-
 <div align="center">
   <img alt="文件活动插件截图（最近访问 / 文件统计）" src="https://unpkg.com/dsh-file-activity/assets/screenshot.png" width="340" />
   <br />
@@ -10,13 +8,13 @@
   <img alt="浮窗 HTML 预览：内容撑满整个浮窗主体（issue #111）" src="https://unpkg.com/dsh-file-activity/assets/preview-float-0.5.6.png" width="340" />
 </div>
 
-**DSH 侧边栏文件活动插件**（基于 [dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar) 扩展）：在 better-sidebar 中新增「文件活动」页签，记录 agent 工具与侧边栏自身的文件读取/新增/修改事件，提供**最近访问**（LRU）与**文件统计**（树形目录）两块视图，点击文件弹出浮窗预览。
+**DSH 侧边栏文件活动插件**（基于宿主 0.1.5-rc.1 的原生侧边栏扩展点，零第三方侧边栏依赖）：在右侧边栏新增「文件活动」页签，记录 agent 工具与插件自身路由的文件读取/新增/修改事件，提供**最近访问**（LRU）与**文件统计**（树形目录）两块视图，点击文件弹出浮窗预览。
 
 ## 功能
 
-在 better-sidebar 中新增「文件活动」页签：
+在右侧边栏新增「文件活动」页签：
 
-1. **最近访问**：按 LRU 记录文件读取 / 新增 / 修改事件（agent 工具读写 + 侧边栏打开/编辑保存都会记录），**每会话最多保留 5 条，同一文件只出现一次**（再次访问会移到列表最前）；区块标题可**点击折叠/展开**；点击任意文件即弹出**浮窗预览**，浮窗内**复用侧边栏内置渲染**（代码高亮 / Markdown 渲染 / 图片 / PDF / HTML，见下方「浮窗预览」）。
+1. **最近访问**：按 LRU 记录文件读取 / 新增 / 修改事件（agent 工具读写 + 侧边栏打开/编辑保存都会记录），**每会话最多保留 5 条，同一文件只出现一次**（再次访问会移到列表最前）；区块标题可**点击折叠/展开**；点击任意文件即弹出**浮窗预览**（浮窗内渲染：代码高亮 / Markdown 富文本 / 图片 / PDF / 沙箱 HTML，见下方「浮窗预览」）。
 2. **文件统计**：每个文件的「读取 / 新增 / 修改」次数，按文件**绝对路径**组织成**树形目录**；连续单子目录的路径链自动**压缩为点号标签**（如 `a/b/c` → `a.b.c`），文件直接列在下方；**每个文件夹行可点击展开/收起**（箭头指示状态）；每个文件行内显示**相对时间**（刚刚 / N 分钟前 / N 小时前 / N 天前），悬停可查看**创建 / 最近访问**的完整时钟时间：
 
    ```
@@ -28,17 +26,17 @@
          client.js
    ```
 
-3. **默认启用**：页签注册后默认开启（无需在设置页勾选），且每个会话首次打开时**自动打开**本页（可在侧边栏设置中关闭自动打开）。
+3. **默认启用**：页签注册后默认开启（无需在设置页勾选），且每个会话首次打开时**自动打开**本页——开关在 **设置 → 插件 → 文件活动**（`settings.plugins.tab`，存储在浏览器 `localStorage`，插件自身持久化）。
 
 ## 工作原理
 
-- **Server 端**（`lib/index.js`）：监听 DSH `fs/observed` 事件捕获 agent 的 `read` / `write` / `edit` / `str_replace_editor` / `read_image` 等文件操作；提供 `/file-activity/api` 路由（`stats` / `record` / `clear`）；状态按会话持久化到 `$DSH_HOME/file-activity.json`（防抖 + 原子写入）。
+- **Server 端**（`lib/index.js`）：监听 DSH `fs/observed` 事件捕获 agent 的 `read` / `write` / `edit` / `str_replace_editor` / `read_image` 等文件操作；提供 `/file-activity/api` 路由（`stats` / `record` / `clear`）；状态按会话持久化到 `$DSH_HOME/file-activity.json`（**JSON Lines 增量 append + 阈值原子 compact**，见下「资源治理」）。
   - `write` 通过每会话的已知文件表自动区分**新增**（首次接触）与**修改**（再次写入）。
-- **Client 端**（`lib/client.js`）：通过 `ctx.betterSidebar.registerTab` 注册页签；fetch 拦截捕获侧边栏自身操作（`/sidebar/api/fs.read`、`/sidebar/api/fs.write`、`/sidebar/file` 媒体预览）并上报 server；数据按会话（session）**分桶隔离**（`bySession`），每个会话只渲染自己的记录——新建/切换会话立即显示该会话的数据，**不会残留上一个会话的记录**；点击文件通过 `ctx.betterSidebar.matchFileViewer(path)` 匹配内置 viewer 并挂载其组件，打开浮窗预览。
+- **Client 端**（`lib/client.js`）：通过宿主原生扩展点注册——`ctx.sidebarRightTabs.register({id,kind,title})`（页签类型）+ `ctx.slots.register({name:'sidebar.right.pane.tab',key:id}, Body)`（正文席位）；`ctx.documentPreviews.register(...)` 声明本插件认领的文件后缀（元数据 only，字节由宿主 document owner 读取）；自动打开走 `ctx.sidebarRight.openTab(kind)`（会话表面未挂载时按 1s 重试，彻底失败会写入 `data-dfa-degraded` 标记并在页签内显示提示，绝不静默失效）；浮窗自实现并挂在宿主推荐落点 `shell.overlay` 列表席位（不替换宿主 UI）；fetch 拦截只记录插件自身路由 `/file-activity/file` 的预览读取。数据按会话（session）**分桶隔离**（`bySession`），每个会话只渲染自己的记录——新建/切换会话立即显示该会话的数据，**不会残留上一个会话的记录**。预览按后缀分流：图片 / PDF / HTML 走插件媒体路由（`<img>` / 原生 PDF frame / **沙箱 iframe**），其余文本走插件文本路由并由官方 `MarkdownText` / `CodeBlock` 渲染（不可用时退回 `<pre>`）。
 
 ## 安装
 
-> 💡 **npm 安装（普通用户推荐）**：`dsh plugin --profile web add dsh-file-activity --trust-lockfile`——无需克隆本仓库；依赖自动级联安装：`dsh-better-sidebar`（宿主，提供侧边栏扩展点）与 `dsh-shared`（server 端共享工具包）均声明为 dependencies，安装时自动安装并加入 profile bundles，无需手动单独处理。
+> 💡 **npm 安装（普通用户推荐）**：`dsh plugin --profile web add dsh-file-activity --trust-lockfile`——无需克隆本仓库；依赖自动级联安装：`dsh-shared`（server 端共享工具包）是唯一 dependencies，侧边栏能力全部来自宿主原生扩展点（**不需安装任何第三方侧边栏插件**）。
 
 ```sh
 # 方式一：dsh plugin（推荐）
@@ -63,22 +61,22 @@ dsh plugin --profile web add link:<仓库路径>/plugins/dsh-file-activity
 
 ## 使用
 
-- 侧边栏 `+` 菜单 → 文件活动（或会话开始自动打开）。
-- 点击任意文件行 → 弹出**浮窗预览**：浮窗内**复用侧边栏内置的 file viewer** 渲染（代码语法高亮 / Markdown 富文本 / 图片 / PDF / HTML），不打开侧边栏编辑器标签，也不自建预览实现；**点击浮窗外任意处或按 `Esc` 即可关闭**，大文件可在浮窗内滚动。
+- 侧边栏「新标签页」（guide）菜单 → 文件活动（本插件向宿主 `sidebarRightTabs.register` 的 `guide` 提供入口，issue #266 B），或会话开始自动打开。
+- 点击任意文件行 → 弹出**浮窗预览**：按后缀渲染（代码语法高亮 / Markdown 富文本 / 图片 / PDF / 沙箱 HTML），不打开侧边栏编辑器标签；**点击浮窗外任意处或按 `Esc` 即可关闭**，大文件可在浮窗内滚动。
 - 顶部「刷新」手动重载，「清空」删除当前会话全部记录。
 
 ### 浮窗预览（复用内置渲染）
 
-点击文件（最近访问 / 文件统计中的任意文件行）会打开一个**悬浮预览窗**，窗口内容由侧边栏**内置的文件查看器**（file viewer）渲染 —— 通过 `ctx.betterSidebar.matchFileViewer(path)` 拿到匹配的 viewer，取其 `component` 挂载，并按 viewer 的 `fetchStrategy` 取内容（`fsRead` 文本 / `mediaUrl` 媒体 / `custom` 自定义）。浮窗为轻量交互：**点击浮窗外任意处、按 `Esc` 或点标题栏右上 `×` 都能关闭**；浮窗主体是可滚动区域，长文件或大图在窗内滚动查看。
+点击文件（最近访问 / 文件统计中的任意文件行）会打开一个**悬浮预览窗**，窗口由本插件渲染（挂在宿主 `shell.overlay` 浮层席位上，不替换宿主 UI）—— 按后缀分流：图片（svg/png/jpg/gif/webp/avif/bmp/ico）用 `<img>`、PDF 用原生 `<iframe>`、HTML（html/htm/xhtml）用**沙箱 `<iframe>`**，三者都取插件自己的媒体路由 `/file-activity/file`（按 `(sessionId, path)` 授权，因此工作区外的记录路径也能预览）；其余文本走插件文本路由 `/file-activity/file?as=text`，由官方 `MarkdownText` / `CodeBlock` 渲染（组件库不可用时退回 `<pre>`）。浮窗为轻量交互：**点击浮窗外任意处、按 `Esc` 或点标题栏右上 `×` 都能关闭**；浮窗主体是可滚动区域，长文件或大图在窗内滚动查看。
 
 - **代码**（后台为侧边栏内置 CodeMirror 编辑器）：语法高亮 + 行号；支持 预览/编辑 切换与保存。
 - **Markdown**（`.md` / `.markdown`）：渲染后的富文本预览，可切换 预览/编辑 模式。
 - **图片**（png / jpg / jpeg / gif / webp / svg / bmp / ico / avif）：通过媒体路由渲染。
 - **PDF**：浏览器原生 PDF 查看器（浮窗内嵌，工具栏提供下载）。
-- **HTML**：沙箱化渲染预览，内容**撑满整个浮窗主体**（iframe 随浮窗尺寸自适应、内部滚动，与代码/Markdown/图片预览体验一致，issue #111）。
+- **HTML**（`.html` / `.htm` / `.xhtml`）：**沙箱化 iframe 渲染**，内容**撑满整个浮窗主体**（iframe 随浮窗尺寸自适应、内部滚动，与代码/Markdown/图片预览体验一致，issue #111）。沙箱有两层且都不含 `allow-same-origin`：iframe 的 `sandbox="allow-scripts allow-forms"` 与媒体路由响应头的 `Content-Security-Policy: sandbox allow-scripts allow-forms`（响应头让**直接打开该 URL 也仍是沙箱文档**）。文档因此拿到 opaque origin：脚本/表单可跑（交互式页面可用），但读不到宿主页面的 Cookie、存储与同源 API，也不能导航父窗口。页内相对路径资源按站点根解析（不重写为文件目录，与浏览器直开行为一致）。
 - 其余文件按内置 viewer 的 `matchFileViewer` 回退匹配（如 `binary-download` 下载未知二进制）。
 
-> 💡 **工作区外文件也能预览**：文件活动记录的是 agent 实际触碰过的文件，路径可能在会话工作区之外（如 `/tmp` 临时文件）。侧边栏自带的媒体路由只允许工作区内文件，因此图片/PDF 的字节由插件自身的 `/file-activity/file` 路由提供——它按会话记录授权（只放行本会话记录过的路径，未记录的路径一律 403），fence 与侧边栏一致。Markdown/代码/HTML 文本则仍走侧边栏 `fs.read`（不被工作区限制）。
+> 💡 **工作区外文件也能预览**：文件活动记录的是 agent 实际触碰过的文件，路径可能在会话工作区之外（如 `/tmp` 临时文件）。侧边栏自带的媒体路由只允许工作区内文件，因此图片/PDF 的字节由插件自身的 `/file-activity/file` 路由提供——它按会话记录授权（只放行本会话记录过的路径，未记录的路径一律 403），fence 与侧边栏一致。Markdown/代码文本则仍走侧边栏 `fs.read`（不被工作区限制）；HTML 走插件媒体路由的沙箱文档（见上）。
 
 ## 配置
 
@@ -87,15 +85,28 @@ dsh plugin --profile web add link:<仓库路径>/plugins/dsh-file-activity
 ## 数据说明
 
 - 按会话（session）隔离存储（服务端 `$DSH_HOME/file-activity.json` 按 sessionId 分桶 + 前端 `bySession` 分桶展示）；**DSH 重启后历史数据自动恢复**（持久化加载）；新建/切换会话不残留其他会话的记录。
+
+## 资源治理（issue #197）
+
+写放大与无界增长防护（9/2 事故同构模式整改）：
+
+- **增量落盘**：每次记录只追加一行 JSON（`{"s","p","o","t"}`，落盘字节 ≈ 事件本体字节 ×1.0），
+  累计行数达到按状态体积自适应的阈值时做一次原子 compact（tmp+rename 重写快照行），
+  文件大小与写入量双向有界（实测写放大 1.0×，旧实现 2,073×）；
+- **三维入口上限（LRU 淘汰，非静默丢弃）**：每会话路径 ≤ 300、全局路径 ≤ 20000、会话数 ≤ 64；
+  超限淘汰最久未活动条目/会话，淘汰计数暴露在 `store.stats()` 且写 warn 日志（首次 + 每 10 次）；
+- **显式护栏**：compact 快照受 `minIntervalMs`（体积分级节流）与 `maxBytes`（8MB 硬上限，超限拒绝写 + 告警）约束；
+- **升级兼容**：旧的全量 JSON 快照（单行/多行）仍可读取，首次启动一次性改写为 JSON Lines；
+  文件里只有事件行（未 compact）时也能按行序完整重放（不丢数据）。
 - 最近访问列表每会话最多保留 5 条（LRU：同一文件仅一条，重复访问移到最前），文件统计不受条数限制。
 - agent 的 `bash`/`git` 等命令内部的文件触碰不在此跟踪范围（只跟踪 DSH 原生文件工具与侧边栏操作）。
 
 ## 依赖
 
-| 依赖                 | 用途                              | 可选                           |
-| -------------------- | --------------------------------- | ------------------------------ |
-| `dsh-better-sidebar` | 侧边栏页签注册 + 浮窗 file viewer | 否（前置，v0.12+，推荐 v0.14） |
-| `cordis`             | 插件运行时                        | 是（宿主提供）                 |
+| 依赖         | 用途                                 | 可选                 |
+| ------------ | ------------------------------------ | -------------------- |
+| `dsh-shared` | server 端共享工具包（路由/JSONL 等） | 否（随插件自动安装） |
+| `cordis`     | 插件运行时                           | 是（宿主提供）       |
 
 ## 相关文档
 

package/lib/api-route.js

@@ -3,93 +3,89 @@
  * Every request passes the trust fence first; responses are JSON with
  * cache-control: no-cache.
  */
-import { readJsonBody, writeError, writeJson } from 'dsh-shared'
-import { sessionCwdOf } from './cwd.js'
-import { mapOp } from './state.js'
-
-export function createApiHandler({ ctx, store, fence }) {
-  return async (request, response) => {
-    if (!fence(request)) {
-      writeJson(response, 403, { ok: false, error: { code: 'forbidden', message: 'forbidden' } })
-      return
-    }
-    const url = new URL(request.url ?? '/', 'http://dsh.internal')
-    const method = apiMethodOf(url)
-    try {
-      if (method === 'record' && request.method === 'POST') {
-        await handleRecord(store, request, response)
-        return
-      }
-      if (method === 'stats' && request.method === 'GET') {
-        handleStats(ctx, store, url, response)
-        return
-      }
-      if (method === 'clear' && request.method === 'POST') {
-        await handleClear(store, request, response)
-        return
-      }
-      writeJson(response, 404, {
-        ok: false,
-        error: { message: 'unknown file-activity API method' },
-      })
-    } catch (error) {
-      writeError(response, error)
-    }
-  }
+import { readJsonBody, writeError, writeJson } from 'dsh-shared';
+import { sessionCwdOf } from './cwd.js';
+import { mapOp } from './state.js';
+export function createApiHandler({ ctx, store, fence, }) {
+    return async (request, response) => {
+        if (!fence(request)) {
+            writeJson(response, 403, { ok: false, error: { code: 'forbidden', message: 'forbidden' } });
+            return;
+        }
+        const url = new URL(request.url ?? '/', 'http://dsh.internal');
+        const method = apiMethodOf(url);
+        try {
+            if (method === 'record' && request.method === 'POST') {
+                await handleRecord(store, request, response);
+                return;
+            }
+            if (method === 'stats' && request.method === 'GET') {
+                handleStats(ctx, store, url, response);
+                return;
+            }
+            if (method === 'clear' && request.method === 'POST') {
+                await handleClear(store, request, response);
+                return;
+            }
+            writeJson(response, 404, {
+                ok: false,
+                error: { message: 'unknown file-activity API method' },
+            });
+        }
+        catch (error) {
+            writeError(response, error);
+        }
+    };
 }
-
 /** Strip the /file-activity/api/ prefix; undefined for anything else. */
 function apiMethodOf(url) {
-  const pathname = url.pathname
-  return pathname.startsWith('/file-activity/api/') ? pathname.slice('/file-activity/api/'.length) : undefined
+    const pathname = url.pathname;
+    return pathname.startsWith('/file-activity/api/') ? pathname.slice('/file-activity/api/'.length) : undefined;
 }
-
 /** POST /file-activity/api/record — client-reported sidebar operation. */
 async function handleRecord(store, request, response) {
-  const payload = await readJsonBody(request)
-  const sessionId = typeof payload.sessionId === 'string' ? payload.sessionId : ''
-  const path = typeof payload.path === 'string' ? payload.path : ''
-  const op = typeof payload.op === 'string' ? payload.op : 'read'
-  store.record(sessionId, path, mapOp(op), Date.now())
-  writeJson(response, 200, { ok: true })
+    const payload = await readJsonBody(request);
+    const sessionId = typeof payload.sessionId === 'string' ? payload.sessionId : '';
+    const path = typeof payload.path === 'string' ? payload.path : '';
+    const op = typeof payload.op === 'string' ? payload.op : 'read';
+    store.record(sessionId, path, mapOp(op), Date.now());
+    writeJson(response, 200, { ok: true });
 }
-
 /** GET /file-activity/api/stats — recent + counts + session cwd. */
 function handleStats(ctx, store, url, response) {
-  const sessionId = url.searchParams.get('sessionId') ?? ''
-  // Session working directory, for client-side relative-path display.
-  const cwd = sessionCwdOf(ctx, sessionId)
-  const session = store.state.sessions[sessionId]
-  if (session === undefined) {
-    writeJson(response, 200, { ok: true, value: { recent: [], counts: {}, cwd } })
-    return
-  }
-  // Snapshot the leaf fields only — no live objects cross the wire.
-  const recent = session.recent.map((entry) => ({
-    path: entry.path,
-    op: entry.op,
-    time: entry.time,
-  }))
-  const counts = {}
-  for (const [path, counter] of Object.entries(session.counts)) {
-    counts[path] = {
-      read: counter.read,
-      create: counter.create,
-      modify: counter.modify,
-      firstSeen: counter.firstSeen,
-      lastSeen: counter.lastSeen,
+    const sessionId = url.searchParams.get('sessionId') ?? '';
+    // Session working directory, for client-side relative-path display.
+    const cwd = sessionCwdOf(ctx, sessionId);
+    const session = store.state.sessions[sessionId];
+    if (session === undefined) {
+        writeJson(response, 200, { ok: true, value: { recent: [], counts: {}, cwd } });
+        return;
     }
-  }
-  writeJson(response, 200, { ok: true, value: { recent, counts, cwd } })
+    // Snapshot the leaf fields only — no live objects cross the wire.
+    const recent = session.recent.map((entry) => ({
+        path: entry.path,
+        op: entry.op,
+        time: entry.time,
+    }));
+    const counts = {};
+    for (const [path, counter] of Object.entries(session.counts)) {
+        counts[path] = {
+            read: counter.read,
+            create: counter.create,
+            modify: counter.modify,
+            firstSeen: counter.firstSeen,
+            lastSeen: counter.lastSeen,
+        };
+    }
+    writeJson(response, 200, { ok: true, value: { recent, counts, cwd } });
 }
-
 /** POST /file-activity/api/clear — wipe one session's records (persisted). */
 async function handleClear(store, request, response) {
-  const payload = await readJsonBody(request)
-  const sessionId = typeof payload.sessionId === 'string' ? payload.sessionId : ''
-  if (sessionId !== '' && store.state.sessions[sessionId] !== undefined) {
-    delete store.state.sessions[sessionId]
-    store.schedulePersist()
-  }
-  writeJson(response, 200, { ok: true })
+    const payload = await readJsonBody(request);
+    const sessionId = typeof payload.sessionId === 'string' ? payload.sessionId : '';
+    if (sessionId !== '' && store.state.sessions[sessionId] !== undefined) {
+        delete store.state.sessions[sessionId];
+        store.schedulePersist();
+    }
+    writeJson(response, 200, { ok: true });
 }

package/lib/bash-ops.js

@@ -1,6 +1,5 @@
-import { homedir } from 'node:os'
-import { isAbsolute, join, normalize, resolve } from 'node:path'
-
+import { homedir } from 'node:os';
+import { isAbsolute, join, normalize, resolve } from 'node:path';
 /**
  * bash-ops.js — command → file-operation mapping for the bash intent parser
  * (see bash-parse.js for the segment/token layer).
@@ -11,89 +10,101 @@ import { isAbsolute, join, normalize, resolve } from 'node:path'
  */
 /** Options of a command that consume the following argument (never a path). */
 function optionArgsOf(cmd) {
-  if (cmd === 'touch') return new Set(['-d', '-t', '-r', '--date', '--time', '--reference'])
-  return new Set()
+    if (cmd === 'touch')
+        return new Set(['-d', '-t', '-r', '--date', '--time', '--reference']);
+    return new Set();
 }
-
 /**
  * Path arguments with options stripped: `-rf` / `--force` / `--` are skipped;
  * options listed in `optionArgs` consume their following argument too.
+ *
+ * `optionArgs` 可选：`cd` 的目标解析（bash-parse.js）只取第一个位置参数，
+ * 不传选项表——与迁移前逐字节一致（该路径遇到 `-` 开头的 token 仍会抛错）。
  */
 export function positionalArgs(args, optionArgs) {
-  const paths = []
-  let afterDashDash = false
-  for (let i = 0; i < args.length; i += 1) {
-    const token = args[i]
-    if (!afterDashDash && token.text === '--') {
-      afterDashDash = true
-      continue
-    }
-    if (!afterDashDash && token.text.startsWith('-') && token.text !== '-') {
-      if (optionArgs.has(token.text)) i += 1
-      continue
+    const paths = [];
+    let afterDashDash = false;
+    for (let i = 0; i < args.length; i += 1) {
+        const token = args[i];
+        if (!afterDashDash && token.text === '--') {
+            afterDashDash = true;
+            continue;
+        }
+        if (!afterDashDash && token.text.startsWith('-') && token.text !== '-') {
+            if (optionArgs.has(token.text))
+                i += 1;
+            continue;
+        }
+        paths.push(token);
     }
-    paths.push(token)
-  }
-  return paths
+    return paths;
 }
-
 /**
  * -t / --target-directory variants (cp/mv/install) relocate sources into a
  * directory; statically resolving the real destination is unreliable, so the
  * whole segment is skipped (conservative: never record a wrong path).
  */
 function hasTargetDirOption(cmd, args) {
-  if (cmd !== 'mv' && cmd !== 'cp' && cmd !== 'install') return false
-  return args.some((token) => token.text === '-t' || token.text === '--target-directory')
+    if (cmd !== 'mv' && cmd !== 'cp' && cmd !== 'install')
+        return false;
+    return args.some((token) => token.text === '-t' || token.text === '--target-directory');
 }
-
 /** Dispatch one segment's command to the matching file-op mapping. */
 export function pushCommandOps(ops, cmd, args, cwd) {
-  if (hasTargetDirOption(cmd, args)) return
-  const optionArgs = optionArgsOf(cmd)
-  const paths = positionalArgs(args, optionArgs)
-  if (cmd === 'rm') return pushAll(ops, 'delete', paths, cwd)
-  if (cmd === 'touch' || cmd === 'tee') return pushAll(ops, 'write', paths, cwd)
-  if (cmd === 'mv') return pushMv(ops, paths, cwd)
-  if (cmd === 'cp' || cmd === 'install') return pushLast(ops, paths, cwd)
-  if (cmd === 'sed' && hasInPlace(args)) pushLast(ops, positionalArgs(args, optionArgs), cwd)
+    if (hasTargetDirOption(cmd, args))
+        return;
+    const optionArgs = optionArgsOf(cmd);
+    const paths = positionalArgs(args, optionArgs);
+    if (cmd === 'rm')
+        return pushAll(ops, 'delete', paths, cwd);
+    if (cmd === 'touch' || cmd === 'tee')
+        return pushAll(ops, 'write', paths, cwd);
+    if (cmd === 'mv')
+        return pushMv(ops, paths, cwd);
+    if (cmd === 'cp' || cmd === 'install')
+        return pushLast(ops, paths, cwd);
+    if (cmd === 'sed' && hasInPlace(args))
+        pushLast(ops, positionalArgs(args, optionArgs), cwd);
 }
-
 /** All positional paths get the same op (rm / touch / tee). */
 function pushAll(ops, op, paths, cwd) {
-  for (const token of paths) pushOp(ops, op, token, cwd)
+    for (const token of paths)
+        pushOp(ops, op, token, cwd);
 }
-
 /** Only the last path is the write destination (cp / install). */
 function pushLast(ops, paths, cwd) {
-  if (paths.length === 0) return
-  pushOp(ops, 'write', paths[paths.length - 1], cwd)
+    if (paths.length === 0)
+        return;
+    pushOp(ops, 'write', paths[paths.length - 1], cwd);
 }
-
 /** mv: all but the last are sources (delete), the last is the destination. */
 function pushMv(ops, paths, cwd) {
-  if (paths.length === 0) return
-  for (let i = 0; i < paths.length - 1; i += 1) pushOp(ops, 'delete', paths[i], cwd)
-  pushOp(ops, 'write', paths[paths.length - 1], cwd)
+    if (paths.length === 0)
+        return;
+    for (let i = 0; i < paths.length - 1; i += 1)
+        pushOp(ops, 'delete', paths[i], cwd);
+    pushOp(ops, 'write', paths[paths.length - 1], cwd);
 }
-
 /** sed writes files only with -i / --in-place (also -i.bak style). */
 function hasInPlace(args) {
-  return args.some((token) => /^-i($|[A-Za-z0-9_.])/.test(token.text) || token.text === '--in-place')
+    return args.some((token) => /^-i($|[A-Za-z0-9_.])/.test(token.text) || token.text === '--in-place');
 }
-
 export function pushOp(ops, op, token, cwd) {
-  const path = resolveSafe(token, cwd)
-  if (path !== '') ops.push({ op, path })
+    const path = resolveSafe(token, cwd);
+    if (path !== '')
+        ops.push({ op, path });
 }
-
 /** Resolve a token to an absolute path; '' when unsafe or unusable. */
 export function resolveSafe(token, cwd) {
-  if (!token.safe || token.text === '') return ''
-  let path = token.text
-  if (path === '~') return homedir()
-  if (path.startsWith('~/')) path = join(homedir(), path.slice(2))
-  if (path.includes('\0')) return ''
-  const abs = isAbsolute(path) ? normalize(path) : resolve(cwd, path)
-  return normalize(abs)
+    if (!token.safe || token.text === '')
+        return '';
+    let path = token.text;
+    if (path === '~')
+        return homedir();
+    if (path.startsWith('~/'))
+        path = join(homedir(), path.slice(2));
+    if (path.includes('\0'))
+        return '';
+    const abs = isAbsolute(path) ? normalize(path) : resolve(cwd, path);
+    return normalize(abs);
 }