Skip to content
BranchesTags

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
README.md
README.md
 
 

Repository files navigation

ShunCode

把自定义 API、Codex 账号和网页版 AI，变成真正能操作本地项目的编程 Agent。QQ交流群：244627843

ShunCode 是一款基于 Code-OSS 深度定制的本地 AI 代码编辑器。它吸收了 Cursor、Windsurf、Claude Code、Codex CLI、OpenCode 等主流 AI 编程产品已经验证的交互共识：先理解项目，再规划任务；使用工具读取、搜索、修改和验证；并行执行可以并行的工作；所有改动都可审阅、可追踪、可回滚。

与封闭的一体化订阅不同，ShunCode 同时提供三条模型接入路径：

  1. 自定义 API：接入兼容 OpenAI Chat Completions 或 Responses API 的云端及本地模型。
  2. Codex 账号授权：通过 OpenAI 官方授权页面登录，使用 ChatGPT 订阅中的 Codex 能力。
  3. Bridge 桥接：把本地工作区作为 MCP Server，接入支持自定义 MCP Connector 的 ChatGPT、Claude、Grok 等网页 AI。

你可以按成本、模型能力、隐私要求和使用场景自由切换，不被单一模型厂商或单一计费方式锁定。

一句话定位

ShunCode 不是简单的“聊天窗口 + 代码复制按钮”，而是一套运行在编辑器内部的 Agent 工作台：

理解项目 → 搜索与定位 → 制定方案 → 安全修改 → 执行命令 → 读取诊断 → 验证结果 → 汇报交付

它既保留图形化 IDE 的低门槛、Diff 审阅和插件生态，也具备命令行 Agent 的工具自由度、自动执行能力和长任务处理能力。

核心优势

1. 原生 Agent，而不是外挂聊天框

  • Chat、模型选择、工具调用、任务进度、终端输出和代码 Diff 都在编辑器内完成。
  • AI 可以自主读取项目、搜索代码、定位定义与引用、修改多个文件、执行测试并检查诊断。
  • 工具结果会进入后续上下文，模型可以连续完成多步骤任务，而不是每一步都要求用户复制粘贴。
  • 支持流式输出、取消执行、超时控制、失败重试和可恢复检查点，长任务中断后不必从头开始。

2. Ask / Plan / Code 三种工作模式

模式 适用场景 权限边界
Ask 解释代码、回答问题、分析现状 只读，不修改文件，不运行命令
Plan 调研项目、评估方案、拆解实施步骤 只读，输出可执行计划和验证方案
Code 实际开发、修复、重构、测试与交付 可读取、修改、执行和验证

明确的权限分层可以减少误操作：需要讨论时不动代码，需要实施时再进入 Code 模式。

3. 并行工具调用，提高复杂任务效率

  • Agent Runtime 单批最多可并行执行 8 个工具调用。
  • 多文件读取、文件查找和搜索支持批量请求，减少模型与工具之间的往返次数。
  • 多条互不依赖的终端任务可以使用独立持久 PTY 并行运行。
  • 模型可以同时调查多个模块，再汇总结果，而不是按文件串行等待。
  • 工具输出记录执行耗时、并行批次和错误状态，便于模型判断下一步。

并行不是盲目地同时修改文件。涉及写入时，ShunCode 会进行补丁预检、版本校验和并发写入保护，在效率与安全之间保持平衡。

4. 安全、可验证的代码修改

ShunCode 使用结构化 apply_patch 作为主要修改工具：

  • 一次调用可以新增、更新、移动或删除多个文件。
  • 修改前检查上下文是否精确匹配，避免补丁落到错误位置。
  • read_files 返回文件版本哈希；写入时可通过 expected_versions 检测文件是否已被用户或其他任务修改。
  • 整个补丁先预检再写入，后续 hunk 失败时不会留下前半段修改。
  • 保留 UTF-8 BOM、CRLF/LF 等原始文件格式。
  • 返回由真实修改结果生成的标准 Unified Diff，而不是相信模型自己描述的修改。
  • 同一文件的并发写入会被串行化，过期写入会明确返回冲突。

这套机制借鉴了现代 Agent 编程工具“可审阅、可回滚、拒绝静默覆盖”的行业实践。

5. IDE 语义能力，而不只依赖文本搜索

ShunCode 直接调用当前 VS Code 语言服务：

  • 工作区符号和文档符号
  • 跳转定义
  • 查找引用
  • 查找实现
  • Hover 类型与文档信息
  • 当前错误、警告、提示和未保存文件诊断

