Files
fanlusky a7779d2b05 refactor(engine): 将 engine 从 submodule 内嵌为仓内一等组件
`vendor/MetasequoiaImeEngine` submodule 改为 `engine/` 目录,导入的是
product-lock.json 原本钉住的提交 c810d201,逐文件核对过 blob,因此这是一次
搬迁而不是引擎升级。引擎自己的嵌套 submodule(googlepinyinime-rev、utfcpp、
miniaudio)按各自 gitlink 一并展开,来源与提交见 engine/UPSTREAM.md。

Windows 专门化裁掉了不属于本产品的部分:whisper.cpp 与本地推理 provider、
macOS 示例宿主、整个 dictionary/ 建库流水线、上游 CI 与 release-please 配置。
词库仍按 product-lock.json 在构建时取发布产物。

引擎不再进 product-lock.json:没有 gitlink 就没有可比对的东西,锁里写一个上游
commit 等于宣称这棵树仍等于上游,而第一个 Windows 专门化改动落地时这句话就假了。
verify-contracts / verify-checkout 随之移除,verify-published 保留。

CI 与工具链:引擎源码并入根 scripts/format.sh(删掉引擎自己的那份,避免两套排除
列表分叉);引擎 voice.yml 里的 silero_vad.onnx 摘要校验移到本仓 lock job;
engine-bump-triage 工作流与其测试删除;gitsubmodule 的 dependabot 频率由 daily
改为 monthly。

README、README.en、AGENTS.md、CONTRIBUTING、docs/product-release.md 及各子目录
文档同步说明新的位置与边界。
2026-09-12 03:40:48 +08:00

30 lines
1.3 KiB
C++

#pragma once
#include <filesystem>
#include <string>
namespace metasequoia
{
// Paths are captured at construction. Changing process environment variables cannot redirect
// an existing session. Mutable dictionary copies are durable user data, never disposable cache.
struct RuntimePaths
{
std::filesystem::path resources;
std::filesystem::path user_data;
std::filesystem::path cache;
std::filesystem::path dictionaries;
static RuntimePaths legacy();
std::filesystem::path resource(const std::filesystem::path &name) const;
std::filesystem::path user(const std::filesystem::path &name) const;
std::filesystem::path dictionary(const std::filesystem::path &name) const;
void validate() const;
};
// The host verifies the published bundle and supplies its immutable content ID. Quiesce all
// sessions and user-data writers during preparation/switching. New generations are staged,
// replayed and renamed as a directory; failure never replaces a working generation.
// The three roots must be disjoint (including resolved symlinks): none may contain another.
RuntimePaths prepare_runtime_paths(const std::filesystem::path &resources, const std::filesystem::path &user_data,
const std::filesystem::path &cache, const std::string &content_id);
} // namespace metasequoia