chatccc 0.2.243 → 0.2.244

package/README.md

@@ -210,11 +210,11 @@ chatccc
 
 Claude Code、Cursor 和 Codex 需要对应的本地工具；CCC Agent 内置于 ChatCCC，开箱即用，**模型接入不限于 DeepSeek**——它走 OpenAI 兼容协议，任意兼容端点都可以直接替换（详见下文 CCC Agent）。
 
-#### CCC Agent
-
-CCC Agent 是 ChatCCC 内置的编程 Agent，不需要额外安装 CLI，开箱即用。在首次配置向导或 Web 管理页中启用后，填写 API Key、Base URL 和模型即可使用；它可以设为 `/new` 的默认 Agent，也可以通过 `/new ccc` 显式创建会话。
-
-ChatCCC 会把 `ccc.DEEPSEEK_API_KEY`、`ccc.DEEPSEEK_BASE_URL`、模型和 effort 显式传给内置 Agent；这些配置不会回退读取 `~/.deepccc/config.json`，因此用户无需安装或配置独立的 `deepccc` 包。API Key 为空时 CCC Agent 会自动保持禁用。
+#### CCC Agent
+
+CCC Agent 是 ChatCCC 内置的编程 Agent，不需要额外安装 CLI，开箱即用。在首次配置向导或 Web 管理页中启用后，填写 API Key、Base URL 和模型即可使用；它可以设为 `/new` 的默认 Agent，也可以通过 `/new ccc` 显式创建会话。
+
+ChatCCC 会把 `ccc.DEEPSEEK_API_KEY`、`ccc.DEEPSEEK_BASE_URL`、模型和 effort 显式传给内置 Agent；这些配置不会回退读取 `~/.deepccc/config.json`，因此用户无需安装或配置独立的 `deepccc` 包。API Key 为空时 CCC Agent 会自动保持禁用。
 
 **API 支持不限于 DeepSeek。** CCC Agent 底层使用 OpenAI 兼容协议（`@ai-sdk/openai-compatible`），DeepSeek 只是出厂默认端点。`ccc.DEEPSEEK_API_KEY` / `ccc.DEEPSEEK_BASE_URL` 可以指向**任意 OpenAI 兼容服务**，例如：
 

package/bin/cccagent.mjs

@@ -1,17 +1,17 @@
-#!/usr/bin/env node
-import { spawnSync } from "node:child_process";
-import { createRequire } from "node:module";
-import { dirname, join } from "node:path";
-
-const require = createRequire(import.meta.url);
-const pkgRoot = dirname(require.resolve("../package.json"));
-const cliTs = join(pkgRoot, "deepccc-agent", "src", "cli.ts");
-const tsxCli = require.resolve("tsx/cli");
-
-const result = spawnSync(process.execPath, [tsxCli, cliTs, ...process.argv.slice(2)], {
-  stdio: "inherit",
-  cwd: process.cwd(),
-  env: process.env,
-});
-
-process.exit(result.status === null ? 1 : result.status);
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+
+const require = createRequire(import.meta.url);
+const pkgRoot = dirname(require.resolve("../package.json"));
+const cliTs = join(pkgRoot, "deepccc-agent", "src", "cli.ts");
+const tsxCli = require.resolve("tsx/cli");
+
+const result = spawnSync(process.execPath, [tsxCli, cliTs, ...process.argv.slice(2)], {
+  stdio: "inherit",
+  cwd: process.cwd(),
+  env: process.env,
+});
+
+process.exit(result.status === null ? 1 : result.status);

package/deepccc-agent/bin/deepccc.mjs

