chore: initialize proxyctl specification

2026-07-17 01:51:13 +08:00
commit c4a7616488
16 changed files with 553 additions and 0 deletions
@@ -0,0 +1,33 @@
+# Proxy Configuration
+
+This context describes how one active proxy configuration is coordinated across independently switchable Linux configuration surfaces.
+
+## Language
+
+**Proxy Profile**:
+A named, reusable set of proxy connection details and bypass rules.
+_Avoid_: Proxy, configuration preset
+
+**Active Profile**:
+The Proxy Profile currently selected as the source for every Enabled Target; it may be absent when no Proxy Profiles exist.
+_Avoid_: Current proxy, selected preset
+
+**Target**:
+A configuration surface that can independently receive proxy settings, such as the Shell environment, APT, or the Docker daemon.
+_Avoid_: Application, service
+
+**Available Target**:
+A Target detected as applicable to the current system and therefore shown on the main switch panel.
+_Avoid_: Installed application, supported Target
+
+**Enabled Target**:
+A Target whose actual configuration matches the Active Profile; a Target cannot be enabled when there is no Active Profile.
+_Avoid_: Active application, proxied app
+
+**Drifted Target**:
+A Target whose managed configuration exists but no longer matches the Active Profile, whether because an update failed or an external change occurred.
+_Avoid_: Broken Target, partially enabled Target
+
+**External Target**:
+A Target for which a recognized proxy configuration exists outside this tool's ownership; absence of detected external configuration is treated as Disabled.
+_Avoid_: Unknown Target, unmanaged error