pi-wechat-session-hub 0.1.1 → 0.1.4

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,151 @@
1
+ # 更新日志
2
+
3
+ 本文件记录所有值得关注的变更. 格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/), 版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/).
4
+
5
+ ## [未发布]
6
+
7
+ 暂无.
8
+
9
+ ## [0.1.4] - 2026-11-12
10
+
11
+ 本版重做 `/watch` 会话健康总览: 默认视图改为「当前打开着的会话」, 并新增「最后提问」列.
12
+
13
+ ### 改进
14
+
15
+ - **`/watch` 默认视图改为按「是否还开在后台」筛选**
16
+ - 原规则按会话状态筛选(非空闲), 结果是 256 个会话里有 250 个长期空闲的历史会话被藏起来, 而真正开在后台但刚跑完的会话(worker 状态 idle)反而看不见
17
+ - 改为按 registry 中是否还有 worker 实例判断: 有 worker = 当前可操作, 直接展示, 不论 running 还是 idle; 异常与断连会话始终展示
18
+ - 汇总行改为「打开 N 个(共 M)」, 不再用总数误导; 页尾补充「共 M 个会话, 发 `/watch --all` 查看全部」
19
+ - 实测本机: 默认视图从 2 行变为 7 行, 正好对应当前开着的 7 个会话
20
+ - **新增「最后提问」列, 取代会话标题**
21
+ - 取 transcript 中最后一条 user 消息, 即你自己最后一句话, 比会话标题更能帮助回忆起该会话在干什么
22
+ - 超长内容按 Unicode code point 截断到 22 字并加省略号, 避免手机端横向滚动
23
+ - 仅对会被展示的行读取, 不为几百个历史会话做无意义 IO
24
+ - 读取采用与 `readLatestFailure` 相同的动态扩窗策略(64KB → 2MB): 长会话中最后一条用户消息会被大量 assistant 输出挤出初始窗口, 固定窗口会误报「暂无提问」
25
+ - **活动时间改为相对描述**: `2026-11-12 14:54` 改为 `14m` / `2h` / `1d`, 手机上无需心算
26
+ - 移除表格中的 PID 列(手机端无用且撑宽), 需要诊断时用 `/wx status`
27
+
28
+ ### 测试
29
+
30
+ - 更新 `/watch` 用例: 断言默认视图按 worker 实例筛选、展示最后提问而非会话标题、`--all` 不再输出分页提示
31
+ - 全量测试 134 条, 131 通过 / 0 失败 / 3 跳过
32
+
33
+ ### 升级提示
34
+
35
+ - 升级后需重启 Pi TUI 并执行 `/wx restart`, 否则 daemon 仍跑旧代码
36
+
37
+ ## [0.1.3] - 2026-11-11
38
+
39
+ 本版修复 `/watch` 会话健康总览的误报: 用户主动中断与历史遗留失败被长期当作「需要处理」的异常.
40
+
41
+ ### 修复
42
+
43
+ - **`/watch` 把用户主动中断当成错误**
44
+ - transcript 中 `stopReason: aborted` / `errorMessage: Operation aborted` 表示用户自己按了中断, 属于正常操作痕迹, 但原逻辑只看到 `errorMessage` 非空就判为失败, 结果在总览里永久显示错误并进入「需要处理」列表
45
+ - 新增 `interrupted` 状态: 主动中断显示为「已中断」, 默认与空闲会话一起收起, `--all` 仍可查看
46
+ - 实测样本: 本机 248 个会话中有 3 个属于此类误报
47
+ - **历史遗留失败被当作当前故障**
48
+ - 健康状态由 transcript 最后一条 assistant 记录推导, 而 transcript 不会再变化, 因此一个多月前的一次失败会每天出现在「需要处理」里
49
+ - 失败信息现在带上 transcript 条目的 `timestamp`(`detectedAt`), 超过 24 小时的失败视为历史记录, 不再报异常; 「需要处理」列表同时显示失败发生时间
50
+ - 缺少可信时间戳时按未过期处理, 避免因解析不到时间而漏报真实故障
51
+ - **上游合规拦截被归为「未知错误」**
52
+ - 新增 `policy_blocked` 分类, 识别 `Request blocked` / `are not allowed` / `violates` / `account suspension` 等文本, 显示为「请求被上游合规策略拦截」, 便于判断应该换模型或换账号, 而不是当成偶发故障重试
53
+
54
+ ### 测试
55
+
56
+ - 新增主动中断不算故障、时间窗口生效与边界、缺少时间戳不漏报、合规拦截分类、`readLatestFailure` 带时间戳等用例
57
+ - 全量测试 134 条, 131 通过 / 0 失败 / 3 跳过
58
+
59
+ ### 升级提示
60
+
61
+ - 升级后需重启 Pi TUI, 让新的健康判定生效
62
+
63
+ ## [0.1.2] - 2026-11-11
64
+
65
+ 本版核心是**修复 npm 安装场景下后台服务无法启动**, 并新增 Windows 登录后自动启动、会话健康总览, 以及一批微信端展示修复.
66
+
67
+ ### 修复
68
+
69
+ - **npm 安装后后台 Gateway 无法启动**(#1, PR #2, 感谢 [@leliyliu](https://github.com/leliyliu))
70
+ - 此前 daemon 以 `node --experimental-transform-types src/runtime/gateway-daemon.ts` 启动, 这在两种常见环境下必然失败:
71
+ - Node >= 26 已移除该参数, 子进程以 `bad option` 退出(退出码 9), 上层报「后台 Gateway 在 ready 前退出 (code 9)」
72
+ - 从 npm 安装时入口位于 `node_modules` 内, 而 Node 原生 TypeScript 支持拒绝剥离 `node_modules` 下的 `.ts`(`ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING`), 降级 Node 也无效
73
+ - 改为通过 `jiti` 加载同一份 `.ts` 源码(新增 `extensions/daemon-entry.mjs` 启动垫片), Node 22 / 24 / 26 一致可用, 且不需要维护编译产物
74
+ - 仅在入口仍以 `.ts` 结尾时保留该参数, 自定义入口与测试行为不变
75
+ - Windows 登录自动启动的 launcher 同步适配: `.mjs` 入口不再传该参数
76
+ - macOS 上 POSIX 控制 socket 路径超长导致的 `listen()` EINVAL 一并修复(`sun_path` 上限 104 字节)
77
+ - **单条消息投递失败会永久卡死整条 route**
78
+ - 队列原为严格 FIFO 阻塞语义, 队首标记 `failed` / `interrupted` 后永久阻断该 route 后续消息, 且不向用户回任何提示. 表现为微信能发消息、Hub 显示在线, 但永远收不到回复, 连 `/status` 也被堵在队列里. 线上曾因此卡死 9 天
79
+ - 新增 `skipped` 状态: 遇到遗留 `processing` / `failed` / `interrupted` 项时跳过并放行后续消息
80
+ - 跳过时主动向微信回提示, 含消息 ID、原文预览、失败原因与 `/retry` 指令; 提示投递失败只放弃提示, 不阻塞队列
81
+ - `/status` 新增「已跳过」段, 展示跳过数量、消息 ID 与原因
82
+ - **回复过长导致 iLink 投递失败**, 按实测上限重做单条消息约束
83
+ - 实测结论: `item_list` 只能含 **1 个** `text_item`(2 个时即使总长仅 30 字也返回 `ret=-2 prepare failed`); 请求体 UTF-8 字节上限约 16800(16791 成功 / 16926 失败, 中文 5456 字成功 / 5501 字失败)
84
+ - 移除 `splitTextItems`, `sendText` 恒定发送单 item, 上限设为 16500 字节
85
+ - **UI 会话 reload 后重连失败**
86
+ - **`/wx autostart on` 在非提升用户下失败**, 改用当前用户注册表启动项
87
+ - Task Scheduler 方案有两层问题: 完整 `/TR` 命令 787 字符, 超过 261 字符上限; 且当前非提升用户连创建 `notepad.exe` 任务都返回 `Access is denied`
88
+ - 改为写入 `HKCU\Software\Microsoft\Windows\CurrentVersion\Run`, 不需要管理员权限
89
+ - Run 项只调用短 PowerShell launcher, 由 launcher 以隐藏窗口启动 Node Gateway, 完整 launch payload 留在私有 manager 目录中
90
+ - 失败提示保留 `reg.exe` 返回原因, 不再吞掉底层错误; 配置失败会回滚
91
+ - **`/last` 误报「尚未产生回复」**: 最新一轮失败时改为显示真实错误原因
92
+
93
+ ### 新增
94
+
95
+ - **`/watch [--all]` 会话健康总览**
96
+ - 默认列出运行中、启动中、异常与断连会话, `--all` 包含空闲会话; 表格显示索引、标题、项目、当前状态与最后活动时间
97
+ - 从 transcript 最后一条 assistant 的 `stopReason` / `errorMessage` 归类失败, 可识别周 / 5 小时 / 月额度耗尽、TPM 限流、鉴权失败、服务不可用(503)、网络错误与中断; 上游提供重置时间时直接显示原时间
98
+ - 不依据 `heartbeatAt` 推断卡死: 该字段只在状态变化时写入, 不是周期心跳
99
+ - **Windows 登录后自动启动**(`/wx autostart on|off`), 默认关闭
100
+ - 使用已保存授权在登录时连接, 不在登录桌面前运行, 启动时不弹扫码窗口
101
+ - 授权失效时需先在本机执行 `/wx login`
102
+
103
+ ### 改进
104
+
105
+ - **微信端命令改为 markdown 表格与分段显示**. 实测确认微信支持表格、列表、加粗、行内代码与 `---` 分隔线; **单个 `\n` 会被渲染为空格**, 这是此前信息挤成一行的真因
106
+ - `/sessions`: 改为四列表格 + 项目汇总, 索引列去掉冗余 `#` 前缀; 移除页码参数, 一次展示所有符合筛选条件的会话
107
+ - `/status`: 纯文本字段堆叠改为两列键值表, 可见 UI 模式并入表格
108
+ - `/projects`: 改为三列表格, 默认项目加粗并补充登记命令提示
109
+ - `/new`、`/last`、`/resume`、`/help` 与跳过提示: 消除单换行导致的信息粘连, 标签与正文分段展示
110
+ - README 与实现说明同步更新会话列表展示方式与自动启动机制
111
+
112
+ ### 测试
113
+
114
+ - 新增 Windows 登录自动启动管理器测试, 覆盖 Run 项写入、launcher 生成与失败回滚
115
+ - 新增 `.mjs` daemon 入口断言: launcher 不传 Node TypeScript 参数, 且包含 `daemon-entry.mjs` 与 `--launch-payload`
116
+ - CI 新增 `Gateway npm bootstrap` 检查(Node 22 与 Node 26), 将包打成 tarball 解压到 `node_modules/` 后实际加载 daemon 垫片, 覆盖 npm 安装场景
117
+ - 全量测试 128 条, 125 通过 / 0 失败 / 3 跳过
118
+
119
+ ### 升级提示
120
+
121
+ - 从 0.1.x 升级后**需要重启 Pi TUI**, 让新扩展入口生效
122
+ - 若此前已开启自动启动, **需要重新执行一次 `/wx autostart on`**: launcher 中记录的是绝对路径, 旧 launcher 仍指向源码目录的入口
123
+ - npm 包内文件的安装位置发生变化时, 旧的 daemon 进程不会自动切换, 请执行 `/wx restart`
124
+
125
+ ## [0.1.1] - 2026-10-29
126
+
127
+ ### 修复
128
+
129
+ - 修复 0.1.0 的 npm 索引元数据异常
130
+ - 0.1.0 首次发布时 2FA 触发了 npm staged publishing, 先落地了 `0.0.0-stage` 占位 stub, 之后才写入真实 0.1.0. 结果 registry 上 packument 的 `readme` 与 `readmeFilename` 均为空字符串(tarball 内 `README.md` 正常), 导致该包无法进入 npm search 索引, `pi.dev/packages` 因而查不到
131
+ - `0.0.0-stage` 已 unpublish 清除, 重新发布 0.1.1 以重建元数据
132
+
133
+ ## [0.1.0] - 2026-10-29
134
+
135
+ ### 新增
136
+
137
+ - 首个公开版本
138
+ - 微信远程下发任务, 由本机 Pi 执行, 结果回到微信
139
+ - 会话常驻: Pi TUI 全部关闭后仍可在微信继续对话
140
+ - 前后台自动交接: TUI 打开即接管, 关闭即交回后台, 始终只有一个 writer
141
+ - 多项目多会话管理与稳定数字索引
142
+ - `/last` 只读回顾最近一轮对话, 不调模型不耗 token
143
+ - 授权根目录白名单与 fail-closed 命令处理
144
+ - AGPL-3.0 许可证与安装文档
145
+
146
+ [未发布]: https://github.com/yangfeng20/pi-wechat-session-hub/compare/v0.1.4...HEAD
147
+ [0.1.4]: https://github.com/yangfeng20/pi-wechat-session-hub/compare/v0.1.3...v0.1.4
148
+ [0.1.3]: https://github.com/yangfeng20/pi-wechat-session-hub/compare/v0.1.2...v0.1.3
149
+ [0.1.2]: https://github.com/yangfeng20/pi-wechat-session-hub/compare/v0.1.1...v0.1.2
150
+ [0.1.1]: https://github.com/yangfeng20/pi-wechat-session-hub/compare/v0.1.0...v0.1.1
151
+ [0.1.0]: https://github.com/yangfeng20/pi-wechat-session-hub/releases/tag/v0.1.0