jinzd-ai-cli 0.1.37 → 0.1.38

package/CLAUDE.md

@@ -42,6 +42,7 @@ src/
 ├── repl/
 │   ├── repl.ts                     # 主 REPL 循环（MAX_TOOL_ROUNDS=20，handleChatWithTools agentic loop）
 │   ├── renderer.ts                 # 终端输出（renderStream / renderResponse 均不加前置 \n）
+│   ├── theme.ts                    # 集中式主题系统（dark/light/custom 主题 + 语义色槽 Proxy 导出）
 │   ├── dev-state.ts                # 开发状态交接（provider/model 切换时快照生成、save/load/clear）
 │   ├── setup-wizard.ts             # @inquirer/prompts 首次运行交互式设置
 │   └── commands/
@@ -333,6 +334,10 @@ const stdinLines = Array.isArray(rawStdin) ? rawStdin.map(String)
 - [x] **Checkpointing**（2026-02-28）：`/checkpoint save/restore/list/delete`，检查点元数据随 session JSON 持久化
 - [x] **`/review` 代码审查**（2026-02-28）：读取 git diff + 上下文，AI 生成结构化审查意见（`--staged`/`--detailed`）
 - [x] **Custom Commands**（2026-02-28）：`~/.aicli/commands/*.md` 用户自定义命令，YAML frontmatter + `{{input}}/{{git-diff}}/{{git-context}}/{{file:path}}` 模板变量
+- [x] **项目级 `.mcp.json`**（2026-03-05）：项目根目录 `.mcp.json` 自动发现，与全局 `config.json` 的 `mcpServers` 合并（项目覆盖同名），`/mcp` 显示 `[global]`/`[project]` 来源标签
+- [x] **`--resume <id>` 启动参数**（2026-03-05）：命令行直接恢复指定会话（前缀匹配），找不到时显示最近 5 个 session 提示
+- [x] **Word wrap 配置**（2026-03-05）：`config.ui.wordWrap`，0=自动（终端宽度），>0=固定列宽。ANSI 转义码感知折行
+- [x] **主题/颜色自定义**（2026-03-05）：`src/repl/theme.ts` 集中式主题系统，dark/light/custom 三主题 + 10 语义色槽 + Proxy 全局导出
 
 ## 已知待改进项
 
@@ -343,6 +348,79 @@ const stdinLines = Array.isArray(rawStdin) ? rawStdin.map(String)
 - [x] **web_fetch DNS 解析时 SSRF 防护**（v0.1.25）：新增 `resolveAndCheck()` 函数，用 `dns.promises.lookup()` 预解析域名，检查结果 IP 是否为私有地址。初始 URL 和 redirect 目标均校验。
 - [ ] **`persistentCwd` 全局状态**：bash 工具的当前工作目录是模块级全局变量，多 session 并发时可能串扰。现阶段单 session REPL 无影响，GUI 多会话扩展时需重构为 per-session 状态。
 
