huicai — VS Code 扩展
把 HuiCai 智能体带进 VS Code / Cursor：登录即聊。原始模型走本机工具循环（在你的真实工作区读写文件、
执行命令），智能体 / 业务数字人 / 工作流走平台编排（分享页同款对话）。另含工作区全量分析、当前文件分析、
选区与终端日志一键入上下文、内联 diff 审阅、SCM 改动视图与集成终端启动 huicai CLI。
快速开始
- 安装扩展后，点状态栏
huicai 登录（或命令面板 huicai: 浏览器授权登录）——打开浏览器确认授权码即可，
与 CLI 同一套设备码机制，令牌保存在 ~/.huicai/config.json（两边共用，任一端登录即可）。
- 点状态栏
huicai 打开对话面板直接聊；点旁边的目标名可切换模型 / 智能体 / 数字人 / 工作流。
- 右键选中代码 →「把选中代码加入对话上下文」；终端里选中报错日志 → 右键「把终端/日志选中内容加入对话上下文」。
- 命令面板：
huicai: 全量分析当前工作区 / huicai: 分析当前文件。
对话双模式
| 对话目标 |
执行方式 |
能力 |
| 原始模型（如 deepseek-v4-flash） |
本机工具循环（扩展内运行 CLI 核心） |
读写文件、搜索、执行命令、todo 进度、内联 diff 审阅、@文件引用 |
agent-* 智能体 |
平台编排 |
分享页同款对话：人格/知识库/服务端工具，自动显示名称与简介 |
datahuman-* 业务数字人 |
平台编排 |
自然语言查数（NL→SQL），结果表格化渲染 |
workflow-* 工作流 |
平台编排 |
输入作为启动参数，运行 DAG 返回结果 |
分析类命令需要本机工具，若当前目标是智能体/数字人/工作流，会自动切回默认原始模型执行。
终端集成（可选）
集成终端里跑 CLI 的能力仍在：安装 huicai CLI（npm link）后可用「打开终端智能体」等命令。
若未全局安装，在扩展设置 huicai.command 填绝对路径，如：node /abs/huicai-cli/bin/huicai.js。
自建/联调平台可在设置 huicai.baseUrl 覆盖平台地址（留空用内置默认）。
安装（开发/本地）
无需构建（纯 JS 扩展）：
- 调试运行：用 VS Code 打开本
vscode/ 目录，按 F5 启动「扩展开发主机」。
- 本地安装：
npx @vscode/vsce package 生成 .vsix，再「Extensions: Install from VSIX…」。
命令与面板
| 命令 |
说明 |
快捷键 |
| huicai: 打开对话面板 |
登录后直接聊天（本机工具循环 / 平台编排） |
点状态栏 huicai |
| huicai: 浏览器授权登录 / 退出登录 |
设备码流，与 CLI 共用令牌 |
— |
| huicai: 切换模型 / 智能体 / 数字人 / 工作流 |
分组选择对话目标 |
点状态栏目标名 |
| huicai: 全量分析当前工作区 |
结构→关键文件→质量/风险/建议报告 |
— |
| huicai: 分析当前文件 |
深析当前标签页文件（自动带诊断） |
— |
| huicai: 把选中代码加入对话上下文 |
选区以 chips 进入下一条消息 |
Ctrl/Cmd+Alt+L |
| huicai: 把终端/日志选中内容加入对话上下文 |
终端选区/剪贴板日志入上下文 |
终端右键 |
| huicai: 打开终端智能体 |
在集成终端启动 huicai（带上下文） |
— |
| huicai: 提问（带当前文件/选区） |
输入问题，带文件+选区+诊断上下文启动 |
Ctrl/Cmd+Alt+H |
| huicai: 解释选中代码 |
解释当前选区 |
Ctrl/Cmd+Alt+E |
| huicai: 继续最近会话 |
huicai -c |
— |
活动栏有 huicai 侧边栏：快捷操作 + 「最近会话」列表（点击即恢复该会话）。也可在编辑器右键菜单调用。
三项深度集成
1) 诊断上下文
提问/打开时，扩展把 Problems 面板的诊断（优先当前文件）经环境变量 HUICAI_IDE_DIAGNOSTICS 注入，
智能体作答时即知晓报错。文件/选区同样经 HUICAI_IDE_FILE/HUICAI_IDE_SELECTION 注入（多行安全，不塞命令行）。
2) 内联 diff 审阅
扩展在本地（127.0.0.1，随机端口 + 令牌）起一个服务，经 HUICAI_IDE_PORT/HUICAI_IDE_TOKEN 告知终端里的 CLI。
当智能体要写文件（write_file/edit_file）时，CLI 不直接落盘，而是把拟写内容发给扩展：弹出原生 diff 视图
（当前内容 vs 提案）+ 模态「应用 / 拒绝」；应用则经 WorkspaceEdit 写入（进入撤销历史并保存）。
CLI 侧此时跳过自身的 y/n 授权（以 IDE 审阅为准）。未经本扩展启动的终端里，CLI 仍直接写盘，互不影响。
3) 侧边栏面板
活动栏 huicai 视图（TreeView）：「操作」组（打开 / 提问 / 解释选中 / 继续会话）与「最近会话」组
（读 ~/.huicai/sessions，按当前工作区过滤，点击恢复）。标题栏有「对话面板」与刷新按钮。
4) SCM 视图（huicai 改动）
源代码管理面板出现「huicai 改动」分组，列出本会话 huicai 改过的文件；点击某项打开 diff（改动前快照 vs 当前）。
行内「放弃此改动」可回滚单个文件到改动前。
5) 多文件批量 diff
SCM 标题栏「审阅全部改动」用原生多文件 diff 一屏查看全部改动；「放弃全部改动」批量回滚。
6) 内嵌对话面板（webview）
命令「huicai: 打开对话面板」（或侧栏标题按钮）在编辑器旁打开对话 webview。它在扩展内进程直接运行 huicai 核心
（复用 CLI 的 Agent 循环、工具、MCP、子智能体、上下文压缩），流式渲染、行内授权按钮；写文件仍走上面的内联 diff 审阅
与 SCM 跟踪。会话与终端共享（存 ~/.huicai/sessions）。
需扩展与 CLI 源码同处仓库运行（F5 调试或从 vscode/ 打包）；无法加载核心时会提示改用终端。
设置
huicai.command：启动命令（默认 huicai）。huicai.extraArgs：附加参数数组，如 ["-m","某模型"]、["--agent","agent-xxx"]、["--yolo"]。
验证
- 静态冒烟（无需 VS Code）：
node vscode/smoke.cjs（或 npm --prefix vscode run smoke）——校验 manifest↔命令一致、webview JS 语法、核心可导入等。
- 运行时清单：见 VERIFY.md（F5 启动后逐项勾选各功能）。
限制
- 命令行引用按 POSIX（bash/zsh）转义；Windows 默认终端（PowerShell/cmd）可能需调整。
- 内联 diff 审阅要求写文件的终端由本扩展启动（以便注入服务端口）；在外部终端手动运行的 CLI 会直接写盘。
- webview 内嵌面板需扩展与 CLI 源码同处仓库运行（动态导入核心）；打包脱离仓库时回退到终端。
