WorkClaw CLAUDE.md

CLAUDE.md

本文件为 Claude Code (claude.ai/code) 在此代码库中工作时提供指导。

重要约定：除代码、命令、文件路径、技术术语等必须使用英文的内容外，所有说明、注释、文档均使用中文。

项目概述

WorkClaw 是一个开源的 AI Skill 打包与桌面应用发布平台。项目由两个 Tauri 桌面应用组成：Studio（供创作者打包 Skill）和 Runtime（供用户安装和运行 Skill）。Skill 使用 AES-256-GCM 加密打包成 .skillpack 文件。

Monorepo 结构

apps/
├── studio/              # 创作者端应用 (Tauri + React)
├── runtime/             # 用户端应用 (Tauri + React + Node.js Sidecar)
│   ├── src-tauri/       # Rust 后端，包含 agent 系统
│   └── sidecar/         # Node.js HTTP 服务器 (Playwright, MCP)
packages/
└── skillpack-rs/        # 核心加密/打包库 (Rust)

包管理器: pnpm workspaces + Turborepo

常用命令

# 开发
pnpm runtime              # 以开发模式运行 Runtime 应用
pnpm studio               # 以开发模式运行 Studio 应用

# 构建
pnpm build:runtime        # 构建 Runtime 生产版本
pnpm build:studio         # 构建 Studio 生产版本

# 测试
cd apps/runtime/src-tauri
cargo test                # 运行所有 Rust 测试
cargo test --test test_registry  # 运行特定测试文件

# Sidecar
cd apps/runtime/sidecar
pnpm build                # 构建 Node.js sidecar

核心架构

1. 加密系统（基于用户名）

加密模型使用确定性密钥推导方式，从用户名生成密钥：

username → PBKDF2-HMAC-SHA256 (100k iterations) → AES-256-GCM key
                ↓ salt = SHA256(skill_id + skill_name)

关键特性：

• 相同用户名 + Skill 始终生成相同密钥
• 创作者无需存储密钥
• 通过 manifest 中加密的 "SKILLMINT_OK" token 验证用户名

代码位置: packages/skillpack-rs/src/crypto.rs

2. SkillPack 格式

.skillpack 文件是 ZIP 压缩包：

myskill.skillpack
├── manifest.json           # 明文（id, name, version, username_hint, encrypted_verify）
├── icon.png                # 明文（可选）
└── encrypted/              # AES-256-GCM 加密文件
    ├── SKILL.md.enc
    ├── templates/*.md.enc
    └── examples/*.md.enc

打包: packages/skillpack-rs/src/pack.rs 解包: packages/skillpack-rs/src/unpack.rs

3. 多模型系统（双协议架构）

所有 LLM 交互通过两种适配器格式：

Anthropic Messages API (adapters/anthropic.rs):

• 原生支持：Claude 模型
• 兼容：MiniMax Anthropic 端点

OpenAI 兼容 API (adapters/openai.rs):

• 原生支持：OpenAI GPT 模型
• 兼容：DeepSeek, Qwen, MiniMax, Moonshot, Yi