dsh-agent-soul 0.9.6 → 0.9.8

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.
Files changed (42) hide show
  1. package/CHANGELOG.md +40 -0
  2. package/LICENSE +16 -0
  3. package/LICENSES/MIT-THIRD-PARTY.txt +42 -0
  4. package/LICENSES/Yuuyuko-uu-PLUGIN-1.2.txt +50 -0
  5. package/README.md +18 -1
  6. package/THIRD-PARTY-NOTICES.md +246 -0
  7. package/assets/README.md +22 -0
  8. package/docs/KNOWN-ISSUES.md +116 -0
  9. package/lib/client/diary-tab.js +13 -7
  10. package/lib/client/memory-tab.js +9 -4
  11. package/lib/client/mood-tab.js +21 -7
  12. package/lib/client/notes-tab.js +7 -4
  13. package/lib/client/persona-tab.js +8 -16
  14. package/lib/client/purpose-tab.js +2 -5
  15. package/lib/client/settings-tab.js +5 -1
  16. package/lib/client/styles.js +2 -0
  17. package/lib/client.js +67 -44
  18. package/lib/core/diary-pick.js +22 -3
  19. package/lib/core/session-groups.js +87 -0
  20. package/lib/diary/compose.js +24 -7
  21. package/lib/diary/feed.js +481 -435
  22. package/lib/env.js +29 -3
  23. package/lib/extract.js +21 -2
  24. package/lib/http/middleware.js +282 -265
  25. package/lib/http/routes/diary.js +190 -145
  26. package/lib/http/routes/memory.js +4 -4
  27. package/lib/http/server.js +6 -0
  28. package/lib/index.js +42 -41
  29. package/lib/memory/card-io.js +75 -12
  30. package/lib/memory/card.js +15 -2
  31. package/lib/memory/render.js +5 -0
  32. package/lib/mood/core.js +2 -0
  33. package/lib/mood/digest.js +185 -181
  34. package/lib/mood/prompt.js +4 -0
  35. package/lib/mood/session.js +4 -0
  36. package/lib/mood.js +7 -0
  37. package/lib/purpose.js +6 -0
  38. package/lib/session-title.js +18 -1
  39. package/lib/state/mood-state.js +203 -198
  40. package/lib/store.js +6 -0
  41. package/package.json +14 -4
  42. package/tools/sync.mjs +3 -2
package/CHANGELOG.md CHANGED
@@ -7,6 +7,46 @@
7
7
 
8
8
  ---
9
9
 
