@namewta/speculo 2.0.6 → 2.1.1

package/skills-hub/system/clash-client-profile/scripts/proxy_doctor.py

@@ -0,0 +1,213 @@
+#!/usr/bin/env python3
+"""Read-only proxy diagnostics. Offline by default; Python 3.10+, optional curl.
+
+This tool does not change proxies, DNS, routes, firewall rules, or accounts.
+A successful echo probe is NOT proof that another application's traffic is proxied.
+"""
+from __future__ import annotations
+import argparse
+import ipaddress
+import json
+import os
+from pathlib import Path
+import platform
+import shutil
+import subprocess
+import sys
+import urllib.error
+import urllib.request
+from urllib.parse import urlsplit
+
+PROXY_KEYS = ("http_proxy", "https_proxy", "all_proxy", "no_proxy",
+              "HTTP_PROXY", "HTTPS_PROXY", "ALL_PROXY", "NO_PROXY")
+TARGETS = ("anthropic.com", "claude.ai", "claude.com")
+ECHO = {4: "https://api4.ipify.org", 6: "https://api6.ipify.org"}
+LIMIT = 1024 * 1024
+
+
+def local_endpoint(value: str, controller: bool = False) -> str:
+    """Require an explicit numeric loopback and port; never forward credentials."""
+    try:
+        u = urlsplit(value)
+        schemes = ("http", "https") if controller else ("http", "https", "socks5h")
+        if u.scheme not in schemes or u.username is not None or u.password is not None:
+            raise ValueError
+        if not u.hostname or not ipaddress.ip_address(u.hostname).is_loopback:
+            raise ValueError
+        if u.port is None or not 1 <= u.port <= 65535:
+            raise ValueError
+        if u.path or u.query or u.fragment or any(c.isspace() for c in value):
+            raise ValueError
+    except (ValueError, TypeError):
+        raise ValueError("Use scheme://numeric-loopback:port without credentials, path or query; SOCKS requires socks5h") from None
+    return value
+
+
+def environment_summary(env: dict[str, str]) -> dict:
+    result = {}
+    for key in PROXY_KEYS:
+        value = env.get(key)
+        if value is None:
+            continue
+        if key.lower() == "no_proxy":
+            result[key] = {"set": bool(value), "wildcard": any(part.strip() == "*" for part in value.split(",")),
+                           "note": "Inspect locally for target-domain bypass; value redacted"}
+        else:
+            try:
+                u = urlsplit(value)
+                scheme = u.scheme if u.scheme in ("http", "https", "socks5", "socks5h") else "unknown"
+                result[key] = {"set": bool(value), "scheme": scheme,
+                               "credentials_present": u.username is not None or u.password is not None}
+            except ValueError:
+                result[key] = {"set": bool(value), "scheme": "invalid"}
+    return result
+
+
+def target_host(host: object, targets: tuple[str, ...] = TARGETS) -> bool:
+    if not isinstance(host, str):
+        return False
+    host = host.lower().rstrip(".")
+    return any(host == t or host.endswith("." + t) for t in targets)
+
+
+def analyze_connections(data: object, targets: tuple[str, ...] = TARGETS) -> dict:
+    if not isinstance(data, dict) or not isinstance(data.get("connections"), list):
+        return {"status": "UNVERIFIED", "reason": "Missing connections array", "observations": []}
+    observations = []
+    for item in data["connections"]:
+        if not isinstance(item, dict):
+            continue
+        metadata = item.get("metadata")
+        if not isinstance(metadata, dict) or not target_host(metadata.get("host"), targets):
+            continue
+        chains = item.get("chains")
+        valid = isinstance(chains, list) and bool(chains) and all(isinstance(c, str) for c in chains)
+        direct = valid and any(c.upper() == "DIRECT" for c in chains)
+        blocked = valid and any(c.upper() in ("REJECT", "REJECT-DROP") for c in chains)
+        status = "FAIL" if direct else "BLOCKED" if blocked else "OBSERVED" if valid else "UNVERIFIED"
+        observations.append({"status": status, "direct": bool(direct), "blocked": bool(blocked),
+                             "chain_length": len(chains) if valid else 0,
+                             "rule_present": isinstance(item.get("rule"), str) and bool(item["rule"]),
+                             "note": "Host, process, destination IP and node names redacted"})
+    return {"status": "FAIL" if any(o["status"] == "FAIL" for o in observations) else "UNVERIFIED",
+            "reason": "A snapshot cannot prove all application traffic, DNS, IPv6 or crash isolation",
+            "matched_connections": len(observations), "observations": observations}
+
+
+def curl_command(executable: str, proxy: str, family: int) -> list[str]:
+    # -q must be first: ignore .curlrc (which may contain proxy, insecure, or output options).
+    # Do NOT add -6: with an IPv4 loopback HTTP proxy it constrains the proxy connection,
+    # not the exit's address family. Instead use a family-specific remote endpoint.
+    local_endpoint(proxy)
+    return [executable, "-q", "--silent", "--show-error", "--fail",
+            "--connect-timeout", "4", "--max-time", "10", "--max-filesize", "128",
+            "--proto", "=https", "--proxy", proxy, "--noproxy", "", ECHO[family]]
+
+
+def probe(proxy: str, family: int, show_ip: bool = False) -> dict:
+    executable = shutil.which("curl.exe" if os.name == "nt" else "curl")
+    if not executable:
+        return {"status": "UNVERIFIED", "reason": "curl unavailable", "family": family}
+    env = {k: v for k, v in os.environ.items() if k.lower() not in
+           {"http_proxy", "https_proxy", "all_proxy", "no_proxy", "sslkeylogfile"}}
+    try:
+        result = subprocess.run(curl_command(executable, proxy, family), env=env,
+                                capture_output=True, timeout=12, check=False)
+        if result.returncode:
+            return {"status": "UNVERIFIED", "curl_exit": result.returncode, "family": family,
+                    "reason": "Probe failed; no direct retry; this alone does not prove a leak"}
+        ip = ipaddress.ip_address(result.stdout.decode("ascii").strip())
+        if ip.version != family:
+            return {"status": "UNVERIFIED", "reason": "Unexpected echo address family", "family": family}
+        return {"status": "OBSERVED", "family": family, "ip": str(ip) if show_ip else "<redacted>",
+                "note": "Only this explicit-proxy echo request was observed; country and application route unverified"}
+    except (OSError, subprocess.TimeoutExpired, UnicodeError, ValueError):
+        return {"status": "UNVERIFIED", "reason": "Probe unavailable or invalid response", "family": family}
+
+
+class NoRedirect(urllib.request.HTTPRedirectHandler):
+    def redirect_request(self, req, fp, code, msg, headers, newurl):
+        raise urllib.error.HTTPError(req.full_url, code, "Redirect refused", headers, fp)
+
+
+def read_controller(base: str, secret: str | None) -> dict:
+    local_endpoint(base, controller=True)
+    if secret and any(c in secret for c in "\r\n"):
+        raise ValueError("Invalid controller credential")
+    headers = {"Authorization": "Bearer " + secret} if secret else {}
+    opener = urllib.request.build_opener(urllib.request.ProxyHandler({}), NoRedirect())
+    request = urllib.request.Request(base + "/connections", headers=headers, method="GET")
+    with opener.open(request, timeout=5) as response:
+        payload = response.read(LIMIT + 1)
+    if len(payload) > LIMIT:
+        raise ValueError("Controller response too large")
+    return json.loads(payload)
+
+
+def domain(value: str) -> str:
+    value = value.lower().rstrip(".")
+    labels = value.split(".")
+    if len(labels) < 2 or len(value) > 253 or not all(
+        label and len(label) <= 63 and label[0].isalnum() and label[-1].isalnum()
+        and all(c.isascii() and (c.isalnum() or c == "-") for c in label) for label in labels
+    ):
+        raise argparse.ArgumentTypeError("Use a DNS hostname, not a URL, wildcard or IP")
+    try:
+        ipaddress.ip_address(value)
+    except ValueError:
+        return value
+    raise argparse.ArgumentTypeError("Use a DNS hostname, not an IP")
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--network", action="store_true", help="Allow explicitly requested network probes; echo services see the exit IP")
+    parser.add_argument("--proxy", help="Actual local HTTP/HTTPS or socks5h endpoint; no assumed port")
+    parser.add_argument("--controller", help="Existing loopback controller; never enables or reconfigures it")
+    parser.add_argument("--connections", type=Path, help="Offline /connections JSON snapshot; keep raw file private")
+    parser.add_argument("--target", action="append", type=domain, help="Replace default target domain set; repeat as needed")
+    parser.add_argument("--show-ip", action="store_true", help="Include observed public echo IPs in stdout")
+    parser.add_argument("--strict", action="store_true", help="Exit 3 for inconclusive evidence; default exits 0 unless DIRECT observed")
+    args = parser.parse_args(argv)
+    if args.proxy or args.controller:
+        if not args.network:
+            parser.error("--proxy/--controller require --network; offline inspection makes no requests")
+        try:
+            if args.proxy:
+                local_endpoint(args.proxy)
+            if args.controller:
+                local_endpoint(args.controller, controller=True)
+        except ValueError as exc:
+            parser.error(str(exc))
+    elif args.network:
+        parser.error("--network requires --proxy and/or --controller")
+    if args.connections and args.controller:
+        parser.error("Choose either an offline snapshot or a live controller")
+    report = {"schema_version": 1, "platform": platform.system(), "network_requested": args.network,
+              "environment": environment_summary(dict(os.environ)), "verdict": "UNVERIFIED",
+              "limitations": ["No OS settings changed", "No direct baseline or fallback",
+                              "No DNS/IPv6/crash-isolation or service-region guarantee"]}
+    targets = tuple(args.target or TARGETS)
+    if args.connections or args.controller:
+        try:
+            if args.connections:
+                with args.connections.open("rb") as handle:
+                    payload = handle.read(LIMIT + 1)
+                if len(payload) > LIMIT:
+                    raise ValueError("Snapshot too large")
+                data = json.loads(payload)
+            else:
+                data = read_controller(args.controller, os.environ.get("MIHOMO_SECRET"))
+            report["connections"] = analyze_connections(data, targets)
+            if report["connections"]["status"] == "FAIL":
+                report["verdict"] = "FAIL"
+        except (OSError, ValueError, urllib.error.URLError):
+            report["connections"] = {"status": "UNVERIFIED", "reason": "Snapshot/controller unavailable or invalid; raw error withheld"}
+    if args.proxy:
+        report["echo_probes"] = [probe(args.proxy, family, args.show_ip) for family in (4, 6)]
+    print(json.dumps(report, ensure_ascii=False, indent=2))
+    return 1 if report["verdict"] == "FAIL" else 3 if args.strict else 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/skills-hub/system/clash-client-profile/scripts/render_rules.py

