ysagc-agent 0.1.0 → 0.3.0

package/README.md

@@ -6,39 +6,31 @@
 - 通信：JSON-RPC 2.0 over WebSocket（控制通道）+ 二进制帧（终端通道）
 - 路径沙箱：只能操作 allowlist（用户显式添加的项目根目录）内路径
 - 终端：node-pty（Windows: PowerShell / macOS·Linux: 默认 shell），输入输出**不经过网站后端**
+- **免配对码**（v0.2.0）：浏览器打开网站「工作台」自动识别并连接本机代理，无需输入配对码、无需安装 exe
+- **目录树浏览 + 技能链接安装**（v0.3.0）：新增 `fs.browse`（网页内逐级选文件夹）与 `skill.installFromUrl`（从链接下载安装技能）
 
-## 安装（两种渠道任选）
+## 安装（npm 方式，全球通用）
 
-### ① 安装包（普通用户）
-
-到网站「工作台 → 下载」页，按你的系统下载安装包：
-
-| 平台 | 形态 |
-|---|---|
-| Windows 10/11 | `ysagc-agent.exe`（单文件，免装 Node） |
-| macOS 12+ | 单文件二进制（未签名，首次需右键「打开」） |
-| Linux (Ubuntu 20.04+/Debian 11+) | 单文件二进制（AppImage 敬请期待） |
-
-Windows 若被杀软拦截：选择「仍要运行」，或在 Windows 安全中心放行。
-
-### ② npm（开发者用户）
+要求 Node.js ≥ 20（Windows / macOS / Linux 均可）。
 
 ```bash
-# 免安装，直接跑
+# 方式一：免安装，直接跑（推荐，首次会下载依赖包）
 npx ysagc-agent
 
-# 或全局安装
+# 方式二：全局安装后运行
 npm i -g ysagc-agent
 ysagc-agent
 ```
 
-要求 Node.js ≥ 20。
+启动后终端会显示 `ysagc-agent 运行中: ws://127.0.0.1:37890`，保持该终端窗口开启即可（最小化没问题，不要关闭）。
 
 ## 使用流程
 
-1. 启动后终端会显示 **6 位配对码**（10 分钟有效）。
-2. 打开网站 → 设置 → 设备管理 → 输入配对码 → 配对成功。
-3. 在网站添加项目（本机文件夹 / 克隆仓库 / 从零创建），即可开始使用工作台。
+1. 打开终端执行 `npx ysagc-agent`（保持运行）。
+2. 打开网站「工作台」，点击「新增工作区」→ 选择本机文件夹。
+3. 在聊天中把话题「绑定工作区」后，AI 就能在对应文件夹里读文件、改代码、跑命令了。
+
+> 旧版（0.1.x）安装包渠道与配对码流程已不再需要；如需卸载：`npm rm -g ysagc-agent`。
 
 ## 配置（agent.json）
 
@@ -47,8 +39,9 @@ ysagc-agent
 ```jsonc
 {
   "port": 37890,               // 端口被占用自动 +1（最多 5 次）
-  "allowedRoots": [],          // 授权项目根目录（网站添加项目时自动写入）
-  "deviceTokenWhitelist": [],  // 已配对设备令牌（sha256）
+  "allowedRoots": [],          // 授权项目根目录（网站添加工作区时自动写入）
+  "deviceTokenWhitelist": [],  // 旧版配对令牌（sha256，兼容保留）
+  "originWhitelist": [],       // 允许直连的浏览器 Origin；留空=自动信任站点与 localhost
   "trashEnabled": true,        // 删除进回收站
   "trashRetentionDays": 7,
   "enableTerminal": true,      // 终端开关
@@ -64,13 +57,15 @@ ysagc-agent
 
 **Q：端口被占用怎么办？** 自动尝试 37891–37894；也可 `ysagc-agent --port <端口>` 指定。
 
-**Q：macOS 提示"无法打开"？** 未签名应用：右键（或 Control+点击）→ 打开；或 系统设置 → 隐私与安全性 → 仍要打开。
+**Q：网页提示"未检测到本机代理"？** 确认 Agent 已在终端运行（能看到 `运行中: ws://127.0.0.1:37890`）；首次 `npx` 会先下载依赖，稍等片刻。
 
