前言¶
用 DeepSeek Harness（dsh）在網頁裏跑長任務時，最常見的麻煩不是任務本身跑不完，而是過程看不清。思考、上下文、命令輸出和工具調用會順着對話一條條往下刷，當前做到哪一步、已經跑了多久，往往要在一長串技術消息裏自己找。任務結束後，這些過程記錄還佔着主視線，真正要讀的答案反而被擠到後面。
DeepSeek Harness 是 DeepSeek AI 開源的 agent harness，目前處於開發者預覽階段，核心理念是「一切皆插件」：模型、工具、會話、沙箱和界面都可以替換或組合。社區圍繞會話界面做了不少擴展。本文介紹的 deepseek-harness-ux 針對的就是網頁裏的長任務觀感：關鍵進度先看得見，完成後過程自動收起，細節需要時再展開。
需要先說明兩件事。第一，社區插件目錄是獨立站點，和 DeepSeek / 幻方沒有官方從屬關係，不能當成官方應用商店。第二，這個倉庫自己也寫得很清楚：它不是 DeepSeek 官方發行版，也不享有上游官方支持。
這是什麼¶
deepseek-harness-ux 由 ayuanwong 維護，主要語言是 TypeScript，許可證爲 BSD-3-Clause。社區目錄把它歸在「會話與消息」分類，GitHub 倉庫當前 13 星（2026-08-17 覈實；目錄頁當時顯示 10 星）。倉庫簡介是：長任務不刷屏，關鍵進度清晰可見，完成後自動摺疊，詳情隨時展開。
定位上，它是基於上游 DeepSeek Harness 源碼快照維護的社區網頁版。README 寫明：它沒有重寫 Agent 的工作方式，而是重點改進網頁裏的任務過程、長回答、會話查找和文件入口。根目錄 package.json 裏的包名仍是 @deepseek-ai/dsh-root，版本號爲 0.0.1-rc.2，這是上游快照留下的工作區元數據；倉庫同時聲明，自己不會向 @deepseek-ai scope 發佈 npm 包。
這裏有一處需要交叉看的信息。社區目錄頁給出的安裝命令是 dsh plugin add github:ayuanwong/deepseek-harness-ux，也就是按普通插件收錄的。倉庫 README 則明確寫道：本倉庫交付的是完整源碼版本，不是能直接安裝到乾淨上游倉庫的補丁，也沒有單獨發佈爲 npm 插件。社區站點 DSH Find 的介紹同樣把它寫成「不是插件，需要從源碼運行」。安裝方式以倉庫一手說明爲準，目錄裏的 dsh plugin add 只代表該站點的收錄寫法，不代表可以把它當補丁打進官方 dsh。
核心功能¶
倉庫 README 把用戶能直接感受到的差異寫成了七項。對照官方源碼時，維護者給出的依據是：UX 功能源碼基於提交 35c6172，說明文檔以 2026-08-17 的官方提交 47f9438 爲對照，只記錄用戶能感知的差異，不把測試、包元數據和機械性源碼差異包裝成產品能力。
1、會話進行時，思考和工具步驟不會一直刷屏。任務運行時，思考、上下文、命令和工具調用會被收進一個穩定的「過程」區域。可以直接看到當前做到哪一步、已經運行多久，不必在大量技術消息裏尋找進度。如果啓用展示輔助，界面還會用一次很小的模型請求，把 Todo、思考和工具證據整理成更容易理解的階段名稱。這個請求只負責顯示，不會改變 Agent 的回答。
2、任務完成後，過程自動摺疊，答案回到主視線。正常完成的任務會自動收起思考過程；遇到失敗或中斷時，過程會繼續展開，方便檢查問題。需要覈對細節時，點一下就能重新展開「運行詳情」。
3、長日誌可以單獨滾動。展開運行詳情後，長命令輸出和工具日誌會在自己的區域裏滾動。滾到邊緣時不會突然把整個對話帶走，底部輸入框也不會把頁面頂出一大片空白。
4、長回答更適合閱讀。回答的段落、標題和不同輪次之間更緊湊。任務結束後，可選的展示輔助還能優化答案標題；複製內容、會話歷史和模型看到的原始答案都不會被改寫。任務剛結束時，網頁會在後臺補齊最後一段歷史，避免晚到的結束事件讓界面看起來還在運行，也不會閃出新的加載頁。
5、以前的會話更容易找。會話默認按最近更新時間排列，也可以切回手動排序。側邊欄可以搜索標題、工作區名稱和當前進程中的對話內容；「未分組」區域也能直接新建不屬於任何工作區的會話。
6、生成的文件更容易找到。除了工具明確寫出的文件，UX 版還會識別答案裏清楚列出的文檔、表格、數據集、圖片、音視頻、壓縮包、數據庫和 3D/CAD 文件路徑，把它們顯示成可打開的產物入口。普通文字、網址、命令和示例代碼不會被誤當成文件。
7、模型配置集中在設置頁。首次使用時會直接進入「設置 → 模型」的完整配置卡，不再維護另一套簡化的密鑰彈窗。提供方、模型、API Key 和錯誤恢復都在同一個地方完成。
它沒有改動的部分同樣寫在 README 裏：Agent Loop、模型路由、工具、權限、沙箱和 Session Log 仍沿用 DeepSeek Harness 的執行方式；原始思考、上下文、命令和工具證據沒有被刪除，只是收進「運行詳情」；展示輔助不會修改 System Prompt、用戶消息、工具、原始回答或會話歷史；Session Log 默認仍保存在本地。
安裝與啓用¶
社區目錄頁上的安裝命令原文如下，在 DeepSeek Harness 終端中複製運行即可。如需可復現安裝，目錄頁提供了固定 commit 哈希的寫法：
dsh plugin add github:ayuanwong/deepseek-harness-ux
dsh plugin add github:ayuanwong/deepseek-harness-ux#commit
上面第二條裏的 commit 需要替換成實際提交哈希。目錄頁同時提醒：插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。安裝前請檢查源代碼倉庫和許可證。
就這個倉庫而言，更接近一手的用法是從源碼運行整份工作區，而不是把它當成打進官方安裝的補丁。環境要求是 Node.js ^22.19 或 >=24、pnpm 11，以及兼容 DeepSeek 的 API Key。倉庫 package.json 裏寫明的包管理器是 pnpm@11.7.0。
git clone https://github.com/ayuanwong/deepseek-harness-ux.git
cd deepseek-harness-ux
pnpm install
pnpm run build
pnpm run dsh -- web --port 3081
啓動後打開 http://127.0.0.1:3081，在「設置 → 模型」中添加模型提供方，然後新建會話。如果 3081 已被佔用，可以換成其他端口。官方上游默認網頁端口是 3080，這個社區版 README 示例用的是 3081。
典型用法¶
1、在網頁裏新建會話，發起一個會走多步工具調用的任務。運行過程中看「過程」區域：當前階段和已運行時間會留在這塊穩定區域裏，思考和工具調用不再把整頁刷下去。
2、任務正常結束後，過程會自動收起，最終答案留在最顯眼的位置。如果要覈對某次命令或工具證據，展開「運行詳情」即可；長日誌在自己的區域裏滾動，不會拖着整段對話一起走。
3、需要找以前的會話時，側邊欄默認按最近更新時間排列，也可以搜索標題、工作區名稱和當前進程中的對話內容。不屬於任何工作區的會話，可以從「未分組」區域直接新建。
4、如果回答裏清楚列出了文檔、表格、數據集、圖片等文件路徑，界面會把它們顯示成可打開的產物入口。普通敘述、網址和示例代碼按倉庫說明不會被當成文件。
5、展示輔助是可選能力。啓用後，網頁展示服務會用當前會話配置的模型提供方，發起有界、僅用於顯示的請求：進行中整理階段名稱，結束後可以優化答案標題。主 Agent 看不到額外指令，原始回答和會話歷史也不會被改寫。輔助路徑不可用時，任務繼續跑，界面回退到本地標題。需要注意：啓用階段或標題整理時，會把受限的運行證據發送給該提供方。
適用場景與注意事項¶
如果你主要在網頁裏運行長任務，希望過程更清楚、回答更好讀、會話和文件更容易找到，可以選擇 DeepSeek Harness UX。如果你更在意最新官方更新、npm 安裝、Headless 或 CLI 工作流，應優先選擇官方 DeepSeek Harness。
和官方版本相比，README 還列了這些邊界，安裝前值得看完：
- 這是基於上游源碼快照維護的社區版本，不會自動獲得官方後續的修復、兼容性更新和安全更新。
- 這個快照還沒有官方後來加入的部分能力，例如更嚴格的冷會話校驗、隱藏當前無法登錄的 OAuth-only 提供方，以及新的全局界面擴展位。
- 當前沒有內建的 Codex OAuth 登錄和 Token 自動刷新；選擇
openai-codex路由時需要手動提供 Token。 - 基礎 Bundle 會安裝休眠狀態的 Codex 和 Claude Code 子代理提供方，但不會因此自動啓動對應產品進程。
- 官方版提供 npm 包，默認可用
npx @deepseek-ai/dsh web啓動；這個倉庫只提供源碼運行。 - 當前官方源碼使用 MIT 許可證；這個分支保留其上游快照當時採用的 BSD 3-Clause 許可證和相關聲明。LICENSE 文件中的版權聲明仍爲 Copyright (c) 2026, DeepSeek。
另外，不要提交 .env、.npmrc、API Key、本地 Session、構建產物或 profile 數據。啓用任何非默認遙測模式前，請先閱讀上游遙測設置。無論是按目錄頁的 dsh plugin add 嘗試安裝，還是按 README 從源碼啓動，代碼都會以當前進程權限運行，安裝或克隆前應檢查源碼與許可證。
小結¶
deepseek-harness-ux 要解決的是網頁長任務「過程刷屏、答案被擠走」這件事。它把思考和工具調用收進可摺疊的過程區，完成後把視線還給答案，同時補了會話查找和產物入口，但並不改 Agent 循環、工具和權限。它是社區源碼版，不是官方發行，也不宜按普通插件補丁來理解。目錄頁和 GitHub 地址如下：
- 目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/deepseek-harness-ux/
- GitHub：https://github.com/ayuanwong/deepseek-harness-ux
- 官方上游：https://github.com/deepseek-ai/deepseek-harness
