dsh-conversation-recycle-bin 0.2.1 → 0.3.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/AUDIT-2026-10-17-desktop-web.md +333 -0
- package/CHANGELOG.md +66 -0
- package/INSTALL.md +2 -1
- package/README.md +101 -12
- package/client.js +502 -29
- package/config.schema.json +13 -1
- package/cordis.patch.yml +16 -0
- package/lib/core/cascade.js +53 -19
- package/lib/core/config.js +38 -1
- package/lib/core/errors.js +11 -2
- package/lib/core/file-lock.js +151 -0
- package/lib/core/memory/generic-json.js +2 -2
- package/lib/core/memory/json-index-adapter.js +182 -87
- package/lib/core/memory/lingshu.js +10 -4
- package/lib/core/memory/none.js +4 -2
- package/lib/core/memory/registry.js +9 -6
- package/lib/core/policy.js +4 -4
- package/lib/core/redact.js +66 -0
- package/lib/host/api.js +276 -58
- package/lib/host/catalog.js +101 -36
- package/lib/host/feedback.js +400 -0
- package/lib/host/gateway.js +19 -5
- package/lib/host/paths.js +13 -2
- package/lib/version.js +1 -1
- package/package.json +7 -5
- package/locale/en.json +0 -63
- package/locale/zh.json +0 -63
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
给 DeepSeek Harness (DSH) Web 增加「删除对话」:会话列表的「…」菜单与会话详情页头部各有一个删除入口;确认框内可勾选「同时删除关联记忆」(默认不勾选),并实时显示将被影响的记忆条数。删除默认进入插件回收站,可恢复;每次操作写入审计日志;批量删除有上限与限流,批量软删除需输入数量,彻底删除一键执行;事务任一步失败即回滚。
|
|
4
4
|
|
|
5
|
-
> 状态:`0.2.
|
|
5
|
+
> 状态:`0.2.2`,Host + Web Client 双半,零构建(plain JS ESM),只依赖宿主已发布的公开扩展点。
|
|
6
6
|
> 包名:`dsh-conversation-recycle-bin`(原 `dsh-delete-conversation` 因 npm 被他人占用而改名,见 CHANGELOG 0.2.0)。
|
|
7
7
|
> 本 README 同时是设计说明与验收依据;安装/回滚步骤见 [INSTALL.md](INSTALL.md);变更见 [CHANGELOG.md](CHANGELOG.md)。
|
|
8
8
|
|
|
@@ -23,6 +23,7 @@
|
|
|
23
23
|
| 对话框落点 | 菜单项随下拉菜单卸载;对话框必须挂在根级 overlay | `shell.overlay` 里的 `DialogHost`,菜单项只写模块级 dialog store |
|
|
24
24
|
| Client→Host | 生成式 `ctx.remote.*` 在构建期固定,纯 JS 插件无法新增命名空间;Client `ctx.connection` 没有 `fetch`;推荐 Host `ctx.webServer.register({kind:'prefix', path, handler})` + 同源 `fetch(document.baseURI)` | 自定义路由 `/conversation-recycle-bin/api/*` |
|
|
25
25
|
| 路由鉴权 | Web server 本身不鉴权;官方插件用 `ctx.connection.requestRejection(req)` 兜底。本插件另加:同源校验、loopback 默认、私有无头 header、JSON content-type、体积上限 | 见 `lib/host/api.js#requestOriginVerdict` |
|
|
26
|
+
| 桌面/网页传输差异 | 桌面端页面源是特权 scheme `dsh-app://app`(安装包 `out/lib/main.js` 注册),Renderer 对 Host 的请求经外壳 `forwardWebRequest` 转发:**删掉 `origin`/`sec-fetch-site`/`host` 头**并附上 Host 签发的 cookie;网页端是同源 fetch,三个头都在 | Client 一律用 `document.baseURI` 相对路径:桌面走 `dsh-app://app/...` 由外壳转发,网页走同源直连;Origin 完整性校验(主机名+端口)实际约束的是网页路径,桌路径由外壳自己的 `origin === "dsh-app://app"` 闸门 + cookie 保证 |
|
|
26
27
|
| Agent 工具 | 用户授权类操作应保持 user-only(skill `user-actions`) | **不注册任何 agent tool**,模型无法执行或授权删除 |
|
|
27
28
|
|
|
28
29
|
**操作者模型**:DSH 是本地单用户应用,没有账号/角色系统。因此本插件把「操作者权限」落实在传输层(同源页面、默认仅 loopback、私有请求头)与数据归属策略(工作区登记、允许根目录、受保护 id、子代理来源、live 状态)上,而不是虚构一套用户体系。
|
|
@@ -95,12 +96,13 @@ memory → messages → session/catalog
|
|
|
95
96
|
|
|
96
97
|
1. `POST /preview`:校验 session 存在、工作区归属、是否受保护/子代理/超出允许根;hard 模式下活跃会话不再拒绝,而是给出「会先停止该会话」的 warning(`stopLiveSessions:false` 时仍拒绝)。随后统计日志条数与记忆数,签发**单次使用**确认 token(绑定排序后的 sessionIds + includeMemory + mode,TTL 默认 120s)。
|
|
97
98
|
2. `POST /delete`:
|
|
98
|
-
-
|
|
99
|
+
- 传输层依次过三道闸:本路由自身的 loopback/Origin(比较完整 authority:主机名**和**有效端口,桌面 `dsh-app://app` 外壳源按 DSH 自己的口径豁免)/私有 header 校验 → DSH `connection.requestRejection`(401/403 短路)→ `ctx.waterfall('connection/request', ...)`(桌面更新任务借此在安装更新时返回 503 并排空在途请求,删除事务不会被杀在半路);
|
|
99
100
|
- token(彻底删除无需短语;批量软删除校验数量)、**有效批量上限** `min(maxBatchSessions, 本分钟剩余额度)`、限流(默认 20 次/分钟,滑动窗口)全部通过后才消费 token;
|
|
100
101
|
- 先对**全部**会话做策略预检,任一被拒绝则整批不执行(不会半成功);
|
|
101
102
|
- 逐会话执行 `quiesce(live) → memory → messages → session/catalog` 事务;
|
|
103
|
+
- 所有 mutation(delete/restore/purge/discard)串行经过进程内链 + `<dataDir>/mutation.lock` 跨进程文件锁:桌面端与 `dsh web` 共享一个 `DSH_HOME` 时,第二个实例的并发删除会拿到 `E_LOCK_BUSY` 而不是写坏同一份 manifest;
|
|
102
104
|
- 返回 `{ok: true, partial, results, failures}`:`ok` 表示计划已执行,`partial` 表示有会话失败;只有**全部**失败时才抛首个错误(HTTP 状态来自 `ERROR_STATUS`,错误码保留真实策略码)。
|
|
103
|
-
3. `GET /trash`(返回 `entries`(可恢复)与 `incomplete`(failed/pending/restoring/purging))、`POST /trash/restore`、`POST /trash/purge`(必须输入 `DELETE`)、`POST /trash/discard`(清理未完成条目,必须输入 `DELETE
|
|
105
|
+
3. `GET /trash`(返回 `entries`(可恢复)与 `incomplete`(failed/pending/restoring/purging))、`POST /trash/restore`、`POST /trash/purge`(必须输入 `DELETE`)、`POST /trash/discard`(清理未完成条目,必须输入 `DELETE`;仍保存会话日志的条目应走「恢复」而不是 discard)。未完成条目若还留着会话日志,设置页会给出「恢复」按钮,可以直接把它恢复回会话列表。
|
|
104
106
|
4. `GET /audit?limit=N`。
|
|
105
107
|
|
|
106
108
|
### 4.2 安全清单
|
|
@@ -109,7 +111,8 @@ memory → messages → session/catalog
|
|
|
109
111
|
|---|---|
|
|
110
112
|
| 误删 | 默认软删除;记忆复选框默认关;回收站;彻底删除一键但仍写回收站可恢复;批量软删除需输入数量 |
|
|
111
113
|
| 批量误操作 | `maxBatchSessions`(实际上限还会被本分钟剩余额度收紧,避免"合法批量必然 429");批量需输入数量;每个会话独立事务 |
|
|
112
|
-
| 暴力/脚本调用 |
|
|
114
|
+
| 暴力/脚本调用 | 同源校验(完整 authority:主机名+有效端口)+ `x-conversation-recycle-bin: 1` 私有 header + DSH `connection` 层(`requestRejection` + `connection/request` 瀑布流)+ 限流;默认仅接受 loopback 绑定,`allowNonLoopback=false` |
|
|
115
|
+
| 两个 Host 并发写同一回收站 | mutation 串行 + `<dataDir>/mutation.lock` 跨进程文件锁,抢不到锁返回 `E_LOCK_BUSY`(而非写坏 manifest) |
|
|
113
116
|
| 越权/越界 | 不在工作区登记的会话默认拒绝;可配置允许根目录白名单;受保护 id 列表;子代理会话默认拒绝 |
|
|
114
117
|
| 活跃会话被写坏 | hard 模式对 live 会话先走 `quiesce`:取消当前轮次 → `archiveSession({stopActivity:true})` → 在 `liveDrainMs` 内等待 `running=false`,之后才移动日志;仍停不下来则整笔回滚并报 `E_POLICY_LIVE`。`stopLiveSessions:false` 可恢复为直接拒绝 |
|
|
115
118
|
| 另一个 Host 正在写 | 移动前按 `foreignWriterGraceMs` 复检日志 mtime;仍在增长则报 `E_POLICY_FOREIGN_WRITER`。best-effort:两端同时运行时仍应先关闭另一端的会话 |
|
|
@@ -132,7 +135,7 @@ memory → messages → session/catalog
|
|
|
132
135
|
files/<nodeId>.content
|
|
133
136
|
```
|
|
134
137
|
|
|
135
|
-
`manifest.status` 只允许 `pending → trashed → restoring/restored / purging
|
|
138
|
+
`manifest.status` 只允许 `pending → trashed → restoring/restored / purging`。`GET /trash` 把**所有**条目都返回:`trashed` 进 `entries`(回收站 UI,可恢复/彻底删除),其余状态进 `incomplete`(设置页单独列出,提供「恢复」与「discard」两个出口,不再出现"失败了却没有任何清理入口"的死条目)。恢复顺序是删除的逆序:日志 → catalog → 记忆。
|
|
136
139
|
|
|
137
140
|
---
|
|
138
141
|
|
|
@@ -141,7 +144,8 @@ memory → messages → session/catalog
|
|
|
141
144
|
### 5.1 灵枢(默认,已实机核对格式)
|
|
142
145
|
|
|
143
146
|
- 计数:读 `_index.json`,按 `nodes[*].session === sessionId` 过滤;`protected === true` 或 `immutable === true` 的节点只计数、不删除。
|
|
144
|
-
-
|
|
147
|
+
- 删除:持插件私有锁 `_index.json.conversation-recycle-bin.lock`(**不碰** md_cg 的 `_index.json.lock`——那是 md_cg 的永久 0 字节 OS 字节锁文件,存在与否不代表加锁,删它反而会破坏 md_cg 自己的互斥;本锁只协调本插件的多个 Host 进程),把节点正文移到回收站 bundle,从索引删除节点,并剥离其他节点指向被删节点的 `edges/depends_on/derived_from` 引用;先写 bundle 再改索引,失败时还原。**没有任何可删节点的会话会先读索引直接返回空 bundle,不取锁**,因此记忆库繁忙不会拖住一次本来无记忆可删的彻底删除。
|
|
148
|
+
- 分片日志:md_cg 的索引是「快照 `_index.json` + `_index_log/` 追加分片,装载时重放」。删除/恢复除改写快照外,还会写入一个**新分片**(`e: null` 墓碑 / 恢复后的节点记录),`_t` 取「现在」与「最新分片时间 + 1ms」的较大值,保证重放时我们的记录排在最后,已删节点不会因重放复活、已恢复节点不会被旧墓碑覆盖。
|
|
145
149
|
- 恢复:按 bundle 把正文放回、节点条目与引用补回;若目标 id 已存在则拒绝并报 `E_TRASH_CONFLICT`。
|
|
146
150
|
- **边界**:这是「离线索引适配器」,不经过灵枢的 `forget` 工具,因此不会写它的 `_deletions.jsonl` 墓碑、`trash/` 与 review queue;`_recent.jsonl` 滚动窗口里的旧文本会自然过期。对格式做的是 schema 2 的受支持子集。若要求走灵枢自己的软删/审计语义,请使用 `lingshu_cg op=forget`(可能进入 review queue,需校验 receipt),本插件不冒充该协议。
|
|
147
151
|
|
|
@@ -164,8 +168,8 @@ dsh-conversation-recycle-bin/
|
|
|
164
168
|
├─ package.json # bundle + dsh.client 声明
|
|
165
169
|
├─ cordis.patch.yml # Host 行与默认配置
|
|
166
170
|
├─ config.schema.json # 配置/权限的机器可读声明
|
|
167
|
-
├─ client.js # Web Client:4 个槽位 + 确认框 +
|
|
168
|
-
├─ icon.svg
|
|
171
|
+
├─ client.js # Web Client:4 个槽位 + 确认框 + 设置页(内联中英文案)
|
|
172
|
+
├─ icon.svg
|
|
169
173
|
├─ lib/
|
|
170
174
|
│ ├─ index.js # apply(ctx, config):注册路由
|
|
171
175
|
│ ├─ core/ # 纯逻辑(无 DSH 依赖,可单测)
|
|
@@ -184,8 +188,9 @@ dsh-conversation-recycle-bin/
|
|
|
184
188
|
│ ├─ catalog.js # archive/detach/pin 与日志移动
|
|
185
189
|
│ ├─ lifecycle.js # live 会话停机:cancel + archive + drain
|
|
186
190
|
│ ├─ memory.js # 适配器装配
|
|
191
|
+
│ ├─ feedback.js # 反馈校验/渲染/投递(http 或 smtp,凭证只读环境变量)
|
|
187
192
|
│ └─ api.js # 同源 HTTP API、确认 token、限流
|
|
188
|
-
└─ test/ #
|
|
193
|
+
└─ test/ # 121 个用例,覆盖用户要求的 5 类场景 + live 删除 + 记忆锁 + 原地刷新 + 部分失败/跨进程/未完成条目 + 反馈通道 + Client 半渲染冒烟
|
|
189
194
|
```
|
|
190
195
|
|
|
191
196
|
---
|
|
@@ -194,7 +199,7 @@ dsh-conversation-recycle-bin/
|
|
|
194
199
|
|
|
195
200
|
```powershell
|
|
196
201
|
cd D:\Users\34332\AI\dsh-conversation-recycle-bin
|
|
197
|
-
npm test # = manifest && client-module && core && cascade && memory && trash-audit && api(
|
|
202
|
+
npm test # = manifest && client-module && core && cascade && memory && trash-audit && feedback && api(121 个用例)
|
|
198
203
|
npm run check # 语法 + manifest
|
|
199
204
|
```
|
|
200
205
|
|
|
@@ -220,5 +225,89 @@ npm run check # 语法 + manifest
|
|
|
220
225
|
3. 灵枢适配器不写其删除台账(§5.1);跨节点引用只处理 `edges/depends_on/derived_from` 三个已知字段。
|
|
221
226
|
4. 投影缓存清理是 best-effort;旧日志/附件按宿主语义保留。
|
|
222
227
|
5. UI 依赖当前版本的 slot 约定;宿主升级若改 slot props,入口会失效但不会破坏宿主。0.1.4 的原地刷新还会调用 `uiWorkspace.clearArchivedCurrent/clearMain`(宿主 `.d.ts` 中标为 private);两者都不存在时会退回整页刷新,不会留下过期视图,但属于对私有方法的依赖,宿主升级需复核。
|
|
223
|
-
6.
|
|
224
|
-
7.
|
|
228
|
+
6. 回收站 manifest 的并发写由 `<dataDir>/mutation.lock` 跨进程锁保护(抢不到锁返回 `E_LOCK_BUSY`);但**会话日志内容**的跨进程写保护仍是 best-effort:`foreignWriterGraceMs` 只能发现"窗口内仍在增长"的日志,另一个 Host 的空闲 live 会话(两次写入之间)无法被本进程识别。桌面端与 `dsh web` 同时运行时,仍应先关闭另一端的会话再彻底删除。
|
|
229
|
+
7. 未完成条目(failed/pending/restoring/purging)若仍持有已移动的会话日志或记忆文件,出于数据安全不允许 `discard`(会报 `E_TRASH_CONFLICT`);设置页对这类条目提供「恢复」按钮,可直接恢复回会话列表,不再出现"失败了却没有出口"的死条目。日志与记忆都已不在磁盘上的条目才可以 discard。
|
|
230
|
+
|
|
231
|
+
---
|
|
232
|
+
|
|
233
|
+
## 9. 反馈通道(设置页「反馈」按钮)
|
|
234
|
+
|
|
235
|
+
设置页**最上方**新增一条「反馈」横幅(主色按钮,位于标题之上):把问题或建议写成一条消息,由**宿主进程**通过邮件发到维护者邮箱。凭证只在宿主侧读取,页面拿不到、也发不出任何邮件。
|
|
236
|
+
|
|
237
|
+
### 9.1 为什么是「页面 → 宿主路由 → 邮件」三段
|
|
238
|
+
|
|
239
|
+
浏览器既不能开 SMTP 连接,也不该持有邮件服务凭证。因此 `client.js` 只负责表单与校验提示,`POST /conversation-recycle-bin/api/feedback` 由 `lib/host/feedback.js` 校验、渲染并投递。表单里的「类型 / 标题 / 正文 / 联系方式」之外,只额外附带**对话框里已展示给用户**的上下文(插件版本、平台、语言);对话内容、会话 id、工作区路径都不会进入邮件。
|
|
240
|
+
|
|
241
|
+
### 9.2 配置项(`feedback` 段,非机密)
|
|
242
|
+
|
|
243
|
+
| 键 | 默认 | 说明 |
|
|
244
|
+
|---|---|---|
|
|
245
|
+
| `feedback.enabled` | `true` | 是否允许该通道。通道本身没配好时按钮依旧不显示 |
|
|
246
|
+
| `feedback.to` | `b64:…`(维护者收件箱) | 收件人。默认值以 `b64:<base64>` 形式携带,公开 tarball 里没有可直接抓取的 `name@domain` 串(这是**混淆,不是加密**:解码器就在 `lib/host/feedback.js`,拿到包的人总能解出来)。也接受明文地址;`DSH_CRB_FEEDBACK_TO` 优先于它 |
|
|
247
|
+
| `feedback.from` | `''` | 发件人。留空时 SMTP 通道复用连接串里的用户名(服务商通常要求 From 与登录账号一致);`DSH_CRB_FEEDBACK_FROM` 优先于它 |
|
|
248
|
+
| `feedback.transport` | `auto` | `auto` = 有 `DSH_CRB_MAIL_API_URL` 走 http,否则有 `DSH_CRB_SMTP_URL` 走 smtp;`http`/`smtp` 强制单通道(配不全就报未配置,不会静默换道);`off` 关闭 |
|
|
249
|
+
| `feedback.rateLimitPerHour` | `5` | 每宿主每小时发送上限(1–100)。邮件从操作者自己的账号发出,默认值刻意压低 |
|
|
250
|
+
|
|
251
|
+
### 9.3 环境变量(优先级高于配置项;凭证只走这里,不进配置文件)
|
|
252
|
+
|
|
253
|
+
> 冲突时**环境变量赢**:`DSH_CRB_FEEDBACK_TO` 覆盖 `feedback.to`,`DSH_CRB_FEEDBACK_FROM` 覆盖 `feedback.from`。这样多台机器/多人共用一个 package 时,各自改环境变量即可,不必改配置。
|
|
254
|
+
|
|
255
|
+
| 变量 | 用途 |
|
|
256
|
+
|---|---|
|
|
257
|
+
| `DSH_CRB_FEEDBACK_TO` | 收件人(优先于 `feedback.to`) |
|
|
258
|
+
| `DSH_CRB_FEEDBACK_FROM` | 发件人(优先于 `feedback.from`) |
|
|
259
|
+
| `DSH_CRB_MAIL_API_URL` | 邮件 HTTP API 地址(Resend 兼容形状,也可指向自建转发网关) |
|
|
260
|
+
| `DSH_CRB_MAIL_API_TOKEN` | 该 API 的 Bearer token |
|
|
261
|
+
| `DSH_CRB_MAIL_API_AUTH_HEADER` | 可选,鉴权头名,默认 `authorization`,值为 `Bearer <token>` |
|
|
262
|
+
| `DSH_CRB_SMTP_URL` | SMTP 连接串,如 `smtps://user:pass@smtp.example.com:465` |
|
|
263
|
+
|
|
264
|
+
HTTP 通道发出的 JSON 固定为 `{from, to: [收件人], subject, text, reply_to}`,`text` 是纯文本(不生成 HTML);`reply_to` 只在联系方式看起来可用时填写。SMTP 通道按需 `import('nodemailer')`:它已声明为 `optionalDependencies`(`^10.1.2`),正常安装会随包就位;以 `link:` 方式开发安装时插件从自身真实目录解析,需在**本仓库**跑一次 `npm install`。仍未安装时返回 `E_FEEDBACK_TRANSPORT` + `reason: nodemailer-missing`。
|
|
265
|
+
|
|
266
|
+
#### 9.3.1 QQ 邮箱开通示例
|
|
267
|
+
|
|
268
|
+
QQ 邮箱不能直接用登录密码发信,要先取**授权码**(设置 → 账号 → POP3/SMTP 服务 → 开启 → 生成授权码),再把两件事写进环境变量(`@` 在连接串里必须写成 `%40`;`<你的QQ号>` 换成实际号码):
|
|
269
|
+
|
|
270
|
+
```powershell
|
|
271
|
+
setx DSH_CRB_SMTP_URL 'smtps://<你的QQ号>%40qq.com:你的授权码@smtp.qq.com:465'
|
|
272
|
+
# 可选:换收件人/发件人(不设就用包内默认的维护者收件箱)
|
|
273
|
+
setx DSH_CRB_FEEDBACK_TO 'your-feedback@example.com'
|
|
274
|
+
# 设置后重启 DSH 桌面端(setx 只对新进程生效)
|
|
275
|
+
```
|
|
276
|
+
|
|
277
|
+
需要自己生成一个 `b64:` 地址(放进 profile patch 而不是环境变量时):
|
|
278
|
+
|
|
279
|
+
```powershell
|
|
280
|
+
node -e "console.log('b64:' + Buffer.from('your-feedback@example.com','utf8').toString('base64'))"
|
|
281
|
+
```
|
|
282
|
+
|
|
283
|
+
|
|
284
|
+
### 9.4 本地验证
|
|
285
|
+
|
|
286
|
+
```powershell
|
|
287
|
+
cd D:\Users\34332\AI\dsh-conversation-recycle-bin
|
|
288
|
+
npm run check # 语法 + manifest(含 feedback.js)
|
|
289
|
+
node test/feedback.test.mjs # 15 个反馈用例
|
|
290
|
+
npm test # 全量 121 个用例
|
|
291
|
+
|
|
292
|
+
# 端到端:用本机收件桩观察真实投递路径,不外发邮件
|
|
293
|
+
$env:DSH_CRB_MAIL_API_URL = 'http://127.0.0.1:9099/emails'
|
|
294
|
+
$env:DSH_CRB_MAIL_API_TOKEN = 'dev-token'
|
|
295
|
+
$env:DSH_CRB_FEEDBACK_TO = 'feedback@example.test'
|
|
296
|
+
# 另一个终端起桩:
|
|
297
|
+
# node -e "require('http').createServer((q,s)=>{let b='';q.on('data',c=>b+=c);q.on('end',()=>{console.log(q.method,q.url,b);s.end('{}')})}).listen(9099)"
|
|
298
|
+
```
|
|
299
|
+
|
|
300
|
+
起桩后打开设置页点「反馈」,填表发送:桩终端应打印 `POST /emails {...}`,页面出现「反馈已发送,谢谢!」。测 SMTP 通路时改设 `DSH_CRB_SMTP_URL`(本仓库已按 `optionalDependencies` 声明 `nodemailer`,先在本仓库 `npm install` 一次;未安装时返回 `E_FEEDBACK_TRANSPORT` + `reason: nodemailer-missing`,这是预期行为)。
|
|
301
|
+
|
|
302
|
+
### 9.5 失败排查
|
|
303
|
+
|
|
304
|
+
| 现象 | 原因 | 处理 |
|
|
305
|
+
|---|---|---|
|
|
306
|
+
| 设置页没有「反馈」按钮 | 通道未配置(`/state.feedback.enabled === false`) | 设好 `DSH_CRB_MAIL_API_URL` + token,或 `DSH_CRB_SMTP_URL`;确认 `feedback.transport` 不是 `off`、`enabled` 不是 `false` |
|
|
307
|
+
| 点击后 503 `E_FEEDBACK_DISABLED` | 同上一行(按钮来自旧页面渲染) | 刷新页面;看 `/state.feedback.reason`:`not-configured` / `disabled` / `off` |
|
|
308
|
+
| 400 `E_FEEDBACK_INVALID` | 标题 4–120 字、正文 10–4000 字、联系方式 ≤200 字不满足 | `details.field` 指明字段,`details.min`/`details.max` 给出边界 |
|
|
309
|
+
| 429 `E_FEEDBACK_RATE_LIMITED` | 超过 `feedback.rateLimitPerHour` | 等 `details.retryAfterMs` 后重试,或调高上限 |
|
|
310
|
+
| 502 `E_FEEDBACK_TRANSPORT` | 邮件服务返回非 2xx / 网络失败 / 未装 nodemailer / 暴露不出 `createTransport` | 看宿主日志 `[conversation-recycle-bin] feedback delivery failed (<transport>): <code> <message>`(只含错误码与通道,不含正文);核对 URL、token、SMTP 授权码 |
|
|
311
|
+
| 接口 200 但收件箱没有 | 服务端已受理,但被对方退信或进了垃圾箱 | 查发件账号退信;`feedback.from` 用与 SMTP 账号一致的地址,并检查收件人域名 |
|
|
312
|
+
|
|
313
|
+
> 隐私边界:邮件正文 = 用户输入 + 对话框里已展示的上下文;宿主日志只记错误码、通道与耗时。删除开关(`enabled`)与反馈通道互相独立——关掉删除不影响反馈,反之亦然。
|