From 6d91b20b755fe97fa207330df18e402b0733de48 Mon Sep 17 00:00:00 2001 From: maple <1209384559@qq.com> Date: Mon, 2 Nov 2026 08:09:48 +0800 Subject: [PATCH] A Simplified Chinese README (#188) Adds README.zh.md, translated from README.md with the same links and commands, and links it from the language switcher in README.md and README.ja.md. --- README.ja.md | 2 +- README.md | 2 +- README.zh.md | 329 ++++++++++++++++++++++++++++++++++++++++++++++++ docs/ROADMAP.md | 4 + 4 files changed, 335 insertions(+), 2 deletions(-) create mode 100644 README.zh.md diff --git a/README.ja.md b/README.ja.md index 8e6431a1..d3c9e4b9 100644 --- a/README.ja.md +++ b/README.ja.md @@ -14,7 +14,7 @@

Craft Anything

- English · 日本語 + English · 日本語 · 简体中文

diff --git a/README.md b/README.md index 5edfa755..d5d44c60 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@

Craft Anything

- English · 日本語 + English · 日本語 · 简体中文

diff --git a/README.zh.md b/README.zh.md new file mode 100644 index 00000000..29d9c31e --- /dev/null +++ b/README.zh.md @@ -0,0 +1,329 @@ + + +

+ + + + ArtCraft + + +

+ +

+ Craft Anything 图标：蓝色底块上雕刻的乌鸦 +

+ +

Craft Anything

+ +

+ English · 日本語 · 简体中文 +

+ +

+ 看清任意网站、应用或游戏是怎么做的，再让 AI 给你造一个自己的版本；一个纯 Rust 写的开源净室引擎。
+ 把目标指给它，说清你想要什么，它就用真实的检查工具研究原作，
+ 让编码 agent 建一个新项目，把结果与原件比对，再反复收敛。 +

+ +

+ 100% Rust + macOS · Windows · Linux · FreeBSD · Web + License: MIT OR Apache-2.0 + Status: early alpha +

+ +

+ 加入 ArtCraft 的 Discord 社区 +

+ +

+ 下载 Craft Anything · + ArtCraft · + 全部 Crafting 应用 +

+ +
+ +

+ Craft Anything 里的一个网站项目：检查清单列出还不一致的地方和每页的相似度，构建方说它的版本已就绪，一张审批卡在跑命令前先征求同意，计划显示四步里已完成两步 +
+ 一个网站项目：每项检查都说明构建成果有多像，规则之外的任何动作都要你批准，计划显示还剩什么没做。 +

+ +> [!NOTE] +> **ArtCraft 是一个来自各行各业的创作者社区。** 画家、摄影师、导演、插画师、设计师、动画师、 +> 爱好者，以及上周才拿起笔的人。只要你动手做东西，你就是我们的一员。**[来 Discord 打个招呼](https://discord.gg/artcraft)。** + +

+ 工作原理 · + 两种用法 · + AI · + 面向 agent · + 内部实现 · + 开始使用 · + 状态 · + 下载 · + Discord +

+ +
+ + + + + + + + +
+

🔍 研究一切

+ 网站、桌面程序、手机应用、游戏和文件：真实的检查工具弄清它们是怎么搭起来的、做了什么，每个结论都带着证据。 + 		+

🛠️ 造一个自己的

+ 说出你要什么（“复刻这个网站”、“用 Rust 复刻这个游戏的玩法”），编码 agent 就按你指定的技术栈建一个新项目。 + 		+

✅ 比对过，不是猜的

+ 每个构建都会与原件比对（网页按三种屏宽、游戏跑它自己的自检、应用看它的运行），并反复收敛到足够接近。 + 		+

🤖 为 agent 准备好

+ 314 个工具，每个既是 CLI 子命令、又是 MCP 工具，任何 agent 都能驱动跟应用同一个引擎。纯研究不需要 AI。 +
+ +
+ + + +## 工作原理 + +把 Craft Anything 指向一个目标，说清你要什么，按下 Start。它分四步走，遇到该你拍板的地方就用大白话问你： + +1. **研究：** 检查原件：它在各种宽度下的页面、它的代码、它的文件、它怎么运行。 +2. **构建：** 编码 agent 建一个新项目，用你的请求指定的语言、框架或引擎（没指定就用合理默认）。 +3. **检查：** 把构建成果与原件比对，列出还不一致的地方。 +4. **就绪：** 打开、试玩或预览结果，或者继续提要求让它接着收敛。 + + + + + + +
+ Make 界面：选择要复刻的网站、应用或游戏，填入地址，选净室或深度模式，说出你要什么，按下 Start
+ Make：选择要复刻什么，说出你要什么，按下 Start。 + 		+ 一个做完的贪吃蛇项目，所有步骤都完成了，还有一个“试玩游戏”按钮
+ 就绪：试玩游戏，或者在下面提改动要求。 +
+ + + +## 两种用法 + +- **简单模式**（默认）：“你想做什么？” 选一个网站、应用或游戏，描述它，按下 Start。项目页显示四个步骤（研究 → 构建 → 检查 → 就绪）、agent 正在做什么（用大白话）、提问卡和审批卡、结果有多像，以及打开结果或它所在文件夹的按钮。在底部的输入框里提改动要求。“只看里面”会打开一个目标供你提问，但不构建任何东西（需深度模式）。 +- **进阶模式**：完整的工作台：所有工具（Ctrl/Cmd+K）、函数、字符串、伪 C、反汇编、十六进制、调用图、证据、未知项、任务、日志和 agent 控制台。 + +两种模式驱动同一个引擎。 + + + +## 净室还是深度 + +- **净室**（默认）：绝不读取原件内部的任何东西——不读它的代码、文件或页面源码。Craft Anything 只依据你所能看到的来工作：你添加的图片、网站以访客身份呈现的样子（截图、可见文本、测量出的布局、颜色、字体与间距、展开的菜单），以及在你允许时截取的应用窗口画面。所有会往内部看的工具都会被拒绝，并告诉你如何开启深度模式。 +- **深度**：使用全部工具，供你自己私下使用。程序的代码和文件由内置引擎读取（装了 Ghidra 时也会用它），网站的 JavaScript 会被读取、起始页面会被持续观察，构建方也可以使用全部这些能力。 + +在标题栏或设置里切换，或执行 `settings_set deep_mode true`，或单次 CLI 运行时加 `--deep`（或 `--clean-room`）。 + +

+ 进阶模式的工作台：函数列表、所选函数的伪 C、用工具调用回答问题的 agent，以及证据台账 +
+ 进阶：函数、伪 C、agent，以及每个答案背后的证据。 +

+ + + +## AI + +构建需要你电脑上有一个已登录的编码 agent。**Claude Code** 是首选支持对象：Craft Anything 运行你自己那份未经改动的 `claude` 程序，它用你自己的登录；Craft Anything 从不查看也不接触你的账号，你对它的使用适用你与 Anthropic 自己的协议。原因与做法见 [docs/claude-code.md](docs/claude-code.md)。Codex 适配器已存在，但还没在真实安装上验证过。提问和分析可选用 Anthropic、OpenAI、OpenRouter 以及本地 OpenAI 兼容服务（设置 → AI）。 + + + +## 面向 agent + +每个工具同时是一个 CLI 子命令和一个 MCP 工具，所以 agent 不用打开应用也能研究目标或跑完整个重建： + +```sh +craft-anything-cli commands # every tool, by toolset +craft-anything-cli mcp # serve them to any MCP client +craft-anything-cli rebuild https://example.com "Recreate this website" +``` + +结果是带置信度、覆盖范围和局限性的证据记录；大结果先给摘要，再用 `core_evidence_browse` 分页读取。`craft-anything-cli setup` 把 Craft Anything 接到编码 agent 应用上。 + + + +## 内部实现 + +一个纯 Rust 的逆向工程引擎，314 个工具（引擎里 298 个，其余来自 AI 与设置层），覆盖原生程序、.NET、Java、Android、Apple、Electron/JavaScript、网站、固件、抓包、数据库和游戏文件。它自带的解码器、反汇编器和反编译器无需任何外部程序即可工作；深度模式会全部用上，装了 Ghidra 时也会使用它。它支撑着桌面应用（egui）、CLI 和 MCP 服务器，其中一部分还能以 WebAssembly 跑在浏览器里。完整清单在 [docs/tools.md](docs/tools.md)。 + + + +## 开始使用 + +需要 Rust **1.97 或更新**（有依赖要求它；`rustup update`）。在 Debian 或 Ubuntu 上，桌面应用还需要： + +```sh +sudo apt-get install libxkbcommon-dev libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev +``` + +然后： + +```sh +git clone https://github.com/storytold/craft-anything && cd craft-anything +cargo run --release -p craft-anything # the desktop app +cargo install --path apps/craft-anything-cli # the CLI, as `craft-anything-cli` +craft-anything-cli doctor # checks the install, coding agents and engines +``` + +构建需要你电脑上已登录一个编码 agent（见 [AI](#ai)）；`doctor` 会告诉你缺什么。从命令行重建（问题在终端里问）： + +```sh +craft-anything-cli rebuild https://example.com "Recreate this website" +craft-anything-cli rebuild - "A snake game in Rust" --rounds 1 +craft-anything-cli rebuild https://example.com "Make the header blue" --continue-in "" +craft-anything-cli rebuild - "Add a contact form" --project-folder "" --existing edit +``` + +新项目放在 `Documents/Craft Anything`（可在设置 → 通用里改）。每个项目文件夹里有 `craft.json`（请求、目标、状态和历史）、`capture/`（从目标录到的内容）、`app/`（生成的项目）、`checks/`（每次与原件比对的结果）、`investigation.cany/`（证据）和 `inbox/`（待回答问题）。 + +项目也可以从你指定的文件夹开始（Start 下的“选择文件夹…”，或 `--project-folder`）。如果那里已经有文件，你要说明它们是什么：就是应用本身（构建方会就地修改），还是作为起点用的素材（应用会建在它们旁边的 `app/` 里）；设置 → 通用可以记住你的选择。设置 → 通用还会列出其他文件夹里的项目；移除一个只是把它从列表里拿掉。 + + + +## 状态 + +> [!IMPORTANT] +> **状态：** Craft Anything 处于早期 alpha。今天能用的、部分可用的，以及接下来要做的： +> +> - **今天可用：** 桌面应用（简单与进阶模式）、CLI 和 MCP 服务器；以 Claude Code 作为构建方、面向网站/应用/游戏的 +> 研究 → 构建 → 检查 → 收敛 流程；三种屏宽下的网站检查；Unity、Unreal 或 Godot 的游戏重建；带 Ghidra 的深度 +> 模式；生成图片和 3D 模型（需自行选择开启，用你自己的 fal.ai 密钥）；插件（MCP 服务器，以及开启 `wasm-plugins` +> 选项的构建中的 WASM 组件）。 +> - **部分可用：** 用 API 密钥和其他编码 agent 构建（已实现，尚未真机跑通），应用和游戏的行为检查，少数引擎工具只用替身测过。 +> - **接下来：** 第一次公开发布（Windows、macOS、Linux 和 FreeBSD 的安装包，以及浏览器查看器都已在 CI 里配好），然后是托管版。 +> +> [docs/STATUS.md](docs/STATUS.md) 有细节和每部分的验证方式，[docs/tool-status.md](docs/tool-status.md) 是逐个工具的清单， +> [docs/ROADMAP.md](docs/ROADMAP.md) 是逐项的计划。欢迎提 issue，或者到 [Discord](https://discord.gg/artcraft) 说哪里坏了。 + +**负责地使用。** 请在你拥有或获准检查的软件上使用 Craft Anything。它绝不绕过 DRM、登录或反作弊。重建是依据证据复现布局、风格与行为；agent 被要求不得复制 logo、照片或文本，除非你确认你拥有它们或已获授权。 + + + +## 下载 + +在 GitHub 上，[最新发布](https://github.com/storytold/craft-anything/releases/latest) 列出了下面所有构建，[全部发布](https://github.com/storytold/craft-anything/releases) 有更早的版本和它们的说明。文件名里的 `` 是版本号，`SHA256SUMS.txt` 列出每个文件的校验和。 + +### Windows + +| 构建 | 安装包 | 便携版 | +|---|---|---| +| x64（64 位 Intel/AMD） | `craft-anything--windows-x64.msi` | `craft-anything--windows-x64-portable.zip` | +| arm64（骁龙及其他 ARM PC） | `craft-anything--windows-arm64.msi` | `craft-anything--windows-arm64-portable.zip` | +| x86（32 位） | `craft-anything--windows-x86.msi` | `craft-anything--windows-x86-portable.zip` | + +安装包和可执行文件都有代码签名。便携版把设置放在应用旁边。 + +### macOS + +| 构建 | 文件 | 说明 | +|---|---|---| +| 应用，通用版（Apple silicon + Intel） | `craft-anything--macos-universal.dmg` | 已签名并公证 | +| 命令行工具，通用版 | `craft-anything-cli--macos-universal.zip` | 已签名并公证 | + +### Linux + +| 格式 | x86_64 | aarch64（ARM64） | 说明 | +|---|---|---|---| +| AppImage | `craft-anything--linux-x86_64.AppImage` | `craft-anything--linux-aarch64.AppImage` | 随处可跑；用 [AppImageUpdate](https://github.com/AppImageCommunity/AppImageUpdate) 自我更新（`.zsync` 文件） | +| Flatpak | `craft-anything--linux-x86_64.flatpak` | `craft-anything--linux-aarch64.flatpak` | 沙箱运行；`flatpak install --user ` | +| Debian/Ubuntu | `craft-anything--linux-x86_64.deb` | `craft-anything--linux-aarch64.deb` | | +| Fedora/RHEL/openSUSE | `craft-anything--linux-x86_64.rpm` | `craft-anything--linux-aarch64.rpm` | | +| Tarball | `craft-anything--linux-x86_64.tar.gz` | `craft-anything--linux-aarch64.tar.gz` | 解压到任意位置 | + +RISC-V（riscv64）：`craft-anything--linux-riscv64.tar.gz`，只有 tarball。 + +### FreeBSD + +| 构建 | 文件 | +|---|---| +| x86_64 | `craft-anything--freebsd-x86_64.tar.gz` | + +### Web（WebAssembly） + +| 构建 | 文件 | 说明 | +|---|---|---| +| 浏览器查看器 | `craft-anything-web-.zip` | 在浏览器里说明一个文件是什么（文件本身不离开浏览器）；把这个文件夹放到任意静态 Web 服务器上即可（[packaging/web/README.md](packaging/web/README.md)） | + +
+ +

+ 加入 ArtCraft 的 Discord 社区 +

+ +

来和我们一起做东西

+ +

+ 我们的 Discord 是各类创作者待的地方：画画的人、拍摄的人、绘图的人、剪片子的人、排版的人， + 以及还在摸索自己喜欢做什么的人。分享你正在做的东西、求助、告诉我们哪里坏了，或者说说你希望 + 这些工具能做什么。不论你用什么媒介、入行多久，这里都欢迎你。 +

+ +

+ discord.gg/artcraft · + getartcraft.com · + The Crafting Apps · + Craft Anything +

+ +--- + +## The Craft App Suite + +| | 应用 | 用来做什么 | 代码 | 了解更多 | +|:-:|---|---|---|---| +| | **PhotoCraft** | 图像编辑：图层、蒙版、文字，以及真正的 PSD 文件 | [GitHub](https://github.com/storytold/photocraft) | [网站](https://getartcraft.com/apps/photocraft) | +| | **VectorCraft** | 矢量插画 | [GitHub](https://github.com/storytold/vectorcraft) | [网站](https://getartcraft.com/apps/vectorcraft) | +| | **FilmCraft** | 视频剪辑、调色与声音 | [GitHub](https://github.com/storytold/filmcraft) | [网站](https://getartcraft.com/apps/filmcraft) | +| | **LightCraft** | 照片库与 raw 冲图 | [GitHub](https://github.com/storytold/lightcraft) | [网站](https://getartcraft.com/apps/lightcraft) | +| | **PdfCraft** | 阅读、整理与保护 PDF | [GitHub](https://github.com/storytold/pdfcraft) | [网站](https://getartcraft.com/apps/pdfcraft) | +| | **EffectCraft** | 动态图形与视觉特效 | [GitHub](https://github.com/storytold/effectcraft) | [网站](https://getartcraft.com/apps/effectcraft) | +| | **DesignCraft** | 页面排版与出版 | [GitHub](https://github.com/storytold/designcraft) | [网站](https://getartcraft.com/apps/designcraft) | +| | **FigCraft** | 界面设计与原型 | [GitHub](https://github.com/storytold/figcraft) | [网站](https://getartcraft.com/apps/figcraft) | +| | **WordCraft** | 文字处理与文档 | [GitHub](https://github.com/storytold/wordcraft) | [网站](https://getartcraft.com/apps/wordcraft) | +| | **SoundCraft** | 音频录制与编辑 | [GitHub](https://github.com/storytold/soundcraft) | [网站](https://getartcraft.com/apps/soundcraft) | +| | **DeckCraft** | 演示文稿与幻灯片 | [GitHub](https://github.com/storytold/deckcraft) | [网站](https://getartcraft.com/apps/deckcraft) | +| | **CADCraft** | 计算机辅助设计 | [GitHub](https://github.com/storytold/cadcraft) | [网站](https://getartcraft.com/apps/cadcraft) | +| | **GridCraft** | 电子表格与数据 | [GitHub](https://github.com/storytold/gridcraft) | [网站](https://getartcraft.com/apps/gridcraft) | +| | **TextureCraft** | 3D 贴图绘制 | [GitHub](https://github.com/storytold/texturecraft) | [网站](https://getartcraft.com/apps/texturecraft) | +| | **Craft Anything** | 看清任意软件是怎么做的，然后造一个自己的 | [GitHub](https://github.com/storytold/craft-anything) | [网站](https://getartcraft.com/apps/craft-anything) | +| | **SolidCraft** | Tangency Labs 的参数化 3D CAD（社区应用） | [GitHub](https://github.com/tangency-labs/solidcraft) | | + + + + +## 许可与致谢 + +Craft Anything 采用 [MIT](LICENSE-MIT) 或 [Apache-2.0](LICENSE-APACHE) 双许可，任你选择。 +Copyright (c) 2026 ArtCraft Team and the Craft Anything contributors。必需的声明在 [NOTICE](NOTICE)。 + +随附的字体、图标、图片和其他资源各自保留其开源许可；每一项都在 [ATTRIBUTION.md](ATTRIBUTION.md) 里列出了作者、来源和许可。 + +截图里展示的是为它们制作的示例项目：example.com、一个贪吃蛇游戏和一个小计算器程序。 + +[`docs/brand/`](docs/brand/) 里的 ArtCraft 名称、标志图形和 logo 是 ArtCraft Team 的商标，不在本许可范围内。 +它们只能在未作修改的前提下，作为本仓库和 Craft Anything 的一部分使用，并须遵守 +[`docs/brand/LICENSE-brand.txt`](docs/brand/LICENSE-brand.txt)。分支和修改版必须移除它们。 + +

+ ArtCraft
+ 由 ArtCraft 团队与社区制作。 +

\ No newline at end of file diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index 823ddb49..5df94c08 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -771,6 +771,10 @@ Gaps found while using the app for real projects. - [x] Simplified and Traditional Chinese UI catalogs, system-locale selection and translated tool-title search; catalog integrity, coverage checks and isolated language-switch tests ([localisation](localization.md)) +- [ ] A Simplified Chinese README (`README.zh.md`) translated from `README.md`, linked from the + language switcher in `README.md` and `README.ja.md` — claimed: maple323, branch docs/readme-zh +- [ ] `README.ja.md` is behind `README.md`: the whole Craft App Suite section is missing, so the + Japanese translation needs a catch-up pass - [x] First run sets up who builds, not only who answers, and no longer says the purpose is saved with projects (it stays on the computer); its Back has a name for screen readers - [x] An error whose fix quotes a command (`claude auth login`, `codex login`) offers to copy it,