procproxy 0.1.1__tar.gz → 0.1.3__tar.gz

{procproxy-0.1.1/src/procproxy.egg-info → procproxy-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: procproxy
-Version: 0.1.1
+Version: 0.1.3
 Summary: ProcProxy —— 进程级代理：按进程决定哪条连接走哪个上游代理
 Author: Longersking
 License-Expression: MIT
@@ -74,10 +74,12 @@ python procproxy.py doctor | rules | sessions | ...  # 子命令（等价于 pyt
 pip install procproxy
 procproxy init          # 生成 ~/.procproxy/config.yaml
 procproxy doctor        # 环境自检
-procproxy forward WeChat.exe --port 8848   # 真实转发（需管理员）
+procproxy forward --process WeChat.exe --port 8848   # 真实转发（需管理员）
 ```
 
 安装后直接运行 `procproxy` 会显示首次使用指引，不依赖任何样例文件。
+Python SDK 也一样：`start_proxy()` 不传配置即可启动（内置 `backend=null`），
+不需要先跑 `init`；`init` 只用于生成可编辑配置。
 
 非管理员：WinDivert 抓包必须管理员；可以用 `--backend null` 做转发链路联调，
 或在服务已启动、且配置了 `service.ipc_allow_group` 时读取状态。
@@ -248,7 +250,7 @@ python procproxy.py Weixin.exe WeChatAppEx.exe --port 8848
 ⚠️ 只有 ① 没有 ② → 端口填错了（**要填抓包工具的 MITM 监听口，不是它的 Web 管理口**）。
 ① ② 都正常但内容看不懂 → 那是 TLS，不是转发的问题。
 
-完整指南（含排错与参数表）见 [`docs/14-把进程流量转发给抓包工具.md`](docs/14-把进程流量转发给抓包工具.md)。
+完整指南（含排错与参数表）见 [`docs/14-把进程流量转发给抓包工具.md`](https://github.com/Longersking/procproxy/blob/master/docs/14-%E6%8A%8A%E8%BF%9B%E7%A8%8B%E6%B5%81%E9%87%8F%E8%BD%AC%E5%8F%91%E7%BB%99%E6%8A%93%E5%8C%85%E5%B7%A5%E5%85%B7.md)。
 
 ---
 
@@ -338,30 +340,203 @@ rules:                                      # 自上而下，**首个命中生
 7. 都没命中     → profile.default_action
 ```
 
-完整语义见 [`docs/07-规则引擎与Profile格式.md`](docs/07-规则引擎与Profile格式.md)。
+完整语义见 [`docs/07-规则引擎与Profile格式.md`](https://github.com/Longersking/procproxy/blob/master/docs/07-%E8%A7%84%E5%88%99%E5%BC%95%E6%93%8E%E4%B8%8EProfile%E6%A0%BC%E5%BC%8F.md)。
 
 ---
 
 ## 编程接口
 
+`proxycore.api` 是与 CLI 共用同一套配置、规则引擎和会话表的 SDK。
+完整教程见 [`docs/15-编程接口与SDK.md`](https://github.com/Longersking/procproxy/blob/master/docs/15-%E7%BC%96%E7%A8%8B%E6%8E%A5%E5%8F%A3%E4%B8%8ESDK.md)。
+
+### 30 秒：零配置启动
+
+```python
+from proxycore.api import start_proxy
+
+with start_proxy() as ppx:          # 不需要任何配置文件
+    print(ppx.config_source)        # "packaged"
+    print(ppx.config_path)          # .../proxycore/data/default.yaml
+    print(ppx.status())             # 后端 / 规则 / 会话 / UDP / 配置来源
+```
+
+不传配置时的来源优先级：
+
+| 优先级 | 来源 | 说明 |
+|---|---|---|
+| 1 | `start_proxy(path)` | 显式路径（也接受内存中的 `Config` 对象） |
+| 2 | `PROCPROXY_CONFIG` | 指向不存在文件会直接报错，不回退 |
+| 3 | `~/.procproxy/config.yaml` | `procproxy init` 生成的用户配置 |
+| 4 | 包内 `data/default.yaml` | `backend=null`，不抓包、不改道 |
+
+内置配置**不会**监听 sink，也**不会**创建任何文件。它适合装配、规则决策、
+状态查询和联调；要真实抓包请用 `backend="windivert"`（需管理员）或
+`procproxy init` 生成自己的配置。
+
+### 初始化：生成一份可编辑配置
+
+```python
+from proxycore.api import init_config
+
+path = init_config(
+    "D:/cfg/procproxy.yaml",   # 省略则用 PROCPROXY_CONFIG 或 ~/.procproxy/config.yaml
+    backend="windivert",       # 真抓包需管理员；联调用 "null"
+    sink_port=19080,
+)
+print(path)                    # 绝对路径；等价于 procproxy init
+```
+
+生成的是最小模板，`upstreams` / `rules` 仍为空，需要按下面的案例补上。
+
+### 代理一个进程（最小完整配置）
+
+```yaml
+version: 1
+service:
+  sink: { host: 127.0.0.1, port: 19080 }
+  backend: windivert            # 真抓包；联调改 null
+profile:
+  name: chrome-via-socks
+  default_action: direct
+  dns_mode: remote
+upstreams:
+  - { alias: socks, kind: socks5, host: 127.0.0.1, port: 1080, auth: none }
+rules:
+  - { id: r-private, action: direct, targets: "*",
+      dst_ip: "10.0.0.0/8,172.16.0.0/12,192.168.0.0/16,127.0.0.0/8" }
+  - { id: r-chrome, action: proxy, upstream: socks,
+      targets: "chrome.exe", dst_port: "*" }
+```
+
 ```python
-from proxycore import api
+from proxycore.api import start_proxy
 
-# 上下文管理器：退出自动停
-with api.start_proxy("samples/profiles/dev.yaml") as handle:
-    print(handle.status())
+with start_proxy("D:/cfg/chrome.yaml") as ppx:   # 管理员终端
+    print(ppx.status())
+    print(ppx.sessions(limit=20))
+```
+
+规则自上而下、首个命中生效；启动后只影响**新建立**的连接。
+完整步骤、验证方法与常见坑见 [`docs/15-编程接口与SDK.md`](https://github.com/Longersking/procproxy/blob/master/docs/15-%E7%BC%96%E7%A8%8B%E6%8E%A5%E5%8F%A3%E4%B8%8ESDK.md)。
 
-# 测试模式：sink 把所有连接转发到固定目标（不做抓包）
-with api.start_proxy("samples/profiles/dev.yaml", backend="null",
-                     sink_test_target="127.0.0.1:8080") as handle:
+### 显式配置与测试转发
+
+```python
+from proxycore.api import start_proxy
+
+# 显式路径 + 真实抓包（需要管理员）
+with start_proxy(r"D:\cfg\procproxy.yaml", backend="windivert") as ppx:
+    print(ppx.sink)                 # sink 监听地址
+    print(ppx.sessions(limit=20))
+
+# 联调模式：backend=null + 把 sink 收到的连接固定转发到目标
+with start_proxy(backend="null", sink_test_target="127.0.0.1:8080",
+                 upstream="local-mock") as ppx:
     ...
+    # curl -x http://127.0.0.1:19080 http://any/ → 127.0.0.1:8080
+```
 
-# 只要规则决策，不要监听
-runtime = api.make_runtime("samples/profiles/dev.yaml", backend="null")
+### 在代码里构建配置
+
+可以从字典构造 `Config`，也可以先落盘再按路径加载：
+
+```python
+from proxycore.config import Config, atomic_write
+from proxycore.api import start_proxy
+
+doc = {
+    "version": 1,
+    "service": {"sink": {"host": "127.0.0.1", "port": 19080}, "backend": "null"},
+    "profile": {
+        "name": "myapp",
+        "default_action": "direct",
+        "dns_mode": "remote",
+        "rules": [
+            {"id": "r1", "action": "proxy", "upstream": "office",
+             "targets": "chrome.exe;msedge.exe", "dst_port": "443,80"},
+        ],
+    },
+    "upstreams": [
+        {"alias": "office", "kind": "socks5", "host": "127.0.0.1", "port": 1080},
+    ],
+}
+
+cfg = Config.from_dict(doc)
+cfg.validate()                       # from_dict 只解析，不校验
+atomic_write(cfg, "myconfig.yaml")   # 临时文件 → 校验 → 原子替换
+
+with start_proxy("myconfig.yaml") as ppx:
+    ...
+```
+
+> `Config.from_dict()` 不会解析 `password_ref`；需要凭据时请用
+> `Config.load()` / `start_proxy(path)`，或自己给 `upstream.password` 赋值。
+
+### 只做决策，不启动数据面
+
+```python
+from proxycore.api import make_runtime
+
+runtime = make_runtime()             # 默认用内置配置，backend=null
 decision = runtime.decide(conn_request)
+print(decision.action, decision.reason)
 ```
 
-跑 `python tests/tools/api_demo.py` 看三种用法的完整演示。
+### 生命周期与句柄
+
+```python
+ppx = start_proxy()
+try:
+    print(ppx.status())
+finally:
+    ppx.stop()                       # 幂等；with 退出时也会自动调用
+```
+
+| 成员 | 说明 |
+|---|---|
+| `status()` | 后端、规则、会话、熔断、DNS、UDP、sink、`config_path`、`config_source` |
+| `sessions(limit=50)` / `active_sessions()` | 会话明细 / 活跃数 |
+| `reload(path="")` | 热重载；不传路径则重读当前文件。`sink.port`/`backend` 变更需重启 |
+| `decide(conn)` | 只问规则引擎，不抓包、不改道 |
+| `profile` | 当前生效的 `Profile` |
+| `config_path` / `config_source` | 当前配置的绝对路径与来源 |
+| `running` | 是否仍在运行 |
+
+`start_proxy()` 会启动后台维护线程；`run_forever()` 会阻塞到 Ctrl+C。
+请在主线程使用，并在退出时 `stop()`（或使用 `with`）。
+
+### 错误处理
+
+配置 / 后端 / 启动失败统一抛 `ProxyStartError`，`code` 是稳定的机器可读标识：
+
+```python
+from proxycore.api import ProxyStartError, start_proxy
+
+try:
+    start_proxy("missing.yaml")
+except ProxyStartError as exc:
+    print(exc.code)                  # config_not_found
+```
+
+| code | 含义 |
+|---|---|
+| `config_not_found` | 配置文件不存在（显式路径 / 环境变量不会回退） |
+| `config_unreadable` | 文件存在但读不了（权限、目录等） |
+| `config_parse_invalid` | YAML 语法错误 / 根节点非映射 / 非 UTF-8 |
+| `config_version_unsupported` | `version != 1` |
+| `rule_upstream_missing` 等 | 规则或上游校验失败（完整列表见文档） |
+| `E_BACKEND_UNAVAILABLE` | 后端不可用（未知后端、WinDivert 不可加载等） |
+
+`api.load_config()` 同样抛 `ProxyStartError`，不是 `ConfigError`。
+
+### 环境变量
+
+| 变量 | 作用 |
+|---|---|
+| `PROCPROXY_CONFIG` | 配置文件路径；显式路径之后、用户配置之前生效 |
+| `PROCPROXY_RUNTIME_DIR` | 运行时状态/日志目录（CLI 与服务使用） |
+
+跑 `python tests/tools/api_demo.py` 看完整演示。
 
 ---
 
@@ -406,12 +581,13 @@ src/proxycore/          核心包
   ├── tunnel/           sink + relay（本地落地与双向转发）
   ├── upstream/         SOCKS5 / SOCKS4 / HTTP CONNECT / 跳链
   ├── dns/              DNS 三模式与 UDP
+  ├── config_source.py  配置来源解析（显式 / env / 用户 / 样例 / 内置）
   ├── forward.py        ← procproxy.py <进程名> 的实现
   ├── canproxy.py / checkroute.py / probe.py / pathsetup.py  ← 其余子命令
   └── service/ ipc.py   Windows 服务 + 命名管道
 samples/                mock 服务 + 示例配置
-docs/                   文档（00 架构与阅读路线 / 07 规则语义 / 11 排错 / 14 转发到抓包工具）
-tests/                  测试套件（555 passed）
+docs/                   文档（00 架构 / 07 规则 / 11 排错 / 14 抓包 / 15 SDK）
+tests/                  测试套件（624 passed / 4 skipped）
   └── tools/            验证脚本（run_demo / run_e2e / bench / …）
 ```
 
@@ -432,7 +608,7 @@ tests/                  测试套件（555 passed）
 
 ## 排错
 
-见 [`docs/11-调试排错手册.md`](docs/11-调试排错手册.md)（症状 → 定位 → 解决）。
+见 [`docs/11-调试排错手册.md`](https://github.com/Longersking/procproxy/blob/master/docs/11-%E8%B0%83%E8%AF%95%E6%8E%92%E9%94%99%E6%89%8B%E5%86%8C.md)（症状 → 定位 → 解决）。
 
 最常见的一条：**`[WinError 5] 拒绝访问` = 不是管理员**。
 
@@ -442,7 +618,7 @@ tests/                  测试套件（555 passed）
 
 ```bash
 pip install -e ".[dev]"
-python -m pytest -q tests/                     # 555 passed / 4 skipped（非管理员 Windows）
+python -m pytest -q tests/                     # 624 passed / 4 skipped（非管理员 Windows）
 python -m ruff check src tests
 python -m mypy src/proxycore
 ```

{procproxy-0.1.1 → procproxy-0.1.3}/README.md

@@ -35,10 +35,12 @@ python procproxy.py doctor | rules | sessions | ...  # 子命令（等价于 pyt
 pip install procproxy
 procproxy init          # 生成 ~/.procproxy/config.yaml
 procproxy doctor        # 环境自检
-procproxy forward WeChat.exe --port 8848   # 真实转发（需管理员）
+procproxy forward --process WeChat.exe --port 8848   # 真实转发（需管理员）
 ```
 
 安装后直接运行 `procproxy` 会显示首次使用指引，不依赖任何样例文件。
+Python SDK 也一样：`start_proxy()` 不传配置即可启动（内置 `backend=null`），
+不需要先跑 `init`；`init` 只用于生成可编辑配置。
 
 非管理员：WinDivert 抓包必须管理员；可以用 `--backend null` 做转发链路联调，
 或在服务已启动、且配置了 `service.ipc_allow_group` 时读取状态。
@@ -209,7 +211,7 @@ python procproxy.py Weixin.exe WeChatAppEx.exe --port 8848
 ⚠️ 只有 ① 没有 ② → 端口填错了（**要填抓包工具的 MITM 监听口，不是它的 Web 管理口**）。
 ① ② 都正常但内容看不懂 → 那是 TLS，不是转发的问题。
 
-完整指南（含排错与参数表）见 [`docs/14-把进程流量转发给抓包工具.md`](docs/14-把进程流量转发给抓包工具.md)。
+完整指南（含排错与参数表）见 [`docs/14-把进程流量转发给抓包工具.md`](https://github.com/Longersking/procproxy/blob/master/docs/14-%E6%8A%8A%E8%BF%9B%E7%A8%8B%E6%B5%81%E9%87%8F%E8%BD%AC%E5%8F%91%E7%BB%99%E6%8A%93%E5%8C%85%E5%B7%A5%E5%85%B7.md)。
 
 ---
 
@@ -299,30 +301,203 @@ rules:                                      # 自上而下，**首个命中生
 7. 都没命中     → profile.default_action
 ```
 
-完整语义见 [`docs/07-规则引擎与Profile格式.md`](docs/07-规则引擎与Profile格式.md)。
+完整语义见 [`docs/07-规则引擎与Profile格式.md`](https://github.com/Longersking/procproxy/blob/master/docs/07-%E8%A7%84%E5%88%99%E5%BC%95%E6%93%8E%E4%B8%8EProfile%E6%A0%BC%E5%BC%8F.md)。
 
 ---
 
 ## 编程接口
 
+`proxycore.api` 是与 CLI 共用同一套配置、规则引擎和会话表的 SDK。
+完整教程见 [`docs/15-编程接口与SDK.md`](https://github.com/Longersking/procproxy/blob/master/docs/15-%E7%BC%96%E7%A8%8B%E6%8E%A5%E5%8F%A3%E4%B8%8ESDK.md)。
+
+### 30 秒：零配置启动
+
+```python
+from proxycore.api import start_proxy
+
+with start_proxy() as ppx:          # 不需要任何配置文件
+    print(ppx.config_source)        # "packaged"
+    print(ppx.config_path)          # .../proxycore/data/default.yaml
+    print(ppx.status())             # 后端 / 规则 / 会话 / UDP / 配置来源
+```
+
+不传配置时的来源优先级：
+
+| 优先级 | 来源 | 说明 |
+|---|---|---|
+| 1 | `start_proxy(path)` | 显式路径（也接受内存中的 `Config` 对象） |
+| 2 | `PROCPROXY_CONFIG` | 指向不存在文件会直接报错，不回退 |
+| 3 | `~/.procproxy/config.yaml` | `procproxy init` 生成的用户配置 |
+| 4 | 包内 `data/default.yaml` | `backend=null`，不抓包、不改道 |
+
+内置配置**不会**监听 sink，也**不会**创建任何文件。它适合装配、规则决策、
+状态查询和联调；要真实抓包请用 `backend="windivert"`（需管理员）或
+`procproxy init` 生成自己的配置。
+
+### 初始化：生成一份可编辑配置
+
+```python
+from proxycore.api import init_config
+
+path = init_config(
+    "D:/cfg/procproxy.yaml",   # 省略则用 PROCPROXY_CONFIG 或 ~/.procproxy/config.yaml
+    backend="windivert",       # 真抓包需管理员；联调用 "null"
+    sink_port=19080,
+)
+print(path)                    # 绝对路径；等价于 procproxy init
+```
+
+生成的是最小模板，`upstreams` / `rules` 仍为空，需要按下面的案例补上。
+
+### 代理一个进程（最小完整配置）
+
+```yaml
+version: 1
+service:
+  sink: { host: 127.0.0.1, port: 19080 }
+  backend: windivert            # 真抓包；联调改 null
+profile:
+  name: chrome-via-socks
+  default_action: direct
+  dns_mode: remote
+upstreams:
+  - { alias: socks, kind: socks5, host: 127.0.0.1, port: 1080, auth: none }
+rules:
+  - { id: r-private, action: direct, targets: "*",
+      dst_ip: "10.0.0.0/8,172.16.0.0/12,192.168.0.0/16,127.0.0.0/8" }
+  - { id: r-chrome, action: proxy, upstream: socks,
+      targets: "chrome.exe", dst_port: "*" }
+```
+
 ```python
-from proxycore import api
+from proxycore.api import start_proxy
 
-# 上下文管理器：退出自动停
-with api.start_proxy("samples/profiles/dev.yaml") as handle:
-    print(handle.status())
+with start_proxy("D:/cfg/chrome.yaml") as ppx:   # 管理员终端
+    print(ppx.status())
+    print(ppx.sessions(limit=20))
+```
+
+规则自上而下、首个命中生效；启动后只影响**新建立**的连接。
+完整步骤、验证方法与常见坑见 [`docs/15-编程接口与SDK.md`](https://github.com/Longersking/procproxy/blob/master/docs/15-%E7%BC%96%E7%A8%8B%E6%8E%A5%E5%8F%A3%E4%B8%8ESDK.md)。
 
-# 测试模式：sink 把所有连接转发到固定目标（不做抓包）
-with api.start_proxy("samples/profiles/dev.yaml", backend="null",
-                     sink_test_target="127.0.0.1:8080") as handle:
+### 显式配置与测试转发
+
+```python
+from proxycore.api import start_proxy
+
+# 显式路径 + 真实抓包（需要管理员）
+with start_proxy(r"D:\cfg\procproxy.yaml", backend="windivert") as ppx:
+    print(ppx.sink)                 # sink 监听地址
+    print(ppx.sessions(limit=20))
+
+# 联调模式：backend=null + 把 sink 收到的连接固定转发到目标
+with start_proxy(backend="null", sink_test_target="127.0.0.1:8080",
+                 upstream="local-mock") as ppx:
     ...
+    # curl -x http://127.0.0.1:19080 http://any/ → 127.0.0.1:8080
+```
 
-# 只要规则决策，不要监听
-runtime = api.make_runtime("samples/profiles/dev.yaml", backend="null")
+### 在代码里构建配置
+
+可以从字典构造 `Config`，也可以先落盘再按路径加载：
+
+```python
+from proxycore.config import Config, atomic_write
+from proxycore.api import start_proxy
+
+doc = {
+    "version": 1,
+    "service": {"sink": {"host": "127.0.0.1", "port": 19080}, "backend": "null"},
+    "profile": {
+        "name": "myapp",
+        "default_action": "direct",
+        "dns_mode": "remote",
+        "rules": [
+            {"id": "r1", "action": "proxy", "upstream": "office",
+             "targets": "chrome.exe;msedge.exe", "dst_port": "443,80"},
+        ],
+    },
+    "upstreams": [
+        {"alias": "office", "kind": "socks5", "host": "127.0.0.1", "port": 1080},
+    ],
+}
+
+cfg = Config.from_dict(doc)
+cfg.validate()                       # from_dict 只解析，不校验
+atomic_write(cfg, "myconfig.yaml")   # 临时文件 → 校验 → 原子替换
+
+with start_proxy("myconfig.yaml") as ppx:
+    ...
+```
+
+> `Config.from_dict()` 不会解析 `password_ref`；需要凭据时请用
+> `Config.load()` / `start_proxy(path)`，或自己给 `upstream.password` 赋值。
+
+### 只做决策，不启动数据面
+
+```python
+from proxycore.api import make_runtime
+
+runtime = make_runtime()             # 默认用内置配置，backend=null
 decision = runtime.decide(conn_request)
+print(decision.action, decision.reason)
 ```
 
-跑 `python tests/tools/api_demo.py` 看三种用法的完整演示。
+### 生命周期与句柄
+
+```python
+ppx = start_proxy()
+try:
+    print(ppx.status())
+finally:
+    ppx.stop()                       # 幂等；with 退出时也会自动调用
+```
+
+| 成员 | 说明 |
+|---|---|
+| `status()` | 后端、规则、会话、熔断、DNS、UDP、sink、`config_path`、`config_source` |
+| `sessions(limit=50)` / `active_sessions()` | 会话明细 / 活跃数 |
+| `reload(path="")` | 热重载；不传路径则重读当前文件。`sink.port`/`backend` 变更需重启 |
+| `decide(conn)` | 只问规则引擎，不抓包、不改道 |
+| `profile` | 当前生效的 `Profile` |
+| `config_path` / `config_source` | 当前配置的绝对路径与来源 |
+| `running` | 是否仍在运行 |
+
+`start_proxy()` 会启动后台维护线程；`run_forever()` 会阻塞到 Ctrl+C。
+请在主线程使用，并在退出时 `stop()`（或使用 `with`）。
+
+### 错误处理
+
+配置 / 后端 / 启动失败统一抛 `ProxyStartError`，`code` 是稳定的机器可读标识：
+
+```python
+from proxycore.api import ProxyStartError, start_proxy
+
+try:
+    start_proxy("missing.yaml")
+except ProxyStartError as exc:
+    print(exc.code)                  # config_not_found
+```
+
+| code | 含义 |
+|---|---|
+| `config_not_found` | 配置文件不存在（显式路径 / 环境变量不会回退） |
+| `config_unreadable` | 文件存在但读不了（权限、目录等） |
+| `config_parse_invalid` | YAML 语法错误 / 根节点非映射 / 非 UTF-8 |
+| `config_version_unsupported` | `version != 1` |
+| `rule_upstream_missing` 等 | 规则或上游校验失败（完整列表见文档） |
+| `E_BACKEND_UNAVAILABLE` | 后端不可用（未知后端、WinDivert 不可加载等） |
+
+`api.load_config()` 同样抛 `ProxyStartError`，不是 `ConfigError`。
+
+### 环境变量
+
+| 变量 | 作用 |
+|---|---|
+| `PROCPROXY_CONFIG` | 配置文件路径；显式路径之后、用户配置之前生效 |
+| `PROCPROXY_RUNTIME_DIR` | 运行时状态/日志目录（CLI 与服务使用） |
+
+跑 `python tests/tools/api_demo.py` 看完整演示。
 
 ---
 
@@ -367,12 +542,13 @@ src/proxycore/          核心包
   ├── tunnel/           sink + relay（本地落地与双向转发）
   ├── upstream/         SOCKS5 / SOCKS4 / HTTP CONNECT / 跳链
   ├── dns/              DNS 三模式与 UDP
+  ├── config_source.py  配置来源解析（显式 / env / 用户 / 样例 / 内置）
   ├── forward.py        ← procproxy.py <进程名> 的实现
   ├── canproxy.py / checkroute.py / probe.py / pathsetup.py  ← 其余子命令
   └── service/ ipc.py   Windows 服务 + 命名管道
 samples/                mock 服务 + 示例配置
-docs/                   文档（00 架构与阅读路线 / 07 规则语义 / 11 排错 / 14 转发到抓包工具）
-tests/                  测试套件（555 passed）
+docs/                   文档（00 架构 / 07 规则 / 11 排错 / 14 抓包 / 15 SDK）
+tests/                  测试套件（624 passed / 4 skipped）
   └── tools/            验证脚本（run_demo / run_e2e / bench / …）
 ```
 
@@ -393,7 +569,7 @@ tests/                  测试套件（555 passed）
 
 ## 排错
 
-见 [`docs/11-调试排错手册.md`](docs/11-调试排错手册.md)（症状 → 定位 → 解决）。
+见 [`docs/11-调试排错手册.md`](https://github.com/Longersking/procproxy/blob/master/docs/11-%E8%B0%83%E8%AF%95%E6%8E%92%E9%94%99%E6%89%8B%E5%86%8C.md)（症状 → 定位 → 解决）。
 
 最常见的一条：**`[WinError 5] 拒绝访问` = 不是管理员**。
 
@@ -403,7 +579,7 @@ tests/                  测试套件（555 passed）
 
 ```bash
 pip install -e ".[dev]"
-python -m pytest -q tests/                     # 555 passed / 4 skipped（非管理员 Windows）
+python -m pytest -q tests/                     # 624 passed / 4 skipped（非管理员 Windows）
 python -m ruff check src tests
 python -m mypy src/proxycore
 ```

{procproxy-0.1.1 → procproxy-0.1.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "procproxy"
-version = "0.1.1"
+version = "0.1.3"
 description = "ProcProxy —— 进程级代理：按进程决定哪条连接走哪个上游代理"
 readme = "README.md"
 requires-python = ">=3.10"