gewe-skill 用于把 GeWe 微信回调整理成智能体（Agent）可读取、可检索、可长期保存的记忆层。
这个项目采用 Rust 优先的 monorepo 结构，包含边缘接入层、长期记忆服务、可复用 Rust 客户端，以及面向各类 Agent 的通用 Skill。
当前实现重点服务于只读场景，让 Agent 能安全查看和分析微信消息，而不是直接替用户操作微信：
- 通过 Cloudflare Workers 接收 GeWe 回调。
- 将 V1/V2 回调统一规范化为共享结构。
- 在边缘侧短期保存原始回调证据。
- 在边缘侧把附件下载并写入 R2。
- 由 Rust 长期记忆服务持续拉取原始回调和附件内容。
- 通过 CLI/API 查询消息、会话、群事件、身份记忆和附件。
- 通过 GeWe 只读接口补全联系人、群资料、群成员和群名片索引。
- 暂不开放微信发消息等写入或变更类 API。
| 组件 | 路径 | 作用 |
|---|---|---|
| gewe-skill-edge | apps/gewe-skill-edge |
Cloudflare Workers 边缘接入层和短期缓冲区 |
| gewe-skill-memory | crates/gewe-skill-memory |
持久化消息记忆服务和只读 API |
| gewe-skill-client | crates/gewe-skill-client |
访问记忆服务的 Rust SDK |
| gewe-skill-types | crates/gewe-skill-types |
共享 DTO 和规范化数据结构 |
| gewe-skill-core | crates/gewe-skill-core |
回调规范化、事件解析和差异计算逻辑 |
| gewe-skill-cli | crates/gewe-skill-cli |
面向 Agent 和 Computer Use 的 JSON 查询协议 CLI |
| gewe-skill | skills/gewe-skill |
通用 Agent Skill 使用说明 |
构建并测试 Rust workspace：
cargo test --workspace --all-targets检查 Cloudflare Worker：
cd apps/gewe-skill-edge
npm ci
npm run check在本机运行记忆服务：
export GEWE_SKILL_DATABASE_URL='sqlite:/tmp/gewe-skill-memory.sqlite?mode=rwc'
export GEWE_SKILL_LISTEN='127.0.0.1:8788'
export GEWE_SKILL_READ_TOKEN='local-read-token'
export GEWE_SKILL_WRITE_TOKEN='local-write-token'
cargo run -p gewe-skill-memory使用 CLI 查询数据：
export GEWE_SKILL_BASE_URL='http://127.0.0.1:8788'
export GEWE_SKILL_READ_TOKEN='local-read-token'
cargo run -p gewe-skill-cli -- --json doctor
cargo run -p gewe-skill-cli -- --json conversations list --limit 20
cargo run -p gewe-skill-cli -- --json identity resolve --q '<group-or-member-name>' --limit 10
cargo run -p gewe-skill-cli -- --json messages list --conversation-id '<conversation_id>' --limit 50
cargo run -p gewe-skill-cli -- --json messages search --q '<keyword>' --conversation-id '<conversation_id>' --limit 20推荐的生产部署方式是拉取式同步：
GeWe -> gewe-skill-edge -> Cloudflare D1/R2/Queue -> gewe-skill-memory -> Agent CLI/API
gewe-skill-edge 负责接收回调并保存短期证据。gewe-skill-memory 运行在可信服务器上，定期从边缘侧管理导出接口拉取数据。这样可以避免把记忆服务的写入 API 暴露到公网。
任何支持 Markdown Skill 或指令文件的 Agent runtime，都可以安装或引用 skills/gewe-skill/SKILL.md。这个 Skill 默认以 CLI 为核心，并且保持只读。
安装 Markdown Skill 到通用本地目录：
./scripts/install-skill.sh安装到指定 Agent runtime 目录：
./scripts/install-skill.sh "$HOME/.codex/skills/gewe-skill"常用命令：
gewe-skill --json doctor
gewe-skill --json conversations list --limit 100
gewe-skill --json identity resolve --q '<chatroom/contact/member name>' --limit 10
gewe-skill --json identity refresh --recent-chatrooms 20
gewe-skill --json messages list --conversation-id '<conversation_id>' --limit 50
gewe-skill --json messages list --conversation-id '<conversation_id>' --sender-wxid '<wxid>' --after '<iso-time>' --before '<iso-time>' --limit 50
gewe-skill --json messages search --q '<keyword>' --conversation-id '<conversation_id>' --limit 20
gewe-skill --json chatrooms events --chatroom-id '<chatroom_id>' --limit 100
gewe-skill --json chatrooms system-events --chatroom-id '<chatroom_id>' --limit 100
gewe-skill --json attachments download --sha256 '<sha256>' --output /tmp/gewe-attachment.bin- 不要提交 GeWe token、回调密钥、边缘管理 token 或记忆服务 bearer token。
- 将 GeWe 回调和本地微信数据库视为源证据。
- 将
gewe-skill-memory视为 Agent 可读取的记忆层。 - 除非用户明确授权具体修复或删除动作，否则保持源数据不可变。
- 未来如果加入微信写入类 API，应作为单独的、需要明确授权的能力面开放。
MIT