dsh-matrix-todo 0.0.0-stage → 1.0.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/CHANGELOG.md +32 -0
- package/LICENSE +21 -0
- package/README.md +202 -2
- package/client.js +2074 -0
- package/cordis.patch.yml +5 -0
- package/icon.svg +7 -0
- package/index.js +122 -0
- package/lib/store.js +469 -0
- package/locale/en.json +6 -0
- package/locale/zh.json +6 -0
- package/package.json +46 -3
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## 1.0.0
|
|
4
|
+
|
|
5
|
+
First public release.
|
|
6
|
+
|
|
7
|
+
- Eisenhower-matrix panel: four importance × urgency quadrants (do first /
|
|
8
|
+
schedule / delegate / drop), each auto-filling the panel with its own count
|
|
9
|
+
and an inline "add here" row.
|
|
10
|
+
- One-click switch between the matrix and the completed view; completed items
|
|
11
|
+
can be restored or removed, and clearing requires a second confirmation.
|
|
12
|
+
- Drag any to-do to reorder inside a quadrant or drop it into another quadrant
|
|
13
|
+
(the important/urgent flags follow it); the order is persisted.
|
|
14
|
+
- The centre dot resizes the quadrants (20%–80%), snaps back to an even split,
|
|
15
|
+
and a double click resets it.
|
|
16
|
+
- Per-item due dates with a hand-drawn picker (single click previews, double
|
|
17
|
+
click commits and adds the item); due/overdue items are colour-marked and can
|
|
18
|
+
show a countdown.
|
|
19
|
+
- Completing an item pops a random encouragement in the centre of the plugin
|
|
20
|
+
panel, split into "on time" praise and "overdue" encouragement, never
|
|
21
|
+
repeating the previous line.
|
|
22
|
+
- Double-click a to-do to edit its title in place; Enter saves, Escape cancels.
|
|
23
|
+
- Settings: urgent column side, frame style (cards / grid / cross), soft
|
|
24
|
+
quadrant tint, corner radius, font size, text wrap or truncate, date or
|
|
25
|
+
countdown, custom sidebar label, reset to defaults.
|
|
26
|
+
- Minimal styling built only on `--dsw-alias-*` theme tokens, so the panel
|
|
27
|
+
follows light/dark appearance and the active skin.
|
|
28
|
+
- Bilingual UI (English / 简体中文) following the Harness language setting.
|
|
29
|
+
- Data and settings live in one JSON file under the profile (`data/dsh-matrix-todo/todos.json`),
|
|
30
|
+
written atomically with a serialised queue; a corrupt file is backed up and
|
|
31
|
+
replaced with an empty list.
|
|
32
|
+
- Settings footer links to GitHub feedback and the author's profile.
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Zhang-Eli
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,203 @@
|
|
|
1
|
-
#
|
|
1
|
+
# 四象限待办 · dsh-matrix-todo
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
DeepSeek Harness 的侧栏待办插件:主界面是艾森豪威尔矩阵(重要 × 紧急四个象限),可一键切换到「已完成」;数据与界面设置写入本机 profile 下的一个 JSON 文件。
|
|
4
|
+
|
|
5
|
+
- 侧边栏新增入口「四象限待办」,排在自带「待办」之后
|
|
6
|
+
- 矩阵视图:立即做 / 计划做 / 委托做 / 别做,四个象限自动撑满面板、各自计数
|
|
7
|
+
- 拖动四象限中心的圆点即可调整行/列比例,双击圆点恢复均分
|
|
8
|
+
- 每个象限都能直接点击空白处或底部「+ 添加」就地新增,可为该条设置截止日期
|
|
9
|
+
- 到期日临期/逾期会在行内变色标识,逾期标题转为警示色
|
|
10
|
+
- 拖动任意待办可在象限内上下排序,或直接拖到另一个象限
|
|
11
|
+
- 双击待办文字即可就地重写标题,回车保存、Esc 取消
|
|
12
|
+
- 完成一项时在**插件面板正中**(不含左侧边栏)弹出随机鼓励浮窗(中英各 8 条,避免连续重复)
|
|
13
|
+
- 顶部一键切换「四象限 ↔ 已完成」,已完成项可恢复或删除,清空需二次确认
|
|
14
|
+
- 齿轮设置:紧急列在左 / 在右、边框风格(卡片 / 田字格 / 十字线)、象限底色(纯色 / 淡彩)、圆角幅度、待办字号、文字显示、日期显示、侧栏名称、恢复默认
|
|
15
|
+
- 设置面板底部有一条链接行:左侧「反馈问题」,右侧是带头像的「*Developed by* Zhang-Eli」(都在系统浏览器中打开)
|
|
16
|
+
- 极简风:界面颜色只用 `--dsw-alias-*` 主题 token(淡彩底色由 token 混出),跟随明暗外观与配色风格
|
|
17
|
+
- 界面文案中英双语,跟随 Harness 语言设置
|
|
18
|
+
|
|
19
|
+
## 安装
|
|
20
|
+
|
|
21
|
+
从 npm 安装(推荐):
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
dsh plugin --profile desktop add dsh-matrix-todo
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
或在 Harness 里用插件管理工具安装:
|
|
28
|
+
|
|
29
|
+
```text
|
|
30
|
+
plugin_manager install_bundle target: dsh-matrix-todo
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
从本仓库目录安装(开发用,改 `client.js` 由 HMR 即时生效):
|
|
34
|
+
|
|
35
|
+
```text
|
|
36
|
+
plugin_manager install_bundle target: <本目录绝对路径>
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
安装后侧边栏出现「四象限待办」,点击即打开矩阵面板。
|
|
40
|
+
|
|
41
|
+
## 使用
|
|
42
|
+
|
|
43
|
+
**新增**
|
|
44
|
+
|
|
45
|
+
- 点击象限空白处,或点象限底部「+ 添加」,输入标题后回车;连续回车可连续添加,Esc 退出。
|
|
46
|
+
- 新增项直接使用该象限的重要/紧急标记,不需要先选分类。
|
|
47
|
+
- 新增区右侧的日历按钮打开日期面板:
|
|
48
|
+
- **单击**某天只预览/改选,面板保持打开,可以反复点选;
|
|
49
|
+
- **双击**某天即确定截止日期,面板关闭并**自动把这条待办加入该象限**;
|
|
50
|
+
- 面板里还能切换月份、选「今天」、或「清除」已选日期。
|
|
51
|
+
- 也可以只单击选好日期后按回车提交,效果相同(带上该日期)。
|
|
52
|
+
|
|
53
|
+
**到期标识**
|
|
54
|
+
|
|
55
|
+
- 到期日 = 今天的待办,日期文字用警示色加粗;已过期则日期变红、标题也转红。
|
|
56
|
+
- 日期固定在每行最右侧,两种显示方式可在设置里切换:**日期**(如 `11-11`)或**倒计时**(如 `7d`、`0d`、`-3d`)。
|
|
57
|
+
- 点日期本身会打开同一个自绘日历:单击预览、双击确认保存;「清除」可去掉日期。还没设日期的行,悬浮工具条里会出现日历按钮作为入口。
|
|
58
|
+
|
|
59
|
+
**拖拽排序 / 跨象限**
|
|
60
|
+
|
|
61
|
+
- 按住任意待办行上下拖动,出现蓝色插入线时松手即完成排序。
|
|
62
|
+
- 拖到另一个象限的列表里松手,该条会连同「重要 / 紧急」标记一起移过去,并落在外框高亮的目标象限。
|
|
63
|
+
- 顺序会持久保存;一旦手动排过序,之后新增的待办仍排在该象限最前面。
|
|
64
|
+
|
|
65
|
+
**完成反馈**
|
|
66
|
+
|
|
67
|
+
完成一项时会在插件面板正中(右侧主面板区域,不含左侧边栏)弹出一个小浮窗,按是否按期分成两类语气:
|
|
68
|
+
|
|
69
|
+
| 情况 | 弹窗内容 | 图标 |
|
|
70
|
+
| --- | --- | --- |
|
|
71
|
+
| 按期完成(当天或提前完成,或未设日期) | 表扬,「Well done! 按期完成」「漂亮,正好赶上」等 | 成功色对勾 |
|
|
72
|
+
| 逾期完成(完成时截止日期已过) | 勉励,「完成了就好,下次早点开始」「逾期也完成了,值得肯定」等 | 品牌色箭头 |
|
|
73
|
+
|
|
74
|
+
中英各 8 条,同类内随机且不会连续重复;约 2.6 秒后自动消失,不拦截鼠标操作。取消完成/恢复不会触发。
|
|
75
|
+
|
|
76
|
+
**双击编辑**
|
|
77
|
+
|
|
78
|
+
- 双击任意待办的文字即进入就地编辑,输入框带下划线提示。
|
|
79
|
+
- 回车或点击别处保存,Esc 取消;标题去空白后为空(或没有改动)则视为放弃修改。
|
|
80
|
+
|
|
81
|
+
**整理**
|
|
82
|
+
|
|
83
|
+
- 勾选复选框 → 完成,移入「已完成」;「已完成」里的复选框可恢复。
|
|
84
|
+
- 行内悬浮(或键盘聚焦)出现小按钮:改「重要」、改「紧急」、设日期、删除;改标记会即时在象限间移动。
|
|
85
|
+
- 「清空已完成」点一次变成「确认清空」,再点一次才真正清除(3 秒后自动退回)。
|
|
86
|
+
|
|
87
|
+
**设置**
|
|
88
|
+
|
|
89
|
+
点右上角齿轮展开设置,修改即时生效并自动保存:
|
|
90
|
+
|
|
91
|
+
| 设置项 | 取值 | 说明 |
|
|
92
|
+
| --- | --- | --- |
|
|
93
|
+
| 紧急方向 | 在左 / 在右 | 「紧急」列放在矩阵左侧或右侧;默认在右 |
|
|
94
|
+
| 边框风格 | 卡片 / 田字格 / 十字线 | 卡片=四个圆角框;田字格=外框 + 中间十字线;十字线=只有中间十字、无外框;默认十字线 |
|
|
95
|
+
| 象限底色 | 纯色 / 淡彩 | 淡彩用低饱和主题色给四个象限分别铺一层很淡的底色;默认纯色 |
|
|
96
|
+
| 圆角幅度 | 0–24px(步长 2) | 卡片风格作用于每个象限框,田字格/十字线风格作用于外框;默认 10px |
|
|
97
|
+
| 字号 | 11–17px(步长 1) | 待办标题与象限内输入框的字号;默认 14px |
|
|
98
|
+
| 文字显示 | 完整换行 / 单行截断 | 完整换行时内容全部展示;单行截断时超长内容以省略号收尾;默认完整换行 |
|
|
99
|
+
| 侧边栏名称 | 0–24 字 | 自定义左侧入口显示的文字,留空则用默认的「四象限待办」 |
|
|
100
|
+
| 日期显示 | 日期 / 倒计时 | 日期显示 `11-11`;倒计时显示距今天数 `7d`、`0d`、逾期 `-3d`;默认倒计时 |
|
|
101
|
+
| 恢复默认 | 按钮 | 立即回到 紧急在右 / 十字线 / 纯色 / 10px / 14px / 完整换行 / 倒计时 / 均分 |
|
|
102
|
+
|
|
103
|
+
**象限大小**
|
|
104
|
+
|
|
105
|
+
鼠标移动到矩阵中心附近(约 56px 内)才会浮出一个小圆点,避免平时干扰视线。按住圆点拖动即可实时调整四象限的行列比例(左右各 20%–80%),松手自动保存。
|
|
106
|
+
|
|
107
|
+
拖动过程中会出现一个**默认等分参考标记**——正中央一段两端渐隐的短十字线与一个实心圆点;把圆点拖到它附近会自动吸附回正中间(吸附时参考标记与圆点都会高亮),方便一键恢复等分。双击圆点也能直接复位。
|
|
108
|
+
|
|
109
|
+
十字线风格下中间的实际十字线会跟着比例移动。
|
|
110
|
+
|
|
111
|
+
**关于与链接**
|
|
112
|
+
|
|
113
|
+
设置面板最下方有一条链接行,都会用系统默认浏览器打开:
|
|
114
|
+
|
|
115
|
+
| 位置 | 内容 | 地址 | 说明 |
|
|
116
|
+
| --- | --- | --- | --- |
|
|
117
|
+
| 最左 | 反馈问题 | `https://github.com/Zhang-Eli/dsh-matrix-todo/issues` | 提 issue、报告 bug |
|
|
118
|
+
| 最右 | *Developed by* + 头像 + Zhang-Eli | `https://github.com/Zhang-Eli` | 顺序为斜体的「Developed by」、16px 圆形 GitHub 头像、用户名;只有用户名是可点击链接,跳转 GitHub |
|
|
119
|
+
|
|
120
|
+
## 数据文件
|
|
121
|
+
|
|
122
|
+
默认 `%DSH_PROFILE_DIR%\data\dsh-matrix-todo\todos.json`(无 `DSH_PROFILE_DIR` 时退化为进程工作目录下的同名相对路径)。
|
|
123
|
+
|
|
124
|
+
```json
|
|
125
|
+
{
|
|
126
|
+
"version": 1,
|
|
127
|
+
"todos": [
|
|
128
|
+
{
|
|
129
|
+
"id": "e_m3k2_ab12",
|
|
130
|
+
"title": "交周报",
|
|
131
|
+
"important": true,
|
|
132
|
+
"urgent": false,
|
|
133
|
+
"done": false,
|
|
134
|
+
"dueDate": "2026-11-15",
|
|
135
|
+
"createdAt": "2026-11-09T10:00:00.000Z",
|
|
136
|
+
"updatedAt": "2026-11-09T10:00:00.000Z",
|
|
137
|
+
"completedAt": null
|
|
138
|
+
}
|
|
139
|
+
],
|
|
140
|
+
"settings": {
|
|
141
|
+
"urgentSide": "right",
|
|
142
|
+
"frame": "cross",
|
|
143
|
+
"radius": 10,
|
|
144
|
+
"tint": "plain",
|
|
145
|
+
"fontSize": 14,
|
|
146
|
+
"dueFormat": "countdown",
|
|
147
|
+
"titleStyle": "wrap",
|
|
148
|
+
"colRatio": 0.5,
|
|
149
|
+
"rowRatio": 0.5,
|
|
150
|
+
"navLabel": ""
|
|
151
|
+
},
|
|
152
|
+
"reordered": false
|
|
153
|
+
}
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
`todos` 的数组顺序就是同象限内的显示顺序。`reordered` 为 `false` 时顺序按创建时间倒序派生(新条目在前);一旦手动拖拽排序,它就变成 `true`,此后数组顺序即你的顺序。`dueDate` 为 `YYYY-MM-DD` 或 `null`。
|
|
157
|
+
|
|
158
|
+
写盘是「临时文件 + rename」的原子替换,写操作串行排队;文件损坏时会先备份为 `todos.corrupt-<时间戳>.json`,再以空清单 + 默认设置启动。手改文件里的 `settings` 非法值会被忽略并回落到默认值。
|
|
159
|
+
|
|
160
|
+
可在 `cordis.patch.yml` 的插件行里覆盖路径:
|
|
161
|
+
|
|
162
|
+
```yaml
|
|
163
|
+
- id: matrix-todo
|
|
164
|
+
config:
|
|
165
|
+
dataPath: 'D:\notes\todos.json'
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
## HTTP 接口(面板自用)
|
|
169
|
+
|
|
170
|
+
Host 半在 `/matrix-todo/api` 注册 prefix 路由,只接受 POST,并做同源/回环校验:
|
|
171
|
+
|
|
172
|
+
| 方法 | body | 说明 |
|
|
173
|
+
| --- | --- | --- |
|
|
174
|
+
| `list` | `{}` | 取全部待办与设置 |
|
|
175
|
+
| `create` | `{ title, important, urgent, dueDate? }` | 新建 |
|
|
176
|
+
| `update` | `{ id, title?, important?, urgent?, dueDate? }` | 改字段(含象限标记、截止日期;`dueDate: null` 清除) |
|
|
177
|
+
| `toggle` | `{ id }` | 完成 / 恢复 |
|
|
178
|
+
| `reorder` | `{ id, important?, urgent?, beforeId }` | 拖动结果:移到目标象限并插到 `beforeId` 之前(`null` = 末尾) |
|
|
179
|
+
| `remove` | `{ id }` | 删除 |
|
|
180
|
+
| `clearCompleted` | `{}` | 清空已完成 |
|
|
181
|
+
| `saveSettings` | `{ urgentSide?, frame?, radius?, tint?, fontSize?, dueFormat?, titleStyle?, colRatio?, rowRatio?, navLabel? }` | 合并保存界面设置 |
|
|
182
|
+
|
|
183
|
+
成功返回 `{ ok: true, result: { todos, settings } }`;失败返回 `{ ok: false, error: { code, message } }`,状态码 `invalid-input` 400 / `not-found` 404 / `io-error` 500。标题去空白后 1–200 字符,清单上限 500 条,圆角 0–24 整数,字号 11–17 整数,`dueDate` 必须是真实存在的 `YYYY-MM-DD` 日期。
|
|
184
|
+
|
|
185
|
+
## 文件结构
|
|
186
|
+
|
|
187
|
+
| 文件 | 作用 |
|
|
188
|
+
| --- | --- |
|
|
189
|
+
| `package.json` | 包清单:`dsh.bundle.patch` + `dsh.client`(web、immediately、locale/sidebar 依赖) |
|
|
190
|
+
| `cordis.patch.yml` | 插入插件行 `matrix-todo` |
|
|
191
|
+
| `index.js` | Host 半:注册 HTTP 路由,管理 store 生命周期 |
|
|
192
|
+
| `lib/store.js` | 文件型 store:待办与设置、校验、原子写、备份损坏文件 |
|
|
193
|
+
| `client.js` | Client 半:侧栏入口、矩阵与已完成两个视图、设置面板、全部样式 |
|
|
194
|
+
| `locale/en.json`、`locale/zh.json` | 插件管理器的标题/描述 |
|
|
195
|
+
| `icon.svg` | 插件图标(2×2 矩阵) |
|
|
196
|
+
|
|
197
|
+
## 已知边界
|
|
198
|
+
|
|
199
|
+
- 不提供 agent 工具;待办数据只由面板读写(Harness 已自带 `personal_todo` 工具,避免重复暴露两套语义)。
|
|
200
|
+
- 没有多选与批量操作;一次拖拽只移动一条,删除也只针对单条。
|
|
201
|
+
- 淡彩底色用 CSS `color-mix()` 从主题 token 混出;很旧的 Chromium 不支持时自动回落到单色背景。
|
|
202
|
+
- 侧栏图标与面板的视觉细节无法在无浏览器控制的环境里截图验证;本次通过实时插槽注册、接口契约、存储测试与语法/资源检查验证。
|
|
203
|
+
- 改 `client.js` 由 HMR 自动拾取;改 `index.js` / `lib/store.js`(Host 半)需要重启该插件行或重启 Harness。
|