wangchuan 1.0.0

package/dist/src/utils/prompt.js

@@ -0,0 +1,37 @@
+/**
+ * prompt.ts — 交互式用户确认工具
+ *
+ * 提供单文件冲突提示和批量冲突策略选择，
+ * 支持 TTY 交互和 CI 非交互模式（环境变量 WANGCHUAN_NONINTERACTIVE=1）。
+ */
+import readline from 'readline';
+/** 非交互模式的默认策略（CI 环境） */
+const NON_INTERACTIVE_DEFAULT = 'skip';
+/**
+ * 询问单个冲突文件的处理方式。
+ * 返回 overwrite_all / skip_all 时，调用方应将该策略用于后续所有冲突。
+ */
+export async function askConflict(repoRel) {
+    // 非交互模式（CI / pipe）
+    if (process.env['WANGCHUAN_NONINTERACTIVE'] === '1' || !process.stdin.isTTY) {
+        return NON_INTERACTIVE_DEFAULT;
+    }
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise(resolve => {
+        process.stdout.write(`\n  ⚡ 冲突: ${repoRel}\n` +
+            `     本地文件已存在且内容不同。\n` +
+            `     [o] 覆盖本地  [s] 跳过(保留本地)  [A] 全部覆盖  [S] 全部跳过\n` +
+            `  请选择 [o/s/A/S]: `);
+        rl.once('line', (ans) => {
+            rl.close();
+            switch (ans.trim()) {
+                case 'o': return resolve('overwrite');
+                case 'A': return resolve('overwrite_all');
+                case 'S': return resolve('skip_all');
+                case 's':
+                default: return resolve('skip');
+            }
+        });
+    });
+}
+//# sourceMappingURL=prompt.js.map

package/dist/src/utils/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/utils/prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,QAAQ,MAAM,UAAU,CAAC;AAShC,wBAAwB;AACxB,MAAM,uBAAuB,GAAqB,MAAM,CAAC;AAEzD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAe;IAC/C,mBAAmB;IACnB,IAAI,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC5E,OAAO,uBAAuB,CAAC;IACjC,CAAC;IAED,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEtF,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,aAAa,OAAO,IAAI;YACxB,sBAAsB;YACtB,mDAAmD;YACnD,mBAAmB,CACpB,CAAC;QAEF,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAW,EAAE,EAAE;YAC9B,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,QAAQ,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;gBACnB,KAAK,GAAG,CAAC,CAAC,OAAO,OAAO,CAAC,WAAW,CAAC,CAAC;gBACtC,KAAK,GAAG,CAAC,CAAC,OAAO,OAAO,CAAC,eAAe,CAAC,CAAC;gBAC1C,KAAK,GAAG,CAAC,CAAC,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC;gBACrC,KAAK,GAAG,CAAC;gBACT,OAAO,CAAC,CAAE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/utils/validator.d.ts

@@ -0,0 +1,17 @@
+/**
+ * validator.ts — 通用校验函数
+ *
+ * requireInit 使用 TypeScript asserts 类型谓词，调用后编译器收窄 cfg 为非 null。
+ * 必须声明显式接口（TS2775：assertion 函数不能通过推断的 const 对象调用）。
+ */
+import type { WangchuanConfig } from '../types.js';
+/** 显式接口确保 asserts 签名可被编译器识别 */
+interface Validator {
+    pathExists(p: string): boolean;
+    isGitUrl(url: string): boolean;
+    containsSensitiveData(content: string): boolean;
+    requireInit(cfg: WangchuanConfig | null): asserts cfg is WangchuanConfig;
+}
+export declare const validator: Validator;
+export {};
+//# sourceMappingURL=validator.d.ts.map

package/dist/src/utils/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/utils/validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAUnD,+BAA+B;AAC/B,UAAU,SAAS;IACjB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAChD,WAAW,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,eAAe,CAAC;CAC1E;AAED,eAAO,MAAM,SAAS,EAAE,SAmBvB,CAAC"}

package/dist/src/utils/validator.js