+## 本轮开发完成记录（2026-03-05，v0.1.36 → v0.1.37）
+
+### P2 四项功能全部实现
+
+**Feature 1：项目级 `.mcp.json`**（`src/repl/repl.ts` + `src/repl/commands/index.ts` + `src/core/constants.ts`）
+- `src/core/constants.ts`：新增 `MCP_PROJECT_CONFIG_NAME = '.mcp.json'`
+- `src/repl/repl.ts`：
+  - 新增私有属性 `mcpServerSources = new Map<string, 'global' | 'project'>()`
+  - 新增 `loadProjectMcpConfig()` 方法：`getGitRoot(cwd)` 查找项目根 → 读取 `<root>/.mcp.json` → 基础校验（每个 server 须有 `command` 字段）→ 解析失败 stderr 警告不中断启动
+  - `start()` 中 MCP 初始化重构：先获取全局 `mcpServers`，再获取项目 `.mcp.json`，合并（项目覆盖全局同名），记录来源到 `mcpServerSources`
+  - CommandContext 注入 `getMcpServerSource`
+- `src/repl/commands/index.ts`：`/mcp` 命令显示每个服务器的 `[global]`/`[project]` 来源标签
+
+**Feature 2：`--resume <id>` 启动参数**（`src/index.ts` + `src/repl/repl.ts`）
+- `src/index.ts`：新增 `--resume <id>` CLI 选项 + `startRepl` 参数传入
+- `src/repl/repl.ts`：
+  - constructor options 扩展 `resumeSessionId?: string`
+  - `start()` 有 `resumeSessionId` 时：`listSessions()` 前缀匹配 → 未找到显示最近 5 个 session + exit(1) → 找到则 `loadSession()` 恢复
+  - welcome 后显示 `📂 Resumed session: <id> (<N> messages, "<title>")`
+
+**Feature 3：Word wrap 配置**（`src/config/schema.ts` + `src/repl/renderer.ts` + `src/repl/repl.ts`）
+- `src/config/schema.ts`：`ui` 对象新增 `wordWrap: z.number().int().min(0).default(0)`（0=自动，>0=固定列宽）
+- `src/repl/renderer.ts`：
+  - 新增 `stripAnsi(s: string): string` — 去除 ANSI 转义码（正则匹配 ESC 序列）
+  - 新增 `wrapText(text: string, width: number | undefined): string` — 逐行处理，按单词边界折行，ANSI 码不计入宽度
+  - Renderer constructor 扩展 `options?: { wrapWidth?: number }`
+  - `renderResponse()` 对内容应用 `wrapText()`（流式模式不折行，由终端自然处理）
+
+**Feature 4：主题/颜色自定义**（`src/repl/theme.ts` + `src/config/schema.ts` + 多文件迁移）
+- `src/config/schema.ts`：`ui` 对象新增 `theme: z.enum(['dark', 'light', 'custom']).default('dark')` + `colors` 对象（10 个可选色槽）
+- **新文件** `src/repl/theme.ts`：
+  - `ThemeColors` 接口：10 个语义色槽（prompt/info/warning/error/success/dim/accent/toolCall/toolResult/heading）→ `ChalkInstance`
+  - `DARK_THEME`：精确匹配 v0.1.36 硬编码颜色（green/cyan/yellow/red/dim/magenta 等），确保零变化升级
+  - `LIGHT_THEME`：浅色终端优化（blue/blueBright/gray 等）
+  - `resolveColor(name: string)`：支持 chalk 颜色名 + `#hex` + `bold.cyan` 组合样式
+  - `buildCustomTheme(base, overrides)`：以 base 主题为底 + 自定义覆盖
+  - `initTheme(themeId, customColors?)`：设置全局主题
+  - `theme`：Proxy 导出，始终指向当前活跃主题
+- 迁移覆盖：
+  - `src/repl/renderer.ts`：`printWelcome`（heading/prompt/dim）、`printPrompt`（prompt）、`renderStream`（accent）、`renderResponse`（accent）、`renderError`（error）、`printInfo`（warning）、`printSuccess`（success）
+  - `src/tools/executor.ts`：`printToolCall`（toolCall/accent/dim）、`printToolResult`（error/toolResult/warning）
+  - `src/repl/repl.ts`：constructor 中调用 `initTheme()`，传入 `wrapWidth` 给 Renderer
+
+### 版本与收尾
+- `src/core/constants.ts`：VERSION `0.1.36` → `0.1.37`
+- `package.json`：version 同步
+- `src/repl/renderer.ts`：`/about` 新增 4 条特性条目（项目级 .mcp.json / --resume / Word wrap / 主题系统）
+- 构建验证：`npm run build` 零错误
+- 发布：`npm publish` → `jinzd-ai-cli@0.1.37`
+
+### 本轮变更文件汇总
+
+| 文件 | 变更类型 | 说明 |
+|------|---------|------|
+| `src/core/constants.ts` | 修改 | VERSION 0.1.36 → 0.1.37，新增 MCP_PROJECT_CONFIG_NAME |
+| `src/config/schema.ts` | 修改 | `ui.wordWrap` + `ui.theme` + `ui.colors` 三个新字段 |
+| `src/repl/theme.ts` | 新增 | 集中式主题系统（ThemeColors + DARK/LIGHT + Proxy） |
+| `src/repl/repl.ts` | 修改 | .mcp.json 加载 + --resume + theme 初始化 + mcpServerSources |
+| `src/repl/renderer.ts` | 修改 | stripAnsi/wrapText 辅助函数 + theme 迁移 + /about 更新 |
+| `src/tools/executor.ts` | 修改 | theme 迁移（printToolCall/printToolResult） |
+| `src/repl/commands/index.ts` | 修改 | getMcpServerSource + /mcp 来源标签 |
+| `src/index.ts` | 修改 | --resume CLI 选项 |
+| `package.json` | 修改 | version 0.1.36 → 0.1.37 |
+
+### 下一步建议
+1. **Extended Thinking**：Claude 3.7 深度推理模式集成
+2. **theme 迁移扩展**：`commands/index.ts` 中 ~115 个 chalk 调用增量迁移为 theme 调用
+3. **L1 低危**：`run-tests.ts` 的 `JSON.parse(package.json)` 细粒度错误处理
+4. **IDE 集成**：VS Code 扩展（架构已准备就绪）
+5. **OAuth/浏览器登录**：无需手动填 API Key
+
+---
+
 ## 本轮开发完成记录（2026-03-05，v0.1.34 → v0.1.36）
 
 ### v0.1.35 — P0 功能缺口 + P1 前三项
