词遇的中文产品、使用、开发与设计文档。站点采用 VitePress 官方默认主题，支持本地搜索、明暗主题和 Mermaid 图解。
使用页提供实际操作步骤和完整阅读工作区截图。图片保持原有正文尺寸，宽图随正文自适应；点击或按 Enter 放大，按 Esc 关闭。手机和明暗主题使用同一套正文。
所有正文都维护在根目录 docs。website/ 只保存前端配置；构建前会校验并建立 website/docs → ../docs 入口，让站点直接使用这份正文。
两个平台是平级的源码、文档与贡献入口，使用同一条 main 历史；可任选一处参与，跨平台跟进同一问题时引用原讨论。
需要 Node.js 22.12–25 与 npm。
npm ci
npm run dev启动后，终端会显示本机访问地址。运行完整检查并预览生产构建：
npm run verify
npx playwright install chromium
npm run test:dev
npm run test:ui
npm run serve -- --port 4174构建、开发和预览均以 website 为 VitePress 根目录，产物统一在 website/.vitepress/dist。脚本拒绝覆盖真实目录或指向其他资料的软链接。
| 内容 | 入口 |
|---|---|
| 产品与版本 | 词遇是什么 · 版本与路线 |
| 安装与使用 | 快速开始 · 学习规划与练习 |
| 操作演示 | 桌面端 · 浏览器插件 |
| 本地连接 | 连接桌面 · 协议 |
| 架构与贡献 | 系统架构 · 开发入口 |
| 维护此站 | 文档站维护 · 贡献指南 |
这里说明当前产品与后续路线，正式接口仍以各项目仓库的规范为准。1.0.0 是本地连接阶段，云账号和同步属于 2.0.0 规划。文档站建成不代表桌面软件、插件商店或云端已经发布。
产品的首次正式版本及标签统一为 1.0.0，Desktop、Core、Browser 与 LMCP 各仓独立核验和发布；本站不单独打产品版本标签。首次公开整理保留原始 init commit 与当时的结果提交；后续正常追加提交，不因增加平台重写已公开历史。开发历史备份不进入公开分支。六仓交付范围、检查与依赖顺序见发布与版本管理。
GitHub Actions 在 push 与 PR 时执行隔离脚本测试、引用检查、格式检查和静态构建，并对真实 dev 冷启动与生产预览运行无头 UI 回归。Gitee 托管同一份源码与文档，当前未配置 Gitee 流水线或 Pages 部署；两边都可运行相同的本地检查。GitHub Pages 部署仅由维护者手动触发，配置见 维护文档站。
文档站不接入遥测、外部字体或云搜索。依赖锁定到稳定 VitePress 1.6.4；将其构建链中的 Vite 固定为含安全修复的 6.4.3，并通过实际构建与页面测试验证兼容性。
自有代码和文档使用 AGPL-3.0-only。项目截图、品牌资源的出处与第三方许可见 素材来源 和 隐私与许可。感谢 VitePress、Mermaid 和 Prettier；其原许可保留在依赖包中。