模型可以先用文本搜索定位，再用 LSP 验证语义关系，降低仅凭字符串匹配产生的误判。

6. 真正可交互的持久终端

  • Windows 使用 Node PTY + ConPTY，提供独立于用户终端配置的持久 PowerShell。
  • POSIX 环境使用持久 Bash/Sh。
  • 支持交互式输入、REPL、安装提示、终端尺寸和 TTY 感知程序。
  • 命令超时后不会被强制杀死，可继续通过命令 ID 读取增量输出。
  • 支持后台服务器、Watcher、长时间构建和多个并行终端。

这比一次性 exec 更适合真实开发任务，例如启动开发服务器、等待编译、输入确认或持续读取日志。

7. 上下文按需读取，减少无效 Token 和卡顿

  • “+”菜单和拖动只保留文件、文件夹、终端三类清晰上下文。
  • 文件与文件夹默认只传名称和路径，不在发送前递归扫描或整包注入内容。
  • 模型真正需要内容时，再调用目录、搜索和读取工具。
  • 终端上下文使用有行数与字符数上限的文本快照。
  • 图片文件通过路径引用；Ctrl+V 粘贴图片可作为真实视觉输入发送给支持图片的模型。
  • 大文件、搜索结果和工具输出均有明确边界与截断标记，避免一次请求吞掉全部上下文窗口。

内置 Agent 工具

工作区读取与搜索

工具 能力
list_directory 查看已知目录的直接内容，限制深度，避免无控制递归
find_files 按一个或多个 Glob 查找文件，支持范围、排除规则和排序
search_files 文本或正则搜索，返回文件、行号、列号和有限上下文
read_files 一次读取多个文件或指定行范围，支持分页、大小限制和版本哈希

修改与审阅

工具 能力
apply_patch 多文件原子化预检补丁，支持新增、更新、移动、删除与冲突检测

语义与诊断

工具 能力
lsp 符号、定义、引用、实现、Hover 等语言服务能力
get_diagnostics 读取 VS Code 当前诊断，包括语言服务报告的未保存状态

命令执行

工具 能力
run_command 在持久真实 PTY 中执行前台或后台命令
get_command_output 按字节偏移增量读取长任务输出和状态
send_command_input 向交互式命令、REPL 或安装流程继续输入
wait 为后台构建、服务器或 Watcher 提供合理等待，不进行高频轮询

任务协作与扩展

能力 说明
任务进度 Bridge 提供 report_progress，网页 AI 可把当前阶段和完成度同步到编辑器
外部 MCP 可把请求级 MCP 工具加入 Agent 工具列表，与内置工具共同工作
自定义 Agent 支持自定义 Agent/指令，按任务选择不同工作方式

三种模型接入方式

方式一：自定义 API

Chat 模式可直接配置自己的模型服务：

  • 支持 OpenAI Chat Completions 协议。
  • 支持 OpenAI Responses API 协议。
  • 自动从 GET /models 加载模型列表；不提供该接口的服务可手动填写模型 ID。
  • API Key 使用 Secret 配置，不需要写入项目文件。
  • 可配置 Thinking、Reasoning Effort、上下文窗口、最大输出 Token、Temperature、Top P、Stop、Seed、惩罚参数等。
  • 可配置首 Token 超时、空闲超时、总超时、重试次数、并行工具调用和最大工具调用数。
  • 兼容 OpenAI、DeepSeek、OpenRouter 及其他实现相应 OpenAI 协议的服务，也可连接提供兼容接口的本地推理服务。

这条路径适合需要自选模型、自控成本、连接企业网关或本地模型的用户。

方式二：Codex 官方授权链路

ShunCode 内置 Codex 账号页：

  • 通过 auth.openai.com 的 OAuth 2.0 Authorization Code + PKCE 流程登录。
  • 浏览器完成授权，不要求用户手动复制访问 Token。
  • 凭据格式与官方 Codex CLI 兼容，默认共享 ~/.codex/auth.json。
  • ShunCode 与官方 Codex CLI 可以复用同一登录状态。
  • 自动刷新账号状态和 Codex 模型目录。
  • 使用 OpenAI Responses 协议、推理等级和并行 Tool Call 能力。

是否可用、可用模型、额度和速率限制取决于 OpenAI 账号、订阅方案及其当前政策。ShunCode 不出售或共享 OpenAI 账号。

