CnkeIDE 软件介绍

本地优先 AI 编程 IDE，基于 Electron + React 构建，面向全栈开发者与 Agent 开发爱好者。

市面上主流 AI IDE 普遍存在僵尸进程残留、上下文 Token 爆炸、任务中断不可恢复、MCP 无权限隔离、后台进程卡死等痛点。

CnkeIDE 以自研 Agent 引擎为核心，完整实现进程生命周期管控、上下文智能压缩熔断、MCP 细粒度权限隔离、任务自愈、断点续跑、Git 任务快照审计全套能力。

从 v1.3.3 起，同一套 Agent 内核还可脱离界面，在纯 Node 环境以 headless 命令行运行，工具、审批策略、模型路由、任务计划与桌面端完全一致，可直接嵌入 CI 与脚本流水线。

核心能力

• ▸自研 Agent 引擎：完整进程治理、熔断保护、崩溃断点续跑、验证自愈，稳定高效。
• ▸完整 MCP 协议生态：支持 Stdio / SSE 类型 MCP 服务，工具 Schema 动态裁剪，独立权限管控，操作审计日志。
• ▸全局进程治理：统一子进程管理器，自动销毁僵尸进程，监听进程崩溃异常，防止内存 / CPU 泄漏。
• ▸上下文治理：长会话自动摘要压缩，工具调用记录限额，解决上下文爆炸，提升工具调用准确率。
• ▸Git 任务快照：每次 Agent 任务自动生成 Git 检查点，支持一键回滚到任意历史任务节点。
• ▸分层配置：全局配置 + 项目工作区独立配置，不同项目加载独立 MCP、Agent 规则。
• ▸headless 命令行：无界面运行同一内核，支持 NDJSON 事件流、语义化退出码与无人值守审批策略，适合 CI 与自动化。

• Windows 10 / Windows 11，后续版本支持 MacOS、Linux
• 网络可正常访问大模型 API 接口

1. 前往官网下载页面获取安装包
2. 运行安装程序完成安装
3. 启动软件，新建或打开代码工作区

打开本地代码文件夹作为工作区，软件会在项目目录生成 .cnkeide 目录，存放本项目独立配置、技能脚本。

在「设置」页面填入 API Key、接口代理地址，选择对应模型，点击「测试连通性」确认接口正常。

支持 Stdio、SSE 两种 MCP 服务，可单独启用 / 禁用，可配置目录读写、Shell 执行、网络访问权限。

加载本地 .cnkeide/skills 技能目录，实现 Agent 能力扩展。

• 全局配置：所有工作区公用配置，保存在软件用户目录。
• 工作区配置：保存在项目目录，打开项目自动加载独立 MCP、Agent 参数。

• 内置完整进程管理、熔断保护、自愈恢复逻辑；
• 崩溃断点续跑，任务中断可恢复继续执行；
• 工具调用统一调度，危险操作自动拦截确认。

• Ask 问答：仅对话，不修改代码，专注解释与讨论。
• Craft 快速：读写文件执行命令，局部精准改动，自动完成开发任务。
• Plan 深度：全量 Agent，先生成完整方案，确认后执行，规划 + 工具 + 自愈。
• Debug 调试：围绕报错与异常推进，优先读取日志、运行测试、定位根因后再改动。

输入框上方可随时切换模式；命令行下用 --mode ask|craft|plan|debug 指定。

• 熔断条件：Token 上限、最大执行时长、连续工具失败次数，触发暂停任务。
• 自愈：自动尝试修复报错，可自定义自愈最大轮次。
• 断点续跑：软件崩溃重启后，恢复上一轮任务继续执行。

开启会话自动摘要压缩，设置工具调用历史限额，MCP 工具 Schema 动态裁剪，缓解长会话 Token 爆炸问题。

在侧边栏选择「演示文稿」即可打开独立的 PPT 工作台。核心价值是 把「介绍 / 汇报一个项目」这件事交给 AI： 自动读取当前工作区的 README、目录结构与文档，提炼出项目定位、功能、技术栈与架构亮点， 生成逻辑递进的大纲，再套用模板输出可交付的 PPTX 文件。

三种创建方式

大纲可视化精修

• 左侧逐页展开，直接编辑每页标题与要点条目，支持增删页、调整顺序
• 支持单页 AI 细化与全部 AI 细化：把粗略要点扩写成完整表述
• 细化时可附加个性化要求（如「偏技术向，多给数据」「语言口语化」），AI 会按约束重写
• 在大纲确认前可反复调整，避免生成后返工

模板库内置在服务器端，客户端可直接浏览、搜索、下载并套用真实 PPTX 模板， 比内置主题更贴近实际汇报场景（尤其是国内各类评审、答辩、总结模板）。

操作步骤

1. 在 PPT 工作台切换到顶部「模板库」标签页
2. 用分类筛选（文化 / 节日 / 科技 / 教育 / 营销 / 商务等）或关键词搜索缩小范围
3. 浏览缩略图，选定后点击「下载模板」，模板会缓存到本地
4. 点击「套用此模板并保存到工作区」，大纲内容会自动写入模板的标题位与正文位
5. 生成结果保存在当前工作区，可直接在 PowerPoint / WPS 中继续编辑

套用逻辑说明

• 套用采用版式识别策略：自动区分封面页、目录页、分节页、内容页、结尾页，按类型分别填充
• 模板自带的装饰性元素会原样保留——单字水印（如「淡」「雅」「壹」）、序号、分隔符不会被当作占位内容覆盖
• 模板自带的装饰性成句文案（诗句、引文、标语，如「路漫漫其修远兮」）同样受保护，不会被大纲内容顶替
• 若模板某页版式无法识别，会退化为占位符替换策略，尽可能保留原设计

生成完成后可导出为可编辑的 PPTX 或用于分享的 PDF。

内置主题与版式

不套用服务器模板时，可使用内置主题直接生成：

支持的页面元素

页面内可承载图片、表格与 图表（柱状图 / 折线图 / 饼图）， 适合需要展示数据趋势或产品截图的场景。

让 AI 在大型项目里也能快速找对上下文，而不是靠你手动翻文件复制粘贴。

• 三路召回融合：关键词检索 + 语义向量检索 + 符号检索，结果按加权融合后排序，比单一策略更稳
• 符号级理解：按函数 / 类 / 方法切分代码块，能直接定位定义与引用关系
• 增量索引：文件内容未变则跳过重建，重复检索不重复计算
• 引用语法：@文件 注入文件内容、@目录 注入目录清单、#codebase 你的问题 触发仓库级检索
• 无需额外配置：复用你已配置的模型接口做向量化，不强制再申请一套 API

配置了多个模型时，不必每次手动切换——软件会根据任务特征自动选型，在效果与成本之间取平衡。

• 能力矩阵：内置国内主流模型的能力档案，按 旗舰 / 标准 / 快速 / 推理 四档归类
• 任务识别：自动区分视觉理解、深度推理、规划、编码、摘要、闲聊等任务类型
• 手动覆盖：在对话中用 @模型名 可强制指定，优先级最高
• 一致性保证：同一轮任务内不会中途切换模型，避免上下文理解漂移

把长文档交给 AI 检索问答，不必再把整份资料复制进对话框。

支持的格式

工作方式

• 文档本地解析并切块建索引，按段落优先、长段落滑窗重叠的方式分块
• 提问时检索最相关的若干片段作为上下文交给模型，回答会附带来源编号引用
• 表格文件会自动截断超大数据（前 4 个工作表、每表前 500 行），避免一次性撑爆上下文
• 未配置向量模型时自动降级为关键词检索，功能可用性不受影响

统一管控终端、扩展、浏览器、Agent 所有子进程；关闭工作区自动销毁全部进程，杜绝僵尸进程。

限制每个 MCP 服务读写目录、Shell 执行、网络访问，防止 MCP 服务越权操作本地文件。

高危 Shell 命令、大文件覆盖、目录删除操作弹窗确认，超时拒绝执行，保护本地代码安全。

完整记录全部文件修改、命令执行、工具调用，支持查询与导出审计记录。

选中代码，按下 Ctrl+K 唤起内联 AI 对话，直接修改选中片段，实时预览 Diff 变更。

在编辑器里正常敲代码，光标处会以灰色 ghost-text 形式给出补全建议，按 Tab 采纳，继续输入或按 Esc 忽略。

• 上下文感知：提示由当前文件内容 + 光标前后代码构造，不需要额外写说明。
• 成本可控：结果做 LRU 缓存，同一位置重复触发不重复请求；并发去重，快速连打不会堆积请求。
• 随时打断：按 Esc 立即取消在途请求，不阻塞输入。
• 可关闭：设置 → 编辑器 内可整体开关，不想用时零打扰。

