cabletidy 0.3.0-rc.4 → 0.4.0-rc.1

package/README.md

@@ -14,18 +14,19 @@ CableTidy 的核心不是“提供一个统一 OpenAI API”，而是把复杂
 
 ## 风险监测与审计
 
-本地管理台的“安全”页面使用统一的审计日志列表，每行对应一次请求或操作，显示最高风险等级和风险发现数量，固定为“仅记录”模式。第一版默认观察经过代理的 Responses / Messages 请求、流式与普通响应，以及配置提交、配置启停、客户端配置应用和恢复操作。检测结果不触发通知、阻断或人工授权，也不会额外调用模型。
+本地管理台的“审计记录”按会话组织。会话列表显示输入摘要、请求数量、最高风险与检查状态；打开会话后，通过请求概览、按顺序排列的轨迹和右侧详情回看过程。页面固定为“仅记录”模式。仅审计经过代理的 Agent Responses / Messages 请求以及流式与普通响应；CableTidy 自身的配置提交、配置启停、客户端配置应用和恢复不在审计范围内。检测结果不触发通知、阻断或人工授权，也不会额外调用模型。
 
 - 风险分为敏感数据与凭据、破坏性操作、权限与安全配置变更、外部代码执行、疑似指令操纵；详情分别显示严重程度、置信度、判断依据和检查完整性。
-- 支持“仅看有风险”及时间、配置、最高严重程度、分类、证据阶段等统一筛选；一条记录不因命中多个风险而重复展示。有风险的记录数与风险发现数分别统计，详情始终展示全部关联风险。页面手动刷新，读取本身不增加审计记录。
+- 支持“仅看有风险”及时间、配置、最高严重程度、分类、证据阶段等筛选。命中任一请求即可找到其会话，打开后保留全部已留存上下文；会话数、请求数和风险发现数分开统计。轨迹可上下连续滚动，接近底部时按需追加请求；支持已加载摘要搜索、风险筛选；概览默认按请求数量分配宽度，选中“耗时占比”按耗时分配，再次点击恢复默认，请求顺序始终不变；每条请求同时展示客户端模型与上游模型，支持按两种模型名搜索；详情分为概览、风险和原始内容。页面手动刷新，读取本身不增加审计记录。
+- 根据客户端提供的会话标识归组，并按配置入口与协议隔离。支持 Codex 常见会话头、显式 `metadata.session_id` 和 Claude Code 的会话元数据；这些标识属于客户端报告。没有标识的 Agent 请求与历史 Agent 记录单独展示，不根据时间、相同内容或用户账号猜测会话。
 - 区分本轮工具调用提议、历史调用、客户端报告的工具结果和文本内容。工具的真实执行状态为未知；未命中规则也不表示已证明安全。
 - 审计存入数据目录中的 `audit.sqlite3`，默认保留 30 天，容量预算 128 MiB，接近容量时可能提前清理较旧记录。页面显示实际保留范围、写入状态和记录缺口。
-- 保留网关观察到的请求与响应正文，包括对话、模型输出、工具参数和客户端报告的工具结果；凭据、认证头、Cookie、私钥等在入队前定向脱敏并标记位置。点击风险可定位、高亮对应内容并查看上下文；流式命中保存检测当时的独立快照。普通对话、命令和路径保持可读。
-- 正文不再设单条固定长度上限，网关也不再按 8 MiB 拒绝请求。采用有界内存、临时加密暂存、分段脱敏落盘和正文按页加载；后台完整扫描保留的可检测内容，不再只检查前 1 MiB。共享内存、临时空间或审计存储预算不足时明确显示进度、失败和缺口；旧记录没有正文时不作补造。
+- 保留网关观察到的请求与响应正文，包括对话、模型输出、工具参数和客户端报告的工具结果；凭据、认证头、Cookie、私钥等保留原文并记录检测位置，详情页自动高亮敏感内容。点击风险可定位对应内容并查看上下文；流式命中保存检测当时的独立快照。普通对话、命令和路径保持可读。
+- 正文不再设单条固定长度上限，网关也不再按 8 MiB 拒绝请求。采用有界内存、临时加密暂存、原文分段落盘和正文按页加载；后台完整扫描保留的可检测内容，不再只检查前 1 MiB。共享内存、临时空间或审计存储预算不足时明确显示进度、失败和缺口；旧记录没有正文时不作补造。
 
 检查使用本地规则和有界缓冲。未知工具、动态脚本、未覆盖的推理内容、图片、加密内容以及超限情况会显示覆盖不足。数据库不可用或队列满时代理继续运行，页面显示审计退化状态；正常退出会排空已接收的写入，强制退出可能丢失未提交记录。它是本地可追溯日志，不提供零丢失或防篡改保证。
 