方式三：Bridge 桥接网页版 AI

Bridge 会把当前 ShunCode 工作区暴露为受保护的 Streamable HTTP MCP Server。支持自定义 MCP Connector 的网页 AI 可以直接调用本地工具：

  • 读取和搜索项目
  • 应用多文件补丁
  • 执行命令并读取输出
  • 调用 LSP 与诊断
  • 汇报任务进度

这样可以复用用户已有的 ChatGPT、Claude、Grok 等网页订阅，而不需要把网页版对话手工复制到编辑器。各平台是否开放自定义 MCP、支持的账户范围及使用限制，以对应平台当前政策为准。

Bridge 的三种隧道方式

方式 地址特征 适用场景
Cloudflare Quick Tunnel 自动生成临时公网地址 最快开始、临时使用、无需提前配置域名
Cloudflare Named Tunnel 固定域名 + Tunnel Token 长期使用、稳定 Connector 地址、适合持续配置
ngrok Reserved Domain 固定 ngrok 域名 已有 ngrok 账号或保留域名的用户

Bridge 还包含：

  • Windows 下通过 Winget 一键安装并检查 cloudflared。
  • 本地和公网健康检查，确认 Connector 地址真正可访问后才报告就绪。
  • Token 化 MCP 路径，避免裸露一个无保护的固定入口。
  • Tunnel Token 和授权信息保存在 Secret Storage。
  • 支持持久模式、重新生成入口和切换隧道提供商。
  • 同一 Bridge 账号同时最多保留 2 台有效设备；新设备授权时自动替换最久未活动设备，不会同时授权第三台。

为什么它效率高

ShunCode 的效率来自工具设计和调度，而不是只依赖更长的 Prompt：

  1. 先搜索后读取：未知位置先搜索，定位后只读取需要的文件和行范围。
  2. 批量调用：多个文件、多个 Glob、多个搜索条件尽量在一个工具调用中完成。
  3. 并行调查：互不依赖的工具调用最多 8 路并行。
  4. 持久执行环境：命令、目录、环境变量和后台进程可以跨调用保持。
  5. 增量输出：长任务只读取新输出，不重复把全部日志发送给模型。
  6. 结构化诊断：优先读取 IDE 诊断，不需要模型从海量编译日志中猜测错误。
  7. 按需上下文：文件夹不递归灌入 Prompt，图片和大文件不会无条件编码上传。
  8. 写入防冲突：版本哈希和补丁预检减少返工与静默覆盖。

与主流 AI 编程工具的设计取向

下表概括的是典型产品形态，不代表其他产品所有版本的完整功能；各产品能力会持续变化。

维度 ShunCode Cursor / Windsurf 类 IDE Claude Code / Codex CLI 类 OpenCode 类开放 Agent
使用界面 完整 Code-OSS 图形化编辑器 完整图形化编辑器 以终端为主 以终端/TUI 为主
模型接入 自定义 API + Codex 授权 + 网页 Bridge 通常以平台内置模型和额度为主 通常与对应厂商生态深度绑定 多供应商 API
网页订阅复用 支持 MCP Bridge 通常不是核心路径 通常不是核心路径 取决于扩展
工具透明度 内置工具、Prompt、模型和 Bridge 均可查看与配置 由产品预设为主 官方 Agent 工具链 高度开放
修改体验 多文件补丁 + IDE Diff + 诊断 + LSP IDE 原生 Diff 终端补丁/确认 终端补丁/确认
长任务执行 并行工具 + 持久 PTY + 增量输出 + 检查点 产品内部调度 CLI Agent 调度 Agent 调度
本地控制 编辑器、工具和项目上下文均在本地运行 本地客户端 + 云服务 本地 CLI + 云模型 本地 Agent + 云/本地模型

ShunCode 的目标不是简单复制某个竞品，而是把行业中已经被验证的优秀实践组合在一个开放、可控、图形化的工作环境中。

典型使用场景

  • 理解陌生项目并输出架构说明。
  • 根据需求先生成实施计划，再进入 Code 模式执行。
  • 跨多个模块完成新功能、重构或迁移。
  • 定位编译错误、测试失败、类型错误和运行时问题。
  • 启动服务、观察日志、修改代码并再次验证。
  • 批量修改配置、接口、类型和测试。
  • 用截图分析 UI、报错页面、设计稿或图表。
  • 在网页 ChatGPT / Claude / Grok 中远程操作当前本地项目。
  • 在自定义 API、Codex 账号和网页订阅之间按任务切换。

