前言¶
在 DeepSeek Harness（DSH）Web 中做智能體開發時，常需要查看智能體生成或修改的文件。CodeReader 是 DSH Web 插件，把工作區文件樹與多標籤編輯畫板放進對話界面，方便在同一窗口內瀏覽、覈對、編輯並寫回當前工作區磁盤。
這是什麼¶
CodeReader 是 DSH Web 插件，由 PathChan 維護，許可證爲 MIT。它的定位是：在 DSH Web 的對話界面中提供工作區文件樹與多標籤編輯畫板。
package.json 名稱爲 codereader，倉庫爲 PathChan/CodeReader。
核心功能¶
工作區文件樹¶
- 提供「打開文件」入口。
- 目錄可逐級展開。
- 顯示文件圖標。
- 點擊文件後在右側畫板打開。
多標籤編輯畫板¶
- 支持多標籤打開源文件與產物。
- 當前文件可直接編輯。
- 提供語法高亮與行號。
- 未保存標籤以圓點標識，關閉前將提示確認。
保存與打開¶
- 通過
Ctrl+S/Cmd+S或工具欄保存。 - 保存後內容寫回當前工作區磁盤，並在寫入後校驗。
- 可將當前文件交由系統默認程序打開。
與智能體協同¶
- 智能體生成過程中，畫板自動切換爲只讀，避免與模型同時改寫同一文件。
- 點擊對話中的產物路徑時，可按設置選擇「系統默認軟件」或「在工作區畫板中打開」。
設置¶
偏好保存在本機瀏覽器，不經過服務端。可設置：
- 默認打開方式
- 編輯器主題：跟隨 Harness、深色、淺色
- 文件樹設置入口
安裝與啓用¶
使用前需已安裝 DSH，並使用 Web 配置。
安裝插件：
npx @deepseek-ai/dsh plugin --profile web add github:PathChan/CodeReader
安裝後啓動 DSH Web，然後在側欄使用文件樹入口。
從本倉庫源碼安裝時，先構建再加入配置：
npm install
npm run build
npx @deepseek-ai/dsh plugin --profile web add .
典型用法¶
1、安裝插件並啓動 DSH Web。
2、在側欄工作區文件夾行點擊「打開文件」。
3、在文件樹中打開目標文件，於右側畫板編輯；保存後即寫入磁盤。
4、如需使用本機程序打開，請使用畫板工具欄中的「在系統默認軟件中打開」。
適用場景與注意¶
CodeReader 適合使用 DSH Web、希望在對話界面內快速查看、覈對或修改工作區文件的人。它圍繞當前工作區提供文件瀏覽與編輯，不擴展工作區以外的路徑訪問。
注意：
- 讀寫範圍限於當前工作區目錄，不會訪問工作區以外的路徑。
- 插件以當前 DSH 進程權限運行；安裝前應檢查源碼與許可證。
- 智能體生成過程中，畫板自動切換爲只讀，避免與模型同時改寫同一文件。
- 偏好保存在本機瀏覽器，不經過服務端。
鏈接¶
GitHub：https://github.com/PathChan/CodeReader
許可證：MIT