@@ -0,0 +1,34 @@
+#!/usr/bin/env python3
+"""Render a minimal Mihomo rules-extension fragment to stdout; never edits a profile."""
+from __future__ import annotations
+import argparse
+import json
+import sys
+
+DOMAINS = ("anthropic.com", "claude.ai", "claude.com", "openai.com", "chatgpt.com",
+           "oaistatic.com", "oaiusercontent.com", "cursor.com", "cursor.sh", "x.ai", "grok.com")
+
+
+def render(group: str) -> str:
+    if not group.strip() or group != group.strip() or any(c in group for c in ",\r\n\x00"):
+        raise ValueError("Group must be a nonempty exact name without comma or control characters")
+    if any(ord(c) < 32 for c in group) or group.upper() in ("DIRECT", "REJECT", "REJECT-DROP", "PASS", "COMPATIBLE"):
+        raise ValueError("Choose a real proxy policy group, not a direct/reject/reserved target")
+    rules = [json.dumps("DOMAIN-SUFFIX," + d + "," + group, ensure_ascii=False) for d in DOMAINS]
+    return "# Minimal domain baseline, not an exhaustive service allowlist.\nprepend:\n" + "".join("  - " + r + "\n" for r in rules) + "append: []\ndelete: []\n"
+
+
+def main() -> None:
+    p = argparse.ArgumentParser(description=__doc__)
+    p.add_argument("--group", required=True, help="Exact existing group name; verify its currently selected leaf is not DIRECT")
+    args = p.parse_args()
+    try:
+        text = render(args.group)
+    except ValueError as exc:
+        p.error(str(exc))
+    # Keep redirected output UTF-8 even on Windows legacy code pages.
+    sys.stdout.buffer.write(text.encode("utf-8"))
+
+
+if __name__ == "__main__":
+    main()

package/skills-hub/system/clash-client-profile/templates/ai-rules.yaml

@@ -0,0 +1,18 @@
+# Minimal domain baseline, not an exhaustive service allowlist.
+prepend:
+  - "DOMAIN-SUFFIX,anthropic.com,🔰 节点选择"
+  - "DOMAIN-SUFFIX,claude.ai,🔰 节点选择"
+  - "DOMAIN-SUFFIX,claude.com,🔰 节点选择"
+  - "DOMAIN-SUFFIX,openai.com,🔰 节点选择"
+  - "DOMAIN-SUFFIX,chatgpt.com,🔰 节点选择"
+  - "DOMAIN-SUFFIX,oaistatic.com,🔰 节点选择"
+  - "DOMAIN-SUFFIX,oaiusercontent.com,🔰 节点选择"
+  - "DOMAIN-SUFFIX,cursor.com,🔰 节点选择"
+  - "DOMAIN-SUFFIX,cursor.sh,🔰 节点选择"
+  - "DOMAIN-SUFFIX,x.ai,🔰 节点选择"
+  - "DOMAIN-SUFFIX,grok.com,🔰 节点选择"
+  - "DOMAIN-SUFFIX,gemini.google.com,🔰 节点选择"
+  - "DOMAIN-SUFFIX,aistudio.google.com,🔰 节点选择"
+  - "DOMAIN-SUFFIX,generativelanguage.googleapis.com,🔰 节点选择"
+append: []
+delete: []

package/skills-hub/system/clash-client-profile/templates/dns-request.example.json

@@ -0,0 +1,9 @@
+{
+  "schema_version": 1,
+  "group": "🔰 节点选择",
+  "resolvers": ["https://1.1.1.1/dns-query"],
+  "bootstrap": {"mode": "deny"},
+  "ipv6": "tunnel",
+  "targets": ["anthropic.com", "claude.ai", "claude.com"],
+  "replace_existing_dns_policies": false
+}

package/skills-hub/system/clash-client-profile/templates/dns.yaml

@@ -0,0 +1,8 @@
+# Backward-compatible discovery fragment, NOT a privacy or deployment profile.
+# Do not apply this by itself: use scripts/dns_guard.py plan with a real effective
+# configuration and templates/dns-request.example.json customized by the user.
+# The generated plan pins nameserver/default/direct DNS to the approved group,
+# explicitly models node bootstrap, and requires map REPLACEMENT for stale policies.
+# No resolver, port-53 listener, OS DNS or IPv6 block is inferred here.
+dns:
+  enable: true

package/skills-hub/system/linux-dev-disk-cleanup/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ting'an Wang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills-hub/system/linux-dev-disk-cleanup/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: linux-dev-disk-cleanup
+description: 审计 Linux 开发机磁盘，并在具名授权后清理 APT、journal、snap 旧修订、Docker 未使用数据和可重建缓存。用于根分区空间、缓存体积和 /linux-dev-disk-cleanup；不处理 Windows、仅查 CPU、区域、代理或 Clash。
+license: MIT
+compatibility: Requires systemd Linux on the actual target, commonly Ubuntu or Debian. Root is required only for authorized steps that need it.
+metadata:
+  author: NAMEWTA
+  wta-format-reviewed: '2026-10-08'
+---
+# Linux 开发机磁盘清理
+
+## 输入与输出契约
+
+确认目标是 systemd Linux 主机，而不是 WSL 里看到的 Windows 盘、容器内部或远程跳板。取得根分区基线和当前清理清单；每项具有确切路径、容器名、volume ID、snap 修订或官方缓存命令，以及所有者、估计大小、决定和状态。扫描发现候选不自动新增删除授权。
+
+清单逐项写估计占用、批准动作、执行/停止/保留状态、`df` 实测变化，以及运行中容器、业务数据目录、当前内核和回退内核的核对。目录 `du` 之和不能冒充释放量。
+
+示例：“仅审计这台 Ubuntu 的根分区，列出可清理项目让我确认。”应进入本技能；“清理 Windows 的 C 盘缓存。”或“只看哪个进程占 CPU。”不应由本技能接管。
+
+Docker、snap 或 APT 不存在时跳过对应项。需要 root 的步骤先确认权限，审计不自动提权。测量和命令见 [清理工作流](references/linux-cleanup-workflow.md)。本入口的授权与停止条件优先于参考中的示例命令。
+
+在用户工作区的 `清理清单.md` 或指定文件记录稳定编号和历史；不能因重新扫描覆盖已有决定。
+
+## 审计与授权
+
+只读或规划请求不删除、不清缓存、不 prune、不卸载、不改 journald。已有具名批准可执行，新候选继续待确认。“磁盘优化一下”不授权破坏性操作。
+
+开始前重测 `df -h /` 与 `df -ih /`。overlay 和 loop 与根分区是同一块盘，不相加。`du` 使用 `-x`，不跟随其他挂载。
+
+## 执行
+
+操作前重读路径、所有权和清单。先处理清单点名的过期临时目录，再处理 Docker。Docker 顺序固定：点名且非 running 的容器、`docker volume prune`、`docker image prune -a`、`docker builder prune`。不运行 `docker system prune -a --volumes`，不把 `docker volume prune` 放进定时任务。
+
+语言和构建缓存只用该工具的官方清理命令。`node_modules`、工具链、会话目录和业务 bind mount 各自独立决定。不从家目录或仓库根递归删除 `dist`、`build`、`node_modules`、`.next`。
+
+留下当前内核和至少一个已安装的回退内核。`apt autoremove` 先 dry-run；列表含回退内核、桌面或运行时则不执行。snap 只删除带 disabled 标记的修订，并且必须带 `--revision`。journal 上限和 vacuum 只有清单写明才改。
+
+父目录里还有未点名内容、在用 volume 会消失、dry-run 与保留项冲突，或现场与清单矛盾时，停止受影响项。不删除 `/tmp`、`/var/tmp` 本身，也不删除 `systemd-private-*`。
+
+## 验收
+
+按阶段读回根分区可用空间。核对运行中容器的名单与健康、点名数据目录大小、`uname -r` 与回退内核、源码仍在且生成目录已空。成功、失败、保留和硬停写入清单。只清理本轮自行创建且不再需要的临时文件，保留清单与证据。