@@ -423,10 +501,10 @@ const stdinLines = Array.isArray(rawStdin) ? rawStdin.map(String)
 | `USAGE.md` | 新增 | 21 章节完整用户使用说明文档 |
 
 ### 下一步建议（P2 优先）
-1. **项目级 `.mcp.json`**：项目根目录独立 MCP 配置，优先全局 config
-2. **`--resume <id>` 启动参数**：命令行直接恢复指定会话（`aicli --resume abc12345`）
-3. **Word wrap 配置**：终端输出折行宽度可配置（`config.ui.wordWrap`）
-4. **主题/颜色自定义**：dark/light/custom 主题支持
+1. ~~**项目级 `.mcp.json`**~~：✅ 已在 v0.1.37 实现
+2. ~~**`--resume <id>` 启动参数**~~：✅ 已在 v0.1.37 实现
+3. ~~**Word wrap 配置**~~：✅ 已在 v0.1.37 实现
+4. ~~**主题/颜色自定义**~~：✅ 已在 v0.1.37 实现
 5. **L1 低危**：`run-tests.ts` 的 `JSON.parse(package.json)` 细粒度错误处理
 
 ---
@@ -1106,6 +1184,8 @@ const stdinLines = Array.isArray(rawStdin) ? rawStdin.map(String)
 - Dev State 开发状态交接
 - Agent Skills 系统
 - 企业级权限规则 + Hooks 系统
+- 主题/颜色自定义系统（dark/light/custom + 10 语义色槽）
+- 项目级 MCP 配置（`.mcp.json` + 全局合并 + 来源追踪）
 
 ### ❌ 缺失功能路线图（新增）
 
@@ -1124,11 +1204,11 @@ const stdinLines = Array.isArray(rawStdin) ? rawStdin.map(String)
 - [x] **`--allowed-tools` / `--blocked-tools` 启动参数**（v0.1.35）：启动时白名单/黑名单限制 AI 可用工具
 - [x] **流式 JSON 输出**（v0.1.36）：`--output-format streaming-json`，NDJSON 每 chunk 一行 `{"type":"delta","text":"..."}` + 最终 `{"type":"done",...}`
 
-#### P2 — 体验增强
-- [ ] **项目级 `.mcp.json`**：项目根目录独立 MCP 配置，优先全局 config
+#### P2 — 体验增强（v0.1.37 完成 4 项）
+- [x] **项目级 `.mcp.json`**（v0.1.37）：项目根目录 `.mcp.json` 自动发现，与全局合并（项目覆盖同名），`/mcp` 显示来源标签
+- [x] **`--resume <id>` 启动参数**（v0.1.37）：命令行直接恢复指定会话（前缀匹配），找不到时显示最近 5 个 session
+- [x] **Word wrap 配置**（v0.1.37）：`config.ui.wordWrap`，ANSI 转义码感知折行
+- [x] **主题/颜色自定义**（v0.1.37）：dark/light/custom 三主题 + 10 语义色槽 + Proxy 全局导出
 - [ ] **IDE 集成**：VS Code / JetBrains 扩展（架构已准备就绪）
 - [ ] **OAuth/浏览器登录**：无需手动填 API Key
-- [ ] **`--resume <id>` 启动参数**：命令行直接恢复指定会话
-- [ ] **Extended Thinking**：Claude 3.7 深度推理模式集成
-- [ ] **Word wrap 配置**：终端输出折行宽度可配置
-- [ ] **主题/颜色自定义**：dark/light/custom 主题
+- [ ] **Extended Thinking**：Claude 深度推理模式集成

package/dist/{chunk-54GLHKXV.js → chunk-JLT4LDJH.js}

@@ -8,7 +8,7 @@ import { platform } from "os";
 import chalk from "chalk";
 
 // src/core/constants.ts
-var VERSION = "0.1.37";
+var VERSION = "0.1.38";
 var APP_NAME = "ai-cli";
 var CONFIG_DIR_NAME = ".aicli";
 var CONFIG_FILE_NAME = "config.json";