xtep-workspace 1.10.10

package/README.md

@@ -0,0 +1,188 @@
+<p align="center">
+  <img src="assets/logo.svg" alt="XtepWorkspace" height="48">
+</p>
+
+<h3 align="center">AI 编程任务的结构化管理方案</h3>
+
+<p align="center">
+  树形任务结构 · 上下文聚焦 · 过程可追溯
+</p>
+
+---
+
+## 这是什么？
+
+XtepWorkspace 就像是 AI 的项目管理系统。
+
+想象你在和一个能干但健忘的同事合作——他很聪明，但对话一长就忘了早期的决策；任务一复杂就容易跑偏。XtepWorkspace 就是给这个"同事"配的任务管理工具：把大任务拆成小步骤，每步都记录下来，随时能回顾进度。
+
+| 概念 | 说明 |
+|------|------|
+| **工作台** | XtepWorkspace 本身，管理所有工作区 |
+| **工作区** | 单个任务的完整记录，包含一棵任务树 |
+| **节点** | 任务树中的每个任务单元 |
+
+### 解决什么问题？
+
+| 问题 | 没有工作台时 | 有工作台后 |
+|------|-------------|-----------|
+| **AI 忘事** | 对话超过 10 轮，AI 忘了开头说的需求 | 所有决策都记录在节点里，随时查阅 |
+| **过程黑盒** | 不知道 AI 做了什么、为什么这样做 | WebUI 实时展示任务树和执行日志 |
+| **粒度失控** | AI 一次规划太多，执行质量下降 | 强制拆分，一次只做一个任务 |
+| **难以继续** | 关掉对话就没了，下次从头来 | 工作区持久化，随时恢复进度 |
+
+---
+
+## 核心特性
+
+- **树形任务结构**：无限层级嵌套，规划节点分解任务，执行节点逐个完成
+- **派发上下文控制**：子任务只获取与当前任务相关的信息，隔离无关上下文
+- **可视化 WebUI**：直观快捷地查看任务树进度，无需翻聊天记录
+- **过程可追溯**：完整操作日志和决策路径，支持回溯复盘
+- **5 种任务场景**：新功能 / 调试修复 / 优化重构 / 总结分析 / 其他，自动匹配引导策略
+- **边界自由**：不要求统一项目根目录，支持跨仓库、跨目录管理任务
+
+## 快速开始
+
+```bash
+# 安装（需要 Node.js >= 20）
+npm install -g xtep-workspace
+
+# 配置（自动检测环境）
+xtep-workspace setup
+```
+
+**支持的 AI 助手**：
+
+| AI 助手 | 支持程度 | 说明 |
+|---------|---------|------|
+| **Claude Code** | 完全支持 | 所有功能可用，推荐使用 |
+| **Cursor** | 基础支持 | subagent 和 skill 支持有限 |
+| **其他 MCP 兼容助手** | 基础功能 | 支持 MCP 即可使用核心功能 |
+
+配置完成后，在 AI 助手中说：
+
+> "使用**工作台**，帮我实现用户登录功能"
+
+**注意**：必须提及"工作区"或"工作台"才会触发，否则 AI 会直接执行而不创建工作区。
+
+<details>
+<summary>其他配置方式</summary>
+
+### 一键配置
+
+```bash
+xtep-workspace setup --claude-code  # Claude Code
+xtep-workspace setup --cursor       # Cursor
+```
+
+### 其他平台
+
+运行 `xtep-workspace setup` 获取配置信息后手动配置。
+
+### WebUI 管理
+
+```bash
+xtep-workspace webui          # 启动 WebUI 服务
+xtep-workspace webui status   # 查看服务状态
+xtep-workspace webui stop     # 停止服务
+xtep-workspace webui restart  # 重启服务
+```
+
+</details>
+
+## 使用样例
+
+```
+你：用工作台帮我加个登录功能
+
+AI：工作区建好了 → http://localhost:19540/workspace/ws-xxx，核对一下需求：
+    登录方式想用哪种？密码、验证码还是第三方？
+
+[用户与AI进行需求核对以及剩余任务开始前需要的信息收集并记录到工作区中]
+
+AI：[展示任务规划]
+    共计3个任务：用户表、中间件、登录API，可以开始吗？
+
+你：可以，使用派发模式进行
+
+AI：收到，派发任务1...
+    [子agent只拿到"创建用户表和密码验证"这个具体任务，前面讨论的细节不会干扰它]
+    任务1完成了，继续派发任务2...
+
+[任务逐个完成，过程记录在工作区日志中，可通过WebUI实时查看]
+
+---（隔了一天，新开对话）---
+
+你：昨天那个登录做到哪了
+
+AI：[从工作区恢复上下文] 3个任务都完成了。还需要改什么吗？
+
+你：再加个验证码登录，进行计划
+
+AI：好，我加个新任务
+
+[继续进任务补充至工作区统一管理]
+```
+
+**优势体现**：派发隔离无关上下文、进度持久保存、新对话无缝恢复
+
+更多使用场景，请参阅 **[用户手册](docs/用户手册.md)**。
+
+### 跨仓库任务
+
+传统工具要求统一项目根目录，XtepWorkspace 不受此限制——按**逻辑层级**管理分散在不同路径的任务：
+
+```
+涉及的项目根路径：
+  ~/work/mobile/FlutterApp/
+  ~/sdk/camera/CameraSDK/
+  ~/sdk/decoder/QRDecoder/
+  ~/libs/CommonUtils/
+```
+
+```
+二维码扫描功能                              进度: 13/17
+│
+├─ 📱 应用层
+│   ├── [✓] 扫描页面 UI                    → ~/work/mobile/FlutterApp/
+│   ├── [▶] 相机调用封装                   → ~/work/mobile/FlutterApp/
+│   ├── [ ] 解码结果处理                   → ~/work/mobile/FlutterApp/
+│   └── [ ] 集成测试                       → ~/work/mobile/FlutterApp/
+│
+├─ 📷 相机 SDK 层
+│   ├── [✓] 预览流接口                     → ~/sdk/camera/CameraSDK/
+│   ├── [✓] 帧数据回调                     → ~/sdk/camera/CameraSDK/
+│   ├── [✓] 权限处理                       → ~/sdk/camera/CameraSDK/
+│   └── [✓] 错误恢复                       → ~/sdk/camera/CameraSDK/
+│
+├─ 🔍 解码器层
+│   ├── [✓] 解码引擎封装                   → ~/sdk/decoder/QRDecoder/
+│   ├── [✓] 多格式支持                     → ~/sdk/decoder/QRDecoder/
+│   ├── [✓] 性能优化                       → ~/sdk/decoder/QRDecoder/
+│   └── [✓] 单元测试                       → ~/sdk/decoder/QRDecoder/
+│
+└─ 🔧 基础库层
+    ├── [✓] 日志工具                       → ~/libs/CommonUtils/
+    ├── [✓] 错误处理                       → ~/libs/CommonUtils/
+    ├── [✓] 配置管理                       → ~/libs/CommonUtils/
+    ├── [✓] 类型定义                       → ~/libs/CommonUtils/
+    └── [✓] 版本同步                       → ~/libs/CommonUtils/
+```
+
+---
+
+## 已知局限
+
+- **长对话下 AI 唤起能力下降**：对话过长时，AI 可能忘记使用工作台，可提醒"用工作台记录一下"
+- **派发模式需要 AI 支持 subagent**：Cursor 等部分助手的派发功能受限
+- **上下文恢复依赖记录完整性**：暂停前建议让 AI 充分记录当前状态
+
+详见 [用户手册 - 已知局限](docs/用户手册.md#已知局限)。
+
+---
+
+## 更多资源
+
+- **[用户手册](docs/用户手册.md)**：完整使用指南、场景示例、FAQ
+- **[更新日志](CHANGELOG.md)**：版本历史和变更记录

package/config/component-versions.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "./component-versions.schema.json",
+  "description": "组件最低版本要求配置 - 仅当用户安装版本低于此处指定版本时才提示更新，0.0.0 表示该平台不支持此组件",
+  "claudeCode": {
+    "mcp": "1.0.0",
+    "hooks": "1.10.3",
+    "agents": "1.10.6",
+    "skills": "1.10.7"
+  },
+  "cursor": {
+    "mcp": "1.0.0",
+    "hooks": "1.0.0",
+    "agents": "0.0.0",
+    "skills": "0.0.0"
+  }
+}