@@ -0,0 +1,33 @@
+/**
+ * validator.ts — 通用校验函数
+ *
+ * requireInit 使用 TypeScript asserts 类型谓词，调用后编译器收窄 cfg 为非 null。
+ * 必须声明显式接口（TS2775：assertion 函数不能通过推断的 const 对象调用）。
+ */
+import fs from 'fs';
+const SENSITIVE_PATTERNS = [
+    /sk-[A-Za-z0-9]{20,}/,
+    /api[_-]?key\s*[:=]\s*["']?\S+/i,
+    /token\s*[:=]\s*["']?\S{16,}/i,
+    /password\s*[:=]\s*["']?\S+/i,
+    /secret\s*[:=]\s*["']?\S+/i,
+];
+export const validator = {
+    pathExists(p) {
+        return fs.existsSync(p);
+    },
+    isGitUrl(url) {
+        if (!url)
+            return false;
+        return /^(git@|https?:\/\/).+\.(git)?/.test(url.trim());
+    },
+    containsSensitiveData(content) {
+        return SENSITIVE_PATTERNS.some(re => re.test(content));
+    },
+    requireInit(cfg) {
+        if (cfg === null) {
+            throw new Error('忘川尚未初始化，请先运行: wangchuan init --repo <仓库地址>');
+        }
+    },
+};
+//# sourceMappingURL=validator.js.map

package/dist/src/utils/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../../src/utils/validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AAGpB,MAAM,kBAAkB,GAAsB;IAC5C,qBAAqB;IACrB,gCAAgC;IAChC,8BAA8B;IAC9B,6BAA6B;IAC7B,2BAA2B;CAC5B,CAAC;AAUF,MAAM,CAAC,MAAM,SAAS,GAAc;IAClC,UAAU,CAAC,CAAS;QAClB,OAAO,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IAED,QAAQ,CAAC,GAAW;QAClB,IAAI,CAAC,GAAG;YAAE,OAAO,KAAK,CAAC;QACvB,OAAO,+BAA+B,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,qBAAqB,CAAC,OAAe;QACnC,OAAO,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,WAAW,CAAC,GAA2B;QACrC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/test/crypto.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * crypto.test.ts — AES-256-GCM 加解密模块单元测试
+ */
+export {};
+//# sourceMappingURL=crypto.test.d.ts.map

package/dist/test/crypto.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.test.d.ts","sourceRoot":"","sources":["../../test/crypto.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/test/crypto.test.js

@@ -0,0 +1,93 @@
+/**
+ * crypto.test.ts — AES-256-GCM 加解密模块单元测试
+ */
+import { describe, it, before, after } from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { cryptoEngine } from '../src/core/crypto.js';
+const TMP = fs.mkdtempSync(path.join(os.tmpdir(), 'wc-test-'));
+const KEY = path.join(TMP, 'master.key');
+after(() => {
+    fs.rmSync(TMP, { recursive: true, force: true });
+});
+describe('cryptoEngine.generateKey', () => {
+    it('生成 64 字符十六进制密钥文件', () => {
+        cryptoEngine.generateKey(KEY);
+        const hex = fs.readFileSync(KEY, 'utf-8').trim();
+        assert.equal(hex.length, 64);
+        assert.match(hex, /^[0-9a-f]+$/);
+    });
+    it('文件权限为 0o600', () => {
+        if (process.platform !== 'win32') {
+            const stat = fs.statSync(KEY);
+            assert.equal((stat.mode & 0o777).toString(8), '600');
+        }
+    });
+});
+describe('cryptoEngine.hasKey', () => {
+    it('密钥存在时返回 true', () => assert.equal(cryptoEngine.hasKey(KEY), true));
+    it('密钥不存在时返回 false', () => assert.equal(cryptoEngine.hasKey(`${KEY}.nope`), false));
+});
+describe('cryptoEngine.encryptString / decryptString', () => {
+    const cases = [
+        '普通 ASCII text',
+        '中文内容：忘川永不遗忘',
+        '{"api_key":"sk-test-1234","model":"claude-3"}',
+        'A'.repeat(10_000),
+        '',
+    ];
+    for (const plain of cases) {
+        it(`往返一致: "${plain.slice(0, 40)}"`, () => {
+            const enc = cryptoEngine.encryptString(plain, KEY);
+            assert.ok(typeof enc === 'string' && enc.length > 0);
+            const dec = cryptoEngine.decryptString(enc, KEY);
+            assert.equal(dec, plain);
+        });
+    }
+    it('相同明文两次加密结果不同（IV 随机）', () => {
+        const a = cryptoEngine.encryptString('hello', KEY);
+        const b = cryptoEngine.encryptString('hello', KEY);
+        assert.notEqual(a, b);
+    });
+    it('篡改密文后解密抛出错误（GCM AuthTag 校验）', () => {
+        const enc = cryptoEngine.encryptString('sensitive', KEY);
+        const buf = Buffer.from(enc, 'base64');
+        const last = buf[buf.length - 1];
+        assert.ok(last !== undefined, '密文不应为空');
+        buf[buf.length - 1] = last ^ 0xff;
+        const tampered = buf.toString('base64');
+        assert.throws(() => cryptoEngine.decryptString(tampered, KEY));
+    });
+});
+describe('cryptoEngine.encryptFile / decryptFile', () => {
+    const PLAIN_FILE = path.join(TMP, 'plain.txt');
+    const ENC_FILE = path.join(TMP, 'plain.txt.enc');
+    const DEC_FILE = path.join(TMP, 'plain.dec.txt');
+    const CONTENT = '敏感配置\nAPI_KEY=sk-xxxxx\n用户信息';
+    before(() => {
+        fs.writeFileSync(PLAIN_FILE, CONTENT, 'utf-8');
+    });
+    it('加密后文件不含明文内容', () => {
+        cryptoEngine.encryptFile(PLAIN_FILE, ENC_FILE, KEY);
+        const raw = fs.readFileSync(ENC_FILE, 'utf-8');
+        assert.ok(!raw.includes('敏感配置'));
+        assert.ok(!raw.includes('sk-xxxxx'));
+    });
+    it('解密后内容与原文一致', () => {
+        cryptoEngine.decryptFile(ENC_FILE, DEC_FILE, KEY);
+        assert.equal(fs.readFileSync(DEC_FILE, 'utf-8'), CONTENT);
+    });
+});
+describe('cryptoEngine 错误路径', () => {
+    it('密钥文件不存在时抛出友好错误', () => {
+        assert.throws(() => cryptoEngine.encryptString('x', '/tmp/nonexistent.key'), /密钥文件不存在/);
+    });
+    it('无效密钥格式时抛出错误', () => {
+        const badKey = path.join(TMP, 'bad.key');
+        fs.writeFileSync(badKey, 'tooshort', 'utf-8');
+        assert.throws(() => cryptoEngine.encryptString('x', badKey), /密钥文件格式无效/);
+    });
+});
+//# sourceMappingURL=crypto.test.js.map

package/dist/test/crypto.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.test.js","sourceRoot":"","sources":["../../test/crypto.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "wangchuan",
+  "version": "1.0.0",
+  "description": "忘川 · AI 记忆同步系统 — 智能体记忆永不遗失",
+  "bin": {
+    "wangchuan": "./dist/bin/wangchuan.js"
+  },
+  "files": [
+    "dist/",
+    "skill/",
+    ".wangchuan/config.example.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "postbuild": "chmod +x dist/bin/wangchuan.js",
+    "prepublishOnly": "npm run build",
+    "dev": "tsx bin/wangchuan.ts",
+    "test": "node --import tsx/esm --test test/crypto.test.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "ai",
+    "memory",
+    "sync",
+    "agent",
+    "claude",
+    "gemini",
+    "openclaw",
+    "encryption"
+  ],
+  "author": "SUpermin6u",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SUpermin6u/wangchuan.git"
+  },
+  "homepage": "https://github.com/SUpermin6u/wangchuan",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "dotenv": "^16.4.5",
+    "ora": "^8.1.1",
+    "simple-git": "^3.27.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.15",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=18.19.0"
+  },
+  "type": "module"
+}

package/skill/SKILL.md

@@ -0,0 +1,67 @@
+# wangchuan — 智能体记忆同步技能
+
+## 技能简介
+
+忘川（Wangchuan）AI 记忆同步系统的 OpenClaw Skill 封装。
+在对话中直接调用以同步 AI 智能体的配置文件，跨环境永不遗失记忆。
+
+## 命令速查
+
+```
+wangchuan list   [--agent openclaw|claude|gemini]     列出所有受管配置项
+wangchuan status [--agent openclaw|claude|gemini]     查看同步状态和差异摘要
+wangchuan diff   [--agent openclaw|claude|gemini]     显示行级文件差异
+wangchuan pull   [--agent openclaw|claude|gemini]     拉取远端配置，还原到本地
+wangchuan push   [--agent <name>] [-m "<描述>"]       加密推送本地配置到远端
+wangchuan init   --repo <git地址>                     首次初始化
+```
+
+## 调用示例
+
+> 帮我列出忘川管理的所有配置文件
+
+> 查看一下忘川的同步状态
+
+> 只看 openclaw 的配置差异
+
+> 帮我把最新的 AI 记忆同步到本地
+
+> 只拉取 openclaw 的配置
+
+> 我修改了 MEMORY.md，帮我推送一下，描述是"更新项目记忆"
+
+> 只推送 claude 的配置
+
+## 输出说明
+
+### list
+- `✔ 本地  ✔ 仓库` — 两侧均存在，已同步
+- `✔ 本地  · 仓库` — 本地有但未推送
+- `✖ 本地  ✔ 仓库` — 仓库有但本地缺失，执行 pull 还原
+- `[enc]` — 该文件加密存储（AES-256-GCM）
+
+### diff
+- `+` 绿色行 — 本地新增内容
+- `-` 红色行 — 仓库有但本地已删除
+- 灰色行 — 上下文（未变化）
+- `[enc]` — 加密文件已自动解密后再对比
+
+### push / pull
+- `[已加密]` / `[已解密]` — 经过 AES-256-GCM 处理
+
+## --agent 说明
+
+所有命令均支持 `--agent` 过滤，只操作指定智能体的配置：
+
+| 值 | 说明 |
+|----|------|
+| `openclaw` | ~/.openclaw/workspace/ 下的所有配置 |
+| `claude`   | ~/.claude/.claude.json（需在 config.json 中 enabled:true）|
+| `gemini`   | ~/.gemini/ 下的配置（需在 config.json 中 enabled:true）|
+
+## 前置条件
+
+1. Node.js ≥ 18
+2. 已执行过 `wangchuan init`（~/.wangchuan/config.json 存在）
+3. 本地 SSH 密钥可访问目标 git 仓库
+4. 跨机器迁移时需手动复制 `~/.wangchuan/master.key`

package/skill/wangchuan-skill.sh

@@ -0,0 +1,54 @@
+#!/usr/bin/env bash
+# wangchuan-skill.sh — OpenClaw Skill 脚本
+#
+# 用法（由 OpenClaw / Claude 调用）：
+#   wangchuan-skill.sh pull   [--agent openclaw|claude|gemini]
+#   wangchuan-skill.sh push   [--agent <name>] [--message "<msg>"]
+#   wangchuan-skill.sh status [--agent <name>]
+#   wangchuan-skill.sh diff   [--agent <name>]
+#   wangchuan-skill.sh list   [--agent <name>]
+#   wangchuan-skill.sh init   --repo <url>
+#
+# 环境变量：
+#   WANGCHUAN_DIR        可覆盖 wangchuan 安装路径（默认 ~/wangchuan）
+#   WANGCHUAN_LOG_LEVEL  日志级别 debug|info|warn|error
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+WC_DIR="${WANGCHUAN_DIR:-"$(dirname "$SCRIPT_DIR")"}"
+BIN="$WC_DIR/dist/bin/wangchuan.js"
+
+if [[ ! -f "$BIN" ]]; then
+  echo "✖ 找不到 wangchuan 编译产物: $BIN" >&2
+  echo "  请先在 $WC_DIR 目录执行: npm run build" >&2
+  exit 1
+fi
+
+if ! command -v node &>/dev/null; then
+  echo "✖ 未找到 Node.js，请先安装 (https://nodejs.org)" >&2
+  exit 1
+fi
+
+NODE_MAJOR="$(node --version | sed 's/v//' | cut -d. -f1)"
+if (( NODE_MAJOR < 18 )); then
+  echo "✖ Node.js 版本过低，需要 >= 18（当前: $(node --version)）" >&2
+  exit 1
+fi
+
+CMD="${1:-status}"
+shift || true   # 移除第一个参数，剩余参数透传
+
+case "$CMD" in
+  pull|push|status|diff|list)
+    node "$BIN" "$CMD" "$@"
+    ;;
+  init)
+    node "$BIN" init "$@"
+    ;;
+  *)
+    echo "✖ 未知命令: $CMD" >&2
+    echo "  可用命令: pull | push | status | diff | list | init" >&2
+    exit 1
+    ;;
+esac