Files
ycode/docs/四模块拆解总览-2026-10-17.md

83 lines
7.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 四模块拆解总览(2026-10-17)
> 当前推进范围:用户要求先梳理定时任务、资料库、项目并准备开发,具体契约、文件分工和验收门槛见[三模块开发计划](三模块开发计划-2026-10-17.md)。安全中心仍待后续取证,不混入这轮开发。
用户已明确订正:此前“安装中心”应为“设置 → 安全中心”。当前四模块为**安全中心、定时任务、资料库、更多→项目**;应用安装管理不在本次四模块范围。此前“仅记录、不拆解”限制已由用户授权取代;本轮只交付分析与后续任务,未修改业务代码。云端服务、产品侧子代理调度仍按此前要求暂缓。
## 当前结论
| 模块 | 原版证据现状 | YCode 现状 | 下一步要解决的核心问题 |
| --- | --- | --- | --- |
| [设置→安全中心](安全中心模块拆解-2026-10-17.md) | 范围已订正;实际页面内容与策略尚待REA取证,安装/发现应用证据不适用于本项 | `securityCenter`导航可见但未接入,无页面分支 | 先采原版实际分区/控件与行为,再逐项映射真实能力、接页面与执行策略并验收 |
| [定时任务](定时任务模块拆解-2026-10-17.md) | 页面、新建表单、频率与校验有REA证据;执行记录/生命周期/时间语义不齐 | 侧栏入口占位,缺少调度存储与执行服务 | 不只是复刻表单,还要定义时间规则、任务执行、运行记录、重启恢复及并发行为 |
| [资料库](资料库模块拆解-2026-10-17.md) | 本轮已补首页、类型菜单、个人新增菜单、骨架和本地产物页;完整编辑/导入/引用仍需补采 | 入口占位;可复用真实文件读取、产物预览和消息关联 | 个人资料、团队资料、本地产物分开;建立真实索引、最近/收藏/搜索及引用快照 |
| [更多→项目](项目模块拆解-2026-10-17.md) | 列表、新建、详情、任务页、指令和模板已有REA证据;协作与其余页签证据有限 | 本地项目、持久化、任务归属和指令注入已有通路;动态/计划/资产多为占位 | 补生命周期、配置选择、筛选和任务行;分清本地业务与云协作缺口 |
“有页面/源码证据”“YCode 已有功能”“功能测试通过”“全状态1:1通过”是不同状态。四个模块都没有完整1:1验收结论。
## 每个模块的实施拆分
### A. 设置→安全中心
1. 通过REA进入原版设置的`securityCenter`,取得实际页面分区、字段、默认值、说明与布局。
2. 逐控件核对修改、保存/取消、生效时机、持久化、确认、错误和不可用状态,不预设具体功能。
3. 用REA追踪对应脚本、CSS与宿主契约,区分页面偏好、实际执行策略和远端依赖。
4. 主上下文确定数据与执行边界,基于原版事实映射YCode真实能力;涉及策略时验证其在执行入口实际生效。
5. 验证重启、多窗口同步和错误恢复,再做深浅色、窄屏、键鼠及动效对照。
6. 旧安装中心分析退出本次任务;发现应用与能力中心独立保留,不计入安全中心进度。
### B. 定时任务
1. 列表/空态/模板入口、新建/编辑弹窗及字段校验。
2. 一次、间隔小时、每天、每周、双周、每月、每年及有效期规则。
3. 自动化配置存储、启停、编辑、删除、手动运行的真实状态机。
4. 本地调度服务:下一次触发、系统休眠/恢复、重启、错过触发和重复执行策略。
5. 复用现有模型/OMP/会话链路执行,生成真实运行记录,不以按钮Toast替代执行。
6. 记录详情、失败重试、运行中互斥、会话跳转、归档/删除。
7. 项目级定时任务与通知推送单独接线;远端推送按当前范围暂缓。
第4项为YCode必须做的工程设计,原版服务端的同名行为尚未证实。不能用设计建议冒充原版已采集规则。
### C. 资料库
1. library路由、资料库内侧栏、最近三页签、骨架/空/错误与主题。
2. 个人文档、CSV、文件夹、上传导入、链接的真实存储和操作。
3. 本地产物索引:工作空间→任务→文件;类型筛选、排序、收藏、搜索和失效文件。
4. 文档/表格/网页编辑与预览;先补编辑器证据,复用已有右侧预览宿主。
5. 最近访问、资料搜索、选择资料添加到对话;保存引用来源和内容版本。
6. 个人资料与项目资产关系通过显式关联表达;团队协作/分享/远端配额分开记录。
7. 逐状态几何、字体、图标、滚动、键鼠、响应式与动效比对。
### D. 更多→项目
1. 保留现有项目存储和任务绑定;补契约边界、列表空/加载/失败和创建全状态。
2. 项目卡片菜单与项目重命名、归档/删除等生命周期;副作用先取证后实现。
3. 指令、连接器、专家、技能的完整配置选择和保存,不停留于ID展示。
4. 任务状态/来源筛选、任务行菜单、首发占位、取消/失败和打开任务。
5. 动态、计划、资产分别建模并接真实数据;不能只保留页签和“尚未配置”。
6. 成员、角色、通知、cloud路由与协作作为云端依赖拆出,保持未接状态真实可见。
7. 统一对照四个页签、右配置栏、弹窗、浅深色和窄窗口。
## 共享契约与依赖
以下为YCode目标设计,不能作为原版后端结构结论:
- 工作空间代表本地工作目录;项目代表任务组织与配置;资料库集合代表资料组织。三者有显式关联,ID和生命周期独立。
- 定时任务描述触发与执行配置,一次运行产生独立运行记录,并关联实际会话。
- 专家/技能/连接器沿用已有能力类型与可用状态;项目与定时任务保存能力引用,发送时解析真实可用能力。此依赖不再扩展成应用安装管理任务。
- 对话产物和导入资料都可进入索引,但保留来源;发送到模型的引用冻结内容/版本,历史重载不能悄悄改请求内容。
- 页面状态、持久化、执行状态统一由主进程提供权威值;多窗口订阅更新,避免把定时任务UI计时器当调度器。
## 建议推进顺序与并行边界
1. **补证据并定契约**:主上下文统一数据关系、迁移、来源与状态定义;缺失原版实现只用REA。现有5.8.2有效证据继续使用,新补采明确5.8.3。
2. **三个并行工作面**:定时任务本地执行闭环;资料库本地产物/个人资料闭环;安全中心原版取证与能力映射。安全中心待证据明确后再分派实现;shared/main IPC由主上下文协调集成。
3. **项目收口与联动**:在已有项目实现上补缺,绑定前述能力、资料和自动化;先完成本地真实链路。
4. **逐状态对标**:同视口、同主题、同字体、同数据;截图/计算几何/状态序列与功能回归分别留证。云依赖未接不能计入完整1:1。
本轮不提供虚假的完成百分比或固定工期;各专项文档按证据、实现、占位、未知和验收门槛列出可分派工作。
## 本轮交付与验证边界
当前交付为三份已有模块拆解、安全中心范围订正与待拆解记录、总览和TODO/交接更新。此前安装中心文档保留为误解范围的历史,不计入当前四模块完成度。没有改业务代码、权限策略或用户配置;没有重新跑上一轮已通过的应用回归。