一个 VS Code 侧栏聊天扩展。主推模式 Harness 通过 JSON-RPC 连接你本地的
DeepSeek-Harness（DSH）运行时 ——
真实工具调用、真实转写；当 media/dsh-live 产物齐全时，用 DSH 自带的 React 对话组件渲染。
| 模式 |
说明 |
| Harness（默认） |
恒为 DSH 直播：扩展以子进程拉起本地 DSH jsonrpc-agent 端到端驱动。模型与消息经 JSON-RPC 下发，工具调用 / 增量 / 转写回流。未配置时底部配置条常驻、引导点内建 配置 DSH 向导（路径配好前禁发）。 |
| 内嵌聊天（本版未开放入口） |
自带流式界面、回复是内置假文本的沙盒 —— 未完成，仅用于打磨流式/渲染管线。入口按钮已隐藏（代码全部保留），见手册内嵌聊天。 |
仓库不带任何机器路径：hello.dsh.* 一律从你的用户设置读取（scope: machine），绝不进仓库。
文档（手册）
这一页只回答两件事：它是什么，以及五分钟怎么跑起来。其余全部正文 —— 从零安装 0–5、
设置速查（含会话历史、Windows 上 agent 拿到哪个 bash）、运行可靠性（中断与续跑）、
运行检查器、上下文窗口与压缩、项目级 agent profile、真 DSH 组件画面（react-live）、
项目结构、开发与安全提示 —— 都在 docs/manual.zh-CN.md。
状态
开发者预览。 「Harness」是受支持的路径，在 Windows 上端到端跑过；
「内嵌聊天」是未完成的沙盒、本版未开放入口（按钮已隐藏，代码保留，只用于打磨流式/渲染管线）。
哪些做完、哪些有意没做，见 docs/backlog.md。
安装
从 VSIX（本版尚未上架 Marketplace）：
- 到 Releases 下载
hello-vscode-ext-0.0.1.vsix。
- VS Code 扩展面板右上角
… → Install from VSIX… 选中它；或在终端跑
code --install-extension hello-vscode-ext-0.0.1.vsix。
- Reload 窗口。
从源码：走下面的「运行（三步）」——F5 起的是同一个扩展。
扩展里不含 DSH 运行时。Harness 模式要你自己有一份 DSH 检出，见
手册第 0–2 节。
运行（三步）
前提是你已经有一份 DSH 检出（还没有？见手册第 0–2 节）：
git clone https://github.com/CG3274650969/HELLO-VSCODE_EXT.git
cd HELLO-VSCODE_EXT
npm install
- 在 VS Code 打开本文件夹 → 按 F5（运行和调试 → Run Extension）。
- 扩展开发窗口 Activity Bar 点 AlohaDSH，面板默认落在 Harness 页签。
- 用底部 配置 DSH 向导指向你的 DSH 运行时；点 API 按钮把 Key 存进
VS Code SecretStorage（不回写任何文件）。
每一步的长版说明都在手册里，从
第 4 节 配置扩展开始。
讨论与参与
欢迎所有人加入。仓库的 Issues 对什么都开着 —— 用法问题、bug、想要的功能，或者只是说说你拿它做了什么。
PR 同样欢迎；当前工作线是常驻的 dev 分支。
- 项目地址：https://github.com/CG3274650969/HELLO-VSCODE_EXT
- 问题 / 想法：https://github.com/CG3274650969/HELLO-VSCODE_EXT/issues
开发
npm run compile（tsc）是构建。另有自检与一族探针（scripts/），
F5 之前必须全绿。见手册：开发与安全提示。
打包与发布（VSIX 怎么出、Marketplace 上怎么传）见 docs/publishing.md。
License
MIT
Third-party dependencies and their licenses are disclosed in THIRD_PARTY_NOTICES.md.
