closer-code 1.0.0

package/docs/EXPORT_COMMAND.md

@@ -0,0 +1,152 @@
+# /export 命令使用说明
+
+## 功能描述
+
+`/export` 命令用于将当前对话历史导出为文本文件，方便保存和分享对话内容。
+
+## 使用方法
+
+### 基本用法
+
+```
+/export <filename>
+```
+
+### 示例
+
+```bash
+# 导出对话到 my-conversation.txt
+/export my-conversation
+
+# 导出对话到 chat-2024-01-18.txt（会自动添加 .txt 扩展名）
+/export chat-2024-01-18
+
+# 如果文件名已包含 .txt 扩展名，则不会重复添加
+/export conversation.txt
+```
+
+## 导出格式
+
+导出的文本文件包含以下内容：
+
+```
+================================================================================
+Closer Code - Conversation Export
+================================================================================
+Export Date: 2024-01-18 14:30:00
+Total Messages: 15
+================================================================================
+
+[1] 👤 User
+--------------------------------------------------------------------------------
+你好，请帮我写一个 Python 脚本
+
+[2] 🤖 Assistant
+--------------------------------------------------------------------------------
+好的，我来帮你写一个 Python 脚本。请告诉我你需要什么功能...
+
+[3] 👤 User
+--------------------------------------------------------------------------------
+需要一个读取 CSV 文件的脚本
+
+...
+```
+
+## 特性
+
+- ✅ 自动添加 `.txt` 扩展名（如果未指定）
+- ✅ 包含导出日期和消息统计
+- ✅ 清晰的消息分隔符
+- ✅ 支持用户、助手、系统消息
+- ✅ 支持工具调用和结果显示
+- ✅ UTF-8 编码，支持中文
+
+## 注意事项
+
+1. 文件会保存在当前工作目录
+2. 如果文件已存在，会被覆盖
+3. 导出的是当前会话的所有对话历史
+4. 包括从历史记录中加载的旧对话
+
+## 完整命令列表
+
+```
+/clear - 清除对话历史
+/export <filename> - 导出对话到文本文件
+/plan <task> - 创建并执行任务计划
+/learn - 学习项目模式
+/status - 显示对话统计
+/help - 显示帮助信息
+```
+
+## 快捷键
+
+- `Ctrl+C` (双击) - 退出程序
+- `ESC` - 同双击 Ctrl+C
+- `↑/↓` - 滚动查看历史消息
+- `Page Up/Down` - 快速滚动
+- `Enter` - 回到底部
+
+## 示例场景
+
+### 场景1：保存重要的对话
+
+```
+你: /export api-design-discussion
+系统: ✅ Conversation exported to: api-design-discussion.txt
+```
+
+### 场景2：导出调试会话
+
+```
+你: /export debug-session-$(date +%Y%m%d)
+系统: ✅ Conversation exported to: debug-session-20240118.txt
+```
+
+### 场景3：备份对话历史
+
+```
+你: /export conversation-backup-before-clear
+系统: ✅ Conversation exported to: conversation-backup-before-clear.txt
+你: /clear
+系统: 🗑️ 清除对话历史...
+```
+
+## 技术细节
+
+### 实现位置
+
+- 命令处理：`src/closer-cli.jsx` 中的 `handleCommand` 函数
+- 导出逻辑：`exportConversation` 函数
+
+### 支持的消息类型
+
+- `user` - 用户消息（👤）
+- `assistant` - AI 助手消息（🤖）
+- `system` - 系统消息（ℹ️）
+- `error` - 错误消息（❌）
+
+### 复杂内容处理
+
+对于包含工具调用的消息，导出时会格式化为：
+
+```
+[Tool: bash]
+{
+  "command": "ls -la"
+}
+
+[Tool Result]
+total 16
+drwxr-xr-x  4 user  staff  128 Jan 18 14:30 .
+...
+```
+
+## 未来改进
+
+可能的增强功能：
+- 支持更多导出格式（Markdown、JSON、HTML）
+- 添加过滤选项（按日期、关键词）
+- 支持导出部分消息（指定范围）
+- 添加导出预览功能
+- 支持批量导出多个项目

