0.7.6.3

docs/PRODUCT.md

@@ -0,0 +1,62 @@
+# 产品文档 / Product
+
+## 中文
+
+### 产品一句话
+
+阑山桌面是一个可编排的桌面信息与交互空间，面向需要高频查看信息、追求桌面效率与个性化体验的用户。
+
+### 产品定位
+
+- 产品类型：跨平台桌面环境增强工具
+- 技术基线：Avalonia UI + .NET 10
+- 支持平台：Windows、Linux、macOS
+- 仓库角色：本仓库是桌面宿主、插件运行时、Plugin SDK 与共享契约的权威来源
+
+### 目标用户
+
+- 学生用户：课程表、自习监测、计时、天气和日常信息聚合
+- 办公用户：日历、资讯、最近文档、常用工具入口
+- 效率和美化爱好者：自由布局、主题切换、插件扩展
+- 中文用户：本地化界面、农历和节假日等本地语境支持
+
+### 核心使用场景
+
+- 学习辅助：课程表、自习环境监测、计时与知识卡片
+- 信息聚合：天气、新闻、日历、热搜等信息集中展示
+- 效率提升：最近文档、浏览器、工具组件与桌面快捷访问
+- 个性化桌面：自由布局、多页桌面、主题与视觉风格配置
+- 插件扩展：通过 `.laapp` 插件补充新的组件、设置页和集成功能
+
+### 核心能力
+
+- 桌面组件系统：内置组件与扩展组件统一注册、统一放置约束
+- 插件系统：宿主加载插件、整合设置页、组件与市场安装流
+- 外观系统：主题、玻璃层级、圆角与颜色资源统一管理
+- 设置系统：独立设置窗口、设置页注册与分域持久化
+- 跨平台运行：基于 Avalonia 的桌面宿主运行在 Windows、Linux、macOS
+
+### 当前阶段
+
+- 产品版本：`1.0.0`
+- Plugin SDK API 基线：`4.0.0`
+- 当前重点：持续完善宿主体验、设置页体验、组件能力与插件生态
+- 近期需求入口：以 `.trae/specs/` 中的 feature spec 为准
+
+### 生态边界
+
+- 本仓库负责：宿主代码、插件运行时、SDK、共享契约、主题与设置基础设施
+- `LanAirApp` 负责：插件市场元数据、开发者生态材料
+- `LanMountainDesktop.SamplePlugin` 负责：官方示例插件实现
+
+### 维护原则
+
+- 产品事实只在本文件沉淀，不在多个根目录文档重复维护
+- 代码结构和运行方式分别以 `docs/ARCHITECTURE.md` 与 `docs/DEVELOPMENT.md` 为准
+- 专题规范以 `docs/VISUAL_SPEC.md`、`docs/CORNER_RADIUS_SPEC.md` 等专题文档为准
+
+## English
+
+LanMountainDesktop is a cross-platform desktop enhancement product built with Avalonia UI and .NET 10. It targets students, office users, and customization-focused users who want a programmable desktop surface for information, tools, and plugin-driven extensions.
+
+This repository is the source of truth for the desktop host, plugin runtime, Plugin SDK, shared contracts, and core appearance/settings infrastructure. The current product version is `1.0.0`, and the active Plugin SDK baseline in this repository is `4.0.0`.