@chantezy/mcp-jingwei 1.0.3 → 1.0.6

package/dist/index.js

@@ -5,7 +5,7 @@ import { z } from "zod";
 import { listSkills, getSkill, getReference } from "./skill-loader.js";
 const server = new McpServer({
     name: "mcp-jingwei",
-    version: "1.0.0",
+    version: "1.0.4",
 });
 if (process.env.DEBUG) {
     process.stderr.write(`[mcp-jingwei] 已加载 ${listSkills().length} 个技能\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chantezy/mcp-jingwei",
-  "version": "1.0.3",
+  "version": "1.0.6",
   "description": "精卫平台产品工作流技能集合 MCP Server（需求讨论 / 版本文案 / 竞品分析 / 文档转帮助中心）",
   "type": "module",
   "main": "./dist/index.js",

package/skills/product-discussion/README.md

@@ -2,6 +2,8 @@
 
 > 精卫平台（4399 内部工具）需求设计方案讨论 Skill
 > 适用于文档系统与项目管理系统的产品需求分析、方案发散、竞品参考。
+>
+> **平台基线：v2.7.3（2026-09-28）** ｜ 上一版基线：v2.6.6（2026-05-21）
 
 ---
 
@@ -19,18 +21,36 @@
 ## 文件结构
 
 ```
-product-design-discussion/
+product-discussion/
 ├── README.md                          # 本文件
 ├── SKILL.md                           # Skill 主文件（框架、规则、触发逻辑）
 ├── references/                        # 参考资料
 │   ├── platform-spec.md               # 精卫平台产品规格（现有能力、边界约束）
 │   ├── competitors-docs.md            # 文档系统竞品参考（飞书/语雀/石墨/有道/Notion/WPS笔记）
 │   └── competitors-pm.md              # 项目管理竞品参考（Trello/PingCode/Teambition/Monday/TAPD/日事清）
-└── assets/                            # 静态资源（平台功能截图）
-    ├── doc_dashboard_full.png
-    ├── doc_list_page.png
-    ├── task_management_Kanban.png
-    └── ...
+└── assets/                            # 静态资源（平台功能截图，2026-09-28 采集）
+    ├── doc_dashboard_full.png         # 文档首页（最近浏览/最近编辑）
+    ├── doc_library_grid.png           # 文档库网格视图
+    ├── doc_search.png / doc_search_2.png   # 搜索（含筛选）
+    ├── doc_collect.png                # 收藏
+    ├── doc_user_menu.png              # 用户菜单
+    ├── doc_ai_assistant.png           # AI 侧边助手
+    ├── doc_board_editor.png           # 画板编辑器
+    ├── doc_board_embedded.png         # 画板嵌入文档
+    ├── doc_board_toolbar.png          # 画板工具栏
+    ├── doc_board_export.png           # 画板导出
+    ├── doc_list_page.png              # 文档列表（历史留存）
+    ├── project_dashboard.png          # 项目管理首页
+    ├── task_management_Kanban.png     # 任务视图 - 看板
+    ├── task_management_Form.png       # 任务视图 - 表格
+    ├── task_management_Gantt.png      # 任务视图 - 甘特图
+    ├── task_level_switch.png          # 任务层级切换
+    ├── task_detail.png                # 任务详情弹窗
+    ├── custom_view_panel.png          # 新建自定义视图
+    ├── archive_management.png         # 已归档管理
+    ├── notification_center.png        # 消息通知中心
+    ├── my_tasks.png                   # 我的任务
+    └── my_team.png                    # 我的团队
 ```
 
 ---
@@ -66,7 +86,9 @@ Skill 的核心文件，包含：
 精卫平台自身的产品规格说明，是方案讨论最重要的参考依据：
 - 精卫文档的功能模块、页面结构、权限体系
 - 精卫项目管理的功能模块、迭代生命周期、权限体系
-- 两个系统的集成关系
+- **AI 能力层**（AI 侧边助手 / AI 写作辅助 / AI 概览 / 帮助中心知识库问答 / 云文档 MCP）
+- 两个系统的集成关系、信息架构与 URL 规则
+- 版本迭代记录（v2.6.6 → v2.7.3）与页面截图索引
 - **当前已有能力** vs **暂未明确有的能力**（方案讨论的边界参考）
 
 ### competitors-docs.md
@@ -102,8 +124,12 @@ Skill 的核心文件，包含：
 AI 会在当次对话中以你的描述为准，无需重新打包 Skill。
 
 ### 季度/大版本更新
-1. 修改 `references/platform-spec.md` 对应章节
-2. 重新打包文件
-3. 在替换旧版本
+1. 通过 note MCP 读取「帮助中心 → 功能更新日志」拿到本期版本更新明细
+2. 用智能体浏览器实际操作新界面，补充/替换 `assets/` 截图并核对 DOM 结构
+3. 修改 `references/platform-spec.md` 对应章节（含版本迭代记录、截图索引）
+4. 同步 `SKILL.md` 的能力描述与版本基线
+5. 运行 `mcp-server/scripts/sync-skills.sh` 同步到 MCP 包
 
-竞品信息变化较慢，通常无需频繁更新；平台自身功能迭代较快，建议每季度更新一次 `platform-spec.md`。
+竞品信息变化较慢，通常无需频繁更新；平台自身功能迭代较快，建议每季度更新一次 `platform-spec.md`。
+
+> 参考：本次更新（v2.6.6 → v2.7.3）覆盖 9 个版本（v2.6.7–v2.7.3），新增 AI 能力层与云文档 MCP 两大主线。

package/skills/product-discussion/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jingwei-product-discussion
-description: 精卫需求设计方案讨论 Skill，专门针对文档系统（含文字文档、电子表格、PDF、幻灯片、多人协作、权限管理）和项目管理系统（Kanban 看板）两大产品方向。当用户遇到产品需求问题、功能方案讨论、竞品参考、用户场景分析、交互设计发散等任务时，必须触发本 Skill。即使用户只是描述了一个使用痛点或说"我有个想法想讨论"，只要涉及这两类平台产品，都应立即触发本 Skill，输出贴合平台特性的方案分析与建议，而不是给出通用的产品建议。
+description: 精卫需求设计方案讨论 Skill，专门针对文档系统（含文字文档、电子表格、幻灯片、PDF、Markdown、甘特图、画板——思维导图/流程图，以及 AI 助手与 AI 辅助写作、云文档 MCP 开放接口、多人协作、权限管理）和项目管理系统（看板 / 表格 / 甘特图三视图，自定义视图、子任务、任务层级切换、归档管理）两大产品方向。当用户遇到产品需求问题、功能方案讨论、竞品参考、用户场景分析、交互设计发散等任务时，必须触发本 Skill。即使用户只是描述了一个使用痛点或说"我有个想法想讨论"，只要涉及这两类平台产品，都应立即触发本 Skill，输出贴合平台特性的方案分析与建议，而不是给出通用的产品建议。
 ---
 
 # 企业内部工具平台 · 需求设计方案讨论
@@ -9,7 +9,7 @@ description: 精卫需求设计方案讨论 Skill，专门针对文档系统（
 
 本 Skill 服务于**精卫平台**（4399 内部工具）的两大核心系统需求讨论。
 
-> **产品规格详见** `references/platform-spec.md`，每次讨论优先读取该文件以了解平台现有能力和约束边界。
+> **产品规格详见** `references/platform-spec.md`（当前基线：**v2.7.3 / 2026-09-28**），每次讨论优先读取该文件以了解平台现有能力和约束边界。
 >
 > **处理产品更新的规则**：
 > - 如果用户在对话中说"我们新增了 X 功能"或"X 功能已经有了"，立即以用户的描述为准，覆盖 platform-spec 中的旧内容，在当次对话中全程使用最新信息。
@@ -21,12 +21,14 @@ description: 精卫需求设计方案讨论 Skill，专门针对文档系统（
 **核心定位**：企业内部 PRD 产品文档管理平台，介于 Confluence 和 Notion 之间，专注 PRD 撰写、协作和版本管理。
 
 **现有核心能力**（详见 platform-spec.md）：
-- 富文本编辑器  + 附件 + 自动保存
-- 版本历史、版本对比、回滚
-- 评论 + @提及 + 邮件通知+ 企微通知
-- 文档级权限，两级角色（管理员/普通成员）
-- 标题/更新人搜索，全文检索
-- 结构：项目-文件夹-文档（富文本、表格等）
+- 八类内容：文字文档 / 表格 / Markdown / 幻灯片 / PDF / 甘特图 / Word / **画板**（思维导图、流程图，可独立成文或嵌入文档）
+- 富文本编辑器 + 附件 + 视频 + 自动保存；文档批注、演示模式、版本历史与「恢复此记录」
+- 评论 + 历史评论 + @提及通知；企微 / 邮件 / 浏览器桌面推送三通道
+- **全局搜索已改版**：搜索前「最近浏览 / 最近编辑」预推荐 + 标题与正文匹配 + 6 类可组合筛选（类型 / 项目含「个人」/ 创建者 / 创建年份 / 最近创建时间 / 版本）+ 排序
+- 结构：文档库（项目）→ 文件夹 → 文档；项目文档库支持展开收起；文件夹分享、同步知识库
+- 权限：文档库/文档级权限，**v2.7.2 起支持非公司 OA 账号「外部登录」访问分享链接**
+- **AI 能力层**：AI 侧边栏助手（多轮对话 + 关联知识库）、AI 辅助写作（扩充/润色/纠错/改写/精简）、AI 速览、帮助中心知识库问答
+- **开放接口**：云文档 MCP（可被 IDE / Agent 搜索并读取有权限的文档，v2.7.1 起支持直接投喂分享链接）
 
 **主要竞品参考**（方案讨论时可借鉴）：
 - 飞书云文档、腾讯文档、语雀（国内对标）
@@ -42,9 +44,16 @@ description: 精卫需求设计方案讨论 Skill，专门针对文档系统（
 **核心定位**：产品项目全生命周期管理平台，以 Kanban 看板为核心，覆盖需求→迭代→发布全流程，与精卫文档深度集成。
 
 **现有核心能力**（详见 platform-spec.md）：
-- 多视图：看板 / 列表 / 甘特 / 日历 / 时间线
-- 需求池（Backlog）+ 需求评审流程 + 需求流转自动化
-- 迭代规划 + 迭代看板 + 任务管理（含子任务/依赖）
+- 三视图：**看板 / 表格 / 甘特图**（注意：日历、时间线视图目前**没有**，不要在方案里当成已有能力）
+- **自定义视图**：把常用筛选 + 分组保存为看板/表格/甘特图视图，可私有或共享给团队（v2.6.8）
+- **任务层级**：仅父任务 / 所有任务（看板）、子任务折叠展示 / 子任务独立展示（表格、甘特图），v2.7.3 起子任务可独立成行并显示归属父任务
+- **子任务**：独立执行人、独立截止时间、拖动排序、字段设置排序；父任务同步子任务变更记录
+- 任务字段：标题、任务ID（T+编号，默认不显示，需在字段设置开启）、状态、执行者、开始/截止时间、工期、任务列表、备注、优先级、标签、参与者、迭代、需求方、权重、需求文档、需求背景、期待方案、计划上线月份、交互地址、设计稿地址
+- 任务详情：子任务、备注附件上传、视频/文件附件、评论与动态（所有动态 / 仅评论）
+- **归档**：单个任务 / 整列 / 整组归档 + 独立「已归档管理」页（搜索、筛选、批量恢复、删除；快照独立存储）
+- 通知：站内 / 浏览器推送 / 企微 / 邮件；子任务通知（新增、进度、执行者、过期提醒）受父任务通知设置控制
+- 团队：我的团队、成员管理、标签跨项目筛选
+- 项目仪表盘：我的任务、团队统计（进行中 / 已逾期 / 总数）、帮助中心、我的项目
 
 **主要竞品参考**（方案讨论时可借鉴）：
 - Teambition、Trello（Kanban 交互）
@@ -55,6 +64,21 @@ description: 精卫需求设计方案讨论 Skill，专门针对文档系统（
 
 ---
 
+### 横切层：AI 能力（v2.6.7 起，横跨文档与项目）
+
+**形态**：全局单例浮层（页面右下角 AI 按钮 → `.jw-assistant` 面板），**首次进入页面会自动展开**。
+
+| 能力 | 入口 | 说明 |
+|------|------|------|
+| AI 侧边栏助手 | 右下角 AI 按钮 | 多轮对话 + 上下文记忆；可查看当前文档相关信息；可关联企业知识库（支持多选知识库项目） |
+| AI 辅助写作 | 富文本选中文字 → 工具栏，或输入 `/` | 扩充 / 润色 / 语法纠错 / 改写降重 / 精简；结果可替换或插入 |
+| AI 速览 | 文档工具栏 | 文档摘要 |
+| 帮助中心知识库问答 | 帮助中心右下角 AI 按钮 | 基于帮助中心内容答疑 |
+
+> 讨论涉及 AI 时注意：现有 AI 是**问答与改写**形态，不是「自动执行业务操作」形态。若方案要求 AI 直接改文档/改任务，属于能力边界外，需要单独讨论实现路径。
+
+---
+
 ## 方案讨论框架
 
 收到需求/问题时，按以下步骤思考并输出：
@@ -107,11 +131,13 @@ description: 精卫需求设计方案讨论 Skill，专门针对文档系统（
 **权限设计约束**
 - 权限粒度：项目级 / 页面级（添加协作人）
 - 角色继承：子页面默认继承父页面权限，可单独覆盖
-- 外链分享：只读链接、密码保护
+- 外链分享：只读链接、密码保护；**v2.7.2 起支持非公司 OA 账号通过「外部登录」访问**，方案涉及对外协作时要考虑这条
+- 已知权限耦合：**画板权限与所属文档权限完全一致**（分享画板 = 同时分享文档），设计画板相关方案时需明确这一点
 
 **内容类型联动**
-- 文字文档中可嵌入表格/图表/幻灯片视图
+- 文字文档中可嵌入表格 / 图表 / 幻灯片视图 / **画板**
 - 电子表格数据可作为文档内容的数据源
+- 画板可导出 JSON / SVG / PNG / JPG，并拥有独立分享链接（v2.7.3）
 
 ---
 
@@ -131,8 +157,11 @@ description: 精卫需求设计方案讨论 Skill，专门针对文档系统（
 
 **视图扩展约束**（若讨论多视图需求）
 - 看板视图（默认）
-- 列表视图（适合大量任务筛选）
+- 表格视图（适合大量任务筛选，含任务ID与归属列）
 - 甘特视图（适合有时间依赖的项目）
+- **自定义视图**（v2.6.8 已有）：保存筛选+分组的组合，可私有/共享
+- **任务层级**（v2.7.3 已有）：子任务折叠展示 / 独立展示；看板侧对应「仅父任务 / 所有任务」
+- 注意：日历视图、时间线视图**尚未实现**，不要假设已有
 
 ---
 

package/skills/product-discussion/references/platform-spec.md

@@ -1,8 +1,9 @@
 # 精卫平台（4399云文档 & 4399项目管理）深度功能分析报告
 
-> 分析时间：2026-06-04  
-> 平台版本：v2.6.6  
-> 分析方式：通过Agent控制浏览器实际操作、DOM解析、页面截图
+> 分析时间：2026-09-28
+> 平台版本：**v2.7.3**
+> 上一版基线：v2.6.6（2026-05-21）
+> 信息来源：4399云文档「帮助中心 → 功能更新日志 / 云文档 / 项目管理」文档（note MCP 读取）+ Agent 控制浏览器实际操作、DOM 解析、页面截图
 
 ---
 
@@ -11,12 +12,18 @@
 | 项目 | 内容 |
 | :--- | :--- |
 | **产品名称** | 精卫（Jingwei） |
-| **产品类型** | 企业级文档管理 + 项目协作一体化平台 |
-| **所属行业** | 互联网/游戏行业内部工具（4399集团） |
-| **核心用户** | 产品经理、交互设计师、开发团队、运营团队、客服团队 |
-| **核心价值主张** | 将文档管理与项目管理深度融合，提供统一的知识沉淀和任务协作工作空间 |
-| **解决的问题** | 团队信息分散、知识管理困难、项目进度不透明、跨团队协作效率低 |
-| **差异化优势** | 文档与项目数据互通；支持多种文档类型（富文本、Markdown、甘特图）；企微消息通知集成 |
+| **产品类型** | 企业级文档管理 + 项目协作一体化平台，并已扩展出 AI 能力层 |
+| **所属行业** | 互联网/游戏行业内部工具（4399 集团） |
+| **核心用户** | 产品经理、交互设计师、开发团队、测试、运营团队、客服团队 |
+| **核心价值主张** | 文档与项目数据互通，叠加 AI（写作/问答/知识库/AI 编程接口）形成统一的知识沉淀与任务协作空间 |
+| **解决的问题** | 团队信息分散、知识检索困难、项目进度不透明、跨岗位沟通成本高 |
+| **差异化优势** | ① 文档与项目数据互通；② 内容类型完整（文字/表格/幻灯片/PDF/Markdown/甘特图/Word/**画板**）；③ **v2.6.7 起密集补齐 AI 能力**；④ **v2.7.0 起开放文档 MCP**，可被 IDE/Agent 直接调用；⑤ 企微消息通知与企业账号体系打通 |
+
+### 1.1 相比 v2.6.6 的三个质变
+
+1. **AI 从「单点」变成「能力层」**：v2.6.7 一次性上线 AI 侧边栏助手 + AI 辅助写作，随后补上帮助中心知识库问答（v2.7.0）、知识库项目多选（v2.7.0）。AI 已是横跨文档与项目两个系统的公共能力。
+2. **从「页面产品」变成「可被调用的平台」**：v2.7.0 开放**云文档 MCP**，v2.7.1 支持直接投喂分享链接；外部 AI 工具（IDE / Agent）可搜索、读取有权限的云文档。**本报告本身即是该能力的产物。**
+3. **内容形态与协作粒度双扩**：新增**画板**（思维导图/流程图，可独立成文或嵌入文档，v2.7.2 一期、v2.7.3 二期）；文档侧补上「外部账号访问」；项目侧把任务层级从「父子折叠」扩到「子任务独立展示」，并把归档升级为独立的「已归档管理」。
 
 ---
 
@@ -25,27 +32,35 @@
 ### 2.1 系统顶层架构
 
 ```
-精卫平台 (https://note.4399doc.com/prd)
+精卫平台 (https://doc.example.com/prd)
 ├── 4399云文档（文档中心）
-│   ├── 文档仪表盘
-│   ├── 文档编辑器
-│   └── 文档库管理
+│   ├── 文档仪表盘（最近查看 / 我的收藏）
+│   ├── 全局搜索面板（最近浏览 / 最近编辑 / 高级筛选）
+│   ├── 文档编辑器（文字/表格/Markdown/幻灯片/PDF/甘特图/Word/画板）
+│   └── 文档库管理（文件夹、权限、分享、同步知识库）
 │
 ├── 4399项目管理（项目中心）
 │   ├── 项目仪表盘
 │   ├── 我的任务
-│   ├── 项目详情（看板/表格/甘特图）
-│   └── 团队管理
+│   ├── 我的团队
+│   ├── 项目详情（看板 / 表格 / 甘特图 + 自定义视图）
+│   ├── 任务详情（子任务、自定义字段、附件、动态）
+│   └── 已归档管理
+│
+├── AI 能力层（横跨两端）
+│   ├── AI 侧边栏助手（多轮对话 + 关联知识库）
+│   ├── AI 辅助写作（选中文字 → 扩充/润色/纠错/改写/精简）
+│   ├── AI 速览（文档摘要）
+│   └── 帮助中心知识库问答
 │
 └── 全局功能
     ├── 帮助中心
-    ├── 消息通知
-    ├── 版本更新
-    └── 用户中心
+    ├── 消息通知（站内 / 浏览器推送 / 企微）
+    ├── 版本更新日志
+    ├── 云文档 MCP（开放接口）
+    └── 用户中心 / 用户管理 / 外部账号访问
 ```
 
----
-
 ### 2.2 文档中心（4399云文档）功能树
 
 ```
@@ -53,437 +68,433 @@
 ├── 顶部导航栏
 │   ├── Logo + 产品标题 "4399云文档"
 │   ├── 全局搜索入口 "搜索文档"
-│   ├── 版本更新提示（带"new"徽章）
-│   ├── 消息通知（铃铛图标，显示"99+"）
+│   ├── 版本更新提示（带 "new" 徽章，当前显示 v2.7.2）
+│   ├── 顺手工具入口（面板折叠 / 主题等图标）
+│   ├── 消息通知（铃铛图标，未读计数）
 │   ├── 帮助中心入口（问号图标）
-│   └── 用户信息（头像 + 昵称）
-│
-├── 左侧边栏 - 文档库面板
-│   ├── 文档库标题 + 数量
-│   ├── 新建文档库按钮（+）
-│   ├── 展开/收起按钮
-│   ├── 项目选择
-│   └── 文档库列表
+│   └── 用户信息（头像 + 昵称，下拉：个人信息 / 用户管理 / 帮助中心 / 文档MCP / 4399项目管理 / 退出）
 │
-├── 主内容区 - 文档仪表盘
-│   ├── 标签页切换
+├── 文档仪表盘（#/docDashboard）
+│   ├── 文档库区块
+│   │   ├── "文档库 N" + 新建文档库按钮（+）
+│   │   ├── 文档库卡片网格（缩略图 + 名称，支持自定义封面）
+│   │   └── 展开更多 / 收起更多
+│   │
+│   ├── 标签页
 │   │   ├── 最近查看（默认）
-│   │   └── 我的收藏
+│   │   └── 我的收藏（弹窗式，含 标题/更新人/收藏时间 筛选）
 │   │
 │   ├── 最近查看
-│   │   ├── 筛选区
-│   │   │   ├── 按标题搜索（输入框）
-│   │   │   ├── 按更新人搜索（输入框）
-│   │   │   ├── 重置按钮
-│   │   │   └── 搜索按钮
-│   │   ├── 操作区
-│   │   │   └── 移除查看记录（危险按钮，disabled状态）
-│   │   ├── 文档列表表格
-│   │   │   ├── 复选框列（批量选择）
-│   │   │   ├── 标题列（含文档图标 + 文档名称）
-│   │   │   ├── 更新人列
-│   │   │   ├── 查看时间列（支持排序）
-│   │   │   └── 收藏列（星标图标）
-│   │   └── 分页器
-│   │       ├── 总数显示
-│   │       ├── 每页条数选择（10条/页）
-│   │       ├── 页码导航
-│   │       └── 跳转至指定页
+│   │   ├── 筛选区：标题 / 更新人 / **查看时间（日期区间，v2.7.x 新增）** / 重置 / 搜索
+│   │   ├── 操作区：移除查看记录（危险按钮，未选中时 disabled）
+│   │   ├── 文档列表表格：标题（含类型图标）、更新人、查看时间
+│   │   └── 分页器（总数 / 每页条数 / 页码 / 跳转）
 │   │
-│   └── 我的收藏
-│       ├── 筛选区（标题 + 更新人）
-│       ├── 文档列表表格
-│       │   ├── 标题列
-│       │   ├── 更新人列
-│       │   ├── 收藏时间列（区别于查看时间）
-│       │   └── 取消收藏操作
-│       └── 分页器（共4条）
+│   └── AI 悬浮入口（右下角，打开 AI 侧边栏助手）
 │
-└── 全局搜索面板（点击"搜索文档"展开）
-    ├── 搜索关键词输入框
-    ├── 需求创建者筛选
-    ├── 项目选择器（下拉框）
-    ├── 版本选择器（下拉框）
-    ├── 创建年份选择器（下拉框）
-    ├── 排序方式选择（更新时间降序等）
-    ├── 重置按钮
-    ├── 搜索按钮
-    └── 搜索结果列表（20条/页）
+├── 全局搜索面板（点击"搜索文档"，v2.7.3 改版）
+│   ├── 搜索关键词输入框（同时匹配标题与正文）
+│   ├── **搜索前内容推荐**
+│   │   ├── 最近浏览：查看过的分享文档
+│   │   └── 最近编辑：已加入项目的文档、他人分享给编辑权限的文档
+│   ├── 搜索结果（关键词高亮，显示所属文档库位置）
+│   ├── 高级筛选（可组合）
+│   │   ├── 云文档类型（多选：文档 / Markdown / 表格 / 幻灯片 / PDF …）
+│   │   ├── 项目（含新增的「个人」类型）
+│   │   ├── 创建者
+│   │   ├── 创建年份
+│   │   ├── 最近创建时间（近 1 天 / 3 天 / 7 天 / 30 天）
+│   │   ├── 版本
+│   │   └── 排序方式（更新降序等）
+│   └── 筛选器收起/展开
+│
+└── 文档编辑器（#/doc/:id）
+    ├── 左侧导航面板
+    │   ├── 文件夹树形结构（项目文档库支持 **展开/收起列表**，hover 显示收起按钮，v2.7.2）
+    │   └── 文档项（noteItem / navigatorList）
+    │
+    ├── 顶部工具栏
+    │   ├── 返回按钮 / 文档标题（可编辑）
+    │   └── 操作项：分享、（评论/历史）、全屏、更多（⋯）
+    │       └── 更多菜单：历史评论 / **历史记录（版本快照 + 恢复此记录）** / 保存为版本 / 查看已存版本 / 同步至知识库
+    │
+    ├── 编辑区域
+    │   ├── 富文本编辑（ProseMirror/TipTap 系）
+    │   ├── 目录导航（自动生成）
+    │   ├── 浮动工具栏（选中文字出现，含 AI 辅助写作入口）
+    │   └── 右侧：目录 / 评论
+    │
+    └── 内容类型与能力
+        ├── 创建文字文档 / 表格 / Markdown / 幻灯片 / PDF / 甘特图 / Word / **画板**
+        ├── 插入：链接 / 表格 / 图片（可拖拽调整）/ 视频 / **画板** / 引用云文档 / 附件
+        ├── 上传本地文件转在线文档、导入文档
+        ├── 文档批注、文档演示模式（v2.7.2 优化阅读与展示体验）
+        ├── AI 速览、AI 辅助写作
+        ├── 收藏、最近查看、历史操作记录（版本管理）
+        ├── 自定义排序、文件夹创建方式优化（v2.7.2：目录顶部「新建文件夹」或文档列表「+」）
+        ├── 文件夹分享、同步知识库
+        └── 外部账号访问（v2.7.2：分享链接支持非公司 OA 账号通过「外部登录」访问）
 ```
 
----
-
-### 2.3 文档编辑器功能树
+### 2.3 画板（v2.7.2 一期 / v2.7.3 二期）
 
 ```
-文档编辑器（基于 ProseMirror/TipTap）
-├── 左侧导航面板
-│   ├── 文件夹树形结构
-│   │   ├── 文件夹（可展开/收起）
-│   │   └── 文档项（noteItem）
-│   └── 导航列表（navigatorList）
+画板
+├── 创建方式
+│   ├── 作为独立文档类型创建（默认标题「未命名画板」）
+│   └── 富文本文档中「插入 → 画板」
 │
-├── 顶部工具栏
-│   ├── 返回按钮
-│   ├── 文档标题（可编辑）
-│   └── 文档状态指示
+├── 编辑能力
+│   ├── 图形：思维导图、流程图、自由画笔、连线、形状、文本、表格、图片
+│   ├── 左侧工具栏：图形 / 矩形 / 文本 / 便签 / 连线 / 表格 / 画笔 / 图片 / 素材 / 分区
+│   ├── 图形操作：拖拽、旋转、拉伸（Shift 等比）、填充色与透明度、边框、双击进入文本编辑
+│   ├── 连线：类型切换、虚实粗细、折线/曲线拉伸、连线说明（双击或 Enter 添加）
+│   ├── 图片：上传（png/jpg/jpeg/gif/webp/bmp/svg）、裁剪、换图、边框
+│   ├── 素材：通用设计素材、原型素材、项目管理图标、云计算图标、表情、贴纸；可固定到左侧面板
+│   ├── 分区（v2.7.3 新增）：16:9 / 4:3 / 1:1 / A4 预设 + 自定义尺寸
+│   ├── 便签（v2.7.3 新增）：高亮色彩、显示备注成员头像及名称
+│   ├── Mermaid / Markdown 转流程图（v2.7.3 新增，支持实时预览，可反向改代码重生成）
+│   └── 多人协作：不同成员光标异色（同一节点不支持并发编辑）
 │
-├── 编辑区域（ProseMirror编辑器）
-│   ├── 富文本编辑
-│   ├── 目录导航（自动生成）
-│   └── 内容渲染区
+├── 文档内嵌表现
+│   ├── 以缩略预览形式展示，自动保存
+│   └── hover 工具栏：缩放（百分比）/ 编辑 / 复制 / 导出图片 / 调整边框宽高 / 删除
 │
-├── 浮动工具栏（选中文字时出现）
-│   └── 文字格式化操作
+├── 导出：JSON / SVG / PNG / JPG
 │
-└── 文档功能
-    ├── 创建文档（富文本）
-    ├── 创建 Markdown
-    ├── 创建甘特图
-    ├── 创建/编辑/删除文件夹
-    ├── 文档中插入链接
-    ├── 文档中插入表格
-    ├── 文档中插入图片（支持拖拽调整大小）
-    ├── 文档中插入视频
-    ├── 上传文件转在线文档
-    ├── 导入文档
-    ├── 引用云文档内容
-    ├── 附件上传
-    ├── 文档批注
-    ├── 文档演示模式
-    ├── AI速览
-    ├── 文档收藏
-    ├── 最近查看记录
-    ├── 历史操作记录（版本管理）
-    ├── 自定义排序
-    ├── 文件夹分享
-    └── 同步知识库
+├── 分享（v2.7.3 新增独立分享链接）
+│   ├── 文档分享页-编辑模式：画板可切换编辑/阅读
+│   ├── 文档分享页-浏览模式：画板只能阅读
+│   └── 画板分享页：需编辑时需退出至文档分享页获取权限
+│   ⚠️ 画板权限与所属文档权限完全一致，授予画板权限等于同时授予文档权限
+│
+└── 快捷键
+    ├── 插入图形：R 圆角矩形 / S 矩形 / O 圆形 / D 菱形 / T 文本 / L 直线
+    ├── 画布导航：Ctrl(⌘)+滚轮 缩放 / Ctrl+0 缩放至 100% / Shift+2 缩放到选中 / Shift+1 全览
+    ├── 选择：Ctrl+A 全选 / （Ctrl|Shift）+点击 多选反选
+    ├── 编辑：Ctrl+C 复制 / Ctrl+Shift+C 复制为图片 / Ctrl+V 粘贴 / Ctrl+G 成组 / Ctrl+X 剪切 / Ctrl+D 创建副本 / Ctrl+Z 撤销 / Ctrl+Y 恢复 / Delete 删除
+    ├── 思维导图：Enter 同级 / Tab 子节点 / Shift+Tab 父节点 / Alt+. 展开收起 / Ctrl+Alt+Shift+C 全部展开收起 / 空格 编辑节点
+    └── 模式：H 或按住空格 进入/退出拖拽模式
 ```
 
----
-
 ### 2.4 项目管理（4399项目管理）功能树
 
 ```
 4399项目管理
 ├── 顶部导航栏
 │   ├── Logo + 产品标题 "4399项目管理"
-│   ├── 版本更新提示（带"new"徽章）
-│   ├── 消息通知（铃铛图标）
-│   ├── 帮助中心入口
-│   └── 用户信息
+│   ├── 版本更新提示 / 消息通知 / 帮助中心 / 用户信息
+│   └── 顶部操作：成员头像组、未读计数、邀请、菜单
 │
-├── 项目仪表盘（projectDashboard）
-│   ├── 我的任务区块
-│   │   ├── 任务总数（共79个任务）
-│   │   ├── 任务列表预览（前5条）
-│   │   │   ├── 任务名称
-│   │   │   ├── 所属项目名称（彩色标签）
-│   │   │   └── 优先级标识
-│   │   └── "查看更多"链接 → 跳转至任务列表页
-│   │
+├── 项目仪表盘（#/projectDashboard）
+│   ├── 我的任务区块（任务总数 + 前几条预览 + 查看更多）
 │   ├── 团队区块
-│   │   ├── 团队名称
-│   │   ├── 团队人数
-│   │   ├── 任务统计面板
-│   │   │   ├── 进行中的任务（绿色）
-│   │   │   ├── 已逾期任务（红色）
-│   │   │   └── 总任务数量（蓝色）
-│   │   └── "创建团队"按钮
+│   │   ├── 团队名称 / 团队人数
+│   │   └── 任务统计：进行中的任务 / 已逾期任务 / 总任务数量
+│   ├── 帮助中心区块（帮助文档 + 版本更新日志列表 + 查看更多）
+│   └── 我的项目区块（项目卡片网格 + 新建项目）
+│
+├── 我的任务（#/myTask）
+│   ├── 视图切换：表格（看板/甘特图同样可达）
+│   ├── **任务层级切换：子任务折叠展示 / 子任务独立展示（v2.7.3）**
+│   ├── 筛选（执行者 / 自定义筛选 / 保存配置）
+│   ├── 展开子任务（开关）
+│   ├── 任务列表：标题、开始时间、截止时间、优先级、所属项目
+│   └── 优先级：非常紧急（红）/ 紧急 / 普通 / 待设置
+│
+├── 我的团队（#/myTeam）
+│   ├── 团队 / 全部成员 / 邀请新成员
+│   ├── 成员视图：全部成员 / 用户管理
+│   ├── 任务列表：表格视图 + 项目显隐设置
+│   ├── 筛选：状态 / 执行者 / 优先级 / 项目 / 标签 / 时间
+│   └── 标签筛选支持跨成员所有项目（v2.6.9 修复）
+│
+├── 项目详情（?project_id=:id#/project）
+│   ├── 项目切换、任务分组（如 精卫需求池 / 精卫文档）
+│   ├── 工具栏
+│   │   ├── 视图切换：看板 / 表格 / 甘特图
+│   │   ├── 任务层级：仅父任务 / 所有任务（看板）；子任务折叠展示 / 子任务独立展示（表格、甘特图）
+│   │   ├── 分组方式：不分组 / 按任务列表分组
+│   │   ├── 筛选
+│   │   ├── 展开子任务（开关）
+│   │   ├── 关键词/任务ID 搜索
+│   │   └── 更多（⋯）
 │   │
-│   ├── 帮助中心区块
-│   │   ├── 帮助文档入口
-│   │   ├── 版本更新日志列表
-│   │   └── "查看更多"链接
+│   ├── 视图能力
+│   │   ├── 看板：列 = 任务列表（阶段/状态），卡片含标题、标签、子任务进度、参与者、权重
+│   │   ├── 表格：列含 标题 / **任务ID** / 任务状态 / 执行者 / 开始时间 / 截止时间 / 工期 / 任务列表 / 备注 / 优先级 / 标签 / 参与者 / 迭代 / 需求方 / 权重 / 需求文档 / 需求背景 / 期待方案 / 计划上线月份 / 交互地址 / 设计稿地址
+│   │   │   └── 子任务独立展示时新增「归属」列（默认在标题之后；调整自定义表头排序时不显示）
+│   │   ├── 甘特图：时间轴（日/周…视图切换）、悬浮滚动条（v2.6.9 优化）
+│   │   └── 各视图支持单独记录设置项（v2.6.9）
 │   │
-│   └── 我的项目区块
-│       ├── 项目卡片网格
-│       └── 新建项目按钮
-│
-├── 我的任务页面（myTask）
-│   ├── 页面标题 "我的任务"
-│   ├── 筛选控制栏
-│   │   ├── 执行者筛选（"显示所有执行者"）
-│   │   ├── 自定义筛选
-│   │   └── 表头配置（支持自定义列）
-│   ├── 表头修改提示（"当前表头有修改未保存"）
-│   ├── 保存配置按钮
-│   ├── 任务列表表格
-│   │   ├── 任务名称列（含项目标签颜色标识）
-│   │   ├── 开始时间列
-│   │   ├── 截止时间列
-│   │   ├── 优先级列
-│   │   │   ├── 非常紧急（红色）
-│   │   │   ├── 紧急
-│   │   │   ├── 普通
-│   │   │   └── 待设置
-│   │   └── 所属项目列
-│   └── 空状态提示（"当前暂无任务"）
+│   ├── 自定义视图（v2.6.8 新增）
+│   │   ├── 保存常用筛选 + 分组为 看板/表格/甘特图 视图
+│   │   ├── 可见性：仅自己可见 / 共享给整个团队
+│   │   └── 可预设默认的子任务显示方式（选填，设后在页面置灰）
+│   │
+│   ├── 任务详情
+│   │   ├── 字段：状态 / 执行者 / 时间（开始-截止）/ 工期 / 项目 / 备注 / 需求背景 / 优先级 / 标签 / 参与者 …
+│   │   ├── **子任务**（v2.6.8 新增）：可拆解、单独设执行人与截止时间、拖动排序、字段设置调整排序
+│   │   ├── 备注支持附件上传（v2.7.0 新增）
+│   │   ├── 视频上传 / 文件附件
+│   │   ├── 评论 + 动态（所有动态 / 仅评论 两个 tab）
+│   │   └── 看板评论功能
+│   │
+│   ├── 任务唯一标识（v2.7.0 新增）
+│   │   └── 形如 T10031909，默认不显示，需在【字段设置】手动勾选开启
+│   │
+│   ├── 归档（v2.7.0 改造）
+│   │   ├── 支持归档单个任务 / 整列 / 整组
+│   │   ├── 独立「已归档管理」页面：搜索、筛选、批量恢复、批量删除
+│   │   └── 归档数据以快照形式独立存储，不受原项目分组变更影响
+│   │
+│   ├── 回收站
+│   └── 项目成员管理、标签编辑、任务字段编辑（仅管理员有字段编辑入口）
 │
-└── 项目详情页（project/:id）
-    ├── 项目名称 + 状态
-    ├── 工具栏
-    ├── 视图切换
-    │   ├── 看板视图（Kanban）
-    │   ├── 表格视图（Table）
-    │   └── 甘特图视图（Gantt）
-    ├── 任务分组
-    ├── 任务自定义字段
-    ├── 任务详情页
-    │   ├── 任务描述
-    │   ├── 附件上传（支持视频）
-    │   ├── 评论功能
-    │   └── 任务详情展示样式
-    ├── 自定义筛选
-    ├── 归档功能
-    ├── 回收站
-    └── 项目成员管理
+└── 通知体系
+    ├── 站内消息中心
+    ├── 浏览器桌面推送
+    ├── 企微消息通知
+    └── 子任务通知（v2.7.0）：新增（指定执行者）/ 修改进度状态 / 修改执行者 / 过期提醒（定时）
+        └── 支持企微 + 邮件，受父任务设置中的通知设置控制
 ```
 
 ---
 
-## 三、核心业务流程分析
-
-### 3.1 文档管理核心流程
-
-| 阶段       | 用户行为                  | 页面     | 系统动作                           |
-| :------- | :-------------------- | :----- | :----------------------------- |
-| **进入**   | 用户访问 `#/docDashboard` | 文档仪表盘  | 加载最近查看列表，显示文档库侧边栏              |
-| **浏览**   | 切换标签页"最近查看"/"我的收藏"    | 文档仪表盘  | 刷新列表数据，切换显示列（查看时间 ↔ 收藏时间）      |
-| **搜索**   | 点击"搜索文档"，输入关键词        | 全局搜索面板 | 展开高级搜索面板，支持按关键词/创建者/项目/版本/年份筛选 |
-| **定位文档** | 在左侧文档库点击某个库           | 文档仪表盘  | 切换到该文档库的文档列表                   |
-| **查看文档** | 点击文档标题                | 文档编辑器  | 打开文档详情页，加载ProseMirror编辑器       |
-| **编辑文档** | 在编辑器中修改内容             | 文档编辑器  | 实时保存，支持富文本/Markdown/甘特图编辑      |
-| **收藏**   | 点击星标图标                | 文档列表   | 将文档加入"我的收藏"，记录收藏时间             |
-| **分享**   | 使用分享功能                | 文档编辑器  | 生成分享链接，支持文档库项目分享               |
-| **协作**   | 邀请成员/成员管理             | 文档库设置  | 添加协作者，设置权限                     |
-
-### 3.2 项目管理核心流程
-
-| 阶段        | 用户行为                      | 页面     | 系统动作                 |
-| :-------- | :------------------------ | :----- | :------------------- |
-| **进入**    | 用户访问 `#/projectDashboard` | 项目仪表盘  | 加载我的任务、团队统计、项目列表     |
-| **查看任务**  | 点击"查看更多"                  | 我的任务页面 | 展示完整任务列表，支持按执行者筛选    |
-| **管理任务**  | 修改表头配置、筛选条件               | 我的任务页面 | 自定义列显示、保存配置          |
-| **进入项目**  | 点击项目卡片                    | 项目详情页  | 加载项目看板/表格/甘特图视图      |
-| **创建任务**  | 在项目中新建任务                  | 项目详情页  | 填写任务名称、优先级、截止时间、所属项目 |
-| **跟踪进度**  | 切换看板/表格/甘特图视图             | 项目详情页  | 多维度展示任务进度            |
-| **任务协作**  | 评论、上传附件                   | 任务详情页  | 支持文字评论、视频上传、文件附件     |
-| **归档/回收** | 归档已完成任务                   | 项目详情页  | 移入归档区或回收站            |
+## 三、AI 能力层（v2.6.7 起）
+
+| 能力 | 上线版本 | 入口 | 说明 |
+| :--- | :--- | :--- | :--- |
+| **AI 侧边栏助手** | v2.6.7 | 页面右下角 AI 悬浮按钮 | 开放式多轮对话，支持上下文记忆；可查看与当前文档相关信息；可接入企业知识库并按需选择 |
+| **AI 辅助写作** | v2.6.7 | 富文本选中文字 → 工具栏，或输入 `/` | 内容扩充、语言润色、语法纠错、改写降重、精简内容；结果可替换原文或插入文档 |
+| **AI 速览** | v2.6.x 已存在 | 文档工具栏 | 文档内容摘要 |
+| **帮助中心知识库问答** | v2.7.0 | 帮助中心右下角 AI 悬浮按钮 | 基于帮助中心文档内容对话式答疑 |
+| **知识库项目多选** | v2.7.0 | AI 助手 → 关联知识库 | 支持选择多个知识库项目组合进行问答 |
+
+> 说明：AI 助手是**全局单例面板**（DOM 容器 `.jw-assistant`），在文档端与项目端都会出现，且**首次进入页面会自动展开**。做界面/交互方案时需把它当作常驻浮层考虑遮挡关系。
 
 ---
 
-## 四、信息架构（IA）分析
+## 四、核心业务流程
 
-### 4.1 导航结构
+### 4.1 文档管理核心流程
+
+| 阶段 | 用户行为 | 页面 | 系统动作 |
+| :--- | :--- | :--- | :--- |
+| 进入 | 访问 `#/docDashboard` | 文档仪表盘 | 加载文档库卡片 + 最近查看列表，挂载 AI 悬浮入口 |
+| 浏览 | 切换「最近查看」/「我的收藏」 | 文档仪表盘 | 刷新列表；收藏为弹窗，列头换为「收藏时间」 |
+| 检索 | 点击「搜索文档」 | 全局搜索面板 | 无输入时给「最近浏览 / 最近编辑」推荐；有输入时标题+正文匹配并高亮 |
+| 筛选 | 组合 类型/项目/创建者/年份/最近创建/版本/排序 | 全局搜索面板 | 逐个条件收窄结果集 |
+| 查看 | 点击文档标题 | 文档编辑器 | 打开编辑器，左侧目录树 + 顶部工具栏 |
+| 编辑 | 修改内容 / 选中文字用 AI 辅助 | 文档编辑器 | 实时保存；版本快照可持续累积，可「恢复此记录」 |
+| 画图 | 插入 → 画板 / 新建画板文档 | 画板编辑页 | 绘图内容独立保存，缩略图回填文档 |
+| 分享 | 分享文档库项目 / 文件夹 / 画板 | 分享页 | 生成链接；v2.7.2 起支持外部账号「外部登录」访问 |
+| 对外调用 | 开启云文档 MCP 并粘贴配置到 IDE | 文档 MCP 配置 | 外部 AI 工具可搜索/读取有权限的文档；v2.7.1 起也支持直接投喂分享链接 |
+
+### 4.2 项目管理核心流程
+
+| 阶段 | 用户行为 | 页面 | 系统动作 |
+| :--- | :--- | :--- | :--- |
+| 进入 | 访问 `#/projectDashboard` | 项目仪表盘 | 加载我的任务、团队统计、帮助中心、我的项目 |
+| 查看任务 | 点击「查看更多」 | 我的任务 | 完整任务列表，可切任务层级、按执行者筛选 |
+| 配置视图 | 切换视图 / 分组 / 任务层级 / 筛选 | 项目详情 | 设置项按视图独立记录；也可存为自定义视图 |
+| 进入项目 | 点击项目卡片 | 项目详情 | 加载看板/表格/甘特图 |
+| 新建任务 | 在分组列或表格中新建 | 项目详情 | 填写标题、优先级、时间、所属任务列表等 |
+| 拆解 | 在任务详情创建子任务 | 任务详情 | 子任务独立设执行人与截止时间，可拖动排序 |
+| 跟踪 | 切换三种视图 / 展开子任务 / 切任务层级 | 项目详情 | 表格视图子任务独立展示时新增「归属」列 |
+| 协作 | 评论、上传附件（含视频） | 任务详情 | 支持文字评论、备注附件、视频附件，记录到动态 |
+| 归档 | 归档单个任务 / 整列 / 整组 | 项目详情 → 已归档管理 | 快照独立存储，可在归档页搜索/筛选/批量恢复/删除 |
+| 通知 | —— | —— | 任务与子任务的增改、进度、执行者变更、过期提醒按设置推送站内/企微/邮件 |
+
+---
+
+## 五、信息架构（IA）分析
+
+### 5.1 导航结构
 
 ```
 精卫平台
 ├── 一级导航（产品切换）
-│   ├── 4399云文档（文档中心）
+│   ├── 4399云文档（文档中心）  → 用户下拉可切换
 │   └── 4399项目管理（项目中心）
 │
 ├── 文档中心内部导航
-│   ├── 顶部：全局搜索 | 版本更新 | 通知 | 帮助 | 用户
-│   ├── 左侧：文档库列表（固定项 + 可展开列表）
-│   └── 主区：标签页（最近查看 | 我的收藏）
+│   ├── 顶部：全局搜索 | 版本更新 | 工具 | 通知 | 帮助 | 用户
+│   ├── 主区：文档库卡片（可展开/收起）
+│   ├── 标签页：最近查看 | 我的收藏
+│   └── 右下：AI 助手悬浮入口
 │
 └── 项目管理内部导航
-    ├── 顶部：版本更新 | 通知 | 帮助 | 用户
-    ├── 主区仪表盘：任务概览 | 团队 | 帮助 | 项目列表
-    └── 二级页面：我的任务 | 项目详情
+    ├── 顶部：项目切换 | 版本更新 | 通知 | 帮助 | 成员 | 邀请 | 菜单
+    ├── 主区仪表盘：我的任务 | 团队 | 帮助中心 | 我的项目
+    └── 二级页面：我的任务 | 我的团队 | 项目详情 | 已归档管理
 ```
 
-### 4.2 页面层级
+### 5.2 页面层级与 URL
 
-```
-层级1：产品入口
-  ├── https://note.4399doc.com/prd#/docDashboard    （文档仪表盘）
-  └── https://note.4399doc.com/prd#/projectDashboard （项目仪表盘）
-
-层级2：功能页面
-  ├── https://note.4399doc.com/prd#/myTask           （我的任务）
-  └── https://note.4399doc.com/prd#/project/:id      （项目详情）
+| 层级 | URL | 页面 |
+| :--- | :--- | :--- |
+| 1 产品入口 | `https://doc.example.com/prd#/docDashboard` | 文档仪表盘 |
+| 1 产品入口 | `https://doc.example.com/prd#/projectDashboard` | 项目仪表盘 |
+| 2 功能页面 | `https://doc.example.com/prd#/myTask` | 我的任务 |
+| 2 功能页面 | `https://doc.example.com/prd#/myTeam` | 我的团队 |
+| 2 功能页面 | `https://doc.example.com/prd?project_id=:id&b=:boardId#/project` | 项目详情 |
+| 3 内容页面 | `https://doc.example.com/prd?note_id=:id&doc=:id&owner_id=:id#/doc/:id` | 文档编辑器 |
+| 3 内容页面 | `https://doc.example.com/prd?sid=:sid#/share` | 分享页（文档 / 画板） |
 
-层级3：内容页面
-  └── https://note.4399doc.com/prd?doc=:id#/doc/:id  （文档编辑器）
-```
+> 注意：项目详情页**不能靠 `#/project/:id` 直达**，必须带 `project_id` 查询参数，否则页面空白；文档列表中的条目也应通过 Router 跳转而非直接改 URL。
 
-### 4.3 信息组织方式评价
+### 5.3 信息组织方式评价
 
 | 评价维度 | 评价 | 说明 |
 | :--- | :--- | :--- |
-| **符合用户认知** | ⭐⭐⭐⭐ | 文档与项目分开管理，符合主流协同工具分类方式 |
-| **易于发现功能** | ⭐⭐⭐⭐ | 左侧文档库一目了然，项目仪表盘分区清晰 |
-| **信息层级合理** | ⭐⭐⭐⭐ | 三层页面层级清晰，不嵌套过深 |
-| **搜索可达性** | ⭐⭐⭐⭐⭐ | 全局搜索支持多维度筛选（关键词/创建者/项目/版本/年份） |
-| **导航一致性** | ⭐⭐⭐⭐ | 两个产品共用顶部导航风格，操作习惯一致 |
+| 符合用户认知 | ⭐⭐⭐⭐ | 文档与项目分区清晰，AI 作为公共浮层不抢导航位 |
+| 易于发现功能 | ⭐⭐⭐⭐ | 主导航入口少而稳定；但深层能力（画板/自定义视图/已归档管理/任务层级）埋在工具栏，新用户不易发现 |
+| 信息层级合理 | ⭐⭐⭐⭐ | 三层页面层级，不嵌套过深 |
+| 搜索可达性 | ⭐⭐⭐⭐⭐ | v2.7.3 后支持「最近浏览/最近编辑」预推荐 + 6 类可组合高级筛选 + 正文匹配 |
+| 导航一致性 | ⭐⭐⭐⭐ | 两端共用顶部导航与 AI 浮层，操作习惯一致 |
 
 ---
 
-## 五、用户角色分析
+## 六、用户角色分析
 
 | 角色 | 目标 | 核心操作 | 权限范围 |
 | :--- | :--- | :--- | :--- |
-| **普通成员** | 查看文档、了解项目进度 | 搜索/查看文档、查看任务列表 | 对文档库有只读权限，对所属项目有查看权限 |
-| **文档编辑者** | 创建和维护文档 | 创建/编辑/删除文档、管理文件夹 | 对指定文档库有读写权限 |
-| **项目成员** | 参与项目任务执行 | 查看/更新任务状态、评论、上传附件 | 对所属项目有任务操作权限 |
-| **项目管理员** | 管理项目和团队 | 创建项目、管理成员、配置字段、归档任务 | 对项目有完整管理权限 |
-| **文档库管理员** | 管理文档库 | 创建文档库、邀请成员、设置权限 | 对文档库有完整管理权限 |
-| **团队管理员** | 管理团队 | 创建团队、管理团队成员 | 团队级别的管理权限 |
-| **超级管理员** | 平台全局管理 | 用户管理、权限分配、系统配置 | 平台所有功能的最高权限 |
+| **普通成员** | 查看文档、了解项目进度 | 搜索/查看文档、查看任务列表 | 文档库只读，所属项目可查看 |
+| **文档编辑者** | 创建和维护文档 | 创建/编辑/删除文档、管理文件夹、使用 AI 写作 | 指定文档库读写 |
+| **项目成员** | 参与任务执行 | 更新任务状态、评论、上传附件、处理子任务 | 所属项目任务操作权限 |
+| **项目管理员** | 管理项目和团队 | 创建项目、管理成员、**编辑任务字段**、自定义视图、归档 | 项目完整管理权限（字段编辑入口仅管理员可见） |
+| **文档库管理员** | 管理文档库 | 创建文档库、邀请成员、设置权限、同步知识库 | 文档库完整管理权限 |
+| **团队管理员** | 管理团队 | 创建团队、管理成员 | 团队级管理权限 |
+| **外部协作者** | 阅读被分享的文档 | 通过「外部登录」访问分享链接 | 仅被分享内容，v2.7.2 起支持非 OA 账号 |
+| **超级管理员** | 平台全局管理 | 用户管理、权限分配、系统配置（用户下拉 → 用户管理） | 全平台最高权限 |
 
 ---
 
-## 六、技术架构分析
+## 七、技术架构分析
 
-### 6.1 前端技术栈
+### 7.1 前端技术栈
 
 | 技术 | 用途 |
 | :--- | :--- |
-| **Vue.js 2.x** | 前端框架（通过 `__vue__` 实例确认） |
-| **Vue Router** | 路由管理（Hash模式：`#/docDashboard`） |
-| **Ant Design Vue** | UI组件库（`ant-table`、`ant-btn`、`ant-pagination`、`ant-select`等） |
-| **ProseMirror** | 富文本编辑器内核 |
-| **TipTap** | 基于ProseMirror的编辑器框架 |
-| **SVG图标系统** | 自定义JwIcon组件 |
+| **Vue** | 前端框架（v2.6.8 完成「前端框架升级 + 组件库升级」，具体主版本待向前端确认） |
+| **Vue Router** | Hash 模式路由（`#/docDashboard`、`#/project`） |
+| **Ant Design Vue** | UI 组件库（产物分包 `antdv.*.js`；DOM 中可见 `ant-dropdown`、`ant-btn`、`ant-modal`、`ant-checkbox` 等） |
+| **自研组件前缀** | `Jw*`：`JwIcon`（SVG 图标）、`JwSelect`、`JwColor` |
+| **ProseMirror / TipTap** | 富文本编辑器内核 |
+| **画板内核** | 独立画布应用，以 `iframe`（`.custom-canvas-node__iframe`）嵌入文档，外层由 `custom-canvas-node` 包裹 |
+| **AI 助手** | 独立挂载的全局组件 `.jw-assistant`，含 `.jw-assistant-trigger`（悬浮入口）与 `.jw-assistant-panel` |
 
-### 6.2 URL路由结构
+### 7.2 数据标识
 
-| 路由 | 页面 | 说明 |
+| 类型 | ID 格式 | 示例 |
 | :--- | :--- | :--- |
-| `#/docDashboard` | 文档仪表盘 | 文档中心首页 |
-| `#/projectDashboard` | 项目仪表盘 | 项目管理首页 |
-| `#/myTask` | 我的任务 | 个人任务列表 |
-| `#/project/:id` | 项目详情 | 具体项目看板/表格/甘特图 |
-| `#/doc/:id` | 文档详情 | 文档编辑器页面 |
+| 文档库（group） | MongoDB ObjectId | `e0cf0b1d47e98d6ef677c92c` |
+| 文档（note） | MongoDB ObjectId | `346e7ff94ff89012beb2ea3b` |
+| 文件夹（notebook） | MongoDB ObjectId | `0d9410f74fbaa4603527d651` |
+| 项目（project） | 数字 ID | `42`、`327`、`355` |
+| 任务（task） | `T` + 数字 | `T10031909` |
+| 分享（share） | 32 位字符串 | `sid=f145b1b641908ccf39c6dc11` |
 
-### 6.3 数据标识
+### 7.3 开放能力（MCP）
 
-| 类型 | ID格式 | 示例 |
+| 能力 | 上线版本 | 说明 |
 | :--- | :--- | :--- |
-| 文档库 | MongoDB ObjectId | `e0cf0b1d47e98d6ef677c92c` |
-| 文档 | MongoDB ObjectId | `346e7ff94ff89012beb2ea3b` |
-| 项目 | 数字ID | `42`、`327`、`355` |
+| 云文档 MCP | v2.7.0 | 文档首页开启后生成标准 MCP 配置，粘贴到 IDE 使用；AI 工具可搜索、读取有权限的云文档 |
+| 分享链接投喂 | v2.7.1 | 直接把文档分享链接发给智能体查看 |
+
+> 本 Skill 的 `platform-spec` 更新流程即依赖该 MCP：工具面为 `list-group` / `list-notebook` / `list-note` / `fetch-note` / `fetch-note-share` / `search-note`。
 
 ---
 
-## 七、功能模块详细清单
-
-### 7.1 文档中心功能清单
-
-| 功能模块      | 功能点                       | 状态              |
-| :-------- | :------------------------ | :-------------- |
-| **文档管理**  | 创建文档（富文本）                 | ✅ 已实现           |
-|           | 创建 Markdown               | ✅ 已实现           |
-|           | 创建甘特图                     | ✅ 已实现           |
-|           | 导入文档                      | ✅ 已实现           |
-|           | 上传文件转在线文档                 | ✅ 已实现           |
-|           | 创建/编辑/删除文件夹               | ✅ 已实现           |
-| **编辑能力**  | 富文本编辑（ProseMirror/TipTap） | ✅ 已实现           |
-|           | 文档中插入链接                   | ✅ 已实现           |
-|           | 文档中插入表格                   | ✅ 已实现           |
-|           | 文档中插入图片（可拖拽调整）            | ✅ 已实现           |
-|           | 文档中插入视频                   | ✅ 已实现（v2.6.6新增） |
-|           | 引用云文档内容                   | ✅ 已实现           |
-|           | 附件上传                      | ✅ 已实现           |
-|           | 文档批注                      | ✅ 已实现           |
-|           | 文档演示模式                    | ✅ 已实现           |
-|           | AI速览                      | ✅ 已实现           |
-| **组织管理**  | 文档库管理                     | ✅ 已实现           |
-|           | 自定义排序                     | ✅ 已实现（v2.6.6新增） |
-|           | 文件夹下显示子文件夹                | ✅ 已实现（v2.6.6新增） |
-|           | 邀请成员/成员管理                 | ✅ 已实现           |
-| **查找与检索** | 全局搜索（关键词）                 | ✅ 已实现           |
-|           | 按创建者筛选                    | ✅ 已实现           |
-|           | 按项目筛选                     | ✅ 已实现           |
-|           | 按版本筛选                     | ✅ 已实现           |
-|           | 按创建年份筛选                   | ✅ 已实现           |
-|           | 排序方式选择                    | ✅ 已实现           |
-| **个人中心**  | 最近查看                      | ✅ 已实现           |
-|           | 我的收藏                      | ✅ 已实现           |
-|           | 移除查看记录                    | ✅ 已实现           |
-|           | 历史操作记录                    | ✅ 已实现           |
-| **分享协作**  | 分享文档库项目                   | ✅ 已实现           |
-|           | 文件夹分享                     | ✅ 已实现           |
-|           | 同步知识库                     | ✅ 已实现           |
-| **通知系统**  | 浏览器桌面推送                   | ✅ 已实现           |
-|           | 企微消息通知                    | ✅ 已实现           |
-|           | 消息通知设置                    | ✅ 已实现           |
-
-### 7.2 项目管理功能清单
-
-| 功能模块     | 功能点                   | 状态              |
-| :------- | :-------------------- | :-------------- |
-| **仪表盘**  | 我的任务概览                | ✅ 已实现           |
-|          | 团队统计（人数/进行中/逾期/总数）    | ✅ 已实现           |
-|          | 项目列表                  | ✅ 已实现           |
-|          | 版本更新日志                | ✅ 已实现           |
-|          | 帮助中心入口                | ✅ 已实现           |
-| **任务管理** | 我的任务列表                | ✅ 已实现           |
-|          | 任务筛选（执行者）             | ✅ 已实现           |
-|          | 自定义筛选                 | ✅ 已实现           |
-|          | 表头自定义配置               | ✅ 已实现           |
-|          | 任务优先级（非常紧急/紧急/普通/待设置） | ✅ 已实现           |
-|          | 任务时间管理（开始/截止时间）       | ✅ 已实现           |
-|          | 任务所属项目关联              | ✅ 已实现           |
-| **项目视图** | 看板视图（Kanban）          | ✅ 已实现           |
-|          | 表格视图（Table）           | ✅ 已实现           |
-|          | 甘特图视图（Gantt）          | ✅ 已实现           |
-|          | 看板任务分组                | ✅ 已实现           |
-| **项目功能** | 任务自定义字段               | ✅ 已实现           |
-|          | 任务详情页                 | ✅ 已实现           |
-|          | 任务详情视频上传              | ✅ 已实现（v2.6.6新增） |
-|          | 任务详情展示样式              | ✅ 已实现           |
-|          | 看板评论功能                | ✅ 已实现           |
-|          | 归档功能                  | ✅ 已实现           |
-|          | 回收站                   | ✅ 已实现           |
-|          | 项目成员管理                | ✅ 已实现           |
-| **团队管理** | 创建团队                  | ✅ 已实现           |
-|          | 团队成员管理                | ✅ 已实现           |
-|          | 我的团队                  | ✅ 已实现           |
+## 八、版本迭代记录（v2.6.6 → v2.7.3）
+
+| 版本 | 文档更新时间 | 主要更新 |
+| :--- | :--- | :--- |
+| **v2.6.6** | 2026-05-21 | 文档自定义排序、文件夹下显示子文件夹、文档视频上传、项目详情视频上传（上一版基线） |
+| **v2.6.7** | 2026-06-09 | 【新增】AI 助手（侧边栏、多轮对话、关联企业知识库）；【新增】AI 辅助写作（扩充/润色/纠错/改写/精简） |
+| **v2.6.8** | 2026-07-15 | 【新增】子任务规则（详情页建子任务、独立执行人与截止时间）；【新增】自定义视图（看板/表格/甘特图，可私有或共享）；【优化】前端框架与组件库升级、服务端数据安全修复、分享链接企微展示、知识库同步规则 |
+| **v2.6.9** | 2026-07-23 | 【优化】子任务：字段设置排序、企微通知加「归属父任务」、父任务同步子任务记录、标题选填（缺省显示「子任务」）、分享页可返回父任务、列表拖动排序、看板可展开子任务；【修复】我的团队标签筛选（跨全部项目）；【优化】甘特图悬浮滚动条、视图设置项独立记录 |
+| **v2.7.0** | 2026-08-03 | 【新增】任务唯一标识（T+编号，默认不显示，字段设置开启）；【新增】归档优化（单个/整列/整组归档 + 独立「已归档管理」页，快照独立存储）；【新增】帮助中心知识库问答；【新增】任务详情备注附件上传；【新增】文档 MCP 服务；【优化】子任务通知（企微+邮件）；【新增】知识库项目多选 |
+| **v2.7.1** | 2026-08-11 | 【优化】文档 MCP 支持分享链接查看；【优化】子任务到期通知文案；【优化】列表无任务时归档列表的显示与分组逻辑 |
+| **v2.7.2** | 2026-08-31 | 【新增】文档支持插入画板（思维导图/流程图，可嵌入文档查看与编辑）；【优化】演示模式；【新增】项目文档库支持展开收起列表；【优化】文件夹创建方式；【新增】云文档支持外部账号访问 |
+| **v2.7.3** | 2026-09-28 | 【新增】子任务单独列表展示（任务层级切换，可查归属父任务）；【优化】搜索页样式调整（最近浏览/最近编辑 + 高级多条件筛选与搜索）；【优化】画板二期（便签、分区、贴纸素材、Mermaid/Markdown 转流程图、独立画板分享链接）；【优化】父任务与子任务层级视觉区分（表格/甘特图） |
 
 ---
 
-## 八、版本迭代记录
+## 九、页面截图参考
 
-| 版本         | 发布时间       | 主要更新                                                                                                                         |
-| :--------- | :--------- | :--------------------------------------------------------------------------------------------------------------------------- |
-| **v2.6.6** | 2026年5月21日 | 文档自定义排序、文件夹子文件夹显示、文档视频上传、项目详情视频上传                                                                                            |
+所有截图位于 `assets/`（共 23 张，采集于 v2.7.3 / 2026-09-28）。多数为 Retina 高清（约 1600–3240 × 1000–1744），画板系列为 1600×1000，部分弹窗图为裁切截图。
 
+### 9.1 文档端
 
----
+| 文件 | 内容 |
+| :--- | :--- |
+| `doc_dashboard_full.png` | 文档首页：文档库卡片 + 最近查看（标题/更新人/查看时间筛选） |
+| `doc_library_grid.png` | 文档库全部展开（29 个库的卡片网格） |
+| `doc_search.png` | 全局搜索面板 · 搜索前推荐（最近查看 / 最近编辑 tab） |
+| `doc_search_2.png` | 搜索结果：关键词高亮 + 右侧高级筛选（类型/项目/创建者/创建年份/最近创建/版本/排序） |
+| `doc_collect.png` | 我的收藏弹窗（标题/更新人/收藏时间） |
+| `doc_ai_assistant.png` | AI 侧边栏助手（新建AI对话、关联知识库） |
+| `doc_user_menu.png` | 用户下拉：个人信息/用户管理/帮助中心/文档MCP/4399项目管理/退出 |
+| `doc_list_page.png` | 文档编辑器：左侧目录树 + 内容区 |
+
+### 9.2 画板
+
+| 文件 | 内容 |
+| :--- | :--- |
+| `doc_board_embedded.png` | 画板以缩略预览嵌入富文本文档 |
+| `doc_board_toolbar.png` | 画板嵌入节点选中态：缩放/编辑/复制/导出/删除 工具栏 |
+| `doc_board_editor.png` | 画板编辑页：左侧图形工具栏、右上分享/编辑、右下缩放与网格 |
+| `doc_board_export.png` | 画板导出菜单（JSON / SVG / PNG / JPG） |
 
-## 九、页面截图参考
+### 9.3 项目管理端
+
+| 文件 | 内容 |
+| :--- | :--- |
+| `project_dashboard.png` | 项目仪表盘：我的任务 / 团队统计 / 帮助中心 / 我的项目 |
+| `my_tasks.png` | 我的任务：表格、子任务折叠展示、筛选、展开子任务 |
+| `my_team.png` | 我的团队：成员、任务列表、项目显隐设置、多维筛选 |
+| `task_management_Kanban.png` | 项目详情 - 看板视图（列=任务列表，卡片含标签与子任务进度） |
+| `task_management_Form.png` | 项目详情 - 表格视图（含任务ID列，可按任务列表分组） |
+| `task_management_Gantt.png` | 项目详情 - 甘特图视图（时间轴 + 日视图切换） |
+| `task_level_switch.png` | 任务层级切换下拉：仅父任务 / 所有任务 |
+| `task_detail.png` | 任务详情弹窗：子任务（1/1、+添加子任务）、状态/执行者/时间/项目、需求背景、优先级与标签、参与者、需求文档与交互地址、权重等字段；右侧「所有动态 / 仅评论」时间线 |
+| `custom_view_panel.png` | 新建视图弹窗：视图名称、可见范围（公开视图 / 个人视图）、视图类型（看板 / 表格 / 甘特图）、任务层级（仅父任务 / 所有任务）、任务分组与分组方式、筛选条件 |
+| `archive_management.png` | 已归档管理：ID / 标题 / 项目 / 归档时间 / 归档操作人列表，支持标题、归档时间、归档操作人筛选 + 批量删除 / 恢复 + 分页 |
+
+### 9.4 全局与跨端
+
+| 文件 | 内容 |
+| :--- | :--- |
+| `notification_center.png` | 消息通知中心：全部 / 未读 / @我的 / 系统通知 四个分类 + 通知流（含子任务评论、完成、认领等事件）+ 右侧详情（可直接评论、一键「查看项目」） |
 
-主要截图已保存至`references/img`：
-
-- `doc_dashboard_full.png` - 文档首页
-- `doc_list_page.png` - 文档列表
-- `doc_search.png` - 文档搜索
-- `doc_collect.png` - 文档收藏
-- `doc_Recently.png` - 文档最近查看
-- `doc_Information.png` - 文档消息中心
-- `project_dashboard.png` - 项目管理首页
-- `my_tasks.png` - 我的任务
-- `my_team.png` - 我的团队
-- `task_management_Kanban.png` - 任务管理-看板
-- `task_management_Form.png` - 任务管理-表格
-- `task_management_Gantt.png` - 任务管理-甘特图
-- `task_Details.png` - 任务详情
+> 说明：云文档 MCP 配置页**不提供截图**（能力说明见 §7.3），属于入口型配置页，不影响对能力的理解。
 
 ---
 
 ## 十、总结与评价
 
 ### 优势
-1. **文档与项目深度融合**：文档库与项目管理共享同一平台，信息流转顺畅
-2. **多视图支持**：项目管理支持看板、表格、甘特图三种视图，满足不同场景需求
-3. **强大的搜索能力**：全局搜索支持5个维度的筛选条件
-4. **丰富的文档类型**：支持富文本、Markdown、甘特图等多种文档格式
-5. **企业级协作**：集成企微消息通知、浏览器推送等企业级功能
+
+1. **文档与项目真正打通**：同一平台、同一账号体系、同一通知链路，文档可同步知识库、项目可关联需求文档。
+2. **内容形态完整且独特**：文字/表格/幻灯片/PDF/Markdown/甘特图/Word/**画板** 八类，其中画板把「绘制—嵌入—协作」闭环做在了平台内，无需外部绘图工具。
+3. **AI 已成公共能力层**：写作辅助、侧边栏问答、知识库问答、知识库多选，横跨两端且入口统一（右下浮层）。
+4. **检索能力显著增强**：v2.7.3 的「最近浏览/最近编辑」预推荐 + 6 类可组合筛选 + 正文匹配，是本次迭代中最实用的一条。
+5. **任务模型更细**：子任务（含独立执行人/时间/排序）+ 任务层级切换 + 任务唯一标识 + 归档快照，覆盖从拆解到归档的完整链路。
+6. **开放性好**：MCP 让平台内容可以被外部 Agent 直接消费，等于把内容资产变成了「可编程资产」。
 
 ### 待改进
-1. **项目详情页加载**：部分项目详情页存在加载缓慢或无法加载的问题
-2. **文档点击交互**：文档列表中的点击事件响应有待优化（需通过Vue Router而非直接URL跳转）
-3. **信息密度**：仪表盘信息密度较高，新用户可能需要一定的学习成本
+
+1. **深层能力入口过深**：画板、自定义视图、已归档管理、任务层级切换都藏在工具栏或二级页面；新用户教育成本高。
+2. **AI 浮层遮挡**：AI 助手首次进入页面自动展开，覆盖页面右下区域，容易压住分页器 / 悬浮操作按钮，建议改为记忆用户偏好或缩小初始态。
+3. **项目详情直链不友好**：必须携带 `project_id` 查询参数，直接使用 `#/project/:id` 会白屏，对外分享与调试都不便。
+4. **仪表盘信息密度高**：我的任务 + 团队统计 + 帮助中心 + 项目网格共处一屏，视觉层级偏平。
+5. **文档列表点击交互**：仍需通过 Router 跳转，直接改 URL 体验不一致。
+6. **权限耦合**：画板权限与所属文档权限强绑定，分享画板会连带分享文档，这个隐式行为需要在交互上更明确地提示。
+
+### 建议优先讨论的三个方向
+
+1. **AI 浮层的默认态与记忆策略**（直接影响所有页面的可用面积）。
+2. **子任务在三种视图中的表达一致性**（看板「所有任务」vs 表格/甘特「子任务独立展示」，命名与行为已出现分叉）。
+3. **画板作为「准独立内容」的权限模型**（是否需要在文档权限之外给画板单独的可见性开关）。

package/skills/version-update-description/SKILL.md

@@ -13,7 +13,11 @@ description: 精卫平台版本更新描述撰写 Skill，通过功能名称快
 
 （输出时去掉方括号，即第一行重复标题，随后紧跟描述正文。）
 
-> 平台背景：精卫平台是 4399 企业内部的文档与项目管理工具，含**文档系统**（文字文档、电子表格、幻灯片、评论协作、权限管理）与**项目管理系统**（看板/列表/甘特视图、需求池、迭代管理）。文案需贴合这一平台定位，语气对标飞书更新日志风格。
+> 平台背景（当前基线：**v2.7.3 / 2026-09-28**）：精卫平台是 4399 企业内部的文档与项目管理一体化工具。
+> - **文档系统**：八类内容（文字文档 / 电子表格 / 幻灯片 / PDF / Markdown / 甘特图 / Word / **画板**——思维导图、流程图，可独立成文或嵌入文档）；评论协作、演示模式、版本历史、项目文档库与权限管理；具备 **AI 能力层**（AI 侧边栏助手、AI 辅助写作、帮助中心知识库问答）与**云文档 MCP** 开放接口。
+> - **项目管理系统**：看板 / 表格 / 甘特图三种视图 + 自定义视图；含子任务、任务层级切换、任务唯一标识、归档与「已归档管理」、需求池与迭代管理。
+>
+> 文案需贴合这一平台定位，语气对标飞书更新日志风格。
 
 ---