前言¶
用 DeepSeek Harness（DSH）或 Claude Code、Cursor 等 agent 做編程會話時，截圖、驗證腳本、臨時下載和中間產物往往會堆在工作目錄頂層。幾天之後，頂層條目上百、體積數 GB 卻不敢刪——亂的不只是體積，而是顆粒度：小文件和源碼、文檔平鋪在同一層，誰也說清哪張圖還有用。另一個常見問題是命名在開幹前定下，會話裏可能多主題，隔幾週再看文件夾名對不上實際內容。
下面介紹社區插件 dsh-session-artifacts（GitHub：feely0208/dsh-session-artifacts，維護者 feely0208，分類：記憶）。它把「每個會話一個專屬文件夾、收尾按實際內容改名、刷新索引」做成可重複流程；隨 DSH 以 skill 插件分發，三個腳本是純 bash，不依賴 DSH，在其他 agent 環境裏也能直接用。
這是什麼¶
會話產物歸攏與命名：默認在 ~/會話產物（可用環境變量 SESS_ROOT 覆蓋）下，爲每次會話建專屬目錄；會話中的截圖、腳本、臨時文件等一律放進該目錄，而不是散落在工作區根、/tmp 或 $HOME 根。收尾時用 sess-rename.sh 按實際完成的內容改名（腳本保留原日期前綴），再用 sess-index.sh 生成或刷新 INDEX.md，便於事後檢索。
npm 包名爲 @deepwhale-cn/dsh-session-artifacts，當前版本 0.1.0，許可證 MIT；要求 DSH >=0.1.0-rc.6（見 package.json）。
它解決的兩類問題¶
產物散落¶
多會話共用一個工作目錄時，頂層會混有大批量截圖、多個會話產物目錄以及真正的源碼與構建工具。這類文件往往不在版本控制裏，刪錯不可恢復，結果常常是「整個目錄放着不敢動」。
名字對不上內容¶
命名若在「開幹前」完成，而內容在「幹完之後」才確定；單會話多主題、隔週交接時，單靠文件夾名很難回憶具體做了什麼。插件的做法是命名分兩段：開干時用粗糙臨時名，收尾再按主線改名；文件夾名作索引鍵，會話目錄內的 README.md 寫全清單，INDEX.md 作總表。
核心功能¶
1. 歸攏：每會話一個文件夾¶
目錄結構示例（來自 README）：
~/會話產物/
2026-10-11-律師端UI定稿與v0.1.12發版/
2026-10-10-深鯨畫布上架插件市場/
2026-10-09-鴻蒙涉外文書排版/
INDEX.md
_歸檔/
2. 命名：臨時名 → 收尾改名¶
| 階段 | 做什麼 |
|---|---|
| 開干時 | sess.sh <關鍵詞> 建文件夾，名字粗糙即可 |
| 收尾時 | 回顧會話實際內容，sess-rename.sh --apply <舊> <新> 改名 |
3. 索引¶
sess-index.sh 刷新 INDEX.md，表格含日期、會話名、體積、文件數、摘要等，便於幾個月後查找。
安裝與啓用¶
作爲 DSH 插件¶
安裝命令（README 原文）：
dsh plugin add @deepwhale-cn/dsh-session-artifacts
裝完後重啓 DSH，技能自動可用。
插件在 當前 DSH 進程的權限 下運行；安裝前建議在 GitHub 倉庫覈對源碼與 MIT 許可證，確認符合你的環境策略。
僅使用 bash 腳本¶
三個腳本位於倉庫 bin/：sess.sh、sess-rename.sh、sess-index.sh。README 說明可將 bin/*.sh 複製到 PATH 中的目錄（例如 /usr/local/bin/）。不裝 DSH 時也可單獨使用。
典型用法¶
會話首次要存文件時，建專屬文件夾（冪等，同一天多次調用複用同一目錄）：
DIR=$(sess.sh 律師端輝光)
echo "$DIR"
# → 例如 /Users/you/會話產物/2026-10-11-律師端輝光
收尾時按實際內容改名（保留日期前綴）：
sess-rename.sh --apply 律師端輝光 律師端UI定稿與v0.1.12發版
刷新索引：
sess-index.sh
# → 已刷新 ~/會話產物/INDEX.md
命令速查¶
| 命令 | 作用 |
|---|---|
sess.sh <主題> |
建或複用當天目錄並打印路徑 |
SESS_NEW=1 sess.sh <主題> |
同一天強制新建（後綴 -2、-3 等） |
sess-rename.sh --list |
列出所有會話文件夾 |
sess-rename.sh --apply <舊> <新> |
改名（模糊匹配；重名拒絕） |
sess-rename.sh --apply <舊> <新> --dry |
預覽改名結果 |
sess-index.sh |
刷新 INDEX.md |
命名建議（README）：動詞 + 對象、主線優先；多主題並列可用 +；不要塞日期（腳本保留）；避免「工作、雜項、臨時」等泛詞。多主題時文件夾名取主線，細節寫在會話目錄的 README.md。
適用場景與注意¶
適合：長期用 agent 編程、會話產出文件多、需要按時間與主題留痕或交接的團隊或個人；法律、財務、醫療等需要可追溯工作記錄的場景，有組織、可檢索的會話目錄可作爲審計友好的基礎設施。
環境：DeepSeek Harness（插件安裝）、Claude Code / Codex / Cursor（僅用腳本）、macOS / Linux；Windows 需 WSL 或 Git Bash（腳本使用 bash 數組與 [[ ]]）。
注意：產物根目錄默認 ~/會話產物，用 SESS_ROOT 可改。腳本操作的是本地文件系統，權限與運行 DSH 或執行腳本的用戶一致；安裝插件或拷貝腳本前請自行審查倉庫代碼。
結尾¶
dsh-session-artifacts 用極低成本的命令把「散落」和「記不清」拆成歸攏、收尾改名、刷索引三步，既可作爲 DSH 記憶類 skill 插件，也可在任意 agent 工作流裏單獨用三個 bash 腳本。
- 社區目錄頁：https://www.skillhub.cn/plugins/feely0208/dsh-session-artifacts
- 源碼與完整說明：https://github.com/feely0208/dsh-session-artifacts
DSH 生態採用「一切皆插件」思路；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
