@xrn1997/dsh-session-delete 0.0.0-stage → 0.0.1

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 xrn1997
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,130 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @xrn1997/dsh-session-delete
+
+给 DeepSeek Harness（DSH）加一个**删除会话**的能力。DSH 官方有归档、没有删除——归档只是把会话从列表里挪走，文件还在。本插件补上删除，并且让删除可恢复：删除 = 移入回收站，另有一个显式的「彻底删除」。
+
+![左侧栏「回收站」面板：按项目分组的卡片列表，每条带「恢复」与「彻底删除…」，页脚是整页唯一的实心红按钮「清空回收站…」](https://raw.githubusercontent.com/xrn1997/dsh-session-delete/main/docs/screenshots/screenshot-01.png)
+
+- 安装：`dsh plugin --profile <profile> add @xrn1997/dsh-session-delete`
+- 许可：[Apache-2.0](LICENSE)
+- 数据：回收站本体留在本机 `~/.dsh/session-trash/`，不联网、不上传
+
+## 目录
+
+- [功能特性](#功能特性)
+- [安装](#安装)
+- [用法](#用法)
+- [回收站与数据](#回收站与数据)
+- [界面语言](#界面语言)
+- [常见问题](#常见问题)
+- [开发](#开发)
+- [贡献](#贡献)
+- [许可](#许可)
+
+## 功能特性
+
+- **删除 = 移入回收站**：会话条目「…」菜单里的「删除」把会话搬进回收站，可随时恢复；删完有一条停留 6 秒的撤销提示
+- **显式彻底删除**：单条「彻底删除…」或页脚「清空回收站…」，两者共用同一个二次确认
+- **回收站面板**：按项目分组的卡片列表，每条两行（标题 / 删除时间 · 大小），头部是条数与合计占用 + 刷新，页脚交代本体位置与「清空后不可恢复」
+- **运行中的会话拒绝删除**：菜单项置灰并说明原因——不替用户终止正在进行的活
+- **不自动过期**：不设天数上限，清空是显式动作
+- **失败不吞**：回收站读不到时把宿主原文上屏，并给一个「重试」
+- **不可用时不出现**：取数通道探测不过就一个入口都不注册——页面上看不出本插件，但也不会因此把宿主拖死
+- **文案随宿主语言**：中文 / English 挂在宿主 locale 服务上，跟随设置的界面语言
+
+## 安装
+
+```bash
+dsh plugin --profile <profile> add @xrn1997/dsh-session-delete
+```
+
+装完**重启宿主**（Node 半不走 HMR）。卸载：
+
+```bash
+dsh plugin --profile <profile> remove @xrn1997/dsh-session-delete
+```
+
+卸载只是移除插件；`~/.dsh/session-trash/` 下已有的目录仍留在原处，不会被自动清理。
+
+也可以离线分发：`pnpm pack` 出 tarball 后 `dsh plugin add ./dsh-session-delete-<版本>.tgz`。包里带的是**预构建产物**（`prepack` 在打包时替你跑 `build`），所以这条路上用户不需要为构建脚本授权。
+
+**兼容性分两层，别混**：
+
+- **装得上**由 `package.json` 的 `peerDependencies` 决定——宿主 `dsh plugin add` 会拿运行中的宿主版本逐项比对插件的 `@deepseek-ai/dsh*` peer 区间，不满足即拒绝并回滚。本插件**一条 `dsh-*` peer 都没有**（界面用的控件与图标已固化成 `src/client/ui/*`，浏览器半只 require React 家族这三个冻结平台模块），所以这道闸不限制它装在哪些代上。
+- **真跑过**由 `dsh.compatibility.dshReleases` 记录，只列实测过的宿主：**DSH Desktop 0.2.0-rc.2**（`compatible`）。别的 rc 装得上，但没验过。
+
+## 用法
+
+两个入口。
+
+**删除**：会话条目右边的「…」菜单 → 「删除」→ 确认框（「移入回收站」）→ 会话进回收站。正在运行的会话这一行是**置灰**的，悬停给出「会话正在运行，先停止再删除」——本插件不替用户终止正在进行的活。
+
+**回收站**：侧栏面板列表里常驻的「回收站」一行（与「插件」「小说」同层）。打开后是中央面板：
+
+- 清单按项目分组，每条两行——标题 / 「刚刚删除 · 24KB」或「删除于 7分钟前 · 350KB」；动作收在右侧，「恢复」是描边，「彻底删除…」是安静的红
+- 头部是条数与合计占用（「2 个会话 · 共 49KB」）加一个「刷新」；页脚是「清空回收站…」——**整页唯一一块实心红**
+- 面板四态：读数中 / 空（「回收站是空的」，此时底部**不出现**「清空回收站…」）/ 读数失败（宿主原文 + 「重试」）/ 有条目
+- 「恢复」按记录的原目录名放回原项目目录，并还原它原本的可见性：删除前未归档的，恢复后仍未归档；删除前已归档的，恢复后仍在归档态
+
+## 回收站与数据
+
+| 东西 | 位置 |
+| --- | --- |
+| 回收站本体 | `~/.dsh/session-trash/<时间戳>-<原目录名>/` |
+| 回收站清单 | 本插件自己的 storage domain（介质在 `~/.dsh/storages/`） |
+
+- 回收站与 `~/.dsh/sessions/` **同卷**：搬进搬出靠整目录 `rename`，原子、瞬时
+- **清单丢了不致命**：会话文件自描述，解压后第一行即 header，含 `id` 与 `cwd`
+- **不自动过期**：不设天数上限，清空是显式动作；界面显示条数与占用
+- **附件不连坐**：附件是全局内容寻址的，与会话不是父子关系——删除不连带，也不会回收；被删会话独享的附件会留成垃圾（要回收得先有引用计数，属另一件事）
+
+## 界面语言
+
+中文 / English 挂在宿主自己的 locale 服务上，跟随设置的界面语言；服务不可用时退回内置中文。
+
+## 常见问题
+
+**装完侧栏没有「回收站」，会话菜单里也没有「删除」？**
+
+先重启宿主。若仍没有，确认这一代宿主上本插件激活过——取数通道探测不过时，本插件**一个入口都不注册**：页面上看不出它的存在，但它也不会因此把宿主拖死。这是有意用「入口不出现」表达不可用，不是禁用态。
+
+**删完之后侧栏那一行怎么还在？**
+
+本插件只在**宿主确实不再列它**时才通告客户端把那一行去掉；拿不准时宁可沉默（那时说「已移除」是假话）。刚巧遇上就刷新页面，那一行会自己消失。本机运行期没打开过的**冷会话**走的是正常路径，删完即走。
+
+**正在运行的会话为什么删不掉？**
+
+判据用的是宿主自己的活跃检查（与官方归档的准入同源）。首版一律拒绝，不替用户终止正在进行的活——先停下这个会话再删。
+
+**能恢复多久？**
+
+不存在时间上限。不自动过期，只有你显式清空或彻底删除才会真的丢字节。
+
+## 开发
+
+```bash
+pnpm install
+pnpm build        # tsdown：Node 半 + 浏览器半（含浏览器半的纯度门）
+pnpm test         # vitest run
+pnpm typecheck    # tsc --noEmit
+```
+
+### 本地源码调试
+
+**`lib/` 是构建产物且不入库，从源码目录链进 profile 的安装方式不会替你构建它。**
+
+```bash
+pnpm build        # 必须在源码目录手动跑一次
+dsh plugin --profile <profile> add "link:<本仓绝对路径>"
+```
+
+改动生效分两半：**浏览器半**（`src/client/`）由宿主 HMR 推到浏览器，无需重启；**Node 半**不在热重载链路内，必须重启宿主。
+
+设计（五个触点、边界、错误形状、验证门、界面规格）住在 [`docs/design/2026-09-30-session-delete-design.md`](docs/design/2026-09-30-session-delete-design.md)，README 不复述。
+
+## 贡献
+
+欢迎 Issue 与 PR。提交改动前请确保 `pnpm test` 与 `pnpm typecheck` 都通过，且**两条命令的退出码都亲眼看过**——跑门要把输出先灌进文件、再单独打印退出码，管道会把红吃掉。提交即表示你同意以 [Apache-2.0](LICENSE) 协议授权你的贡献。
+
+## 许可
+
+[Apache-2.0](LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: session-delete
+      name: '@xrn1997/dsh-session-delete'

package/icon.svg

@@ -0,0 +1,18 @@
+<!--
+  插件卡片/组件行的图标（`package.json` 顶层 `icon`，宿主按**图片**读它、不内联 HTML）。
+
+  形状逐字取自 `@deepseek-ai/dsh-client-ui-primitives@0.2.0-rc.2` 的 `IconTrashOutlineRegular`
+  （与插件界面里那枚垃圾桶图标同源）。
+
+  两处与组件版不同：
+  1. 颜色写死。图片形式的 SVG **不继承 `currentColor`**（它是一份独立文档），所以不能像组件里那样
+     吃宿主的字色 ⇒ 取一个浅色/深色底上都能读的中灰。
+  2. 不带 `aria-hidden`。这不是行内构件，可及名由承载它的宿主卡片提供。
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" fill="none" stroke="#8a9099" stroke-width="1">
+  <path d="M1.28149 3.88831H14.7187" />
+  <path d="M5.41602 3.88833V2.47962C5.41602 2.29282 5.52492 2.11366 5.71876 1.98157C5.9126 1.84948 6.17551 1.77527 6.44964 1.77527H9.55053C9.82466 1.77527 10.0876 1.84948 10.2814 1.98157C10.4753 2.11366 10.5842 2.29282 10.5842 2.47962V3.88833" />
+  <path d="M2.57349 3.88831L3.19366 13.2943C3.21937 13.5502 3.33952 13.7872 3.53065 13.9593C3.72178 14.1313 3.97016 14.2259 4.22729 14.2246H11.7728C12.0299 14.2259 12.2783 14.1313 12.4694 13.9593C12.6605 13.7872 12.7807 13.5502 12.8064 13.2943L13.4266 3.88831" />
+  <path d="M6.44946 6.98926V11.1238" />
+  <path d="M9.55054 6.98926V11.1238" />
+</svg>