@yanglaofish/fishtools 0.5.2 → 0.6.0

package/manual/docs/superpowers/plans/2026-10-13-global-plugins.md

@@ -0,0 +1,56 @@
+# 用户级共享插件库实施计划
+
+> **For agentic workers:** REQUIRED SUB-SKILL: 使用 superpowers:executing-plans 在当前会话逐项实施；完成后按 code-review 技能进行两轴独立评审。
+
+**Goal:** 用户安装或链接一次插件后，普通工作区均可使用，且不会因另一个工作区缺少插件配置而无法启动。
+
+**Architecture:** workspace 负责共享库路径、登记工作区及跨工作区引用查询，复用现有安装批次、锁、租约与恢复备份。core 合并预置、旧工作区及全局插件并管理待配置状态；CLI 默认接入共享库，分发包保持独立。
+
+**Tech Stack:** Node.js、ESM、npm workspaces、node:test；不新增第三方依赖。
+
+**Spec:** docs/superpowers/specs/2026-10-13-issue-5-results-and-history.md
+
+## Global Constraints
+
+- Node 支持范围为 `^22.22.2 || >=24.0.0`，Windows 与 Linux 均验证。
+- 普通 CLI 默认使用 `FISHTOOLS_HOME/plugins`；未配置 FISHTOOLS_HOME 时为用户主目录 `.fishtools/plugins`。
+- 插件配置、工作流和代理规则保存在当前工作区。
+- 原有业务文件和历史插件状态不迁移、不删除；安装状态切换保留前一份备份。
+- 分发包不加载宿主全局插件；不放宽固定便携运行时的校验。
+- 文档、注释和用户界面使用中文。
+
+## Review Focus
+
+- 多工作区同时变更：统一共享库锁，旧状态写入被拒绝。
+- 全局插件必填配置缺失：只停用相关插件及消费者，其他动作可正常调用。
+- 旧本地版本与全局版本同名：全局优先；全局卸载不复活旧版本。
+- 其他工作区仍引用插件：默认拒绝卸载；明确强制卸载仍保留恢复状态。
+- 离线分发与热重载：包内快照独立；开发监听包含全局链接及登记状态。
+
+### Task 1：共享登记与跨工作区安装
+
+**Files:** 创建 `packages/fst-workspace/src/plugin-registry.js` 与 `tests/global-plugins.test.js`；修改 workspace exports、core application、CLI。
+
+**Interfaces:** `userPluginRegistry()` 返回用户库绝对路径；`registerWorkspace(registryDir, projectDir)` 原子登记路径；`registryWorkflowReferences(registryDir, pluginId)` 返回带工作区路径的实际引用。`createApplication({pluginRegistryDir})` 接入共享库并兼容本地安装。
+
+- [x] 新增真实双工作区测试：共享 link/install、配置隔离、旧版本优先级、跨工作区引用与并发状态。
+- [x] 运行 `node --test tests/global-plugins.test.js`，确认功能缺失导致失败。
+- [x] 实现双范围锁、租约、安装状态切换与来源元数据；全局删除记录旧版本屏蔽项。
+- [x] 同一测试命令及现有安装/租约回归通过后提交。
+
+### Task 2：配置、来源提示与开发监听
+
+**Files:** 创建 `packages/core/src/plugin-catalog.js`；修改 application、TUI presentation/session、development watcher；扩充 global-plugins 与 development-watch 测试。
+
+**Interfaces:** `preparePluginCatalog(entries, config, globalIds)` 返回 `{active,pending}`；待配置项保留作者声明与具体原因。`app.pluginDefinition(id)` 返回可用或待配置的原始声明。
+
+- [x] 新增全局插件缺少必填配置、有 runtime 消费者及配置恢复的失败测试。
+- [x] 实现待配置目录、动作调用明确错误、配置后激活与保存失败恢复。
+- [x] 添加全局链接源码监听与两种来源文案的实际回归。
+- [x] 运行全局、runtime、TUI、开发监听测试并更新使用文档。
+
+### Task 3：发布验证
+
+- [ ] 构建新的唯一 npm 归档，在支持版本和 issue 报告版本上执行真实安装与运行。
+- [x] 按固定基线 `46a897450e122054dcfab882de5be061b311570f` 执行 Standards 和 Spec 两轴评审，修复有效发现。
+- [ ] 提交、推送 main 与 v0.5.3，等待发布完成并核对 npm 版本、归档完整性和 GitHub 资源。

package/manual/docs/superpowers/plans/2026-10-13-tui-readable-sessions.md

@@ -0,0 +1,21 @@
+# 0.5.3：可读执行详情与完整会话
+
+用户本轮确认需要：步骤附近的展开入口、能看懂的指令/文件/结果、主面板计时、恢复完整 TUI 会话、TUI 内平台提示，以及 `!ipconfig` 中文输出修复。本轮集中合入 0.5.3，现已发布，见[验收记录](../../verification.md)。
+
+## 设计
+
+- 主面板保留逐步摘要，在运行及步骤附近提示 Ctrl+O。展开后按插件的字段标题展示输入输出，JSON 文本可读化；原始 JSON 仍可在单步详情按 j 查看。
+- 受管 `runProcess` 记录实际程序路径、逐项参数、执行目录；插件目录按真实声明记录。内核无法观察插件绕过该接口执行的任意代码，不猜测其文件访问。
+- 主面板和单步阅读器显示运行开始至结束的耗时，执行中每秒更新，结束后固定；界面关闭时取消刷新计时器。
+- 平台与架构声明提示在 TUI 启动后显示；命令行入口仍使用 stderr。已知声明不匹配继续作为提示，不把它伪装成已确认的运行失败。
+- `/history` 独立保存 TUI 命令、反馈与运行关联，支持恢复并继续；运行日志仍保留全文。会话追加记录按页读取，当前面板内存保留有界摘要。恢复不会重新执行历史指令或覆盖旧会话。
+- 会话保存在所属工作区，可写便携工作区同样支持；只读包使用可写输出位置。首轮无需加密或压缩，不引入密钥管理和启动密码。
+- Windows Shell 中文输出先真实复现，采用子进程范围内的编码修正，保持原始命令、多行、管道、重定向和取消行为。
+
+## 实施与验证
+
+- [x] 先补步骤呈现、真实进程追踪、计时及 TUI 平台提示的失败测试，再实现。
+- [x] logs 增加会话存储与分页，覆盖重开、竞争、归属、坏记录、链接及预算；TUI 接入保存恢复并验证输入、反馈、结果。
+- [x] 实际执行 Windows `ipconfig` 验证中文，同时覆盖 Shell 自身输出及已有命令回归。
+- [x] 进行独立 Standards / Spec 增量审查，修复有效发现并验证；两轴终轮均无剩余阻塞问题。最终归档完整验收与发布结果记入验收记录。
+- [x] 推送后等待两平台及 Node 支持范围的正式发布验收，核对 npm 和四个 Release 附件。公开 npm 与实测包逐字节一致；便携包由 CI 实际运行并核对 GitHub 服务端摘要，本机未完成的下载单独记录。

