快速入门
结合使用栈与工作树的常见工作流（功能开发、PR 测试、服务端变更）。
本页是开发工作流的“即拷即用”速查参考。
1) 常规功能开发（推荐）
基于上游创建工作树（保持干净的 PR 提交记录）：
hstack wt new my-feature --from=upstream --use创建独立栈并固定至当前激活的工作树：
hstack stack new exp1
hstack stack wt exp1 -- use active以开发模式运行该栈：
hstack tui stack dev exp1若无法使用 TUI（非交互式终端或 CI 环境），请运行：
hstack stack dev exp1将分支推送到你的 Fork 仓库：
hstack wt push active --remote=origin2) 使用规范的 dev/ 检出代码
若直接在 dev 分支上工作（维护者常见操作）：
hstack stack new dev
hstack stack wt dev -- use dev
hstack tui stack dev dev
# (optional) mobile dev-client + QR:
hstack tui stack dev dev --mobile3) 开发服务端变更（完整服务端）
创建完整服务端栈：
hstack stack new full1 --server=Kaiwu-server随后运行开发模式：
hstack tui stack dev full1说明：
- 此操作会使用 Docker 托管的 Postgres/Redis/Minio 来支持该栈。
- 若不希望由 Docker 托管基础设施，可在栈环境配置文件中配置
DATABASE_URL/REDIS_URL/S3_*后重新运行。
4) 在本地测试上游 PR
创建 PR 工作树：
hstack wt pr 123 --use创建固定到该工作树的 PR 栈：
hstack stack pr pr123 --repo=123 --dev若已有 dev-auth 种子栈，可进行数据预置并关联或复制认证信息：
hstack stack pr pr123 --repo=123 --dev --seed-auth --copy-auth-from=dev-auth --link-auth5) 将旧版多仓提交迁移至 Monorepo
若待合并的修改仍留在旧版多仓架构中（原 UI/CLI/server 仓库），请参阅：
6) 在工作树上执行单次校验
针对当前检出代码进行快速检查（非栈作用域）：
hstack typecheck all
hstack lint all
hstack test all执行栈作用域校验（排查运行时问题时推荐使用）：
hstack stack typecheck exp1 all
hstack stack lint exp1 all
hstack stack test exp1 all© 乾元执中（南京）科技有限公司 · WUJI-Labs