0 Fork 0

Files

T

Evan 4fc16952b3 wip(windows): 补齐隐私与许可交付，修好外部人的构建入口

- 新增 PRIVACY.md：逐项写明每个联网端点、发送内容、默认开关与关闭方式，明确云候选默认开启、
  token 在 config.toml 明文存储、无任何遥测
- 设置页「用户协议」「隐私政策」两个无 handler 的死按钮接上；前者改名为「开源许可协议」指向
  LICENSE，开源产品的用户条款就是许可证本身，不再承诺一份不存在的 EULA
- 安装包随包装入 GPL 正文并在安装向导显示（GPLv3 §4/§6），补上打包测试断言
- release.yml 增加 build provenance attestation，并在发布后向 MSIME-Web 发 repository_dispatch，
  让 msime.app/update.json 不再等两小时一次的 cron
- 所有 CMakePresets 的 vcpkg 路径改用 $env{VCPKG_ROOT}，server 的 Boost 回退不再指向个人目录
- ui/README.md 指向本机绝对路径的 markdown 死链改成相对链接
- 新增 check-developer-paths.sh 并接入 required 的 quality 检查，防止路径回潮
- docs/installation.md 不再写死版本号

2026-09-06 12:05:06 +09:00

scripts

refactor: collapse the duplicated submodules into one vendor/ directory

2026-09-06 02:27:52 +09:00

webview2

wip(windows): 补齐隐私与许可交付，修好外部人的构建入口

2026-09-06 12:05:06 +09:00

.gitignore

add git ignore

2025-12-08 13:29:47 +08:00

LICENSE

chore: add license

2025-11-10 21:13:13 +08:00

README.md

docs: describe one repository instead of six

2026-09-06 02:40:51 +09:00

README.md

Metasequoia IME UI HTML

水杉输入法 Windows 端的界面资源。Server 加载这里的页面来渲染候选窗、悬浮工具栏、托盘菜单和设置窗口。

webview2/shared/ 是 Engine web 契约的副本，由 scripts/sync-contracts.py 从 ../vendor/MetasequoiaImeEngine/contracts/webview/ 生成，CI 用 --check 验证两者一致。要改契约请改 Engine，不要直接改这个目录。

同仓的相关组件：../windows/（TSF 前端）、../server/（后端与窗口宿主）。

路径	内容
`webview2/candwnd/`	候选窗，含 `skins/` 下的皮肤
`webview2/ftb/`	悬浮工具栏
`webview2/menu/`	托盘菜单
`webview2/settings/ime-settings/`	设置页，唯一需要构建的部分，Vite + TypeScript
`webview2/default-themes/`、`webview2/other-themes/`	主题

构建设置页

设置页是发布安装包的必要输入之一，pnpm build 的产物 dist/ 会被打包脚本收集。

cd webview2/settings/ime-settings
corepack enable
pnpm install --frozen-lockfile
pnpm build

pnpm 版本由 package.json 的 packageManager 字段固定，corepack enable 之后不用自己装。开发时用 pnpm dev 起本地服务。

本地调试

把本仓链接到 Server 的数据目录，改页面就不用重新打包：

$target = Join-Path $env:LOCALAPPDATA 'metasequoiaime\html'
if (Test-Path -LiteralPath $target) {
    Remove-Item -LiteralPath $target -Recurse -Force
}
New-Item -ItemType SymbolicLink -Path $target -Target (Resolve-Path .).Path

必须用绝对路径，Resolve-Path 就是用来把当前目录转成绝对路径的。设置页走这条路时链接的仍是仓库目录，页面读的是 webview2/settings/ime-settings/dist/，所以改完设置页要重新 pnpm build。

与 C++ 侧的边界

窗口归 Server，页面归本目录。HWND、尺寸、位置、DPI、Z-order 和 WebView2 controller 的生命周期都在 ../server/src/window/ 与 ../server/src/webview2/；页面结构、样式和浏览器端交互在这里。

C++ → 页面主要经 WebView2 导航和脚本执行，页面 → C++ 经 window.chrome.webview.postMessage(...)。改消息 type、JSON 字段、页面导出的 JS 函数或 DOM 标识时，必须同步检查 Server 的消息解析与拼接代码，两边没有编译期约束。

候选内容和输入状态的权威在 Server 和引擎，页面只负责展示与发出用户动作；不要在页面侧复制候选选择、翻页、输入模式或配置持久化的状态机。

完整的组件边界约定见仓库根 AGENTS.md。

README.md Unescape Escape

Metasequoia IME UI HTML

目录

构建设置页

本地调试

与 C++ 侧的边界

README.md