dsh-archived-panel

English · 中文

中文

dsh-archived-panel 是一个 DeepSeek Harness 社区插件，在侧边栏提供「已归档」面板：

• 显示已归档会话的标题、工作区和相对时间。
• 点击会话即可重新打开。
• Host 支持 unarchiveSession 时可以取消归档。
• Host 支持 deleteSession 时可以永久删除已归档会话（删除前会二次确认）。
• Host 尚未安装补丁时自动隐藏对应的操作按钮，查看和打开功能不受影响。

插件以 DSH bundle 分发：cordis.patch.yml 挂载 Host 条目，浏览器功能由 dsh.client bundle 加载。

兼容性

安装

从本地检出安装到 web profile：

dsh plugin --profile web add ./dsh-archived-panel
dsh --profile web

从 GitHub 安装：

dsh plugin --profile web add github:chensl139-ok/dsh-archived-panel

git 安装会从源码运行 prepare。pnpm 10 及以上版本默认可能阻止依赖的构建脚本；发生这种情况时，把 pnpm 输出的包名加入对应 profile 的 pnpm-workspace.yaml：

allowBuilds:
  dsh-archived-panel: true

随后重新执行安装命令。安装成功后，dsh plugin 会根据本包的 dsh.bundle 声明自动把它加入 profile 的 bundle 列表。

启用取消归档

查看和打开功能无需修改 DSH。取消归档需要把仓库中的 Host/runtime 补丁应用到与其匹配的 DeepSeek Harness 0.1.0-rc.7 源码检出：

# 在 deepseek-harness 仓库根目录执行
git apply --check /path/to/dsh-archived-panel/patches/unarchiveSession.diff
git apply --check /path/to/dsh-archived-panel/patches/unarchiveSession.tests.diff
git apply /path/to/dsh-archived-panel/patches/unarchiveSession.diff
git apply /path/to/dsh-archived-panel/patches/unarchiveSession.tests.diff

pnpm run build:lib:host
pnpm run build:lib:client

补丁提供以下完整链路：

WorkspaceRegistry.unarchiveSession
  → workspace.unarchiveSession RPC
  → fetch client/runtime
  → ctx.workspaces.unarchiveSession
  → 已归档面板

补丁涉及的文件、测试支持和限制详见 patches/README.md。应用前务必运行 git apply --check；如果目标 DSH 版本不同，请重新生成或人工迁移补丁，不要强制应用。

未启用取消归档补丁时，仅能查看和打开。启用后可取消归档；启用删除补丁后可永久删除。删除会调用 ctx.workspaces.deleteSession(id)，由 Host 拆除会话日志（sessionPersistence.delete）并从所有工作区与归档集中移除该会话。正在进行的会话不会被删除（Host 返回 session-live 错误）。

启用删除

删除是破坏性操作：它会永久删除会话的持久化日志，并从工作区和归档集中摘除。需要把删除补丁应用到已应用取消归档补丁的 DeepSeek Harness 0.1.0-rc.7 源码检出：

# 在 deepseek-harness 仓库根目录执行（取消归档补丁已应用）
git apply --check /path/to/dsh-archived-panel/patches/deleteSession.diff
git apply --check /path/to/dsh-archived-panel/patches/deleteSession.tests.diff
git apply /path/to/dsh-archived-panel/patches/deleteSession.diff
git apply /path/to/dsh-archived-panel/patches/deleteSession.tests.diff

pnpm run build:lib:host
pnpm run build:lib:client

补丁提供的完整链路：

WorkspaceRegistry.detachSession + sessionPersistence.delete
  → workspace.deleteSession RPC
  → fetch client/runtime
  → ctx.workspaces.deleteSession
  → 已归档面板 🗑 按钮

deleteSession.diff 基于“已应用 unarchiveSession 补丁”的源码生成；如果尚未应用取消归档补丁，先把两个补丁都应用一遍。涉及文件与限制详见 patches/README.md。

本地开发

pnpm install
pnpm run build
pnpm run pack:check

构建会生成：

• lib/index.mjs：Host 半部。
• lib/client.cjs：浏览器半部（DSH 客户端模块加载器使用的 CommonJS factory）。
• lib/types/：TypeScript 声明。

本仓库使用独立的 tsdown.config.ts，不依赖相邻的 Harness 检出。开发依赖固定为 DSH 0.1.0-rc.7，运行时 peer 范围为 >=0.1.0-rc.7 <0.2.0。

接线原理

• cordis.patch.yml 插入 dsh-archived-panel Loader 条目。
• package.json 的 dsh.bundle.patch 让包成为 profile patch 层。
• package.json 的 dsh.client 声明浏览器依赖与平台。
• exports["./client"] 指向浏览器 bundle；根导出是无 Host 行为的 Cordis 插件。