package/config/scenarioCapabilities.json

@@ -0,0 +1,29 @@
+{
+  "feature": {
+    "basePack": ["intent_alignment", "context_discovery"],
+    "optionalPack": ["tech_research", "solution_design", "verification_strategy"]
+  },
+  "summary": {
+    "basePack": ["intent_alignment", "context_discovery"],
+    "optionalPack": []
+  },
+  "optimize": {
+    "basePack": ["intent_alignment", "context_discovery", "measurement_analysis"],
+    "optionalPack": ["diagnosis", "solution_design", "verification_strategy"]
+  },
+  "debug": {
+    "basePack": ["intent_alignment", "context_discovery", "diagnosis"],
+    "optionalPack": ["solution_design", "verification_strategy"]
+  },
+  "misc": {
+    "basePack": ["intent_alignment"],
+    "optionalPack": [
+      "context_discovery",
+      "tech_research",
+      "measurement_analysis",
+      "diagnosis",
+      "solution_design",
+      "verification_strategy"
+    ]
+  }
+}

package/config/version-notes.yaml

@@ -0,0 +1,244 @@
+# XtepWorkspace 版本更新说明
+#
+# 此文件由 scripts/sync-versions.ts 同步维护
+# - conclusion: 自动从 CHANGELOG.md 提取
+# - requirement/note: 人工填写
+#
+# 使用方式：
+#   npm run sync-versions  # 从 CHANGELOG 同步新版本
+#   npm run check-versions # 检查未填写的 requirement
+
+versions:
+  - version: 1.10.10
+    requirement: 工作区置顶、全局备份管理、验收标准动态列
+    conclusion: |-
+      - 工作区置顶：将重要工作区固定在列表顶部
+      - 全局备份管理：WebUI 备份界面，支持创建/恢复/导入/导出
+      - 验收标准动态列：支持任意列结构
+      - 设置页面优化和备份功能修复
+    note: ""
+  - version: 1.10.9
+    requirement: 修复版本更新工作区创建失败、前端版本号不同步
+    conclusion: |-
+      - 修复版本更新工作区创建时 CONCLUSIONS_HASH_REQUIRED 错误
+      - 修复发布脚本版本同步顺序，确保前端版本号正确
+    note: ""
+  - version: 1.10.8
+    requirement: 结论过期检测、update 自动更新插件、Skills 增强
+    conclusion: |-
+      - 结论过期检测：子节点完成时自动提醒更新父节点结论
+      - update 自动更新插件：版本更新后自动同步插件
+      - Skills 增强：新增测试验证和可观测性设计步骤
+      - 工作区导入修复和日志系统优化
+    note: ""
+  - version: 1.10.7
+    requirement: 工作区诊断修复、跨工作区搜索、MCP 输出优化
+    conclusion: |-
+      - 工作区诊断修复：WebUI 新增诊断/修复功能，自动识别并修复工作区问题
+      - 跨工作区搜索：新增 workspace_search 和 content_search 工具
+      - 先读后写机制：node_update/memo_update 防止并发修改冲突
+      - MCP 输出优化：日志智能压缩，减少 token 消耗
+      - CLI 别名：新增 tw 等简短命令
+    note: ""
+  - version: 1.10.6
+    requirement: MEMO 导出、工作区导出/导入、索引管理、派发增强
+    conclusion: |-
+      - MEMO 导出：支持将 MEMO 内容导出为独立文件
+      - 工作区导出/导入：支持工作区完整导出和跨项目导入
+      - 索引管理：WebUI 新增索引管理界面，可查看和重建索引
+      - 功能介绍入口转正：设置页面新增功能介绍生成入口
+      - 多项 Bug 修复和稳定性提升
+    note: ""
+  - version: 1.10.5
+    requirement: 日志系统、Mermaid 图表、工作区稳定性增强
+    conclusion: |-
+      - 新增统一日志系统，便于问题排查
+      - WebUI 支持 Mermaid 图表渲染
+      - 工作区自恢复能力增强
+      - 新增 CLI 自更新命令
+      - 多项 Bug 修复
+    note: ""
+  - version: 1.10.4
+    requirement: 帮助系统增强、Skill 声明机制、文档体系重构
+    conclusion: |-
+      - 功能简介工作区新增版本更新与帮助系统 MEMO
+      - 设置弹窗嵌入用户帮助模块
+      - Skill 添加 Announcement 声明机制
+      - 用户文档体系重构
+    note: ""
+  - version: 1.10.3
+    requirement: 派发状态机修复、Skill 展示成果环节、Hook 功能增强
+    conclusion: |-
+      - 修复派发节点 retry/reopen 后状态未重置的问题
+      - Info 类 Skill 新增展示成果环节（防止直接开始执行）
+      - PostToolUse Hook 增强（TodoWrite 提醒、节流优化）
+      - setup 命令插件安装体验优化
+    note: ""
+  - version: 1.10.2
+    requirement: 派发子代理优化，完善 Skill 引导与 Prompt 生成
+    conclusion: |-
+      - 移除冗余的 xtep-tester
+      - 子代理添加 Skill 调用引导
+      - dispatch_create 返回完整 prompt
+    note: ""
+  - version: 1.10.1
+    requirement: 修复能力列表配置路径问题
+    conclusion: "- 修复 capability_list 在用户项目目录下无法正常工作的问题"
+    note: ""
+  - version: 1.10.0
+    requirement: 派发系统优化、Memo 富卡片、Agents/Skills 更新
+    conclusion: |-
+      - 派发系统优化: Review 机制、Skill 化、AI 引导增强
+      - Memo 富卡片: 节点详情中 Memo 引用以卡片形式展示
+      - Agents/Skills 更新: 执行流程更清晰，需重新安装插件
+    note: ""
+  - version: 1.9.2
+    requirement: 插件更新提示、节点排序、README 重构
+    conclusion: |-
+      - 插件更新提示: 首页显示插件更新横幅，方便及时升级
+      - 插件状态优化: 新增「不支持」状态，区分未安装和不可用
+      - 节点排序: 支持调整同级节点顺序
+      - 版本更新逻辑优化: 改进升级时的工作区处理
+      - README 重构: 精简内容，新增完整使用流程示例
+    note: ""
+  - version: 1.9.1
+    requirement: WebUI同步刷新、旧版本工作区目录名兼容性修复
+    conclusion: |-
+      - 跨进程事件转发: MCP 进程的事件可转发到 HTTP 服务，实现 WebUI 实时同步刷新
+      - 工作区出事后流程强化
+      - 目录名兼容性: 修复旧版本工作区节点目录名无法正确加载的问题
+    note: ""
+  - version: 1.9.0
+    requirement: MEMO 长篇内容记录、验收标准功能、场景化能力包系统
+    conclusion: |-
+      - MEMO 功能: 支持节点级长篇内容记录，草稿机制防丢失
+      - 验收标准: 节点可定义验收条件，WebUI 显示验收状态
+      - 场景化能力包: AI 智能引导系统，根据任务场景推荐执行流程
+      - 插件版本跟踪: 组件级版本检测，前端状态展示，插件更新提醒
+    note: ""
+  - version: 1.8.2
+    requirement: 修复 npm 包前端资源缺失
+    conclusion: "- 修复 npm 安装后 WebUI 无法启动的问题"
+    note: ""
+  - version: 1.8.1
+    requirement: 修复 npm 安装后的启动问题
+    conclusion: |-
+      - 修复 npm 安装后 WebUI 无法启动
+      - 修复生产环境日志报错
+      - 新增自动化发布脚本
+    note: ""
+  - version: 1.8.0
+    requirement: WebUI 独立启动、端口迁移、参数容错
+    conclusion: |-
+      - WebUI 独立启动: `xtep-workspace webui` 命令管理 WebUI 服务
+      - 端口迁移: 默认端口改为 19540
+      - 参数容错: AI 传错参数时自动修复
+      - 版本检测: 前后端版本不匹配时警告
+    note: ""
+  - version: 1.7.2
+    requirement: WebUI 实时刷新、夜间模式优化
+    conclusion: |-
+      - 实时刷新: AI 操作后 WebUI 自动更新，无需手动刷新
+      - 夜间模式优化: 更柔和的颜色、平滑切换过渡
+      - 子节点结论紧凑显示
+    note: ""
+  - version: 1.7.1
+    requirement: 修复配置路径问题
+    conclusion: "- 修复 setup 命令配置路径错误"
+    note: ""
+  - version: 1.7.0
+    requirement: WebUI 全新设计、新手教程、版本更新提示
+    conclusion: |-
+      - WebUI 全新设计: 统一视觉风格
+      - 新手教程: 自动为新用户创建教程工作区
+      - 版本更新提示: 升级后展示新功能变更
+    note: ""
+  - version: 1.6.4
+    requirement: 修复规则更新失败问题
+    conclusion: "- 修复更新工作区规则时报错的问题"
+    note: ""
+  - version: 1.6.3
+    requirement: 修复目录名相关问题
+    conclusion: "- 修复工作区和节点目录相关的遗留问题"
+    note: ""
+  - version: 1.6.2
+    requirement: 派发流程优化
+    conclusion: |-
+      - 派发完成后自动更新节点状态
+      - 子任务全部完成时提醒完成父节点
+      - 支持多工作区并行派发
+    note: ""
+  - version: 1.6.1
+    requirement: 旧数据自动迁移
+    conclusion: |-
+      - 自动将旧版本数据迁移为可读目录名格式
+      - 修改节点标题时自动同步目录名
+    note: ""
+  - version: 1.6.0
+    requirement: 目录名可读化
+    conclusion: |-
+      - 目录名从 UUID 改为「名称_短ID」格式，方便本地查看
+      - 高版本数据自动备份保护
+      - 兼容旧版本数据
+    note: ""
+  - version: 1.5.1
+    requirement: AI 感知 WebUI 手动操作
+    conclusion: "- AI 可感知用户在 WebUI 的手动修改"
+    note: ""
+  - version: 1.5.0
+    requirement: 简化安装流程，支持 npm 全局安装
+    conclusion: |-
+      - npm 全局安装: `npm install -g xtep-workspace`
+      - 一键配置: `xtep-workspace setup` 自动配置 Claude Code 或 Cursor
+      - 版本更新通知: 自动提醒新版本
+      - 权限简化: MCP 权限从 30+ 条简化为通配符规则
+    note: ""
+  - version: 1.4.1
+    requirement: Git 派发稳定性优化
+    conclusion: |-
+      - 派发模式切换: 支持在派发过程中切换 Git/无 Git 模式
+      - Git 兼容性: 工作区目录自动排除，不干扰 Git 操作
+      - 修复派发分支冲突问题
+    note: ""
+  - version: 1.4.0
+    requirement: AI 引导增强、防止 AI 编造确认
+    conclusion: |-
+      - 确认机制: 关键操作需用户确认，防止 AI 自行决定
+      - 智能引导: 根据任务场景自动提供操作建议
+      - 自动绑定提示: 检测到匹配工作区时提示绑定
+      - 重开节点保留历史: 节点重开时保留原有结论
+    note: ""
+  - version: 1.3.0
+    requirement: 多 Agent 协作派发功能
+    conclusion: |-
+      - 派发功能: 任务可派发给其他 AI 会话执行
+      - Git 可选: 派发时可选择是否创建 Git 分支
+      - 多种合并策略: 支持 merge/rebase/squash 等方式
+    note: ""
+  - version: 1.2.0
+    requirement: OpenSpec 导入、智能提醒增强
+    conclusion: |-
+      - OpenSpec 导入: 将 OpenSpec 规范导入为工作区任务
+      - 文档扫描: 创建工作区时自动扫描项目文档
+      - 智能提醒: 代码变更、错误检测等场景自动提醒
+    note: ""
+  - version: 1.1.0
+    requirement: Cursor 支持、归档功能、智能提醒
+    conclusion: |-
+      - Cursor 支持: 新增 Cursor 编辑器集成
+      - 归档功能: 支持工作区归档与恢复
+      - 智能提醒: 日志超时、问题未解决等场景自动提醒
+      - 并发控制: 同级任务不会同时执行
+      - 工作区列表优化: 当前项目优先显示
+    note: ""
+  - version: 1.0.0
+    requirement: XtepWorkspace 首个正式版本
+    conclusion: |-
+      - 树形任务结构: 支持无限层级嵌套
+      - 双节点类型: 规划节点分解任务，执行节点逐个完成
+      - 状态流转: pending → implementing → validating → completed
+      - 聚焦上下文: 执行时自动过滤无关信息
+      - 日志与问题追踪: 完整记录操作过程
+      - WebUI 可视化: 工作区列表、节点树、详情面板
+      - 项目级存储: 数据保存在项目内 `.xtep-workspace`
+    note: ""

