前言¶
在 DeepSeek Harness(DSH)裏做智能體或長對話開發時,右側欄「文件」頁默認是樹形目錄。文件一多,很難一眼看出「先寫了什麼、後落了什麼」,也很難按對話或日期把某次產出找出來。社區插件 dsh-creation-timeline(中文名:創作軌跡)把同一頁改成按創建時間升序的時間線,並在宿主側補充工作區掃描與刪除能力;安裝後通過頭部開關在「時間線」與原生文件樹之間切換,不改動平臺源碼。
這是什麼¶
dsh-creation-timeline 是面向 DSH Web 客戶端的插件 bundle,維護者爲 fengtianyang523。package.json 中版本爲 1.0.1,許可證 MIT。它在右側欄「文件」頁增加「按時間順序」開關:打開後展示可搜索、可篩選、可多選刪除的創作時間線;關閉則恢復平臺原文件樹。
插件目錄頁:https://www.skillhub.cn/plugins/fengtianyang523/dsh-creation-timeline
源碼與說明:https://github.com/fengtianyang523/dsh-creation-timeline
核心功能¶
下面按 README 中已列能力簡述;未在資料中出現的細節不寫。
時間線與分組¶
- 文件按創建時間升序:較早的在上,最近的在下;左側豎線與圓點串聯,最新一條高亮。
- 日期分組:組頭顯示「今天 / 昨天 / 10月8日 / 2024年10月8日」等,組間留白更大,豎線按組獨立。
文件來源與展示¶
- 真實文件清單:除會話中寫入過的文件外,會遞歸掃描工作區(深度 ≤ 4、≤ 4000 條),把原有文件一併列出;跳過
node_modules、.git、dist、build、target、.cache。 - 類型圖標:與平臺
FileTypeIcon同一套圖形(Word/PDF/Excel/PPT/Markdown/圖片/視頻/代碼等),按類型着色。 - 成品 / 過程文件:成品(docx/pdf/png/mp4 等)用主色;腳本與中間產物(py/json/txt/yml 等)用三級灰。
- 已刪除:宿主用
lstat判定;灰字、刪除線、圖標去飽和;不可選中、無懸停、不參與篩選。
搜索、範圍與操作¶
- 搜索:支持文件名、路徑、對話名、時間(如
今天、10月8日、10-08、2026-10-08、18:42);多關鍵詞空格分隔取交集。 - 顯示範圍:摺疊菜單可選「顯示全部文件」或「僅重點文件」(未刪除的成品)。
- 右鍵菜單:複用平臺原生文件菜單,並追加「刪除…」。
- 刪除:支持單個或批量;批量只彈一次確認;刪除走宿主端點,限定在工作區內。
- 多選:「選擇」進入多選模式,左側圓點變勾選框;紅色「刪除 (N)」提交。
- 字號與語言:字號引用平臺內容字號變量;界面語言跟隨應用(中文用中文,其餘回退英文)。
安裝與啓用¶
兩種方式任選其一。
本地包安裝¶
在 DSH 插件管理器中使用「安裝本地包 / Install bundle」,選擇包含 package.json 與 cordis.patch.yml 的插件目錄。安裝後刷新頁面,右側欄「文件」頁頭部會出現「按時間順序」開關。
從 GitHub 安裝(Web 配置)¶
README 給出的命令如下:
dsh plugin --profile web add "github:fengtianyang523/dsh-creation-timeline#v1.0.1"
安裝後建議按順序操作:
- 打開右側欄「文件」頁;
- 打開頭部開關 → 時間線視圖;關閉 → 原生文件樹;
- 在時間線面板內使用搜索框、顯示範圍菜單,以及「選擇 / 批量刪除」。
卸載:在插件管理器中停用或移除本插件,文件頁立即恢復平臺原樣。
典型用法¶
- 按時間回顧產出:開啓「按時間順序」,從最新條目向上看,結合日期分組判斷某天的 docx、代碼或配置是何時出現的。
- 按對話或關鍵詞定位:在搜索框輸入對話名或文件名片段;需要按日期篩時輸入
今天、2026-10-08等形式。 - 只看成品:顯示範圍選「僅重點文件」,減少腳本與中間文件干擾。
- 清理工作區文件:進入「選擇」,勾選多條後點「刪除 (N)」;刪除前確認路徑在工作區內。
兼容性與已知限制¶
兼容性(資料原文):
- 目標契約:DSH 0.2.2-rc.1 客戶端槽位;使用
slots、locale、uiWorkspace、sidebarRight、contextMenus與宿主的connection、sessionPersistence、fs。 - 不 import 平臺客戶端包;平臺升級若改動文件頁頭部 DOM 標記(
[data-files-page]/[data-files-content]),時間線面板測量可能退化到整頁兜底,仍可用但位置可能不準。
已知限制(安裝前宜知曉):
- 會話內寫過的文件用「第一次寫入時間」;其餘用文件系統創建時間(取不到則用修改時間)。掃描部分直接讀進程文件系統(只讀),因
ctx.fs不提供時間戳。 - 掃描:工作區根內深度 ≤ 4、≤ 4000 條;索引條數上限 300(按最近修改排序截斷)。
- 索引與刪除僅通過 DSH 已認證所有者連接訪問,且工作區須已有宿主保存的會話;刪除會檢查解析後的實際路徑並遵循宿主寫入策略。
- 工作區名取根目錄名,不是工作區顯示標題。
插件在 DSH 進程權限下運行;安裝前請自行查看 倉庫源碼 與 MIT 許可證。client.js 內嵌的部分文件類型圖形來自 DeepSeek Harness 對應版本分支,版權聲明見倉庫 LICENSE。
結尾¶
dsh-creation-timeline 把右側欄文件頁改成可搜索的創作時間線,併合並工作區掃描與受控刪除,適合需要在 DSH 裏按時間與對話追溯文件、又希望保留原生文件樹的用戶。詳情與更新以 GitHub README 爲準。