@@ -1,26 +1,26 @@
-#!/usr/bin/env node
-import { existsSync } from "node:fs";
-import { spawnSync } from "node:child_process";
-import { createRequire } from "node:module";
-import { dirname, join } from "node:path";
-
-const require = createRequire(import.meta.url);
-const pkgRoot = dirname(require.resolve("../package.json"));
-const distCli = join(pkgRoot, "dist", "cli.js");
-
-let args;
-if (existsSync(distCli)) {
-  args = [distCli, ...process.argv.slice(2)];
-} else {
-  const tsxCli = require.resolve("tsx/cli");
-  const sourceCli = join(pkgRoot, "src", "cli.ts");
-  args = [tsxCli, sourceCli, ...process.argv.slice(2)];
-}
-
-const result = spawnSync(process.execPath, args, {
-  stdio: "inherit",
-  cwd: process.cwd(),
-  env: process.env,
-});
-
-process.exit(result.status === null ? 1 : result.status);
+#!/usr/bin/env node
+import { existsSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+
+const require = createRequire(import.meta.url);
+const pkgRoot = dirname(require.resolve("../package.json"));
+const distCli = join(pkgRoot, "dist", "cli.js");
+
+let args;
+if (existsSync(distCli)) {
+  args = [distCli, ...process.argv.slice(2)];
+} else {
+  const tsxCli = require.resolve("tsx/cli");
+  const sourceCli = join(pkgRoot, "src", "cli.ts");
+  args = [tsxCli, sourceCli, ...process.argv.slice(2)];
+}
+
+const result = spawnSync(process.execPath, args, {
+  stdio: "inherit",
+  cwd: process.cwd(),
+  env: process.env,
+});
+
+process.exit(result.status === null ? 1 : result.status);

package/deepccc-agent/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/deepccc-agent/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/deepccc-agent/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/deepccc-agent/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"

package/deepccc-agent/src/__tests__/chat-session.test.ts

@@ -1,6 +1,7 @@
 import { mkdir, mkdtemp, readFile, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+import { fileURLToPath } from "node:url";
 
 import { afterEach, describe, expect, it, vi } from "vitest";
 
@@ -576,3 +577,41 @@ describe("estimateBuiltinContextTokens", () => {
     expect(estimate).toBeLessThan(340);
   });
 });
+
+describe("loadPlatformCommandPrompt", () => {
+  // 测试文件在 src/__tests__/，上两级即包根 os-prompts/
+  const builtinDir = fileURLToPath(new URL("../../os-prompts/", import.meta.url));
+
+  async function loadPrompt(
+    platform: string,
+    dirs?: { builtinDir?: string; userDir?: string },
+  ): Promise<string> {
+    const mod = (await import("../index.js")) as {
+      loadPlatformCommandPrompt: (
+        platform: string,
+        dirs?: { builtinDir?: string; userDir?: string },
+      ) => string;
+    };
+    return mod.loadPlatformCommandPrompt(platform, dirs);
+  }
+
+  it("loads builtin guidance from os-prompts/<platform>.md", async () => {
+    const text = await loadPrompt("win32", { builtinDir });
+    expect(text).toContain("## Windows Command-Line Notes");
+    expect(text).toContain("cmd.exe");
+    expect(text).toMatch(/double quotes/i);
+    expect(text).toMatch(/single quotes/i);
+  });
+
+  it("prefers the user override at ~/.deepccc/prompts/<platform>.md", async () => {
+    const userDir = await mkdtemp(join(tmpdir(), "deepccc-os-prompt-override-"));
+    await writeFile(join(userDir, "win32.md"), "CUSTOM OVERRIDE GUIDANCE", "utf-8");
+    const text = await loadPrompt("win32", { builtinDir, userDir });
+    expect(text).toBe("CUSTOM OVERRIDE GUIDANCE");
+  });
+
+  it("returns empty string for unknown platforms or missing files", async () => {
+    expect(await loadPrompt("freebsd", { builtinDir })).toBe("");
+    expect(await loadPrompt("linux", { builtinDir: join(builtinDir, "missing") })).toBe("");
+  });
+});

package/deepccc-agent/src/__tests__/cli-json.test.ts

