deepccc 0.1.1 → 0.1.2

package/README.md

@@ -1,200 +1,217 @@
-# deepccc
-
-`deepccc` 是一个轻量级本地编程 Agent，针对 DeepSeek 使用体验做了优化，同时支持其他 OpenAI-compatible 模型接口。
-
-它提供交互式命令行、JSONL 流式输出、本地文件工具、命令执行、项目提示词自动注入和持久化上下文。
-
-## 当前状态
-
-代码已经开源在 GitHub：
-
-https://github.com/wzj998/deepccc-agent
-
-npm 包名规划为 `deepccc`。如果 npm 包已经发布，可以直接全局安装：
-
-```bash
-npm install -g deepccc
-```
-
-如果还没有发布，可以从源码运行：
-
-```bash
-git clone https://github.com/wzj998/deepccc-agent.git
-cd deepccc-agent
-npm install
-npm run build
-node bin/deepccc.mjs --help
-```
-
-运行要求：
-
-- Node.js >= 20
-- DeepSeek 或其他 OpenAI-compatible 模型服务的 API Key
-
-## 配置
-
-最快的方式是使用环境变量：
-
-```bash
-export DEEPCCC_API_KEY="sk-..."
-export DEEPCCC_BASE_URL="https://api.deepseek.com/v1"
-export DEEPCCC_MODEL="deepseek-v4-pro"
-```
-
-Windows PowerShell：
-
-```powershell
-$env:DEEPCCC_API_KEY="sk-..."
-$env:DEEPCCC_BASE_URL="https://api.deepseek.com/v1"
-$env:DEEPCCC_MODEL="deepseek-v4-pro"
-```
-
-也兼容这些 DeepSeek 别名：
-
-- `DEEPSEEK_API_KEY`
-- `DEEPSEEK_BASE_URL`
-- `DEEPSEEK_MODEL`
-- `DEEPSEEK_EFFORT`
-
-也可以创建 `~/.deepccc/config.json`：
-
-```json
-{
-  "apiKey": "sk-...",
-  "baseURL": "https://api.deepseek.com/v1",
-  "model": "deepseek-v4-pro",
-  "effort": "",
-  "rawStreamLogs": {
-    "enabled": false,
-    "maxBytesPerTurn": 1048576,
-    "retentionDays": 7,
-    "keepCompleted": false
-  }
-}
-```
-
-## 命令行交互
-
-在当前目录启动一个交互式 Agent：
-
-```bash
-deepccc
-```
-
-指定其他模型或 OpenAI-compatible 接口：
-
-```bash
-deepccc --base-url https://api.openai.com/v1 --api-key "$OPENAI_API_KEY" --model gpt-4.1
-```
-
-指定工作目录：
-
-```bash
-deepccc --cwd /path/to/project
-```
-
-恢复当前工作目录最近一次会话：
-
-```bash
-deepccc --resume
-```
-
-设置工具调用步数上限：
-
-```bash
-deepccc --max-steps 20
-```
-
-默认情况下，`deepccc` 不设置固定步数上限，会让模型自然完成工具循环。
-
-设置推理强度（reasoning effort）：
-
-```bash
-deepccc --effort high
-```
-
-可选值：`none` / `minimal` / `low` / `medium` / `high` / `xhigh` / `max`（留空则不传 `reasoning_effort` 请求字段）。
-
-## 终端过程区块
-
-交互模式下，每轮回复渲染为固定"过程区块"：状态行（生成中/完成/已停止/异常结束）+ 折叠工具行 + 原地更新正文，不滚屏刷 JSON。生成中有心跳点号动画；完成/停止/异常后区块定型留在屏幕上。
-
-如果终端渲染出现异常，可以强制回退为纯文本流式输出：
-
-```bash
-deepccc --plain
-```
-
-## JSONL 流式输出
-
-JSONL 模式适合脚本、服务端集成或其他上层系统调用：
-
-```bash
-deepccc --stream-json --prompt "检查这个仓库并总结测试命令"
-```
-
-也可以从 stdin 传入提示词：
-
-```bash
-echo "运行测试并解释失败原因" | deepccc --stream-json
-```
-
-输出是逐行 JSON：
-
-```jsonl
-{"type":"start","session_id":"session-...","mode":"new","cwd":"/repo","model":"deepseek-v4-pro"}
-{"type":"text_delta","text":"...","accumulated":"..."}
-{"type":"tool_call","id":"call_...","name":"read_file","input":{"path":"package.json"}}
-{"type":"tool_result","tool_call_id":"call_...","name":"read_file","content":{},"is_error":false}
-{"type":"done","text":"..."}
-```
-
-## 在 ChatCCC 中使用
-
-ChatCCC 公有仓库：
-
-https://github.com/wzj998/ChatCCC
-
-在 ChatCCC 会话里可以使用隐藏指令创建 `deepccc` Agent 会话：
-
-```text
-/new ccc
-```
-
-这种方式适合已经在 ChatCCC 里协作的场景：ChatCCC 负责会话入口和消息通道，`deepccc` 负责本地编程 Agent 能力，包括读取项目提示词、运行命令、编辑文件和输出流式结果。
-
-## 项目提示词自动注入
-
-会话启动时，`deepccc` 会从当前工作目录读取这些文件，如果存在就注入为项目级提示词：
-
-- `AGENTS.md`
-- `AGENTS.local.md`
-- `CLAUDE.md`
-- `CLAUDE.local.md`
-
-这些内容会放在固定系统提示词之后，作为项目指导使用。
-
-## Codex-style Skills 支持
-
-`deepccc` 会扫描以下目录，把本机的 Codex 目录式 skill（`<name>/SKILL.md`，含 `name` + `description` frontmatter）索引注入系统提示词；模型在任务匹配时先用 `read_file` 读取 `SKILL.md` 全文再执行：
-
-- `~/.codex/skills`
-- `~/.agents/skills`
-- `<cwd>/.codex/skills`（项目级，优先级最高）
-
-## 内置工具
-
-`deepccc` 可以让模型调用这些本地工具：
-
-- 按行读取文件
-- 列目录
-- 用 ripgrep 搜索代码
-- 编辑、创建、删除、移动文件
-- 应用 unified diff patch
-- 运行非交互式 shell 命令，并返回 stdout、stderr、exitCode 和超时状态
-
-命令返回非零退出码时不会直接被当成工具异常；模型可以读取结构化结果，继续判断下一步。
-
-## License
-
-Apache-2.0
+# deepccc
+
+`deepccc` 是一个轻量级本地编程 Agent，针对 DeepSeek 使用体验做了优化，同时支持其他 OpenAI-compatible 模型接口。
+
+它提供交互式命令行、JSONL 流式输出、本地文件工具、命令执行、项目提示词自动注入和持久化上下文。
+
+## 当前状态
+
+代码已经开源在 GitHub：
+
+https://github.com/wzj998/deepccc-agent
+
+npm 包名规划为 `deepccc`。如果 npm 包已经发布，可以直接全局安装：
+
+```bash
+npm install -g deepccc
+```
+
+如果还没有发布，可以从源码运行：
+
+```bash
+git clone https://github.com/wzj998/deepccc-agent.git
+cd deepccc-agent
+npm install
+npm run build
+node bin/deepccc.mjs --help
+```
+
+运行要求：
+
+- Node.js >= 20
+- DeepSeek 或其他 OpenAI-compatible 模型服务的 API Key
+
+## 配置
+
+最快的方式是使用环境变量：
+
+```bash
+export DEEPCCC_API_KEY="sk-..."
+export DEEPCCC_BASE_URL="https://api.deepseek.com/v1"
+export DEEPCCC_MODEL="deepseek-v4-pro"
+```
+
+Windows PowerShell：
+
+```powershell
+$env:DEEPCCC_API_KEY="sk-..."
+$env:DEEPCCC_BASE_URL="https://api.deepseek.com/v1"
+$env:DEEPCCC_MODEL="deepseek-v4-pro"
+```
+
+也兼容这些 DeepSeek 别名：
+
+- `DEEPSEEK_API_KEY`
+- `DEEPSEEK_BASE_URL`
+- `DEEPSEEK_MODEL`
+- `DEEPSEEK_EFFORT`
+
+也可以创建 `~/.deepccc/config.json`：
+
+```json
+{
+  "apiKey": "sk-...",
+  "baseURL": "https://api.deepseek.com/v1",
+  "model": "deepseek-v4-pro",
+  "effort": "",
+  "rawStreamLogs": {
+    "enabled": false,
+    "maxBytesPerTurn": 1048576,
+    "retentionDays": 7,
+    "keepCompleted": false
+  }
+}
+```
+
+## 隐私替换
+
+`deepccc` 支持在展示层（终端输出 / JSONL 流式输出）把敏感信息替换为掩码值，防止用户名、路径等隐私内容出现在终端或管道输出里。创建 `~/.deepccc/privacy.json` 即可启用：
+
+```json
+{
+  "enabled": true,
+  "rules": {
+    "weizhangjian": "wzj"
+  }
+}
+```
+
+- `rules` 的键按字面量替换（`split`/`join`，非正则），可配置多条规则；不配置 `enabled`/`rules` 字段时，扁平写法 `{ "weizhangjian": "wzj" }` 也兼容（等效 `enabled: true`）。
+- 替换作用于模型回复文本、工具调用参数与结果、错误消息中的字符串字段；持久化上下文仍保存原文，替换仅影响展示层。
+- 文件变更后自动热加载，无需重启进程。
+
+## 命令行交互
+
+在当前目录启动一个交互式 Agent：
+
+```bash
+deepccc
+```
+
+指定其他模型或 OpenAI-compatible 接口：
+
+```bash
+deepccc --base-url https://api.openai.com/v1 --api-key "$OPENAI_API_KEY" --model gpt-4.1
+```
+
+指定工作目录：
+
+```bash
+deepccc --cwd /path/to/project
+```
+
+恢复当前工作目录最近一次会话：
+
+```bash
+deepccc --resume
+```
+
+设置工具调用步数上限：
+
+```bash
+deepccc --max-steps 20
+```
+
+默认情况下，`deepccc` 不设置固定步数上限，会让模型自然完成工具循环。
+
+设置推理强度（reasoning effort）：
+
+```bash
+deepccc --effort high
+```
+
+可选值：`none` / `minimal` / `low` / `medium` / `high` / `xhigh` / `max`（留空则不传 `reasoning_effort` 请求字段）。
+
+## 终端过程区块
+
+交互模式下，每轮回复渲染为固定"过程区块"：状态行（生成中/完成/已停止/异常结束）+ 折叠工具行 + 原地更新正文，不滚屏刷 JSON。生成中有心跳点号动画；完成/停止/异常后区块定型留在屏幕上。
+
+如果终端渲染出现异常，可以强制回退为纯文本流式输出：
+
+```bash
+deepccc --plain
+```
+
+## JSONL 流式输出
+
+JSONL 模式适合脚本、服务端集成或其他上层系统调用：
+
+```bash
+deepccc --stream-json --prompt "检查这个仓库并总结测试命令"
+```
+
+也可以从 stdin 传入提示词：
+
+```bash
+echo "运行测试并解释失败原因" | deepccc --stream-json
+```
+
+输出是逐行 JSON：
+
+```jsonl
+{"type":"start","session_id":"session-...","mode":"new","cwd":"/repo","model":"deepseek-v4-pro"}
+{"type":"text_delta","text":"...","accumulated":"..."}
+{"type":"tool_call","id":"call_...","name":"read_file","input":{"path":"package.json"}}
+{"type":"tool_result","tool_call_id":"call_...","name":"read_file","content":{},"is_error":false}
+{"type":"done","text":"..."}
+```
+
+## 在 ChatCCC 中使用
+
+ChatCCC 公有仓库：
+
+https://github.com/wzj998/ChatCCC
+
+在 ChatCCC 会话里可以使用隐藏指令创建 `deepccc` Agent 会话：
+
+```text
+/new ccc
+```
+
+这种方式适合已经在 ChatCCC 里协作的场景：ChatCCC 负责会话入口和消息通道，`deepccc` 负责本地编程 Agent 能力，包括读取项目提示词、运行命令、编辑文件和输出流式结果。
+
+## 项目提示词自动注入
+
+会话启动时，`deepccc` 会从当前工作目录读取这些文件，如果存在就注入为项目级提示词：
+
+- `AGENTS.md`
+- `AGENTS.local.md`
+- `CLAUDE.md`
+- `CLAUDE.local.md`
+
+这些内容会放在固定系统提示词之后，作为项目指导使用。
+
+## Codex-style Skills 支持
+
+`deepccc` 会扫描以下目录，把本机的 Codex 目录式 skill（`<name>/SKILL.md`，含 `name` + `description` frontmatter）索引注入系统提示词；模型在任务匹配时先用 `read_file` 读取 `SKILL.md` 全文再执行：
+
+- `~/.codex/skills`
+- `~/.agents/skills`
+- `<cwd>/.codex/skills`（项目级，优先级最高）
+
+## 内置工具
+
+`deepccc` 可以让模型调用这些本地工具：
+
+- 按行读取文件
+- 列目录
+- 用 ripgrep 搜索代码
+- 编辑、创建、删除、移动文件
+- 应用 unified diff patch
+- 运行非交互式 shell 命令，并返回 stdout、stderr、exitCode 和超时状态
+
+命令返回非零退出码时不会直接被当成工具异常；模型可以读取结构化结果，继续判断下一步。
+
+## License
+
+Apache-2.0

