pi-wechat-session-hub 0.1.1 → 0.1.2

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,95 @@
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.2] - 2026-11-11
10
+
11
+ 本版核心是**修复 npm 安装场景下后台服务无法启动**, 并新增 Windows 登录后自动启动、会话健康总览, 以及一批微信端展示修复.
12
+
13
+ ### 修复
14
+
15
+ - **npm 安装后后台 Gateway 无法启动**(#1, PR #2, 感谢 [@leliyliu](https://github.com/leliyliu))
16
+ - 此前 daemon 以 `node --experimental-transform-types src/runtime/gateway-daemon.ts` 启动, 这在两种常见环境下必然失败:
17
+ - Node >= 26 已移除该参数, 子进程以 `bad option` 退出(退出码 9), 上层报「后台 Gateway 在 ready 前退出 (code 9)」
18
+ - 从 npm 安装时入口位于 `node_modules` 内, 而 Node 原生 TypeScript 支持拒绝剥离 `node_modules` 下的 `.ts`(`ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING`), 降级 Node 也无效
19
+ - 改为通过 `jiti` 加载同一份 `.ts` 源码(新增 `extensions/daemon-entry.mjs` 启动垫片), Node 22 / 24 / 26 一致可用, 且不需要维护编译产物
20
+ - 仅在入口仍以 `.ts` 结尾时保留该参数, 自定义入口与测试行为不变
21
+ - Windows 登录自动启动的 launcher 同步适配: `.mjs` 入口不再传该参数
22
+ - macOS 上 POSIX 控制 socket 路径超长导致的 `listen()` EINVAL 一并修复(`sun_path` 上限 104 字节)
23
+ - **单条消息投递失败会永久卡死整条 route**
24
+ - 队列原为严格 FIFO 阻塞语义, 队首标记 `failed` / `interrupted` 后永久阻断该 route 后续消息, 且不向用户回任何提示. 表现为微信能发消息、Hub 显示在线, 但永远收不到回复, 连 `/status` 也被堵在队列里. 线上曾因此卡死 9 天
25
+ - 新增 `skipped` 状态: 遇到遗留 `processing` / `failed` / `interrupted` 项时跳过并放行后续消息
26
+ - 跳过时主动向微信回提示, 含消息 ID、原文预览、失败原因与 `/retry` 指令; 提示投递失败只放弃提示, 不阻塞队列
27
+ - `/status` 新增「已跳过」段, 展示跳过数量、消息 ID 与原因
28
+ - **回复过长导致 iLink 投递失败**, 按实测上限重做单条消息约束
29
+ - 实测结论: `item_list` 只能含 **1 个** `text_item`(2 个时即使总长仅 30 字也返回 `ret=-2 prepare failed`); 请求体 UTF-8 字节上限约 16800(16791 成功 / 16926 失败, 中文 5456 字成功 / 5501 字失败)
30
+ - 移除 `splitTextItems`, `sendText` 恒定发送单 item, 上限设为 16500 字节
31
+ - **UI 会话 reload 后重连失败**
32
+ - **`/wx autostart on` 在非提升用户下失败**, 改用当前用户注册表启动项
33
+ - Task Scheduler 方案有两层问题: 完整 `/TR` 命令 787 字符, 超过 261 字符上限; 且当前非提升用户连创建 `notepad.exe` 任务都返回 `Access is denied`
34
+ - 改为写入 `HKCU\Software\Microsoft\Windows\CurrentVersion\Run`, 不需要管理员权限
35
+ - Run 项只调用短 PowerShell launcher, 由 launcher 以隐藏窗口启动 Node Gateway, 完整 launch payload 留在私有 manager 目录中
36
+ - 失败提示保留 `reg.exe` 返回原因, 不再吞掉底层错误; 配置失败会回滚
37
+ - **`/last` 误报「尚未产生回复」**: 最新一轮失败时改为显示真实错误原因
38
+
39
+ ### 新增
40
+
41
+ - **`/watch [--all]` 会话健康总览**
42
+ - 默认列出运行中、启动中、异常与断连会话, `--all` 包含空闲会话; 表格显示索引、标题、项目、当前状态与最后活动时间
43
+ - 从 transcript 最后一条 assistant 的 `stopReason` / `errorMessage` 归类失败, 可识别周 / 5 小时 / 月额度耗尽、TPM 限流、鉴权失败、服务不可用(503)、网络错误与中断; 上游提供重置时间时直接显示原时间
44
+ - 不依据 `heartbeatAt` 推断卡死: 该字段只在状态变化时写入, 不是周期心跳
45
+ - **Windows 登录后自动启动**(`/wx autostart on|off`), 默认关闭
46
+ - 使用已保存授权在登录时连接, 不在登录桌面前运行, 启动时不弹扫码窗口
47
+ - 授权失效时需先在本机执行 `/wx login`
48
+
49
+ ### 改进
50
+
51
+ - **微信端命令改为 markdown 表格与分段显示**. 实测确认微信支持表格、列表、加粗、行内代码与 `---` 分隔线; **单个 `\n` 会被渲染为空格**, 这是此前信息挤成一行的真因
52
+ - `/sessions`: 改为四列表格 + 项目汇总, 索引列去掉冗余 `#` 前缀; 移除页码参数, 一次展示所有符合筛选条件的会话
53
+ - `/status`: 纯文本字段堆叠改为两列键值表, 可见 UI 模式并入表格
54
+ - `/projects`: 改为三列表格, 默认项目加粗并补充登记命令提示
55
+ - `/new`、`/last`、`/resume`、`/help` 与跳过提示: 消除单换行导致的信息粘连, 标签与正文分段展示
56
+ - README 与实现说明同步更新会话列表展示方式与自动启动机制
57
+
58
+ ### 测试
59
+
60
+ - 新增 Windows 登录自动启动管理器测试, 覆盖 Run 项写入、launcher 生成与失败回滚
61
+ - 新增 `.mjs` daemon 入口断言: launcher 不传 Node TypeScript 参数, 且包含 `daemon-entry.mjs` 与 `--launch-payload`
62
+ - CI 新增 `Gateway npm bootstrap` 检查(Node 22 与 Node 26), 将包打成 tarball 解压到 `node_modules/` 后实际加载 daemon 垫片, 覆盖 npm 安装场景
63
+ - 全量测试 128 条, 125 通过 / 0 失败 / 3 跳过
64
+
65
+ ### 升级提示
66
+
67
+ - 从 0.1.x 升级后**需要重启 Pi TUI**, 让新扩展入口生效
68
+ - 若此前已开启自动启动, **需要重新执行一次 `/wx autostart on`**: launcher 中记录的是绝对路径, 旧 launcher 仍指向源码目录的入口
69
+ - npm 包内文件的安装位置发生变化时, 旧的 daemon 进程不会自动切换, 请执行 `/wx restart`
70
+
71
+ ## [0.1.1] - 2026-10-29
72
+
73
+ ### 修复
74
+
75
+ - 修复 0.1.0 的 npm 索引元数据异常
76
+ - 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` 因而查不到
77
+ - `0.0.0-stage` 已 unpublish 清除, 重新发布 0.1.1 以重建元数据
78
+
79
+ ## [0.1.0] - 2026-10-29
80
+
81
+ ### 新增
82
+
83
+ - 首个公开版本
84
+ - 微信远程下发任务, 由本机 Pi 执行, 结果回到微信
85
+ - 会话常驻: Pi TUI 全部关闭后仍可在微信继续对话
86
+ - 前后台自动交接: TUI 打开即接管, 关闭即交回后台, 始终只有一个 writer
87
+ - 多项目多会话管理与稳定数字索引
88
+ - `/last` 只读回顾最近一轮对话, 不调模型不耗 token
89
+ - 授权根目录白名单与 fail-closed 命令处理
90
+ - AGPL-3.0 许可证与安装文档
91
+
92
+ [未发布]: https://github.com/yangfeng20/pi-wechat-session-hub/compare/v0.1.2...HEAD
93
+ [0.1.2]: https://github.com/yangfeng20/pi-wechat-session-hub/compare/v0.1.1...v0.1.2
94
+ [0.1.1]: https://github.com/yangfeng20/pi-wechat-session-hub/compare/v0.1.0...v0.1.1
95
+ [0.1.0]: https://github.com/yangfeng20/pi-wechat-session-hub/releases/tag/v0.1.0