文档组件

doc/ 现在可以直接在 MDX 里使用一组文档组件，不必继续手写大段 Markdown 表格。它们已经通过 doc/mdx-components.tsx 全局注册，所以任意 .mdx 页面都能直接写 JSX 标签。

1. 多工具功能矩阵

Tool	Core Capability	Entry / Surface	Notes
CLI Stable 用户入口，负责执行同步与清理流程。	执行默认同步管线支持 dry-run / clean / config 作为 npm / crate 暴露入口	tnmsc pnpm -C cli exec node dist/index.mjs --help	用户真正执行的入口还是 CLI，而不是文档或 GUI。
MCP Server Stable API 对外暴露 prompt 管理能力。	列出 prompt 读取 source / dist 更新 zh/en source 写入翻译产物	memory-sync-mcp stdio server MCP client integration	它复用 CLI 侧的 prompt service，不应单独发明新 Schema。
GUI Beta 桌面调用层与展示层。	调用 tnmsc crate 承载桌面工作流展示项目状态与操作页面	Tauri desktop shell React frontend	GUI 负责调用与呈现，不应反过来主导领域设计。

2. 多系统支持矩阵

System	Support	Coverage	Notes
Windows	Full	CLI 工作流文档站开发 Tauri 桌面开发	对本仓库用户群最关键，命令示例应优先覆盖。
macOS	Partial	CLI 工作流文档站开发	原则上支持，但桌面与签名链路需要单独验证。
Linux	Partial	CLI 工作流文档站开发部分桌面场景	适合 CI 与开发机，桌面分发要看发行版差异。
WSL	Recommended	Node / pnpm / Rust 开发跨 Windows 文件系统协作	仓库当前就很适合在 WSL 下维护。

3. 系统展示卡片

Desktop

Windows

Full

主要桌面用户环境，适合搭配 WSL、PowerShell 与 Tauri GUI 一起说明。

优先给出安装与升级路径
适合展示 GUI 与 CLI 双入口
文档截图与命令示例价值最高

Desktop

macOS

Partial

开发者常见环境，适合补充 Homebrew、codesign、桌面集成等细节。

强调开发体验
需要单独处理签名分发
命令与路径写法要避免 Windows 假设

Desktop / CI

Linux

Partial

更适合作为自动化、CI 与本地开发环境的说明对象。

适合展示 CI/构建命令
发行版差异要写清楚
桌面分发能力需按包格式拆开

4. 技术栈命令参考

Stack	Task	Command	Runtime	Notes
pnpm workspace	安装依赖	`pnpm install`	Node.js 22+	所有工作区都从根目录开始。
docs / Next.js	本地开发文档站	`pnpm -C doc dev`	Node.js 22+	适合和 MDX 组件一起预览。
docs / Next.js	类型检查	`pnpm -C doc run validate:contentpnpm -C doc run typecheck`	Node.js 22+	改了 MDX、frontmatter 或组件后都应该跑。
Rust workspace	执行测试	`cargo test --workspace`	Rust 1.88+	适合核对 Rust-first 侧是否被改动影响。

使用方式

在任意 MDX 页面中直接写：


<FeatureMatrix items={[{tool: 'CLI', capabilities: ['sync'], surfaces: ['tnmsc']}]}/>
<SupportMatrix items={[{system: 'Windows', support: 'full'}]}/>
<PlatformGrid items={[{name: 'Windows', description: 'Primary desktop target'}]}/>
<CommandReference items={[{stack: 'pnpm', task: 'dev', command: 'pnpm -C doc dev'}]}/>

如果后面还要继续扩展，建议沿着这个方向做，而不是回到散乱的原生 Markdown 表格：

表格类信息继续复用 FeatureMatrix、SupportMatrix、CommandReference
偏展示型内容复用 PlatformGrid
需要完全自由布局时，再单独加新的卡片或对比组件

文档组件

1. 多工具功能矩阵

memory-sync 工具能力矩阵