minhdevtry/dsh-markdown-ide

@anoslide/dsh-vscode-workspace

统一的 3 栏 VS Code 工作区、TipTap Notion 所见即所得套件，以及面向 DeepSeek Harness (dsh) 的高级 AI 生产力插件。

📖 概述

@anoslide/dsh-vscode-workspace 是一个与上游保持一致、双面（Dual-Face）的 Cordis 插件，专为 DeepSeek Harness 打造。它将整个后端工作区文件服务与现代 IDE 前端统一到单个包中，取代了旧版解耦插件（@anoslide/dsh-host-files 和 @anoslide/dsh-client-vscode-layout）。

它结合了：
- 一个 3 栏 VS Code IDE 布局（资源管理器、搜索、Git 源代码管理、多标签代码与 Markdown 工作台，以及可折叠的 AI 聊天与工具轨迹）。
- 一套 TipTap Notion 所见即所得文档套件（交互式块、斜杠命令 /、标注框、折叠列表、交互式表格、KaTeX 数学公式、Mermaid 图表，以及目录大纲）。
- 深度 AI 聊天集成（真实的蓝色引用芯片、类 Cursor 的 Ctrl+K 内联 AI 辅助、@ 文件提及自动补全，以及一键应用代码）。
- 知识与生产力工具（交互式知识图谱视图、内嵌 Excalidraw 白板，以及可视化并排 / 统一 Diff 查看器）。

🏛️ 架构：双面 Cordis 模型

DeepSeek Harness 采用模块化的 Cordis 微内核架构。@anoslide/dsh-vscode-workspace 实现了 双面（Dual-Face） 结构，其中单个包同时提供 Node.js 宿主服务和浏览器微前端客户端 bundle。

flowchart TD
subgraph DSH["DeepSeek Harness Platform (Cordis Kernel)"]
Launcher["dsh CLI Launcher (dsh web)"]
Profile["Profile Bundle Layer (~/.dsh/profiles/web)"]
CordisHost["Cordis Host Container (Node.js 22)"]
CordisClient["Cordis Web Client (Browser Runtime)"]
end

subgraph UnifiedPlugin["@anoslide/dsh-vscode-workspace"]
Patch["cordis.patch.yml(inserts vscode-workspace)"]

subgraph HostHalf["Host Node.js Half (lib/index.js)"]
WebServer["ctx.webServer Injection"]
HostRoutes["/vscode-files/* Endpoints"]
FS["File Service & Sandbox Guards"]
Git["Git Porcelain Service"]
Shiki["Shiki Syntax Highlighter"]
Persona["Persona System Prompt Hook"]
end

subgraph ClientHalf["Client Browser Half (lib/client.js)"]
ModuleLoader["window.__ModuleLoader__(Lazy-CJS Closure Factory)"]
Slots["ctx.slots.register('root', AppFrame)"]

subgraph Layout["3-Column IDE Workbench"]
Rail["Sidebar Rail & Switcher (Explorer, Search, Git)"]
Editor["Multi-Tab Editor (CodeMirror + TipTap)"]
Chat["AI Chat Tray & Reference Chips"]
end

subgraph Tools["Productivity Modules"]
Excalidraw["Excalidraw Whiteboard"]
Graph["Knowledge Graph"]
Diff["Visual Diff Engine"]
end
end
end

Launcher --> Profile
Profile --> Patch
Patch --> CordisHost
Patch --> CordisClient

CordisHost --> WebServer
WebServer --> HostRoutes
HostRoutes --> FS
HostRoutes --> Git
HostRoutes --> Shiki
HostRoutes --> Persona

CordisClient --> ModuleLoader
ModuleLoader --> Slots
Slots --> Layout
Layout --> Tools

ClientHalf -.->|"HTTP /vscode-files/"| HostRoutes

🌟 核心功能

1. 🖥️ 专业三栏 VS Code IDE 布局
- 左侧边栏与活动栏（280px）：
- 🐋 宿主活动栏集成：保留原生 ui-sidebar 控件（新建会话、会话、设置），同时通过 sidebar.footer.action 座位贡献一个交互式切换器。
- 📁 资源管理器（Ctrl+Shift+E）：分层工作区文件树，带实时 Git 状态徽章（M、U、A、D、R）、隐藏文件切换（👁）、目录创建，以及删除到操作系统回收站。
- 🔍 搜索（Ctrl+Shift+F）：高性能递归工作区搜索，支持文件名和全文内容匹配（ripgrep）、大小写敏感切换（Aa）、正则表达式支持（.）以及匹配计数徽章。
- ⑂ 源代码管理（Ctrl+Shift+G）：暂存、取消暂存、丢弃和提交更改，带差异预览和提交日志历史。
- 💬 会话：将整列以全宽交还给宿主的会话管理。通过 Ctrl+B 折叠会将面板隐藏到 56px 活动栏，而不会丢失导航。
- 中央工作区（多标签工作台）：
- 独立的编辑器标签页，支持拖放重新排序、活动标签指示器和脏状态徽章（• 未保存圆点）。
- 由 Shiki（github-dark / github-light）驱动的高性能服务端语法高亮，同时为代码文件提供交互式 CodeMirror。
- 交互式面包屑导航：编辑器上方的可点击目录层级，用于快速路径导航。
- 状态栏：实时 Git 分支（🌿 main）、活动文件路径、行与列指示器、字数统计、UTF-8 编码、语言模式徽章，以及 💾 自动保存：开/关 切换。
- 标签页上下文菜单（关闭、关闭其他、关闭左侧/右侧、全部关闭、📋 复制路径）。
- 右侧栏（AI 聊天与工具轨迹）：
- 无缝嵌入的 AI 对话面板和实时工具执行流。
- 在 全宽编辑器画布 和 三栏 IDE 布局 之间一键切换（Ctrl+L）。
- 面板折叠时显示浮动的 打开聊天 胶囊按钮。

