deepccc 0.1.12 → 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";
@@ -96,6 +98,47 @@ function buildRuntimeWorkspacePrompt(cwd) {
         "File tools run locally through DeepCCC. Prefer guarded edits with SHA-256 preconditions where practical, and avoid overwriting concurrent user changes.",
     ].join("\n");
 }
+/**
+ * 各操作系统特有的命令行指引（文本资产，维护在 os-prompts/ 目录，而非硬编码）：
+ *
+ * - 内置文件：包内 os-prompts/<platform>.md（win32/darwin/linux），随 npm 包分发；
+ * - 用户覆盖：~/.deepccc/prompts/<platform>.md 存在时完全替代内置内容（可自定义）。
+ *
+ * 文件内容自带标题（如 "## Windows Command-Line Notes"），读取后 trim 直接作为
+ * 一个段落注入固定规则区（项目指令之前）。未知平台或文件缺失时返回空字符串。
+ */
+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 "";
+    // 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)
         return undefined;
@@ -157,6 +200,10 @@ export class ChatSession {
      */
     buildSystemPrompt(skills) {
         const systemContent = [SYSTEM_PROMPT];
+        const platformPrompt = loadPlatformCommandPrompt();
+        if (platformPrompt) {
+            systemContent.push("", platformPrompt);
+        }
         const projectInstructions = readProjectInstructionFiles(this.cwd);
         if (projectInstructions) {
             systemContent.push("", projectInstructions);

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.12",
+  "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"