cabletidy 0.3.0-rc.2 → 0.3.0-rc.3

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 CHANGED
@@ -25,7 +25,7 @@ CableTidy 的核心不是“提供一个统一 OpenAI API”,而是把复杂
25
25
 
26
26
  检查使用本地规则和有界缓冲。未知工具、动态脚本、未覆盖的推理内容、图片、加密内容以及超限情况会显示覆盖不足。数据库不可用或队列满时代理继续运行,页面显示审计退化状态;正常退出会排空已接收的写入,强制退出可能丢失未提交记录。它是本地可追溯日志,不提供零丢失或防篡改保证。
27
27
 
28
- 分类调研、规则清单、固定预算和 HTTP 查询接口见 [代理安全 V1 设计与实现](docs/agent-security-v1.md)。此功能纳入 `0.3.0-rc.2` 候选版;候选版发布与验收状态见 [发布说明](docs/releases/0.3.0-rc.2.md)。
28
+ 分类调研、规则清单、固定预算和 HTTP 查询接口见 [代理安全 V1 设计与实现](docs/agent-security-v1.md)。此功能纳入 `0.3.0-rc.3` 候选版;候选版发布与验收状态见 [发布说明](docs/releases/0.3.0-rc.3.md)。
29
29
 
30
30
  ## 模型透传与可选设置
31
31
 
@@ -48,7 +48,7 @@ Codex 的可选模型设置目前只支持与本机官方 GPT 目录明确对应
48
48
 
49
49
  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。
50
50
 
51
- 当前源码版本为 `0.3.0-rc.2`,正在准备候选发布;本页的原生程序、后台运行和安全审计说明对应此版本。npm 的 `latest` 仍为 Node 实现的 `0.2.0`,默认安装命令不会选择候选版。候选版发布后可按 [发布说明](docs/releases/0.3.0-rc.2.md) 指定版本安装;GitHub Pre-release 可用不代表 npm 已发布。历史版本见 [0.2.0 发布说明](docs/releases/0.2.0.md)。
51
+ 当前源码版本为 `0.3.0-rc.3`,正在准备候选发布;本页的原生程序、后台运行和安全审计说明对应此版本。npm 的 `latest` 仍为 Node 实现的 `0.2.0`,默认安装命令不会选择候选版。候选版发布后可按 [发布说明](docs/releases/0.3.0-rc.3.md) 指定版本安装;GitHub Pre-release 可用不代表 npm 已发布。历史版本见 [0.2.0 发布说明](docs/releases/0.2.0.md)。
52
52
 
53
53
  ### 从 npm 官方源安装
54
54
 
@@ -97,7 +97,7 @@ cabletidy stop
97
97
  `status` 同时显示 daemon 是否在线、管理台 URL、配置版本和当前配置套装列表;每套配置包含 ID、名称、目标 CLI、本地接入 URL 和启用状态,不再需要单独的 URL 或 Web 状态命令。
98
98
  `status` 和不带参数的命令只读取状态,不创建数据目录、配置、密钥或备份。尚未初始化时,只提示未启动以及运行 `cabletidy start`,不返回预设的管理台地址。
99
99
 
100
- 升级时先停止服务,再安装目标版本并重新启动。从 `0.2.0` 升级时,先在原运行终端按 Ctrl+C,或通过原进程管理器停止;该版本没有 `stop` 命令。以下命令适用于已经支持 `stop` 的版本,且 `latest` 只选择稳定版;候选版升级步骤见 [发布说明](docs/releases/0.3.0-rc.2.md):
100
+ 升级时先停止服务,再安装目标版本并重新启动。从 `0.2.0` 升级时,先在原运行终端按 Ctrl+C,或通过原进程管理器停止;该版本没有 `stop` 命令。以下命令适用于已经支持 `stop` 的版本,且 `latest` 只选择稳定版;候选版升级步骤见 [发布说明](docs/releases/0.3.0-rc.3.md):
101
101
 
102
102
  ```bash
103
103
  cabletidy stop
@@ -355,7 +355,7 @@ npm run test:claude
355
355
  CABLETIDY_CLAUDE_BIN=/absolute/path/claude npm run test:claude
356
356
  ```
357
357
 
358
- 首版仅支持 Anthropic Messages 兼容上游。HTTP/HTTPS 企业网络代理、动态上游凭据、Bedrock/Vertex 原生协议转换和内置 `claude gateway` 托管不在本版范围。模型网关不代表 npm、Git、MCP 子进程或 Claude 其他联网流量也经过 CableTidy。
358
+ 首版仅支持 Anthropic Messages 兼容上游。动态上游凭据、Bedrock/Vertex 原生协议转换和内置 `claude gateway` 托管不在本版范围。模型网关不代表 npm、Git、MCP 子进程或 Claude 其他联网流量也经过 CableTidy。
359
359
 
360
360
  ## 其他 CLI
361
361
 
@@ -370,6 +370,27 @@ npm test
370
370
 
371
371
  配置文件和 secrets 使用原子写入。管理台和 Virtual Provider 都只绑定 loopback,不需要本地访问 token、API Key 或 session 有效期。上游 API Key 由 CableTidy 单独保存和使用。
