wangchuan 2.2.0 → 2.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/LICENSE +21 -0
  2. package/package.json +1 -1
  3. package/skill/SKILL.md +42 -48
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 SUpermin6u
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "wangchuan",
3
- "version": "2.2.0",
3
+ "version": "2.3.1",
4
4
  "description": "忘川 · AI 记忆同步系统 — 智能体记忆永不遗失",
5
5
  "bin": {
6
6
  "wangchuan": "./dist/bin/wangchuan.js"
package/skill/SKILL.md CHANGED
@@ -1,80 +1,74 @@
1
- # wangchuan — 智能体记忆同步技能 / AI Agent Memory Sync Skill
1
+ # wangchuan — AI Agent Memory Sync Skill
2
2
 
3
- ## 技能简介 / Overview
4
-
5
- 忘川（Wangchuan）AI 记忆同步系统的 OpenClaw Skill 封装。在对话中直接调用以同步 AI 智能体的配置文件，跨环境永不遗失记忆。
3
+ ## Overview
6
4
 
7
5
  OpenClaw Skill wrapper for the Wangchuan AI memory sync system. Invoke directly in conversation to sync AI agent configs — memories never lost across environments.
8
6
 
9
- ## 命令速查 / Command Reference
7
+ ## Command Reference
10
8
 
11
9
  ```
12
- wangchuan list [--agent openclaw|claude|gemini] 列出所有受管配置项 / List managed configs
13
- wangchuan status [--agent openclaw|claude|gemini] 查看同步状态和差异摘要 / Show sync status & diff summary
14
- wangchuan diff [--agent openclaw|claude|gemini] 显示行级文件差异 / Show line-level file diff
15
- wangchuan pull [--agent openclaw|claude|gemini] 拉取远端配置，还原到本地 / Pull & restore from repo
16
- wangchuan push [--agent <name>] [-m "<描述>"] 加密推送本地配置到远端 / Encrypt & push to repo
17
- wangchuan dump [--agent openclaw|claude|gemini] 生成明文快照到临时目录 / Plaintext snapshot to temp dir
18
- wangchuan init --repo <git地址> 首次初始化 / First-time init
10
+ wangchuan list [--agent openclaw|claude|gemini] List managed configs
11
+ wangchuan status [--agent openclaw|claude|gemini] Show sync status & diff summary
12
+ wangchuan diff [--agent openclaw|claude|gemini] Show line-level file diff
13
+ wangchuan pull [--agent openclaw|claude|gemini] Pull & restore from repo
14
+ wangchuan push [--agent <name>] [-m "<msg>"] Encrypt & push to repo
15
+ wangchuan dump [--agent openclaw|claude|gemini] Plaintext snapshot to temp dir
16
+ wangchuan init --repo <git-url> First-time init
19
17
  ```
20
18
 
21
- ## 调用示例 / Invocation Examples
19
+ ## Invocation Examples
22
20
 
23
- > 帮我列出忘川管理的所有配置文件 / List all files managed by Wangchuan
21
+ > List all files managed by Wangchuan
24
22
 
25
- > 查看一下忘川的同步状态 / Check Wangchuan sync status
23
+ > Check Wangchuan sync status
26
24
 
27
- > 只看 openclaw 的配置差异 / Show diff for openclaw only
25
+ > Show diff for openclaw only
28
26
 
29
- > 帮我把最新的 AI 记忆同步到本地 / Pull the latest AI memories to local
27
+ > Pull the latest AI memories to local
30
28
 
31
- > 只拉取 openclaw 的配置 / Pull openclaw configs only
29
+ > Pull openclaw configs only
32
30
 
33
- > 我修改了 MEMORY.md，帮我推送一下，描述是"更新项目记忆" / Push my MEMORY.md changes with note "update project memory"
31
+ > Push my MEMORY.md changes with note "update project memory"
34
32
 
35
- > 只推送 claude 的配置 / Push claude configs only
33
+ > Push claude configs only
36
34
 
37
- > 生成明文快照，让我检查一下同步内容 / Generate a plaintext dump so I can inspect
35
+ > Generate a plaintext dump so I can inspect
38
36
 
39
- ## 输出说明 / Output Guide
37
+ ## Output Guide
40
38
 
41
39
  ### list
42
- - `✔ 本地 ✔ 仓库` — 两侧均存在，已同步 / Present on both sides, in sync
43
- - `✔ 本地 · 仓库` — 本地有但未推送 / Local only, not yet pushed
44
- - `✖ 本地 ✔ 仓库` — 仓库有但本地缺失，执行 pull 还原 / In repo but missing locally, run pull
45
- - `[enc]` — 该文件加密存储（AES-256-GCM）/ Encrypted (AES-256-GCM)
46
- - `[字段]` — JSON 字段级提取（只同步指定字段）/ JSON field-level extraction (only syncs specified fields)
40
+ - `✔ local ✔ repo` — Present on both sides, in sync
41
+ - `✔ local · repo` — Local only, not yet pushed
42
+ - `✖ local ✔ repo` — In repo but missing locally, run pull
43
+ - `[enc]` — Encrypted (AES-256-GCM)
44
+ - `[field]` — JSON field-level extraction (only syncs specified fields)
47
45
 
48
46
  ### diff
49
- - `+` 绿色行 — 本地新增内容 / Green: local additions
50
- - `-` 红色行 — 仓库有但本地已删除 / Red: removed locally
51
- - 灰色行 — 上下文（未变化）/ Gray: context (unchanged)
52
- - `[enc]` — 加密文件已自动解密后再对比 / Encrypted files auto-decrypted for comparison
47
+ - `+` green lines — Local additions
48
+ - `-` red lines — Removed locally
49
+ - Gray lines — Context (unchanged)
50
+ - `[enc]` — Encrypted files auto-decrypted for comparison
53
51
 
54
52
  ### push / pull
55
- - `[已加密]` / `[已解密]` — 经过 AES-256-GCM 处理 / Processed with AES-256-GCM
56
- - `[已清理]` — 所有 agent 都已删除的文件从 repo 移除 / Stale files pruned from repo (delete propagation)
57
- - `⚠ 本地独有` — pull 时检测到本地有但 repo 无的文件，建议 push / Local-only files detected, suggest push
58
-
59
- ## --agent 说明 / --agent Filter
53
+ - `[encrypted]` / `[decrypted]` — Processed with AES-256-GCM
54
+ - `[pruned]` — Stale files removed from repo (delete propagation)
55
+ - `⚠ local-only` — Local-only files detected, suggest push
60
56
 
61
- 所有命令均支持 `--agent` 过滤，只操作指定智能体的配置。
57
+ ## --agent Filter
62
58
 
63
59
  All commands support `--agent` to filter by agent.
64
60
 
65
- | 值 / Value | 说明 / Description |
66
- |----|------|
67
- | `openclaw` | MEMORY.md(加密/enc)、AGENTS.md、SOUL.md — 默认/default ~/.openclaw/workspace/ |
68
- | `claude` | CLAUDE.md、settings.json(加密/enc)、.claude.json→mcpServers 字段提取(加密/enc) — 默认/default ~/.claude-internal/ |
69
- | `gemini` | settings.internal.json→security+model 字段提取(加密/enc) — 默认/default ~/.gemini/ |
70
-
71
- 不指定 `--agent` 时，同时操作所有已启用的 agent 及 shared 共享层（skills/MCP/共享记忆）。
61
+ | Value | Description |
62
+ |-------|-------------|
63
+ | `openclaw` | MEMORY.md (enc), AGENTS.md, SOUL.md — default ~/.openclaw/workspace/ |
64
+ | `claude` | CLAUDE.md, settings.json (enc), .claude.json → mcpServers field extraction (enc) — default ~/.claude-internal/ |
65
+ | `gemini` | settings.internal.json → security + model field extraction (enc) — default ~/.gemini/ |
72
66
 
73
67
  When omitted, operates on all enabled agents plus the shared tier (skills/MCP/shared memory).
74
68
 
75
- ## 前置条件 / Prerequisites
69
+ ## Prerequisites
76
70
 
77
71
  1. Node.js ≥ 18
78
- 2. 已执行过 `wangchuan init`（~/.wangchuan/config.json 存在）/ `wangchuan init` has been run
79
- 3. 本地 SSH 密钥可访问目标 git 仓库 / Local SSH key has access to the target repo
80
- 4. 跨机器迁移时需手动复制 `~/.wangchuan/master.key` / Copy `master.key` manually when migrating across machines
72
+ 2. `wangchuan init` has been run (~/.wangchuan/config.json exists)
73
+ 3. Local SSH key has access to the target git repo
74
+ 4. Copy `~/.wangchuan/master.key` manually when migrating across machines