Skip to content
RespoPublic

About

Guidebook for Respo Calcit

Resources

Stars

1 star

Watchers

2 watching

Forks

Repository files navigation

Respo Guidebook

开发使用配对的 Calcit CLI 和 @calcit/procs 0.42.1,并从正式标签解析 Docs Workflow 0.1.0 与 Reel 0.11.0。更新依赖后重新生成前端。

Guide 说明当前 Ref/watch、Option、event handler/app dispatch、名义 Store 和宿主边界。 旧 Beginner Guide、部分 Guide 实现说明和 API 仍有历史片段,尚未全部迁移或独立执行;站点构建通过不代表 所有旧示例都可用于当前版本。新应用以维护中的模板和已发布接口为准。

开发与验收

Node 24、Yarn 4.18.0、正式 0.42.1 CLI。

corepack enable
caps --strict --ci
yarn install --immutable
caps verify --toolchain
calcit --check-only --all-defs
calcit fix --workflow strict --verify
yarn dev

yarn build 默认使用相对资源路径,VITE_BASE_URL 可指定前端 CDN 根路径。CI 检查所有定义、公开 namespace、完整 strict、旧调用与动态方法,构建 SPA/mdBook 并保存 PR 预览。当前 Guide 计数器与 DOM Events 数据解码示例由官方代码块检查覆盖;原项目没有定义附带测试,零个测试不等于业务覆盖;浏览器导航、 搜索与刷新需另行验收。页面 hud! 错误展示保留。

文档导航直接派发具名 docs-workflow.schema/Op。Reel 面板和快捷键通过独立回调接收 reel.typed/Control。

部署边界

生产 SPA 引用 https://cos-sh.tiye.me/Respo/guidebook/ 下的静态 assets,COS 只用 action 内置校验,不新增脚本。原 SPA/mdBook 的 rsync 目录均保持 /web-assets/repo/Respo/guidebook,无服务端部署。本 PR 不自动合并或发版。 组织级 COS secrets 需要授权本仓库;PR 不读取部署凭据、不运行 COS 或 rsync。 原 SHA256 校验的 rsync/mdBook 安装、SSH 主机校验和 main 部署条件保留。 CI 的类型步骤显式启用 pipefail,保留上游 Calcit 失败退出码;canonical diff 仅静默输出。 npm 新版本解析使用统一一小时包龄,无包级豁免;已有 lock 的 immutable 重放不重新检查包龄。

# 与 CI 对齐 mdbook 0.4.14 / mdbook-linkcheck 0.7.6
mdbook build

已知 mdBook Cirru 高亮回退为纯文本,见 Docs Workflow #95;当前构建不声称修复该限制。

License

MIT

About

Guidebook for Respo Calcit

Resources

Stars

1 star

Watchers

2 watching

Forks

Used by

Contributors

Languages