372
372
 
373
+ ## Q&A
374
+
375
+ ### Q:配置显示“已启动”,本地地址也正确,为什么客户端仍然连接失败或请求报错?
376
+
377
+ A:一种可能原因是客户端继承了终端配置或启动脚本中的代理环境变量。检查启动客户端的环境中是否设置了 `HTTP_PROXY`、`HTTPS_PROXY`、`ALL_PROXY` 或对应的小写变量。
378
+
379
+ 部分客户端会将发往 `127.0.0.1`、`localhost` 或 `::1` 的请求也交给代理,导致本地连接失败或收到代理返回的错误。浏览器和客户端使用的代理设置也可能不同,因此管理台或浏览器中的 `/v1/models` 能正常访问,并不代表客户端的请求一定能直达 CableTidy。
380
+
381
+ 如果设置了上述任一代理变量,需要同时配置 `NO_PROXY`,将本地回环地址排除,让客户端直接连接 CableTidy。
382
+
383
+ 在启动客户端和 CableTidy 的终端中执行以下 Bash / Zsh 命令,保留已有排除规则,并兼容读取小写 `no_proxy` 的客户端:
384
+
385
+ ```bash
386
+ export NO_PROXY="${NO_PROXY:+${NO_PROXY},}${no_proxy:+${no_proxy},}127.0.0.1,localhost,::1"
387
+ export no_proxy="$NO_PROXY"
388
+ ```
389
+
390
+ 随后从该环境重新启动客户端和 CableTidy,已运行的进程不会自动读取新的环境变量。仅给 CableTidy 设置 `NO_PROXY` 无法改变客户端的代理行为,客户端也必须继承这些变量。
391
+
392
+ `NO_PROXY` 中填写主机名或 IP,不填写 `http://`、端口或接口路径。CableTidy 的上游请求也会读取启动环境中的代理变量;此设置让本地上游绕过代理,远程上游仍可通过原有代理访问。
393
+
373
394
  ## 许可证
374
395
 
375
396
  本项目采用 [MIT License](LICENSE)。
@@ -1,6 +1,6 @@
1
1
  {
2
- "version": "0.3.0-rc.2",
2
+ "version": "0.3.0-rc.3",
3
3
  "platform": "darwin-arm64",
4
4
  "target": "aarch64-apple-darwin",
5
- "sha256": "8b005ebd071aaaae40a12da409e32de4c11bb39decb195b3265d7057de4a62ca"
5
+ "sha256": "f4c6f85a132702309b1ddeeb7ac82c16a6280ef578a8c692b973a63c3a541d74"
6
6
  }
Binary file
@@ -1,6 +1,6 @@
1
1
  {
2
- "version": "0.3.0-rc.2",
2
+ "version": "0.3.0-rc.3",
3
3
  "platform": "darwin-x64",
4
4
  "target": "x86_64-apple-darwin",
5
- "sha256": "3e6fd347928ac46eb06ed07c9bb08bc7be685527584ff812ef01edc5f24e86fe"
5
+ "sha256": "cd05696fdac9357508e7917ef94a892216a5900bc5f8aebae4a42030031b7098"
6
6
  }
Binary file
@@ -1,6 +1,6 @@
1
1
  {
2
- "version": "0.3.0-rc.2",
2
+ "version": "0.3.0-rc.3",
3
3
  "platform": "linux-arm64",
4
4
  "target": "aarch64-unknown-linux-musl",
5
- "sha256": "9835e88c885b3603e934a5a64e92e1fc3703a0844c4dfcecc23135db61d76504"
5
+ "sha256": "dddc03fdfc4732024f70ffd8819c026c1f231a9f244aa555513998f174fdac0b"
6
6
  }
Binary file
@@ -1,6 +1,6 @@
1
1
  {
2
- "version": "0.3.0-rc.2",
2
+ "version": "0.3.0-rc.3",
3
3
  "platform": "linux-x64",
4
4
  "target": "x86_64-unknown-linux-musl",
5
- "sha256": "7c8976df53b43f56d84732ef5978a8b96955967119498e4bae1a2d89017a18a9"
5
+ "sha256": "1699a59cbad98574822faed87d806ae9e59721b16a7f52675c38be2bcddeeca4"
6
6
  }
Binary file
@@ -1,6 +1,6 @@
1
1
  {
2
- "version": "0.3.0-rc.2",
2
+ "version": "0.3.0-rc.3",
3
3
  "platform": "win32-x64",
4
4
  "target": "x86_64-pc-windows-msvc",
5
- "sha256": "a90eef9d983f8c794209336c5da1375146ecfab9140ec392266ffc1cb67e9bee"
5
+ "sha256": "b4b3b688a17a0f0500c74839b9c7173bb18c38413e6a19fe74f65e2f79b4de2d"
6
6
  }
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cabletidy",
3
- "version": "0.3.0-rc.2",
3
+ "version": "0.3.0-rc.3",
4
4
  "description": "A local multi-target coding CLI gateway and provider manager.",
5
5
  "license": "MIT",
6
6
  "repository": {