package/manual/docs/superpowers/reviews/2026-10-13-0.5.3-review.md

@@ -0,0 +1,28 @@
+# 0.5.3 代码审查
+
+固定基线 `46a897450e122054dcfab882de5be061b311570f`；两名独立评审分别阅读 `e4143e819f02d391497b711bfca98f955567f2d6` 的 Standards 与 Spec 轴。来源为 issue #4 正文/评论/截图、issue #5 正文/截图及用户确认的普通安装全局范围。评审只读，不写用户插件库。
+
+## Standards
+
+1 项硬规范问题，最高 P2：旧批次的租约释放仅查看新目录记录，未检查定向更新后宿主实际仍使用的旧 root。违反插件开发文档“活动代码由批次租约保护”。未发现需要单独报告的判断性气味。
+
+## Spec
+
+3 项，最高 P1：
+
+- P1：上述租约问题，可能使 GC 回收正在使用的资源。
+- P1：其他工作区调用本地消费者，而消费者依赖全局提供者时，直接工作流前缀扫描漏掉依赖。
+- P2：被全局覆盖或屏蔽的旧链接仍先导入，旧源码移走后会阻止工作区启动。
+
+两轴共有 3 个不同问题，已全部修正，分别保留各轴原优先级。
+
+## 修复与证据
+
+- 租约判断使用活动宿主及目录记录的路径并集。真实 npm 安装探针在关闭 npm 锁文件时先复现 GC 删除活动目录，再确认连续更新/回收后资源仍可读取。
+- 全局卸载增加已登记工作区插件依赖扫描，其他工作区的本地消费者同样受保护，force 不绕过此保护。探针先出现“没有拒绝卸载”，修复后正常/强制卸载均被拒绝。
+- 旧安装在导入前按全局 ID 和屏蔽项过滤；移动旧源码后，覆盖版本正常执行，卸载后的新启动仍正常。修复前为 ENOENT，修复后通过。
+- 额外自检发现待配置目录会跳过原宿主静态校验；提取统一 `validatePluginDefinitions`，待配置插件仍检查 SDK、依赖、动作函数与服务图。无效 SDK 探针先未被拒绝，修复后三种无效声明均被拒绝。
+- 上述修复与 runtime、TUI、开发重载相关回归：71 项通过，0 失败。
+- Windows/Node 22.12.0 再次导出多次出现退出码 3221225477；切换原生进程调用及禁用 JIT 后仍复现，没有归因为已证实的内核逻辑问题。22.22.2 和 24.11.1 同一测试通过，产品支持声明同步收敛到实际验证范围。
+
+最终完整测试、归档安装与发布结果见 `docs/verification.md`。

package/manual/docs/superpowers/reviews/2026-10-13-command-shortcuts-review.md

@@ -61,3 +61,10 @@ TUI 列表每个工作流只枚举一次，选择后进入管理页复制；原
 
 合入后重新构建的本地 npm 归档为 **9,806,640 字节、285 个生产包**；指定该归档完整验收 **489 项：487 通过、0 失败、2 跳过**，186.3 秒。
 待发布 tag 更新前再次核对注册表无该版本、仓库无该 Release，以及旧 tag 对象，避免覆盖已发布版本。