package/docs/FILE_NAMING_IMPROVEMENT.md

@@ -0,0 +1,168 @@
+# 文件命名改进说明
+
+## 改进内容
+
+### 之前的问题
+只用哈希值命名文件，虽然保证了唯一性，但不便于人类查阅：
+
+```
+❌ 旧命名: 06aecb89a562f1a6038cca327538315e.json
+❌ 旧命名: e902bcc2a63d1efb2d3c879517a255a3.json
+```
+
+当你在 `~/.closer-code/history/` 目录下查看文件时，无法直接知道哪个文件对应哪个项目。
+
+### 改进后的方案
+在哈希值后面加上目录名，既保证唯一性又便于识别：
+
+```
+✅ 新命名: 06aecb89a562f1a6038cca327538315e-project-beta.json
+✅ 新命名: f5617862fb3ca8fbbc2f3ff26b106cf6-my-awesome-app.json
+✅ 新命名: aed557b877e451758c55c4d3f7306497-api-server.json
+```
+
+## 命名规则
+
+### 格式
+```
+{md5-hash}-{directory-name}.json
+{md5-hash}-{directory-name}.meta.json
+```
+
+### 组成部分
+
+1. **MD5哈希前缀** (32个字符)
+   - 基于完整项目路径生成
+   - 确保文件名唯一性
+   - 避免路径冲突
+
+2. **目录名后缀**
+   - 提取项目路径的最后一级目录名
+   - 便于人类识别和查阅
+   - 特殊字符自动处理
+
+3. **特殊字符处理**
+   - 非字母数字字符替换为下划线
+   - 例如：`data.processor` → `data_processor`
+
+## 实际示例
+
+### 示例1: 简单项目名
+```
+项目路径: /home/user/project-alpha
+文件名:   90e42e971156247007484e3a455f62ed-project-alpha.json
+```
+
+### 示例2: 带连字符的项目名
+```
+项目路径: /home/user/my-awesome-app
+文件名:   f5617862fb3ca8fbbc2f3ff26b106cf6-my-awesome-app.json
+```
+
+### 示例3: 带点号的项目名
+```
+项目路径: /home/user/data.processor
+文件名:   d8af9338aa986877bcea3aa9d4c1e915-data_processor.json
+```
+
+### 示例4: Windows路径
+```
+项目路径: S:\bld\opencode\closer_code
+文件名:   83545f14f3db2e01ee2669719bc705fe-closer_code.json
+```
+
+## 优势对比
+
+| 特性 | 旧方案 | 新方案 |
+|------|--------|--------|
+| 唯一性 | ✅ | ✅ |
+| 可读性 | ❌ | ✅ |
+| 可识别性 | ❌ | ✅ |
+| 特殊字符处理 | ✅ | ✅ |
+| 查阅便利性 | ❌ 需要查看元数据 | ✅ 直接从文件名识别 |
+
+## 使用场景
+
+### 场景1: 手动查看历史文件
+```bash
+# 列出历史目录
+ls ~/.closer-code/history/
+
+# 输出：
+# 06aecb89a562f1a6038cca327538315e-project-beta.json
+# f5617862fb3ca8fbbc2f3ff26b106cf6-my-awesome-app.json
+# aed557b877e451758c55c4d3f7306497-api-server.json
+
+# 现在可以直接看出每个文件对应的项目！
+```
+
+### 场景2: 备份特定项目历史
+```bash
+# 备份 my-awesome-app 项目
+cp ~/.closer-code/history/*-my-awesome-app.* ~/backup/
+
+# 旧方案需要先查看元数据才知道哪个文件是哪个项目
+```
+
+### 场景3: 清理特定项目历史
+```bash
+# 删除 api-server 项目历史
+rm ~/.closer-code/history/*-api-server.*
+```
+
+## 技术实现
+
+### 代码片段 (src/config.js)
+```javascript
+function getProjectHistoryPath(projectPath) {
+  const normalizedPath = path.normalize(projectPath);
+  const hash = crypto.createHash('md5').update(normalizedPath).digest('hex');
+  const dirName = path.basename(normalizedPath);
+  const cleanDirName = dirName.replace(/[^a-zA-Z0-9_-]/g, '_');
+  return path.join(HISTORY_DIR, `${hash}-${cleanDirName}.json`);
+}
+```
+
+### 关键点
+1. `path.basename()` - 提取最后一级目录名
+2. `replace(/[^a-zA-Z0-9_-]/g, '_')` - 清理特殊字符
+3. 保留哈希前缀 - 确保唯一性
+
+## 向后兼容
+
+### 旧文件处理
+如果你有旧版本的哈希文件（不带目录名），系统会：
+1. 继续读取旧文件（向后兼容）
+2. 新保存的文件使用新格式
+3. 建议运行迁移工具统一格式
+
+### 迁移建议
+```bash
+# 旧文件会继续工作
+# 新文件使用改进的命名
+# 无需立即迁移，可以逐步过渡
+```
+
+## 常见问题
+
+**Q: 为什么保留哈希值？**
+A: 哈希值确保唯一性，避免不同路径但相同目录名导致的冲突。
+
+**Q: 目录名太长怎么办？**
+A: 文件系统通常支持长文件名（255字符），目录名一般不会超过限制。
+
+**Q: 特殊字符会被如何处理？**
+A: 非字母数字字符（除了 `-` 和 `_`）会被替换为下划线。
+
+**Q: 如何查看完整的项目路径？**
+A: 查看 `.meta.json` 文件，其中包含完整的原始路径。
+
+## 总结
+
+这个改进在保持技术优势（唯一性、安全性）的同时，大大提升了用户体验（可读性、可识别性），是一个简单但有效的改进！
+
+**核心原则**：
+- ✅ 机器可读（哈希前缀）
+- ✅ 人类可读（目录名后缀）
+- ✅ 安全可靠（特殊字符处理）
+- ✅ 向后兼容（旧文件仍可用）

