dsh-plugin-yanyan-toolkit
Manifest validYanYan Toolkit: DeepSeek Harness Plugin Collection (plugin updates / session management / sub-agent management), supporting physical deletion and complete removal of session logs
研研工具包
English | 中文
当前版本:v1.4.2 |适配 DSH 0.2.2-rc.2
仓库:GitHub
一个聚合插件包,安装后同时获得四个可独立开关的插件。遵循「有现成的就直接借鉴、不重复造轮子」:会话管理直接复用社区现成包,另外三个自写插件也尽量照抄官方与社区已验证的注入点。
包含插件
| 插件 | 行 id | 作用 |
|---|---|---|
| 插件更新 | dsh-plugin-yanyan-update | 在插件页「已安装插件」标题行右侧提供「检查更新」按钮;点击后展开下拉小面板,逐行列出可更新插件(当前版本 → 最新版本)并带独立「更新」按钮。覆盖 npm registry 源与本地 link:/file:(git 仓库)源。 |
| 会话管理 | session-archive | 自动归档会话、自动删除已归档会话(默认均关闭,可设 7/15/30/自定义天数)、单条与批量删除。直接复用 @linxin666/dsh-session-archive@0.4.18,其设置页与后端已完整覆盖需求。 |
| 子智能体管理 | dsh-plugin-yanyan-subagent | 会话顶部新增可改名的「智能体管理」标签,浮层列出当前会话所有子智能体、支持行尾逐个彻底删除(日志根除 + 内存投影根治)与底部「清理全部空闲」;提供按空闲时间自动清理(默认关闭、可设分钟数)。 |
| 图标生成 | dsh-plugin-yanyan-icon | 根据上传的图片居中裁切、套上圆角背景,生成适配插件列表图标位(列表行 30px / 详情卡片 36px)的 icon.svg;提供双尺寸预览与一键下载。 |
四个插件各有独立 loader 行,可在插件页分别启停。
组件独立版本与显示
聚合包里的每个组件都保留自己独立的 package.json 版本(聚合根包与四个功能插件可各自发版,互不强求一致):当前为 dsh-plugin-yanyan-toolkit 1.4.2、dsh-plugin-yanyan-update 1.2.1、dsh-plugin-yanyan-subagent 1.4.0、dsh-plugin-yanyan-icon 1.0.1、@linxin666/dsh-session-archive 0.4.18。
在插件详情页「包含的组件」列表里,每个组件中文标题右侧会显示一个 v<版本> 小标签。官方的 InstalledPluginChild 协议只有 id/name/enabled/locked,不含 version,DSH 自身不会渲染组件版本;本包由 host 半区新增 /__dsh-plugin-yanyan-toolkit/components 路由动态读取各组件自己的 package.json(绝不写死,避免失同步),client 半区照抄 插件更新 包已有的 MutationObserver + ctx.effect 注入骨架,按 [data-plugin-rows] li[data-plugin-row] 与行内 <code> 里的真实包名匹配后注入版本标签,不改 React 管理的 DOM、不误伤其它插件详情页,页面重渲染后自动重挂。
设计取舍
- 会话管理零改动复用:
@linxin666/dsh-session-archive已实现按updatedAt自动归档、按归档台账archivedAt自动删除、单条/批量物理删除、13650 任意天数、Host 端定时调度与设置页 UI。其天数输入框接受任意 13650 的整数,已包含 7/15/30/自定义,无需改造。 - 插件更新复用注入骨架,补齐现成轮子缺失的部分:官方
@linxin666/dsh-client-ui-plugin-manager的 DOM 座位[data-plugin-panel] [data-plugin-group="bundles"]、「检查更新」按钮、下拉面板与双通道 RPC 契约可直接借鉴;但它的检查逻辑只覆盖 npm registry 源(source.kind === 'npm'),对本地link:/file:目录与 GitHub 源一律跳过。本插件在自写 Host 半区里补上 git 本地源的版本比对与git merge --ff-only更新,并给下拉列表每一行加独立更新按钮。 - 子智能体「删除」= 物理删除 + 日志根除(不可逆):旧版只调用
archiveSession归档,既删不掉 mnemon 虚拟委派(会报session/not-found),也移除不了父会话subagentCatalog的 append-only 引用,导致列表里仍显示该条目。现改为 host/purge物理删除:真实会话优先复用现成/api/dsh-session-archive/delete管线,再兜底清会话目录、projcache 与 catalog 引用、workspace 记账、归档台账与归档标记;虚拟 id 直接走兜底。v1.2.0 起进一步借鉴dsh-plugin-subagent-clean(MIT)的「原位退休」把父会话日志session.v4.jsonl.zstd里的subagent/catalog事件改写为subagent-delete/retired(保留 seq/time、ignorable),从 append-only 源头根除目录行,宿主不再重建;配合「清理残留行」按钮(/scrub)、一键清理只改写一次日志(/cleanup)、ctx.sessions.refresh()让侧边栏残留行同步消失,以及localStorage['yanyan-subagent.deletedIds']隐藏清单兜底。另注册三个可选模型工具(yanyan_list_subagents/yanyan_delete_subagent/yanyan_cleanup_subagents),让 Agent 一句话即可清理空闲 Mnemon review 子代理。v1.2.1 起补上真正的根治层:官方「N 个子智能体」浮层只读 client 内存投影projectionsBySession[*].values.subagentCatalog,宿主对已加载的 live 父会话复用内存 fold state,改磁盘日志 / 删 projcache 都不会让它重算,导致磁盘已退休的残留行仍显示、点进去报subagent/not-found。现由 host 扫全库退休日志行经/config下发hiddenIds,clientpatchProjections订阅sessions.list用list.set()持续从内存投影剔除隐藏 childId(幂等收敛),官方浮层计数归零后自动隐藏。 - 图 3 官方子智能体列表行尾加 X:官方浮层行没有行级 Slot,也没有
data-session-id之类的 DOM 锚点,无法通过稳定注入实现行尾删除。本插件把「逐个删除」做在自建的「智能体管理」标签浮层里(数据来自listDescendants,id 明确),并在conversation.session.header.actions.subagent.footer提供「清理全部空闲」按钮。图 3 行内 X 仅作为可选的高风险 DOM 注入增强,默认不启用。
安装
本包是一个 npm 包,通过 dsh.bundle.patch 的 cordis.patch.yml 一次插入五条 loader 行。三种方式任选其一:
从 npm 安装(推荐,需 Node ^22.19.0 || >=24.0.0):
dsh plugin add dsh-plugin-yanyan-toolkit
本地目录安装(开发调试):
dsh plugin add file:<本包目录>
或在插件页「添加插件」里选择本地目录 / 输入 npm 包名安装。
分发与自动化
- npm:
.github/workflows/publish.yml在 pushmain、v*标签、Release 发布或手动触发时用 OIDC 可信发布执行npm publish --provenance --access public;发布前先跑npm test,并轮询跳过已发布版本。首次使用需在 npmjs.com 为本仓库与该工作流配置 trusted publisher。 - Gitee:
.github/workflows/sync-gitee.yml在 pushmain或手动触发时把 main 与全部标签镜像到 Gitee;需要在仓库 Secret 配置GITEE_SSH_PRIVATE_KEY(一把已注册在 Gitee 账号下的无口令私钥)。 - GitHub Release:每个版本附带
dsh-plugin-yanyan-toolkit-<version>.tgz离线分发包,可直接npm install <tgz>后按本地包方式安装。
生效说明
改动涉及 bundle 行与 cordis.patch.yml,需要用户重启 DSH 服务后生效(本会话未自行重启正在运行的 DSH 服务)。重启后刷新页面即可看到:
- 插件页「已安装插件」标题行右侧的「检查更新」按钮;
- 插件详情页「包含的组件」列表里每个组件标题右侧的
v<版本>标签; - 设置页新增的「会话管理」分区(由复用的包提供);
- 会话顶部新增的「智能体管理」标签;
- 插件页「已安装插件」标题行右侧的「图标生成」按钮,上传图片后双尺寸预览并下载
icon.svg。
目录结构
dsh-plugin-yanyan-toolkit/ 聚合根包(自身行为空壳,只承载 patch 与依赖)
cordis.patch.yml 5 行 insert:自身 + 4 个插件
lib/index.js, lib/client.js 极简 host / client 半区
locale/{zh,en}.json 插件页展示元数据
packages/
dsh-plugin-yanyan-update/ 插件更新(自写)
dsh-plugin-yanyan-subagent/ 子智能体管理(自写)
dsh-plugin-yanyan-icon/ 图标生成(自写)
(会话管理无子目录,直接依赖 npm 包 @linxin666/dsh-session-archive)
四个真实插件列在根包 dependencies 里,pnpm 的 hoisted 布局会把它们与 npm 包一起提升到 profile 根 node_modules,五条 loader 行的 name 均可解析。
Comments
Loading…
Similar plugins
by luckamuu
DeepSeek Harness 插件:提供删除已归档会话的入口(可以彻底删除不会在次出现)
★ 0
MIT
JavaScript
Oct 8, 2026
dsh plugin --profile web add @local/archived-sessionsby G57651
DeepSeek Harness 会话管理面板插件:全部/已归档/已删除视图、批量管理、软删除回收站
★ 1
NOASSERTION
JavaScript
Sep 28, 2026
dsh plugin --profile web add @g57651/dsh-session-managerby AndroidSix
DeepSeek Harness 会话工具箱:图片草稿保险箱、项目分组与会话迁移、归档池、文件检查点恢复、多引用回复、后续任务联想。第三方插件,数据只存本机。
★ 4
↓ 136/wk
MIT
JavaScript
Oct 23, 2026
dsh plugin --profile web add dsh-session-toolboxby lanlandeli
DeepSeek Harness 会话管理插件|归档与恢复、批量操作、工作区分组、子代理关系、活动详情、记录目录与安全文件清理
★ 2
↓ 20/wk
NOASSERTION
TypeScript
Aug 18, 2026
dsh plugin --profile web add dsh-conversation-managerby MuWinds
DeepSeek Harness 插件-归档会话管理,支持释放、清除归档会话
★ 7
MIT
TypeScript
Sep 12, 2026
dsh plugin --profile web add @muwinds/dsh-archived-sessionsby uio-o
DeepSeek Harness 会话面板插件:按轮次/步骤统计 Skill、MCP 调用与文件读写,含失败详情、按来源筛选、文件删除标注。
★ 0
MIT
JavaScript
Oct 7, 2026
dsh plugin --profile web add dsh-plugin-operation-log