2. 📝 TipTap Notion 所见即所得文档套件
- 交互式块编辑：Markdown 文件（.md）直接渲染为丰富、可交互的 Notion 风格块。
- 可折叠切换列表（/toggle）：可折叠的摘要和详情块，与 Notion 的用户体验一致。
- Notion 标注（/callout 或 💡）：高可见度的标注框，带自定义图标和背景色调。
- 斜杠菜单（/）：输入 / 即可插入标题（H1/H2/H3）、切换列表、任务列表（[ ]）、交互式表格、标注框、语法高亮代码块、块引用、KaTeX 数学公式、Mermaid 图表和 YouTube 嵌入。
- 交互式表格：动态添加和删除行与列，表头行可切换。
- 数学公式：支持行内和块级 KaTeX 渲染（$E=mc^2$ 和 $$\int ...$$）。
- Mermaid 图表：在笔记内实时渲染流程图、序列图和架构图。
- 文档大纲（📑 Outline）：滑出式目录抽屉，显示层级化的 H1、H2 和 H3 标题，支持点击滚动导航。
- 一键导出套件（📤 Export）：
- 📋 Copy Clean Markdown
- 📋 Copy Formatted HTML
- 📄 Print / PDF Preview（window.print()）
- 智能自动保存引擎：1.5 秒防抖，静默将文档编辑持久化到磁盘，并显示微妙的 Saved ✓ 指示器。
- Notion 拖拽手柄：悬停在块上即可轻松拖拽并重新排序内容。
- 浮动选区气泡菜单：高亮文本即可格式化：粗体（B）、斜体（I）、下划线（U）、删除线（S）、行内代码（）、🎨 文本与高亮颜色、💬 Mention in Chat 和 🤖 Ask AI。

3. ⚡ AI 聊天集成与引用芯片
- 原生蓝色引用芯片（OccurrenceChip）：
- 在聊天中输入 @：工作区文件会出现在原生 @ 菜单中，并支持即时搜索。
- 选择文件候选项后，会将原生引用芯片（@filename）直接插入到输入框中。
- 自动行范围精确化：当活动编辑器中有文本被选中时，提及会格式化为精确行号（例如 @AppFrame.tsx#L45-80）。
- 智能 Ctrl+L 导航：
- 编辑器中有选区时：将选区格式化为引用芯片插入聊天，并聚焦输入框。
- 无选区时：切换右侧 AI 聊天面板的打开或关闭，且不会抢占编辑器焦点。
- 行内代码操作按钮：
- AI 响应中的每个代码块都提供一键 ⚡ Apply to Tab（替换选区或写入活动文件）和 📋 Copy。
- 回合审查卡片与审查树：
- 可视化检查每回合的 AI 工具操作、文件差异和已落定的代码更改。
- AI 辅助快捷操作菜单（🤖 AI Assist ▾）：
- 📖 Explain Code / File：注入深度架构解析提示词。
- 🧪 Generate Unit Tests：为当前文件生成全面的单元测试。
- 🔧 Refactor & Optimize：建议简洁的重构和现代化优化。
- 📝 Generate JSDoc / Docs：创建文档和行内注释。
- 🔍 Code Review & Bug Check：对边界情况和安全性进行全面审查。

4. 🪄 行内 AI 助手（Ctrl+K 光标式）
- 高亮任意代码行、Markdown 段落或文本，然后按 Ctrl+K。
- 浮动玻璃拟态卡片会直接出现在选区上方。
- 快捷操作芯片：
- ⚡ 润色文本：清理语法、改善语气并增强可读性。
- 📊 格式化表格：将非结构化数据或杂乱的行转换为整洁的表格。
- 💡 总结：将选中的部分浓缩为要点。
- 🔧 重构代码：为提升可读性、性能和最佳实践而重构代码。
- 自然语言输入栏允许自定义指令（例如，“将此函数转换为带类型错误的 async/await”）。

5. 🌿 Git 源代码管理与底层命令
- 文件资源管理器徽章：实时 Git 状态指示器：
- M（已修改 - 黄色）
- U（未跟踪 - 绿色）
- A（已添加 / 已暂存 - 青色）
- D（已删除 - 红色）
- R（已重命名 - 紫色）
- 源代码管理视图（Ctrl+Shift+G）：
- 已暂存和未暂存更改分组。
- 一键暂存（+）、取消暂存（-）和丢弃（↺）。
- 提交消息框，带有 Commit 操作。
- 提交日志查看器，显示最近的提交及其作者和时间戳。
- 远程同步操作（Fetch、Pull、Push）。