-分类调研、规则清单、固定预算和 HTTP 查询接口见 [代理安全 V1 设计与实现](docs/agent-security-v1.md)。此功能纳入 `0.3.0-rc.3` 候选版；候选版发布与验收状态见 [发布说明](docs/releases/0.3.0-rc.3.md)。
+分类调研、规则清单、固定预算和 HTTP 查询接口见 [代理安全 V1 设计与实现](docs/agent-security-v1.md)。基础安全审计自 `0.3.0` 提供；会话轨迹、敏感原文保留与高亮纳入 `0.4.0-rc.1`，发布与验收状态见 [候选版发布说明](docs/releases/0.4.0-rc.1.md)。
 
 ## 模型透传与可选设置
 
@@ -48,7 +49,7 @@ Codex 的可选模型设置目前只支持与本机官方 GPT 目录明确对应
 
 npm 安装方式推荐 Node.js 24，也支持 Node.js 22.13 及以上的 22.x 版本；完整版本约束见 `package.json`。原生程序可独立运行。发行包支持 Linux x64 / arm64、macOS x64 / arm64、Windows x64；源码构建需要稳定版 Rust 和系统 C 编译器 / 链接器。CI 执行源码测试与安装冒烟测试，跨平台结果以对应提交的 CI 为准。Windows 使用原生进程 API 查询进程身份；Codex 目录查询仍需要系统 Windows PowerShell，并允许 `Add-Type` 调用 Windows Job Object API。
 
-当前源码版本为 `0.3.0-rc.4`，正在准备发布，尚未确认 GitHub Pre-release 或 npm 可用；本页的原生程序、后台运行和安全审计说明对应此版本。上一候选版 `0.3.0-rc.3` 已发布到 GitHub Pre-release 和 npm 的 `next`；npm 的 `latest` 仍为 Node 实现的 `0.2.0`，默认安装命令不会选择候选版。新版本的发布状态与升级步骤见 [发布说明](docs/releases/0.3.0-rc.4.md)。历史版本见 [0.2.0 发布说明](docs/releases/0.2.0.md)。
+当前源码版本为 `0.4.0-rc.1`，新增配置删除、审计原文与敏感内容高亮、会话轨迹。候选版使用 npm `next`；默认 npm 安装命令仍选择 `latest` 指向的稳定版 `0.3.0`。候选版的发布状态、验收范围与升级步骤见 [0.4.0-rc.1 发布说明](docs/releases/0.4.0-rc.1.md)；GitHub Release 与 npm 分别发布。稳定版见 [0.3.0 发布说明](docs/releases/0.3.0.md)。
 
 ### 从 npm 官方源安装
 
