docs: plan private app market and local model management

Record YAML application import/export, configurable market URLs, and future ShareServer distribution responsibilities. Define a local model management entry with managed-process and external-service boundaries; both remain planned capabilities.
2026-09-15 16:52:57 +08:00
parent 34215c72a1
commit 02e59427a1
4 changed files with 105 additions and 0 deletions
@@ -7,6 +7,12 @@
 当前分期见 [PRD 第 8 节](./prd.md#8-分期)，实施步骤见[技术设计第 11 节](./technical-design.md#11-实施顺序)。
 本轮更新实施计划与范围，旧版功能要求、验收和配套设计仍需按新计划同步，此项列为实现前的第一步。

+新增计划包括 [私有化市场与 YAML 交换](./prd.md#fr-15-私有化市场与-yaml-交换后续)：
+通过市场 URL 获取应用，支持 `.yml` 导入导出，未来由 ShareServer 提供私有目录与分发。
+[本机模型管理入口](./prd.md#fr-16-本机模型管理入口新增计划项)可独立于商店交付，拟作为
+可常驻左侧的内置管理应用，区分受管进程、外部服务和进程内模型。两项均为需求记录，
+未实现，相关后续验收见 [User Stories](./user-stories.md#7-后续需求场景)。
+
 项目活动汇总独立于上述应用中心计划，范围见 [FR-14](./prd.md#fr-14-项目活动汇总)。
 计数规则由[活动逻辑](./logic-design.md#9-项目活动汇总)定义，入口与级联菜单见
 [活动界面](./ui-design.md#10-项目活动汇总)，数据加载与会话跳转见
@@ -221,3 +221,43 @@ Switch，切换后立即持久化。系统工具区域列出四项内置固定

 现有 Demo 的商店页、项目管理和阅读空间安装流程仅保留为未来交互参考，不纳入首期验收，
 也不作为已有商店能力的说明。首期实现不预建插件安装服务或远程目录协议。
+
+### FR-15 私有化市场与 YAML 交换（后续）
+
+市场面向组织私有化部署。用户配置市场 URL 后即可获取该来源的应用目录与详情，并按需获取
+应用；需要认证的来源复用其登录流程。市场不可达时说明原因并允许重试，不影响已安装应用
+和内置应用使用，也不自动切换到公共市场。市场 URL 只影响应用市场，不改变模型、桌面更新
+或 Runtime 的下载源。
+
+应用支持以 `.yml` 导入、导出，兼容 `.yaml` 扩展名，用于组织内部共享、备份和迁移。
+导出内容为应用定义及可迁移配置，包含格式版本、应用标识、应用版本、入口声明和依赖说明；
+凭据、会话、笔记及知识库业务数据不随应用定义导出。导入前展示应用摘要、缺失依赖和与已有
+应用的冲突；同标识应用由用户选择更新或取消，不静默覆盖本机配置。
+
+YAML 描述文件不能代替模型权重或插件程序包。有外部依赖时应明确资源引用；离线导入仅在
+所需资源已具备时可完成使用，否则列出需要补充的资源，不显示为可运行。导入应用不会自动
+启动模型或执行任务。
+
+未来 ShareServer 提供私有市场目录、应用定义的导入导出、发布和版本资源分发；桌面端负责
+配置来源、获取目录、本地导入导出及应用安装管理。服务端职责归属见
+[ShareServer 总体设计](../../architecture/share-network-architecture.md)。本节记录后续需求，
+尚未确定 API、YAML Schema 或服务端交付版本，不纳入应用中心首期。
+
+### FR-16 本机模型管理入口（新增计划项）
+
+应用中心提供“本机模型”内置管理应用，可选择常驻左侧，打开主内容区管理页。该入口统一
+查看各功能使用的本机模型及服务状态，包括已接入的 OCR、向量、语音或推理引擎；具体支持
+清单需核对现有模型服务后确定，不因提供入口而假定全部引擎均已支持进程控制。
+
+页面展示模型名称、用途、所属引擎、管理方式、运行状态、占用情况及使用它的应用或任务。
+GoodBuddy 管理的进程提供启动、停止、重启和错误查看；外部启动的模型服务标明“外部管理”，
+提供连接状态与配置入口，未接入其管理接口时不提供停止或重启。进程内运行的模型按引擎实际
+能力提供加载与释放，不伪造独立进程。
+
+停止或重启前展示正在使用该服务的任务和影响，由用户决定是否继续；取消时保留运行状态，
+失败时显示实际状态和原因。多个应用共用同一模型服务时展示同一个服务及其使用方，不重复
+启动进程。隐藏管理入口、关闭管理页面或取消应用常驻均不停止模型；卸载模型文件是独立操作。
+
+资源监控仍是只读系统工具，本机模型管理负责模型生命周期，两者共享可用的状态来源。
+该项可独立于商店交付；当前只纳入计划，具体分期、任务使用期间的停止策略和各引擎管理能力
+在详细设计中确定。原首期资源监控的 GoodBuddy 桌面进程统计范围不因此扩大。
@@ -385,6 +385,23 @@ resourceMonitor.getLocalSnapshot(input: {
 首期使用内置应用清单，不依赖远程商店、插件注册或安装服务。商店目录、推荐、安装与
 更新机制在后续独立设计中确定；Demo 中的模拟商店不接入首期产品界面。

+后续设计输入见 [FR-15](./prd.md#fr-15-私有化市场与-yaml-交换后续) 与
+[FR-16](./prd.md#fr-16-本机模型管理入口新增计划项)：
+
+- 私有市场的 YAML Schema 应由桌面本地导入与 ShareServer 发布共用，具体协议与字段在
+  市场功能设计中确定。市场 URL 按设备保存，认证信息沿用受保护凭据存储；导出仅包含
+  可迁移应用定义与非敏感配置。
+- 程序包与模型资源单独分发。受管下载声明不可变版本、预期字节数和 SHA-256，下载开始后
+  固定来源，失败不静默切源；下载地址与重定向范围由 Main 验证，不接受 Renderer 任意覆盖。
+  市场来源配置不覆盖现有模型、应用更新或 Runtime 下载源设置。
+- ShareServer 的市场发布与分发实现由其独立仓库承接，本仓库先记录依赖，不将桌面需求
+  记录标为服务端已实现。
+- 本机模型管理实施前盘点现有 OCR、向量、语音及推理服务的生命周期接口，优先复用其
+  Main 服务。只为实际支持的操作提供 typed IPC；区分受管子进程、外部服务和进程内模型，
+  不把直连模型 HTTP 请求等同于独立模型进程。
+- 模型管理的详细逻辑需确定共享服务的使用方识别、忙碌时停止与重启、退出应用时的释放
+  行为，再接入管理页面并验证实际引擎。该工作单独排期，不依赖市场上线。
+
 ## 12. 项目活动汇总

 对应 [FR-14](./prd.md#fr-14-项目活动汇总)，按[活动逻辑](./logic-design.md#9-项目活动汇总)
@@ -263,3 +263,45 @@
 - Then 返回项目层并恢复可用焦点；全局无活动时整行隐藏摘要并关闭菜单，新活动到来时只恢复摘要
 - When 点击外部、焦点离开、按 Tab 或隐藏侧栏
 - Then 菜单关闭，后台新活动不自动重新展开
+
+## 7. 后续需求场景
+
+本节对应新增计划，不计入应用中心首期完成条件。
+
+### US-F1 连接组织应用市场
+
+对应 [FR-15](./prd.md#fr-15-私有化市场与-yaml-交换后续)。
+
+- Given 组织已部署提供应用市场的 ShareServer
+- When 用户配置市场 URL，并在来源要求时完成登录
+- Then 可以浏览该来源的应用目录、详情及可获取版本
+- Given 市场暂时不可达
+- Then 显示失败原因与重试入口，已安装和内置应用仍可打开，不切换公共市场
+
+### US-F2 导入导出应用定义
+
+对应 FR-15。
+
+- Given 用户需要在私有部署间迁移应用
+- When 导出应用为 `.yml` 并在另一台设备导入
+- Then 预览应用身份、版本、可迁移配置和依赖，凭据与业务数据不包含在导出文件中
+- Given 同标识应用已存在
+- Then 用户可选择更新或取消，取消后原应用与配置保持不变
+- Given 文件格式无效、版本不支持或离线环境缺失程序包或模型资源
+- Then 显示具体问题与补充要求，不将应用误报为可运行，也不自动启动模型或任务
+
+### US-F3 管理本机模型服务
+
+对应 [FR-16](./prd.md#fr-16-本机模型管理入口新增计划项)。
+
+- Given 用户使用依赖本机模型的应用
+- When 从应用中心或常驻菜单打开“本机模型”
+- Then 可查看已接入模型的状态、管理方式及使用方，两处入口访问同一页面
+- Given 多个应用共用一个 GoodBuddy 受管模型服务
+- Then 展示同一服务及使用方，启动操作不重复创建进程
+- When 用户停止或重启仍有任务使用的受管服务
+- Then 先展示任务影响供用户决定，取消后服务保持运行；操作失败显示原因与实际状态
+- Given 模型服务由外部程序启动，且未接入其管理接口
+- Then 展示“外部管理”与连接配置，不提供停止或重启
+- When 用户关闭管理页或取消常驻
+- Then 模型运行状态不变