package/skills-hub/system/linux-dev-disk-cleanup/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Linux 磁盘清理"
+  short_description: "审计 Linux 磁盘并具名清理，保护内核、业务数据和活动容器"
+  default_prompt: "请使用 $linux-dev-disk-cleanup：仅审计根分区空间，列出可清理项目让我确认。"

package/skills-hub/system/linux-dev-disk-cleanup/references/linux-cleanup-workflow.md

@@ -0,0 +1,145 @@
+# Linux 开发机清理工作流
+
+用于大范围审计、交互式清理规划，或已授权执行。按这台机器裁剪清单。某个工具或路径不存在是结果，不是错误。
+
+基线写到清单，并另存一份不覆盖的记录，例如 `/tmp/cleanup-YYYYMMDD-manifest.txt`。
+
+## 只读发现
+
+提出方案之前先抓初始快照：
+
+- `df -h /` 与 `df -ih /`。只报根分区。overlay 行和同一文件系统上的 loop 是同一块盘的另一种视图，不相加。光盘或 ISO 挂载（例如 `/dev/sr0`）不占根分区。
+- `du -xh --max-depth=1` 从 `/`、`/var`、`/var/lib`、`/var/tmp`、`/home`、`/root` 和大型项目根开始。跳过 overlay 挂载点。inode 紧张时再查文件数量。
+- `docker system df`，以及 `docker ps` 的名字、状态、健康。数据根用 `docker info -f '{{.DockerRootDir}}'`。
+- `journalctl --disk-usage`，`du -sh /var/cache/apt/archives /var/log`。
+- `snap list --all` 里的 disabled 修订。`uname -r` 和已安装的 `linux-image-*`。
+- 各用户的语言缓存：`go env GOCACHE GOMODCACHE`、`npm config get cache`、Cargo registry、Gradle caches、Maven repository、pnpm store。把缓存目录和工具链目录分开。
+
+体积扫描可能很贵。从已知的大目录往下钻，不要对同一 overlay 再走一遍。
+
+## 给候选分类
+
+| 类别 | 通常怎么处理 | 主要风险 |
+| --- | --- | --- |
+| 过期临时目录 | 无进程、mtime 已旧、清单点名后按确切路径删除 | 父目录里还有别的工作 |
+| 可重建构建缓存 | 官方命令：`cargo clean`、`go clean -cache` | 下次编译变慢，源码必须留下 |
+| 可重新下载的依赖缓存 | 第二波：module、registry、Gradle caches、Maven repository | 离线时无法马上重建 |
+| Docker 未使用数据 | 先看挂载，再按下面的顺序 prune | 匿名 volume 里可能有已停止栈的数据 |
+| 包缓存与旧 snap 修订 | `apt-get clean`；只删 disabled 修订 | 误卸当前 snap 或回退内核 |
+| 日志 | `journalctl --vacuum-size=`，需要时再写上限 | 丢掉旧日志 |
+| 业务数据 | 除非被点名，否则保留 | bind mount 上的数据库、对象存储、索引 |
+| 工具链与会话 | 保留，除非单独点名 | 拆掉正在用的运行时或会话 |
+
+目录大不等于可以删除。写清谁拥有它、能不能重建、支撑哪条工作流、必须留下什么。
+
+运行中的数据库、对象存储和搜索服务经常把数据 bind 到宿主机目录，而不是 Docker volume。匿名 volume 显示为 dangling 时，先 `docker inspect` 确认没有容器引用，再 prune。
+
+## 清单合同
+
+```markdown
+# Linux 磁盘清理清单
+
+> 更新时间：YYYY-MM-DD
+> 当前状态：只读排查 / 决策中 / 已授权执行 / 已完成
+
+## 基线
+| 文件系统 | 总空间 | 已用 | 可用 | 使用率 | inode 使用率 |
+
+## 已批准清理
+| 编号 | 项目 | 决定 | 已知大小 | 精确边界 | 状态 |
+
+## 明确保留
+| 编号 | 项目 | 保留边界 |
+
+## 待确认
+| 编号 | 项目 | 风险/收益 | 问题 |
+
+## 执行记录
+| 时间 | 项目 | 方法 | 结果 | df 变化 |
+```
+
+候选编号跨批次保持稳定。用户收窄边界后，后续项都按新边界做。已经删掉的内容如实记录。
+
+## 执行阶段
+
+路径互不重叠的已批准项可以并行。编排者先写基线，最后统一验收。并行不能改变下面的 Docker 顺序。
+
+### 1. 点名的过期临时目录
+
+- 删除前确认路径是目录、清单写了完整路径、没有进程占用。
+- 一次删除一个确切路径。不删除 `/var/tmp` 或 `/tmp` 本身，不删除 `systemd-private-*`。
+- 父目录里还有未点名的子树时，停止并报告，不删父目录。
+
+### 2. Docker
+
+先记录每个运行中容器的 Mounts，以及因此必须留下的 volume ID。
+
+1. `docker rm` 只针对清单点名、且当前不是 running 的容器。正在运行的不删。
+2. `docker volume prune -f`。prune 之后，清理前记下的 volume ID 必须还在。
+3. `docker image prune -a -f`。仍被任何容器（含未删除的已退出容器）引用的镜像会留下。
+4. `docker builder prune -f`。随后看 `docker system df`。Build Cache 的 RECLAIMABLE 仍高于清单里的阈值（默认可按 1G）时，再执行一次 `docker builder prune -af`。
+
+不运行 `docker system prune -a --volumes`。不把 `docker volume prune` 放进 cron。
+
+### 3. 构建缓存
+
+优先用官方命令，并且只作用于清单点名的树或用户：
+
+- 在点名的 Cargo 项目里执行 `cargo clean`。失败时只删除该项目的 `target/`。
+- `go clean -cache`。`sudo -u` 找不到 `go` 时改用绝对路径。
+- `npm cache clean --force`。它不清 `_npx`；`_npx` 未单独批准就留下。
+
+不从家目录或仓库根递归删除 `dist`、`build`、`node_modules`、`.next`。
+
+### 4. 包、snap、journal
+
+- `apt-get clean` 只清 `/var/cache/apt/archives`。
+- `apt-get autoremove --purge --dry-run`。待删除列表含回退内核、桌面元包、docker、containerd 或其他运行时则不执行。列表只有明确的孤儿包时才真正 autoremove。
+- 对 `snap list --all` 里带 disabled 的行执行 `snap remove <name> --revision=<rev>`。不带 `--revision` 就不删。不卸载 snapd。
+- 清单写明时：`journalctl --vacuum-size=200M`。需要持久上限时写入 `/etc/systemd/journald.conf.d/size-cap.conf`：
+
+```
+[Journal]
+SystemMaxUse=200M
+```
+
+然后 `systemctl restart systemd-journald`。重启失败就报告，不反复重试。
+
+回收站和 `/var/crash` 只在清单点名时清空内容，目录本身留下。
+
+### 5. 第二波：需要重新下载的依赖缓存
+
+第一波验收通过，且清单单独批准之后才做：
+
+- `go clean -modcache`
+- 删除 Cargo 的 `registry` 目录，保留 `bin`
+- 删除 Gradle 的 `caches`，保留 `wrapper`
+- 删除 Maven 的 `repository`，保留 `~/.m2/settings.xml`
+- `pnpm store prune`。仍被项目引用的包会留下，这是预期结果
+- 浏览器只清 Cache 与 Code Cache 子目录，不删 `~/.config` 里的配置
+
+## 硬停
+
+出现下列任一情况，停止受影响的项并报告证据：
+
+- 要保留的容器不再 Up，或点名的数据目录大小变了。
+- prune 之后，清理前还被容器挂载的 volume 不见了。
+- 删除范围从点名路径扩到父目录，或父目录里有未识别内容。
+- dry-run 要移除回退内核、桌面或运行时。
+- 当前内核被列进待删除包。
+- 缺少执行该项所需的权限。
+
+## 最终验收
+
+- `df -h /` 的可用空间，以及相对基线的实际增量。目录 `du` 之和不必等于 `df` 的变化。
+- `docker ps` 的名字、状态、健康与清理前的运行集合一致，除非清单批准过停掉其中某一个。
+- 点名的业务数据目录大小未变。
+- `uname -r` 不变，回退内核仍是 `ii`。
+- 点名项目的源码还在，生成目录（例如 `target/`）已空。
+- 清单写明保留的工具链和会话目录还在。
+
+## 一次实测里学到的边界
+
+2026-10-05，一台 Ubuntu 开发机根分区 196G，从 94%（剩余 12G）降到 38%（剩余 117G）。最大的几项是：三个已无进程的 `/var/tmp` 工作目录、84 个无引用匿名 volume、一个 Tauri 项目的 `target/`、Go build cache、未使用镜像和 build cache。19 个业务容器使用 bind mount，清理后仍全部健康；两个正在使用的 Kafka volume 被 prune 留下。
+
+同一台机器上，一个 828M 的项目 `temp/` 因为里面还有未点名的子树而整目录保留。pnpm store 在 prune 之后几乎没变，因为包仍被项目引用。这些是分类规则的例子，不是可以在别的机器上照路径重放的删除列表。

