Repository navigation
TB-423: README 加入 Moke Preview 下载与赞助内测说明 - #143
Conversation
![claude[bot]](https://avatars.githubusercontent.com/in/1236702?s=60&v=4){kind=small}
|
|
||
| OpenHarmony 安装包目前处于 alpha 阶段，建议在测试设备上体验；iOS/iPadOS 和 OpenHarmony 的签名、安装要求见对应版本的发布说明。 | ||
|
|
||
| ### Moke Preview 赞助内测 |
There was a problem hiding this comment.
结构层级不一致：顶部导航（L12）和目录（L23）都把这一节当作顶层章节链接，但这里用的是三级标题 ###，实际嵌在 ## 安装 之下（同级还有 ### Reader 开发与构建）。结果是：目录里它与 ## 快速开始 并列，文档树里它却是「安装」的子节，且 GitHub 右侧自动目录会把它折叠进「安装」。
建议改成 ## Moke Preview 赞助内测。锚点 #moke-preview-赞助内测 由标题文本决定，改成 ## 后不变，两处链接（L12、L23）无需改动。
|
|
||
| ### Moke Preview 赞助内测 | ||
|
|
||
| [Moke Preview](https://github.com/hehetoshang/moke-preview-builds) 是面向希望提前体验新功能并参与反馈的赞助者的预览通道。安装包与发布说明在独立仓库提供，具体可用平台及安装要求以对应版本的发布说明为准。 |
There was a problem hiding this comment.
按 AGENTS.md 的 Preview 晋升规则，需要先确认这个改动是否有意进入稳定 main：
- Preview-only paths and concerns are denied by default, including: … Preview activation, device leases, control-plane endpoints, signing secrets, and gated updater authorization
- A denied path may enter
mainonly when the developer explicitly changes its product scope and the PR explains why it is no longer Preview-only.
本节描述的是 Preview 的分发渠道、访问码/设备激活/联网授权与付费资格——正属于规则 4 列举的「Preview-only concern（分发与授权）」，而 PR 描述没有按规则 5 说明产品范围变化。代码侧 denylist（src-tauri/src/preview/**、src/lib/preview-entitlement.ts、tauri.preview.conf.json、preview-*.yml）在本次改动中都没有触碰，这点是好的；但 README 目前会成为 main 里唯一对外宣传 Preview 通道的位置。
考虑到 main 中已存在 .github/ISSUE_TEMPLATE/moke-preview.yml（算是先例），我不认为这一定是错误——但请维护者明确确认：这是产品决策，而非从预览分支顺带带出的内容。若是前者，建议在 PR 描述里写明；否则按规则应改为 preview: 前缀并留在 Preview 分支。
| [Moke Preview](https://github.com/hehetoshang/moke-preview-builds) 是面向希望提前体验新功能并参与反馈的赞助者的预览通道。安装包与发布说明在独立仓库提供，具体可用平台及安装要求以对应版本的发布说明为准。 | ||
|
|
||
| 1. 前往 [爱发电](https://ifdian.net/a/hehetoshang) 选择包含 Moke Preview 资格的内测方案，从私信获取一次性访问码及安装说明。 | ||
| 2. 从 [Preview Releases](https://github.com/hehetoshang/moke-preview-builds/releases) 下载适合设备的安装包。 |
There was a problem hiding this comment.
安全/信任面：官方 talebook/moke 的 README 现在直接把用户导向个人账号下的二进制分发仓库（L82 的 hehetoshang/moke-preview-builds/releases）。README 其余部分的安装包都由本项目 Release 流程产出、签名与 CI 可追溯，这里没有任何说明来区分两者，用户很容易默认它们同等可信。
建议补一句边界说明，例如：
- 这些安装包不属于
talebook/moke的官方 Release，不在本项目的发布签名与 CI 溯源范围内，安装前请以 Preview 仓库发布说明中的校验方式为准； - Moke 采用 GPLv3（见 L198），对外分发二进制时需要同时提供对应源码，请确认 Preview 仓库已提供对应版本的源码或源码获取方式。
另外 https://ifdian.net/a/hehetoshang（L81）建议确认是爱发电当前的规范域名，并把付款链接的最终指向在 PR 里记录一次——官方 README 上的收款链接写错代价较高。
| 2. 从 [Preview Releases](https://github.com/hehetoshang/moke-preview-builds/releases) 下载适合设备的安装包。 | ||
| 3. 首次启动时输入访问码，完成当前设备的激活；后续启动需要联网检查授权。更换或重装设备时，请按应用提示迁移资格。 | ||
|
|
||
| 普通赞助不代表自动获得 Preview 资格，具体权益以爱发电方案说明为准。目前 Preview 安装包未启用自动更新，更新时请前往 Preview Releases 下载新版本并按发布说明安装。 |
There was a problem hiding this comment.
两点小问题：
- 时效性：「目前 Preview 安装包未启用自动更新」是一个会过期的强断言。一旦 Preview 通道启用 updater（
main已有updater-manifest.test.mjs/update-store.test.mjs相关逻辑），这段就会变成错误的用户指引。建议弱化为指向发布说明，例如「是否支持自动更新以对应版本发布说明为准」，避免日后漏改。 - 与「支持」章节的衔接：L163 起的
## 支持章节提供的是微信/支付宝赞赏码，本节则说「普通赞助不代表自动获得 Preview 资格」。两处并列出现「赞助」但权益不同，读者容易混淆。建议在## 支持处加一句回链（如「希望参与 Preview 内测请见 Moke Preview 赞助内测」），把两个渠道的差别说清。
|
|
||
| Preview 可能包含未完成的功能或兼容性问题，请提前备份重要数据。参与方式、设备迁移与安装详情见 [Preview 仓库说明](https://github.com/hehetoshang/moke-preview-builds#readme)。 | ||
|
|
||
| 遇到问题或有体验建议时，可使用 [Moke Preview 专用反馈表单](https://github.com/talebook/moke/issues/new?template=moke-preview.yml&labels=moke-preview)。访问码或订单问题请通过爱发电私信联系开发者，请勿在公开 Issue 中提交访问码、订单凭证、账号密码或服务器密钥。 |
There was a problem hiding this comment.
小 nit：&labels=moke-preview 与 .github/ISSUE_TEMPLATE/moke-preview.yml 第 4 行的 front matter labels: [moke-preview] 重复。两者都会生效，所以无害；但如果日后标签改名，URL 参数会被静默忽略（标签不存在时 GitHub 不报错，只创建不带标签的 Issue），而 front matter 才是真正生效的那个。若想保留 URL 参数以便分享时也能带上标签，可以不管；只是建议知道它以 front matter 为准。
README 缺少已发布的 Moke Preview 下载入口。现在在首页导航、目录和安装章节加入赞助内测说明，链接到 hehetoshang/moke-preview-builds、Preview Releases 和现有专用反馈表单。
说明依据 Preview 仓库当前 README 与 preview-v1.1.5.10 发布说明，涵盖内测方案、访问码、设备激活、联网授权和手动更新，并明确公开稳定版免费提供。仅修改 README.md。
验证
git diff --check通过。moke-preview.yml模板与moke-preview标签存在。pnpm lint、pnpm typecheck、pnpm test，均受当前检出未安装依赖、Reader 子模块未初始化影响：lint 调用到旧版系统 ESLint，typecheck 缺少 tsc，test 报缺少 react/zustand/clsx 及 Reader 文件。未声称应用测试通过。Closes TB-423