[中] 打包后文档里的音效说明链接失效

Open
#60 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
Half a day
Newbie friendliness
64/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
markdown, shell

Research direction

Start from the four doc references at docs/第三方许可.md:54, docs/使用说明.md:266, docs/windows/使用说明.md:276, and docs/windows/第三方许可.md:61, then trace how scripts/build_app.sh:37 and windows/BirdLock.spec:13 lay out Docs and audio in packaged apps. Compare the repo-relative ../SharedResources/Audio/README.md target with the packaged macOS Contents/Resources/Docs and Windows _internal/docs/windows paths. Done when the links resolve in both packaged outputs without breaking the repository links.

Written by the indexing model from the issue text.

Description

位置:docs/第三方许可.md:54、docs/使用说明.md:266、docs/windows/使用说明.md:276、docs/windows/第三方许可.md:61;scripts/build_app.sh:37;windows/BirdLock.spec:13

现象:仓库内 ../SharedResources/Audio/README.md 有效,但打包后失效:Mac 把音频复制到 Contents/Resources/Audio、文档在 Contents/Resources/Docs,链接解析到不存在的 Contents/Resources/SharedResources/Audio/README.md;Windows 音频在 _internal/audio、文档在 _internal/docs/windows,../../SharedResources/Audio/README.md 同样不存在。

建议:构建时在 Docs 下补齐对应的 SharedResources/Audio,或让打包文档使用包内实际相对路径;不要直接改仓库路径,否则会破坏仓库内链接。

来源:2026-11-15 全仓只读审计,PR #7 未包含此项。

Dominant language
Swift
Stars
2
Forks
2
Avg merge
1h 11m
Merged PRs (30d)
2

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from cyandee/BirdLock

All issues in cyandee/BirdLock

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.