📝 docs: 说明仓库结构与维护者命令，记录 v1.0.7
This commit is contained in:
@@ -2,6 +2,19 @@
|
||||
|
||||
版本说明按倒序排列。提交信息遵循 [CONTRIBUTING.md](CONTRIBUTING.md) 的单行规范，因此每次改动"为什么这样改、影响面是什么"记在这里，而不是提交信息里。
|
||||
|
||||
## v1.0.7
|
||||
|
||||
- 重构：**客户端源码拆成模块，`client.js` 从「手写文件」变成「构建产物」**。原来的 `client.js` 是 1452 行单文件，通知引擎、轻弹窗、插件页、观察器、字典、样式、图标全塞在一个 `apply` 里，改任何一处都要在同一个文件里上下翻。现在：
|
||||
- `src/client/core/` 是行为：`observe`（一轮派生）、`delivery`（通道决策、节流、400ms 确认窗口）、`system-channel`（系统通知与平台回执）、`replay`（回前台补发）、`toasts`（弹窗栈与计时）、`actions`（两个测试按钮、权限请求、开关）、以及 `copy` / `session` / `storage` / `store` / `log`；
|
||||
- `src/client/ui/` 是界面：`ToastLayer`、`KindRow`、`ConfigSection`、`NotifyObserver`、`icons`、`styles`、`hooks`；
|
||||
- `src/client/i18n/` 是字典与翻译器，`src/client/platform.js` 是浏览器与平台事实，`src/client/plugin.js` 是组合根（建 store、装配模块、注册三个 slot），`src/client/index.js` 是构建入口。
|
||||
- **`client.js` 仍然是包根那一个文件，安装路径与发布清单都没变**：`exports`、`files`、`main`、`icon`、`dsh` 与 `cordis.patch.yml`、`locale/` 全部原样，使用者依旧零依赖、零构建。
|
||||
- 新增 `scripts/build-client.mjs`（esbuild）：把 `src/client/**` 打包成一个自包含单文件，并校验它仍然满足注册契约（只有一个 factory、`require('react')` 落在 factory 内、没有顶层 `import`/`export`、除了 `react` 不再向模块表要别的模块）。这一步无法省略：客户端模块系统只交给插件一个自包含 bundle，factory 里的 `require` 不能 require 同一个包里的相对文件。
|
||||
- 新增 `tests/`（`pnpm test`，用 `node --test`，无第三方依赖）：26 个纯函数单测（文案、会话派生、存储、字典与翻译器）、4 个产物测试（注册 id、factory 返回值、`apply` 在没有 DOM 的 Node 里也能跑通、**产物与 `src/**` 是否一致**）、6 个渲染测试（用一份最小 React 替身渲染插件页与轻弹窗，验证重构后的 props 装配：开关的选中态、诊断行、按钮回调、观察器的健康上报）。以后改完源码忘了重新构建，测试会直接失败。
|
||||
- 维护者现在需要跑一次 `pnpm install`（唯一 devDependency 是 esbuild）；**使用者不需要**。README 的安装说明按这个区分改写了，并新增「仓库结构」一节。
|
||||
- 行为未改：三类提醒的判定、通道选择、节流与确认窗口、补发与去重、开关的存储键、CSS 全文与 `dsn-*` 类名、全部字典键与文案都逐字保持（构建产物与 v1.0.6 的字符串逐条比对通过，样式表 4615 字节完全一致）。
|
||||
- 顺带记录一个**本次没有修的既有缺陷**：`body.planReview`（「计划正在等待你确认」）在 v1.0.6 里已是死代码——`copyFor` 先判断 `kind === 'question'`，而计划确认正是以 `kind: 'question'` 入队的，所以计划提醒实际显示的是提问那段文案。修它要调整判断顺序、属于行为变更，因此这次只把现状写进 `src/client/core/copy.js` 的注释，并在 `tests/unit/copy.test.js` 里钉住当前输出。
|
||||
|
||||
## v1.0.6
|
||||
|
||||
- 修复：**窗口不在前台时，提醒有可能一次都看不到**。排查证据：一次真实投递（会话 17:52:29 结束）在插件页留下 `09:52:30 · 系统通知`——`09:52:30` 是 UTC，本机时间是 17:52:30；而 Windows 的通知平台记录 `LastNotificationAddedTime` 停在 70 分钟前。也就是说 `new Notification()` 没抛错，但**构造函数成功不等于通知真的弹出来了**，加上系统通知的气泡只存在几秒，人不在电脑前时它等于没送达。这一版不再把"发出去"当成"收到了"：
|
||||
|
||||
Reference in New Issue
Block a user