+
+## 正式发布结果
+
+[最终发布流程](https://github.com/yanglaofish/Fishtools/actions/runs/38361266757)全部成功，Windows / Ubuntu 同一归档各 **488/489 通过、0 失败、1 项平台专用跳过**。
+两平台便携包、无 Node 的断网只读容器及普通主分支 CI 通过。
+最终 tag 固定于 `fdb62c1`；npm `latest` 为 0.5.2，独立下载包的 SHA-512 与注册表 integrity、SHA-256 与 Release 均一致。
+详细字节数、校验值和四个附件见[验收记录](../../verification.md)。

package/manual/docs/superpowers/reviews/2026-10-13-tui-sessions-review.md

@@ -0,0 +1,57 @@
+# 0.5.3 可读详情、会话恢复与中文命令审查
+
+固定基线 `9cc912f965a1e9fd23924c3aa107077a464f6307`；生产实现及修复至 `3ce925221f7ba8fe4eacf1fb33e536ef60f4c810`。两名独立评审按 code-review 分别检查 Standards 与 Spec，互不合并优先级。规格来自本轮用户确认及[实施计划](../plans/2026-10-13-tui-readable-sessions.md)。
+
+## Standards
+
+各轮共确认 4 项问题，最高 P1，已修正：
+
+- P1：完成的运行等待对象仍持有完整大结果。结束后移除等待句柄，仅保存 logs 提供的有界最终投影。
+- P2：大结果从内核缓存淘汰后，详情计时器仍反复查询空缓存。使用最终摘要或磁盘记录更新，并清理计时器。
+- P2：终态事件早于日志收尾，详情先停止刷新，缺少最终结束时间。完成监听补充真实结束时间及最后的保存状态。
+- P2：每次查看长任务都向未完成 Promise 注册页面闭包，关闭页面仍被保留。改为可注销的完成监听，退出页面及关闭 feed 时清理。
+
+最后增量复核：硬规范违反 0 项，判断性代码气味 0 项，本轴没有阻塞发布的发现。评审独立执行 17 项定向测试，全部通过。
+
+## Spec
+
+复核确认 2 项 P2，已修正：
+
+- 日志收尾失败时，内核已变为 `failed / LOG_WRITE_FAILED`，主面板和恢复快照仍显示成功。拒绝分支同步最终状态、错误及结束时间，并保存最终会话反馈。
+- 恢复快照遮住 `/logs` 已读出的磁盘记录，旧摘要显示未知状态或省略正文。历史详情优先采用当前或传入的磁盘记录；格式化阅读返回后重新读取当前状态。
+
+完整参数保存也按用户范围补齐：直接动作、插件命令及工作流将 `run.input` 全文写入执行日志；主面板、恢复快照与命令历史保持预算，完整交互仍可分页查看。配置表单不纳入输入历史。
+
+最后增量复核：剩余阻塞发布问题 0 项；完成监听、关闭注销及磁盘记录优先级均通过独立只读探针。
+
+## 修复证据
+
+- 真实 Windows TUI 命令处理路径执行 `!ipconfig`、`!ipconfig /all`：均成功，显示 `Windows IP 配置`，替换字符 0 个。stdout 流与同次返回正文一致，保存真实 System32 程序追踪。自动编码适配限于简单 ipconfig 调用，不宣称所有遗留程序均能自动识别编码。
+- 日志收尾失败通过实际创建 `result.json` 目录触发；修复前面板成功，修复后失败与 `LOG_WRITE_FAILED`、最终时间及会话记录一致。
+- 控制终态广播与收尾间隙，验证最终 4.2 秒补到已打开页面；旧页关闭后收尾不会更新另一次运行。
+- 长任务连续开关详情 10 次，真实 `--expose-gc` 回归修复前保留 10 个阅读器，修复后 0 个。
+- 恢复时旧快照标记未知，磁盘保存成功状态、真实时间和 4000 字中文；修复前被遮住，修复后完整展示。
+- 长命令追加分块不拆开 emoji 代理对；同页阅读拼回原文不插入额外换行。
+- 最终相关 Windows/Node 24.15.0 回归 27/27，Node 22.22.2 包括中文命令及 GC 回归 34/34，零失败、零跳过。
+
+最终完整测试、支持版本兼容验收及正式发布产物见[验收记录](../../verification.md)。
+
+## 正式验收发现的兼容问题
+
+- Windows / Node 24.0 的首次发布验收出现日志文件身份误判。官方 [24.0.0 源码](https://github.com/nodejs/node/blob/v24.0.0/deps/uv/src/win/fs.c) 的路径查询使用 64 位卷编号，句柄查询只提供低 32 位；[24.11.1 源码](https://github.com/nodejs/node/blob/v24.11.1/deps/uv/src/win/fs.c) 已把路径查询统一为 LowPart。修复用 BigInt 保存完整文件 ID，在 Windows 比较卷编号低 32 位，其他平台仍比较完整设备编号；继续拒绝链接及访问期间的文件替换，不放宽读取预算。
+- 这项源码差异是失败原因的推断，首次失败任务没有记录原始 stat 值；修复后新增真实文件诊断，必须由同一 CI 平台复跑确认。低 32 位卷编号和完整文件 ID 同时碰撞时无法区分身份，不能宣称拒绝所有异卷。
+- 本地 Node 24.0 与 24.15 相关日志、会话及详情回归各 42 项：41 通过、1 项平台用例跳过。针对该增量，两名独立评审均无阻塞发现；Standards 硬规范违反与判断性气味均为 0，Spec 范围扩张为 0。
+- 本地 Node 24.0 完整回归另有一项共享打包缓存校验失败。旧实现命中有效缓存仍截断重写，并发读取可能得到半成品；缓存最终摘要正确，独立重跑打包 2/2 通过。新增有效缓存不重写的断言先失败，修复后只读命中缓存，冷缓存和自定义运行时校验后使用唯一暂存文件原子替换，许可证缓存也采用原子写入。固定 SHA 校验及损坏缓存拒绝行为保留。
+- 缓存修复与文件身份修复的 Node 24.0 定向回归 7/7 通过；缓存增量独立审查、最终完整回归及正式发布复跑结果见验收记录。
+- 冷缓存并发回归又在 Windows / Node 24.15 复现同目标 rename 的 EPERM，Standards 独立探针也确认。最终仅在 Windows 的 EPERM/EACCES/EBUSY 且目标内容完全相同时接受已胜出的完整缓存；不同、缺失、不可读目标及其他错误仍传播。追加真实替换失败、保留原目标及清理暂存的断言，缓存最终回归在 Node 24.0 和 24.15 各 4/4 通过。
+- 缓存最终增量复核：Standards 硬问题 0、判断性气味 0，Spec 阻塞 0、范围扩张 0。Standards 独立执行 6/6 定向测试，并用只读目标制造真实 EPERM，确认仅相同内容可接受，错误分支保留目标并清理暂存；Spec 探针另外确认目标不可读及其他错误保留原始错误。此前并发替换阻断已解除，完整矩阵继续作为正式发布门禁。
+
+## 真实 Windows 24.0 文件身份与 Web 等待期限补充
+
+- 固定增量基线 `0cb40f3eb8928860c8290055d4e8626399ae5300`。第二次发行验收仍拒绝 Windows / Node 24.0 的合法日志，真实诊断记录路径 `dev=0`、句柄 `dev=742408122`、完整 `ino=7036874418249441`；此前低 32 位宽度推断不能单独解释该事实。
+- 回归先确认缺失路径设备号时的合法文件会被拒绝，再增加受限补充验证：只在 Windows 的路径设备号未知且完整文件 ID 相同时，重新只读打开当前路径，以两个句柄完整 BigInt 身份证明同一文件，最后重新拒绝链接和路径替换。句柄始终关闭；原普通文件、归属、大小及读取预算检查保留。
+- 新增真实替换文件、同一原文件链接及不同设备/文件 ID 拒绝探针，链接创建无权限时明确跳过。Windows Node 24.0、24.11.1、24.15.0 定向回归各 54 项：52 通过、0 失败、2 项链接权限跳过；真实 CI 文件系统还需定向复跑确认。
+- Windows / Node 24.11.1 的 Web 测试过早结束轮询，任务仍为 running。仅调整为 10 秒明确期限，原成功状态、输出、鉴权及路径断言保留；不修改产品执行逻辑。CI 新增 Windows 早期 Node 定向门禁，原全量矩阵保留。
+- Standards 独立复审：硬问题 0、判断性气味 0；Spec 缺失需求、范围扩张、错误实现均为 0。Spec 的 16 个只读边界探针通过，包含实际诊断值、异设备高位、替换、链接及异常清理。实际失败文件系统定向 CI 和完整发行矩阵仍作为发布门禁。
+- 后续 CI 环境变量移至步骤级的增量独立复核：两轴均无新增问题。最终主分支六组检查通过，Windows 24.0/24.11 专项各 54/54；Windows 24.0 真实路径设备编号仍为 0，与主句柄完整身份补证成功。最终发行八组各 586 项、零失败，便携包与断网只读容器通过；详见[验收记录](../../verification.md)。
+- 0.5.3 已完成正式发布；公开 npm 包与上述实测归档逐字节一致，Release 四个附件齐全。npm 后台处理超时后仅续跑发布任务完成同步，发行源提交保持 `047a202fb92de100104f689014bb831283e1f00b`。便携包本机下载未完成，采用 CI 运行验收和 GitHub 实际文件摘要核对，具体方法如实记入验收记录。

package/manual/docs/superpowers/reviews/2026-10-14-0.6.0-release-review.md

@@ -0,0 +1,19 @@
+# 0.6.0 发布复核
+
+基线 `v0.5.3`，范围为之后的源码与发布前修正。需求依据为 `docs/plans/` 的插件默认参数、有效输入与表格、能力发现与历史、业务报告、受管执行及 #6–#11 处理记录。用户授权推送和发布；保留必要 CLI、以 TUI 为主，不新增内置剪贴板、不修改插件源码、不提交用户业务结果。
+
+## Standards
+
+发布复核发现两项文档问题：参数继承仍标本地未发布；删除工作流错误承诺一律备份。已分别标为 0.6.0 起及明确“备份后删除／直接删除”的恢复区别。模块入口、依赖和代码职责未发现发布阻断。修正后复核遗留 0 项。
+
+## Spec
+
+用户提供的 #9 复核先完成真实失败回归：单个输入框关闭会遗忘未回收进程预算。现由整个终端共享探测器，provider 仅取消自己的请求；终端退出后检查有界关闭报告，终端状态恢复后才报未回收错误。
+
+整体复核补充两项 P2：已知故障插件版本不满足健康消费者要求时仍须拒绝；运行详情输入不能把 JSON 形态字符串解码成布尔或对象，且不能丢弃显式 null。均经历新增失败回归、修正、通过与独立复核。输出继续使用可读化展示。
+
+修正后 Spec 可行动发现 0 项，遗留阻断 0 项，范围扩张 0 项。#6 仍需插件显式声明敏感参数，#11 现场验收待办不冒充已完成。
+
+## 验证职责
+
+审查与全量测试独立进行。完整测试、归档安装及远端多平台发布门禁的实际结果统一记录在 `docs/verification.md`。本次审查不等于已完成跨机真实插件业务验收。

package/manual/docs/superpowers/specs/2026-10-13-issue-4-workflow-menu.md

@@ -26,3 +26,26 @@ Windows 路径诊断使用 `C:\PROGRA~1` 实际执行，Shell 输出 `C:\Program
 
 补充范围 `8223bad...c567534` 的独立 Standards 与 Spec 复审均通过，新增确认问题均为 0。
 合入后的真实 npm 归档为 9,806,640 字节、285 个生产包；完整本地验收 489 项：487 通过、0 失败、2 跳过，186.3 秒。
+
+正式 0.5.2 已包含本修正：[发布流程](https://github.com/yanglaofish/Fishtools/actions/runs/38361266757)成功，两平台各 488/489 通过（1 项平台专用跳过）、零失败，便携包与断网容器通过。
+npm `latest` 为 0.5.2，独立下载公开包与注册表、Release 的校验值一致；tag 固定于 `fdb62c1`。
+
+## 0.5.3 补丁：安装版本与准确提示
+
+固定基线 `46a897450e122054dcfab882de5be061b311570f`，分支 `codex/issue-4-node-compat`。
+用户授权“现在就改吧，改完就发，这算是小补丁”，随后要求同步审查整个 TUI 是否过度提醒，只显示准确的信息。
+
+### 新评论与核对结果
+
+- [6141074515](https://github.com/yanglaofish/Fishtools/issues/4#issuecomment-6141074515)：Node 24.11.1 安装 0.5.2 出现多条 `EBADENGINE`。日志最终显示安装成功；根包和实际捆绑的 npm 工具链均有更高的 Node 下限，不能只降低根包声明或隐藏警告。
+- [6141125892](https://github.com/yanglaofish/Fishtools/issues/4#issuecomment-6141125892)：没有修改时不应提示未保存修改或草稿；删除时由用户决定是否备份。
+- [6141135420](https://github.com/yanglaofish/Fishtools/issues/4#issuecomment-6141135420)：通过 GitHub 已授权的附件地址实际读取截图，确认已保存工作流仍显示包含未保存修改、保留草稿和预定备份。上方 0.5.2 历史记录中的图片 404 对应较早评论，不代表这次截图未读取。
+
+### 采纳范围
+
+1. 支持 Node `^22.22.2 || >=24.0.0`，选择实际兼容且有维护版本的生产依赖；测试 22.22.2、24.0.0 和 24.11.1 的严格离线安装与实际执行。便携包固定运行时不变。
+2. 工作流提示与当前草稿相对已保存快照的差异一致；仅查看、原样完成和还原修改不制造草稿。新建未保存流程仍准确提示草稿。
+3. 删除已保存工作流时提供取消、备份后删除、直接删除；默认取消。备份保存已保存文件原文；明确说明未保存修改会放弃。无文件的草稿只丢弃或取消。
+4. 原样完成插件配置、日志保留、代理规则/配置、命令注册与快捷名称编辑不写配置、不备份、不重启；真正修改仍执行原有保护与维护确认。
+5. TUI 其他提醒根据实际状态或影响显示：默认值须有声明、取消入口须仍在运行、失效引用须真实存在、打包保存提示须与所选流程闭包相关。保留实际权限不足、维护重启、受引用插件移除、运行错误与日志写入失败的提醒。
+6. 保持现有工作流、SDK 和默认 API 备份行为；此次为 0.5.3 补丁，完成双轴代码审查及验证后推送、发布。

package/manual/docs/superpowers/specs/2026-10-13-issue-5-results-and-history.md

@@ -0,0 +1,20 @@
+# Issue #5：插件范围、生成文件与执行记录
+
+来源：[发现严重缺陷](https://github.com/yanglaofish/Fishtools/issues/5)。已读取正文、完整评论列表（当前无评论）以及私有附件截图；截图确实显示 `environment-report.md/json` 保存到工作区 `.flow/runs/运行ID/`。
+
+## 事实与修改范围
+
+- 用户确认普通安装应全局可用。CLI/TUI 默认安装和链接到用户级插件库，普通工作区自动读取同一份插件版本。工作流、插件参数、代理规则和运行状态仍由各工作区保存。
+- 已有工作区安装兼容读取；同名全局插件优先。全局卸载后不自动复活旧工作区同名版本。未配置的全局插件显示“待配置”，不能阻止无关工作区启动。卸载检查已登记工作区的工作流引用，原插件状态保留恢复备份，活动安装批次由租约保护。
+- 离线分发包继续使用包内代码快照及其可写工作区，不读取机器上的全局插件库。程序调用 `createApplication` 可通过 `pluginRegistryDir` 接入共享库；未传时保留原有工作区安装兼容行为。
+- 插件 `ctx.outputDir` 与日志目录相同是实际问题。新增真实插件探针保存 `result.json` 时，业务文件会被内核的同名记录覆盖；这构成数据覆盖风险。
+- 新运行的业务文件改为工作区 `results/运行ID/`，每次运行独立；日志继续在 `.flow/runs/运行ID/`。显式 `--output` 或 `FLOW_OUTPUT_DIR` 的日志路径保持兼容，业务文件放到其 `files/运行ID/`。只读运行包使用可写输出目录。
+- `ctx.outputDir` 继续表示可写业务输出目录，新增 `ctx.logDir` 明确日志路径；`app.outputDir` 继续指向日志根，`app.resultsDir` 表示业务结果根。插件仍须通过返回值或 `print()` 报告文件路径。
+- 不移动、覆盖或删除历史目录与业务文件；日志保留策略继续只清理日志，不清理新业务结果。只移除本次创建且保持为空的结果目录。
+- 暂无重复运行记录的证据：真实工作流内嵌子工作流和插件动作仍只生成一条顶层记录。原列表混列不同入口且没有会话标识，确实难以区分。
+- 新记录保留执行类型、名称与应用启动会话。TUI 标明四类入口及本次/历史启动，支持筛选本次启动、工作流、插件调用或系统命令；默认显示最近 20 条，可继续加载。旧记录可读，按旧目标标识推断类型，不推断未知会话。
+
+## 验证
+
+先补失败探针，确认业务文件与日志隔离、同名文件不覆盖、日志清理保留结果、空目录回收、嵌套调用不重复记录、类型与会话在重启后持久可读、TUI 筛选准确。
+修改后覆盖原有日志写入失败注入、实时落盘、保留策略与 TUI 会话回归。日志故障注入明确操作 `logDir`，不再通过业务输出同名文件模拟故障。

package/manual/docs/terminal-commands.md

@@ -6,6 +6,8 @@
 
 Windows 默认使用 Windows PowerShell，Linux 默认使用 sh。命令按照所选 Shell 的语法解释；管道、引号、重定向和换行保持原样。此入口适合无需交互输入的命令，暂不接管需要 stdin 或全屏界面的程序。
 
+Windows 自动模式下，简单单行 `!ipconfig`、`!ipconfig /all` 使用系统程序及其 OEM 编码，中文输出可以直接在主面板阅读，不改变主终端编码。含管道、展开或重定向的复杂脚本继续按 PowerShell 语法执行；其他程序仍保留 UTF-8 输出，不能把整个混合脚本统一按 GBK 解释。当前自动适配支持系统代码页 866、874、932、936、949、950、65001，其他代码页沿用原 Shell。
+
 ## 多行编辑
 
 | 按键 | 行为 |
@@ -31,6 +33,8 @@ Windows PowerShell 请使用其续行符反引号或括号语法，也可粘贴
 
 输入 `/commands` → **注册常用命令**，填写名称和命令文本，选择保存即可。名称合法时自动建立同名快捷入口。例如 Linux 中注册“查看本机IP”，文本填 `ifconfig`，以后输入 `/查看本机IP` 就能运行。目标机器需已经安装 `ifconfig`；也可注册机器实际具备的 `ip address` 或 Windows `ipconfig`。
 
+编辑已有命令或快捷名称后，内容没有变化时直接返回，不创建备份、不重启插件；已有命令未设置快捷名称时也不会自动补上。只在新注册命令时按合法名称建立默认快捷入口。
+
 高级设置可选择 Shell、超时时间、参数及 Linux root 权限要求。超时时间为秒，`0` 表示不限时。root 需求会在执行前检查，工具不会自动提权。修改命令仍保留原有动作 ID，已保存工作流继续引用它；被工作流使用的命令不能直接删除，需先调整引用。
 
 不填写参数时无需编写输入 schema，也不会弹出空 JSON 输入框。需要参数时添加简单字段（文本、数字、是/否，可设置默认值及必填），脚本通过环境变量读取：
@@ -59,6 +63,10 @@ Write-Output $env:FST_INPUT_name
 
 常用命令和快捷名称保存在 `flow.project.json` 的 `commandPresets`、`shortcuts` 字段。修改前原文件备份到 `.flow/backups/`，同一字段被其他实例改动时拒绝覆盖并提示重新打开工作区。
 
+`/logs` 中每次顶层执行只有一条记录，标明工作流、插件动作、插件命令或系统命令，可筛选本次启动的执行或某类调用。条件、并行和子工作流的内部步骤放在同一条运行记录里；菜单浏览及本次 TUI 命令历史不会产生持久化运行记录。旧记录继续可读，没有会话标识的旧记录不冒充本次启动。
+
+输入与反馈另外保存为 TUI 会话：`/history` 可恢复并继续，或分页阅读完整交互；不会重跑历史指令。工作区内 `.flow/sessions/` 保存快照与追加日志，只读包保存到可写日志目录下。恢复近期面板和命令历史，较大结果和完整指令执行过程从 `/logs` 读取；在详情中按 m 格式化阅读，j 查看原始诊断。
+
 命令快捷项由界面同时保存 `command` 与目标 `plugin` 标识，以免同名能力接管入口；填写参数和确认权限后，执行前再次核对提供者身份。配置 API 可为新建或改变目标的快捷名补齐当前提供者；手工导入却未提供 `plugin` 的旧项需重新选择目标，修改名称、默认参数或保存其他设置都不会顺带启用它。保存或复制工作流草稿时也会核对最新注册项，避免另一实例删除命令后保存悬空引用。
 
 导出选定工作流时携带其使用的命令定义和相关快捷名称；便携工作台携带全部注册能力。导出后的可编辑工作区可修改并再次导出；只读运行包可以执行，不能修改。外部程序和 Shell 需由目标机器提供，不会因为注册命令就把它们包含在包内。

package/manual/docs/verification.md

@@ -1,5 +1,45 @@
 # 验收记录
 
+## 0.6.0 参数、报告与恢复（2026-10-14）
+
+- 发布范围为 `v0.5.3` 之后的本地演进，开发分支 `codex/plugin-defaults`。用户已明确授权修复、验证后推送并发布；本次包含参数继承、报告协议及受管执行等新能力，采用 0.6.0，后续小修继续使用补丁号。
+- 独立 Standards / Spec 发布审查发现文档承诺不准确、故障插件已知版本检查遗漏、运行详情输入字符串及 null 展示错误，均已修正并复核，两个维度各 0 项遗留问题。完整记录见[发布复核](superpowers/reviews/2026-10-14-0.6.0-release-review.md)。
+- 针对用户提供的 #9 后续 P2，使用真实阻塞子进程并模拟终止失败，确认旧输入框关闭会遗忘预算；改为整个终端共用一个探测器，未退出进程持续占预算。覆盖多次进入和取消、退出后重新取得名额、默认非注入路径共用探测器及最终关闭报告。相关终端及文件探测 203 项通过。
+- 首次发布全量遇到 `live-output` CLI 用例共享全局插件库而争锁；该用例改为独立临时 `FISHTOOLS_HOME`，保留退出码及结果断言，不放宽生产锁。输入详情和相关运行回归 38 项通过，随后显式 null 补充回归 18 项通过。
+- `npm run dist:npm` 构建成功，本地归档为 `dist/yanglaofish-fishtools-0.6.0.tgz`，9,913,943 字节，284 个生产包。构建时第三方 `use client` 指令提示不影响完成；未修改插件源码。
+- TUI 为主交互入口，保留必要 CLI；复制沿用终端原生能力，不新增内置剪贴板功能。#11 的真实插件本机闭环已有记录，跨机业务离线验收、首次用户体验及真实 NFS/SMB 故障场景仍待现场验证。发布流水线的容器与便携包测试不能替代这些验收。
+- 最终完整测试使用上述实际 npm 归档：694 项，691 通过，0 失败，3 项既有 Windows 条件跳过，约 202 秒；日志为 `.cache/release-0.6.0-final.log`。`git diff --check` 与 `node scripts/release-info.mjs v0.6.0` 通过。远端发布结果完成后补充，不提前宣称 npm 已发布。用户 `flow-results/` 保持未跟踪，不纳入提交或分发。
+
+## 0.5.3 全局插件、结果保护与准确提示（2026-10-13）
+
+- 分支 `codex/issue-4-node-compat`，固定基线 `46a897450e122054dcfab882de5be061b311570f`；读取 issue #4 正文、评论及截图和 issue #5 正文及截图，采用用户确认的普通插件全局安装范围。
+- 实际复现业务 `result.json` 被内核记录覆盖，新增独立 `results/运行ID/`，日志保留只作用于日志；类型、名称及启动会话随执行记录保存，嵌套调用仍只生成一条顶层记录。历史业务文件没有移动或删除。
+- 全局安装和开发链接在多个工作区共享，参数仍由工作区保存；配置缺失只影响对应插件及其消费者。测试覆盖并发状态、跨工作区引用、待配置启用、全局开发监听和离线分发隔离。
+- TUI 全面核对工作流脏状态、备份删除、无实际修改的配置保存、默认值、完成任务取消入口及草稿打包提示。只保留与实际状态相符的提醒。
+- Standards / Spec 两轴独立审查共确认 3 个不同问题，均补失败探针后修正：活动旧安装目录的租约、跨工作区本地消费者的间接依赖、被全局覆盖或屏蔽的旧源码导入。额外自检统一待配置项静态校验；相关回归 **71/71** 通过，详见[审查记录](superpowers/reviews/2026-10-13-0.5.3-review.md)。
+- 全局插件阶段 `npm run dist:npm` 成功，本地归档 **9,825,324 字节、284 个生产包**。Windows/Node 24.15.0 完整测试 **536 项：534 通过、0 失败、2 跳过**，201.7 秒，使用该阶段归档验证离线安装、脱离源码运行及再次导出。
+- Node 22.12.0 的 Windows 再导出试验多次出现原生进程崩溃，没有确认其底层原因；22.22.2 与 24.11.1 的同一测试通过。产品声明为 `^22.22.2 || >=24.0.0`，便携版仍固定使用经过 SHA 校验的 Node 24.15.0。
+- 验收脚本适配 npm 11.19.1 发布预演按包名返回的 JSON；实际安装仍使用 `--engine-strict`，不放宽不兼容依赖检查。完整兼容验收与正式发布结果完成后追加。
+- 后续合入用户要求的可读步骤、指令追踪、结果渲染、面板计时、完整会话恢复、TUI 内平台提示和 Windows 中文 ipconfig。独立 Standards / Spec 复核均无剩余发布阻塞问题，详见[增量审查记录](superpowers/reviews/2026-10-13-tui-sessions-review.md)。
+- 实际 TUI 处理路径执行 `!ipconfig` 与 `!ipconfig /all` 均显示中文，替换字符 0 个，stdout 流与同次返回正文一致。日志收尾失败、历史磁盘优先及关闭页面内存回收均经历失败复现再修复；最终相关回归 Node 24.15.0 **27/27**、Node 22.22.2 **34/34**。
+- 可读会话阶段完整回归 **576 项：574 通过、0 失败、2 跳过**，185.4 秒；后续历史优先及 GC 专项修正通过上述定向回归。正式发布从最终提交重建同一归档，在支持的平台和 Node 版本执行完整验收后才上传 npm。
+- 首次正式发布验收的 Windows / Node 24.0 出现日志文件身份误判，调查发现官方源码中路径和句柄查询的卷编号宽度不同；其余 7 组完整兼容验收及双平台便携包通过，发布步骤跳过，npm 0.5.3 尚未上传。修复保持完整 BigInt 文件 ID，并统一 Windows 卷编号低 32 位；两轴独立复核均无阻塞。本地相关用例在 24.0 与 24.15 各 41 通过、1 跳过，正式原平台复跑待完成。
+- Linux 停止进程的测试探针遇到进程已退出但 `/proc` 读取返回 ESRCH 的竞争窗口；将 ESRCH 与 ENOENT 同样视为已退出，其余错误继续传播，存活及心跳业务断言保留。[四组主分支 CI](https://github.com/yanglaofish/Fishtools/actions/runs/38393256411) 已全部通过。
+- Windows / Node 24.0 后续本地完整回归 580 项：577 通过、1 失败、2 跳过；唯一失败为有效打包缓存仍被截断重写导致并发读到半成品。增加失败断言后修复为缓存命中只读、冷缓存先校验再原子替换，Node 24.0 定向 7/7 通过。最终完整验收及发布结果完成后追加，不把该次失败记录当作通过证据。
+- Windows 并发原子替换的 EPERM 经独立探针复现并修正，仅接受目标完整内容完全相同的胜出缓存，真实替换错误仍传播。最终缓存回归 Node 24.0 与 24.15 各 4/4 通过。
+- 缓存及文件身份修复后的最终本地 Node 24.0 完整回归 **584 项：582 通过、0 失败、2 跳过**，214.9 秒。`dist:npm` 生成 **9,855,545 字节、284 个生产包**的本地归档，完整测试使用该归档执行离线安装与再次导出；最终文档归档后正式发布流程会从 tag 重新生成并对同一发行归档执行完整矩阵。
+- [第二次正式验收](https://github.com/yanglaofish/Fishtools/actions/runs/38397457051)中，其余 6 组兼容验收与双平台便携包通过，发布步骤仍跳过。Windows / Node 24.0 的真实诊断为路径设备编号 `0`、句柄设备编号 `742408122`，完整文件 ID 同为 `7036874418249441`；因此此前卷编号宽度推断不足以解释此平台失败。新增第二个只读路径句柄，严格比较两个句柄的完整 BigInt 身份，并重新检查路径仍为普通非链接文件；不把未知编号 `0` 当成通配符，原归属及读取预算继续生效。
+- 同次 Windows / Node 24.11.1 唯一失败为 Web 测试过早断言仍运行中的任务。只把约 600 毫秒的固定轮询改为 10 秒内等待真实结束；成功状态、输出、鉴权和路由断言保留。
+- 上述增量包含真实路径替换拒绝和链接拒绝探针。Windows 本地 Node 24.0、24.11.1、24.15.0 各执行同一组定向回归 **54 项：52 通过、0 失败、2 项文件链接权限跳过**。新增 Windows 24.0/24.11 定向 CI，保留原全量矩阵，真实失败文件系统及最终发行归档复验待完成。
+- 新增定向 CI 首次提交因 job 级 `env` 无法使用 `runner.temp` 而未启动测试；按 GitHub 官方上下文范围把隔离目录变量移至测试步骤级，不改变测试内容和原全量门禁，重新执行远端验收。
+- [最终主分支 CI](https://github.com/yanglaofish/Fishtools/actions/runs/38402152986)六组检查全部通过。Windows / Node 24.0、24.11 定向回归各 **54/54**，零失败、零跳过；24.0 实际路径设备编号仍为 `0`，句柄仍为 `742408122`，已覆盖原失败条件。
+- [最终正式发行验收](https://github.com/yanglaofish/Fishtools/actions/runs/38402983167)以源提交 `047a202fb92de100104f689014bb831283e1f00b` 重建同一 npm 归档。Windows、Ubuntu 分别在 Node 22.22.2、24.0.0、24.11.1、24.15.0 执行完整测试，八组均为 **586 项、0 失败**；每组 Windows 582 通过、4 跳过，Ubuntu 581 通过、5 跳过。两平台便携包、无 Node 断网只读 Linux 容器也通过。
+- 正式 npm 候选归档下载后 **9,855,227 字节**，SHA-256 `836bb95161f3ccab637d1f78c671312b4f9577b01fcfffa3fb930bf9177a3593`。用此归档中的真实 TUI 处理路径，在本机 Node 24.11.1 再次执行 `!ipconfig` 与 `!ipconfig /all`：均成功显示“Windows IP 配置”，替换字符 0，界面正文与同次完整 stdout 日志一致。公开 npm、Release 附件和最终校验结果完成后追加。
+- 最终流程的首次发布步骤中，npm 已接受 `@yanglaofish/fishtools@0.5.3` 上传并提示后台处理；五分钟后仍未对外可见，脚本按既有门禁退出，尚未创建 Release。保留该发行 tag 和原验收归档，待注册表可见且完整性一致后仅续跑发布步骤。
+- npm 对外可见且完整性与验收归档一致后，仅续跑发布任务；最终[发布流程](https://github.com/yanglaofish/Fishtools/actions/runs/38402983167)第二次执行成功，没有重跑已通过的测试或再次上传 npm。`latest` 为 **0.5.3**，公开 npm tarball 独立下载为 **9,855,227 字节**，SHA-512 与注册表一致，且与正式验收归档逐字节相同。
+- [GitHub Release](https://github.com/yanglaofish/Fishtools/releases/tag/v0.5.3)已公开，四个附件齐全。npm 归档和 `SHA256SUMS` 独立下载校验；两套便携包本机下载因网络缓慢未完成，未将其计为完整下载通过。便携包使用已通过的双平台运行验收，以及 GitHub 实际上传文件的服务端 SHA-256 与下载校验文件逐项匹配来核验：Windows **52,711,988 字节**，SHA-256 `94dae599c372b54347969258340d36bc46427a00a0dafde04b1a6fa64a9114b7`；Linux **58,213,807 字节**，SHA-256 `52b5ddbb33cc1c32dc2c3d49eb422bba87f7c286bc62ca15e5511163ca66e36a`。
+- 发行 tag 固定于 `047a202fb92de100104f689014bb831283e1f00b`；后续仅补充文档记录，不改变已发布产物。验证脚本分别记录本地字节校验和 GitHub 服务端摘要核验方式，未完成下载保留为临时备份，用户原有 `flow-results/` 没有移动或删除。
+
 ## 0.5.2 命令注册与快捷名称（2026-10-13）
 
 - 分支 `codex/0.5.2-command-shortcuts`，固定基线 `68a84cd`；按用户指定目标集中实现 `!` 系统命令、`/commands` 注册动作、`/shortcuts` 任意动作或命令的中文快捷名称与默认参数。
@@ -18,6 +58,13 @@
   合入后本地重建归档 **9,806,640 字节、285 个生产包**，指定该归档完整 `npm test` **489 项：487 通过、0 失败、2 跳过**，186.3 秒。
   补充范围 `8223bad...c567534` 的独立 Standards / Spec 复审均通过，新增确认问题均为 0。
   最终双平台验收重新执行，完成后核对正式发布产物；待发布 tag 更新前检查旧对象和未发布状态，不覆盖已发布版本。
+- 合入后的 [正式发布流程](https://github.com/yanglaofish/Fishtools/actions/runs/38361266757)全部成功；同一 npm 归档在 Windows 和 Ubuntu 均为 **489 项：488 通过、0 失败、1 项平台专用跳过**。
+  两平台自包含包、无 Node 的断网只读 Debian 容器通过；[主分支 CI](https://github.com/yanglaofish/Fishtools/actions/runs/38361020862)两平台也通过。
+  最终发布 tag 固定于 `fdb62c1367fe80d985d3292a5fe92f4e88dbb813`；之后的验收记录不改变发行产物。
+- npm 官方注册表 `latest` 为 **0.5.2**；独立下载公开 tarball 为 **9,806,832 字节**，SHA-512 与注册表 integrity 一致，
+  SHA-256 `e48954b03a455bcc9997b2b6075b1c4a8a29e343c2eb1af342e8ca51cf0d649c` 与 [Release](https://github.com/yanglaofish/Fishtools/releases/tag/v0.5.2) 的 `SHA256SUMS` 一致。
+- Release 已公开于仓库访问范围，含 npm、Windows（52,523,594 字节）、Linux（58,075,911 字节）归档及校验文件。
+  issue #4 修正与 Shift+Enter / Enter 按键说明进入同一 0.5.2；没有另发版本或覆盖已发布包。
 
 ## 0.5.1 全代际复核修正（2026-10-13）
 

package/manual/packages/core/README.md

@@ -25,6 +25,10 @@
 
 ## 维护与验证
 
+`createApplication({projectDir,pluginRegistryDir})` 可让多个工作区读取同一插件库；CLI 默认接入用户级全局库，程序未传此选项时保留工作区模式。分发包始终使用自身工作区安装状态。`listPlugins()` 返回 scope/source 和待配置原因；`pluginDefinition(id)` 返回作者声明。`app.resultsDir` 是业务文件根，`app.outputDir` 保留为日志根；插件 `ctx.outputDir` 与 `ctx.logDir` 分别对应本次业务目录和日志目录。
+
+已安装条目的加载或单插件契约错误隔离为 `runtime.status: 'unavailable'`，`listPlugins()` 返回 `loadError` 与来源，传递依赖者同样不可用。直接调用或检查引用它的流程抛出 `PLUGIN_UNAVAILABLE`；无关插件继续装配。纯卸载允许保留其他旧故障；新安装/链接严格检查。修复来源后须重新启动。此恢复不覆盖预置插件、明确的跨插件图错误和运行时初始化错误。
+
 `app.startShell(script,options)` 执行临时命令，`app.startAction(id,input,context)` 调用任意动作，两者均纳入运行记录与关闭等待。`startCommand(name,input,{expectedPlugin,...context})` 可固定命令提供者，启动时再次检查，防止参数填写期间被其他同名能力替换。`configureCommandPresets` 和 `configureShortcuts` 在备份、冲突检查与变更锁内保存项目设置；命令快捷项在用户明确设置时绑定提供者 ID，普通安装/卸载和未改变目标的整组保存不会重新绑定；已有未绑定项必须明确提供 plugin 或在界面重新选择目标。注册项变化通过定向宿主更新生效，导出快照保留所需定义与有效快捷项。
 
 本模块负责上述职责的实现、文档与回归；跨模块接口调整需要同时检查生产者与消费者。具体维护人员尚未指定。
@@ -35,6 +39,10 @@
 node --test tests/modules.test.js tests/application.test.js tests/lifecycle.test.js tests/module-interfaces.test.js
 ```
 
+## 输入预览
+
+应用接口 `app.previewInput(target, input)` 读取目标动作或命令的当前有效输入及来源；`target` 为 `插件ID:动作名` 或 `/命令名`。由宿主使用当前有效配置解析，返回脱离原对象的 `{value, fields}`，不回写输入，也不暴露整份配置。预览允许缺参，执行时仍作完整校验。验证见 `tests/effective-inputs.test.js`。
+
 ## 开发监督进程
 
 `createDevelopmentSupervisor({projectDir,entry,args,env,configFile,onEvent})` 启动文件监听 worker 和应用子进程，返回 `status()`、幂等 `close()`。父进程不加载插件运行模块；每次重启使用全新的 Node 进程，完整更新 ESM 导入依赖。`bindDevelopmentChild(app,{details,closePresentation})` 通过 IPC 报告就绪，收到重启请求后等待 `app.developmentStatus()` 的运行和管理操作均为空闲，再调用 `app.close()` 及界面清理。

package/manual/packages/core/package.json

@@ -19,7 +19,7 @@
   ],
   "license": "MIT",
   "engines": {
-    "node": ">=24.15.0"
+    "node": "^22.22.2 || >=24.0.0"
   },
   "dependencies": {
     "@mytools/commands": "0.1.0",