WOI Coder
WOI Coder 是一款面向开发者的 VS Code 编程助手插件，集成 WOI 平台认证，支持 Claude Code CLI 或 OpenCode CLI 作为后端 Agent，提供流畅的 AI 辅助编程体验。
使用前提：需要有效的 WOI / WoiCrew 账号才能登录使用。本扩展为专有软件，源码不开源。
功能特性
- 🔐 WOI 平台登录 - 内置 WOI Crew 认证，一键登录获取访问令牌
- 💬 侧栏对话界面 - 原生 VS Code 侧栏 Webview，支持多会话管理
- 🤖 双后端支持 - 可选 Claude Code CLI 或 OpenCode CLI 作为 Agent 引擎
- 🛠️ 权限管理 - 灵活的权限控制模式，支持自动信任、编辑接受、严格模式等
- 📋 会话持久化 - 对话历史本地保存，支持新建、重命名、删除、清除
- 🔍 环境诊断 - 启动时自动检测依赖环境，确保插件正常运行
- 🧪 Harness 规范 - 集成 Harness 工作区同步，支持远程任务执行
前置依赖
- Node.js - 运行 CLI 后端
- Claude Code CLI 或 OpenCode CLI - 根据选择的后端安装
- Git Bash (Windows 可选) - 用于终端交互
快速开始
1. 登录 WOI 平台
点击侧栏 WOI Coder 视图中的 登录 按钮，或执行命令 WOI Coder: 登录，按照提示完成认证。
2. 配置后端
打开设置 (Ctrl+,)，搜索 WOI Coder，配置以下选项：
| 配置项 |
说明 |
默认值 |
agentBackend |
Agent 后端类型 |
claude-code |
claudeCodeCliPath |
Claude Code CLI 路径 |
claude |
opencodeCliPath |
OpenCode CLI 路径 |
opencode |
permissionMode |
Claude 权限模式 |
default |
cliTerminalMode |
CLI 终端镜像模式 |
off |
3. 开始对话
- 点击状态栏
$(sparkle) WOI Coder 打开对话
- 或在侧栏 对话 视图中点击
+ 新建会话
- 执行命令
WOI Coder: 开始对话
命令列表
| 命令 |
说明 |
WOI Coder: 登录 |
登录 WOI 平台 |
WOI Coder: Logout |
退出登录 |
WOI Coder: 开始对话 |
打开对话界面 |
WOI Coder: 新建会话 |
创建新会话 |
WOI Coder: 显示 CLI 输出终端 |
显示 CLI 输出 |
WOI Coder: 打开 CLI 交互终端 |
打开原生 CLI TUI |
WOI Coder: 设置 |
打开设置面板 |
权限模式说明
Claude Code 权限模式
| 模式 |
说明 |
default |
手动确认：删改文件、执行命令前弹出确认框（推荐） |
acceptEdits |
自动接受文件编辑和常见文件系统命令 |
dontAsk |
未在 allow 列表中的操作直接拒绝 |
bypassPermissions |
跳过权限检查（仅建议在隔离环境使用） |
plan |
仅规划模式：只读探索，不修改源码 |
auto |
后台分类器自动审批（研究预览） |
OpenCode 权限预设
| 预设 |
说明 |
default |
OpenCode 默认：按 opencode.json 规则 |
auto |
自动批准：扩展自动回复 permission.asked |
strict |
谨慎模式：bash / edit 经 VS Code 确认框 |
配置选项
完整配置列表请参考 VS Code 设置中的 WOI Coder 分类，主要选项包括：
woicoder.woiBaseUrl - WOI 平台 Base URLwoicoder.maxTurns - Agent 最大交互轮次（1-100）woicoder.claudeAutoTrustWorkspace - 启动前自动标记工作区为已信任woicoder.cliIdleTimeoutMinutes - CLI 空闲超时自动退出（分钟）woicoder.cliMaxConcurrentProcesses - CLI 进程并发上限
技术架构
src/
├── agent/ # Agent 运行时（Claude Code / OpenCode）
├── auth/ # WOI 认证与令牌管理
├── api/ # API 客户端（设备上报、模型列表）
├── chat/ # 对话界面与会话管理
├── config/ # 配置解析与端点推断
├── harness/ # Harness 规范同步与执行
├── services/ # 核心服务（模型服务等）
├── settings/ # 设置面板
└── utils/ # 工具函数
开发
# 安装依赖
npm install
# 编译
npm run compile
# 监听模式
npm run watch
# 类型检查
npm run lint
# 打包
npm run package
许可证
专有软件（Proprietary）。保留所有权利；未经授权不得复制、分发或公开。
| |