package/docs/GLOBAL_CONFIG.md

@@ -0,0 +1,128 @@
+# 全局配置功能说明
+
+## 功能概述
+
+Closer Code 现在支持全局行为规范配置，允许你在所有项目中共享统一的行为规范。
+
+## 配置文件位置
+
+### 全局配置
+- **路径**: `~/.closer-code/cloco.md`
+- **作用域**: 所有 Closer Code 项目
+- **优先级**: 低于项目级配置
+
+### 项目配置
+- **路径**: `./cloco.md`（项目根目录）
+- **作用域**: 当前项目
+- **优先级**: 高于全局配置
+
+## 工作原理
+
+当启动 Closer Code 时：
+
+1. **读取全局配置**（如果存在）
+   - 从 `~/.closer-code/cloco.md` 读取全局行为规范
+   - 显示：`✅ 已加载全局行为规范: ~/.closer-code/cloco.md`
+
+2. **读取项目配置**（如果存在）
+   - 从当前项目的 `./cloco.md` 读取项目特定规范
+   - 显示：`✅ 已加载项目行为规范: ./cloco.md`
+
+3. **构建系统提示词**
+   - 全局配置和项目配置都会被添加到系统提示词中
+   - 两者不会互相覆盖，而是共同生效
+   - 如果都不存在，使用默认行为规范
+
+## 配置示例
+
+### 全局配置示例 (`~/.closer-code/cloco.md`)
+
+```markdown
+# Closer Code - 全局行为规范
+
+## 编码风格
+- 使用 2 空格缩进
+- 优先使用 const/let，避免 var
+- 函数名使用驼峰命名
+
+## 工具使用偏好
+- 优先使用 bash 工具执行命令
+- 使用 searchFiles 查找文件
+- 使用 readFile 查看文件内容
+
+## 代码审查要点
+- 检查安全漏洞
+- 确保错误处理完善
+- 验证边界条件
+```
+
+### 项目配置示例 (`./cloco.md`)
+
+```markdown
+# 项目特定规范
+
+## 架构约定
+- 使用 MVC 模式组织代码
+- 数据库操作使用 ORM
+
+## 工作流程
+- 提交代码前必须运行测试
+- 使用 git flow 分支管理
+
+## 团队规范
+- 代码审查必须由至少 2 人完成
+- 使用中文编写注释
+```
+
+## 使用建议
+
+### 适合放在全局配置的内容
+- 通用的编码风格
+- 代码审查标准
+- 工具使用偏好
+- 响应格式要求
+- 安全最佳实践
+
+### 适合放在项目配置的内容
+- 项目特定的架构约定
+- 特定库的使用规范
+- 项目内的工作流程
+- 团队协作规范
+- 项目特定的业务规则
+
+## 测试验证
+
+运行测试脚本验证配置是否生效：
+
+```bash
+node test/test-global-cloco.js
+```
+
+测试会检查：
+- ✅ 全局配置文件是否存在
+- ✅ 项目配置文件是否存在
+- ✅ 配置是否正确加载
+- ✅ 系统提示词是否包含配置内容
+
+## 注意事项
+
+1. **配置文件支持任何语言**（中文、英文等）
+2. **配置实时生效**，无需重启
+3. **如果配置文件不存在**，会使用默认行为（不会报错）
+4. **项目级和全局级配置会同时生效**（不会覆盖）
+5. **配置文件必须是 Markdown 格式**
+
+## 升级说明
+
+如果你之前使用项目级的 `cloco.md`，升级后：
+- ✅ 项目配置继续有效
+- ✅ 可以添加全局配置
+- ✅ 两者会同时生效
+- ✅ 无需修改现有配置
+
+## 相关文件
+
+- 全局配置: `~/.closer-code/cloco.md`
+- 全局说明: `~/.closer-code/README.md`
+- 项目配置: `./cloco.md`
+- 测试脚本: `test/test-global-cloco.js`

