Skip to content

文档里的文件路径有多处已不存在(ARCHITECTURE.md 与 release 责任矩阵) #478

Description

@1816586742-stack

核对文档引用时发现,两份文档里列举的文件路径有相当一部分在当前代码树中不存在。同一份清单里的其他条目是可以解析的(例如 apps/src-tauri/src/lib.rscrates/service/src/gateway/request/session_affinity.rs),所以这些清单看起来是在维护的,先把证据列出来请你判断。

docs/en/ARCHITECTURE.md

30 条文件引用中 16 条找不到目标,例如:

apps/src/main.js
apps/src/runtime/app-bootstrap.js
apps/src/runtime/app-runtime.js
apps/src/settings/controller.js
apps/src-tauri/src/settings_commands.rs
apps/src-tauri/src/rpc_client.rs

apps/src/apps/src-tauri/ 目录都存在,但 apps/src/ 下现在是 Next.js 结构(app/components/hooks/ 等),没有 main.jsruntime/settings/ 这几个入口。

docs/en/report/script-and-release-responsibility-matrix.md

8 条引用全部找不到目标:

scripts/release/build-tauri-with-retry.ps1
scripts/release/stage-service-package.ps1
scripts/release/publish-github-release.sh
rebuild.ps1
bump-version.ps1
tests/gateway_regression_suite.ps1

其中 scripts/scripts/release/ 目录存在,scripts/rebuild.ps1 也在,但文档里是按相对 docs/en/report/ 的位置写的,所以解析不到。

想确认的

这些条目是历史遗留(前端重构之前的结构),还是应该指向当前的文件?如果是前者,我可以提一个 PR 把这些条目更新或删掉;如果是后者,告诉我目标路径,我来改。

复现方式

对每个引用路径做一次存在性检查即可:

git ls-files | grep -E 'apps/src/(main\.js|runtime/|settings/)'
git ls-files | grep -E 'scripts/release/|scripts/rebuild\.ps1'

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions