ningzhi-agent-cli 0.0.1

package/dist/agent/permission/util.js

@@ -0,0 +1,347 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isInProjectDir = isInProjectDir;
+exports.isChangingDirectory = isChangingDirectory;
+exports.isScriptExecution = isScriptExecution;
+exports.isSafeCommand = isSafeCommand;
+exports.isDangerousOperation = isDangerousOperation;
+const node_path_1 = __importDefault(require("node:path"));
+const node_os_1 = __importDefault(require("node:os"));
+function isInProjectDir(filepath) {
+    const resolved = node_path_1.default.resolve(filepath);
+    const cwd = node_path_1.default.resolve(process.cwd());
+    // 检查是否在项目根目录下
+    if (resolved === cwd || resolved.startsWith(cwd + node_path_1.default.sep)) {
+        return true;
+    }
+    const ningzhiDir = node_path_1.default.resolve(node_os_1.default.homedir(), ".ningzhiAgentCli");
+    // 检查是否在项目根目录下的子目录下
+    return resolved === ningzhiDir || resolved.startsWith(ningzhiDir + node_path_1.default.sep);
+}
+/*
+    `(?:...)` 的`?:` 表示 非捕获组 ，只分组不保存匹配内容，
+    比普通`()` 开销略小且不污染`match()` 结果，
+    是纯布尔判断（`.test()` ）场景下的惯用写法。
+*/
+function isChangingDirectory(command) {
+    return /(?:^|[\s;|&])(?:cd|chdir|pushd|popd)(?:\s|$)/i.test(command);
+}
+// ==========================================================================
+// exec tool 中不能执行 py js 等脚本语言
+const PYTHON_TOOLS = ["python", "python3", "python2"];
+const JS_TOOLS = ["node", "nodejs", "tsx", "ts-node"];
+const OTHER_LANG_TOOLS = [
+    "java",
+    "javac",
+    "dotnet",
+    "go",
+    "cargo",
+    "rustc",
+    "ruby",
+    "php",
+    "perl",
+    "lua",
+    "rscript",
+];
+// 非 shell/bash/sh 脚本的文件扩展名
+const BLOCKED_EXTENSIONS = [
+    ".py",
+    ".js",
+    ".ts",
+    ".mjs",
+    ".cjs",
+    ".java",
+    ".cs",
+    ".go",
+    ".rb",
+    ".rs",
+    ".php",
+    ".pl",
+    ".lua",
+];
+// 获取命令的第一个 token
+// const trimmed = "git commit -m 'hello'" ;
+// trimmed.match ( /^([^\s]+)/ );    // ---> match[1] === "git"
+function getFirstToken(command) {
+    const trimmed = command.trim();
+    const match = trimmed.match(/^([^\s]+)/);
+    return match ? match[1] : trimmed;
+}
+function isScriptExecution(command) {
+    // 把一条可能包含 多段 shell 命令链 的输入，拆分成单个子命令
+    // "ls && npm test; echo done".split( /[;|&]+/ ).filter( Boolean )
+    // --→  ["ls ", " npm test", " echo done"]
+    const subCommands = command.split(/[;|&]+/).filter(Boolean);
+    for (const sub of subCommands) {
+        const token = getFirstToken(sub);
+        const tool = node_path_1.default.basename(token).toLowerCase();
+        const ext = node_path_1.default.extname(token).toLowerCase();
+        if (PYTHON_TOOLS.includes(tool) || ext === ".py") {
+            return {
+                blocked: true,
+                reason: "检测到 Python 脚本执行，请使用 run_py tool 执行 Python 代码。",
+            };
+        }
+        if (JS_TOOLS.includes(tool) ||
+            [".js", ".ts", ".mjs", ".cjs"].includes(ext)) {
+            return {
+                blocked: true,
+                reason: "检测到 JavaScript/TypeScript 脚本执行，请使用 run_js tool 执行 JavaScript/TypeScript 代码。",
+            };
+        }
+        if (OTHER_LANG_TOOLS.includes(tool) || BLOCKED_EXTENSIONS.includes(ext)) {
+            return {
+                blocked: true,
+                reason: `检测到 ${tool || ext} 脚本执行，exec tool 仅允许执行 shell/bash/sh 脚本。`,
+            };
+        }
+    }
+    return { blocked: false };
+}
+// ===============================================================================================
+// 允许的命令
+const SAFE_COMMANDS = [
+    "ls",
+    "pwd",
+    "cat",
+    "head",
+    "tail",
+    "grep",
+    "find",
+    "echo",
+    "date",
+    "whoami",
+    "id",
+    "uname",
+    "wc",
+    "sort",
+    "uniq",
+    "diff",
+    "which",
+    "whereis",
+    "file",
+    "stat",
+    "df",
+    "du",
+    "ps",
+    "pgrep",
+    "pstree",
+    "uptime",
+    "hostname",
+    "printf",
+    "readlink",
+    "realpath",
+    "tput",
+    "clear",
+    "reset",
+    "seq",
+    "yes",
+    "true",
+    "false",
+    "dir",
+    "type",
+    "findstr",
+    "more",
+    "tree",
+    "ver",
+    "vol",
+    "gci",
+    "gc",
+    "gl",
+    "sls",
+    "write",
+];
+// 允许的 git 子命令
+const SAFE_GIT_SUBCOMMANDS = ["status", "diff", "log"];
+// 获取命令的第二个 token
+function getSecondToken(command) {
+    const tokens = command.trim().split(/\s+/);
+    return tokens[1] || null;
+}
+// 检查命令是否安全
+function isSafeCommand(command) {
+    if (hasOutputRedirect(command))
+        return false;
+    const subCommands = command.split(/[;|&]+/).filter(Boolean);
+    for (const sub of subCommands) {
+        const token = getFirstToken(sub);
+        const tool = node_path_1.default.basename(token).toLowerCase();
+        if (SAFE_COMMANDS.includes(tool)) {
+            continue;
+        }
+        if (tool === "git") {
+            const subCommand = getSecondToken(sub)?.toLowerCase();
+            if (subCommand && SAFE_GIT_SUBCOMMANDS.includes(subCommand)) {
+                continue;
+            }
+        }
+        return false;
+    }
+    return true;
+}
+// ===============================================================================================
+// 阻止危险命令
+const DANGEROUS_COMMANDS = [
+    "sudo",
+    "doas",
+    "rm",
+    "rmdir",
+    "unlink",
+    "shred",
+    "del",
+    "erase",
+    "rd",
+    "remove-item",
+    "clear-item",
+    "mv",
+    "move",
+    "rename",
+    "ren",
+    "cp",
+    "copy",
+    "xcopy",
+    "robocopy",
+    "touch",
+    "dd",
+    "truncate",
+    "tee",
+    "mkdir",
+    "md",
+    "mkfifo",
+    "mknod",
+    "new-item",
+    "chmod",
+    "chown",
+    "chgrp",
+    "umask",
+    "setfacl",
+    "chflags",
+    "icacls",
+    "cacls",
+    "takeown",
+    "attrib",
+    "kill",
+    "killall",
+    "pkill",
+    "xkill",
+    "systemctl",
+    "service",
+    "launchctl",
+    "init",
+    "shutdown",
+    "reboot",
+    "halt",
+    "poweroff",
+    "crontab",
+    "at",
+    "batch",
+    "taskkill",
+    "sc",
+    "net",
+    "netsh",
+    "stop-process",
+    "start-process",
+    "restart-computer",
+    "useradd",
+    "usermod",
+    "userdel",
+    "groupadd",
+    "groupmod",
+    "groupdel",
+    "passwd",
+    "chsh",
+    "chfn",
+    "chage",
+    "su",
+    "runas",
+    "dscl",
+    "dseditgroup",
+    "env",
+    "printenv",
+    "history",
+    "ssh",
+    "scp",
+    "sftp",
+    "ftp",
+    "telnet",
+    "nc",
+    "netcat",
+    "ncat",
+    "curl",
+    "wget",
+    "nmap",
+    "masscan",
+    "zmap",
+    "iptables",
+    "ufw",
+    "firewall-cmd",
+    "nft",
+    "socat",
+    "proxychains",
+];
+// 匹配「外层 shell 再包一层」的调用形态，如：
+//   bash -c "rm -rf /"        → -c   分支，内层命令落在捕获组 1
+//   cmd /c "del C:\data"      → /c   分支，内层命令落在捕获组 2
+//   powershell -Command "..." → -Command 分支，内层命令落在捕获组 3
+// 三个分支共用 ("..."|'...'|\S+) 抓取内层命令体，(?:...) 为非捕获组
+const SHELL_COMMAND_SWITCH = /(?:bash|sh|zsh|cmd|powershell)\s+(?:-c\s+(".*?"|'.*?'|\S+)|\/c\s+(".*?"|'.*?'|\S+)|-Command\s+(".*?"|'.*?'|\S+))/i;
+// 去掉首尾成对的引号
+// `"abc"` → abc，`'abc'` → abc，`abc` → abc（原样返回）
+function unquote(str) {
+    if ((str.startsWith('"') && str.endsWith('"')) ||
+        (str.startsWith("'") && str.endsWith("'"))) {
+        return str.slice(1, -1);
+    }
+    return str;
+}
+// 从 bash -c "..." / cmd /c "..." / powershell -Command "..." 中剥出内层命令
+// 取非空的第一个捕获组（哪个分支匹配成功就用哪个），再去掉引号
+function extractShellSubCommand(command) {
+    const match = command.match(SHELL_COMMAND_SWITCH);
+    if (!match)
+        return null;
+    return unquote(match[1] || match[2] || match[3] || "");
+}
+// 检测输出重定向（覆盖 `> file`、`>> file`、`2> file` 等形态）
+// (^|[\s;|&])  →  重定向符必须出现在开头或分隔符之后，避免误伤 `a>b` 这类比较写法
+// \d?          →  可选的文件描述符编号（2> 1>）
+// >>?          →  覆盖覆盖写 `>` 与追加写 `>>`；\s 要求后面跟空白
+function hasOutputRedirect(command) {
+    return /(^|[\s;|&])\d?>>?\s/.test(command);
+}
+function isDangerousOperation(command) {
+    // 第一步：穿透「shell 包一层」的伪装
+    // "bash -c 'rm -rf /'" 本身第一个 token 是 bash（不在黑名单），
+    // 必须先剥出内层命令，递归检查一遍才能发现里面的 rm
+    const subCommand = extractShellSubCommand(command);
+    if (subCommand) {
+        const result = isDangerousOperation(subCommand);
+        if (result.blocked)
+            return result;
+    }
+    // 第二步：拆分命令链，逐段检查第一个 token 是否命中黑名单
+    // "ls && rm -rf /tmp" → ["ls ", " rm -rf /tmp"] → 第二段命中 rm
+    const subCommands = command.split(/[;|&]+/).filter(Boolean);
+    for (const sub of subCommands) {
+        const token = getFirstToken(sub);
+        const tool = node_path_1.default.basename(token).toLowerCase();
+        if (DANGEROUS_COMMANDS.includes(tool)) {
+            return {
+                blocked: true,
+                reason: `检测到危险操作 "${tool}"，exec tool 禁止执行该命令。如有需要请手动操作。`,
+            };
+        }
+    }
+    // 第三步：检查输出重定向（> 会改写文件系统，同样属于危险操作）
+    if (hasOutputRedirect(command)) {
+        return {
+            blocked: true,
+            reason: "检测到输出重定向，exec tool 禁止修改文件系统。如有需要请手动操作。",
+        };
+    }
+    return { blocked: false };
+}
+// ==========================================================================

package/dist/agent/permission/write.d.ts

@@ -0,0 +1,11 @@
+export declare function checkWritePermission(toolCall: {
+    name: string;
+    args: Record<string, any>;
+}): {
+    action: "allow";
+} | {
+    action: "block";
+    reason: string;
+} | {
+    action: "confirm";
+};

package/dist/agent/permission/write.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkWritePermission = checkWritePermission;
+const is_dangerous_path_1 = require("./is-dangerous-path");
+const util_1 = require("./util");
+function checkWritePermission(toolCall) {
+    const filepath = toolCall.args?.filepath;
+    if (filepath == null) {
+        return { action: "allow" };
+    }
+    if ((0, is_dangerous_path_1.isDangerousPath)(filepath)) {
+        return {
+            action: "block",
+            reason: `路径 "${filepath}" 是系统敏感目录，为保护系统安全，禁止访问。如有需要请手动操作。`,
+        };
+    }
+    if ((0, util_1.isInProjectDir)(filepath)) {
+        return { action: "allow" };
+    }
+    return { action: "confirm" };
+}

package/dist/agent/prompt.d.ts

@@ -0,0 +1 @@
+export declare const systemPrompt: string;

package/dist/agent/prompt.js

@@ -0,0 +1,52 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.systemPrompt = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_os_1 = require("node:os");
+const skills_1 = require("./skills");
+(0, skills_1.discoverSkills)();
+const skillsText = (0, skills_1.getSkillsListText)();
+// 基础提示
+const basePrompt = "You are a helpful assistant. Note that before answering any questions related to timeliness, first check the latest date and do not use your own expired date. For example, execute a 'new Date()' JS script to query";
+// 读取用户个人信息
+function readProfile() {
+    try {
+        const filePath = node_path_1.default.join((0, node_os_1.homedir)(), ".ningzhiAgentCli", ".data", "profile.md");
+        const content = node_fs_1.default.readFileSync(filePath, "utf-8").trim();
+        return `<profile_info>${content}</profile_info>`;
+    }
+    catch {
+        return "<profile_info></profile_info>";
+    }
+}
+// 用户个人信息提示
+const profilePrompt = `## User Profile
+
+When you learn information about the user that fits the following categories, store it as profile information for future personalization.
+
+<profile_template>
+- Basic identity: name, nickname, gender, age, region, language
+- Appearance: height, weight, skin tone, body type
+- Personality and communication preferences
+- Hobbies and interests
+- Skills
+- Work / occupation
+</profile_template>
+
+Here is the user's current profile information:
+${readProfile()}`;
+// 记忆管理规则
+const memoryPrompt = `## Memory Management Rules
+
+- When deleting a memory, first use memory_retrieve to find its id, then call memory_delete with that id. If no matching memory is found, politely inform the user.
+- When updating a memory, first delete the old memory, then create a new one.
+- When information fits the categories in <profile_template>, do not record it as a memory. It will be stored in the profile file instead.`;
+// 组装系统提示词
+exports.systemPrompt = skillsText
+    ? `${basePrompt}\n\n${profilePrompt}\n\n${memoryPrompt}\n\n
+## Available Skills\n\nYou have access to the following skills. When a user's request matches a skill's description, you MUST call the \`load_skill\` tool to load that skill's full instructions, then follow them.\n\n${skillsText}`
+    : `${basePrompt}\n\n${profilePrompt}\n\n${memoryPrompt}`;

package/dist/agent/skills/oppose/SKILL.md

@@ -0,0 +1,100 @@
+---
+name: oppose
+description: >
+  当用户表达观点、提出计划、做出决策、寻求建议、进行头脑风暴或表现出强烈立场时，
+  使用此 skill 主动提供建设性的反对意见和反面思考。即使用户没有明确要求质疑，
+  只要对话涉及观点讨论、方案评估、决策分析、策略制定、因果推断或价值判断，
+  就必须触发此 skill。如果用户只是询问客观事实、请求代码实现、要求生成文件、
+  进行纯技术操作或寻求情感支持，则不要触发。
+---
+
+# Oppose：建设性反对者
+
+## 目的
+
+默认情况下，AI 倾向于顺从用户、强化用户的既有观点。此 skill 要求你在适当场景下主动扮演"魔鬼代言人"（Devil's Advocate），提出有理有据的反对意见或反面思考，帮助用户发现盲点、检验假设、规避确认偏误。
+
+## 何时触发
+
+**必须触发的情况：**
+- 用户陈述个人观点（"我觉得..."、"我认为..."、"显然..."）
+- 用户提出计划、方案或策略（"我想..."、"我们应该..."、"方案是..."）
+- 用户做出判断或决策（"这个更好"、"选 A 不选 B"、"肯定是...的原因"）
+- 用户寻求认同或建议（"你觉得对吗？"、"给我点建议"）
+- 用户进行因果推断或预测（"因为 A，所以 B 一定会..."）
+- 用户表达强烈情绪化的立场
+- 用户要求对比选项并倾向某一方的场景
+
+**不触发的情况：**
+- 纯粹的事实查询（"Python 的 len() 函数怎么用？"）
+- 纯技术操作请求（"把这个文件转成 PDF"、"写一段排序代码"）
+- 明确的情感支持请求（"我今天很难过"）
+- 用户明确要求你不要反对或只想听一面之词（尊重用户当下的明确指令）
+
+## 如何提出反对意见
+
+### 核心原则
+1. **建设性优先**：反对不是为了赢，而是为了帮助思考更完整。
+2. **针对观点，不针对人**：永远不对用户的人格、动机进行攻击。
+3. **有理有据**：基于逻辑、事实、数据或合理的类比提出质疑，而非主观臆断。
+4. **适度反对**：通常提出 1-2 个关键反对角度即可，避免过度辩论让用户反感。
+
+### 反对的角度（选择最适合的 1-2 个）
+- **反例法**：是否存在与该结论相反的实例或场景？
+- **前提质疑**：这个结论依赖的假设是否一定成立？如果前提变了，结论还成立吗？
+- **因果倒置/混淆**：有没有可能是其他因素导致了这个结果？相关性不等于因果性。
+- **极端化检验**：如果把这个逻辑推到极端，是否会产生荒谬的结果？
+- **机会成本**：选择了 A，会失去什么？未选择的 B 有哪些被忽视的价值？
+- **时间维度**：这个方案短期有效，长期呢？或者反过来。
+- **受益者与受损者**：这个决策对谁有利？是否有被忽视的弱势群体或副作用？
+- **归因偏差**：是否把成功归因于能力、把失败归因于运气？（或反之）
+- **幸存者偏差**：你看到的数据是否是经过筛选的？失败案例被忽略了吗？
+- **黑 swan 风险**：有没有低概率但高影响的负面可能性？
+
+### 语气与措辞
+- 使用试探性语言："不过，有没有可能..."、"但如果从另一个角度看..."、"这里有一个潜在的盲区..."
+- 使用提问引导："你是否考虑过...的情况？"、"如果 X 不成立，结论会如何变化？"
+- 承认对方合理之处后再补充："你的思路在...方面很合理，但有一个风险点..."
+- 避免绝对化表达：不要说你错了，而说"另一个视角是..."
+
+## 输出格式
+
+**第一步：正常回应**
+先直接、诚实地回应用户的问题或观点。如果用户问了问题，先回答；如果用户表达了观点，先表示理解。
+
+**第二步：提出反对/质疑**
+在回应之后，自然地插入反对意见。使用分隔或过渡句，例如：
+- "不过，作为另一种思考角度..."
+- "但如果扮演一下'魔鬼代言人'，有几个点值得质疑："
+- "当然，这个判断有一个潜在的盲区："
+
+反对内容应简明扼要，1-2 点即可，每点 1-3 句话。
+
+**第三步：回归用户主权**
+结尾把判断权交还给用户：
+- "当然，你掌握的实际背景信息比我多，这只是供你交叉验证的一个角度。"
+- "这些反对意见未必成立，但检验它们或许能让你的结论更扎实。"
+
+## 示例
+
+**示例 1**
+用户：我觉得我们应该把全部预算投到短视频广告上，因为年轻人都在刷短视频。
+AI 回应：
+> 投短视频广告确实能触达大量年轻用户，逻辑上是合理的。
+>
+> 不过，如果换个角度想想：
+> 1. **幸存者偏差**：你看到"年轻人都在刷"，可能因为你所在的圈子和算法推荐让你看到的内容高度集中。那些不刷短视频或已经对其免疫的年轻群体，是否正好是你的目标用户？
+> 2. **机会成本**：全部预算押注单一渠道意味着放弃搜索广告、私域运营等其他可能带来更高转化率的渠道。如果短视频流量成本突然上涨或平台政策变化，团队是否有退路？
+>
+> 当然，你对产品和市场的实际感知比我更直接，这两个问题只是供你在最终决策前快速检验一下。
+
+**示例 2**
+用户：这个项目延期肯定是因为程序员效率太低。
+AI 回应：
+> 团队效率确实是影响交付的一个因素。
+>
+> 但从另一个视角看，"程序员效率低"这个归因可能过于简单：
+> - 需求是否在开发过程中频繁变更？如果是，表面上的"效率低"实际上是需求管理成本的体现。
+> - 延期是否从项目初期就可预见（比如估算阶段过于乐观）？如果是，问题根源在规划而非执行。
+>
+> 当然，如果你已经详细复盘过流程并有数据支撑你的判断，那我的质疑就不成立。

package/dist/agent/skills/planner/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: planner
+description: 帮用户创建 todo list、任务清单、日程计划或项目计划。当用户提到"待办"、"todo"、"计划"、"任务清单"、"日程"、"schedule"、"plan"、"任务分解"、"行程"时触发此 skill。即使用户只是说"帮我列一下要做的事"或"我想规划一下"，也应使用此 skill。
+---
+
+# Planner
+
+帮助用户创建结构清晰、可执行的 todo list 或计划。
+
+## 核心原则
+
+- **具体可执行**：每个任务应清晰到可以直接行动，避免模糊表述
+- **合理分组**：将相关任务归类，方便用户聚焦
+- **优先级明确**：区分紧急/重要，帮助用户知道从哪里开始
+- **时间感知**：有 deadline 时给出时间节点，无 deadline 时建议大致耗时
+
+---
+
+## 输出格式
+
+根据用户需求选择合适格式：
+
+### 简单 Todo List
+
+适用于：日常任务、购物清单、零散待办
+
+```
+## ✅ 今日待办
+
+### 🔴 优先处理
+- [ ] 任务 A（预计 30 分钟）
+- [ ] 任务 B
+
+### 🟡 今天内完成
+- [ ] 任务 C
+- [ ] 任务 D
+
+### 🟢 有空再做
+- [ ] 任务 E
+```
+
+### 项目计划
+
+适用于：多步骤目标、有时间跨度的任务
+
+```
+## 📋 项目：[项目名]
+
+**目标**：一句话说清楚要达成什么
+**周期**：起止时间或预计时长
+
+### 阶段一：[名称]（第 1-3 天）
+- [ ] 子任务 1
+- [ ] 子任务 2
+
+### 阶段二：[名称]（第 4-7 天）
+- [ ] 子任务 3
+```
+
+### 日程安排
+
+适用于：某一天或某段时间的时间表
+
+```
+## 🗓️ [日期] 日程
+
+| 时间 | 事项 | 备注 |
+|------|------|------|
+| 09:00 | 任务 A | |
+| 10:30 | 任务 B | 需提前准备材料 |
+```
+
+---
+
+## 操作步骤
+
+1. **理解需求**：从用户描述中提取目标、时间范围、资源限制
+2. **补充信息**（如有必要）：若信息太少，问 1 个最关键的问题（不要问多个）
+3. **选择格式**：根据任务性质选择上方合适的模板
+4. **生成计划**：输出结构化内容，加入适当 emoji 提升可读性
+5. **给出建议**：末尾可简短说明"从哪里开始"或注意事项
+
+---
+
+## 注意事项
+
+- 用户若未指定语言，跟随用户语言（中文输入→中文输出）
+- 任务数量控制在合理范围：单日 todo 不超过 10 项，项目计划不超过 5 个阶段
+- 若用户提供的目标过于宏大（如"学会编程"），主动拆解为近期可执行的第一步
+- 允许用户说"太多了"或"再简单一点"，灵活调整粒度

package/dist/agent/skills.d.ts

@@ -0,0 +1,8 @@
+export interface SkillInfo {
+    name: string;
+    description: string;
+    dirPath: string;
+}
+export declare function discoverSkills(): SkillInfo[];
+export declare function loadSkill(name: string): string | null;
+export declare function getSkillsListText(): string;