对话输入框使用 @文件名，将指定文件送入模型上下文。

Agent 每次执行任务自动生成 Git 快照检查点，可以一键回滚到任务执行前的代码状态。

内置终端与调试面板，Agent 执行的 Shell 命令可以直接在内置终端回放查看。

工作区、资源管理器、编辑器、终端四个视图共享同一份数据源，任一视图中的导航或操作都会实时同步到其他视图，无需手动切换或刷新。

• 任务计划状态机：多步骤任务先建计划，步骤状态严格单向推进（待办 → 进行中 → 已完成 / 失败 / 跳过），终态不可回退，避免跑飞。
• 计划工具：create_plan / add_plan_item / update_plan_status / get_plan，进度可视化。
• 并行工具调度：按 DAG 拓扑排序并发执行，只读工具可并发、同文件写入串行、终端命令全局串行，默认并发上限 4，单个工具仍走审批。
• 失败处理：某步骤失败会标记该节点并回注结果，Agent 依据计划继续或补步骤，而不是整轮重来。

• 直接粘贴：在输入框 Ctrl+V 粘贴截图，自动转多模态消息发给模型，无需先存成文件。
• 可叠加文字：截图 + 文字说明一起发送；也支持只发图片不写文字。
• 会随会话保存：图片与消息一起持久化，重新打开会话仍能看到，导出 / 分叉 / 回滚均保留。
• 模型要求：需所选模型支持视觉输入（如 Qwen-VL、GLM-4V 等）；纯文本模型只收到文字部分。

把 IDE 内的 Agent 内核搬到纯 Node 进程运行，用于 CI、脚本、管道等无窗口场景。工具、审批策略、模型路由、任务计划、文档检索与桌面端完全一致，差别只在窗口适配层。

典型用法

# 一次性任务
cnkeide -p "把这个报错修掉" --cwd ./repo

# 从管道读任务
git diff | cnkeide --stdin --mode debug

# CI 内机器可读输出
cnkeide -p "修复 lint" --json --approve-policy never

# 只取最终文本，方便 shell 变量
TEXT=$(cnkeide -p "总结这次改动" --final-only)

常用参数

输出与退出码

• stdout 只有数据：默认流式文本，--json 为事件流，--final-only 只有最终结果；所有日志走 stderr，管道友好。
• 事件类型：run_start、assistant_delta、thinking、tool_call、tool_result、context_state、usage、error、run_end。
• 退出码：0 成功 / 1 失败 / 2 用法错误 / 3 审批被拒 / 4 上下文超限 / 124 超时。

无人值守审批

• 无窗口时不再等弹窗超时：命中审批规则后交给命令行裁决器判断。
• untrusted（默认）只放行只读工具，写文件与执行命令一律拒绝且不落盘。
• 需要放开时用 --allow-tool / --allow-command-pattern 精确授权，或 --approve-policy never 全放行（建议只用于 CI 容器）。

数据目录

命令行默认使用 ~/.cnkeide，与桌面端隔离，避免脚本运行改写桌面配置。要复用桌面端已配好的模型：

cnkeide -p "..." --data-dir "%APPDATA%/CnkeIDE"

• 检查更新：设置 → 关于 → 软件更新，可手动检查；启动后也会自动静默检查一次。
• 增量热更新：基于 blockmap 差分下载，只传变更部分；下载完成校验 SHA512 后才允许安装。
• 失败重试：网络中断自动重试（默认 3 次，指数退避），也可点取消后重新下载。
• 强制更新兜底：服务端可下发最低可用版本，当前版本过低时会弹不可跳过的提示，避免旧版本连接新接口失败。
• 手动覆盖安装：自动更新异常时，直接从下载页覆盖安装即可，会话、工作区与模型配置全部保留。

每次更新的详细说明见 更新说明，历史版本与公告见 公告中心。

• 应用内公告：版本更新、重要变更会以公告形式弹出，可在公告中心查看历史，同一条只需读一次。
• 网页公告中心：ai.cnkes.cn/announcements/，与客户端同源，不装软件也能看。
• 意见反馈：ai.cnkes.cn/feedback/，提交问题与建议，可附联系方式；也可在应用内反馈入口提交。
• 问题定位建议：反馈时附上版本号、模型配置（勿贴 API Key）、复现步骤与截图，处理更快。