-**Q：连不上网站？** 确认 Agent 正在运行、配对码未过期；网站「设备管理」页有一键自检。
+**Q：macOS 提示"无法打开"？** npm 方式无需处理；仅安装包渠道需要右键 → 打开。
 
 **Q：日志在哪？** `~/.ysagc-agent/logs/agent.log`。日志**永不记录**密钥文件内容与 Git 凭证。
 
-**Q：Agent 会读取我电脑上的所有文件吗？** 不会。Agent 只能访问你在网站显式添加的项目目录（allowlist），越界操作一律拒绝并记录审计；终端除外（终端等同于你的命令行，可操作整台电脑——首次使用会在网页端弹安全确认）。
+**Q：Agent 会读取我电脑上的所有文件吗？** 不会。Agent 只能访问你在网站显式添加的工作区目录（allowlist），越界操作一律拒绝并记录审计；终端除外（终端等同于你的命令行，可操作整台电脑——首次使用会在网页端弹安全确认）。
+
+**Q：其他网站能控制我的 Agent 吗？** 不能。Agent 只信任站点域名与 localhost 来源（Origin 白名单），其他网页发起的连接会被拒绝。
 
 ## 开发
 
@@ -81,7 +76,7 @@ npm run smoke        # 冒烟测试（WS 鉴权 / RPC / 终端全链路）
 node scripts/smoke.js <token> <port>   # 自定义参数
 ```
 
-打包（单文件）：
+打包（单文件，可选）：
 
 ```bash
 npx @yao-pkg/pkg . --target node22-win-x64 --output dist/ysagc-agent.exe
@@ -93,4 +88,4 @@ CI：`.gitlab-ci.yml`（build 产物 + tag 触发发布到 Package Registry / np
 
 ## 隐私
 
