dsh-session-artifacts

会话产物归拢与命名

给 AI 编程会话用的工作区整理方法 —— 每个会话一个专属文件夹，收尾时按实际内容改名，并刷新索引。

随 DeepSeek Harness 的 skill 插件分发；三个脚本是纯 bash，不依赖 DSH —— Claude Code / Codex / Cursor 或任何 agent 都能直接用。

---

它解决两个问题（不是假设，是真踩出来的）

问题一：产物散落 → 工作目录失控

多个会话共用一个工作目录，跑几天之后就变成了这样：

3.46 GB / 514 个顶层条目
  ├─ 305 个散落在顶层的截图   1.jpg、10.png、12_small.png …（只占 59 MB）
  ├─ 42 个会话产物目录        帧序列 318M、宣传视频 484M、素材库 2.2G …
  └─ 剩下的才是真东西         构建工具、源码、文档

关键点：乱的不是体积，是颗粒度。 那 305 张截图只占 59 MB —— 但它们和源码、文档、 构建工具平铺在同一层，于是「哪张图还有用、哪个目录能删」谁也说不清， 最后只能整个目录一起放着不敢动。

二次伤害：这些文件通常没有版本控制，删错不可恢复 —— 「乱」直接变成「不敢清理」。

问题二：名字对不上内容

把东西归好类之后，还有第二个坑：

「有些时候我们自己很忙，直接开干了，而且一个会话中不一定只有一个主题， 所以结束后或者交接后再放一段时间，自己就不是很清楚具体内容了。」

三段根因：

1. 命名时机错 —— 名字是在"开干前"起的，而内容是在"干完之后"才确定的。
2. 会话多主题 —— 一个名字概括不了整天做的事。
3. 人的记忆会淡 —— 交接或隔几周回来，光看文件夹名想不起来。

所以：命名必须分两段。

---

它做什么

1. 归拢：每个会话一个专属文件夹

~/会话产物/
  2026-10-11-律师端UI定稿与v0.1.12发版/
  2026-10-10-深鲸画布上架插件市场/
  2026-10-09-鸿蒙涉外文书排版/
  INDEX.md                    ← 自动生成的索引
  _归档/                      ← 收起来的旧会话

截图、验证脚本、临时下载、中间产物一律进去，不写工作目录根、不写 /tmp、不写 $HOME 根。

2. 命名：开干时临时名 → 收尾按实际内容改名

脚本自动保留原日期前缀 —— 日期是「会话发生的时间」，不该被改名弄丢。

3. 索引：几个月后还能查

| 日期 | 会话 | 体积 | 文件 | 摘要 |
|---|---|---|---|---|
| 2026-10-11 | 律师端UI定稿与v0.1.12发版 | 4.0K | 1 | 律师端 UI 定稿（查看原文/术语标注/按钮态）… |

名字概括主线，README.md 写全内容，INDEX.md 汇总 —— 三层各司其职。

---

安装

作为 DSH 插件

dsh plugin add @deepwhale-cn/dsh-session-artifacts

装完重启 DSH，技能自动可用。

只用脚本（任何 agent）

三个脚本是纯 bash，拷走即可：

git clone https://github.com/feely0208/dsh-session-artifacts.git
cp dsh-session-artifacts/bin/*.sh /usr/local/bin/     # 或任何在 PATH 里的目录

---

用法

# 1) 会话首次要存东西时：建专属文件夹（幂等）
DIR=$(sess.sh 律师端辉光)
echo "$DIR"
# → /Users/you/会话产物/2026-10-11-律师端辉光

# 2) 收尾时：按实际内容改名（保留原日期）
sess-rename.sh --apply 律师端辉光 律师端UI定稿与v0.1.12发版
#   旧: 2026-10-11-律师端辉光
#   新: 2026-10-11-律师端UI定稿与v0.1.12发版

# 3) 刷新索引
sess-index.sh
# → 已刷新 ~/会话产物/INDEX.md

命令速查

根目录可用 SESS_ROOT 覆盖（默认 ~/会话产物）。

---

命名规范

• 动词 + 对象：做了什么
• 主线优先：多主题时取主线，不要贪全
• 多主题确实并列时用 + 连：官网发版+插件市场上架
• 不要塞日期（脚本保留原日期）
• 不要用泛词：工作、杂项、整理、临时、各种、其他

多主题会话怎么处理

正解是分工，不是把名字撑长：

名字    = 索引键（要好记、要短）   →  取主线
README  = 内容清单（要全）        →  写全
INDEX   = 总索引（要能搜）        →  自动生成

# 2026-10-11 · 律师端UI定稿与v0.1.12发版     ← 名字概括主线

## 这个会话做了什么                          ← README 写全
1. 鸿蒙律师端「查看原文」对齐桌面端
2. 桌面端 UI 规范整改
3. 移植「深鲸辉光」（三次迭代）
4. v0.1.12 发版上官网
5. 官网源码纳入版本控制
6. 清理 9.2 GB 冗余

---

为什么这件事值得做（不是强迫症）

1. AI 会话的产物天生是碎的 —— 截图、脚本、临时包，一次几十上百个。 没有归宿，它们就只会堆在工作目录里。
2. 留痕对很多行业是硬要求 —— 法律、财务、医疗的工作记录需要可追溯。 有组织、可按时间和主题检索的会话产物，本身就是审计友好的基础设施。
3. 成本极低 —— 建文件夹是一条命令，改名是一条命令。 而事后整理一个 500 项的目录，成本高一个量级（这个仓库就是这么来的）。

---

兼容性

---

License

MIT · 由 深鲸 DeepWhale 维护

---