@dungsil/dsh-plugin-ui-sidebar-inbox 0.2.3 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,83 +1,102 @@
1
- # @dungsil/dsh-plugin-ui-sidebar-inbox
1
+ **한국어** | [English](./README.en.md) | [简体中文](./README.zh.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [Français](./README.fr.md) | [Deutsch](./README.de.md) | [Português](./README.pt.md) | [Русский](./README.ru.md)
2
2
 
3
- DSH의 기존 사이드바 모양을 유지하면서, 프로젝트별 목록을 T3 Code Nightly처럼 상태별 목록으로 배치합니다. 설치 후 최초 활성화 시 `[그룹 기준] > [하나의 목록]`과 `[정렬 기준] > [에이전트 활동]`을 자동으로 선택합니다. 이후 사용자가 바꾼 보기 옵션은 유지합니다.
3
+ # Sidebar Inbox · 사이드바 수신함
4
4
 
5
- 기존 `@dungsil/dsh-plugin-sidebar-inbox`를 대체하는 패키지이며, 새 이름의 첫 버전은 `0.1.0`입니다. 기존 패키지의 모든 버전은 사용 중단(deprecated) 대상입니다. 기존 패키지를 비활성화하고 새 패키지를 설치·활성화합니다. 두 패키지를 동시에 활성화하지 마세요. 기존 정렬 선택과 이전 정렬 복원 설정은 유지됩니다.
5
+ `@dungsil/dsh-plugin-ui-sidebar-inbox`
6
6
 
7
- ### 미리보기
7
+ [![Open Plugin Market](https://img.shields.io/endpoint?url=https%3A%2F%2Fdshopen.org%2Fbadge%2F%2540dungsil%2Fdsh-plugin-ui-sidebar-inbox.json%3Flang%3Den)](https://dshopen.org/plugins/@dungsil/dsh-plugin-ui-sidebar-inbox/)
8
8
 
9
- **라이트 · 영어** — 왼쪽은 Archived 접힘, 오른쪽은 펼침 상태입니다.
9
+ DSH 사이드바의 세션 목록을 T3 Code Nightly처럼 **상태별**로 정리합니다. 응답이 필요한 세션은 위로, 실행 중인 세션과 보관한 세션은 아래로 모아 줍니다. 기존 사이드바의 모양과 세션 행은 그대로 유지합니다.
10
10
 
11
- <img src="./assets/sidebar-preview.webp" alt="라이트 테마의 Sidebar Inbox: 상단의 고정·수신함 세션과 하단 Working 목록, 왼쪽 Archived 접힘과 오른쪽 펼침 비교" width="720" />
11
+ ## 미리보기
12
12
 
13
- **다크 · 한국어** — 같은 예시 세션에서 보관됨의 접힘·펼침을 비교합니다.
13
+ **라이트**: 왼쪽은 보관됨과 잠시 숨김을 접은 상태, 오른쪽은 두 영역을 펼친 상태입니다. 각 영역 제목에는 세션 수를 표시합니다.
14
14
 
15
- <img src="./assets/sidebar-preview-dark.webp" alt="다크 테마의 한국어 Sidebar Inbox: 상단의 고정·수신함 세션과 하단 작업 중 목록, 왼쪽 보관됨 접힘과 오른쪽 펼침 비교" width="720" />
15
+ <img src="./assets/sidebar-preview-ko-light.webp" alt="라이트 테마의 한국어 Sidebar Inbox: 고정·수신함과 작업 중·보관됨·잠시 숨김 목록 및 세션 수, 왼쪽은 보관됨·잠시 숨김 접힘, 오른쪽은 펼침" width="720" />
16
16
 
17
- DSH `0.2.1-rc.5`의 별도 검증용 `web` 프로필에 최신 빌드한 플러그인을 활성화하고, 실제 DSH 웹 화면의 사이드바를 DPR 2로 캡처해 테마별로 나란히 배치했습니다. 한국어 화면에는 저장소의 `@dungsil/dsh-plugin-locale-ko`를 함께 활성화했습니다. 세션 제목은 두 언어 화면에서 동일한 영어 예시 데이터입니다.
17
+ **다크**: 같은 예시 세션에서 보관됨과 잠시 숨김을 접은 상태와 펼친 상태를 비교합니다.
18
18
 
19
- 캡처 전용 서버 fixture로 예시 세션 7개를 생성했습니다. 고정 1개와 보관 2개는 DSH의 실제 고정·보관 API로 설정하고, Working 2개는 세션 목록의 실행 상태를 fixture로 제공했습니다. 실제 모델 작업을 실행한 기록은 아닙니다. 세션 필터는 `모든 대화 (보관된 세션 포함)`이며, 행·상태 아이콘·테마·접힘과 펼침은 실제 DSH 및 이 플러그인의 렌더링입니다. Pinned와 Inbox에는 별도 제목이 없는 원래 배치를 그대로 보여줍니다.
19
+ <img src="./assets/sidebar-preview-ko-dark.webp" alt="다크 테마의 한국어 Sidebar Inbox: 고정·수신함과 작업 중·보관됨·잠시 숨김 목록 및 세션 수, 왼쪽은 보관됨·잠시 숨김 접힘, 오른쪽은 펼침" width="720" />
20
20
 
21
- ## 배치 규칙
21
+ ## 사용법
22
22
 
23
- | 영역 | 포함되는 세션 |
24
- | -------- | ------------------------------------------------------------------------------------- |
25
- | Pinned | DSH에서 고정한 세션입니다. 기존 고정을 우선합니다. |
26
- | Inbox | 응답 확인, 승인, 계획 검토, 사용자 입력이 필요하거나 아직 열지 않은 세션입니다. |
27
- | Working | 에이전트 또는 하위 에이전트가 실행 중인 세션입니다. 요청이 생기면 Inbox로 돌아옵니다. |
28
- | Archived | DSH에서 보관한 세션입니다. 보관과 해제는 DSH의 `⋯` 메뉴에서 실행합니다. |
23
+ 1. DSH의 플러그인 관리 화면에서 **Sidebar Inbox / 사이드바 수신함**을 활성화합니다.
24
+ 2. 처음 활성화하면 보기 옵션이 **그룹 기준: 하나의 목록**, **정렬 기준: 에이전트 활동**으로 자동 설정됩니다. 세션 필터는 바꾸지 않습니다.
25
+ 3. 다시 켜려면 사이드바의 **보기 옵션**에서 같은 두 항목을 선택합니다.
26
+ 4. 그만 쓰려면 정렬 기준을 **수동**이나 **최근 수정일**로 바꾸거나, **에이전트 활동**을 한 번 더 선택합니다. 한 번 더 선택하면 에이전트 활동을 켜기 전에 쓰던 정렬로 돌아갑니다.
29
27
 
30
- 각 영역에서는 최근 갱신된 세션을 먼저 표시합니다. 빈 새 세션은 기존 DSH처럼 맨 위에 둡니다.
28
+ ## 세션 배치
31
29
 
32
- 목록 제목과 메뉴 항목은 DSH UI 언어를 따릅니다. 한국어 UI에서는 정렬 항목이 `에이전트 활동`, 영역 제목이 `작업 중`·`보관됨`으로 표시됩니다. 번역 사전은 이 플러그인이 직접 포함하므로 한국어 UI 언어 팩을 따로 설치하지 않아도 됩니다.
30
+ | 영역 | 포함되는 세션 |
31
+ | -------- | -------------------------------------------------------------------------------- |
32
+ | Pinned | DSH에서 고정한 세션입니다. 실행 중이거나 응답이 필요해도 이 영역에 둡니다. |
33
+ | Inbox | 응답 확인, 승인, 계획 검토, 사용자 입력이 필요하거나 아직 열지 않은 세션입니다. |
34
+ | Working | 에이전트나 하위 에이전트가 실행 중인 세션입니다. 요청이 생기면 Inbox로 옮깁니다. |
35
+ | Archived | DSH에서 보관한 세션입니다. 고정 여부나 실행 상태와 관계없이 이 영역에 둡니다. |
33
36
 
34
- Pinned와 Inbox는 별도 제목 없이 위쪽 목록에 표시합니다. Working과 Archived는 하단의 스크롤 영역을 공유합니다. 두 영역의 제목과 세션을 합친 높이는 사이드바 목록 표시 영역의 50%를 넘지 않습니다. 내용이 많으면 하단 영역 안에서 스크롤하며, Pinned와 Inbox는 위쪽에서 따로 스크롤합니다. 기본값은 Working을 펼치고 Archived를 접은 상태입니다. 두 제목을 누르거나 키보드로 활성화하면 각 영역이 부드럽게 펼쳐지고 접힙니다. Archived는 세션 필터가 `모든 대화 (보관된 세션 포함)`일 때만 접을 수 있습니다. `보관된 세션만` 필터에서는 보관한 세션이 목록 전체이므로 접지 않고 그대로 표시합니다. 새로고침하면 기본값으로 돌아갑니다.
37
+ - 각 영역에서는 최근에 갱신된 세션을 먼저 표시합니다. 내용이 없는 새 세션은 기존 DSH처럼 맨 위에 둡니다.
38
+ - 이 배치는 **그룹 기준이 하나의 목록일 때만** 적용됩니다. `작업 공간`이나 `작업 공간 트리`로 바꾸면 에이전트 활동 정렬이 해제되고 DSH 기본 표시로 돌아갑니다.
35
39
 
36
- 이 배치와 제목은 `그룹 기준`이 `하나의 목록`일 때만 적용됩니다. `작업 공간`·`작업 공간 트리` 그룹에서는 DSH 기본 표시를 따르며, 정렬을 켠 채 그룹 기준을 바꾸면 자동으로 해제됩니다.
40
+ ## 화면 구성
37
41
 
38
- ## 사용법
42
+ 사이드바 목록은 위쪽 목록과 하단 영역으로 나뉘며, 두 영역은 따로 스크롤합니다.
39
43
 
40
- 1. 설치 후 최초 활성화하면 **하나의 목록 / 에이전트 활동**이 자동으로 적용됩니다. 세션 필터는 바꾸지 않습니다.
41
- 2. 나중에 다시 켜려면 사이드바의 **보기 옵션**(필터 아이콘)에서 **그룹 기준**을 **하나의 목록**, **정렬 기준**을 **에이전트 활동**으로 맞춥니다.
42
- 3. 그만 쓰려면 **수동**이나 **최근 수정일**을 선택하거나 같은 **에이전트 활동** 항목을 다시 선택합니다. 전자는 고른 정렬로 바뀌고, 후자는 에이전트 활동을 켜기 전에 쓰던 정렬로 돌아갑니다.
43
- 4. 정리할 세션의 `⋯` 메뉴에서 `세션 보관`을 선택합니다.
44
- 5. 사이드바의 세션 필터를 `모든 대화 (보관된 세션 포함)`으로 바꾸면 보관한 세션이 하단 `Archived` 영역에 접힌 채로 표시됩니다.
45
- 6. 같은 메뉴에서 `세션 보관 해제`를 선택하면 원래 자리로 돌아옵니다.
44
+ - **위쪽 목록**: Pinned와 Inbox를 제목 없이 표시합니다.
45
+ - **하단 영역**: Working과 Archived가 하나의 스크롤 영역을 함께 사용합니다. 제목과 세션을 합친 높이는 사이드바 목록 높이의 50%를 넘지 않습니다.
46
+ - **펼침과 접힘**: 처음에는 Working을 펼치고 Archived를 접어 둡니다. 영역 제목을 클릭하거나 키보드로 활성화하면 펼치거나 접을 수 있습니다. 이 상태는 저장하지 않으므로, 새로고침하면 처음 상태로 돌아갑니다.
47
+ - **Archived 표시 조건**: 세션 필터가 `모든 대화 (보관된 세션 포함)`일 때만 접을 수 있습니다. `보관된 세션만` 필터에서는 보관한 세션이 목록 전체이므로 항상 펼쳐서 표시합니다.
46
48
 
47
- 보관 여부는 DSH가 관리합니다. 이 플러그인은 보관 상태를 저장하거나 바꾸지 않으며, 보관한 세션은 언제든 복원할 수 있습니다. 실행 중이거나 사용자 응답을 기다리는 세션은 DSH가 보관 전에 작업을 먼저 중지합니다.
49
+ ## 보관
48
50
 
49
- ## 설치
51
+ 보관 여부는 DSH가 관리합니다. 보관과 보관 해제는 세션의 `⋯` 메뉴에서 실행하며, 이 플러그인은 보관 상태를 저장하거나 바꾸지 않습니다.
50
52
 
51
- DSH `0.2.1-rc.5`와 `0.2.2-alpha.2`에서 검증했습니다. 지원 범위는 `^0.2.1-rc.5`입니다. npm에서 설치합니다.
53
+ - 보관한 세션은 하단 영역에서 언제든 복원할 수 있습니다.
54
+ - 실행 중이거나 사용자 응답을 기다리는 세션은 DSH가 보관하기 전에 작업을 먼저 중지합니다.
52
55
 
53
- ```bash
54
- dsh plugin --profile web add @dungsil/dsh-plugin-ui-sidebar-inbox@0.1.0
55
- ```
56
+ ## 언어
56
57
 
57
- 배포 전에는 저장소에서 패키지를 생성하여 설치할 수 있습니다.
58
+ 목록 제목과 메뉴 항목은 DSH UI 언어를 따릅니다. 한국어 UI에서는 정렬 항목이 `에이전트 활동`, 영역 제목이 `작업 중`과 `보관됨`으로 표시됩니다. 번역 사전은 플러그인에 포함되어 있으므로 한국어 언어 팩을 따로 설치하지 않아도 됩니다.
58
59
 
59
- ```bash
60
- pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox pack --pack-destination ../../release
61
- dsh plugin --profile web add ./release/dungsil-dsh-plugin-ui-sidebar-inbox-0.1.0.tgz
62
- ```
60
+ ## 세부 동작
61
+
62
+ ### 정렬 설정 유지
63
+
64
+ - 자동 설정은 이전 정렬 기록이 없는 새 설치에서 **처음 활성화할 때 한 번만** 적용됩니다. 그 뒤에는 새로고침하거나 다시 활성화해도 사용자가 고른 보기 옵션을 유지합니다.
65
+ - 브라우저 저장소를 사용할 수 없으면 자동 설정을 적용하지 않습니다.
66
+ - 선택한 정렬 값(`agent-activity`)은 DSH의 공유 Workspace 보기 저장소에 저장하므로 새로고침 후에도 유지됩니다.
67
+ - 플러그인을 비활성화하면 이전에 쓰던 정렬 기준으로 돌아갑니다. 정렬이 어긋나 보이면 보기 옵션에서 **수동**이나 **최근 수정일**을 한 번 선택합니다.
68
+
69
+ ### 수동 정렬과의 관계
70
+
71
+ 세션 행을 드래그하면 DSH가 수동 정렬로 전환하므로 에이전트 활동 정렬이 해제됩니다. 이때 에이전트 활동을 켜기 전에 드래그해 둔 수동 배치는 복원되지 않습니다. 이 동작은 DSH의 정렬 변경 규칙을 그대로 따른 결과입니다.
72
+
73
+ ### 기존 DSH 기능 재사용
74
+
75
+ - 세션 행, 검색, 메뉴, 선택, 고정, 보관 필터는 DSH의 기존 기능을 그대로 사용합니다.
76
+ - CSS로 순서만 바꾸지 않고 DSH의 목록 정렬을 갱신하므로, 화면 순서와 DOM 순서(키보드 이동 순서)가 일치합니다.
77
+ - 스크롤바는 DSH 기본 스크롤바의 두께, 색상, 호버 스타일을 따릅니다.
78
+
79
+ ### 애니메이션
80
+
81
+ | 동작 | 시간 |
82
+ | ------------- | ----- |
83
+ | Working 펼침 | 320ms |
84
+ | Archived 펼침 | 480ms |
85
+ | 접힘 | 260ms |
86
+
87
+ 운영체제에서 동작 줄이기(`prefers-reduced-motion`)를 켜면 애니메이션 없이 즉시 바뀝니다.
88
+
89
+ ### 호환성 참고
63
90
 
64
- DSH의 플러그인 관리 화면에서 **Sidebar Inbox / 사이드바 수신함**을 활성화합니다.
91
+ DSH `0.2.x`의 보기 옵션 메뉴에는 플러그인 확장 슬롯이 없습니다. 따라서 이 플러그인은 다음 내부 구조에 의존하며, DSH가 이 구조를 바꾸면 호환성 갱신이 필요합니다.
65
92
 
66
- ## 동작 범위
93
+ - 정렬 항목을 보기 옵션 메뉴의 DOM에 직접 추가합니다.
94
+ - 공유 Workspace 보기 저장소와 행의 `data-row-key` 속성을 사용합니다.
95
+ - 기본 행을 교체하거나 다른 DOM 부모로 옮기지 않고, Shadow DOM 슬롯으로 위쪽 목록과 하단 영역을 나눕니다. 비활성화하면 기본 슬롯으로 원래 목록을 복원합니다.
67
96
 
68
- - 이전 정렬 복원 설정이 없는 새 설치에서는 최초 활성화 시에만 `하나의 목록 / 에이전트 활동`을 적용합니다. 기존 복원 설정이 있으면 사용자가 선택한 보기 옵션을 유지하며, 새로고침이나 재활성화로 정렬을 강제로 켜지 않습니다. 브라우저 저장소를 사용할 수 없으면 자동 적용하지 않습니다. `세션 필터`는 바꾸지 않으며, `에이전트 활동` 정렬을 선택한 동안에만 순서를 계산합니다.
69
- - 플러그인은 DSH의 공유 Workspace 보기 저장소에 `agent-activity` 정렬 값을 저장합니다. DSH는 이 값을 수동 정렬처럼 읽으므로 화면 순서와 DOM 순서가 일치하고, 새로고침 후에도 선택이 유지됩니다.
70
- - 정렬은 `그룹 기준`이 `하나의 목록`일 때만 활성화됩니다. 다른 그룹 기준에서는 보기 옵션의 `에이전트 활동` 항목이 비활성화되고, 정렬을 켠 채 그룹 기준을 바꾸면 이전 정렬 기준으로 자동 해제됩니다. 정렬을 선택한 동안에는 `하나의 목록`의 순서만 갱신합니다.
71
- - 행을 드래그하면 DSH가 수동 정렬로 전환하므로 에이전트 활동이 자동으로 해제됩니다. DSH의 정렬 변경 규칙을 그대로 따르므로, 에이전트 활동을 켜기 전에 드래그해 둔 수동 배치는 복원되지 않습니다.
72
- - 보관 상태와 보관 필터는 DSH가 소유합니다. 이 플러그인은 브라우저 저장소에 상태를 남기지 않으며, 보관한 세션도 하단 영역에서 그대로 복원할 수 있습니다.
73
- - 기존 세션 행, 검색, 메뉴, 선택, 고정, 보관 필터를 재사용합니다. CSS로 순서만 바꾸지 않고 DSH의 목록 정렬을 갱신하므로 화면 순서와 DOM 순서가 일치합니다.
74
- - Working의 펼침은 320ms로 유지합니다. Archived는 세션 수와 관계없이 실제로 보이는 하단 영역을 480ms 동안 펼칩니다. 접힘은 260ms이며, 운영체제의 동작 줄이기(`prefers-reduced-motion`) 설정을 켜면 애니메이션 없이 즉시 바뀝니다.
75
- - 위쪽 목록과 하단 영역은 DSH 기본 스크롤바의 두께·색상·호버 스타일을 사용합니다. Shadow DOM 안에서도 DSH의 스크롤바 테마 변수를 그대로 따릅니다.
76
- - 접힌 영역의 래퍼는 목록 행 간격을 남기지 않아, 보이는 내용이 짧아도 불필요한 세로 스크롤바가 생기지 않습니다.
77
- - DSH `0.2.x`의 보기 옵션 메뉴에는 플러그인 확장 슬롯이 없어서 정렬 항목을 메뉴 DOM에 직접 추가합니다. DSH가 이 메뉴 구조를 바꾸면 호환성 갱신이 필요합니다. 같은 이유로 공유 Workspace 보기 저장소와 `data-row-key`를 사용합니다. 기본 행은 교체하거나 다른 DOM 부모로 옮기지 않습니다. Shadow DOM 슬롯으로 위쪽 목록과 하단 영역을 나누며, 비활성화하면 기본 슬롯으로 원래 목록 표시를 복원합니다.
78
- - 플러그인을 비활성화하면 이전에 쓰던 정렬 기준으로 돌아갑니다. 정렬 기준이 어긋나 보이면 보기 옵션에서 수동이나 최근 수정일을 한 번 선택하면 DSH 기본 동작으로 돌아갑니다.
97
+ ## 개발
79
98
 
80
- ## 검증
99
+ 소스를 변경한 뒤 다음 명령으로 빌드, 타입 검사, 자동 테스트를 실행합니다.
81
100
 
82
101
  ```bash
83
102
  pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox build
@@ -85,4 +104,5 @@ pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox typecheck
85
104
  pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox test
86
105
  ```
87
106
 
88
- 자동 테스트는 새 설치에서의 기본 정렬 적용과 이후 선택 유지, 정렬 항목 주입과 키보드 순서·선택 표시, 하나의 목록에서의 상태별 순서, 그룹 기준이 다를 때 정렬 항목 비활성화와 자동 해제, 보관한 세션의 하단 배치, 보관 필터별 표시, Working과 Archived의 기본 펼침·접힘과 제목 토글, 보관 해제 반영, UI 언어 전환에 따른 제목 갱신, 정렬 해제와 이전 정렬 복원을 확인합니다.
107
+ 자동 테스트 통과만으로 실제 DSH 화면의 호환성을 확인한 것은 아닙니다. UI를 변경했다면 별도 검증
108
+ 프로필에서 목록 배치와 조작, 테마, 지원 언어를 직접 확인해야 합니다.
package/README.pt.md ADDED
@@ -0,0 +1,109 @@
1
+ [한국어](./README.md) | [English](./README.en.md) | [简体中文](./README.zh.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [Français](./README.fr.md) | [Deutsch](./README.de.md) | **Português** | [Русский](./README.ru.md)
2
+
3
+ # Sidebar Inbox · Caixa de entrada lateral
4
+
5
+ `@dungsil/dsh-plugin-ui-sidebar-inbox`
6
+
7
+ Organiza a lista de sessões da barra lateral do DSH **por estado**, como o T3 Code Nightly. As sessões que precisam da sua resposta sobem para o topo, enquanto as sessões em execução e as arquivadas se agrupam embaixo. A aparência da barra lateral e as linhas de sessão existentes continuam iguais.
8
+
9
+ ## Pré-visualização
10
+
11
+ **Claro**: Arquivadas e Ocultadas temporariamente estão recolhidas à esquerda e expandidas à direita. Os títulos mostram a contagem de sessões.
12
+
13
+ <img src="./assets/sidebar-preview-pt-light.webp" alt="Sidebar Inbox no tema claro: sessões fixadas e da caixa de entrada, Em andamento, Arquivadas e Ocultadas temporariamente com contagens; as duas últimas recolhidas à esquerda e expandidas à direita" width="720" />
14
+
15
+ **Escuro**: as mesmas sessões de exemplo, comparando Arquivadas e Ocultadas temporariamente recolhidas e expandidas.
16
+
17
+ <img src="./assets/sidebar-preview-pt-dark.webp" alt="Sidebar Inbox no tema escuro: sessões fixadas e da caixa de entrada, Em andamento, Arquivadas e Ocultadas temporariamente com contagens; as duas últimas recolhidas à esquerda e expandidas à direita" width="720" />
18
+
19
+ ## Uso
20
+
21
+ 1. Ative **Sidebar Inbox / Caixa de entrada lateral** na tela de gerenciamento de plugins do DSH.
22
+ 2. Na primeira ativação, as opções de visualização são definidas automaticamente como **Agrupar por: Em uma lista** e **Encomendar por: Atividade do agente**. O filtro de sessões não é alterado.
23
+ 3. Para ativá-lo de novo mais tarde, selecione os mesmos dois itens em **Ver opções** na barra lateral.
24
+ 4. Para deixar de usá-lo, mude **Encomendar por** para **Manuais** ou **Última atualização**, ou selecione **Atividade do agente** novamente. Ao selecioná-lo novamente, volta a ordenação que você usava antes de ativar Atividade do agente.
25
+
26
+ ## Posicionamento das sessões
27
+
28
+ | Seção | Sessões incluídas |
29
+ | -------- | -------------------------------------------------------------------------------------------------------------------------------- |
30
+ | Pinned | Sessões fixadas no DSH. Ficam aqui mesmo quando estão em execução ou aguardando resposta. |
31
+ | Inbox | Sessões que precisam de verificação de resposta, aprovação, revisão de plano ou entrada do usuário, e sessões ainda não abertas. |
32
+ | Working | Sessões em que um agente ou subagente está em execução. Passam para Inbox quando surge uma solicitação. |
33
+ | Archived | Sessões arquivadas no DSH. Ficam aqui independentemente de estarem fixadas ou em execução. |
34
+
35
+ - Em cada seção, as sessões atualizadas mais recentemente aparecem primeiro. Uma sessão nova vazia fica no topo, como no DSH.
36
+ - Esse posicionamento vale **somente quando Agrupar por é Em uma lista**. Ao mudar para `Espaço de trabalho` ou `Árvore do espaço de trabalho`, a ordenação Atividade do agente é desativada e a exibição padrão do DSH volta.
37
+
38
+ ## Layout da tela
39
+
40
+ A lista da barra lateral é dividida em uma lista superior e uma área inferior, e cada uma rola separadamente.
41
+
42
+ - **Lista superior**: mostra Pinned e Inbox sem títulos.
43
+ - **Área inferior**: Working e Archived compartilham uma área de rolagem. Os títulos e as sessões juntos nunca ocupam mais de 50% da altura da lista da barra lateral.
44
+ - **Expandir e recolher**: no início, Working fica expandido e Archived recolhido. Clique no título de uma seção ou ative-o pelo teclado para expandi-la ou recolhê-la. Esse estado não é salvo, então recarregar a página restaura o estado inicial.
45
+ - **Quando Archived pode ser recolhido**: somente quando o filtro de sessões é `Todas as conversas (mostrar arquivadas)`. Com o filtro `Somente arquivado`, as sessões arquivadas são a lista inteira, então sempre aparecem expandidas.
46
+
47
+ ## Arquivamento
48
+
49
+ O DSH gerencia se uma sessão está arquivada. Arquive e desarquive uma sessão pelo menu `⋯` dela; este plugin nunca salva nem altera o estado de arquivamento.
50
+
51
+ - Você pode restaurar uma sessão arquivada pela área inferior a qualquer momento.
52
+ - Se uma sessão estiver em execução ou aguardando sua resposta, o DSH interrompe o trabalho dela antes de arquivá-la.
53
+
54
+ ## Idiomas
55
+
56
+ Os títulos da lista e os itens de menu seguem o idioma da interface do DSH. Na interface em português, o item de ordenação aparece como `Atividade do agente` e os títulos das seções como `Em andamento` e `Arquivadas`. O plugin inclui suas próprias traduções, então não é preciso instalar um pacote de idioma à parte.
57
+
58
+ ## Comportamento detalhado
59
+
60
+ ### Manter a escolha de ordenação
61
+
62
+ - A configuração automática é aplicada **apenas uma vez, na primeira ativação** de uma instalação nova sem registro de ordenação anterior. Depois disso, recarregar ou reativar o plugin mantém as opções de visualização que você escolheu.
63
+ - Se o armazenamento do navegador não estiver disponível, a configuração automática não é aplicada.
64
+ - O valor de ordenação selecionado (`agent-activity`) é salvo no armazenamento de visualização compartilhado do Workspace do DSH, por isso se mantém após recarregar.
65
+ - Ao desativar o plugin, volta a ordenação que você usava antes. Se a ordem parecer errada, selecione uma vez **Manuais** ou **Última atualização** nas opções de visualização.
66
+
67
+ ### Relação com a ordenação manual
68
+
69
+ Ao arrastar uma linha de sessão, o DSH muda para a ordenação manual, o que desativa a ordenação Atividade do agente. A disposição manual que você tinha arrastado antes de ativar Atividade do agente não é restaurada. Isso segue as próprias regras do DSH para mudar a ordenação.
70
+
71
+ ### Reutilização de recursos do DSH
72
+
73
+ - Linhas de sessão, busca, menus, seleção, fixação e filtro de arquivamento usam os recursos existentes do DSH.
74
+ - O plugin atualiza a ordem da lista do DSH em vez de reordenar apenas com CSS, então a ordem na tela coincide com a ordem do DOM (a ordem de navegação pelo teclado).
75
+ - As barras de rolagem seguem a espessura, a cor e o estilo ao passar o cursor da barra de rolagem padrão do DSH.
76
+
77
+ ### Animação
78
+
79
+ | Ação | Duração |
80
+ | ----------------- | ------- |
81
+ | Expandir Working | 320ms |
82
+ | Expandir Archived | 480ms |
83
+ | Recolher | 260ms |
84
+
85
+ Com a opção de reduzir movimento do sistema operacional (`prefers-reduced-motion`) ativada, as mudanças acontecem na hora, sem animação.
86
+
87
+ ### Notas de compatibilidade
88
+
89
+ O menu de opções de visualização do DSH `0.2.x` não tem um slot de extensão para plugins. Por isso, este plugin depende das estruturas internas abaixo e precisa de uma atualização de compatibilidade se o DSH as mudar.
90
+
91
+ - Adiciona o item de ordenação diretamente ao DOM do menu de opções de visualização.
92
+ - Usa o armazenamento de visualização compartilhado do Workspace e o atributo `data-row-key` das linhas.
93
+ - Nunca substitui as linhas padrão nem as move para outro elemento pai do DOM; separa a lista superior e a área inferior com slots de Shadow DOM. Ao desativá-lo, o slot padrão restaura a lista original.
94
+
95
+ ## Desenvolvimento
96
+
97
+ ```bash
98
+ pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox build
99
+ pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox typecheck
100
+ pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox test
101
+ ```
102
+
103
+ Os testes automatizados verificam o comportamento a seguir.
104
+
105
+ - Uma instalação nova aplica a ordenação padrão e depois mantém a escolha do usuário.
106
+ - O item de ordenação é adicionado ao menu com a ordem de teclado e a marca de seleção corretas. Quando Agrupar por é diferente, o item é desativado e a ordenação é liberada automaticamente.
107
+ - Em uma lista, as sessões são posicionadas por estado, as arquivadas vão para baixo e cada filtro de arquivamento as exibe de forma diferente.
108
+ - Working e Archived começam expandido e recolhido e alternam pelos títulos; o desarquivamento é refletido; os títulos são atualizados quando o idioma da interface muda.
109
+ - Liberar a ordenação restaura a ordem anterior.
package/README.ru.md ADDED
@@ -0,0 +1,109 @@
1
+ [한국어](./README.md) | [English](./README.en.md) | [简体中文](./README.zh.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [Français](./README.fr.md) | [Deutsch](./README.de.md) | [Português](./README.pt.md) | **Русский**
2
+
3
+ # Sidebar Inbox · Входящие на боковой панели
4
+
5
+ `@dungsil/dsh-plugin-ui-sidebar-inbox`
6
+
7
+ Плагин упорядочивает список сеансов на боковой панели DSH **по состоянию**, как в T3 Code Nightly. Сеансы, которые ждут вашего ответа, поднимаются вверх, а выполняющиеся и архивные сеансы собираются внизу. Внешний вид боковой панели и строки сеансов остаются прежними.
8
+
9
+ ## Предпросмотр
10
+
11
+ **Светлая тема**: слева «Архивные» и «Временно скрытые» свёрнуты, справа развёрнуты. Заголовки показывают количество сеансов.
12
+
13
+ <img src="./assets/sidebar-preview-ru-light.webp" alt="Sidebar Inbox в светлой теме: закреплённые и входящие сеансы, «В работе», «Архивные» и «Временно скрытые» с количеством; два последних раздела свёрнуты слева и развёрнуты справа" width="720" />
14
+
15
+ **Тёмная тема**: те же примеры сеансов; сравнение свёрнутых и развёрнутых «Архивных» и «Временно скрытых».
16
+
17
+ <img src="./assets/sidebar-preview-ru-dark.webp" alt="Sidebar Inbox в тёмной теме: закреплённые и входящие сеансы, «В работе», «Архивные» и «Временно скрытые» с количеством; два последних раздела свёрнуты слева и развёрнуты справа" width="720" />
18
+
19
+ ## Использование
20
+
21
+ 1. Включите **Sidebar Inbox / Входящие на боковой панели** на экране управления плагинами DSH.
22
+ 2. При первом включении параметры вида автоматически принимают значения **Группировать по: В одном списке** и **Заказать по: Активность агента**. Фильтр сеансов не меняется.
23
+ 3. Чтобы позже включить режим снова, выберите эти же два пункта в меню **Посмотреть варианты** на боковой панели.
24
+ 4. Чтобы перестать пользоваться режимом, переключите **Заказать по** на **Руководство** (ручной порядок) или **Последнее обновление** либо ещё раз выберите **Активность агента**. При повторном выборе вернётся порядок, который действовал до включения сортировки «Активность агента».
25
+
26
+ ## Размещение сеансов
27
+
28
+ | Раздел | Какие сеансы входят |
29
+ | -------- | -------------------------------------------------------------------------------------------------------------------- |
30
+ | Pinned | Сеансы, закреплённые в DSH. Остаются здесь, даже если выполняются или ждут ответа. |
31
+ | Inbox | Сеансы, где нужно проверить ответ, дать одобрение, проверить план или ввести данные, а также ещё не открытые сеансы. |
32
+ | Working | Сеансы, в которых выполняется агент или субагент. При появлении запроса переходят в Inbox. |
33
+ | Archived | Сеансы, архивированные в DSH. Остаются здесь независимо от закрепления и состояния выполнения. |
34
+
35
+ - Внутри каждого раздела первыми идут недавно обновлённые сеансы. Пустой новый сеанс, как и в DSH, остаётся вверху.
36
+ - Такое размещение действует **только когда «Группировать по» имеет значение «В одном списке»**. При переключении на `Рабочее пространство` или `Дерево рабочей области` сортировка «Активность агента» снимается и возвращается стандартное отображение DSH.
37
+
38
+ ## Структура экрана
39
+
40
+ Список на боковой панели делится на верхний список и нижнюю область, которые прокручиваются независимо.
41
+
42
+ - **Верхний список**: показывает Pinned и Inbox без заголовков.
43
+ - **Нижняя область**: Working и Archived используют общую область прокрутки. Их заголовки и сеансы вместе занимают не больше 50% высоты списка боковой панели.
44
+ - **Развёртывание и свёртывание**: сначала Working развёрнут, а Archived свёрнут. Щёлкните заголовок раздела или активируйте его с клавиатуры, чтобы развернуть или свернуть раздел. Это состояние не сохраняется: после перезагрузки восстанавливается исходное.
45
+ - **Когда Archived можно свернуть**: только если фильтр сеансов — `Все разговоры (показать в архиве)`. С фильтром `Только в архиве` архивные сеансы составляют весь список, поэтому всегда показываются развёрнутыми.
46
+
47
+ ## Архивирование
48
+
49
+ Архивным состоянием сеансов управляет DSH. Архивируйте и разархивируйте сеанс через его меню `⋯`; плагин никогда не сохраняет и не меняет архивное состояние.
50
+
51
+ - Архивный сеанс можно в любой момент восстановить из нижней области.
52
+ - Если сеанс выполняется или ждёт вашего ответа, DSH останавливает его работу перед архивированием.
53
+
54
+ ## Языки
55
+
56
+ Заголовки списка и пункты меню следуют языку интерфейса DSH. В русском интерфейсе пункт сортировки называется `Активность агента`, а заголовки разделов — `В работе` и `Архивные`. Плагин содержит собственные переводы, поэтому отдельный языковой пакет не нужен.
57
+
58
+ ## Подробности работы
59
+
60
+ ### Сохранение выбранной сортировки
61
+
62
+ - Автоматическая настройка применяется **только один раз — при первом включении** в новой установке без сохранённой прежней сортировки. После этого перезагрузка или повторное включение плагина сохраняют выбранные вами параметры вида.
63
+ - Если хранилище браузера недоступно, автоматическая настройка не применяется.
64
+ - Выбранное значение сортировки (`agent-activity`) сохраняется в общем хранилище вида Workspace в DSH и поэтому сохраняется после перезагрузки.
65
+ - При отключении плагина возвращается порядок, который использовался раньше. Если порядок выглядит неправильно, один раз выберите в параметрах вида **Руководство** или **Последнее обновление**.
66
+
67
+ ### Связь с ручной сортировкой
68
+
69
+ Если перетащить строку сеанса, DSH переключается на ручную сортировку, и сортировка «Активность агента» снимается. Ручное расположение, созданное перетаскиванием до включения «Активности агента», не восстанавливается. Так работают собственные правила DSH для смены сортировки.
70
+
71
+ ### Повторное использование функций DSH
72
+
73
+ - Строки сеансов, поиск, меню, выделение, закрепление и фильтр архива используют существующие функции DSH.
74
+ - Плагин обновляет порядок списка DSH, а не меняет его только через CSS, поэтому порядок на экране совпадает с порядком в DOM (порядком навигации с клавиатуры).
75
+ - Полосы прокрутки повторяют толщину, цвет и стиль наведения стандартной полосы прокрутки DSH.
76
+
77
+ ### Анимация
78
+
79
+ | Действие | Длительность |
80
+ | ---------------------- | ------------ |
81
+ | Развёртывание Working | 320ms |
82
+ | Развёртывание Archived | 480ms |
83
+ | Свёртывание | 260ms |
84
+
85
+ Если в операционной системе включено уменьшение движения (`prefers-reduced-motion`), изменения применяются сразу, без анимации.
86
+
87
+ ### Замечания о совместимости
88
+
89
+ В меню параметров вида DSH `0.2.x` нет слота расширения для плагинов. Поэтому плагин зависит от перечисленных ниже внутренних структур и требует обновления совместимости, если DSH их изменит.
90
+
91
+ - Пункт сортировки добавляется прямо в DOM меню параметров вида.
92
+ - Используются общее хранилище вида Workspace и атрибут `data-row-key` у строк.
93
+ - Стандартные строки не заменяются и не переносятся в другой родительский элемент DOM; верхний список и нижняя область разделяются слотами Shadow DOM. После отключения стандартный слот восстанавливает исходный список.
94
+
95
+ ## Разработка
96
+
97
+ ```bash
98
+ pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox build
99
+ pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox typecheck
100
+ pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox test
101
+ ```
102
+
103
+ Автоматические тесты проверяют следующее поведение.
104
+
105
+ - Новая установка применяет сортировку по умолчанию, а затем сохраняет выбор пользователя.
106
+ - Пункт сортировки добавляется в меню с правильным порядком клавиатурной навигации и отметкой выбора. При другой группировке пункт отключается, а сортировка автоматически снимается.
107
+ - В одном списке сеансы размещаются по состоянию, архивные сеансы уходят вниз, а каждый фильтр архива показывает их по-своему.
108
+ - Working и Archived изначально развёрнут и свёрнут и переключаются по заголовкам; разархивирование учитывается; заголовки обновляются при смене языка интерфейса.
109
+ - Снятие сортировки восстанавливает прежний порядок.
package/README.zh.md ADDED
@@ -0,0 +1,109 @@
1
+ [한국어](./README.md) | [English](./README.en.md) | **简体中文** | [日本語](./README.ja.md) | [Español](./README.es.md) | [Français](./README.fr.md) | [Deutsch](./README.de.md) | [Português](./README.pt.md) | [Русский](./README.ru.md)
2
+
3
+ # Sidebar Inbox · 侧边栏收件箱
4
+
5
+ `@dungsil/dsh-plugin-ui-sidebar-inbox`
6
+
7
+ 本插件像 T3 Code Nightly 一样,将 DSH 侧边栏的会话列表**按状态**整理。需要你回复的会话移到上方,运行中的会话和已归档的会话集中在下方。侧边栏原有的外观和会话行保持不变。
8
+
9
+ ## 预览
10
+
11
+ **浅色**:左侧为已归档和已暂时隐藏折叠状态,右侧为两个分区展开状态。分区标题显示会话数量。
12
+
13
+ <img src="./assets/sidebar-preview-zh-light.webp" alt="浅色主题、中文界面的 Sidebar Inbox:置顶和收件箱会话,以及进行中、已归档、已暂时隐藏列表和会话数量;左侧折叠已归档和已暂时隐藏,右侧展开" width="720" />
14
+
15
+ **深色**:使用相同的示例会话,对比已归档和已暂时隐藏的折叠与展开。
16
+
17
+ <img src="./assets/sidebar-preview-zh-dark.webp" alt="深色主题、中文界面的 Sidebar Inbox:置顶和收件箱会话,以及进行中、已归档、已暂时隐藏列表和会话数量;左侧折叠已归档和已暂时隐藏,右侧展开" width="720" />
18
+
19
+ ## 使用方法
20
+
21
+ 1. 在 DSH 的插件管理界面中启用 **Sidebar Inbox / 侧边栏收件箱**。
22
+ 2. 首次启用时,视图选项会自动设为 **分组方式:单列表**、**排序方式:Agent activity**。会话筛选不会改变。
23
+ 3. 之后要重新开启,请在侧边栏的 **视图选项** 中选择相同的两项。
24
+ 4. 要停止使用,请将排序方式改为 **手动排序** 或 **最近更新**,或再次选择 **Agent activity**。再次选择时,会恢复开启 Agent activity 之前使用的排序。
25
+
26
+ ## 会话分区
27
+
28
+ | 分区 | 包含的会话 |
29
+ | -------- | -------------------------------------------------------------- |
30
+ | Pinned | 在 DSH 中置顶的会话。即使正在运行或等待回复,也留在此分区。 |
31
+ | Inbox | 需要查看回复、批准、审阅计划、需要用户输入,或尚未打开的会话。 |
32
+ | Working | 智能体或子智能体正在运行的会话。出现请求时移到 Inbox。 |
33
+ | Archived | 在 DSH 中归档的会话。无论是否置顶或正在运行,都留在此分区。 |
34
+
35
+ - 每个分区内,最近更新的会话排在前面。没有内容的新会话与 DSH 默认行为一样置于最上方。
36
+ - 此分区**仅在分组方式为单列表时**生效。切换到 `按工作区` 或 `按工作区树` 时,Agent activity 排序会被解除,并恢复 DSH 的默认显示。
37
+
38
+ ## 界面布局
39
+
40
+ 侧边栏列表分为上方列表和下方区域,两者各自滚动。
41
+
42
+ - **上方列表**:不带标题地显示 Pinned 和 Inbox。
43
+ - **下方区域**:Working 和 Archived 共用一个滚动区域。两者的标题与会话合计高度不超过侧边栏列表高度的 50%。
44
+ - **展开与折叠**:初始时 Working 展开、Archived 折叠。点击分区标题或用键盘激活即可展开或折叠。此状态不会保存,刷新后恢复初始状态。
45
+ - **Archived 的折叠条件**:仅当会话筛选为 `全部对话(显示已归档)` 时才能折叠。在 `仅显示已归档` 筛选下,已归档会话就是整个列表,因此始终展开显示。
46
+
47
+ ## 归档
48
+
49
+ 会话是否归档由 DSH 管理。归档和取消归档在会话的 `⋯` 菜单中执行,本插件不会保存或修改归档状态。
50
+
51
+ - 已归档的会话随时可以在下方区域中恢复。
52
+ - 对于正在运行或等待你回复的会话,DSH 会在归档前先停止其工作。
53
+
54
+ ## 语言
55
+
56
+ 列表标题和菜单项跟随 DSH 的界面语言。插件自带英语、韩语、日语、西班牙语、法语、德语、俄语和葡萄牙语的译文,但不含中文译文。因此在中文界面中,这些文字会按 DSH 的回退规则以英语显示:排序项为 `Agent activity`,分区标题为 `Working` 和 `Archived`。
57
+
58
+ ## 详细行为
59
+
60
+ ### 保留排序选择
61
+
62
+ - 自动设置**仅在新安装且没有以前的排序记录时,于首次启用时应用一次**。之后即使刷新或重新启用,也会保留你选择的视图选项。
63
+ - 浏览器存储不可用时,不会应用自动设置。
64
+ - 所选排序值(`agent-activity`)保存在 DSH 共享的 Workspace 视图存储中,因此刷新后依然保留。
65
+ - 停用插件后,会恢复之前使用的排序。如果排序看起来不对,请在视图选项中选择一次 **手动排序** 或 **最近更新**。
66
+
67
+ ### 与手动排序的关系
68
+
69
+ 拖动会话行时,DSH 会切换为手动排序,因此 Agent activity 排序会被解除。开启 Agent activity 之前拖动好的手动排列不会恢复。此行为直接遵循 DSH 的排序变更规则。
70
+
71
+ ### 复用 DSH 现有功能
72
+
73
+ - 会话行、搜索、菜单、选择、置顶和归档筛选都直接使用 DSH 的现有功能。
74
+ - 插件更新 DSH 的列表顺序,而不是仅用 CSS 调整顺序,因此屏幕顺序与 DOM 顺序(键盘导航顺序)一致。
75
+ - 滚动条遵循 DSH 默认滚动条的粗细、颜色和悬停样式。
76
+
77
+ ### 动画
78
+
79
+ | 操作 | 时长 |
80
+ | ------------- | ----- |
81
+ | 展开 Working | 320ms |
82
+ | 展开 Archived | 480ms |
83
+ | 折叠 | 260ms |
84
+
85
+ 开启操作系统的减少动态效果(`prefers-reduced-motion`)设置时,会立即切换而不播放动画。
86
+
87
+ ### 兼容性说明
88
+
89
+ DSH `0.2.x` 的视图选项菜单没有插件扩展槽。因此本插件依赖以下内部结构,若 DSH 更改这些结构,需要进行兼容性更新。
90
+
91
+ - 将排序项直接添加到视图选项菜单的 DOM 中。
92
+ - 使用共享的 Workspace 视图存储和行上的 `data-row-key` 属性。
93
+ - 不替换默认行,也不把它们移到其他 DOM 父节点,而是用 Shadow DOM 插槽划分上方列表和下方区域。停用后,默认插槽会恢复原有列表。
94
+
95
+ ## 开发
96
+
97
+ ```bash
98
+ pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox build
99
+ pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox typecheck
100
+ pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox test
101
+ ```
102
+
103
+ 自动测试检查以下行为。
104
+
105
+ - 新安装时应用默认排序,之后保留用户的选择。
106
+ - 在菜单中添加排序项,并保持键盘顺序和选中标记。分组方式不同时禁用该项并自动解除排序。
107
+ - 在单列表中按状态排列,将已归档会话放在下方,并按归档筛选分别显示。
108
+ - Working 和 Archived 的默认展开与折叠、标题切换、取消归档的反映,以及随界面语言切换更新标题。
109
+ - 解除排序时恢复之前的排序。