⏺ 项目需求澄清报告

  项目概述

  项目名称：ls-plus (推荐)项目目标：创建一个增强型目录查看工具，在 ls 命令基础上添加项目描述显示功能

  功能需求

  1. 核心显示功能

  - 基础模式 (ls)：描述显示在项目目录名下方
  - 详细模式 (ls -l, ls -la 等)：描述显示在项目目录名右侧
  - 目标对象：仅对目录显示描述，文件不处理
  - 无描述处理：没有描述的项目不显示任何额外信息

  2. 描述管理功能

  - 添加方式：支持命令行参数和交互式两种方式
  - 管理操作：添加、编辑、删除项目描述
  - 存储位置：全局配置文件（如 ~/.project_descriptions.json）

  3. 显示控制

  - 开关控制：提供开关来控制描述的显示/隐藏
  - 长文本处理：超长描述显示省略号 (...)
  - 兼容性：作为 ls 的补充命令存在，不替代原生 ls

  技术规格

  存储格式

  {
    "/path/to/project": "项目描述信息",
    "/another/path": "另一个项目描述"
  }

  命令接口设计

  - 查看：lsp 或 ls-describe
  - 管理：lsp add <path> <description>
  - 编辑：lsp edit <path>
  - 删除：lsp remove <path>
  - 开关：lsp --no-desc 或配置选项

  显示效果示例

  # 基础模式
  $ lsp
  project1/
    └─ Vue.js前端项目
  project2/
  node_modules/

  # 详细模式  
  $ lsp -l
  drwxr-xr-x  5 user  staff  160 Jan  1 12:00 project1/     # Vue.js前端项目
  drwxr-xr-x  3 user  staff   96 Jan  1 12:00 project2/     # React后端API
  drwxr-xr-x 10 user  staff  320 Jan  1 12:00 node_modules/

  用户体验目标

  1. 直观性：快速识别各项目用途
  2. 便捷性：保持 ls 使用习惯
  3. 灵活性：支持各种 ls 参数组合
  4. 可控性：可开关描述显示功能