package/dist/index.js

@@ -12,6 +12,7 @@ import { createRawStreamLog, } from "./raw-stream-log.js";
 import { BuiltinContextManager, buildSummaryPrompt, defaultBuiltinSessionId, } from "./context.js";
 import { createBuiltinFileTools } from "./file-tools.js";
 import { buildDefaultSkillDirs, buildSkillsIndexPrompt, scanSkillsDirs } from "./skills.js";
+import { applyPrivacy, applyPrivacyToJson } from "./privacy.js";
 // ---------------------------------------------------------------------------
 // 系统提示词 — 编译期冻结常量（DeepCCC 英文品牌）
 // ---------------------------------------------------------------------------
@@ -130,6 +131,7 @@ export class ChatSession {
     async *chat(userMessage, signal) {
         this.context.appendMessage({ role: "user", content: userMessage });
         let fullText = "";
+        let safeAccumulated = "";
         let rawLog = null;
         let completed = false;
         try {
@@ -170,7 +172,11 @@ export class ChatSession {
                 rawLog?.writeLine(safeRawStreamJson(part));
                 if (part.type === "text-delta") {
                     fullText += part.text;
-                    yield { type: "text", text: part.text, accumulated: fullText };
+                    // 隐私替换只在展示层：safeAccumulated 供事件消费者（终端/JSONL）使用，
+                    // fullText 原文用于持久化上下文，避免替换结果回流污染上下文。
+                    const safeText = applyPrivacy(part.text);
+                    safeAccumulated += safeText;
+                    yield { type: "text", text: safeText, accumulated: safeAccumulated };
                 }
                 else if (part.type === "tool-call") {
                     toolContext.push(`tool_call ${part.toolName}: ${safeJson(part.input)}`);
@@ -178,7 +184,7 @@ export class ChatSession {
                         type: "tool_use",
                         id: part.toolCallId,
                         name: part.toolName,
-                        input: part.input,
+                        input: applyPrivacyToJson(part.input),
                     };
                 }
                 else if (part.type === "tool-result") {
@@ -187,7 +193,7 @@ export class ChatSession {
                         type: "tool_result",
                         tool_use_id: part.toolCallId,
                         name: part.toolName,
-                        content: part.output,
+                        content: applyPrivacyToJson(part.output),
                         is_error: false,
                     };
                 }
@@ -198,13 +204,13 @@ export class ChatSession {
                         type: "tool_result",
                         tool_use_id: part.toolCallId,
                         name: part.toolName,
-                        content: message,
+                        content: applyPrivacy(message),
                         is_error: true,
                     };
                 }
                 else if (part.type === "error") {
                     const message = errorMessage(part.error);
-                    yield { type: "error", message };
+                    yield { type: "error", message: applyPrivacy(message) };
                     throw new Error(message);
                 }
             }
@@ -213,7 +219,7 @@ export class ChatSession {
                 ? `${fullText}\n\n[Tool transcript]\n${toolContext.join("\n")}`
                 : fullText;
             this.context.appendMessage({ role: "assistant", content: persistedText });
-            yield { type: "done", text: fullText };
+            yield { type: "done", text: safeAccumulated };
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
@@ -222,10 +228,10 @@ export class ChatSession {
                 if (fullText) {
                     this.context.appendMessage({ role: "assistant", content: `${fullText}\n[interrupted]` });
                 }
-                yield { type: "done", text: fullText };
+                yield { type: "done", text: safeAccumulated };
                 return;
             }
-            yield { type: "error", message };
+            yield { type: "error", message: applyPrivacy(message) };
             throw err;
         }
         finally {

package/dist/privacy.d.ts

@@ -0,0 +1,21 @@
+interface PrivacyRules {
+    [key: string]: string;
+}
+interface PrivacyConfig {
+    enabled: boolean;
+    rules: PrivacyRules;
+}
+export declare function getPrivacyConfig(): PrivacyConfig;
+export declare function getPrivacyRules(): PrivacyRules;
+export declare function reloadPrivacyRules(): void;
+/**
+ * 把文本中的隐私规则字面量替换为掩码值（split+join，规则键保持字面量）。
+ * 仅作用于展示层：调用方应保持内部数据（如持久化上下文）为原文。
+ */
+export declare function applyPrivacy(text: string): string;
+/**
+ * 递归替换结构化数据（工具调用参数/结果）中的字符串字段。
+ * 数组逐项、对象逐值、字符串走 applyPrivacy，其余类型原样返回。
+ */
+export declare function applyPrivacyToJson(value: unknown): unknown;
+export {};

package/dist/privacy.js

@@ -0,0 +1,124 @@
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { DEEPCCC_HOME } from "./config.js";
+let config = null;
+let loadedStamp;
+function privacyFilePath() {
+    return join(DEEPCCC_HOME, "privacy.json");
+}
+function privacyFileStamp() {
+    const filePath = privacyFilePath();
+    if (!existsSync(filePath))
+        return null;
+    try {
+        const s = statSync(filePath);
+        return `${s.mtimeMs}:${s.size}`;
+    }
+    catch {
+        return null;
+    }
+}
+function sanitizeRules(raw) {
+    const result = {};
+    for (const [from, to] of Object.entries(raw)) {
+        if (!from) {
+            console.error("[PRIVACY] privacy.json rule key cannot be empty, skipped");
+            continue;
+        }
+        if (typeof to !== "string") {
+            console.error(`[PRIVACY] privacy.json value must be a string, skipped "${from}"`);
+            continue;
+        }
+        result[from] = to;
+    }
+    return result;
+}
+function normalizeConfig(parsed) {
+    const hasNewSchema = Object.prototype.hasOwnProperty.call(parsed, "enabled") ||
+        Object.prototype.hasOwnProperty.call(parsed, "rules");
+    if (!hasNewSchema) {
+        return { enabled: true, rules: sanitizeRules(parsed) };
+    }
+    const enabledRaw = parsed.enabled;
+    const enabled = enabledRaw === undefined ? true : enabledRaw !== false;
+    if (enabledRaw !== undefined && typeof enabledRaw !== "boolean") {
+        console.error("[PRIVACY] privacy.json enabled must be a boolean, using true");
+    }
+    const rulesRaw = parsed.rules;
+    if (rulesRaw === undefined)
+        return { enabled, rules: {} };
+    if (typeof rulesRaw !== "object" || rulesRaw === null || Array.isArray(rulesRaw)) {
+        console.error("[PRIVACY] privacy.json rules must be an object");
+        return { enabled, rules: {} };
+    }
+    return { enabled, rules: sanitizeRules(rulesRaw) };
+}
+function loadConfig() {
+    const filePath = privacyFilePath();
+    if (!existsSync(filePath)) {
+        return { enabled: true, rules: {} };
+    }
+    try {
+        const raw = readFileSync(filePath, "utf-8").replace(/^\uFEFF/, "");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+            console.error("[PRIVACY] privacy.json must be an object");
+            return { enabled: true, rules: {} };
+        }
+        return normalizeConfig(parsed);
+    }
+    catch (err) {
+        console.error(`[PRIVACY] failed to read privacy.json: ${err.message}`);
+        return { enabled: true, rules: {} };
+    }
+}
+export function getPrivacyConfig() {
+    const stamp = privacyFileStamp();
+    if (!config || stamp !== loadedStamp) {
+        config = loadConfig();
+        loadedStamp = stamp;
+    }
+    return config;
+}
+export function getPrivacyRules() {
+    return getPrivacyConfig().rules;
+}
+export function reloadPrivacyRules() {
+    config = null;
+    loadedStamp = undefined;
+}
+/**
+ * 把文本中的隐私规则字面量替换为掩码值（split+join，规则键保持字面量）。
+ * 仅作用于展示层：调用方应保持内部数据（如持久化上下文）为原文。
+ */
+export function applyPrivacy(text) {
+    const { enabled, rules } = getPrivacyConfig();
+    if (!enabled || Object.keys(rules).length === 0 || !text)
+        return text;
+    let result = text;
+    for (const [from, to] of Object.entries(rules)) {
+        result = result.split(from).join(to);
+    }
+    return result;
+}
+/**
+ * 递归替换结构化数据（工具调用参数/结果）中的字符串字段。
+ * 数组逐项、对象逐值、字符串走 applyPrivacy，其余类型原样返回。
+ */
+export function applyPrivacyToJson(value) {
+    const { enabled, rules } = getPrivacyConfig();
+    if (!enabled || Object.keys(rules).length === 0)
+        return value;
+    if (typeof value === "string")
+        return applyPrivacy(value);
+    if (Array.isArray(value))
+        return value.map((item) => applyPrivacyToJson(item));
+    if (value !== null && typeof value === "object") {
+        const out = {};
+        for (const [key, item] of Object.entries(value)) {
+            out[key] = applyPrivacyToJson(item);
+        }
+        return out;
+    }
+    return value;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepccc",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "A lightweight DeepSeek-optimized coding agent with OpenAI-compatible model support.",
   "license": "Apache-2.0",
   "keywords": [