nyx-file-panel — panel xem file kiểu Antigravity cho DSH

Click vào file trong chat của DSH Desktop / DeepSeek Harness giờ không mở app ngoài nữa: nó mở một panel bên phải ngay trong app — xem nội dung (có tô màu cú pháp), xem diff file mà agent vừa sửa, cây thư mục workspace, và sửa trực tiếp rồi Save.

Toàn bộ nằm ngoài bundle .app: một plugin host + một client bundle cài vào profile web, đúng chuẩn plugin DSH.

Làm được gì

| Chỗ | Hành vi | |---|---| | Link file trong chat / tool card / deliverables | Mở panel trong app, không gọi open <path> | | Path trong tin nhắn | Path chỉ là chữ — trong code hay trong câu văn — cũng bấm được. Plugin đọc đúng token ngay dưới con trỏ, ghép với workspace root nếu là path tương đối, mở ~ thành home, rồi đưa qua đúng cái cổng kiểm tra tồn tại. Path thật thì có gạch chân chấm; and/or, 24/7 thì không. Bấm kèm phím tắt thì plugin không đụng vào. | | Turn navigator | Dải "nhảy theo lượt" 28px của DSH nằm đúng chỗ panel cần, nên panel cho nó nghỉ: window.__dshFilePanel.debug.hideTurnRail(false) là nó trở lại. | | Tabs | Mỗi file một tab, theo session, đóng được (giữ 12 tab) | | Preview | Có số dòng + highlight (ReadBlock), markdown render (MarkdownText), ảnh/PDF hiện trực tiếp qua route raw | | Changes | Diff chuẩn IDE: header @@ -a,b +c,d @@ có số dòng thật, gutter 2 bên tô màu, change bar, dòng trống có hatch, nhấn mạnh từng từ, gộp context dài, nhảy hunk, inline hoặc side-by-side, revert từng hunk, revert cả file, copy patch | | Review | Mọi file agent đã sửa trong session, +N −M, mở rộng xem before/after, open/revert/patch từng file | | Files | Cây lazy có badge thay đổi, ⌘P quick open, ⌘⇧F tìm trong nội dung (ripgrep bundled) | | Edit | Sửa tại chỗ, ⌘S lưu, ghi atomic, 409 nếu file đã đổi dưới chân | | Làm việc theo dòng | Click (shift-click) 1 dòng → copy reference path:line, thêm review note | | Notes | Note review theo session, copy ra để gửi lại cho agent | | Tự refresh | Poll file đang mở; editor đang sửa dở thì báo changed on disk chứ không ghi đè; chấm xanh = trạng thái sống | | Cửa sổ hẹp | Khi layout trả cột phải về 0 (cột giữa đòi 640px), panel dock thành slide-over dán vào mép phải, kéo resize được — thay vì render vô hình | | Đóng panel | Cột thu lại, panel tool-details gốc trả về ghế của nó |

Phím tắt: ⌘S lưu · ⌘F tìm trong file · ⌘⇧F tìm trong toàn workspace · ⌘P quick open · ⌘W đóng tab · Esc đóng palette → find → panel.

Panel chỉ mượn ghế details khi đang mở (priority: -1000), nên phần xem chi tiết tool call không bị ảnh hưởng: click vào 1 tool call là panel tự nhường ghế.

Ảnh chụp

Chụp thật từ rig (session tổng hợp, workspace fixture) — cắt đúng phần panel, không lấy phần chat:

Preview · Changes · Files · Review — panel dock ở cột phải của harness.

Cài đặt

Cần: DSH Desktop 0.8.x, Node 20+. Mở DSH Desktop một lần để nó tạo harness home.

Một lệnh cho mọi máy (macOS, Linux, Windows):

npx --yes github:thanhdz235123-commits/nyx-dsh-plugins install

Rồi reload cửa sổ DSH — Cmd-R / Ctrl-R. Host half được patch watcher của profile nạp ngay; client half cần reload.

Cài từ checkout, hoặc khi offline:

git clone https://github.com/thanhdz235123-commits/nyx-dsh-plugins
cd nyx-file-panel
node bin/nyx-file-panel.mjs install

Trỏ tới harness home khác mặc định:

node bin/nyx-file-panel.mjs install --home "/path/to/harness" --profile web

Hệ điều hành hỗ trợ

