cabletidy 0.4.0-rc.6 → 0.5.0-rc.1
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/README.md +27 -5
- package/native/darwin-arm64/build.json +2 -2
- package/native/darwin-arm64/cabletidy +0 -0
- package/native/darwin-x64/build.json +2 -2
- package/native/darwin-x64/cabletidy +0 -0
- package/native/linux-arm64/build.json +2 -2
- package/native/linux-arm64/cabletidy +0 -0
- package/native/linux-x64/build.json +2 -2
- package/native/linux-x64/cabletidy +0 -0
- package/native/win32-x64/build.json +2 -2
- package/native/win32-x64/cabletidy.exe +0 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -30,7 +30,7 @@ CableTidy 的核心不是“提供一个统一 OpenAI API”，而是把复杂
|
|
|
30
30
|
|
|
31
31
|
检查使用本地规则和有界缓冲。未知工具、动态脚本、未覆盖的推理内容、图片和加密内容显示“已检查（覆盖有限）”；正文缺失、解析失败和资源不足等检查缺口单独提示。流式结果按 Responses / Messages 各自的完整协议结束事件判定，客户端在结束事件后关闭连接不再误标为中断；连接接收状态与检查状态分别保留。数据库不可用或队列满时代理继续运行，页面显示审计退化状态；正常退出会排空已接收的写入，强制退出可能丢失未提交记录。它是本地可追溯日志，不提供零丢失或防篡改保证。
|
|
32
32
|
|
|
33
|
-
分类调研、规则清单、固定预算和 HTTP 查询接口见 [代理安全 V1 设计与实现](docs/agent-security-v1.md)。基础安全审计自 `0.3.0` 提供；会话轨迹、敏感原文保留与高亮纳入 `0.4.0
|
|
33
|
+
分类调研、规则清单、固定预算和 HTTP 查询接口见 [代理安全 V1 设计与实现](docs/agent-security-v1.md)。基础安全审计自 `0.3.0` 提供；会话轨迹、敏感原文保留与高亮纳入 `0.4.0`，发布与验收状态见 [0.4.0 发布说明](docs/releases/0.4.0.md)。
|
|
34
34
|
|
|
35
35
|
## 服务设置
|
|
36
36
|
|
|
@@ -40,6 +40,18 @@ CableTidy 的核心不是“提供一个统一 OpenAI API”，而是把复杂
|
|
|
40
40
|
|
|
41
41
|
设置保存到 `config.json` 的 `audit` 字段：`retentionDays` 为天数，`budgetBytes` 为字节数，`null` 表示该项不设上限；旧配置缺少字段时使用默认值。设置复用 `POST /api/v1/config/commit` 的校验、修订冲突检查和备份流程，不随线路导出或导入。
|
|
42
42
|
|
|
43
|
+
“临时目录”是独立的服务设置，默认使用 `${CABLETIDY_HOME}/tmp`（通常为 `~/.cabletidy/tmp`，开发实例为 `.cabletidy-debug/tmp`）。可填写服务器上的绝对路径，留空恢复默认；保存时检查目录是否可创建及写入，重启后生效，页面显示当前使用目录与待重启状态。该设置保存在 `config.json` 顶级 `temporaryDirectory` 字段，`null` 表示默认位置，不随线路导出或导入。
|
|
44
|
+
|
|
45
|
+
临时目录按用途包含 `spool`（请求、响应及流式事件的加密暂存）、`sqlite`（数据库排序、分组等临时文件）和 `helpers`（辅助脚本）。正文暂存继续采用匿名文件，转发与后台审计不再引用后关闭并回收，进程退出时也由系统回收。Unix 目录必须属于当前用户且权限为 `0700`，已有的共享目录或符号链接会被拒绝，程序不会修改其权限；Windows 使用目录继承的访问权限，应选择当前用户的私有目录。启动时为 daemon 设置 SQLite 的系统临时目录环境，优先于继承的系统临时路径。Unix 上规范化后的完整 `sqlite` 子目录路径最多为 486 字节，为 bundled SQLite 的 512 字节路径上限预留临时文件名空间；保存和启动时均会拒绝超长路径。
|
|
46
|
+
|
|
47
|
+
正文加密暂存仍受 512 MiB 共享预算限制，SQLite 临时文件不计入该预算；选择同一分区时，临时文件和审计库会共同消耗磁盘空间。修改目录不会迁移审计库，也不会删除旧目录中的其他文件。
|
|
48
|
+
|
|
49
|
+
[XDG Base Directory 规范](https://specifications.freedesktop.org/basedir-spec/latest/)按用途区分配置、数据、状态、缓存和运行时目录，并不提供自动清理机制。CableTidy 目前沿用 `.cabletidy` 数据根目录；大体积正文暂存不使用可能位于内存文件系统的 `XDG_RUNTIME_DIR`。
|
|
50
|
+
|
|
51
|
+
Unix 控制 socket 优先使用 `$XDG_RUNTIME_DIR/cabletidy/<数据目录哈希>/<实例 UUID>.sock`。运行时根目录必须已存在、为绝对路径、属于当前用户且权限为 `0700`；未设置、目录不可用或完整 socket 路径超过可移植长度限制时，回退到 `/tmp/cabletidy-<uid>-<数据目录哈希>/<实例 UUID>.sock`，不会创建或修改运行时根目录。实际地址保存在 `runtime.json` 的 `controlAddress` 字段，`status`、`stop` 和 `restart` 使用记录的地址，因此客户端与 daemon 的环境变量可以不同；没有该字段的旧实例仍按原 `/tmp` 规则连接。正常退出时主动删除 socket，重启同一数据目录时仅清理所选实例目录中的旧 UUID socket，保留其他文件和实例。Windows 继续使用用户私有命名管道。
|
|
52
|
+
|
|
53
|
+
`XDG_RUNTIME_DIR` 的生命周期通常随用户登录会话结束；需要跨注销持续运行时，应通过服务管理器提供稳定的运行时目录。修改设置页面中的正文临时目录不影响控制 socket 的位置。
|
|
54
|
+
|
|
43
55
|
5 GiB 默认值自 `0.4.0-rc.6` 提供。已有配置中保存的上限（包括 128 MiB）或“不限”继续沿用；要提高已有上限，在“设置”中将存储上限改为 5120 MiB 并保存。容量按需使用，不会预占 5 GiB。
|
|
44
56
|
|
|
45
57
|
界面预览：[桌面](docs/screenshots/service-settings-desktop.png) · [手机](docs/screenshots/service-settings-mobile.png)。
|
|
@@ -79,7 +91,9 @@ Codex 的可选模型设置目前只支持与本机官方 GPT 目录明确对应
|
|
|
79
91
|
|
|
80
92
|
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。
|
|
81
93
|
|
|
82
|
-
|
|
94
|
+
最新正式版为 `0.4.0`，沿用 `0.4.0-rc.6` 的功能代码，更新版本号和发布文档后重新构建完整安装包。相对 `0.3.0`，新增会话审计轨迹、完整请求与响应概览、敏感原文保留与风险定位、历史折叠及检测复用、线路导入导出、客户端配置冲突确认、自动更新和服务设置，默认审计存储上限提高到 5 GiB。正式包发布到 npm `latest`；发布状态、验收范围与升级步骤见 [0.4.0 发布说明](docs/releases/0.4.0.md)。GitHub Release 与 npm 分别发布。
|
|
95
|
+
|
|
96
|
+
最新候选版为 `0.5.0-rc.1`，基于最新 `main`，包含 [PR #61](https://github.com/ZY-WANG-0304/cabletidy/pull/61) 的独立临时目录设置与 XDG 控制 socket、[PR #58](https://github.com/ZY-WANG-0304/cabletidy/pull/58) 的轨迹概览坐标轴与横向滚动，以及 [PR #57](https://github.com/ZY-WANG-0304/cabletidy/pull/57) 的 Web 配置与审计领域逻辑迁移到 Rust。候选包发布到 npm `next`，`latest` 保持稳定版 `0.4.0`；升级步骤和验收范围见 [0.5.0-rc.1 发布说明](docs/releases/0.5.0-rc.1.md)。需要稳定版源码时，请使用 `v0.4.0` tag。
|
|
83
97
|
|
|
84
98
|
### 从 npm 官方源安装
|
|
85
99
|
|
|
@@ -95,12 +109,20 @@ cabletidy start
|
|
|
95
109
|
npm exec --yes --registry=https://registry.npmjs.org/ --package=cabletidy -- cabletidy start
|
|
96
110
|
```
|
|
97
111
|
|
|
98
|
-
|
|
112
|
+
升级到 `0.4.0` 时，先按[正式版升级说明](docs/releases/0.4.0.md)停止服务并备份数据，再安装指定版本：
|
|
113
|
+
|
|
114
|
+
```bash
|
|
115
|
+
npm install -g cabletidy@0.4.0 --registry=https://registry.npmjs.org/
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
试用候选版时，先停止服务并备份数据，再安装指定候选版本：
|
|
99
119
|
|
|
100
120
|
```bash
|
|
101
|
-
npm install -g cabletidy@0.
|
|
121
|
+
npm install -g cabletidy@0.5.0-rc.1 --registry=https://registry.npmjs.org/
|
|
102
122
|
```
|
|
103
123
|
|
|
124
|
+
已支持 `update` 的版本也可执行 `cabletidy update 0.5.0-rc.1`，按提示重启；无参数的 `update` 仍使用稳定版 `latest`。
|
|
125
|
+
|
|
104
126
|
### 从本地安装包使用
|
|
105
127
|
|
|
106
128
|
从对应 GitHub Release 下载 `package.tgz` 并按 `SHA256SUMS` 校验后，无需 clone 仓库即可安装：
|
|
@@ -141,7 +163,7 @@ cabletidy stop
|
|
|
141
163
|
`status` 同时显示 daemon 是否在线、管理台 URL、配置版本和当前线路列表（`cables`）；每条线路包含 ID、名称、目标 CLI、本地接入 URL 和启用状态，不再需要单独的 URL 或 Web 状态命令。
|
|
142
164
|
`status` 和不带参数的命令只读取状态，不创建数据目录、配置、密钥或备份。尚未初始化时，只提示未启动以及运行 `cabletidy start`，不返回预设的管理台地址。
|
|
143
165
|
|
|
144
|
-
升级时先停止服务，再安装目标版本并重新启动。从 `0.2.0` 升级时，先在原运行终端按 Ctrl+C，或通过原进程管理器停止；该版本没有 `stop` 命令。以下命令适用于已经支持 `stop` 的版本，且 `latest` 只选择稳定版；完整升级步骤见 [发布说明](docs/releases/0.
|
|
166
|
+
升级时先停止服务，再安装目标版本并重新启动。从 `0.2.0` 升级时，先在原运行终端按 Ctrl+C，或通过原进程管理器停止；该版本没有 `stop` 命令。以下命令适用于已经支持 `stop` 的版本，且 `latest` 只选择稳定版；完整升级步骤见 [发布说明](docs/releases/0.4.0.md)：
|
|
145
167
|
|
|
146
168
|
```bash
|
|
147
169
|
cabletidy stop
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.
|
|
2
|
+
"version": "0.5.0-rc.1",
|
|
3
3
|
"platform": "darwin-arm64",
|
|
4
4
|
"target": "aarch64-apple-darwin",
|
|
5
|
-
"sha256": "
|
|
5
|
+
"sha256": "cc9558e949884c034674689c5aa6ecf15aed796421f1dd1e5b4d33a18bca68ff"
|
|
6
6
|
}
|
|
Binary file
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.
|
|
2
|
+
"version": "0.5.0-rc.1",
|
|
3
3
|
"platform": "darwin-x64",
|
|
4
4
|
"target": "x86_64-apple-darwin",
|
|
5
|
-
"sha256": "
|
|
5
|
+
"sha256": "c9deec61fa8fb268e2e8d7e9a2d54f41b80ea51926e42fa8d616c19885e9ffe3"
|
|
6
6
|
}
|
|
Binary file
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.
|
|
2
|
+
"version": "0.5.0-rc.1",
|
|
3
3
|
"platform": "linux-arm64",
|
|
4
4
|
"target": "aarch64-unknown-linux-musl",
|
|
5
|
-
"sha256": "
|
|
5
|
+
"sha256": "3ad74311f93c659a3ccd921bf0b2aacddbe5423f714e39f29cb5877de8186bc6"
|
|
6
6
|
}
|
|
Binary file
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.
|
|
2
|
+
"version": "0.5.0-rc.1",
|
|
3
3
|
"platform": "linux-x64",
|
|
4
4
|
"target": "x86_64-unknown-linux-musl",
|
|
5
|
-
"sha256": "
|
|
5
|
+
"sha256": "881a04e1b6390f8e4a7bde9412fd8dd5db6589055e2285e68d53ff1cddeb8a78"
|
|
6
6
|
}
|
|
Binary file
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.
|
|
2
|
+
"version": "0.5.0-rc.1",
|
|
3
3
|
"platform": "win32-x64",
|
|
4
4
|
"target": "x86_64-pc-windows-msvc",
|
|
5
|
-
"sha256": "
|
|
5
|
+
"sha256": "2adf4b742a62b67e070f99c5c4d95895856dd9078c10ab863dbc99cdbc358ee2"
|
|
6
6
|
}
|
|
Binary file
|