dsh-better-memo 0.0.0-stage → 0.2.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 ADDED
@@ -0,0 +1,21 @@
1
+ # Changelog
2
+
3
+ ## 0.2.0 — 2026-11-20
4
+
5
+ 改成浮窗卡片(用户口径:不要整页)。
6
+
7
+ - **入口**:顶栏胶囊(slot `shell.overlay`)。没有该 slot 的环境退回右下角固定圆钮。
8
+ - **浮窗卡片**:点胶囊弹出,一条一条列三档备忘录(彩色圆点区分 session / profile / user),**点一条 = 直接复制**(`标题\n正文`),浮出「已复制」1.2 秒;点外部 / ESC / 再点胶囊关闭,退出走 160ms 动画后卸载。
9
+ - **设置页**:卡片右上角齿轮 → 同一个浮层切成整页模式(`min(720px,92vw) × min(80vh)`),里面是完整的三组管理界面(新增表单、勾完成、行内改、两次确认删)+ 开关「在会话 tab 行显示「备忘录」入口」。
10
+ - **tab 座位默认不显示**(`settings.showTabEntry = false`),只有打开开关才注册 `conversation.view` 座位;开关即时生效,不需要重启。
11
+ - 后端新增 `GET /better-memo/settings?showTabEntry=1|0`(marker 头 `x-better-memo: 1`),`/state` 现在带 `settings` 字段。
12
+ - 修:从设置页返回卡片时列表不刷新(现在返回即重取 state);输入框/下拉在深色主题下底色与宿主不一致。
13
+
14
+ ## 0.1.0 — 2026-11-20
15
+
16
+ 首版。
17
+
18
+ - 三层备忘录:`session`(本会话)/ `profile`(本 profile 所有会话)/ `user`(仅用户可见)。
19
+ - 两个 agent 工具:`memo_list` 查收、`memo_edit` 增改删。`user` 档不进 `memo_list`,也不接受工具写入。
20
+ - 存储:`$DSH_HOME/memo/memos.json`,原子写;上限 500 条,标题 120 字、正文 4000 字。
21
+ - 面板进入 / 列表错峰 / 删除退出三处动效,`prefers-reduced-motion` 下退化。
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 MeruSu
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,47 @@
1
- # Temporary Holding Version
1
+ # 备忘录 · dsh-better-memo
2
2
 
3
- 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.
3
+ 给 DeepSeek Harness 加一层**三层备忘录**:顶栏一个小胶囊,点开是浮窗卡片,一条一条列出来,**点一条就复制**。同一个面板里管三档归属,其中两档 AI 能读能改,第三档只有你自己看得到。
4
+
5
+ | 作用域 | 谁收得到 | AI 能看 | AI 能写 |
6
+ |---|---|---|---|
7
+ | **本会话** `session` | 只有这一个会话 | ✅ | ✅ |
8
+ | **本 profile** `profile` | 这个 profile 的所有会话 | ✅ | ✅ |
9
+ | **仅我可见** `user` | 只有你自己 | ❌ 永远不返回 | ❌ 只有你能写 |
10
+
11
+ ## 安装
12
+
13
+ ```bash
14
+ dsh plugin --profile <你的 profile> add dsh-better-memo
15
+ ```
16
+
17
+ 装完**重启该 profile 的 GUI**(浏览器半段与 locale 元数据都是启动时读的)。
18
+
19
+ ## 用
20
+
21
+ 1. **顶栏胶囊**(窗口右上角,`备忘录`):点一下弹出浮窗卡片。
22
+ 2. **浮窗卡片**:一条一条,左边彩色圆点区分三档(蓝=本会话 / 绿=本 profile / 黄=仅我可见)。**点一条 = 复制到剪贴板**(格式 `标题\n正文`),右下角浮出「已复制」。点卡片外面、按 ESC、或再点胶囊都能关。
23
+ 3. **齿轮 → 设置页**:卡片右上角的齿轮点进去是整页模式,可以做全部管理(新增、勾完成、行内改、两次确认删),顶部有开关 **「在会话 tab 行显示「备忘录」入口」**,**默认关**。打开后会话 tab 行才出现「备忘录」座位,关掉立刻消失,不用重启。
24
+
25
+ ## 给 AI 的两个工具
26
+
27
+ - **`memo_list`** —— 返回本会话该查收的条目:本会话的 `session` + 本 profile 的 `profile`,已勾完成的会过滤掉。**`仅我可见` 的条目永远不会出现在这里。**
28
+ - **`memo_edit`** —— `op=add|update|delete`。`add` 必须给 `scope`(`session` 或 `profile`);`update`/`delete` 要 `id`。只能改自己看得到的条目,跨会话或 `user` 条目会被拒。
29
+
30
+ 会话开始时若用户提到「备忘录 / 备忘 / 记一下 / 待办」,会先调 `memo_list`(插件自带这段系统提示,一般不用再写)。
31
+
32
+ ## 数据放哪
33
+
34
+ `$DSH_HOME/memo/memos.json`(`DSH_HOME` 缺省 `~/.dsh`),一个 JSON 文件,原子写。删掉它等于清空全部备忘录。
35
+
36
+ 条目上限 500 条;标题 120 字、正文 4000 字(超出截断)。插件自己的开关(`showTabEntry`)也在这个文件的 `settings` 里。
37
+
38
+ ## 已知限制
39
+
40
+ - **复制依赖窗口焦点**:用的是 `navigator.clipboard.writeText`,失败时退回 `document.execCommand('copy')`;两个都失败会明确显示「复制失败」,不会假装成功。窗口失焦的后台环境两个都会失败(这是浏览器的规矩,不是插件 bug)。
41
+ - 顶栏胶囊固定在 `top:6px; right:150px`,没有按窗口控件实测对齐;如果没有 `shell.overlay` 槽(个别环境),入口会退化成右下角的固定圆钮。
42
+ - 单机单文件,没有多端同步;profile 档只在本 profile 内共享。
43
+ - 没有提醒/定时:这不是提醒插件,是备忘录。
44
+
45
+ ## License
46
+
47
+ MIT