package/dist/adapters/OutputAdapter.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 输出适配器
+ * 用于将 Service 层的完整输出转换为不同消费者（前端/AI）需要的格式
+ */
+import type { NodeListResult } from "../types/node.js";
+import type { WorkspaceListResult } from "../types/workspace.js";
+/**
+ * 简化版节点树项（AI 用）
+ * 只保留 id 和 title，用于节点查找和定位
+ */
+export interface LiteNodeTreeItem {
+    id: string;
+    title: string;
+    children?: LiteNodeTreeItem[];
+}
+/**
+ * 简化版节点列表结果（AI 用）
+ */
+export interface LiteNodeListResult {
+    tree: LiteNodeTreeItem;
+}
+/**
+ * 简化版工作区列表项（AI 用）
+ * 只保留 id, name, projectRoot
+ * status 仅在 filter="all" 时保留
+ */
+export interface LiteWorkspaceListItem {
+    id: string;
+    name: string;
+    projectRoot: string;
+    status?: string;
+}
+/**
+ * 简化版工作区列表结果（AI 用）
+ * - filter 非 "all" 时：顶层显示 filter 字段，各项不含 status
+ * - filter 为 "all" 时：无顶层 filter，各项包含 status
+ */
+export interface LiteWorkspaceListResult {
+    filter?: string;
+    workspaces: LiteWorkspaceListItem[];
+}
+/**
+ * 将完整节点列表结果转换为简化版
+ */
+export declare function simplifyNodeList(result: NodeListResult): LiteNodeListResult;
+/**
+ * 将完整工作区列表结果转换为简化版
+ * @param result 完整工作区列表
+ * @param filter 过滤条件（默认 "active"）
+ */
+export declare function simplifyWorkspaceList(result: WorkspaceListResult, filter?: "active" | "archived" | "all"): LiteWorkspaceListResult;
+/**
+ * 压缩 workspace_get 的 logMd（AI 用）
+ * - 截取最新 5 条
+ * - 简化格式：表格 → 列表
+ * - 省略 AI 操作者标注（只标注非 AI）
+ */
+export declare function compressWorkspaceLog(logMd: string): string;
+/**
+ * 输出适配器接口
+ * 定义各工具输出的转换方法
+ */
+export interface OutputAdapter {
+    /** 转换 node_list 输出 */
+    transformNodeList(result: NodeListResult): NodeListResult | LiteNodeListResult;
+    /** 转换 workspace_list 输出 */
+    transformWorkspaceList(result: WorkspaceListResult, filter?: "active" | "archived" | "all"): WorkspaceListResult | LiteWorkspaceListResult;
+    /** 转换 workspace_get 的 logMd */
+    transformWorkspaceGetLog(logMd: string): string;
+}
+/**
+ * 前端适配器（identity，原样返回）
+ */
+export declare const frontendAdapter: OutputAdapter;
+/**
+ * AI 适配器（简化格式）
+ */
+export declare const aiAdapter: OutputAdapter;
+//# sourceMappingURL=OutputAdapter.d.ts.map