-Agent 与网站后端的交互仅限：配对码上报、版本握手、审计元数据。**项目文件内容、终端输入输出、Git 凭证一律不经过网站后端**。
+Agent 与网站后端的交互仅限：设备自动注册、版本握手、审计元数据。**项目文件内容、终端输入输出、Git 凭证一律不经过网站后端**。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ysagc-agent",
-  "version": "0.1.0",
-  "description": "代码工作台本机代理：替浏览器在本机执行文件/Git/终端操作（JSON-RPC over WebSocket，直连 127.0.0.1）",
+  "version": "0.3.0",
+  "description": "代码工作台本机代理：替浏览器在本机执行文件/Git/终端操作（JSON-RPC over WebSocket，直连 127.0.0.1，免配对码）",
   "main": "src/index.js",
   "bin": {
     "ysagc-agent": "src/index.js"

package/src/config.js

@@ -27,8 +27,13 @@ const DEFAULTS = {
   // 终端权限：ask（每次询问）/ allow（始终允许）/ deny（拒绝）
   terminalPermission: 'ask',
   // 协议版本（与后端握手比对）
-  protocolVersion: 1,
+  protocolVersion: 2,
   agentVersion: null,
+  // ---- 免配对码直连（v0.2.0 起）----
+  // 允许的浏览器 Origin 列表（精确匹配 origin，如 https://chat.ysagc.top）。
+  // 为空时自动信任：backendUrl 对应的 origin + http://localhost / http://127.0.0.1 及其任意端口。
+  // 该列表之外的 Origin 发起的 WebSocket / 本地 HTTP 请求将被拒绝（防恶意网页操控本机代理）。
+  originWhitelist: [],
 };
 
 function ensureDir() {

package/src/http-fs.js

@@ -13,6 +13,8 @@ const path = require('path');
 const crypto = require('crypto');
 const url = require('url');
 
+const { isOriginTrusted } = require('./origin');
+
 const MAX_UPLOAD_SIZE = 512 * 1024 * 1024; // 512MB
 const MAX_ZIP_FILES = 2000;
 
@@ -24,7 +26,12 @@ function createHttpFsHandlers(ctxRef) {
   const sandbox = () => ctxRef().sandbox;
   const cfg = () => ctxRef().config;
 
-  function checkToken(token) {
+  function checkToken(token, req) {
+    // 免配对码直连（v0.2.0）：Origin 受信任的浏览器请求直接放行
+    if (req) {
+      const origin = req.headers && req.headers.origin;
+      if (origin && isOriginTrusted(origin, cfg())) return true;
+    }
     if (!token) return false;
     return (cfg().deviceTokenWhitelist || []).includes(sha256(token));
   }
@@ -37,7 +44,7 @@ function createHttpFsHandlers(ctxRef) {
   /** 上传：分片追加到临时文件，最后一片 rename 落盘 */
   function handleUpload(req, res, query) {
     const token = query.token;
-    if (!checkToken(token)) return sendJson(res, 401, { code: 'E_AUTH_FAILED', msg: '未授权' });
+    if (!checkToken(token, req)) return sendJson(res, 401, { code: 'E_AUTH_FAILED', msg: '未授权' });
     const relPath = String(query.path || '');
     if (!relPath) return sendJson(res, 400, { code: 'E_VALIDATION', msg: '缺少 path' });
     let r;
@@ -89,7 +96,7 @@ function createHttpFsHandlers(ctxRef) {
   /** 单文件下载（流式） */
   function handleDownload(req, res, query) {
     const token = query.token;
-    if (!checkToken(token)) return sendJson(res, 401, { code: 'E_AUTH_FAILED', msg: '未授权' });
+    if (!checkToken(token, req)) return sendJson(res, 401, { code: 'E_AUTH_FAILED', msg: '未授权' });
     const relPath = String(query.path || '');
     let r;
     try {
@@ -111,7 +118,7 @@ function createHttpFsHandlers(ctxRef) {
   /** zip 打包下载（yazl 流式） */
   function handleZip(req, res, query) {
     const token = query.token;
-    if (!checkToken(token)) return sendJson(res, 401, { code: 'E_AUTH_FAILED', msg: '未授权' });
+    if (!checkToken(token, req)) return sendJson(res, 401, { code: 'E_AUTH_FAILED', msg: '未授权' });
     const paths = String(query.paths || '')
       .split(',')
       .map((p) => p.trim())

package/src/index.js

@@ -20,6 +20,7 @@ const fs = require('fs');
 const { loadConfig, saveConfig, CONFIG_DIR } = require('./config');
 const logger = require('./logger');
 const { register, handleRequest } = require('./rpc');
+const { isOriginTrusted } = require('./origin');
 const { registerSystemMethods } = require('./methods/system');
 const { createTerminalMethods } = require('./methods/terminal');
 const { createProjectMethods } = require('./methods/project');
@@ -27,9 +28,11 @@ const { createFsMethods } = require('./methods/fs');
 const { createSkillMethods } = require('./methods/skill');
 const { createGitMethods } = require('./methods/git');
 const { createScaffoldMethods } = require('./methods/scaffold');
+const { createDialogMethods } = require('./methods/dialog');
+const { createBrowseMethods } = require('./methods/browse');
 const { createHttpFsHandlers } = require('./http-fs');
 const { Sandbox } = require('./sandbox');
-const { startPairing, stopPairing } = require('./pairing');
+const { startPairing, stopPairing, agentId } = require('./pairing');
 
 const DEFAULT_PORT = 37890;
 const MAX_PORT_TRIES = 5;
@@ -47,6 +50,26 @@ function getArg(name) {
   return i >= 0 ? argv[i + 1] : null;
 }
 
+const AGENT_VERSION = require('../package.json').version;
+if (argv.includes('--help') || argv.includes('-h')) {
+  console.log(`ysagc-agent v${AGENT_VERSION} — 代码工作台本机代理
+用法: npx ysagc-agent [选项]
+
+选项:
+  --port N          指定监听端口（默认 37890，被占用自动 +1）
+  --init-token <t>  把指定 token 加入白名单（兼容旧版配对，一般无需使用）
+  --help, -h        显示帮助
+  --version, -v     显示版本
+
+启动后无需配对码：浏览器打开网站「工作台」即可自动识别本机代理并连接。
+代理仅监听 127.0.0.1，替浏览器在本机执行文件 / Git / 终端操作。`);
+  process.exit(0);
+}
+if (argv.includes('--version') || argv.includes('-v')) {
+  console.log(AGENT_VERSION);
+  process.exit(0);
+}
+
 // ---------------- 配置 ----------------
 let config = loadConfig();
 logger.setLevel(config.logLevel);
@@ -80,6 +103,10 @@ const gitMethods = createGitMethods(() => configRef);
 gitMethods.register(register);
 const scaffoldMethods = createScaffoldMethods(() => configRef);
 scaffoldMethods.register(register);
+const dialogMethods = createDialogMethods();
+dialogMethods.register(register);
+const browseMethods = createBrowseMethods();
+browseMethods.register(register);
 
 // ---------------- WS 服务 ----------------
 const state = {
@@ -136,6 +163,8 @@ function setupConnection(ws, req) {
   ws.isAlive = true;
   ws.authed = false;
   ws.deviceId = null;
+  // 免配对码直连：Origin 可信的浏览器连接无需 deviceToken（v0.2.0）
+  ws.originTrusted = isOriginTrusted(req.headers.origin, configRef.config);
   ws.authTimer = setTimeout(() => {
     if (!ws.authed) closeWith(ws, 4401, 'auth timeout');
   }, AUTH_TIMEOUT_MS);
@@ -167,9 +196,10 @@ function setupConnection(ws, req) {
     // ---- 鉴权握手 ----
     if (msg && msg.type === 'auth') {
       if (ws.authed) return;
-      const ok = checkAuthToken(msg.token);
-      if (!ok) {
-        logger.warn(`[ws] 鉴权失败：token 不在白名单（remote=${req.socket.remoteAddress}）`);
+      const tokenOk = checkAuthToken(msg.token);
+      const autoOk = ws.originTrusted && (msg.mode === 'auto' || !msg.token);
+      if (!tokenOk && !autoOk) {
+        logger.warn(`[ws] 鉴权失败：token 不在白名单且 Origin 不受信任（origin=${req.headers.origin || 'none'} remote=${req.socket.remoteAddress}）`);
         closeWith(ws, 4401, 'unauthorized');
         return;
       }
@@ -275,20 +305,52 @@ function setupConnection(ws, req) {
 function tryListen(port, triesLeft) {
   const httpFs = createHttpFsHandlers(() => configRef);
   const server = http.createServer((req, res) => {
-    // 本地 HTTP：上传/下载/zip（T-M1-05）
     const parsed = url.parse(req.url, true);
     const p = parsed.pathname || '';
+    const origin = req.headers.origin || '';
+
+    // CORS 预检（浏览器跨源 fetch 到 http://127.0.0.1 需要）
+    if (req.method === 'OPTIONS') {
+      res.writeHead(204, {
+        'Access-Control-Allow-Origin': origin || '*',
+        'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',
+        'Access-Control-Allow-Headers': 'Content-Type, X-Offset, X-Total, Authorization',
+        'Access-Control-Max-Age': '86400',
+      });
+      res.end();
+      return;
+    }
+    const corsHeaders = (h) => {
+      h['Access-Control-Allow-Origin'] = origin || '*';
+      return h;
+    };
     try {
+      // 免配对码直连：浏览器探测本机 Agent 信息（v0.2.0）
+      if (req.method === 'GET' && p === '/api/bootstrap') {
+        res.writeHead(200, corsHeaders({ 'Content-Type': 'application/json' }));
+        res.end(JSON.stringify({
+          agentId: agentId(),
+          agentVersion: require('../package.json').version,
+          protocolVersion: configRef.config.protocolVersion || 2,
+          port: configRef.config.port,
+          platform: `${process.platform} ${process.arch}`,
+          nodeVersion: process.version,
+          hostname: require('os').hostname(),
+          paired: (configRef.config.deviceTokenWhitelist || []).length > 0,
+          allowAuto: true,
+        }));
+        return;
+      }
       if (req.method === 'POST' && p === '/api/fs/upload') return httpFs.handleUpload(req, res, parsed.query);
       if (req.method === 'GET' && p === '/api/fs/download') return httpFs.handleDownload(req, res, parsed.query);
       if (req.method === 'GET' && p === '/api/fs/zip') return httpFs.handleZip(req, res, parsed.query);
     } catch (e) {
       logger.error(`[http] 处理 ${p} 失败: ${e && e.message}`);
-      res.writeHead(500, { 'Content-Type': 'application/json' });
+      res.writeHead(500, corsHeaders({ 'Content-Type': 'application/json' }));
       res.end(JSON.stringify({ code: 'E_INTERNAL', msg: e && e.message }));
       return;
     }
-    res.writeHead(404, { 'Content-Type': 'application/json' });
+    res.writeHead(404, corsHeaders({ 'Content-Type': 'application/json' }));
     res.end(JSON.stringify({ error: 'not found' }));
   });
 
@@ -343,7 +405,9 @@ function tryListen(port, triesLeft) {
   return server;
 }
 
-console.log(`ysagc-agent v${require('../package.json').version} 启动中（配置目录: ${CONFIG_DIR}）`);
+console.log(`ysagc-agent v${AGENT_VERSION} 启动中（配置目录: ${CONFIG_DIR}，端口: ${config.port}）`);
+console.log(`免配对码直连已启用：打开网站「工作台」即可自动识别本机代理（agentId: ${agentId().slice(0, 8)}...）`);
+console.log('提示: 输入 --help 查看完整选项。');
 tryListen(config.port, MAX_PORT_TRIES);
 
 process.on('SIGINT', () => {

package/src/methods/browse.js

@@ -0,0 +1,91 @@
+/**
+ * fs.browse RPC：本机目录树浏览（v0.3.0）
+ * 用途：新增工作区时在网页内逐级点选文件夹，替代系统原生文件夹选择器（跨平台、无原生弹窗依赖）。
+ * - fs.browse {}            → 返回常见根目录（Windows 盘符 + Home；POSIX / + Home）
+ * - fs.browse { path }      → 返回该目录下的子目录
+ * 安全：仅列出目录名（只读），不做 allowlist 校验（选择后加入 allowlist 才可操作）；
+ * 仅 Origin 受信任的浏览器连接可调用（与其他 RPC 相同的鉴权门槛）。
+ */
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { RpcError } = require('../rpc');
+
+// 目录树浏览时默认隐藏的目录（避免噪声/系统目录）
+const HIDDEN = new Set([
+  '.git', '.svn', '.hg', '.idea', '.vscode', '.vs', '.next', '.nuxt',
+  'node_modules', 'dist', 'build', 'out', 'target', '.cache', '.npm',
+  '$RECYCLE.BIN', 'System Volume Information', 'Windows', 'Program Files',
+  'Program Files (x86)', 'ProgramData', 'AppData', '.gradle', '.m2',
+]);
+
+function listRoots() {
+  const roots = [];
+  const home = os.homedir();
+  if (process.platform === 'win32') {
+    for (let c = 65; c <= 90; c++) {
+      const letter = String.fromCharCode(c);
+      try {
+        if (fs.existsSync(`${letter}:/`)) roots.push({ name: `${letter}:`, path: `${letter}:/` });
+      } catch { /* ignore */ }
+    }
+  } else {
+    roots.push({ name: '/', path: '/' });
+  }
+  if (home) roots.push({ name: 'Home', path: home.replace(/\\/g, '/') });
+  return roots;
+}
+
+function browse(dirPath) {
+  // 无路径 → 根目录
+  if (!dirPath || String(dirPath).trim() === '') {
+    return { path: null, parent: null, roots: listRoots(), entries: [] };
+  }
+  const abs = path.resolve(String(dirPath).trim());
+  let st;
+  try {
+    st = fs.statSync(abs);
+  } catch {
+    throw new RpcError('E_PATH_NOT_FOUND', '目录不存在');
+  }
+  if (!st.isDirectory()) throw new RpcError('E_PATH_NOT_DIR', '不是目录');
+  const parent = path.dirname(abs);
+  const atRoot = parent === abs;
+  const entries = [];
+  let raw;
+  try {
+    raw = fs.readdirSync(abs, { withFileTypes: true });
+  } catch (e) {
+    throw new RpcError('E_PATH_NO_PERMISSION', `无法读取目录: ${e.message}`);
+  }
+  for (const e of raw) {
+    if (!e.isDirectory()) continue;
+    if (e.isSymbolicLink()) continue; // 防符号链接循环
+    if (e.name.startsWith('.') || HIDDEN.has(e.name)) continue;
+    const child = path.join(abs, e.name);
+    try {
+      if (fs.statSync(child).isDirectory()) {
+        entries.push({ name: e.name, path: child.replace(/\\/g, '/') });
+      }
+    } catch { /* 无权限跳过 */ }
+  }
+  entries.sort((a, b) => a.name.localeCompare(b.name, 'zh-CN'));
+  return {
+    path: abs.replace(/\\/g, '/'),
+    parent: atRoot ? null : parent.replace(/\\/g, '/'),
+    roots: atRoot ? listRoots() : [],
+    entries,
+  };
+}
+
+function createBrowseMethods() {
+  return {
+    register(reg) {
+      reg('fs.browse', async (params = {}) => browse(params && params.path));
+    },
+  };
+}
+
+module.exports = { createBrowseMethods };

package/src/methods/dialog.js

@@ -0,0 +1,84 @@
+/**
+ * dialog.* RPC 方法：本机原生对话框（T-M3-xx）
+ * - dialog.pickFolder {} → { path }  打开系统文件夹选择器，返回绝对路径（取消返回 E_DIALOG_CANCELED）
+ * 实现：
+ *   Windows: PowerShell FolderBrowserDialog（Agent 运行在用户本机，可弹原生窗口）
+ *   macOS:   osascript choose folder
+ *   Linux:   zenity / kdialog（依次尝试）
+ * 用途：添加项目时"点击选择文件夹"替代手输绝对路径（需求 4.3.1 方式 A）
+ */
+'use strict';
+
+const { execFile } = require('child_process');
+const { RpcError } = require('../rpc');
+
+const DIALOG_TIMEOUT_MS = 5 * 60 * 1000; // 用户可能挑很久，5 分钟上限
+
+function run(cmd, args, timeoutMs) {
+  return new Promise((resolve, reject) => {
+    execFile(
+      cmd,
+      args,
+      { timeout: timeoutMs || DIALOG_TIMEOUT_MS, windowsHide: true, maxBuffer: 4 * 1024 * 1024 },
+      (err, stdout) => {
+        if (err) return reject(err);
+        resolve(String(stdout || ''));
+      }
+    );
+  });
+}
+
+/** Windows：PowerShell FolderBrowserDialog */
+async function pickFolderWindows() {
+  const ps = [
+    'Add-Type -AssemblyName System.Windows.Forms',
+    "$f = New-Object System.Windows.Forms.FolderBrowserDialog",
+    "$f.Description = '选择要添加到工作台的项目文件夹'",
+    '$f.ShowNewFolderButton = $true',
+    "if ($f.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK) { Write-Output $f.SelectedPath }",
+  ].join('; ');
+  const out = await run('powershell.exe', ['-NoProfile', '-NonInteractive', '-STA', '-Command', ps]);
+  const p = String(out || '').trim().split(/\r?\n/).filter(Boolean).pop() || '';
+  return p;
+}
+
+/** macOS：osascript choose folder */
+async function pickFolderMac() {
+  const out = await run('osascript', ['-e', 'POSIX path of (choose folder with prompt "选择要添加到工作台的项目文件夹")']);
+  return String(out || '').trim();
+}
+
+/** Linux：zenity → kdialog 依次尝试 */
+async function pickFolderLinux() {
+  for (const [cmd, args] of [
+    ['zenity', ['--file-selection', '--directory', '--title=选择要添加到工作台的项目文件夹']],
+    ['kdialog', ['--getexistingdirectory', '选择要添加到工作台的项目文件夹']],
+  ]) {
+    try {
+      const out = await run(cmd, args, 30000);
+      const p = String(out || '').trim();
+      if (p) return p;
+    } catch {
+      /* 尝试下一种 */
+    }
+  }
+  throw new RpcError('E_DIALOG_UNSUPPORTED', '当前系统未安装文件夹选择工具（zenity/kdialog），请手动输入路径');
+}
+
+function createDialogMethods() {
+  return {
+    register(reg) {
+      reg('dialog.pickFolder', async () => {
+        let p = '';
+        if (process.platform === 'win32') p = await pickFolderWindows();
+        else if (process.platform === 'darwin') p = await pickFolderMac();
+        else p = await pickFolderLinux();
+        p = String(p || '').trim();
+        if (!p) throw new RpcError('E_DIALOG_CANCELED', '已取消选择文件夹');
+        return { path: p.replace(/\\/g, '/') };
+      });
+    },
+  };
+}
+
+module.exports = { createDialogMethods };

package/src/methods/skill.js

@@ -48,7 +48,10 @@ function saveState(state) {
 
 /** 解析 SKILL.md：frontmatter + 正文 */
 function parseSkillDoc(content) {
-  const m = String(content || '').match(/^---\s*\n([\s\S]*?)\n---\s*\n([\s\S]*)$/);
+  // 兼容带 BOM 的文件（常见于 Windows 编辑器/Compress-Archive 产物）
+  let text = String(content || '');
+  if (text.charCodeAt(0) === 0xfeff) text = text.slice(1);
+  const m = text.match(/^---\s*\n([\s\S]*?)\n---\s*\n([\s\S]*)$/);
   if (!m) return null;
   const meta = {};
   for (const line of m[1].split('\n')) {
@@ -220,6 +223,100 @@ function fetchMarketRaw(backendUrl, skillId, ticket) {
   });
 }
 
+/**
+ * 从任意 http/https 链接下载技能（v0.3.0：skill.installFromUrl）
+ * 支持两种形态：
+ *  - .zip / 压缩包（含 SKILL.md 的技能包，可带 scripts/resources）
+ *  - 单个 SKILL.md / .md 文本（视为单个技能）
+ * 安全：仅 http/https；大小 ≤ MAX_TOTAL_BYTES；SKILL.md frontmatter + 名称白名单校验；
+ *       解压文件防路径穿越；校验失败整体回滚。
+ */
+function downloadUrl(url, maxBytes) {
+  return new Promise((resolve, reject) => {
+    let u;
+    try {
+      u = new URL(String(url || '').trim());
+    } catch {
+      return reject(new RpcError('E_VALIDATION', '链接无效'));
+    }
+    if (u.protocol !== 'http:' && u.protocol !== 'https:') {
+      return reject(new RpcError('E_VALIDATION', '仅支持 http/https 链接'));
+    }
+    const lib = u.protocol === 'https:' ? https : http;
+    const chunks = [];
+    let total = 0;
+    let settled = false;
+    const fail = (err) => {
+      if (settled) return;
+      settled = true;
+      reject(err);
+    };
+    const req = lib.get(u, { timeout: 20000, headers: { 'User-Agent': 'ysagc-agent/0.3' } }, (res) => {
+      if (res.statusCode >= 400) {
+        let body = '';
+        res.on('data', (c) => (body += c));
+        res.on('end', () => {
+          let msg = `下载失败（HTTP ${res.statusCode}）`;
+          try { msg = JSON.parse(body).msg || msg; } catch { /* ignore */ }
+          fail(new RpcError('E_SKILL_DOWNLOAD_FAILED', msg));
+        });
+        return;
+      }
+      res.on('data', (c) => {
+        total += c.length;
+        if (total > maxBytes) {
+          req.destroy();
+          fail(new RpcError('E_SKILL_DOWNLOAD_FAILED', `技能包过大（>${Math.floor(maxBytes / 1024 / 1024)}MB）`));
+          return;
+        }
+        chunks.push(c);
+      });
+      res.on('end', () => {
+        if (settled) return;
+        settled = true;
+        const base = path.basename(u.pathname || '').split('?')[0];
+        resolve({ buffer: Buffer.concat(chunks), contentType: res.headers['content-type'] || '', fileName: base });
+      });
+    });
+    req.on('error', (e) => fail(new RpcError('E_SKILL_DOWNLOAD_FAILED', `下载失败: ${e.message}`)));
+    req.on('timeout', () => { req.destroy(); fail(new RpcError('E_SKILL_DOWNLOAD_FAILED', '下载超时')); });
+  });
+}
+
+/** 解压 zip（防路径穿越），返回 [{relPath, content}] */
+function extractZipToFiles(buffer) {
+  return new Promise((resolve, reject) => {
+    let yauzl;
+    try {
+      yauzl = require('yauzl');
+    } catch {
+      return reject(new RpcError('E_SKILL_INVALID', '本机缺少解压组件，请更新 Agent'));
+    }
+    yauzl.fromBuffer(buffer, { lazyEntries: true, decodeStrings: true }, (err, zipfile) => {
+      if (err || !zipfile) return reject(new RpcError('E_SKILL_INVALID', '压缩包解析失败'));
+      const files = [];
+      zipfile.on('entry', (entry) => {
+        const name = entry.fileName;
+        if (/\/$/.test(name)) { zipfile.readEntry(); return; }
+        if (name.includes('..') || name.startsWith('/') || name.includes('\\')) { zipfile.readEntry(); return; }
+        zipfile.openReadStream(entry, (e, stream) => {
+          if (e || !stream) { zipfile.readEntry(); return; }
+          const chunks = [];
+          stream.on('data', (c) => chunks.push(c));
+          stream.on('end', () => {
+            files.push({ relPath: name, content: Buffer.concat(chunks).toString('utf8') });
+            zipfile.readEntry();
+          });
+          stream.on('error', () => zipfile.readEntry());
+        });
+      });
+      zipfile.on('end', () => resolve(files));
+      zipfile.on('error', (e) => reject(new RpcError('E_SKILL_INVALID', `压缩包读取失败: ${e.message}`)));
+      zipfile.readEntry();
+    });
+  });
+}
+
 function createSkillMethods(ctxRef) {
   const cfg = () => ctxRef().config;
 
@@ -296,6 +393,34 @@ function createSkillMethods(ctxRef) {
       return { ok: true, skill: readSkillInfo(dir) };
     });
 
+    // ---- 从链接安装（v0.3.0）----
+    reg('skill.installFromUrl', async (params = {}) => {
+      const url = String(params.url || '').trim();
+      if (!url) throw new RpcError('E_VALIDATION', '请输入技能链接');
+      const { buffer, fileName } = await downloadUrl(url, MAX_TOTAL_BYTES);
+      const isZip = /\.zip$/i.test(fileName) || (buffer.length >= 2 && buffer[0] === 0x50 && buffer[1] === 0x4b);
+      let files = [];
+      if (isZip) {
+        files = await extractZipToFiles(buffer);
+      } else {
+        files = [{ relPath: 'SKILL.md', content: buffer.toString('utf8') }];
+      }
+      const sm = files.find((f) => f.relPath === 'SKILL.md');
+      if (!sm) throw new RpcError('E_SKILL_INVALID', '技能包缺少 SKILL.md');
+      const parsed = parseSkillDoc(sm.content);
+      if (!parsed) throw new RpcError('E_SKILL_INVALID', 'SKILL.md 格式非法（需要 name/description frontmatter）');
+      const name = parsed.name;
+      const dir = writeSkillFiles(name, files);
+      const check = validateSkillDir(dir, name);
+      if (!check.ok) {
+        try { fs.rmSync(dir, { recursive: true, force: true }); } catch { /* ignore */ }
+        throw new RpcError('E_SKILL_INVALID', `技能校验失败: ${check.errors.join('; ')}`);
+      }
+      audit('skill.install', name, 'ok');
+      logger.info(`[skill] 已从链接安装技能 ${name}（${url}）`);
+      return { ok: true, skill: readSkillInfo(dir) };
+    });
+
     // ---- 卸载（危险级：前端二次确认）----
     reg('skill.uninstall', async (params = {}) => {
       const name = String(params.name || '');

package/src/origin.js

@@ -0,0 +1,38 @@
+/**
+ * Origin 信任判断（免配对码直连，v0.2.0）
+ * 浏览器 WebSocket / fetch 会带 Origin 头；恶意网页发起的请求 Origin 不在白名单时被拒绝。
+ * originWhitelist 为空时自动信任：backendUrl 的 origin + localhost/127.0.0.1 任意端口。
+ */
+'use strict';
+
+/**
+ * @param {string|null|undefined} origin 请求的 Origin 头
+ * @param {{backendUrl?: string, originWhitelist?: string[]}} config 当前配置
+ * @returns {boolean}
+ */
+function isOriginTrusted(origin, config) {
+  if (!origin || typeof origin !== 'string') return false;
+  let o;
+  try {
+    o = new URL(origin).origin;
+  } catch {
+    return false;
+  }
+  const whitelist = (config && config.originWhitelist) || [];
+  if (Array.isArray(whitelist) && whitelist.length > 0) {
+    return whitelist.some((w) => String(w).replace(/\/$/, '') === o);
+  }
+  // 默认策略：站点 origin + 本机开发源
+  const backend = String((config && config.backendUrl) || '').replace(/\/$/, '');
+  if (backend) {
+    try {
+      if (new URL(backend).origin === o) return true;
+    } catch {
+      /* ignore */
+    }
+  }
+  if (o.startsWith('http://localhost') || o.startsWith('http://127.0.0.1')) return true;
+  return false;
+}
+
+module.exports = { isOriginTrusted };

package/src/pairing.js

@@ -93,7 +93,18 @@ function postJson(url, body) {
 
 function rotateCode() {
   current = { code: generateCode(), agentId: agentId(), createdAt: Date.now() };
-  console.log(`\n🔑 配对码: ${current.code}（10 分钟内有效，请在网站“设备管理”输入）\n`);
+  const W = 46;
+  const bar = '═'.repeat(W);
+  const pad = (s) => `  ${String(s).padEnd(W - 2)}`;
+  console.log('');
+  console.log('  ' + bar);
+  console.log(pad('代码工作台 · 配对码'));
+  console.log('  ' + '─'.repeat(W));
+  console.log(pad(`🔑 配对码: ${current.code}`));
+  console.log(pad('有效期: 10 分钟 · 单次使用'));
+  console.log(pad('请在网站「设备管理」或「首次配置」中输入'));
+  console.log('  ' + bar);
+  console.log('');
   logger.info(`[pairing] 生成新配对码 ${current.code}`);
   report();
   return current;