| OS | Harness home installer tự tìm | |---|---| | macOS | ~/Library/Application Support/dsh-desktop/harness | | Linux | $XDG_CONFIG_HOME/dsh-desktop/harness, không thì ~/.config/dsh-desktop/harness | | Windows | %APPDATA%\dsh-desktop\harness |

Toàn bộ là Node 20+ và API trình duyệt: path đi qua node:path, panel học separator của host từ /api/nyx-file-panel.health, ripgrep bundled được resolve rg hoặc rg.exe. git không bắt buộc — không có git thì tab Changes chỉ báo edit của session. Kiểm tra máy bằng doctor:

npx --yes github:thanhdz235123-commits/nyx-dsh-plugins doctor

Installer làm gì

Hai dạng, không bao giờ chồng nhau — chọn một:

| Dạng | Lệnh | Cách kích hoạt | |---|---|---| | copy (mặc định) | install | copy file vào <profile>/node_modules/nyx-file-panel, chèn từ patch layer của profile. Không chạy package manager, không đụng lockfile. | | dependency | install --dep | thêm nyx-file-panel vào dependencies + dsh.profile.bundles của <profile>/package.json; package manager của profile tự cài. Bundle mang theo patch layer nên không ghi row thủ công. |

node bin/nyx-file-panel.mjs status     # đang cài gì, ở đâu, build nào
node bin/nyx-file-panel.mjs doctor     # máy này có đủ điều kiện chạy không
node bin/nyx-file-panel.mjs uninstall  # xoá package, patch row và dependency

