deepccc 0.1.13 → 0.1.14

package/dist/index.d.ts

@@ -5,6 +5,19 @@
  */
 import { type PermissionMode, type PermissionResolver } from "./permissions.js";
 export declare const DEFAULT_COMPACTION_TIMEOUT_MS: number;
+/**
+ * 各操作系统特有的命令行指引（文本资产，维护在 os-prompts/ 目录，而非硬编码）：
+ *
+ * - 内置文件：包内 os-prompts/<platform>.md（win32/darwin/linux），随 npm 包分发；
+ * - 用户覆盖：~/.deepccc/prompts/<platform>.md 存在时完全替代内置内容（可自定义）。
+ *
+ * 文件内容自带标题（如 "## Windows Command-Line Notes"），读取后 trim 直接作为
+ * 一个段落注入固定规则区（项目指令之前）。未知平台或文件缺失时返回空字符串。
+ */
+export declare function loadPlatformCommandPrompt(platform?: string, dirs?: {
+    builtinDir?: string;
+    userDir?: string;
+}): string;
 export interface ChatSessionConfig {
     /** OpenAI-compatible service base URL. Defaults to DEEPCCC_BASE_URL/config. */
     baseURL?: string;

package/dist/index.js

@@ -5,8 +5,10 @@
  */
 import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
 import { generateText, isLoopFinished, stepCountIs, streamText } from "ai";
-import { readFileSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
 import { join } from "node:path";
+import { fileURLToPath } from "node:url";
 import { config as appConfig, RAW_STREAM_LOGS_DIR } from "./config.js";
 import { createRawStreamLog, } from "./raw-stream-log.js";
 import { buildPersistedAssistantMessage, buildSummaryPrompt, BuiltinContextManager, defaultBuiltinSessionId, } from "./context.js";
@@ -97,22 +99,45 @@ function buildRuntimeWorkspacePrompt(cwd) {
     ].join("\n");
 }
 /**
- * Windows 专属命令行指引（仅 win32 注入）：cmd.exe 的引号语义与 bash 不同，
- * 模型按 bash 习惯写命令时会被 cmd 拆坏（引号保留为字面量、单引号不生效、
- * 多行/嵌套引号脚本崩坏）。这段提示放在固定规则区（项目指令之前）。
+ * 各操作系统特有的命令行指引（文本资产，维护在 os-prompts/ 目录，而非硬编码）：
+ *
+ * - 内置文件：包内 os-prompts/<platform>.md（win32/darwin/linux），随 npm 包分发；
+ * - 用户覆盖：~/.deepccc/prompts/<platform>.md 存在时完全替代内置内容（可自定义）。
+ *
+ * 文件内容自带标题（如 "## Windows Command-Line Notes"），读取后 trim 直接作为
+ * 一个段落注入固定规则区（项目指令之前）。未知平台或文件缺失时返回空字符串。
  */
-function buildPlatformCommandPrompt() {
-    if (process.platform !== "win32")
+export function loadPlatformCommandPrompt(platform = process.platform, dirs = {}) {
+    const filename = platform === "win32" ? "win32.md" :
+        platform === "darwin" ? "darwin.md" :
+            platform === "linux" ? "linux.md" :
+                null;
+    if (!filename)
         return "";
-    return [
-        "## Windows Command-Line Notes",
-        "You are running on Windows. run_command executes through cmd.exe, not bash. cmd quoting differs from bash and breaks common habits:",
-        "- Double quotes are NOT stripped: `echo \"hello world\"` prints `\"hello world\"` (quotes included), and `\"a b\" \"c\"` passes the literal arguments `\"a b\"` and `\"c\"` (quotes included) to the program.",
-        "- Single quotes are NOT quoting characters in cmd.exe: `'a b'` is parsed as two arguments (`'a` and `b'`).",
-        "- Multi-line or quote-heavy inline scripts (python -c \"...\\n...\", ssh host \"bash -c '...'\") frequently break under cmd quoting; write the script to a temporary file and execute that file instead.",
-        "- PowerShell-only syntax (Get-Item, 2>$null, Select-Object) is unavailable; the shell is cmd.exe unless you explicitly invoke powershell.",
-        "- To pass an argument containing spaces, use double quotes and expect the quotes to reach the program literally; when the target accepts file input, prefer writing the value to a file.",
-    ].join("\n");
+    // import.meta.url 定位包根：chatccc 源码运行时指向 deepccc-agent/os-prompts/，
+    // deepccc dist 运行时指向包根 os-prompts/（dist/index.js 的 ../os-prompts/）。
+    const builtinDir = dirs.builtinDir ?? fileURLToPath(new URL("../os-prompts/", import.meta.url));
+    const userDir = dirs.userDir ?? join(homedir(), ".deepccc", "prompts");
+    // 用户覆盖优先；读取失败时静默回退内置，内置也失败则返回空。
+    const userFile = join(userDir, filename);
+    if (existsSync(userFile)) {
+        try {
+            return readFileSync(userFile, "utf-8").trim();
+        }
+        catch {
+            // fall through to builtin
+        }
+    }
+    const builtinFile = join(builtinDir, filename);
+    if (existsSync(builtinFile)) {
+        try {
+            return readFileSync(builtinFile, "utf-8").trim();
+        }
+        catch {
+            return "";
+        }
+    }
+    return "";
 }
 function normalizeMaxSteps(value) {
     if (value === undefined)
@@ -175,7 +200,7 @@ export class ChatSession {
      */
     buildSystemPrompt(skills) {
         const systemContent = [SYSTEM_PROMPT];
-        const platformPrompt = buildPlatformCommandPrompt();
+        const platformPrompt = loadPlatformCommandPrompt();
         if (platformPrompt) {
             systemContent.push("", platformPrompt);
         }

package/os-prompts/darwin.md

@@ -0,0 +1,8 @@
+## macOS Command-Line Notes
+
+You are running on macOS. run_command executes through zsh, a POSIX shell. Quoting follows standard POSIX conventions (the same habits you already know from bash):
+
+- Double quotes are stripped and group an argument containing spaces: `echo "hello world"` prints `hello world`.
+- Single quotes are literal quoting characters: `'a b'` is a single argument `a b`.
+- Backticks and `$(...)` perform command substitution; quote them if you need literal text.
+- Paths use `/` separators and `~` expands to the home directory.

package/os-prompts/linux.md

@@ -0,0 +1,8 @@
+## Linux Command-Line Notes
+
+You are running on Linux. run_command executes through a POSIX shell (bash/sh). Quoting follows standard POSIX conventions (the same habits you already know from bash):
+
+- Double quotes are stripped and group an argument containing spaces: `echo "hello world"` prints `hello world`.
+- Single quotes are literal quoting characters: `'a b'` is a single argument `a b`.
+- Backticks and `$(...)` perform command substitution; quote them if you need literal text.
+- Paths use `/` separators and `~` expands to the home directory.

package/os-prompts/win32.md

@@ -0,0 +1,9 @@
+## Windows Command-Line Notes
+
+You are running on Windows. run_command executes through cmd.exe, not bash. cmd quoting differs from bash and breaks common habits:
+
+- Double quotes are NOT stripped: `echo "hello world"` prints `"hello world"` (quotes included), and `"a b" "c"` passes the literal arguments `"a b"` and `"c"` (quotes included) to the program.
+- Single quotes are NOT quoting characters in cmd.exe: `'a b'` is parsed as two arguments (`'a` and `b'`).
+- Multi-line or quote-heavy inline scripts (python -c "...\n...", ssh host "bash -c '...'") frequently break under cmd quoting; write the script to a temporary file and execute that file instead.
+- PowerShell-only syntax (Get-Item, 2>$null, Select-Object) is unavailable; the shell is cmd.exe unless you explicitly invoke powershell.
+- To pass an argument containing spaces, use double quotes and expect the quotes to reach the program literally; when the target accepts file input, prefer writing the value to a file.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepccc",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "description": "A lightweight DeepSeek-optimized coding agent with OpenAI-compatible model support.",
   "license": "Apache-2.0",
   "keywords": [
@@ -34,6 +34,7 @@
     "dist/",
     "bin/",
     "docs/",
+    "os-prompts/",
     "package.json",
     "README.md",
     "LICENSE"