network-proxy-guard 0.1.0 → 0.1.1

package/README.md

@@ -7,37 +7,36 @@
 
 **安装不会配置网络，也不会清理 Claude。** 配置和清理分别默认 dry-run，必须明确使用 `--yes` 才会执行。
 
-## 功能
+## 实测参考环境（非强制）
 
-- Clash Verge：保留旧配置、备份、生成并激活 VLESS Reality 本地配置、规则模式、关闭 PAC 直连兜底
-- 分流诊断：区分直连/显式代理/VPS 直连，检查 AI、Google、Stripe 等域名的实际路径
-- Google 地区检测：VPS 直连证据 + 多地理库交叉验证，证据足够才生成工单草稿
-- Claude 重置：独立确认，清理常见 Claude Code/Desktop/CC Switch 配置，保留程序与共享 skills
-- 手机交付：同一份节点配置生成 VLESS 链接与本地二维码，不调用在线二维码服务
-- Xray 服务端：提供带确认、备份、验证的 Reality 配置 runbook，不盲目复制固定端口或伪装域名
+这套工具的最初实测环境是：
 
-## 环境
+- **VPS 商家**：LisaHost（丽萨主机）
+- **套餐**：**美国4837基础版**（`US-LAX-4837`，洛杉矶）
+- **服务端**：Xray + VLESS Reality + XTLS Vision
+- **客户端**：Clash Verge Rev / mihomo、Shadowrocket
 
-- macOS（自动 Clash Verge 配置）
-- Node.js 18+
-- Clash Verge Rev / mihomo（仅客户端配置需要）
-- VPS 直连检测需要已有 SSH 密钥登录；不会询问或保存 SSH 密码
+Lisa 不是必选商家，其他 VPS 和套餐可以自行尝试。不同商家的上游端口政策、IP 历史、Google 地区判定和国际线路表现可能不同，不能默认复现同样的结果；尤其不要把这里的 4837 实测经验直接套到 9929、CN2 GIA 或其他线路上。
+
+## 快速开始
 
-## npm 安装
+### 安装 skill
 
-### LEE / 通用 agents
+LEE / 通用 agents：
 
 ```bash
 npx network-proxy-guard@latest install --target agents
 ```
 
-### Claude Code 或 Codex
+Claude Code / Codex：
 
 ```bash
 npx network-proxy-guard@latest install --target claude
 npx network-proxy-guard@latest install --target codex
 ```
 
+安装后重启对应 Agent。更新已安装 skill 时，`install --force` 会先保留旧目录备份，不会直接删除。
+
 也可以先全局安装命令，再安装 skill：
 
 ```bash
@@ -45,7 +44,34 @@ npm install -g network-proxy-guard
 network-proxy-guard install --target agents
 ```
 
-安装后重启对应 Agent。更新已安装 skill 时，`install --force` 会先保留旧目录备份，不会直接删除。
+### 查看全部功能和完整流程
+
+直接列出 CLI 命令和实测参考环境：
+
+```bash
+npx network-proxy-guard@latest --help
+npx network-proxy-guard@latest reference
+```
+
+安装 skill 后，也可以在 Agent 中直接输入：
+
+> 列出 network-proxy-guard 的全部功能、完整使用流程和安全确认步骤。
+
+## 功能
+
+- Clash Verge：保留旧配置、备份、生成并激活 VLESS Reality 本地配置、规则模式、关闭 PAC 直连兜底
+- 分流诊断：区分直连/显式代理/VPS 直连，检查 AI、Google、Stripe 等域名的实际路径
+- Google 地区检测：VPS 直连证据 + 多地理库交叉验证，证据足够才生成工单草稿
+- Claude 重置：独立确认，清理常见 Claude Code/Desktop/CC Switch 配置，保留程序与共享 skills
+- 手机交付：同一份节点配置生成 VLESS 链接与本地二维码，不调用在线二维码服务
+- Xray 服务端：提供带确认、备份、验证的 Reality 配置 runbook，不盲目复制固定端口或伪装域名
+
+## 环境
+
+- macOS（自动 Clash Verge 配置）
+- Node.js 18+
+- Clash Verge Rev / mihomo（仅客户端配置需要）
+- VPS 直连检测需要已有 SSH 密钥登录；不会询问或保存 SSH 密码
 
 ## 使用
 

package/bin/network-proxy-guard.js

@@ -10,8 +10,9 @@ import { generateMobileQr } from '../src/qr.js';
 import { resetClaude } from '../src/claude-reset.js';
 import { detectGoogleRegion, buildLisaTicket, probeNetwork } from '../src/diagnostics.js';
 import { atomicWrite, expandHome } from '../src/utils.js';
+import { REFERENCE_ENVIRONMENT } from '../src/reference.js';
 
-const HELP = `network-proxy-guard 0.1.0
+const HELP = `network-proxy-guard
 
 Install the agent skill (no proxy/Claude changes):
   npx network-proxy-guard@latest install --target agents
@@ -19,6 +20,7 @@ Install the agent skill (no proxy/Claude changes):
   npx network-proxy-guard@latest install --target codex
 
 Commands:
+  reference     Show the non-mandatory LisaHost reference environment
   install       Install only the skill files [--target agents|claude|codex|DIR] [--force]
   setup         Preview Clash Verge setup; --config FILE [--yes] [--restart]
                 Optional: --verge-dir DIR --enable-tun --qr-dir DIR
@@ -59,6 +61,11 @@ async function main() {
     return;
   }
 
+  if (command === 'reference') {
+    print(REFERENCE_ENVIRONMENT);
+    return;
+  }
+
   if (command === 'install' || command === 'install-skill') {
     const values = options(args, { target: { type: 'string', default: 'agents' }, force: { type: 'boolean', default: false } });
     print(installSkill(values));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "network-proxy-guard",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Consent-first macOS Clash Verge, Xray Reality, Claude reset and network diagnostics skill",
   "license": "MIT",
   "type": "module",

package/skill/network-proxy-guard/SKILL.md

@@ -8,6 +8,10 @@ compatibility: macOS; Node.js 18+; Clash Verge Rev/mihomo for automatic client s
 
 Configure and diagnose a working proxy without silently changing the user's machine. The npm installer copies files only. Reading this skill never authorizes setup, cleanup, restarts, SSH changes, ticket submission, or package installation.
 
+## Reference environment (not a requirement)
+
+The original tested setup used **LisaHost（丽萨主机）美国4837基础版** (`US-LAX-4837`, Los Angeles), Xray + VLESS Reality + XTLS Vision, Clash Verge Rev/mihomo and Shadowrocket. Other VPS providers and plans are allowed, but users must revalidate port policy, IP history, Google region detection and route quality. Do not generalize the 4837 results to 9929, CN2 GIA or other networks. Run `network-proxy-guard reference` to show this as structured data.
+
 ## Safety contract
 
 1. Start with read-only inspection or a dry-run. Never pass `--yes` on the first inspection.

package/src/reference.js

@@ -0,0 +1,9 @@
+export const REFERENCE_ENVIRONMENT = Object.freeze({
+  required: false,
+  provider: 'LisaHost（丽萨主机）',
+  plan: '美国4837基础版',
+  region: 'US-LAX-4837（洛杉矶）',
+  server: 'Xray + VLESS Reality + XTLS Vision',
+  clients: ['Clash Verge Rev / mihomo', 'Shadowrocket'],
+  note: 'Lisa 不是必选商家。其他 VPS 和套餐可以自行尝试，但端口政策、IP 历史、Google 地区判定和线路表现必须重新验证；不要把 4837 的实测经验直接套到 9929、CN2 GIA 或其他线路。',
+});