Skip to content

迁移正式 Calcit 0.30.1,统一文档类型并保留历史示例边界 - #16

Merged
tiye merged 3 commits into
mainfrom
migrate/respo-guidebook-formal031
Oct 23, 2026
Merged

tiye merged 3 commits into
mainfrom
migrate/respo-guidebook-formal031

Conversation

@tiye

@tiye tiye commented Oct 23, 2026 •

Copy link
Copy Markdown
Member

读者与维护者需要注意

本站从 Calcit/procs 0.20.0 配对升级到正式 0.30.1,重新安装依赖并完整刷新页面;UI 0.8 基础样式可能影响外观。原章节、标题与侧栏顺序保留,Guide 补充当前合同说明。Beginner Guide 和其他历史 API 片段尚未全部逐段迁移,不能把站点构建成功当成所有文档示例可运行的保证。

保留草稿,不自动合并、发版或部署。COS 仅前端 assets;原 SPA/mdBook 的 rsync 目录 /web-assets/repo/Respo/guidebook 不变,无后端迁移。组织级 COS secrets 需授权本仓库后才可生产发布,PR 不访问部署凭据。

具体变更

  • 使用已发布 Docs Workflow 0.0.37、Respo 0.16.124、Reel 0.6.41、UI 0.8.0、Markdown 0.4.59、Router 0.8.37、JS-FFI 0.2.5;不用 alpha、main 或 hash 覆盖。
  • 文档树由匿名 Map 转为 DocNode,统一采用 Docs Workflow 的名义 Store/Op 与 updater,不再声明两个字段相似却不相同的应用类型。保留原文档内容和顺序。
  • 迁移旧 Option helper、defatom/watch;使用 Respo 自有 DOM 合同和检查过的操作边界、JS-FFI timestamp,移除原 Date.now unsafe。reload 保留两处分支的 hud! 与原错误载荷,仅显式返回 Unit,不改为 raise。
  • 删除旧 npm docs-workflow 及其重复 procs 0.5.48;移除强制 parser0.0.9 的旧 resolutions,让正式 procs 使用声明的0.0.10。CSS 改读同一正式源码模块;只用最小 Vite preserveSymlinks 配置,不复制共享模块或给缓存安装依赖。
  • 普通 Actions 用精确正式 tag,保留原 rsync/mdBook SHA256 下载校验、SSH 主机校验和 main-only 部署条件;COS 使用 action 自带校验,没有额外校验脚本、concurrently、质量预算或测试框架。

验收与范围

独立正式 Linux CI 39985345182 已通过:fresh Caps strict/immutable/toolchain、官方结构化事务、所有定义/公开 namespace、完整 strict、旧调用/动态方法检查、生成 JS 和 Vite 构建。辅助事务与验收工作流不进入本 PR,本地不运行 Caps,也不安装/构建编译器或用 alpha 编译正式图。

原项目没有定义附带测试;不将测试零匹配计作业务覆盖。不宣称所有历史 Markdown 片段已独立执行或全生态旧语法可删除。原自动保存行为保留,不新增存档恢复/兼容层。

最终提交 7d6c5a4d95165305efbe99ee976441037d14907d 的原完整 CI 39985700433 成功,包含所有类型门禁、SPA、经校验的 rsync/mdBook 安装与 mdBook 构建;COS/SSH/两项生产部署全部跳过。公开定义14/14、全定义241/241、strict诊断为空,14个应用定义均有完整类型覆盖;不将此等同于依赖图所有动态边界已消失。

SHA256 校验最终 artifact 后,未经修改的 SPA/mdBook 在全新 localhost 来源实测通过:Home当前版本提示、Beginner历史警示、Ctrl+P深层章节选择、Guide父级返回、刷新回到原默认Guide;SPA控制台warn/error均为空。独立mdBook入口和Guide导航正常;Cirru代码块仍出现已有 #95 的缺高亮语言warning,未宣称全站零warning。Quickjump退出动画短暂残留AX节点,截图和稳定AX确认弹层已关闭,不误报运行时故障。没有剪贴板、真实存档、登录或生产访问;临时页面与服务已关闭。

上游评估

干净正式消费者复现模块内 CSS npm 解析失败,与已有 Docs Workflow #90 一致;采用其已验证的最小配置,不重复报 issue 或增加编译器规则。SPA 相对 Markdown 链接仍按 #96 跟踪,主页引导使用已有侧栏导航。mdBook 的历史高亮局限另见 #95。

@coderabbitai

coderabbitai Bot commented Oct 23, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

Note

Currently processing new changes in this PR. This may take a few minutes, please wait...

⚙️ Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: ASSERTIVE
  • Plan: Advanced
  • Run ID: b0c24633-0ca5-4ab9-808a-0c5c4dd2687b
📥 Commits

Reviewing files that changed from the base of the PR and between d795eeb and 7d6c5a4.

⛔ Files ignored due to path filters: 1
  • yarn.lock is excluded by !**/yarn.lock, !**/*.lock
📒 Files selected for processing: 12
  • .github/workflows/upload.yaml
  • .gitignore
  • .yarnrc.yml
  • README.md
  • assets/main.css
  • calcit.cirru
  • deps.cirru
  • docs/beginner-guide.md
  • docs/guide.md
  • docs/home.md
  • package.json
  • vite.config.mjs
+-------------------------------------------------------------------+
| It's elementary, my dear Watson. The bugs are hiding in the code. |
+-------------------------------------------------------------------+
  \
   \     /)/)
        ( '')
        /  |
      o(___)
✨ Finishing Touches
📝 Generate docstrings
  • Commit to this branch
  • Create a new PR
🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@tiye
tiye marked this pull request as ready for review October 23, 2026 16:30
@tiye
tiye merged commit e4882cf into main Oct 23, 2026
1 check passed
@tiye
tiye deleted the migrate/respo-guidebook-formal031 branch October 23, 2026 16:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant