deepccc 0.1.1 → 0.1.3

package/README.md

@@ -1,200 +1,277 @@
-# 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` 请求字段）。
+
+## 权限机制
+
+`deepccc` 内置轻量权限机制，对标主流 agent 的审批体验：**只拦截有副作用的操作**（`run_command` 与文件写操作），只读工具（`read_file` / `list_dir` / `search_code`）永不拦截，常规文件编辑默认放行不打断工作流。
+
+默认模式（`ask`）下，只有**命中内置危险命令库**的高危命令才会询问，例如：
+
+- `rm -rf` / `rm -fr` / `del /s` / `rmdir /s` 等强制删除
+- `git push --force` / `git reset --hard` / `git clean -f` 等破坏性 git 操作
+- `format` / `diskpart` / `mkfs` / `dd of=设备` 等磁盘操作
+- `shutdown` / `reboot` 等系统操作
+- `drop table` / `truncate table` 等数据库操作
+- `npm publish` / `npm uninstall -g` / `pip uninstall` 等发布与全局卸载
+
+交互模式下，高危命令会暂停并询问：
+
+```text
+⚠️  高危操作需要确认
+运行命令: rm -rf node_modules
+允许一次(y) / 永远允许(a) / 拒绝(n) / 本会话允许所有(g) >
+```
+
+- `y` — 允许本次
+- `a` — 永远允许，写入 `~/.deepccc/allow.json`
+- `n` — 拒绝本次
+- `g` — 本会话内全部放行（不落盘）
+
+### 规则文件 `~/.deepccc/allow.json`
+
+规则格式为 `"<工具>:<模式>"`（`*` 为通配符，`*:` 匹配所有工具），支持相对/绝对路径：
+
+```json
+{
+  "allow": [
+    "run_command:git status*",
+    "run_command:git push --force origin release*"
+  ],
+  "deny": [
+    "edit_file:node_modules/**",
+    "run_command:npm publish*"
+  ]
+}
+```
+
+`deny` 命中永远拒绝，`allow` 命中永远放行（可覆盖高危判定）。文件变更后自动热加载，无需重启。
+
+### 非交互模式与 bypass
+
+`--stream-json` 或程序化调用（无终端可交互）时，高危命令**安全默认拒绝**。需要全自动场景可显式传入：
+
+```bash
+deepccc --dangerously-bypass-permissions
+```
+
+该参数与 `ChatSession` 的 `permissionMode: "bypass"` 等价，也是 chatccc 集成 deepccc 时使用的模式（对齐 chatccc 调用 Claude Code / Codex 的 bypass 方式）。
+
+## 终端过程区块
+
+交互模式下，每轮回复渲染为固定"过程区块"：状态行（生成中/完成/已停止/异常结束）+ 折叠工具行 + 原地更新正文，不滚屏刷 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 已内置 deepccc**：ChatCCC 的 "CCC Agent" 工具直接内嵌 deepccc 的代码（`src/builtin/`），以 `permissionMode: "bypass"` 全自动运行，无需单独安装或配置本仓库。
+
+ChatCCC 是一个把 Claude Code / Codex / Cursor / CCC Agent 聚合到飞书/企微等 IM 消息通道的本地机器人框架，提供会话管理、过程卡片、用量统计与隐私替换等能力。
+
+- 公有仓库：https://github.com/wzj998/ChatCCC
+- npm 包：`chatccc`（`npm install -g chatccc`）
+
+在 ChatCCC 会话里可以使用隐藏指令创建 `deepccc` Agent 会话：
+
+```text
+/new ccc
+```
+
+这种方式适合已经在 ChatCCC 里协作的场景：ChatCCC 负责会话入口和消息通道，`deepccc` 负责本地编程 Agent 能力，包括读取项目提示词、运行命令、编辑文件和输出流式结果。
+
+如果希望让 ChatCCC 使用本仓库（deepccc-agent）最新的独立版本能力，也可以把 `src/builtin/` 与本仓库 `src/` 同步后构建。
+
+## 项目提示词自动注入
+
+会话启动时，`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/cli.js

@@ -87,6 +87,10 @@ function parseArgs(argv = process.argv.slice(2)) {
         else if (arg === "--plain") {
             plain = true;
         }
+        else if (arg === "--dangerously-bypass-permissions") {
+            // 仅保留一个 bypass 入口（对齐 chatccc 调 claude/codex 的 bypass 模式）
+            options.permissionMode = "bypass";
+        }
         else if (arg === "--help" || arg === "-h") {
             help = true;
         }
@@ -118,8 +122,16 @@ function printHelp(appConfig) {
         "  --stream-json        One-shot mode: write JSONL events to stdout",
         "  --prompt <text>      Prompt text for --stream-json",
         "  --plain              Force plain streaming output (no progress block renderer)",
+        "  --dangerously-bypass-permissions  Skip all permission prompts (aligns with chatccc's bypass mode)",
         "  --help, -h           Show help",
         "",
+        "Permissions:",
+        "  Default mode asks before high-risk commands (rm -rf, git push --force, ...).",
+        "  Answer y = allow once, a = allow always (saved to ~/.deepccc/allow.json),",
+        "  n = deny, g = allow all for this session. Read-only tools and normal file",
+        "  edits never prompt. In non-interactive mode (--stream-json) high-risk",
+        "  commands are denied unless --dangerously-bypass-permissions is passed.",
+        "",
         "Default config source:",
         "  ~/.deepccc/config.json, DEEPCCC_* environment variables, or DEEPSEEK_* aliases",
         "",
@@ -338,6 +350,37 @@ async function runRepl(args) {
     if (process.stdout.isTTY === true && !args.plain) {
         muteConsoleLogToFile(setupFileLogging(defaultLogDir(), "index").logPath);
     }
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        prompt: `${C.green}>${C.reset} `,
+    });
+    // 权限交互：暂停过程区块渲染（恢复光标）→ readline 提问 → 恢复渲染。
+    // activeRenderer/activeView 由每轮 line 处理器维护，resolver 只在工具
+    // 执行期间被调用，此时当前轮的区块正处于运行中。
+    let activeRenderer = null;
+    let activeView = null;
+    const permissionResolver = async (request) => {
+        const renderer = activeRenderer;
+        const view = activeView;
+        if (renderer)
+            renderer.dispose();
+        process.stdout.write(`\n${C.yellow}⚠️  高危操作需要确认${C.reset}\n`);
+        process.stdout.write(`${C.dim}${request.detail}${C.reset}\n`);
+        const answer = await new Promise((resolve) => {
+            rl.question(`${C.green}允许一次(y) / 永远允许(a) / 拒绝(n) / 本会话允许所有(g) >${C.reset} `, resolve);
+        });
+        if (renderer && view)
+            renderer.begin(view);
+        const v = answer.trim().toLowerCase();
+        if (v === "y")
+            return "allow";
+        if (v === "a")
+            return "allow-always";
+        if (v === "g")
+            return "allow-session";
+        return "deny";
+    };
     let session;
     try {
         session = new ChatSession(args.config, {
@@ -345,17 +388,13 @@ async function runRepl(args) {
             cwd,
             persist: true,
             sessionId: resolvedSession.sessionId,
+            permissionResolver,
         });
     }
     catch (err) {
         console.error(`${C.yellow}${err.message}${C.reset}`);
         process.exit(1);
     }
-    const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout,
-        prompt: `${C.green}>${C.reset} `,
-    });
     let currentAbort = null;
     const ctrlCState = createCtrlCState();
     rl.prompt();
@@ -391,6 +430,8 @@ async function runRepl(args) {
         let view = null;
         if (renderer) {
             view = progressView({ headerTitle: "生成中..." });
+            activeRenderer = renderer;
+            activeView = view;
             // 先回行首换行再 begin：让过程区块从输入行下方开始，避免首帧 \r\x1b[2K
             // 清掉用户刚输入的问题行（历史文本不被刷掉）。\r\n 兼容 readline
             // 行提交后光标仍停在输入行行尾的情况。
@@ -446,6 +487,8 @@ async function runRepl(args) {
             console.error(`\n${C.yellow}[error] ${err.message}${C.reset}`);
         }
         finally {
+            activeRenderer = null;
+            activeView = null;
             if (renderer && view && !rendererEnded) {
                 // 定型终态区块（完成/已停止/异常结束）留在屏幕上，恢复光标
                 renderer.end(view);

package/dist/file-tools.d.ts

@@ -1,4 +1,5 @@
 import { type ToolSet } from "ai";
+import { type PermissionGate } from "./permissions.js";
 export interface ReadFileInput {
     path: string;
     startLine?: number;
@@ -140,4 +141,8 @@ export declare function createFileForTool(cwd: string, input: CreateFileInput):
 export declare function deleteFileForTool(cwd: string, input: DeleteFileInput): Promise<DeleteFileOutput>;
 export declare function moveFileForTool(cwd: string, input: MoveFileInput): Promise<MoveFileOutput>;
 export declare function applyPatchForTool(cwd: string, input: ApplyPatchInput): Promise<ApplyPatchOutput>;
-export declare function createBuiltinFileTools(cwd: string): ToolSet;
+export interface BuiltinFileToolsOptions {
+    /** 权限门控：副作用工具（run_command/文件写操作）执行前会先经过 gate.check */
+    permissionGate?: PermissionGate;
+}
+export declare function createBuiltinFileTools(cwd: string, options?: BuiltinFileToolsOptions): ToolSet;