10
+ ## 0.9.8 · 2026-11-08
11
+
12
+ 本版是 **R13(外部复检轮)的合并 + 一处复核修复**。R13 有 5 个提交、26 文件、+628/−157,
13
+ 来自基于 v0.9.7 的独立分支,本会话逐项复核后合并(说明见 `docs/KNOWN-ISSUES.md` 顶部)。
14
+
15
+ ### 修复
16
+
17
+ - **日记列表预览把汉字切成半个**(R13 #1 的复核补丁):`/diary/list` 改成只读头部 400 字节后,
18
+ `400 % 3 ≠ 0` 让边界必然落在某个汉字中间,预览末尾出现 `�`(U+FFFD)。
19
+ 现在多读 3 字节再丢掉残缺尾字。附带补了带 REDGREEN 的断言 ——
20
+ 第一版测试因为前缀字节数恰好让边界落在字与字之间,**修没修都是绿的**,poison 复核时才发现。
21
+
22
+ ### R13 合并进来的修复(23 条)
23
+
24
+ - **一致性**:#8 `maxRecords` 口径统一、#12 控制字符补 C1/U+2028-2029、#13 合并补 `decayed`、
25
+ #14 `id` 哈希掺 scope、#16 `diaryWindowOf` 空窗、#18 布尔优先级、#19 digest 跳过模板块。
26
+ - **日志与请求层**:#9 `sanitizeLogText`、#10 `readBody` 413、#11 TOCTOU、#17 轮转撞名序号。
27
+ - **性能**:#1 只读头部、#3 备份免全量解析、#4 归档尾块读、#5 迁移退避、#6 mood key 全局化、#7 meta 缓存。
28
+ - **前端与架构**:#22 config 只发改动键、#24 后台暂停轮询、#25 预览受控渲染、
29
+ #29 注释补 data-policy、#30 游标按 agent 分键、#31 缓存上限。
30
+
31
+ ### 变更
32
+
33
+ - `env.js` 新增 `sanitizeLogText` 导出;`tools/lint.mjs` 仍零问题。
34
+ - 与 `d243fd7`(第三方许可声明)合并后,`lib/client.js` 里的原作者署名注释完整保留。
35
+ - **合并同期另一条改动**:日记对话流水改为按「工作区 → 会话 → 时间」分组(新增 `lib/core/session-groups.js`),
36
+ 同时开着的几个对话不再交错。这是一次**有意的输出变更**,`behavior-golden` 基线已按正规通道刷新
37
+ (理由记为:分组 + R13 的 compose/feed 修复叠加)。
38
+
39
+ ---
40
+
41
+ ## 0.9.7 · 2026-11-07
42
+
43
+ ### 文档
44
+
45
+ - 新增 [`docs/KNOWN-ISSUES.md`](docs/KNOWN-ISSUES.md):把**尚未修**的条目集中列出来(性能 7 条、一致性 14 条、前端 4 条、可维护性 10 条、明确不修 3 类、待确认 2 条),每条带代码位置、影响、建议改法与「验证程度」(A 实测 / B 读代码 / C 仅按报告归档)。
46
+ - 这一版**不改任何代码**,只是把「还剩什么」写清楚,避免下一轮凭记忆修。
47
+
48
+ ---
49
+
10
50
  ## 0.9.6 · 2026-11-07
11
51
 
12
52
  ### 工程化
package/LICENSE CHANGED
@@ -1,3 +1,19 @@
1
+ 许可结构说明(本段是说明,不是许可条款)
2
+ ========================================
3
+
4
+ 本项目是派生作品,包含来自 Yuuyuko-uu/dsh-feiyu-mood 与
5
+ Yuuyuko-uu/dsh-fish-memory 的派生部分(两者共用同一份 1.2 许可原文)。
6
+ 按《Yuuyuko-uu 插件许可 1.2》第 6 条「公开的衍生作品必须继续使用本许可
7
+ (或更严格的许可),不得改用更宽松的许可」,本项目作为公开衍生作品
8
+ 整体以该许可 1.2 为准;完整原文见 LICENSES/Yuuyuko-uu-PLUGIN-1.2.txt。
9
+
10
+ 下方 MIT License 仅适用于本项目可与上述派生部分分离的自有代码,
11
+ 不构成对本项目整体的 MIT 授权。SurfCore 的版权行与 MIT 许可全文见
12
+ LICENSES/MIT-THIRD-PARTY.txt;逐项来源、改动清单与署名位置见
13
+ THIRD-PARTY-NOTICES.md。
14
+
15
+ ========================================
16
+
1
17
  MIT License
2
18
 
3
19
  Copyright (c) 2026 danshuyue
@@ -0,0 +1,42 @@
1
+ 第三方 MIT 组件的版权声明与许可全文
2
+ ========================================
3
+
4
+ 本文件保存 dsh-agent-soul 所借鉴的 MIT 组件的原始版权声明与完整 MIT 许可文本。
5
+ 原文来源为该仓库 GitHub 默认分支的 LICENSE 文件,2026-11-07 核对。
6
+
7
+ 本项目的整体许可结构见根目录 THIRD-PARTY-NOTICES.md;
8
+ 本项目自身可分离代码的 MIT 声明见根目录 LICENSE;
9
+ 两个 Yuuyuko-uu 原仓库的许可原文见 LICENSES/Yuuyuko-uu-PLUGIN-1.2.txt。
10
+
11
+ ------------------------------------------------------------------------
12
+ [1] SurfCore
13
+ 仓库:https://github.com/Mieksido/surfcore
14
+ 版权人:Derpyu520 and qq-bridge / QSH contributors
15
+ LICENSE 原文首行:Copyright (c) 2026 Derpyu520 and qq-bridge / QSH contributors
16
+ ------------------------------------------------------------------------
17
+
18
+ MIT License
19
+
20
+ Copyright (c) 2026 Derpyu520 and qq-bridge / QSH contributors
21
+
22
+ Permission is hereby granted, free of charge, to any person obtaining a copy
23
+ of this software and associated documentation files (the "Software"), to deal
24
+ in the Software without restriction, including without limitation the rights
25
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
26
+ copies of the Software, and to permit persons to whom the Software is
27
+ furnished to do so, subject to the following conditions:
28
+
29
+ The above copyright notice and this permission notice shall be included in all
30
+ copies or substantial portions of the Software.
31
+
32
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
33
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
34
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
35
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
36
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
37
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
38
+ SOFTWARE.
39
+
40
+ 注:该仓库 LICENSE 尾部另附「第三方组件与合规边界」长文(涉及 SnowLuma 等),
41
+ 文内自述「不是许可证的一部分,但请一并阅读」。本项目的目的机制取自该仓库
42
+ 自有代码,不涉及那些第三方组件,故此处只保留 MIT 许可本体。
@@ -0,0 +1,50 @@
1
+ Yuuyuko-uu 插件许可 1.2
2
+
3
+ 版权所有 (c) 2026 Yuuyuko-uu
4
+
5
+ ──────────────────────────────────────────────────────────────
6
+
7
+ 【为什么不用 MIT】
8
+
9
+ 2026 年 10 月,有人把我这几个插件(代码、README,还有我做的图)
10
+ 改名、去掉署名,在视频里说成「自研」发布。
11
+
12
+ 他没有违反 MIT —— MIT 只要求保留版权声明,不管「这是谁做的」。
13
+
14
+ 所以换成了这份许可。它只多要求一件事:
15
+ 你拿走的时候,说一声这是谁做的。
16
+
17
+ 安装、修改、商用,全都允许 —— 和 MIT 一样宽。
18
+
19
+ ──────────────────────────────────────────────────────────────
20
+
21
+ 一、允许,不需要另外问我
22
+
23
+ 1. 安装到自己的机器上使用,长期用,商用也行。
24
+ 2. 读源码、改源码、改成自己需要的版本(改给自己用,不必公开)。
25
+ 3. 把你的改动发给我(issue / PR);我采纳后,按仓库惯例记你的贡献。
26
+ 4. 在文章、视频、教程里介绍、演示、截图、引用本项目 —— 请附上原仓库地址。
27
+
28
+ 二、允许,但必须做到
29
+
30
+ 5. 再分发时(把代码或其实质性部分放进你自己的仓库、整合包、安装包,
31
+ 或者换一个包名发布),必须同时做到:
32
+ a) 完整保留本文件,不删、不改、不缩略;
33
+ b) 在 README 的第一屏写明:本项目派生自 <原仓库地址>,原作者 Yuuyuko-uu;
34
+ c) 说明你改了哪些部分。
35
+ 6. 公开的衍生作品必须继续使用本许可(或更严格的许可),不得改用更宽松的许可。
36
+
37
+ 三、禁止
38
+
39
+ 7. 不得把本项目的全部或实质性部分声称为你自己原创 ——
40
+ 包括在 README、发布说明、视频、插件市场条目里,
41
+ 把它写成「自研」「原创」「我写的」。
42
+ 8. 不得删除、替换、隐藏本项目的作者署名,
43
+ 包括 LICENSE、NOTICE、README、package.json 和源码注释里的。
44
+
45
+ 四、其他
46
+
47
+ 9. 本项目按「现状」提供,不附带任何明示或默示的担保。
48
+ 10. 违反第二、三条中任何一条,本许可立即终止;你还应当删除已发布的衍生作品。
49
+ 从违约那一刻起,你就不再拥有使用、复制、分发本项目的任何授权。
50
+ 11. 上面没写的情况想用,直接来问我,一般都会答应。
package/README.md CHANGED
@@ -1,5 +1,7 @@
1
1
  # dsh-agent-soul
2
2
 