@@ -1,49 +1,49 @@
-import { execFile } from "node:child_process";
-import { existsSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import { promisify } from "node:util";
-
-import { describe, expect, it } from "vitest";
-
-const execFileAsync = promisify(execFile);
-
-// 兼容两种布局：<root>/deepccc-agent/src/__tests__（chatccc 子目录）或 <root>/src/__tests__（deepccc 镜像）
-const here = dirname(fileURLToPath(import.meta.url));
-const cliBin = [
-  join(here, "..", "..", "..", "bin", "deepccc.mjs"),
-  join(here, "..", "..", "bin", "deepccc.mjs"),
-].find(existsSync);
-
-describe("deepccc cli --stream-json", () => {
-  it("writes only JSON lines to stdout when startup fails", async () => {
-    let caught: unknown;
-    try {
-      await execFileAsync(process.execPath, [
-        cliBin!,
-        "--stream-json",
-        "--prompt",
-        "hello",
-        "--api-key",
-        "",
-      ], {
-        cwd: dirname(cliBin!),
-        timeout: 10_000,
-        windowsHide: true,
-      });
-    } catch (err) {
-      caught = err;
-    }
-
-    expect(caught).toMatchObject({ code: 1 });
-    const stdout = (caught as { stdout?: string }).stdout ?? "";
-    const lines = stdout.trim().split(/\r?\n/).filter(Boolean);
-    expect(lines.length).toBeGreaterThan(0);
-    for (const line of lines) {
-      expect(() => JSON.parse(line)).not.toThrow();
-    }
-    expect(JSON.parse(lines.at(-1)!)).toEqual(expect.objectContaining({
-      type: "error",
-    }));
-  });
-});
+import { execFile } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { promisify } from "node:util";
+
+import { describe, expect, it } from "vitest";
+
+const execFileAsync = promisify(execFile);
+
+// 兼容两种布局：<root>/deepccc-agent/src/__tests__（chatccc 子目录）或 <root>/src/__tests__（deepccc 镜像）
+const here = dirname(fileURLToPath(import.meta.url));
+const cliBin = [
+  join(here, "..", "..", "..", "bin", "deepccc.mjs"),
+  join(here, "..", "..", "bin", "deepccc.mjs"),
+].find(existsSync);
+
+describe("deepccc cli --stream-json", () => {
+  it("writes only JSON lines to stdout when startup fails", async () => {
+    let caught: unknown;
+    try {
+      await execFileAsync(process.execPath, [
+        cliBin!,
+        "--stream-json",
+        "--prompt",
+        "hello",
+        "--api-key",
+        "",
+      ], {
+        cwd: dirname(cliBin!),
+        timeout: 10_000,
+        windowsHide: true,
+      });
+    } catch (err) {
+      caught = err;
+    }
+
+    expect(caught).toMatchObject({ code: 1 });
+    const stdout = (caught as { stdout?: string }).stdout ?? "";
+    const lines = stdout.trim().split(/\r?\n/).filter(Boolean);
+    expect(lines.length).toBeGreaterThan(0);
+    for (const line of lines) {
+      expect(() => JSON.parse(line)).not.toThrow();
+    }
+    expect(JSON.parse(lines.at(-1)!)).toEqual(expect.objectContaining({
+      type: "error",
+    }));
+  });
+});

package/deepccc-agent/src/__tests__/config.test.ts

@@ -1,26 +1,26 @@
-import { afterEach, describe, expect, it } from "vitest";
-
-import { ChatSession } from "../index.js";
-import { config } from "../config.js";
-
-const originalDeepSeekApiKey = process.env.DEEPSEEK_API_KEY;
-const originalDeepCccApiKey = config.apiKey;
-
-afterEach(() => {
-  if (originalDeepSeekApiKey === undefined) {
-    delete process.env.DEEPSEEK_API_KEY;
-  } else {
-    process.env.DEEPSEEK_API_KEY = originalDeepSeekApiKey;
-  }
-  config.apiKey = originalDeepCccApiKey;
-});
-
-describe("builtin ChatSession config", () => {
-  it("uses the builtin ~/.deepccc config when no apiKey is passed", () => {
-    expect(() => new ChatSession()).not.toThrow();
-  });
-
-  it("allows constructor parameters to override config defaults", () => {
-    expect(() => new ChatSession({ apiKey: "sk-test" })).not.toThrow();
-  });
-});
+import { afterEach, describe, expect, it } from "vitest";
+
+import { ChatSession } from "../index.js";
+import { config } from "../config.js";
+
+const originalDeepSeekApiKey = process.env.DEEPSEEK_API_KEY;
+const originalDeepCccApiKey = config.apiKey;
+
+afterEach(() => {
+  if (originalDeepSeekApiKey === undefined) {
+    delete process.env.DEEPSEEK_API_KEY;
+  } else {
+    process.env.DEEPSEEK_API_KEY = originalDeepSeekApiKey;
+  }
+  config.apiKey = originalDeepCccApiKey;
+});
+
+describe("builtin ChatSession config", () => {
+  it("uses the builtin ~/.deepccc config when no apiKey is passed", () => {
+    expect(() => new ChatSession()).not.toThrow();
+  });
+
+  it("allows constructor parameters to override config defaults", () => {
+    expect(() => new ChatSession({ apiKey: "sk-test" })).not.toThrow();
+  });
+});