package/docs/LONG_MESSAGE_DISPLAY_FIX.md

@@ -0,0 +1,202 @@
+# 长消息显示改进
+
+## 问题描述
+
+之前 Conversation 区域对长文本有硬编码的限制：
+- 最多显示 10 行
+- 最多显示 1000 个字符
+- 超过限制会显示 "... (truncated)" 提示
+
+这导致：
+- 长代码被截断
+- 长日志不完整
+- AI 的详细回复被截断
+- 用户需要多次要求 AI "继续显示"
+
+## 解决方案
+
+**方案1：完全移除限制** ✅ 已实施
+
+### 代码变更
+
+删除了 `MessageItem` 组件中的所有限制逻辑：
+
+```javascript
+// 之前（有限制）
+function MessageItem({ message }) {
+  // ...
+  const maxLines = 10;      // ❌ 硬编码限制
+  const maxChars = 1000;    // ❌ 硬编码限制
+
+  let displayContent = content;
+  let isTruncated = false;
+
+  if (content.length > maxChars) {
+    displayContent = content.slice(0, maxChars);
+    isTruncated = true;
+  }
+
+  if (displayLines.length > maxLines) {
+    displayContent = displayLines.slice(0, maxLines).join('\n');
+    isTruncated = true;
+  }
+
+  return (
+    <Box>
+      <Text>{displayContent}</Text>
+      {isTruncated && <Text>... (truncated)</Text>}
+    </Box>
+  );
+}
+
+// 现在（无限制）
+function MessageItem({ message }) {
+  // ...
+  // 直接显示完整内容
+  return (
+    <Box>
+      <Text>{content}</Text>
+    </Box>
+  );
+}
+```
+
+### 优点
+
+✅ **完整性**
+- 100% 显示所有内容
+- 不会丢失任何信息
+- 代码、日志、长回复都能完整查看
+
+✅ **简单性**
+- 代码更简洁
+- 无需额外逻辑
+- 易于维护
+
+✅ **用户体验**
+- 用户已习惯滚动（上下箭头）
+- PageUp/PageDown 快速导航
+- Enter 回到底部
+
+✅ **可预测性**
+- 行为一致
+- 无隐藏内容
+- 不会有"为什么被截断"的困惑
+
+### 滚动功能
+
+用户可以使用以下键盘快捷键滚动查看长消息：
+
+- **↑ (上箭头)**: 向上滚动 5 行
+- **↓ (下箭头)**: 向下滚动 5 行
+- **PageUp**: 向上滚动 10 行
+- **PageDown**: 向下滚动 10 行
+- **Enter**: 快速回到底部
+
+当向上滚动时，会显示提示：
+```
+↑ Scrolled up (20 lines hidden) - Press ↓/Enter to return
+```
+
+## 测试
+
+### 测试文件
+
+运行测试生成超长消息：
+```bash
+node test/test-long-message.js
+```
+
+这会生成一个包含：
+- 100 行文本
+- 5000 字符的长字符串
+- 50 行代码块
+- 混合内容
+
+### 手动测试
+
+1. 启动 `cloco`
+2. 让 AI 生成大量内容，例如：
+   ```
+   生成一个包含 100 个方法的 JavaScript 类
+   ```
+3. 检查是否完整显示
+4. 使用上下箭头滚动查看
+5. 确认没有 "... (truncated)" 提示
+
+## 性能考虑
+
+### 渲染性能
+
+- Ink 使用虚拟 DOM，差异更新
+- 超长文本渲染时间通常 < 100ms
+- 对于极端情况（1000+ 行），可能稍慢但仍可接受
+
+### 内存占用
+
+- 每条消息完整存储在内存中
+- 对于超长对话，可能占用较多内存
+- 但现代计算机通常有足够内存
+
+### 优化建议（如果需要）
+
+如果未来发现性能问题，可以考虑：
+
+1. **虚拟滚动**：只渲染可见部分
+2. **分页显示**：将超长消息分页
+3. **懒加载**：滚动到时才加载
+
+但目前不需要这些优化。
+
+## 未来增强
+
+虽然当前方案已经很好，但未来可以考虑：
+
+### 方案4：智能截断 + 展开/收起
+
+```javascript
+function MessageItem({ message }) {
+  const [isExpanded, setIsExpanded] = useState(false);
+
+  const THRESHOLD_LINES = 50;
+  const lines = content.split('\n');
+
+  const shouldTruncate = !isExpanded && lines.length > THRESHOLD_LINES;
+  const displayContent = shouldTruncate
+    ? lines.slice(0, THRESHOLD_LINES).join('\n')
+    : content;
+
+  return (
+    <Box>
+      <Text>{displayContent}</Text>
+      {lines.length > THRESHOLD_LINES && (
+        <Text>
+          {isExpanded
+            ? `[收起 - 按 Space] (${lines.length} 行)`
+            : `[展开 - 按 Space] (还有 ${lines.length - THRESHOLD_LINES} 行)`}
+        </Text>
+      )}
+    </Box>
+  );
+}
+```
+
+但这需要：
+- 状态管理
+- 键盘事件处理
+- 焦点管理
+- 用户教育
+
+目前不需要这种复杂度。
+
+## 总结
+
+**采用方案1（完全移除限制）是正确的决定**，因为：
+
+1. ✅ 简单有效，立即解决问题
+2. ✅ 用户已有滚动习惯
+3. ✅ 不会丢失任何信息
+4. ✅ 代码更简洁
+5. ✅ 为未来增强留出空间
+
+这是一个"少即是多"的典型案例。