chore: 移除 Rust/cargo czdev 死文档,新增 ./czdev wrapper + Python czdev 文档 - #16
Merged
Conversation
… docs The Rust czdev CLI and the desktop emulator (crates/, sdk/, emulator submodule) are already gone from the repo, but README and docs still documented a `cargo run -p czdev -- run/watch/deploy/doctor` flow that no longer exists. czdev is now the pure-Python publish CLI in scripts/czdev. - Add an executable ./czdev wrapper (chmod +x) that runs `python3 -m czdev` with scripts/ on PYTHONPATH, so `./czdev …` (as the docs say) actually works. - Rewrite README.md around the Python czdev CLI (login/logout/bump/publish/ unpublish), the online CI build, ownership model, and the no-root policy; remove all cargo/emulator content. - Rewrite QUICKSTART.md / _ZH / _JA into a Python czdev publish quickstart. - Delete dead docs describing removed subsystems: EMULATOR.md, architecture.md (Tauri IDE that was never built), DESKTOP_DEV.md, and the orphaned emulator screenshots. - APP_BUILDER_JSON.md: document the `store` listing section used by `czdev publish`/portal; mark the old emulator fields (runtime/entry/…) as legacy/no-longer-consumed (kept for back-compat). The Rust example app under examples/ is intentionally kept, so the Rust toolchain stays in the Dockerfile/CI to build it. Co-authored-by: Cursor <cursoragent@cursor.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
背景
Rust 版 czdev CLI 与桌面 emulator(
crates/、sdk/、emulator 子模块)其实早已从仓库删除,但 README 和 docs 里还在讲cargo run -p czdev -- run/watch/deploy/doctor这套已失效的流程。现在 czdev 就是scripts/czdev/里的纯 Python 发布 CLI。保留:examples 下的 Rust 示例 app(按需求保留),因此 Dockerfile/CI 里为它服务的 Rust 工具链不动。
改动
./czdevwrapper(chmod +x,git 记录为 100755):内部跑python3 -m czdev(把scripts/放到 PYTHONPATH),让文档里的./czdev …真正可用。README.md:围绕 Python czdev(login/logout/bump/publish/unpublish)、在线 CI 构建、先到先得归属、禁止 root 策略;删掉全部 cargo/emulator 内容。QUICKSTART.md/_ZH/_JA:改成 Python czdev 发布快速上手(中/英/日)。EMULATOR.md、architecture.md(从未实现的 Tauri IDE 设计稿)、DESKTOP_DEV.md,以及孤立的 emulator 截图。APP_BUILDER_JSON.md:补充czdev publish/网页端使用的store段;把旧的 emulator 字段(runtime/entry/…)标注为遗留、不再消费(仅向后兼容保留)。验证
./czdev --help正常输出子命令;./czdev(无参)退出码 0。APP_BUILDER_JSON.md里有意的「遗留字段」说明外,无 cargo/emulator/czdev-run 引用。Made with Cursor