package/dist/adapters/OutputAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OutputAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/OutputAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EAAE,mBAAmB,EAAgC,MAAM,uBAAuB,CAAC;AAI/F;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,qBAAqB,EAAE,CAAC;CACrC;AAoBD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,kBAAkB,CAI3E;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,mBAAmB,EAC3B,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,KAAK,GACrC,uBAAuB,CAwBzB;AAkCD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAmB1D;AAID;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,GAAG,kBAAkB,CAAC;IAC/E,2BAA2B;IAC3B,sBAAsB,CACpB,MAAM,EAAE,mBAAmB,EAC3B,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,KAAK,GACrC,mBAAmB,GAAG,uBAAuB,CAAC;IACjD,+BAA+B;IAC/B,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACjD;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,aAI7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,aAIvB,CAAC"}

package/dist/adapters/OutputAdapter.js

@@ -0,0 +1,124 @@
+/**
+ * 输出适配器
+ * 用于将 Service 层的完整输出转换为不同消费者（前端/AI）需要的格式
+ */
+// ========== 转换函数 ==========
+/**
+ * 将完整节点树转换为简化版
+ */
+function simplifyNodeTreeItem(item) {
+    const lite = {
+        id: item.id,
+        title: item.title,
+    };
+    if (item.children && item.children.length > 0) {
+        lite.children = item.children.map(simplifyNodeTreeItem);
+    }
+    return lite;
+}
+/**
+ * 将完整节点列表结果转换为简化版
+ */
+export function simplifyNodeList(result) {
+    return {
+        tree: simplifyNodeTreeItem(result.tree),
+    };
+}
+/**
+ * 将完整工作区列表结果转换为简化版
+ * @param result 完整工作区列表
+ * @param filter 过滤条件（默认 "active"）
+ */
+export function simplifyWorkspaceList(result, filter) {
+    const effectiveFilter = filter ?? "active";
+    if (effectiveFilter === "all") {
+        // all: 各项保留 status，无顶层 filter
+        return {
+            workspaces: result.workspaces.map(ws => ({
+                id: ws.id,
+                name: ws.name,
+                projectRoot: ws.projectRoot,
+                status: ws.status,
+            })),
+        };
+    }
+    else {
+        // active/archived: 顶层 filter 字段，各项不含 status
+        return {
+            filter: effectiveFilter,
+            workspaces: result.workspaces.map(ws => ({
+                id: ws.id,
+                name: ws.name,
+                projectRoot: ws.projectRoot,
+            })),
+        };
+    }
+}
+// ========== 日志压缩 ==========
+/**
+ * 解析日志表格
+ */
+function parseLogTable(content) {
+    if (!content || typeof content !== "string") {
+        return [];
+    }
+    const normalized = content.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+    const lines = normalized.split("\n");
+    const entries = [];
+    for (const line of lines) {
+        if (!line.startsWith("|"))
+            continue;
+        if (line.includes("时间") || line.includes("Time"))
+            continue;
+        if (/^\|[\s-:|]+\|$/.test(line))
+            continue;
+        const cells = line.split("|").map(c => c.trim()).filter(Boolean);
+        if (cells.length >= 3) {
+            entries.push({
+                time: cells[0] || "",
+                operator: cells[1],
+                event: cells[2] || "",
+            });
+        }
+    }
+    return entries;
+}
+/**
+ * 压缩 workspace_get 的 logMd（AI 用）
+ * - 截取最新 5 条
+ * - 简化格式：表格 → 列表
+ * - 省略 AI 操作者标注（只标注非 AI）
+ */
+export function compressWorkspaceLog(logMd) {
+    const MAX_LOG_ENTRIES = 5;
+    const logs = parseLogTable(logMd);
+    const recentLogs = logs.slice(-MAX_LOG_ENTRIES);
+    if (recentLogs.length === 0) {
+        return "";
+    }
+    const lines = recentLogs.map(log => {
+        const operator = log.operator !== "AI" ? `[${log.operator}] ` : "";
+        return `- [${log.time}] ${operator}${log.event}`;
+    });
+    if (logs.length > MAX_LOG_ENTRIES) {
+        lines.unshift(`（共 ${logs.length} 条，显示最新 ${MAX_LOG_ENTRIES} 条）`);
+    }
+    return lines.join("\n");
+}
+/**
+ * 前端适配器（identity，原样返回）
+ */
+export const frontendAdapter = {
+    transformNodeList: (result) => result,
+    transformWorkspaceList: (result) => result,
+    transformWorkspaceGetLog: (logMd) => logMd,
+};
+/**
+ * AI 适配器（简化格式）
+ */
+export const aiAdapter = {
+    transformNodeList: simplifyNodeList,
+    transformWorkspaceList: (result, filter) => simplifyWorkspaceList(result, filter),
+    transformWorkspaceGetLog: compressWorkspaceLog,
+};
+//# sourceMappingURL=OutputAdapter.js.map