前言¶

在 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"

安装后建议按顺序操作：

1. 打开右侧栏「文件」页；
2. 打开头部开关 → 时间线视图；关闭 → 原生文件树；
3. 在时间线面板内使用搜索框、显示范围菜单，以及「选择 / 批量删除」。

卸载：在插件管理器中停用或移除本插件，文件页立即恢复平台原样。

典型用法¶

1. 按时间回顾产出：开启「按时间顺序」，从最新条目向上看，结合日期分组判断某天的 docx、代码或配置是何时出现的。
2. 按对话或关键词定位：在搜索框输入对话名或文件名片段；需要按日期筛时输入 今天、2026-10-08 等形式。
3. 只看成品：显示范围选「仅重点文件」，减少脚本与中间文件干扰。
4. 清理工作区文件：进入「选择」，勾选多条后点「删除 (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 为准。

• 社区目录：https://www.skillhub.cn/plugins/fengtianyang523/dsh-creation-timeline
• GitHub：https://github.com/fengtianyang523/dsh-creation-timeline