English

dsh-archived-panel is a community plugin for DeepSeek Harness. It adds an Archived panel to the sidebar:

• Shows each archived session's title, workspace, and relative time.
• Opens a session when its row is selected.
• Unarchives sessions when the Host exposes unarchiveSession.
• Permanently deletes archived sessions when the Host exposes deleteSession (with a confirmation prompt).
• Hides the action buttons when their patch is unavailable; browsing and opening still work.

The plugin is distributed as a DSH bundle: cordis.patch.yml mounts the Host entry and the browser feature is loaded through its dsh.client bundle.

Compatibility

Install

Install a local checkout into the web profile:

dsh plugin --profile web add ./dsh-archived-panel
dsh --profile web

Install directly from GitHub:

dsh plugin --profile web add github:chensl139-ok/dsh-archived-panel

A git install runs prepare from source. pnpm 10 and newer may block dependency build scripts by default. If that happens, add the exact package key printed by pnpm to the profile's pnpm-workspace.yaml:

allowBuilds:
  dsh-archived-panel: true

Run the install command again. After a successful install, dsh plugin detects the package's dsh.bundle declaration and adds it to the profile bundle list.

Enable unarchive

Browsing and opening work without changing DSH. Unarchive requires the included Host/runtime patch, based on the DeepSeek Harness 0.1.0-rc.7 source tree:

# Run from the root of the deepseek-harness repository
git apply --check /path/to/dsh-archived-panel/patches/unarchiveSession.diff
git apply --check /path/to/dsh-archived-panel/patches/unarchiveSession.tests.diff
git apply /path/to/dsh-archived-panel/patches/unarchiveSession.diff
git apply /path/to/dsh-archived-panel/patches/unarchiveSession.tests.diff

pnpm run build:lib:host
pnpm run build:lib:client

The patch supplies the complete path:

WorkspaceRegistry.unarchiveSession
  → workspace.unarchiveSession RPC
  → fetch client/runtime
  → ctx.workspaces.unarchiveSession
  → Archived panel

See patches/README.md for affected files, test support, and limitations. Always run git apply --check first. If the target DSH version differs, regenerate or port the patch instead of forcing it.

Without the unarchive patch you can only browse and open. With it you can unarchive; with the delete patch you can permanently delete. Delete calls ctx.workspaces.deleteSession(id), which has the Host tear down the session log (sessionPersistence.delete) and remove the session from every workspace and the archive set. A live session is refused with a session-live error.

Enable delete

Delete is destructive: it permanently removes the session's durable log and detaches it from workspace and archive sets. Apply the delete patch to a DeepSeek Harness 0.1.0-rc.7 source checkout that already has the unarchive patch applied:

# Run from the root of the deepseek-harness repository (unarchive patch already applied)
git apply --check /path/to/dsh-archived-panel/patches/deleteSession.diff
git apply --check /path/to/dsh-archived-panel/patches/deleteSession.tests.diff
git apply /path/to/dsh-archived-panel/patches/deleteSession.diff
git apply /path/to/dsh-archived-panel/patches/deleteSession.tests.diff

pnpm run build:lib:host
pnpm run build:lib:client

The patch supplies the complete path:

WorkspaceRegistry.detachSession + sessionPersistence.delete
  → workspace.deleteSession RPC
  → fetch client/runtime
  → ctx.workspaces.deleteSession
  → Archived panel 🗑 button

deleteSession.diff is generated against a source tree that already has unarchiveSession applied; if you have not applied unarchive yet, apply both patches. See patches/README.md for the affected files and limitations.

Local development

pnpm install
pnpm run build
pnpm run pack:check

The build emits:

• lib/index.mjs: Host half.
• lib/client.cjs: browser half (the CommonJS factory consumed by the DSH client module loader).
• lib/types/: TypeScript declarations.

The repository uses a self-contained tsdown.config.ts; no sibling Harness checkout is required. Development dependencies are pinned to DSH 0.1.0-rc.7, while runtime peers accept >=0.1.0-rc.7 <0.2.0.

Wiring

• cordis.patch.yml inserts the dsh-archived-panel Loader entry.
• package.json's dsh.bundle.patch makes the package a profile patch layer.
• package.json's dsh.client declares browser dependencies and platform.
• exports["./client"] points to the browser bundle; the root export is a Cordis plugin with no Host behavior.

Contributing

See CONTRIBUTING.md. This repository is a community plugin and is not an official DeepSeek Harness package.

License

MIT — see LICENSE.