Merge branch 'main' into feature/mcp-refactor

Author: hqwlkj

.deepcode/AGENTS.md

@@ -13,7 +13,9 @@ src/
 │   ├── App.tsx          # Root Ink component — state, routing, session orchestration
 │   ├── PromptInput.tsx  # Multi-line input with slash commands, image paste, skills
 │   ├── MessageView.tsx  # Renders assistant/tool messages with markdown
+│   ├── DropdownMenu.tsx # Reusable dropdown for skill/model selection
 │   ├── SessionList.tsx  # Session picker for /resume
+│   ├── promptUndoRedo.ts # Ctrl+- undo / Ctrl+Shift+- redo for prompt input
 │   └── ...
 ├── mcp/
 │   ├── mcp-client.ts    # MCP client — JSON-RPC communication with MCP servers
@@ -22,7 +24,7 @@ src/
 │   ├── file-utils.ts    # File read/write with encoding and diff preview
 │   ├── shell-utils.ts   # Shell path resolution (Git Bash, zsh, bash)
 │   ├── state.ts         # In-memory file state and snippet tracking
-│   └── runtime.ts       # Tool validation runtime helpers (executeValidatedTool, semanticBoolean)
+│   └── runtime.ts       # Tool validation runtime helpers
 ├── tools/
 │   ├── executor.ts      # ToolExecutor — dispatches tool calls to handlers
 │   ├── bash-handler.ts  # Executes shell commands
@@ -32,9 +34,10 @@ src/
 │   ├── web-search-handler.ts # Web search tool
 │   └── ask-user-question-handler.ts # Interactive user prompts
 ├── tests/               # Test suite — one *.test.ts per module
-docs/
+templates/
 ├── tools/               # Tool descriptions fed to the LLM
 ├── prompts/             # EJS templates (e.g., init_command.md.ejs)
+docs/                    # User-facing documentation
 dist/                    # Bundled CLI output (gitignored)
 ```
 
@@ -87,7 +90,8 @@ Run the CLI locally for manual testing: `node dist/cli.js` (after `npm run bundl
 - `fix:` — bug fix (e.g., `fix(ui): redraw cleanly after terminal resize`)
 - `chore:` — tooling, deps, hooks (e.g., `chore: add husky + lint-staged`)
 - `refactor:` — code restructuring (e.g., `refactor(ui): optimize App hooks`)
-- `style:` — formatting-only changes
+- `style:` — formatting-only changes (e.g., `style: adjust the tree structure symbols`)
+- `docs:` — documentation (e.g., `docs: add MCP configuration guide`)
 
 **Pull requests** should include:
 - A clear description of what changed and why