package/skills-hub/system/optimize-codex-config/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ting'an Wang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills-hub/system/optimize-codex-config/SKILL.md

@@ -0,0 +1,101 @@
+---
+name: optimize-codex-config
+description: 初始化、只读体检或修复 Codex CLI / Claude Code 配置，设置五小时、周额度与上下文状态栏，关闭遥测和外部检测，诊断 config.toml、settings.json、413 或 compaction。修改前展示脱敏 diff 并取得本次明确确认；不接管 CC Switch、账号额度、远端 API 或反向代理。
+license: MIT
+compatibility: Node.js >=22.16.0. Self-contained offline scripts; no runtime npm install. Linux/macOS guarded apply; native Windows doctor/plan/verify only. No credential-content reads or automatic CLI/network probes.
+metadata:
+  author: NAMEWTA
+  wta-format-reviewed: '2026-10-10'
+---
+
+# AI CLI Config
+
+稳定调用名仍是 `$optimize-codex-config`；覆盖 **Codex CLI 和 Claude Code**，不创建依赖兄弟技能的别名。以本机事实驱动：**发现 → 体检 → 计划 → 本次确认 → 最小写入 → 验证／恢复备份**。
+
+默认 `local-private`：遥测、反馈、外部域名预检、远程目录刷新、自动更新均提出关闭；只显示宿主已经提供的额度，不读取账号凭据查询额度。普通模型调用、云端数据政策与本机遥测开关不是同一件事。
+
+## 1. 确认环境和范围
+
+区分初始化、故障修复、隐私收敛和只设置状态栏。明确客户端、用户级／项目级，以及实际主机：当前容器、WSL、远程机器不是用户电脑。路径按显式参数 → `CODEX_HOME` / `CLAUDE_CONFIG_DIR` → 用户默认目录解析；项目根目录必须明确，worktree/旧版 Claude 本地设置位置不能猜测。
+
+读取 [配置层级与版本契约](references/configuration-contract.md)。原目录不存在是正常初始化状态，不是损坏。已有目录／文件或祖先为符号链接、junction、非普通文件时停止自动写入；不得换工具绕过权限拒绝。
+
+从本 SKILL.md 所在目录运行；先看 `--help`：
+
+```bash
+node scripts/ai-cli-config.mjs doctor --client all --scope user --json
+```
+
+自定义目录使用 `--codex-home <absolute-directory>`、`--claude-home <absolute-directory>`；项目上下文使用 `--project <absolute-project-root>`。`--client claude` / `codex` 限定单个客户端。此命令不启动 CLI、MCP、hooks、插件或 helper，不扫描会话正文；认证仅检查文件元数据。
+
+**完成标准：** 主机、路径、作用域、缺失／损坏文件、配置来源、继承环境冲突和未知能力均被如实记录。报告不能包含配置原文、密钥、provider URL、命令秘密参数或认证内容。
+
+## 2. 选择最小方案
+
+读取 [优化方法](references/optimization-method.md) 和 [隐私策略](references/privacy.md)。不要把最高推理、最大上下文、更多 Agent、关闭沙箱或安装更多插件当作默认优化。模型、供应商、审批、沙箱、MCP、hooks、历史和用户未知键默认保留；相关问题单独形成确认包。
+
+内置确定性写入限于经过版本核验的隐私控制和状态栏：
+
+| 模式 | 用途 |
+|---|---|
+| `local-private` | 隐私控制＋原生额度状态栏；默认 |
+| `privacy-only` | 只收敛非必要外部流量，不换已有状态栏 |
+| `statusline-only` | 只设置状态栏；不宣称其他隐私项已关闭 |
+
+Codex 用原生 `tui.status_line`；Claude 用 [stdin-only renderer](scripts/statusline/claude-statusline.mjs)。读取 [状态栏数据契约](references/statusline.md)：Codex 原生限额是剩余，Claude 输入百分比是已用；缺失不能变成 0% 或伪造余额。不得抓 cookie、读 OAuth、调用非公开接口或设置后台额度轮询。
+
+项目模式不会暗改 HOME。Claude 个人项目配置写 `.claude/settings.local.json`；确认真实宿主加载位置，并单独检查本地设置与运行资源不会被提交进 Git。Codex 机器级 telemetry/provider 不能靠项目配置覆盖：`requires_user_scope` 是阻断，不是放宽作用域的授权。
+
+**完成标准：** 每个目标值有理由和适用范围；未知集成保留并标记“未验证”；不把外部预检关闭描述成安全性全面提高。
+
+## 3. 核验能力并生成脱敏计划
+
+官方网页是配置契约，不证明用户安装的版本支持该键。按 [CLI 使用与能力证据](references/cli.md) 填写本地能力记录，模板是 [capabilities.example.json](assets/capabilities.example.json)。只记录已核验的版本、键、状态项目、作用域及更高优先级来源；不能为了让计划通过而批量填“已验证”。未知、过期、托管限制或无法核验的能力阻止写入，但不阻止只读报告。
+
+不自动执行可能联网的客户端 doctor、登录或模型探测。已有本地版本信息、已授权且确认无外部副作用的本地帮助和当前官方契约可用于核验；不得读取认证内容补证据。外部检测仍保持关闭。
+
+```bash
+node scripts/ai-cli-config.mjs plan --client all --scope user \
+  --mode local-private --evidence <absolute-capabilities.json> \
+  --out <absolute-review.plan.json> --json
+```
+
+`plan` 本身不改配置；`--out` 只明确授权创建一个新的私有计划文件，父目录需已存在。计划列出逐文件目标、指纹、语义脱敏 diff、保留项、blocker、备份位置、原子替换方法和未验证项。它不保存完整原配置。已有 Claude 回调只有在用户选择替换后才加 `--replace-statusline` 并重新生成计划。
+
+**完成标准：** 用户已看到全部目标与代价；`ready` 只是静态计划可供确认，不等于当前 writer、宿主加载或真实额度已验证。
+
+## 4. 本次确认后应用
+
+用户必须在看到计划后给出本次明确确认；计划 ID 是完整性标识，不是授权来源。关闭或暂停相关配置管理器及会触发 ConfigChange 的会话，再由用户确认处于静止状态。不能自动杀进程、关闭安全 hooks 或伪造 `--quiescent`。
+
+```bash
+node scripts/ai-cli-config.mjs apply --plan <absolute-review.plan.json> \
+  --confirm <exact-plan-id> --quiescent --json
+```
+
+读取 [事务与平台边界](references/transactions.md)。脚本取得自身排他锁，重新核验全部观察项，检查目标可写句柄，将 `*.pre-optimize.bak` 保存在私有事务目录，先暂存再逐文件原子提交。缺失文件使用不覆盖创建；Claude 运行脚本复制到内容寻址的稳定目录，不依赖 npm 缓存或技能安装位置。
+
+Linux/macOS writer 观测 unknown 或 busy 时阻断。原生 Windows 的句柄与 ACL 支持尚未达到自动写入门槛，**仅提供 doctor/plan/verify**；不能改用 WSL 或直接写文件绕过这个边界。多文件不是瞬时原子事务，也不承诺断电自动恢复。
+
+**完成标准：** 只写本次确认集合；无强制覆盖、无全局 shell 环境修改、无认证内容操作。异常时尝试安全恢复备份，后续用户编辑存在则停止回滚并保留现场。
+
+## 5. 验证和故障处理
+
+```bash
+node scripts/ai-cli-config.mjs verify --plan <absolute-review.plan.json> --json
+node scripts/ai-cli-config.mjs rollback --plan <absolute-review.plan.json> \
+  --confirm <exact-plan-id> --quiescent --json
+```
+
+离线验证覆盖本机 hash、完整语法、已观察的策略与依赖指纹；不代表真实宿主已经加载、账号额度可用、远端政策或既有集成零出网。重新打开宿主后由用户检查原生状态栏、配置来源和保留功能；不为验收额度而额外发起模型或账号请求。
+
+出现 401/403/404/413/429、SSE、超时或 compaction 故障，按 [故障诊断](references/troubleshooting.md) 分离本机、认证、供应商与代理证据。旧脚本保留用于用户明确选择的 Codex 会话诊断，默认不再执行 CLI 探针：
+
+```bash
+node scripts/audit-codex-config.mjs --codex-home <absolute-directory> \
+  --no-command-probes --since-days 7 --json
+```
+
+不通过提高上下文窗口、无限重试、关闭 TLS 校验或放宽权限修复稳定错误。不接管 CC Switch 数据库、反向代理或远端 API；外部问题只交接。
+
+**交付固定为：** 已改变、已保留、已验证、未验证、阻断和回滚结果。真实设备、账号测试、跨平台 CI、离线 fixtures 和模型选择评估分别报告，未执行的项目不能标记通过。

package/skills-hub/system/optimize-codex-config/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "AI CLI 配置维护"
+  short_description: "体检 Codex 与 Claude 配置、隐私及额度状态栏，确认后安全修改并可回滚。"
+  default_prompt: "请使用 $optimize-codex-config：先只读体检本机 Codex CLI 和 Claude Code，规划隐私收敛与原生额度状态栏；展示脱敏 diff，未经本次明确确认不要修改。"