3
+ > **版权与来源|本项目是派生作品,不是原创。** 心情引擎、五张表情图与部分设置页布局派生自 [Yuuyuko-uu/dsh-feiyu-mood](https://github.com/Yuuyuko-uu/dsh-feiyu-mood);记忆机制(会淡忘的长期记忆、召回去重、注入预算)设计借鉴自 [Yuuyuko-uu/dsh-fish-memory](https://github.com/Yuuyuko-uu/dsh-fish-memory) —— 两者原作者同为 **Yuuyuko-uu**,均适用《Yuuyuko-uu 插件许可 1.2》;目的机制借鉴 [Mieksido/surfcore](https://github.com/Mieksido/surfcore)(MIT,© 2026 Derpyu520 and qq-bridge / QSH contributors)。**完整许可原文、逐项来源与改动清单见 [THIRD-PARTY-NOTICES.md](./THIRD-PARTY-NOTICES.md) 与 [LICENSES/](./LICENSES/)。**
4
+
3
5
  > 给 DSH 的 agent 一份**会忘事的记忆**、一套**会变的人格**、一份**会起伏的心情**,和一个**她自己写的笔记本**。
4
6
 
5
7
  它做六件事:
@@ -793,4 +795,19 @@ app.js 外壳
793
795
 
794
796
  ## 许可
795
797
 
796
- MIT
798
+ **本项目是派生作品,整体按《Yuuyuko-uu 插件许可 1.2》履约**(该许可第 6 条:
799
+ 公开衍生作品不得改用更宽松的许可)。`dsh-feiyu-mood` 与 `dsh-fish-memory` 两个
800
+ 原仓库的 LICENSE 是同一份逐字全文,共用
801
+ [`LICENSES/Yuuyuko-uu-PLUGIN-1.2.txt`](./LICENSES/Yuuyuko-uu-PLUGIN-1.2.txt)。
802
+
803
+ - 根 [`LICENSE`](./LICENSE) 里的 MIT 文本**只覆盖可与派生部分分离的自有代码**,
804
+ 不得据此把本项目整体当作 MIT 项目再分发;`package.json` 的 `license` 字段
805
+ 写的是 `SEE LICENSE IN LICENSE`,指向这份结构说明。
806
+ - 目的机制借鉴的 SurfCore 仍由其版权人按 MIT 授权,版权行与完整许可文本见
807
+ [`LICENSES/MIT-THIRD-PARTY.txt`](./LICENSES/MIT-THIRD-PARTY.txt)。本声明不削弱
808
+ 你从原作者处直接取得的任何权利。
809
+ - 逐项来源、改了哪些部分、署名保留位置、以及不属于第三方版权来源的引用边界,
810
+ 全部列在 [`THIRD-PARTY-NOTICES.md`](./THIRD-PARTY-NOTICES.md)。
811
+
812
+ 《Yuuyuko-uu 插件许可 1.2》允许安装、修改、商用;再分发时要求完整保留许可原文、
813
+ 在 README 第一屏注明原仓库与原作者、说明改动、不得声称原创、不得隐藏署名。
@@ -0,0 +1,246 @@
1
+ # 第三方许可与来源声明
2
+
3
+ > 本文件随 `dsh-agent-soul` 的源码仓库、npm 包与 DSH 宿主安装副本一同分发。
4
+ > 若本文件的转述与 `LICENSES/` 下的许可原文有出入,**以 `LICENSES/` 下的原文为准**。
5
+ > 核对日期:2026-11-08,依据各仓库 GitHub 默认分支的 `LICENSE` 与 `README`。
6
+
7
+ ---
8
+
9
+ ## 一、本项目是派生作品,不声称原创
10
+
11
+ **dsh-agent-soul 不是从零写的原创作品。** 心情引擎、五张表情图、部分设置页布局、
12
+ 记忆机制、目的机制等实质性部分派生或借鉴自下列项目。按《Yuuyuko-uu 插件许可 1.2》
13
+ 第 5(b)、5(c)、7、8 条,在此明示来源、原作者、许可与改动;本项目不将上述部分
14
+ 称为「自研」「原创」,也不隐藏任何原作者署名。
15
+
16
+ | 原项目 | 原作者 / 版权人 | 适用许可 | 本项目中的性质 |
17
+ |---|---|---|---|
18
+ | [Yuuyuko-uu/dsh-feiyu-mood](https://github.com/Yuuyuko-uu/dsh-feiyu-mood) | **Yuuyuko-uu** | [Yuuyuko-uu 插件许可 1.2](./LICENSES/Yuuyuko-uu-PLUGIN-1.2.txt) | **实质性移植**:心情判断内核 + 判断 prompt + 五张表情图 + 界面布局 |
19
+ | [Yuuyuko-uu/dsh-fish-memory](https://github.com/Yuuyuko-uu/dsh-fish-memory) | **Yuuyuko-uu** | [Yuuyuko-uu 插件许可 1.2](./LICENSES/Yuuyuko-uu-PLUGIN-1.2.txt) | 记忆机制的设计借鉴:会淡忘的长期记忆、召回去重、注入预算 |
20
+ | [Mieksido/surfcore](https://github.com/Mieksido/surfcore) | Derpyu520 and qq-bridge / QSH contributors | MIT | 目的机制的设计与逻辑精简移植 |
21
+
22
+ 上表两个 Yuuyuko-uu 仓库的 `LICENSE` 是**同一份《Yuuyuko-uu 插件许可 1.2》逐字全文**,
23
+ 故共用 `LICENSES/Yuuyuko-uu-PLUGIN-1.2.txt` 这一份原文副本。
24
+ SurfCore 的版权声明与完整 MIT 许可文本见
25
+ [LICENSES/MIT-THIRD-PARTY.txt](./LICENSES/MIT-THIRD-PARTY.txt)。
26
+
27
+ ---
28
+
29
+ ## 二、整体许可结构
30
+
31
+ - 本项目包含来自 `dsh-feiyu-mood` 与 `dsh-fish-memory` 的派生部分。按《Yuuyuko-uu 插件许可 1.2》
32
+ **第 6 条**「公开的衍生作品必须继续使用本许可(或更严格的许可),不得改用更宽松的许可」,
33
+ **本项目作为公开衍生作品整体以该许可 1.2 为准**;再分发时不得把本项目整体标成纯 MIT。
34
+ - 根 [`LICENSE`](./LICENSE) 中的 MIT 文本保留不动,**仅覆盖本项目可与上述派生部分分离的
35
+ 自有代码**,不构成对本项目整体的 MIT 授权。`package.json` 的 `license` 字段写
36
+ `SEE LICENSE IN LICENSE`,即指向此处说明。
37
+ - 上表的 SurfCore 仍由其版权人按 MIT 授权;本声明**不削弱**你从原作者处
38
+ 直接取得的任何权利,也不替第三方组件授予额外权利。
39
+
40
+ 完整原文:
41
+
42
+ - `LICENSES/Yuuyuko-uu-PLUGIN-1.2.txt` —— 1.2 逐字全文(满足第 5(a) 条「完整保留本文件,不删、不改、不缩略」;同时对应两个原仓库)
43
+ - `LICENSES/MIT-THIRD-PARTY.txt` —— SurfCore 的版权行 + 完整 MIT 许可文本
44
+ - `LICENSE` —— 本项目自有可分离代码的 MIT 文本
45
+
46
+ ---
47
+
48
+ ## 三、逐项来源与改动清单(第 5(c) 条)
49
+
50
+ ### 3.1 dsh-feiyu-mood 0.7.6 —— 心情引擎(原作者 Yuuyuko-uu)
51
+
52
+ **取用了什么**
53
+
54
+ | 内容 | 本仓库位置 |
55
+ |---|---|
56
+ | 心情判断内核:心情值、七情、时间线、双半衰期衰减、只吃 1/3 的慢动 | `lib/mood.js`、`lib/mood/core.js`、`lib/state/mood-state.js` |
57
+ | 判断 prompt 的 11 条规则与三种判断口径(对方说话 / 定时任务 / 自己搭话) | `lib/mood/prompt.js` |
58
+ | 消息抽取的宿主事件形状容错、消息来源口径 | `lib/mood/session.js` |
59
+ | 五档表情阈值(80 / 62 / 42 / 25)与兜底规则 | `lib/mood/core.js` |
60
+ | **五张表情图**(`face-great/good/ok/worry/sad.png`,作者自绘) | `assets/face-*.png` |
61
+ | 设置页布局:大数字 hero + 七情 + 时间线 + 判断配置 | `lib/client/mood-tab.js`、`lib/client/styles.js` |
62
+ | 静态资源路径前缀的老习惯 | `lib/http/constants.js` |
63
+
64
+ **改了哪些部分**
65
+
66
+ - 砍掉三样:每回合 `systemPrompt.context` 注入、右下角挂饰(widget)、多份绑定(slots / 会话模式 / 工作区模式);改为按 `cwd` 的 slug 记一份全局心情。
67
+ - 判断 prompt 把称呼参数化成 `self / owner / aliases`,并从 2878 字压缩到约 1250 字(不改判据)。
68
+ - 判断调用改为可走硅基流动 OpenAI 兼容接口或宿主 `llm.stream`;不 import `@deepseek-ai/dsh-llm`。
69
+ - **不迁移 feiyu-mood 的历史心情数据**,从空白起步。
70
+ - 2026-11-06 模块化重构:拆成 `lib/mood/`、`lib/state/`、`lib/client/` 等目录,
71
+ 前端片段由 `tools/build-client.mjs` 拼成单 bundle;函数体保持原语义。
72
+
73
+ ### 3.2 SurfCore —— 目的机制(MIT)
74
+
75
+ **取用了什么**:四维驱动值(好奇 / 在乎 / 想分享 / 想搞懂)随时间半衰回基线、
76
+ 被素材反复刺激而上涨、从记忆里提炼「没闭合的事」作目标、`satisfyDrives`
77
+ (说出去了驱动才真的降 ×0.45)。落在 `lib/purpose.js`、`lib/state/maintain.js`、
78
+ `lib/host/runtime/segment-purpose.js`、`lib/client/purpose-tab.js`。
79
+
80
+ **改了哪些部分**:
81
+
82
+ - 删掉原版为 QQ 群聊写的排程、静默时段、投递 / 回执逻辑 —— 本地 DSH 没有推送渠道,
83
+ 「主动」从「主动发消息」改成「主动想起」,由模型自己决定要不要提。
84
+ - `purpose.js` 收敛为纯逻辑、零 I/O;`maintain` 负责落盘并做了写盘节流(P2-8)。
85
+ - 新增 `settleServed` / `markServed` 用「上一轮回复指纹」判定是否真的说出口,
86
+ 取代原先的 60 秒墙钟猜测(P1-5)。
87
+
88
+ ### 3.3 dsh-fish-memory —— 记忆机制(原作者 Yuuyuko-uu,许可 1.2)
89
+
90
+ 原项目定位(据其 README):「给 DSH 里的会话一份**会淡忘的长期记忆** —— 每条都带时间」;
91
+ 记忆有鲜活度、越久越淡但**不删除**,按「命中的词够不够特别」召回,命中才注入、
92
+ 有每日与单次配额,并做召回去重。
93
+
94
+ **取用了什么(设计层面)**
95
+
96
+ | 设计 | 本仓库对应位置 |
97
+ |---|---|
98
+ | 记忆会淡忘而非直接删除,淡到「说不清」而不是抹掉 | `lib/memory/constants.js` 的清晰度分级、`lib/memory/mutation.js`、`lib/state/maintain.js` |
99
+ | 每条记忆带时间,重要的记得更久、最初的事不丢 | `lib/memory/card.js`、`lib/memory/render.js` |
100
+ | 按证据召回、命中才注入、注入有预算上限 | `lib/memory/recall.js`、`lib/memory/render.js` |
101
+ | 自动挑重点(不是每句话都记)、单轮配额 | `lib/extract.js`、`lib/memory/config.js` |
102
+ | 召回去重、遗忘可查回(档案 append-only) | `lib/memory/recall.js`、`lib/memory/card-io.js` 的 `archive.jsonl` |
103
+
104
+ **改了哪些部分**
105
+
106
+ - 淡忘改为**多级清晰度**(清晰 → 清楚 → 模糊 → 只剩印象 → 遗忘)与每日 `maintain` 衰减,
107
+ 不是单一「鲜活度」数值;遗忘写进 `archive.jsonl`,另支持按体积分片。
108
+ - 记忆卡分**全局 / 项目两层**,再叠加按 `kind` 的分类、`pinned` 锚点、重要度与私密标记。
109
+ - 新增自动提取(`extract.js` 按规则打分、过滤宿主注入的上下文)、LLM 提炼与归属路由、
110
+ 跨进程写卡 rev 检测、原子写与写失败回滚。
111
+ - 新增配套能力:日记(公开 / 私密双篇)、笔记(永不衰减)、心情与目的机制的牵引。
112
+ - 2026-11-06 模块化重构:拆成 `lib/memory/`、`lib/state/`、`lib/http/routes/` 等目录。
113
+
114
+ > 说明:本仓库源码注释此前**没有**点名该来源,2026-11-08 按最高标准补记。
115
+ > 原项目 README 另注明其分词词表来自 jieba(MIT);**本仓库不含该词表**
116
+ > (检索确认只有中文分词的规则讨论,没有词表文件与 jieba 依赖),故不涉及该第三方素材。
117
+
118
+ ---
119
+
120
+ ## 四、署名保留位置(第 8 条)
121
+
122
+ 以下原有 / 补充的源码注释均**保留、不删、不替换、不隐藏**;再分发时请一并保留:
123
+
124
+ - `lib/mood.js`、`lib/mood/prompt.js`、`lib/mood/session.js`、`lib/mood/core.js`、
125
+ `lib/http/constants.js`、`lib/client/styles.js`、`lib/client/mood-tab.js`、
126
+ `tests/mood.test.js` —— 点名 dsh-feiyu-mood / 原作者 Yuuyuko-uu。
127
+ - `lib/store.js`、`lib/memory/render.js` —— 点名 dsh-fish-memory / 原作者 Yuuyuko-uu。
128
+ - `lib/purpose.js` —— 点名 SurfCore 与其 MIT 版权人。
129
+ - `assets/README.md` —— 五张表情图的作者与来源。
130
+ - 本文件、README 第一屏、根 `LICENSE`、`package.json` 的 `license` 字段。
131
+
132
+ ---
133
+
134
+ ## 五、不属于第三方版权来源的引用(边界)
135
+
136
+ 以下名字出现在注释或配置里,但**不是被复制的第三方代码**,无需按再分发条款署名:
137
+
138
+ - **明确「不 import」的对象**:`@deepseek-ai/dsh-tools`(`lib/tool.js:8`)、
139
+ `@deepseek-ai/dsh-llm`(`lib/mood/judge.js:143`)—— 注释写的是刻意避开。
140
+ - **宿主内部模块 / 官方包**:`@deepseek-ai/cordis`(peerDependency)、
141
+ `@deepseek-ai/dsh` 及 `@deepseek-ai/*`、`dsh-session/lib/types/index.js` 的
142
+ `validateSessionHeader`、`dsh-persona` 的同名开关 —— 仅用于核实字段名与接口,运行时依赖。
143
+ - **文档知识**:「DSH 问题库 Q07 / Q14 / Q20 / Q37 / Q39」是踩坑记录,不是代码。
144
+ - **第三方服务 / 运行时**:硅基流动 API、DeepSeek API、宿主提供的 React —— 属服务条款与运行时依赖。
145
+
146
+ ---
147
+
148
+ ## 六、许可原文
149
+
150
+ ### 6.1 Yuuyuko-uu 插件许可 1.2(逐字全文;独立副本见 `LICENSES/Yuuyuko-uu-PLUGIN-1.2.txt`)
151
+
152
+ ```
153
+ Yuuyuko-uu 插件许可 1.2
154
+
155
+ 版权所有 (c) 2026 Yuuyuko-uu
156
+
157
+ ──────────────────────────────────────────────────────────────
158
+
159
+ 【为什么不用 MIT】
160
+
161
+ 2026 年 10 月,有人把我这几个插件(代码、README,还有我做的图)
162
+ 改名、去掉署名,在视频里说成「自研」发布。
163
+
164
+ 他没有违反 MIT —— MIT 只要求保留版权声明,不管「这是谁做的」。
165
+
166
+ 所以换成了这份许可。它只多要求一件事:
167
+ 你拿走的时候,说一声这是谁做的。
168
+
169
+ 安装、修改、商用,全都允许 —— 和 MIT 一样宽。
170
+
171
+ ──────────────────────────────────────────────────────────────
172
+
173
+ 一、允许,不需要另外问我
174
+
175
+ 1. 安装到自己的机器上使用,长期用,商用也行。
176
+ 2. 读源码、改源码、改成自己需要的版本(改给自己用,不必公开)。
177
+ 3. 把你的改动发给我(issue / PR);我采纳后,按仓库惯例记你的贡献。
178
+ 4. 在文章、视频、教程里介绍、演示、截图、引用本项目 —— 请附上原仓库地址。
179
+
180
+ 二、允许,但必须做到
181
+
182
+ 5. 再分发时(把代码或其实质性部分放进你自己的仓库、整合包、安装包,
183
+ 或者换一个包名发布),必须同时做到:
184
+ a) 完整保留本文件,不删、不改、不缩略;
185
+ b) 在 README 的第一屏写明:本项目派生自 <原仓库地址>,原作者 Yuuyuko-uu;
186
+ c) 说明你改了哪些部分。
187
+ 6. 公开的衍生作品必须继续使用本许可(或更严格的许可),不得改用更宽松的许可。
188
+
189
+ 三、禁止
190
+
191
+ 7. 不得把本项目的全部或实质性部分声称为你自己原创 ——
192
+ 包括在 README、发布说明、视频、插件市场条目里,
193
+ 把它写成「自研」「原创」「我写的」。
194
+ 8. 不得删除、替换、隐藏本项目的作者署名,
195
+ 包括 LICENSE、NOTICE、README、package.json 和源码注释里的。
196
+
197
+ 四、其他
198
+
199
+ 9. 本项目按「现状」提供,不附带任何明示或默示的担保。
200
+ 10. 违反第二、三条中任何一条,本许可立即终止;你还应当删除已发布的衍生作品。
201
+ 从违约那一刻起,你就不再拥有使用、复制、分发本项目的任何授权。
202
+ 11. 上面没写的情况想用,直接来问我,一般都会答应。
203
+ ```
204
+
205
+ ### 6.2 MIT License(SurfCore;版权行与副本见 `LICENSES/MIT-THIRD-PARTY.txt`)
206
+
207
+ ```
208
+ MIT License
209
+
210
+ Copyright (c) 2026 Derpyu520 and qq-bridge / QSH contributors
211
+
212
+ Permission is hereby granted, free of charge, to any person obtaining a copy
213
+ of this software and associated documentation files (the "Software"), to deal
214
+ in the Software without restriction, including without limitation the rights
215
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
216
+ copies of the Software, and to permit persons to whom the Software is
217
+ furnished to do so, subject to the following conditions:
218
+
219
+ The above copyright notice and this permission notice shall be included in all
220
+ copies or substantial portions of the Software.
221
+
222
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
223
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
224
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
225
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
226
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
227
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
228
+ SOFTWARE.
229
+ ```
230
+
231
+ ---
232
+
233
+ ## 七、版本时间线说明(据实陈述)
234
+
235
+ `lib/mood.js` 注释写的是「从 dsh-feiyu-mood **0.7.6** 移植」。该 tag(commit `4e21024`,
236
+ 2026-10-26)当时的 `LICENSE` 与 `package.json` 均为 **MIT**;上游在 **2026-10-30**
237
+ 连改三次,把许可换成 1.0 → 1.1 → 1.2。按许可不追溯的通常理解,本可只按 MIT 保留
238
+ 版权声明。两个原仓库的 README「许可」章节至今仍写「Yuuyuko-uu 插件许可 1.0」,
239
+ 而 `LICENSE` 文件已是 1.2 —— 属上游自身的版本号不同步,本项目**以 LICENSE 原文为准**。
240
+
241
+ **本项目主动放弃援引这一时间差,按现行的《Yuuyuko-uu 插件许可 1.2》最高标准履约**:
242
+ 完整保留许可原文、README 第一屏声明派生与作者、列出改动、不声称原创、保留全部署名、
243
+ 并接受第 6 条对整体许可的约束。理由是原作者换许可的诉求只是「说一声这是谁做的」,
244
+ 而本项目的注释与五张图都是明确移植,按高标准署名成本极低、也最不容易产生争议。
245
+
246
+ > 本文件是工程层面的来源与许可说明,不构成法律意见。
@@ -0,0 +1,22 @@
1
+ # assets/ 图片来源说明
2
+
3
+ 本目录下的五张表情图为 **Yuuyuko-uu 自绘**,来自
4
+ [dsh-feiyu-mood](https://github.com/Yuuyuko-uu/dsh-feiyu-mood)(本项目注释所记的
5
+ 0.7.6 时期)。原仓库 README 第九节「换掉示例图片」与《Yuuyuko-uu 插件许可 1.2》
6
+ 开头「还有我做的图」均说明这些图由原作者本人绘制,**不是第三方画师素材**。
7
+
8
+ | 文件 | 心情档位 |
9
+ |---|---|
10
+ | `face-great.png` | 欢喜(≥ 80) |
11
+ | `face-good.png` | 开心(62–79) |
12
+ | `face-ok.png` | 一般(42–61) |
13
+ | `face-worry.png` | 心疼(25–41) |
14
+ | `face-sad.png` | 难过(< 25) |
15
+
16
+ - **适用许可**:《Yuuyuko-uu 插件许可 1.2》,逐字原文见
17
+ [`../LICENSES/Yuuyuko-uu-PLUGIN-1.2.txt`](../LICENSES/Yuuyuko-uu-PLUGIN-1.2.txt)。
18
+ - **原作者**:Yuuyuko-uu(版权所有 (c) 2026)。
19
+ - **本项目改动**:**图片内容未修改**,沿用原文件名、84×66 显示比例与五档阈值;
20
+ 仅把静态资源前缀改成 `/dsh-agent-soul`(见 `../lib/http/constants.js`),
21
+ 并按该许可第 5(c) 条在 `../THIRD-PARTY-NOTICES.md` §3.1 列出全部改动。
22
+ - 请勿删除本说明,也请勿把这些图片称为本项目原创。
@@ -0,0 +1,116 @@
1
+ # 已知问题清单(截至 0.9.7;2026-11-08 R13 轮划掉 23 条)
2
+
3
+ > 2026-11-08 R13 轮:~~划线~~ 条目已修,测试锚定在 `tests/r13-batch.test.js`(36 断言),
4
+ > 修法见提交历史(fix/known-issues-r13 分支 R13 批次一~五)。仍打开:#2 #15 #20 #21 #23 #26–#28 #32–#35 与第五、六节。
5
+ >
6
+ > **2026-11-08 复核补丁(0.9.8)**:R13 的 #1(`/diary/list` 只读头部 400 字节)按字节切 UTF-8,
7
+ > 中文预览末尾会出现 `�`(U+FFFD)—— 400 % 3 ≠ 0,边界必然落在汉字中间。
8
+ > 已改为「多读 3 字节 + 丢掉残缺尾字」,并在 `tests/r13-batch.test.js` 补了带 REDGREEN 的断言。
9
+ > 记一笔当时的教训:第一版测试用「【公开】+ 日期」前缀(25 字节),375 恰好整除 3,
10
+ > 边界落在字与字之间 —— **修没修都是绿的**,poison 复核时才发现这是假绿。
11
+
12
+ > 这份清单是**给下一轮修**用的,不是发布说明。所有条目都已复核过代码位置;
13
+ > 每条都标了「验证程度」,方便判断可信度:
14
+ > **A = 读代码 + 实测复现过**,**B = 读代码确认**,**C = 只按报告描述归档,未逐行核**。
15
+ >
16
+ > 状态:`0.9.1`–`0.9.6` 清掉了全部 14 条 P1 与大部分 P2。下面剩下的**没有一条会立刻让插件罢工**,
17
+ > 但每一条都会在特定条件下让人踩到。
18
+
19
+ ---
20
+
21
+ ## 一、性能(数据量大才显形)
22
+
23
+ | # | 问题 | 位置 | 影响 | 建议 | 验证 |
24
+ |---|---|---|---|---|---|
25
+ | ~~1~~ ✅已修(2026-11-08 R13) | `/diary/list` 循环 30 天**全量**读日记,只取前 400 字 | `lib/http/routes/diary.js` | 每天 2 次请求,30 天 × 全量读 → 打开日记标签页要等一下 | 读前 400 字节(`readFileSync` 带 `length`),或按需懒加载 | B |
26
+ | 2 | `/diary/sessions` 两层 `readdir` + 逐目录 `stat` 兜底 | `lib/http/sessions.js` | 会话目录多时列表慢 | 加 TTL 缓存 + `withFileTypes` 一次拿全 | B |
27
+ | ~~3~~ ✅已修(2026-11-08 R13) | `saveCard` 每次写盘前**完整解析旧文件**(只为判断能否备份)+ `copyFileSync` | `lib/memory/card-io.js` | 记忆写入路径多一次全量解析 | 本进程写过的可跳过解析;备份改硬链接/懒备份 | B |
28
+ | ~~4~~ ✅已修(2026-11-08 R13) | `recallArchived` 读**全部**归档分片再截 tail | `lib/memory/card-io.js` | 归档攒多之后查历史慢 | 旧分片只读尾块 | B |
29
+ | ~~5~~ ✅已修(2026-11-08 R13) | v1→v2 迁移失败时,每次 `loadCard` 都重试写盘 + 刷日志(且改写 mtime 使缓存 stamp 永远失配) | `lib/memory/card-io.js` | 一张老卡能刷满日志、并让缓存失效 | 迁移失败加退避 + `note` 节流;别在读取路径写盘 | B |
30
+ | ~~6~~ ✅已修(2026-11-08 R13) | `moodPath` 已是全局单文件,但缓存 key 按 `cwd` 分裂;写失败 settle 只救一个 key | `lib/paths.js` + `lib/state/mood-state.js` | 双工作区下偶发「旧值覆盖新值」 | key 固定成 `mood:global` | B |
31
+ | ~~7~~ ✅已修(2026-11-08 R13) | `readSessionMeta` 无缓存,每次全量解压 ≤16MB 日志 | `lib/session-title.js` | 标题/元信息路径反复解压 | 复用 `readTitleFromLog` 的 `(size, mtime)` 缓存 | B |
32
+
33
+ > 已修(供对照):日志每行 4 次系统调用(P2-1)、`snapshotEvents()` 全量拷贝(P2-2)、
34
+ > `readRecentChat` 全量 parse(P2-5)、`purpose.json` 每回合写盘(P2-8)、8 处 `clear()`(P2-10)。
35
+
36
+ ---
37
+
38
+ ## 二、一致性与小缺陷
39
+
40
+ | # | 问题 | 位置 | 影响 | 建议 | 验证 |
41
+ |---|---|---|---|---|---|
42
+ | ~~8~~ ✅已修(2026-11-08 R13) | `maxRecords` 两处夹取值不一致:`normalizeConfig` 夹 `[20, 5000]`,`NUMBER_RANGES` 卡 `[50, 3000]` | `lib/memory/config.js` vs `lib/http/middleware.js` | 手改配置文件能跳过 `/config` 的校验 | 两边统一(建议都 `[20, 5000]`) | A |
43
+ | ~~9~~ ✅已修(2026-11-08 R13) | `note()` 日志注入:来自请求体的值未清洗就进日志 | `lib/http/routes/memory.js`、`routes/diary.js` | 恶意/意外换行能把一条日志拆成几条 | 统一 `sanitizeLogText()`(去控制字符 + 截断) | B |
44
+ | ~~10~~ ✅已修(2026-11-08 R13) | `readBody` 超限时回 **500** 而不是 413,且 `destroy()` 之后仍写响应 | `lib/http/middleware.js` | 客户端看不出「请求体太大」,只看到服务器错误 | 改 413 + 先判断 `writableEnded` | B |
45
+ | ~~11~~ ✅已修(2026-11-08 R13) | `/diary/list` 的 `exists → statSync` 是 TOCTOU | `lib/http/routes/diary.js` | 并发删文件时偶发 500 | 直接 `statSync` 并 catch | B |
46
+ | ~~12~~ ✅已修(2026-11-08 R13) | `validateConfigEntry` 的控制字符黑名单漏 C1 区(`\u0080-\u009F`)与 `U+2028/2029` | `lib/http/middleware.js` | 某些行分隔符能进配置值 | 改用 `/\p{Cc}\|[\u2028\u2029]/u` | B |
47
+ | ~~13~~ ✅已修(2026-11-08 R13) | `mergeCards` 合并 `stats` 时漏了 `decayed` 字段 | `lib/memory/card.js` | 跨进程合并后衰减计数丢失 | 补字段 | B |
48
+ | ~~14~~ ✅已修(2026-11-08 R13) | `normalizeRecord` 补 id 的哈希不掺 `scope` | `lib/memory/card.js` | 跨卡「同文本 + 同时间」会撞 id,被误并成一条 | 哈希里加 scope | B |
49
+ | 15 | `redact` 的银行卡正则 `\b\d{16,19}\b` 误伤长订单号/雪花 ID,且不可恢复 | `lib/extract.js` | 正常内容被抹成 `[卡号]` | 加前缀白名单(62/4/5 开头)或按 Luhn 校验 | B |
50
+ | ~~16~~ ✅已修(2026-11-08 R13) | `diaryWindowOf` 对 NaN 月/日静默回退成 1 月窗口 | `lib/diary/compose.js` | 坏日期会读错时间段 | 显式判 NaN 并返回空窗口 | B |
51
+ | ~~17~~ ✅已修(2026-11-08 R13) | 日志轮转归档名精确到**分钟**,同分钟二次轮转覆盖/失败 | `lib/env.js` | 极端情况下丢一份归档 | 归档名加序号或毫秒 | B |
52
+ | ~~18~~ ✅已修(2026-11-08 R13) | `diary-pick.js` 的布尔优先级可疑(`&&` 先于 `\|\|`) | `lib/core/diary-pick.js` | 选会话的条件可能和注释不符 | 加括号 + 补测试 | C |
53
+ | ~~19~~ ✅已修(2026-11-08 R13) | mood digest 把 `decay` 模板句收进「那天你自己的想法」候选 | `lib/mood/digest.js` | 日记里出现系统模板句 | 跳过 `kind === 'decay'` | B |
54
+ | 20 | `notes reconcile` 按**索引**对位比较,顺序一变就误报 `changed` | `lib/notes.js` | 笔记索引反复刷新 | 改按 slug 建 Map 比较 | B |
55
+ | 21 | `readNote` 用 `loadIndex` 而不是 `reconcile` | `lib/notes.js` | 可能返回已删文件的条目 | 统一走 reconcile | B |
56
+
57
+ ---
58
+
59
+ ## 三、前端
60
+
61
+ | # | 问题 | 位置 | 影响 | 建议 | 验证 |
62
+ |---|---|---|---|---|---|
63
+ | ~~22~~ ✅已修(2026-11-08 R13) | 各 Tab 各持 stale config 快照(跨 Tab 保存会覆盖) | `lib/client/*-tab.js` | 已用「只发改动键」缓解 90%,但架构上仍是旧快照 | 把 config 状态提升到 `SoulSection` 单点持有 | A |
64
+ | 23 | 「错误边界」接不住**渲染期**异常 | `lib/client/app.js` | 某次渲染抛错 → 白屏 | 需要 `React.Component` 基类;本 bundle 作用域里没有,**做不了,只能等宿主暴露** | A |
65
+ | ~~24~~ ✅已修(2026-11-08 R13) | mood 页在后台标签页仍按 20s 轮询 | `lib/client/mood-tab.js` | 后台也耗电/耗请求 | `document.visibilityState` 时暂停 | B |
66
+ | ~~25~~ ✅已修(2026-11-08 R13) | diary 页的公开预览用 `getElementById` 直写 DOM,绕过 React | `lib/client/diary-tab.js` | 与 React 状态不一致 | 改回受控渲染 | B |
67
+
68
+ ---
69
+
70
+ ## 四、架构 / 可维护性(P3 摘要,本轮刻意不动)
71
+
72
+ | # | 问题 | 影响 | 建议 |
73
+ |---|---|---|---|
74
+ | 26 | `diary/scheduler.js` 687 行混五种职责 | 改一处要读整文件 | 拆 `diary/agent.js` + `diary/deliver.js` |
75
+ | 27 | `diary/compose.js` 591 行四类职责,`composeDiarySetup` 放错位置 | 同上 | 移到 `scheduler` 或 `diary/agent.js` |
76
+ | 28 | `host/runtime/segment-memory.js` 的 `text()` 约 150 行、8 种职责的上帝函数 | 难以单测 | 拆 `runToneForTurn` / `collectDiaryMaterial` / `computeRecallText` / `applyBudget` |
77
+ | ~~29~~ ✅已修(2026-11-08 R13) | `index.js` 顶部注释的注入顺序漏了 `soul:data-policy` | 文档与代码漂移 | 补一句 |
78
+ | ~~30~~ ✅已修(2026-11-08 R13) | `extract` 游标对「无 id 会话」统一用 `'default'` 键 | 两个会话互吃扫描窗口 | 用会话对象身份做键 |
79
+ | ~~31~~ ✅已修(2026-11-08 R13) | `TITLE_CACHE` / `PATH_CACHE` 全仓库唯一无上限缓存 | 长跑内存缓慢增长 | 用 `trimMap` 限一下 |
80
+ | 32 | `build-client.mjs` 的 `ORDER` 硬编码;符号扫描 `DECL_RE` 只认 4 空格的 `var/function` | 新增片段漏登记会静默丢失;`let/const` 逃检 | 自动扫描 + 放宽正则 |
81
+ | 33 | `revOf` 三处逐字重复;`pad2`/`dateKeyOf` 同构重复;测试断言工具在 40+ 文件逐份复制 | 改一处要改 N 处 | 收敛到 `constants.js` 与 `tests/helpers/assert.mjs` |
82
+ | 34 | `summarizeConversations` 成死代码仍从门面导出;`askAgentToWrite` 的 `force` 参数恒 false | 误导读者 | 删掉或标注 |
83
+ | 35 | `docs/preview.html` 手工复制 `styles.js` 整套 CSS | 改样式后预览过期 | 生成或加一致性检查 |
84
+
85
+ ---
86
+
87
+ ## 五、明确「不修」的(已权衡)
88
+
89
+ | 项 | 为什么不修 |
90
+ |---|---|
91
+ | 反代下 `isLoopbackRequest()` 恒真 | 代理把 `remoteAddress` 变成 `127.0.0.1`,插件侧没有可靠信号区分真实远端。引入 `DSH_SOUL_TRUSTED_PROXY` 做**授权**判定会把权限建立在可伪造的请求头上 —— 已开的那个变量**只用于分桶与日志**。真正的锁是 `x-soul-token` + 上游鉴权。 |
92
+ | 跨进程写卡「不自动重写」 | 写后检测 + 告警已够用;自动重写要给**每一次**写盘加成本,而多进程并发是低频场景。 |
93
+ | `P3` 大部分条目 | 改了不解决任何用户问题,却要碰 40 个文件。等前几类清完、测试稳定后再单独一轮。 |
94
+
95
+ ---
96
+
97
+ ## 六、两条待确认(依赖宿主行为,仓库内无法验证)
98
+
99
+ | 项 | 不确定的是什么 | 现在怎么兜 |
100
+ |---|---|---|
101
+ | 压缩会话的 `snapshotEvents(0, seq+1)` 会不会抛 | 宿主是打包的 `.asar`,造不出真实压缩会话 | 抛了也不推进锁:游标一定推进、整卡注入只宽限一次(第一次失败仍注入,之后不再重复)。**若有人报「新会话没人格」,先看这里。** |
102
+ | 反代 + 非默认端口下 `Origin`/`Host` 的边界形态 | 已按规范化权威比较、两端回环允许不同端口,但没有真实反代环境压测 | 被拒时 403 响应体带 `origin`/`host`,可直接对照 |
103
+
104
+ ---
105
+
106
+ ## 七、建议的下一轮顺序
107
+
108
+ 1. **一致性**:#8(`maxRecords` 两处夹取)、#12(控制字符)、#13/#14(合并与 id)—— 都是小改动、纯正确性。
109
+ 2. **日志与请求层**:#9(日志注入)、#10(413)、#11(TOCTOU)。
110
+ 3. **性能**:#1、#3、#5(最常被调用的三条)。
111
+ 4. **前端**:#22(config 单点)、#24(后台暂停)。
112
+ 5. **重构**:#26–#28 三个大文件(要单独一轮,且必须在测试稳定之后)。
113
+
114
+ ---
115
+
116
+ *清单随代码演进维护;修掉一条就把那条划掉并写进 `CHANGELOG.md`。*
@@ -23,6 +23,8 @@
23
23
  var [busy, setBusy] = useState('')
24
24
  var [noteText, setNoteText] = useState('')
25
25
  var [selectedDate, setSelectedDate] = useState('')
26
+ // 公开日记全文:受控 state(2026-11-08 KNOWN-ISSUES #25,原来走 getElementById 直写 DOM)
27
+ var [publicText, setPublicText] = useState('')
26
28
  // 私密正文(2026-10-31):只在 diaryPrivateVisible=true 且本机回环时取得到
27
29
  var [privateText, setPrivateText] = useState('')
28
30
  // 可选日记会话(2026-11-04):下拉选项来自 GET /diary/sessions
@@ -74,7 +76,12 @@
74
76
  return
75
77
  }
76
78
  apiPostDebounced('config:diary', '/config', { config: changed }, 300)
77
- .then(function () { setStatus('已保存,下一个回合生效') })
79
+ .then(function () {
80
+ setStatus('已保存,下一个回合生效')
81
+ // 2026-11-08 KNOWN-ISSUES #22:保存成功后让 SoulSection 拉回最新 config,
82
+ // 其余 Tab 的 props.config 不再停留在各自挂载时的旧快照。
83
+ if (typeof props.reload === 'function') props.reload()
84
+ })
78
85
  .catch(function (e) { setStatus('保存失败:' + e.message) })
79
86
  }
80
87
 
@@ -98,11 +105,9 @@
98
105
  setBusy('read')
99
106
  apiGet('/diary/read?date=' + encodeURIComponent(dateStr))
100
107
  .then(function (res) {
101
- if (res.publicContent) {
102
- // 把公开日记内容显示在文本框里
103
- var el = document.getElementById('soul-diary-preview')
104
- if (el) el.value = res.publicContent
105
- }
108
+ // 2026-11-08 KNOWN-ISSUES #25:公开预览原来用 getElementById 直写 DOM
109
+ // (绕过 React,固定 id 在宿主复用时还会撞车),改受控 state,与私密那份同口径。
110
+ setPublicText(String(res.publicContent || ''))
106
111
  if (res.hasPrivate) {
107
112
  setStatus(config.diaryPrivateVisible === true
108
113
  ? res.date + ' 有私密日记,点「看私密」在本机查看'
@@ -421,10 +426,11 @@
421
426
  // ---- 公开日记预览 ----
422
427
  h(Card, { title: '公开日记全文' },
423
428
  h('textarea', {
424
- id: 'soul-diary-preview',
425
429
  className: 'soul-textarea',
426
430
  style: { minHeight: 200, resize: 'vertical' },
427
431
  readOnly: true,
432
+ value: publicText,
433
+ onChange: function () {},
428
434
  placeholder: '点「看全文」加载某天的公开日记',
429
435
  })
430
436
  ),