@@ -64,6 +65,12 @@ cabletidy start
 npm exec --yes --registry=https://registry.npmjs.org/ --package=cabletidy -- cabletidy start
 ```
 
+试用 `0.4.0` 候选版时，先按[候选版升级说明](docs/releases/0.4.0-rc.1.md)停止服务并备份数据，再安装指定版本：
+
+```bash
+npm install -g cabletidy@0.4.0-rc.1 --registry=https://registry.npmjs.org/
+```
+
 ### 从本地安装包使用
 
 从对应 GitHub Release 下载 `package.tgz` 并按 `SHA256SUMS` 校验后，无需 clone 仓库即可安装：
@@ -101,7 +108,7 @@ cabletidy stop
 `status` 同时显示 daemon 是否在线、管理台 URL、配置版本和当前配置套装列表；每套配置包含 ID、名称、目标 CLI、本地接入 URL 和启用状态，不再需要单独的 URL 或 Web 状态命令。
 `status` 和不带参数的命令只读取状态，不创建数据目录、配置、密钥或备份。尚未初始化时，只提示未启动以及运行 `cabletidy start`，不返回预设的管理台地址。
 
-升级时先停止服务，再安装目标版本并重新启动。从 `0.2.0` 升级时，先在原运行终端按 Ctrl+C，或通过原进程管理器停止；该版本没有 `stop` 命令。以下命令适用于已经支持 `stop` 的版本，且 `latest` 只选择稳定版；候选版升级步骤见 [发布说明](docs/releases/0.3.0-rc.4.md)：
+升级时先停止服务，再安装目标版本并重新启动。从 `0.2.0` 升级时，先在原运行终端按 Ctrl+C，或通过原进程管理器停止；该版本没有 `stop` 命令。以下命令适用于已经支持 `stop` 的版本，且 `latest` 只选择稳定版；完整升级步骤见 [发布说明](docs/releases/0.3.0.md)：
 
 ```bash
 cabletidy stop

package/native/darwin-arm64/build.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.3.0-rc.4",
+  "version": "0.4.0-rc.1",
   "platform": "darwin-arm64",
   "target": "aarch64-apple-darwin",
-  "sha256": "04a5d1c8345102043d88d389607612ab171a6e51b159c714dd845e6022b7f33f"
+  "sha256": "18bbf1e8b1543d9ba8376eeff7aa25e1048ff00ba5fd50162b26c1989ca49573"
 }

package/native/darwin-x64/build.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.3.0-rc.4",
+  "version": "0.4.0-rc.1",
   "platform": "darwin-x64",
   "target": "x86_64-apple-darwin",
-  "sha256": "e5a838185e64e6e52b5bb6715d90d6245dd97087d39523a851ada041619bac82"
+  "sha256": "6a526501a56848dc7c401842d081e7b17166822570393615fee90b4660cd3b27"
 }

package/native/linux-arm64/build.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.3.0-rc.4",
+  "version": "0.4.0-rc.1",
   "platform": "linux-arm64",
   "target": "aarch64-unknown-linux-musl",
-  "sha256": "e219f89432d89b5fbdb99f5872f0cfbe14772d35370dd7e43ab867f63453c618"
+  "sha256": "e1e256fad37165164682675e10d729f461f44bf0fbb08e68a3a00547476f5ee1"
 }

package/native/linux-x64/build.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.3.0-rc.4",
+  "version": "0.4.0-rc.1",
   "platform": "linux-x64",
   "target": "x86_64-unknown-linux-musl",
-  "sha256": "37780337af5aff928e7daf58f3cc6b8eaac319a3197885e62439126edb4bba70"
+  "sha256": "c32a449ba7c7afe474cbc33f92c3f8beb74a7a7ffd533e75fa1f1afbb048a88a"
 }

package/native/win32-x64/build.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.3.0-rc.4",
+  "version": "0.4.0-rc.1",
   "platform": "win32-x64",
   "target": "x86_64-pc-windows-msvc",
-  "sha256": "b73a441810152ceb389936829fac7252b79390b923e5c644a383d56e3c37945e"
+  "sha256": "160af949144c22c1722a7e3dd4bd3a3ca38a277d53b3658dc2d66074b71e6678"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cabletidy",
-  "version": "0.3.0-rc.4",
+  "version": "0.4.0-rc.1",
   "description": "A local multi-target coding CLI gateway and provider manager.",
   "license": "MIT",
   "repository": {