--dep mặc định cài từ github:thanhdz235123-commits/nyx-dsh-plugins; dùng --spec <spec> cho fork, tag (github:you/nyx-file-panel#v0.3.4) hoặc đường dẫn local (file:/path/to/checkout). Mọi lệnh đều idempotent, và uninstall xoá đúng những gì install đã ghi — patch layer rỗng được reset về [] để YAML vẫn hợp lệ.

Route của host

Tất cả là exact Fetch route trên service connection ⇒ tự thừa hưởng auth của trình duyệt (không cookie ⇒ 401; Origin/Host lạ ⇒ 403).

| Route | Việc | |---|---| | GET /api/nyx-file-panel.file?path&cwd | nội dung, ngôn ngữ, số dòng, size, mtime, sha256, cờ binary/truncated, thông tin git repo | | GET /api/nyx-file-panel.tree?path&cwd | 1 cấp thư mục (dir trước, tối đa 4000 entry) | | GET /api/nyx-file-panel.changes?sessionId&cwd | mọi file đã bị sửa trong session, kèm +N −M | | GET /api/nyx-file-panel.diff?path&cwd&sessionId&source | hunk: session (data.meta.diffs), git (git diff HEAD), hoặc none | | GET /api/nyx-file-panel.stat?path&cwd | size/mtime cho vòng poll | | POST /api/nyx-file-panel.write | ghi atomic + chống ghi đè (stale guard) | | GET /api/nyx-file-panel.health | kiểm tra service nào đang có | | GET /api/nyx-file-panel.probe?sessionId | nguồn đọc session nào trả lời, được bao nhiêu event |

Diff của session được đọc thế nào

Panel giữ index diff sống theo từng session, không quét lại log:

1. Seed 1 lần cho mỗi session — ctx.sessionQuery.readSession(id) (một pass đầy đủ của harness) và, với session nó từ chối/chưa ghi ra đĩa, đọc log $DSH_HOME/sessions/<group>/<id>/session.jsonl.zstd và giải từng frame. Log DSH là nhiều frame Zstandard nối nhau (mỗi append 1 frame); biên frame được tìm bằng cách đi theo header frame/block (magic cũng có trong dữ liệu nén) vì zstdDecompressSync của Node chỉ giải frame đầu. Seed từ log có trần (6000 frame mới nhất) và nhường event loop giữa batch nên không làm nghẽn harness.
2. Tươi miễn phí sau đó — ctx.on('session/event', …) fold mọi tool/result có meta.diffs vào index (khử trùng theo seq). Nhờ vậy đọc panel là O(1): đo trên session 4.5 MB / 208k event — lần đầu ~5s (pass của harness), mọi lần sau ~20ms, không đọc lại log kể cả sau vài phút.

Response có cờ live / sessionLive để biết nguồn. Không có hunk thì tab Changes rơi về git diff HEAD; worktree sạch thì báo none.

Restart

Client half được harness hot-reload (~0.5s sau khi lưu client.js). Host half (index.js) không hot-reload được trong app đã đóng gói (HMR module cần internals mà Electron host không có): sửa index.js thì cài lại + restart — client half được harness hot-reload (~0.5 s). Host half cần restart: thoát hẳn DSH Desktop rồi mở lại.

Giới hạn đã biết

• Cột phải chỉ render khi session hiện tại không blank (gate của chính layout). Không có session như vậy thì click vẫn mở file bằng app ngoài như cũ, chứ không "nuốt" cú click.
• Session log viết tay mà không đúng byte-exact có thể làm sessionQuery.readSession từ chối cả log; đường đọc từ đĩa bù được.
• File binary và file >1.5 MB chỉ được báo, không render.
• Nút Open IDE dùng lại đúng opener gốc — hành vi y như trước.

Đối chiếu Antigravity

Panel bám theo các mặt "artifact/review" của Antigravity: cột review ngay trong app thay vì mở editor ngoài, accept/reject theo từng chunk (ở đây là revert), cả hai chế độ diff inline và side-by-side, danh sách file đã đổi, artifact markdown/ảnh, và code search ngay trong cột — xem Antigravity artifacts và hướng dẫn diff view.

Changelog

• 0.6.1 — vòng chọn phiên bản. Trước đây sửa xong để lại một nhánh trông như phiên rác; giờ plugin nhớ quan hệ các bản (localStorage, khoá theo session + lượt) và vẽ ‹ n/m › dưới tin nhắn ở mọi bản: ‹ mở bản trước, › mở bản sau, có chỉ số bản hiện tại. Vòng này là overlay giống nút ✎ — không đụng DOM của DSH, không shadow renderer nào. Đã test live: sửa tin nhắn trong phiên bạn là ai → tạo nhánh, vòng hiện ở nhánh (‹ 2/2 ›) và ở bản gốc (‹ 1/2 ›), bấm ‹ quay về đúng bản gốc.
• 0.6.0 — sửa tin nhắn đã gửi rồi gửi lại. Rê chuột vào tin nhắn của mày: hiện nút ✎ (overlay của plugin, không đụng DOM của app), bấm vào là tin nhắn mở ra trong khung sửa ngay dưới bóng chat, có Hủy / Gửi lại và ⌘↵ để gửi. Vì log của DSH chỉ ghi thêm, "gửi lại" = tách nhánh: mốc fork là tin nhắn trước tin nhắn được sửa, đọc từ nhật ký phiên qua host (/api/nyx-file-panel.chat) chứ không đoán từ trang; DSH mở phiên nhánh với bản đã sửa được gửi sẵn vào đó. Tin nhắn đầu tiên của phiên không có mốc để tách, nên DSH mở một phiên mới cùng thư mục. Bản này cũng thêm route host chat (trả về các lượt người dùng kèm số seq trong log) và 4 check mới chạy trọn luồng (mở, điền sẵn, hủy, tách nhánh).
• 0.5.5 — thanh tab hoạt động lại. Bấm vào tab không có gì xảy ra: handler gọi activateTab — hàm này đã mất trong một lần refactor trước đó, nên quay lại file đã mở thì chết im lặng, trong khi dấu ✕ vẫn đóng được. Đã trả lại hàm (chuyển tab, nạp file nếu chưa nạp, vẽ lại) và bộ test giờ bấm tab cả hai chiều để không thể mất lần nữa mà không ai biết.
• 0.5.4 — panel không còn tự tắt. Trước đây bấm sang file khác khi panel đang mở thì cú bấm đó tính là "bấm ra ngoài" nên panel đóng, phải bấm lần hai mới mở file mới; giờ không có gì trên trang đóng nó nữa. Mở file khác = panel chuyển sang file đó luôn, và chỉ tắt bằng đúng thứ mày chủ động: ✕, Esc, ⌥⌘F. Panel cũng không còn chiếm cột details của layout (luôn dock) nên không bao giờ che panel riêng của app; khi cột đó mở (bấm tool call, kết quả tìm kiếm) panel tạm đứng xuống nhưng giữ nguyên tab và tự quay lại khi cột đóng.
• 0.5.3 — path trong tin nhắn thành cái cửa, và dải lượt được cho nghỉ. DSH chỉ làm click được đúng một thứ trong đoạn chat (chip ở tool row), nên path viết trong câu văn hay trong code bấm không có gì xảy ra — nhìn như plugin không tồn tại. Giờ panel đọc token ngay dưới con trỏ, cắt dấu câu, bỏ qua URL và 24/7, rồi resolve đúng y như viết và đưa qua cùng một cổng kiểm tra tồn tại — path không có thì bị từ chối kèm đúng tên của nó, không thay thế file nào. Path thật được gạch chân chấm + con trỏ pointer (debug.clickPaths(false) để tắt). Turn navigator mặc định được cho nghỉ (debug.hideTurnRail(false) để trả lại). Khi panel mở, đoạn chat tự nhường chỗ — chỉ 1 rule scoped trên đúng cột vốn đã sở hữu khoảng đó, xoá ngay khi panel đóng, chat giữ tối thiểu 560px, không ghi gì vào DOM của DSH. ~ giờ là home trên mọi hệ điều hành.
• 0.5.2 — dọn sạch rác còn sót. Hot-reload client bỏ lại cây React của thế hệ trước vẫn mounted (disposer chết theo module cũ), và nằm trong cột details 0px của layout thì nó tràn ra thành dải gạch dính ở mép cửa sổ. Giờ khi nạp, plugin gỡ thế hệ trước và xoá mọi thứ của mình còn trên màn hình lúc panel đóng; quét lại mỗi 15s và báo cáo mỗi lần quét (reason: strays hoặc swept trong file chẩn đoán).
• 0.5.1 — panel không còn đè lên panel của chính app. Ghế nó chiếm trong slot details có priority cao hơn entry của DSH, nên bấm vào tool call thì panel file hiện ra thay vì phần chi tiết tool — nhìn như panel của app hỏng. Giờ panel theo dõi cột details và nhường ngay khi layout mở cột đó, và không còn wrap openDetails của layout nữa (monkey-patch service của app là cách plugin kéo app chết theo). Lỗi nạp cũng rõ hơn: nếu apply fail, lý do nằm ở window.__dshFilePanel.error thay vì plugin im lặng không làm gì.
• 0.5.0 — panel không còn đụng vào thứ nó không sở hữu. Bỏ sạch: padding chèn vào cột giữa của layout, thuộc tính ghi lên body, ẩn phần tử DSH theo class, và tab nổi ‹ File panel. Panel giờ chỉ vẽ chính nó — một mặt phẳng fixed, 32% cửa sổ (300–420px) ở mép phải, các cột của layout để nguyên như DSH vẽ. Mở bằng cách bấm vào đường dẫn file trong chat (hoặc ⌥⌘F); đóng bằng bấm ra ngoài, Esc, hoặc nút ✕. Panel mở ra mà không có gì để hiện thì nói rõ, thay vì vẽ ra khoảng không.
• 0.4.3 — panel tự chọn bề rộng theo cửa sổ. Mặc định 32% viewport (300–420px) thay vì 420 cố định, dùng border-box nên con số đúng bằng bề rộng thật, và chỉ chèn vào chat khi chat còn giữ được ≥700px nội dung — dưới mức đó panel nổi ở mép thay vì bóp chat thành cột.
• 0.4.2 — panel tự mang "hộp đen". Client báo lại đúng cửa sổ nó đang chạy — build, mode, toạ độ panel, bề rộng các cột của layout, mức chèn vào chat — qua POST /api/nyx-file-panel.diag, host ghi nối vào nyx-file-panel-diag.jsonl cạnh harness home; tiêu đề cửa sổ cũng mang bản tóm tắt đó. Báo lỗi từ máy khác giờ đọc được thay vì đoán.
• 0.4.1 — panel vừa với chỗ được cấp. Việc dùng cột phải của DSH hay không giờ đo cột trước khi mount (seat nằm trong cột 0px từng vẽ ra một dải nội dung tràn ở mép cửa sổ), và khi không có cột thì dock chỉ chèn tối đa cột giữa − 520px, nên chat giữ được bề rộng đọc được thay vì bị bóp. DSH mở cột ⇒ panel nằm trong cột, không chèn, không đè.
• 0.4.0 — panel đẩy chat chứ không đè, và luôn có đường vào. Dock giờ chèn padding vào cột giữa (centerCol = bề rộng panel) thay vì phủ lên; một tab mảnh ‹ File panel ở mép phải (bấm để mở/đóng, ⌥⌘F từ bất kỳ đâu), và nó bám mép panel khi panel đang mở. Mở mà chưa có file thì hiện cây workspace. Panel chỉ hiện khi được gọi — click file, bấm tab, hoặc phím tắt.
• 0.3.9 — — dock không còn "dính": bấm ra ngoài hoặc Escape là panel ẩn đi; bề rộng bị chặn ở 45% cửa sổ; và dock không có gì để hiện (không tab, không notice) thì không vẽ ra — nên nó không thể nằm đè lên chat mà trông như lỗi.
• 0.3.8 — panel không bao giờ vô hình. Việc nó chiếm cột phải hay dock giờ đo thật (độ rộng thật của cột), không đoán theo bản sao công thức chia cột của DSH: ở vài cỡ cửa sổ cột phải resolve về 0px, panel vẫn mount ở đó thành dải 0px mà vẫn giữ ghế — nhìn y như UI hỏng. ResizeObserver đổi qua lại giữa cột và dock ngay khi layout đổi ý.
• 0.3.7 — không mở gì trừ khi nó có thật trên đĩa. Mọi đường vào (link chat, tool row, cây file, quick open, dòng review) đều stat trước: path không tồn tại bị từ chối kèm đúng đường dẫn tuyệt đối đã thử và không tạo tab nào, nên panel không bao giờ trông như đã mở một file không tồn tại. Link thư mục vẫn mở cây file. Host từ chối trả byte cho path thiếu (404 not-found) và từ chối mọi thứ không phải file thường.
• 0.3.6 — surface Edit thành editor kiểu IDE: gutter số dòng cuộn theo text và sáng dòng đang đứng, band dòng hiện tại, Ln, Col, Tab = 2 spaces, Enter giữ indent, Cmd-S lưu có sha-guard, Revert edits.
• 0.3.5 — link mở đúng path nó ghi. Cơ chế dò basename (và danh sách "chọn 1 trong các file giống tên") đã bị bỏ: link tới <root>/index.js mở đúng file đó hoặc báo không có, không bao giờ mở file cùng tên ở chỗ khác. Màn hình lỗi in ra đúng chuỗi link + đường dẫn tuyệt đối đã resolve, kèm nút Search workspace tự nguyện — không mở gì cho tới khi mày chọn. Route resolve phía host vẫn còn như API cho tooling; luồng link không còn gọi nó.
• 0.3.4 — một file = một tab, luôn luôn. Link trong chat được resolve trước khi tab tồn tại (nên cách viết sai không còn để lại tab rỗng nằm cạnh file thật), và mọi kết quả bất đồng bộ khớp với tab qua id ổn định thay vì so chuỗi đường dẫn. Thêm: thanh đường dẫn đầy đủ dưới tên file (bấm để copy), khối chi tiết file (path, relative, size, lines, modified, sha256, language, encoding, session +/-, nguồn link), tooltip đường dẫn tuyệt đối ở cây file, nút Copy path trong Review, banner Opening <path>… khi link đang resolve, tự nạp khi chọn tab chưa có nội dung, và event trace 120 dòng ở window.__dshFilePanel.state(sessionId).events. Bộ test: 36 check rig, 17 check live.
• 0.3.1 — làm lại renderer diff: hàng đã canh LCS với số dòng cũ/mới thật, màu theo theme IDE, change bar, hatch bên trống, gộp context, header 1 dòng có ⌖ nhảy hunk và ↺ revert, thêm gợi ý khi panel hẹp cho side-by-side.
• 0.3.0 — nhiều tab file, tab Review, revert từng hunk/cả file, side-by-side diff nhấn mạnh từng từ, quick open + tìm nội dung bằng ripgrep, preview markdown/ảnh, chọn dòng + notes; sửa lỗi panel rò file của session này sang cột của session khác (đổi session là nhả ghế).
• 0.2.1 — index diff sống theo session (seed 1 lần, sau đó session/event), đọc panel luôn O(1).
• 0.2.0 — đi biên frame zstd đúng, scan log có trần + nhường event loop, so path canonical, client không chặn.

License

MIT