@@ -100,7 +104,7 @@ Run the CLI locally for manual testing: `node dist/cli.js` (after `npm run bundl
 
 The CLI renders a terminal UI using [Ink](https://github.com/vadimdemedes/ink) (React for terminals). `SessionManager` drives the LLM interaction loop: it builds system prompts, sends user messages with optional skills/images, streams responses, executes tool calls via `ToolExecutor`, and compacts context when token thresholds are exceeded (512K for DeepSeek V4 models, 128K for others).
 
-Six tools are available to the LLM: `bash`, `read`, `write`, `edit`, `AskUserQuestion`, and `WebSearch`. Tool definitions are registered in `src/tools/executor.ts` and described to the LLM via `src/prompt.ts` and `docs/tools/`.
+Six tools are available to the LLM: `bash`, `read`, `write`, `edit`, `AskUserQuestion`, and `WebSearch`. Tool definitions are registered in `src/tools/executor.ts` and described to the LLM via `src/prompt.ts` and `templates/tools/`.
 
 ## Agent-Specific Instructions
 

.lintstagedrc

@@ -1,5 +1,5 @@
 {
-  "*.{ts,tsx,js,mjs,cjs,ejs,jsx}": [
+  "*.{ts,tsx,js,mjs,cjs,jsx}": [
     "eslint --fix",
     "prettier --write"
   ],

AGENTS.md

@@ -0,0 +1,35 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+
+- `src/` contains the TypeScript CLI implementation, with tool handlers in `src/tools/`, MCP integration in `src/mcp/`, UI components in `src/ui/`, and shared helpers in `src/common/`.
+- `src/tests/` contains Node test files named `*.test.ts`.
+- `templates/` contains runtime prompt assets: `templates/prompts/` for EJS prompt templates and `templates/tools/` for tool instruction Markdown loaded into the system prompt.
+- `docs/` is reserved for user-facing documentation such as configuration and MCP guides.
+- `resources/` stores static images used by the documentation or UI.
+
+## Build, Test, and Development Commands
+
+- `npm test` runs all test files with `tsx --test`.
+- `npm run test:single -- src/tests/<name>.test.ts` runs one test file.
+- `npm run typecheck` verifies TypeScript types without emitting files.
+- `npm run lint` checks ESLint rules for `src/`.
+- `npm run build` runs checks, bundles `src/cli.tsx` to `dist/cli.js`, and marks the bundle executable.
+
+## Coding Style & Naming Conventions
+
+- Use TypeScript ES modules and keep imports explicit.
+- Prefer small, focused functions; keep filesystem path construction centralized when a path is reused.
+- Use two-space indentation and Prettier-compatible formatting.
+- Respond in standard technical English. Avoid nonstandard phrasing and corporate jargon.
+
+## Testing Guidelines
+
+- Add or update tests in `src/tests/` when changing command behavior, prompt rendering, session flow, tools, or settings.
+- Prefer Node's built-in `node:test` and `node:assert/strict` APIs, matching the existing tests.
+- Keep tests deterministic by using temporary directories and mocked network calls where needed.
+
+## Commit & Pull Request Guidelines
+
+- Keep commits focused on a single change and use concise, imperative commit messages.
+- In pull requests, describe the behavior change, list verification commands, and note any packaging or template path changes.

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@vegamo/deepcode-cli",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "description": "Deep Code CLI - Vibe coding for the deepseek-v4 model in your terminal",
   "license": "MIT",
   "type": "module",
@@ -15,8 +15,8 @@
   "main": "./dist/cli.js",
   "files": [
     "dist/cli.js",
-    "docs/tools/**",
-    "docs/prompts/**",
+    "templates/tools/**",
+    "templates/prompts/**",
     "README.md",
     "LICENSE"
   ],

package.json

@@ -0,0 +1,16 @@
+export const DEEPSEEK_V4_MODELS = new Set(["deepseek-v4-flash", "deepseek-v4-pro"]);
+
+export const NON_MULTIMODAL_MODELS = new Set([
+  "deepseek-v4-pro",
+  "deepseek-v4-flash",
+  "deepseek-chat",
+  "deepseek-reasoner",
+]);
+
+export function defaultsToThinkingMode(model: string): boolean {
+  return DEEPSEEK_V4_MODELS.has(model);
+}
+
+export function supportsMultimodal(model: string): boolean {
+  return !NON_MULTIMODAL_MODELS.has(model.trim());
+}

src/common/model-capabilities.ts

@@ -3,8 +3,10 @@ import * as fs from "fs";
 import * as os from "os";
 import * as path from "path";
 import { fileURLToPath } from "url";
+import ejs from "ejs";
 import type { SessionMessage } from "./session";
 import { findGitBashPath, resolveShellPath } from "./common/shell-utils";
+import { supportsMultimodal } from "./common/model-capabilities";
 
 export const AGENT_DRIFT_GUARD_SKILL = `
 ---
@@ -248,23 +250,28 @@ const SYSTEM_PROMPT_BASE = `你是名叫Deep Code的交互式CLI工具，帮助
 重要：严禁编造任何非编程相关的 URL。对于编程链接，仅限使用：1) 用户提供的上下文；2) 你确定的官方文档主域名。在输出前，必须自查该链接是否存在于你的上下文记忆中；若不存在，请明确说明无法提供。`;
 
 type PromptToolOptions = {
+  model?: string;
   webSearchEnabled?: boolean;
 };
 
-function readToolDocs(extensionRoot: string, _options: PromptToolOptions = {}): string {
-  const toolsDir = path.join(extensionRoot, "docs", "tools");
+function readToolDocs(extensionRoot: string, options: PromptToolOptions = {}): string {
+  const toolsDir = path.join(extensionRoot, "templates", "tools");
   if (!fs.existsSync(toolsDir)) {
     return "";
   }
 
   const entries = fs.readdirSync(toolsDir);
   const docs = entries
-    .filter((entry) => entry.endsWith(".md"))
+    .filter((entry) => entry.endsWith(".md") || entry.endsWith(".md.ejs"))
     .sort()
     .map((entry) => {
       const fullPath = path.join(toolsDir, entry);
       try {
-        return fs.readFileSync(fullPath, "utf8").trim();
+        const template = fs.readFileSync(fullPath, "utf8");
+        const content = entry.endsWith(".ejs")
+          ? ejs.render(template, { supportsMultimodal: supportsMultimodal(options.model ?? "") })
+          : template;
+        return content.trim();
       } catch {
         return "";
       }
@@ -274,10 +281,14 @@ function readToolDocs(extensionRoot: string, _options: PromptToolOptions = {}):
   return docs.join("\n\n");
 }
 
+function getCurrentDatePrompt(date = new Date()): string {
+  return `今天是${date.getFullYear()}年${date.getMonth() + 1}月${date.getDate()}日。随着对话的进行，时间在流逝。`;
+}
+
 export function getSystemPrompt(projectRoot: string, options: PromptToolOptions = {}): string {
   const toolDocs = readToolDocs(getExtensionRoot(), options);
   const basePrompt = toolDocs ? `${SYSTEM_PROMPT_BASE}\n\n# Available Tools\n\n${toolDocs}` : SYSTEM_PROMPT_BASE;
-  return `${basePrompt}\n\n${getRuntimeContext(projectRoot)}`;
+  return `${basePrompt}\n\n${getCurrentDatePrompt()}\n\n${getRuntimeContext(projectRoot)}`;
 }
 
 export function getCompactPrompt(sessionMessages: SessionMessage[]): string {
@@ -310,7 +321,6 @@ function getRuntimeContext(projectRoot: string): string {
     ...shellModeOpts,
     ...runtimeVersions,
     "command installed": {
-      "ast-grep": checkToolInstalled("ast-grep"),
       ripgrep: checkToolInstalled("rg"),
       jq: checkToolInstalled("jq"),
     },