前言¶
用 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 / 幻方无官方从属关系。