0.5.7 更新

  • 原生 Chat/Agent 完整支持 Ask、Plan、Code 三种模式。
  • “+”菜单与拖动上下文统一收缩为文件、文件夹和终端。
  • 文件和文件夹只发送路径，模型按需调用工具读取，减少启动延迟与上下文浪费。
  • Ctrl+V 粘贴图片作为真实视觉输入；普通图片文件继续使用路径引用。
  • Agent 工具调用支持最多 8 路并行执行。
  • Codex 账号授权、模型目录和 Responses 请求链路进一步完善。
  • Bridge 支持 Cloudflare Quick Tunnel、Cloudflare Named Tunnel 和 ngrok Reserved Domain。
  • Bridge 设备满额时自动替换最久未活动设备，始终最多两台有效设备。
  • “帮助 → 关于”显示独立的 ShunCode 产品版本 0.5.7。

快速开始

  1. 下载并安装 ShunCode-0.5.7-win32-x64-Setup.exe。
  2. 打开一个项目文件夹。
  3. 选择一种模型接入方式：
    • 在模型管理中添加自定义 API；
    • 登录 Codex 账号；
    • 或启动 Bridge 并把 MCP 地址添加到网页 AI。
  4. 在 Chat 中选择 Ask、Plan 或 Code。
  5. 描述目标，让 Agent 自己读取项目、修改代码并执行验证。

推荐工作方式：

复杂需求：Plan → 审阅计划 → Code → 运行测试 → 审阅 Diff
简单问题：Ask
明确修改：Code

数据、隐私与安全边界

  • 项目工具在本地 ShunCode 进程中执行。
  • ShunCode 自有许可服务不接收你的源代码、对话内容或模型 API Key。
  • 自定义 API 请求会发送到你配置的模型服务，数据处理受该服务条款约束。
  • Codex 请求和账号数据受 OpenAI 的服务条款与隐私政策约束。
  • Bridge 数据会通过你选择的 Cloudflare 或 ngrok 隧道传输到对应网页 AI，受隧道服务商和 AI 平台政策约束。
  • API Key、Tunnel Token、登录 Token 和本地安装 ID 使用编辑器 Secret Storage 或对应官方凭据文件保存。
  • 对敏感仓库启用 Bridge 前，请确认第三方平台、隧道和组织安全政策允许该数据流向。

免责声明与购买须知

请在下载、购买或使用本产品前仔细阅读以下条款。下载、购买或使用即视为已阅读并同意全部内容。

  1. 产品性质。 ShunCode 是一款本地代码编辑器软件。本产品不出售、不出租、不赠送任何 ChatGPT、Claude、Grok 或其他第三方 AI 平台账号；不提供代付、代充、拼车、共享账号；不提供 API 中转、转售或代理服务。

  2. 接入原理。 网页版接入仅利用第三方平台公开提供的自定义 MCP Connector 能力。使用该功能需要用户自行注册、订阅并遵守对应平台服务条款。

  3. 第三方变更风险。 AI 平台、模型 API、MCP Connector、Cloudflare 和 ngrok 的能力由对应服务商维护。若第三方调整、限制或取消功能，由此导致的兼容性变化不属于 ShunCode 可控制范围。

  4. 账号与额度。 Codex、ChatGPT、Claude、Grok、自定义 API 和其他模型服务的账号、订阅、额度、速率限制与费用由用户自行向对应服务商承担。

  5. 数字商品。 本产品为数字软件，购买与退款规则以购买页面展示的有效条款为准。购买前请充分确认系统要求、功能范围和第三方服务条件。

  6. 按现状提供。 本软件按“现状”提供。在适用法律允许的最大范围内，开发者不对因使用本软件产生的间接损失、数据丢失、业务中断或第三方费用承担责任。

  7. 合法使用。 用户应仅将本软件用于合法用途，并对 Agent 执行的命令、代码修改、对外网络访问和最终交付结果进行审阅。

  8. 商标与归属。 Cursor、Windsurf、Claude、Claude Code、ChatGPT、Codex、Grok、OpenCode 及相关商标归各自权利人。本项目提及这些名称仅用于说明产品类别、兼容性或设计对比，不表示合作、授权、背书或关联。

© 2026 ShunCode AI · 保留所有权利

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

32 stars

Watchers

0 watching

Forks

4 forks
Report repository

Releases

Packages

Contributors