xusuyang030218/dsh-code-workbench

dsh-code-workbench

DSH 代码工作台插件：在输入栏添加「💻 代码」按钮，用户可上传代码文件（单/多），AI 读取后进行修改、优化、重构、审查、评测，修改后的代码可一键下载或复制，并展示 diff 差异视图与评测报告。

与 dsh-doc-import 的区别

- dsh-doc-import：只读文档/代码 → AI 在对话中回复（无下载、无 diff、无结构化评测）
- dsh-code-workbench：专注代码 → AI 修改后生成可下载文件 + diff 视图 + 评测报告

核心功能

| 功能 | 描述 |
|------|------|
| 代码上传 | 多选/多拖代码文件 + 文件夹递归导入（自动过滤 .git/node_modules/二进制/资源文件） |
| 粘贴代码 | 不必落成文件，「＋粘贴」直接建文件参与处理（N1） |
| 勾选圈定 | 文件级 checkbox 决定提交范围，提交按钮实时显示「提交 · N 个文件」（N2） |
| AI 直连 | 面板底部直连 DeepSeek 等已配置 API（可选模型），直接对话或「修改选中」写回版本 |
| 语法高亮预览 | 源码视图带行号 + 语法高亮（关键字/字符串/注释/数字/函数名/HTML 标签） |
| AI 修改指令 | 操作类型：审查 / 修Bug / 重构 / 性能 / 注释 / 测试 / 转语言 |
| Diff 双模式 | 统一 / 并排切换 + 词级高亮 + 未变更行折叠 + +N −N 统计徽章（N5） |
| 版本历史 | 每次修改追加版本记录（AI / 手动编辑 / 回滚），任意两版对比、回滚、下载（N4） |
| 源码可编辑 | 编辑态 textarea 叠加高亮层，保存生成新版本（N3） |
| 评测报告 | AI 生成 Markdown 评测报告，面板内 mini 渲染（N7） |
| 下载 | 单文件（可指定版本）+ 按勾选打包 .zip（N8，文件夹文件保留子目录） |
| 交互 | 快捷键（⌘⏎ 提交 / Esc 关闭 / ⌘F 搜索）、面板最大化、文件栏宽度拖拽、轻量元数据轮询 |
| 历史记录 | 本次会话内所有上传 + 修改记录可回看（内存存储，不持久化） |

使用流程

1. 点击输入栏「💻 代码」按钮 → 弹出 v3 三区工作台（顶栏 / 文件栏 / 编辑区 / 命令栏）
2. 拖入/选择代码文件、「📁 文件夹」递归选择整个目录，或「＋粘贴」直接粘贴代码
3. 勾选要参与的文件（未勾选的不进入提交指令），文件栏宽度可拖拽
4. 在命令栏选择操作类型，可选补充要求
5. 「⌘⏎ 提交 · N 个文件」→ AI 经 code_workbench 工具读取/修改/评测
6. 面板轻量轮询，完成后在「源码 / Diff / 报告 / 历史」四视图中查看结果
7. 不满意可「编辑」手动微调保存为新版本、回滚到任意历史版本、按勾选打包下载

架构

src/                      # TypeScript 源码（tsc 构建 → lib/）
client.ts              浏览器半（React 面板 + 自写语法高亮 token 化器 + LCS diff + AI 助手）
host/
index.ts             host 工具半：code_workbench 工具 + 系统提示
web.ts               web 路由半：上传/粘贴/编辑/版本/下载 + AI 直连端点
ai.ts                AI 直连：provider 解析（credentials+settings）+ chat/apply
parse.ts             语言检测 + 行数 + 文本解码 + 二进制嗅探 + ZIP 打包（node:zlib）
store.ts             内存存储 + 版本历史（进程内 Map，不落盘）
lib/                      tsc 构建产物（随仓库提交，profile 直接运行）
cordis.patch.yml         两行 host 半注册

零外部依赖

- 语法高亮：自写正则 token 化器（关键字/字符串/注释/数字/函数名/HTML 标签）
- Diff：自写 LCS（最长公共子序列）逐行对比
- ZIP：node:zlib 的 deflateRawSync + 手写中央目录（自带 CRC32 查表实现）
- 语法高亮 CSS：内联在 client.js 注入

工具

code_workbench：read（读取代码）/ modify（存储修改后代码）/ review（存储评测报告）/ list（列出文件）。

路由

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | /dsh-code-workbench/ai/providers | 可选 AI 接口列表（DeepSeek 官方 + llm-pi-ai 中转，脱敏） |
| POST | /dsh-code-workbench/ai/chat | 面板内直接对话（OpenAI 兼容 chat/completions） |
| POST | /dsh-code-workbench/ai/apply | AI 修改选中文件并写回为新版本（解析 JSON 修改清单） |
| POST | /dsh-code-workbench/upload | 上传单个代码文件（原始字节 + x-file-name，二进制自动拒绝） |
| POST | /dsh-code-workbench/paste | 粘贴代码建文件（body JSON { name, content }） |
| PUT | /dsh-code-workbench/file/:id | 手动编辑保存（追加 manual 版本） |
| POST | /dsh-code-workbench/rollback/:id | 回滚到指定版本（body { to: v }，追加 rollback 记录） |
| GET | /dsh-code-workbench/list?meta=1 | 全量记录 / 轻量轮询元数据（不含大字段） |
| GET | /dsh-code-workbench/version/:id/:v | 读取指定版本内容（历史查看/对比用） |
| GET | /dsh-code-workbench/download/:fileId?version=N | 下载单个文件（指定版本，缺省当前） |
| GET | /dsh-code-workbench/download-all?ids=a,b | 按勾选 id 打包 .zip（缺省全部，保留相对路径子目录） |

AI 直连

面板底部「🤖 AI 助手」直连 DSH 已配置的 LLM 接口，无需经过宿主对话流：

- 接口来源：DeepSeek 官方（DEEPSEEK_API_KEY）+ settings.yaml 里 llm-pi-ai.providers 配置的中转（codex/claude 等）
- API Key：经 DSH credentials 服务读取（环境变量优先，其次 $DSH_HOME/.credentials.yaml），key 只留在 host 端，不下发浏览器
- 对话：选择模型直接提问（可勾选「附文件」把选中文件作为上下文）
- 修改选中：AI 返回 JSON 修改清单，逐文件写回为新的 ai 版本，可继续 diff / 回滚 / 下载

安装（v0.3 TypeScript 版）

1) 构建（tsc 编译 src/ → lib/，lib/ 已随仓库提交，可跳过）
cd D:\dsh-code-workbench
pnpm install          # 装 typescript 等 devDependencies
pnpm run build

2) 注册到 web profile
cd C:\Users\23074\.dsh\profiles\web
pnpm add dsh-code-workbench@link:D:\dsh-code-workbench
并在 profiles/web/package.json 的 dsh.profile.bundles 中加入 "dsh-code-workbench"
在 pnpm-workspace.yaml 的 allowBuilds 中加入 "dsh-code-workbench"
dsh --profile web --dump-config   # 验证加载

License

Apache-2.0