DeepSeek Harness plugin

dsh-archive-viewer-csiroqa

DSH 归档增强插件:自动定期归档、文件夹归档整理、LLM 摘要沉淀经验库、会话收藏与便签,查看/恢复归档会话与一键关闭 dsh(恢复与关闭需应用核心补丁)

Jump to install

Source facts

Repository
csiroqa/dsh-archive-viewer
Latest update
Aug 13, 2026
Category
Tools & Capabilities
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/csiroqa/dsh-archive-viewer
Plugin: dsh-archive-viewer-csiroqa
Author: csiroqa

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer4 files
README.mdSource · read only
README language

dsh-archive-viewer

DeepSeek Harness(DSH)的归档增强插件:自动定期归档空闲会话、文件夹归档整理、LLM 摘要沉淀经验库、会话收藏与便签,外加已归档会话的查看 / 恢复与一键关闭 dsh。

English: README.en.md

功能

归档管理

  • 自动定期归档(host 半区):ctx.interval 周期扫描空闲会话(非运行中、最后活跃早于 maxIdleDays、未 pin、未归档),幂等归档——日志、附件与工作区分组位置完整保留
  • 文件夹归档:左栏文件夹树(全部归档 / 自定义文件夹 / 未分类 / 收藏 / 经验库),可新建、重命名、删除文件夹,会话可移入/移出;归属关系持久化在 $DSH_HOME/archive_snapshots/folders.json
  • 批量操作:勾选多个会话后批量导出 ZIP / 生成摘要 / 恢复 / 移动
  • 查看对话:直接读取归档会话日志(session.history,冷会话走持久化检查),支持分页加载更早
  • 下载日志 ZIP:官方 session.export 端点
  • 恢复会话(取消归档):一键放回原工作区分组

经验库(LLM 摘要沉淀)

  • 会话完成(running → idle)或手动点「生成摘要」时,用 ctx.llm.stream 生成结构化摘要(目标 / 关键决策 / 产出 / 可复用经验 / 遗留问题)
  • 以 Markdown + JSON 写入 $DSH_HOME/archive_snapshots/,面板「经验库」视图支持全文搜索与重新生成
  • 摘要模型走插件 config 的 provider / model(与 DSH 的 LLM 路由一致),未配置时点「生成摘要」会提示

收藏 + 便签

  • 每个会话卡片可「☆ 收藏 / ★ 已收藏」、写便签;收藏视图展示所有收藏会话(含未归档)
  • 持久化在 $DSH_HOME/archive_snapshots/bookmarks.json

其他

  • 右上角「关闭 dsh」按钮:会话完成后可一键关闭 dsh,日志均已保存,重启后原样恢复
  • 皮肤全适配:全部使用 shell 设计令牌(--dsw-alias-* + --dsw-alias-state-business-primary 强调色),自动跟随任意皮肤;面板 Portal 到 document.body 避开侧边栏令牌覆盖

配置

插件行(cordis.patch.ymlarchive-viewer insert 行)支持以下可选 config:

默认说明
autoArchiveEnabledtrue自动定期归档开关
maxIdleDays7会话空闲多少天后自动归档
scanIntervalMinutes30扫描周期(分钟)
pinnedSessionIds[]永不自动归档的会话 id
summarizeEnabledtrue自动摘要沉淀开关
provider / model未配置摘要模型路由(与 DSH 的 LLM 配置一致)
maxInputBytes65536摘要输入字节上限
maxOutputTokens1024摘要输出 token 上限
timeoutMs60000摘要请求超时(毫秒)

依赖:DSH 核心补丁(必读)

「恢复会话」与「关闭 dsh」依赖 DSH 核心新增的两个 RPC(截至 2026-08 官方尚未包含):

  • workspace.unarchiveSession —— 注册表级取消归档
  • host.shutdown —— 经 CLI 启动器的 appExit 触发优雅关机

使用前请先应用补丁:

cd <你的 deepseek-harness 检出目录>
git apply /path/to/dsh-archive-viewer/patches/0001-workspace-unarchive-and-host-shutdown-rpcs.patch

然后重启 dsh web(源码运行时 tsx 直接执行,无需构建;发布包安装的用户需重新构建受影响包)。补丁共 8 个文件:workspace 注册表、apiproxy 接口/校验/路由/实现、host schema 等。

> 若 DSH 官方后续合入这两个 RPC,补丁会变为空操作,可安全跳过。

安装

前置:Node.js >= 22、pnpm。

git clone https://github.com/csiroqa/dsh-archive-viewer.git
cd dsh-archive-viewer
pnpm install
pnpm build

# 安装进 web profile(link: 指向本目录)
dsh plugin --profile web add link:$(pwd)        # POSIX
dsh plugin --profile web add link:E:\path\to\dsh-archive-viewer   # Windows

重启 dsh web,浏览器 Ctrl+F5 硬刷新。

使用

1. 侧边栏底部(设置按钮上方)点击「已归档会话」打开面板 2. 左栏文件夹树切换视图;会话卡片:查看对话 / 生成摘要 / 收藏 / 便签 / 恢复 / 导出 ZIP 3. 勾选多个会话后底部批量操作条出现;「经验库」视图检索沉淀摘要 4. 会话头部右上角电源按钮 → 确认后关闭 dsh

安全说明

  • 自动定期归档会无人值守地移动你的会话(默认空闲 7 天后),归档会话从所有会话列表与搜索中隐藏但日志完整保留,可随时恢复;如不希望自动归档,请把 autoArchiveEnabled 设为 false
  • LLM 摘要会消耗模型 token:每次会话完成或点「生成摘要」都会发起一次模型请求,请确认插件 config 的 provider / model 与你的额度预期匹配
  • 插件数据(文件夹、书签、摘要)保存在本机 $DSH_HOME/archive_snapshots/,请勿把该目录暴露给不可信进程

兼容性

  • 平台:Windows / macOS / Linux(Node >= 22)
  • 针对 DSH 0.1.0-rc.5 源码检出开发验证
  • 客户端零框架类型依赖:不 import 任何 @deepseek-ai/* 值,全部结构类型,不随 DSH SDK 版本漂移
  • 构建产物:tsdown(host 半区 lib/index.js + browser 半区 lib/client.js,标准 window.__ModuleLoader__.load 闭包工厂格式)

许可与使用声明

MIT License(见 [LICENSE](LICENSE))。

欢迎任何人使用、修改、引用、或把本项目收录进自己的插件合集,只需:

  • 保留 LICENSE 文件与版权声明
  • 标明出处(本仓库链接)

相关