6. 🎨 Excalidraw 白板与草图绘制
- 内置功能齐全的 Excalidraw 画布。
- 直接在 IDE 内绘制架构图、用户流程和线框图。
- 将绘图保存到本地或嵌入 Markdown 文档中。

7. 🕸️ 知识图谱视图
- 交互式可视化知识图谱，映射文件、链接和交叉引用。
- 探索工作区连接性、孤立文档和中心枢纽节点。

8. ⚡ 可视化差异查看器
- 比较未保存的更改、文件版本或 AI 修改。
- 并排分栏视图和统一内联视图。
- 语法高亮的添加（+ 绿色）和删除（- 红色）。
- 实时更改计数器（+12 -4）和一键 ✓ 接受 / ✕ 丢弃。

⌨️ 键盘快捷键

| 快捷键 | 操作 | 范围 | 描述 |
| :--- | :--- | :--- | :--- |
| Ctrl+K / Cmd+K | 内联 AI 辅助 | 编辑器 | 在选区上打开 Cursor 风格的浮动 AI 提示。 |
| Ctrl+L | 聊天 / 将选区发送到 AI | 全局 | 有选区时： 将 @file#L... 芯片发送到聊天。无选区时： 切换右侧聊天面板。 |
| Ctrl+B | 切换左侧边栏 | 全局 | 切换资源管理器/搜索面板，折叠为 56px 侧边栏。 |
| Ctrl+Shift+E | 显示文件资源管理器 | 全局 | 聚焦资源管理器文件树视图。 |
| Ctrl+Shift+F | 工作区搜索 | 全局 | 打开全文 grep 搜索，支持大小写和正则表达式选项。 |
| Ctrl+Shift+G | 源代码管理 | 全局 | 打开 Git 暂存和提交面板。 |
| Ctrl+P / Cmd+P | 快速打开文件 | 全局 | 跨所有工作区文件的模糊文件查找器。 |
| Ctrl+Shift+P / F1 | 命令面板 | 全局 | 可搜索的所有命令和操作面板。 |
| Ctrl+S / Cmd+S | 保存文件 | 编辑器 | 将活动文档保存到磁盘。 |
| Ctrl+F | 在文件中查找 | 编辑器 | 带有上一个/下一个导航的搜索小部件。 |
| Ctrl+H | 查找与替换 | 编辑器 | 文件内搜索和替换小部件。 |
| Ctrl+Z | 撤销 | 编辑器 | 在 Code 或 TipTap 中撤销最近的输入/格式化操作。 |
| Ctrl+Y / Ctrl+Shift+Z | 重做 | 编辑器 | 重做已撤销的更改。 |
| F2 | 重命名项目 | 资源管理器 | 内联重命名文件或目录。 |
| Escape | 关闭模态框 | 全局 | 关闭对话框、命令面板、查找栏或内联提示。 |

🚀 快速开始与安装

前置条件
- Node.js：v22.0.0 或更高版本
- pnpm：v9.0.0 或更高版本
- DeepSeek Harness (dsh)：已安装并配置

单步部署（推荐）

运行部署脚本以编译宿主端与客户端目标、清理任何遗留插件，并将统一包链接到你的 DeepSeek Harness 配置文件中：

Clone the repository
git clone https://github.com/minhdevtry/deepseek-harness-plugins.git
cd deepseek-harness-plugins

Install dependencies
pnpm install

Deploy to default "web" profile
pnpm run deploy
Or specify a custom profile:
node deploy.mjs --profile custom-profile

直接 CLI 安装

或者，使用 dsh CLI 直接链接仓库根目录：

Build the unified plugin
pnpm run build

Link into profile
dsh plugin --profile web add link:.

启动 DeepSeek Harness

dsh web

导航至 http://127.0.0.1:3080 以体验统一的 VS Code 工作区。

🔒 安全沙箱与配置

宿主服务强制执行沙箱安全：

- 沙箱根目录（DSH_SANDBOX_ROOT）：默认为 process.cwd()。所有文件访问、读取、写入和删除均严格限制在此目录内。
- 路径遍历防护：绝对路径解析与 realpath 验证（isInsideSandbox）可阻止目录遍历攻击（../）。
- 可选身份验证（DSH_PASSWORD）：在环境中设置后，/vscode-files/* 路由将要求基于会话或令牌的身份验证。
- Cloudflare R2 集成：配置 Cloudflare R2 存储桶凭据（R2_ACCOUNT_ID、R2_ACCESS_KEY_ID、R2_SECRET_ACCESS_KEY、R2_BUCKET_NAME、R2_PUBLIC_DOMAIN）以进行云端资源存储，或默认使用本地图片持久化。

有关全面的技术设计与 API 文档，请参阅架构与技术规范。

📄 许可证

MIT © minhdevtry