不只是聊天
它能动手把你的活干完
Spark Harness 是 Windows 桌面上的 AI 助手。它读你的文件、改你的代码、跑命令、开网页查资料—— 该问的它会问（删文件、改注册表、关机这类），该干的它自己干（读文件、写工作区里的文件、跑普通命令）。 全程有轨迹可查，历史能跨设备同步，数据默认只留在你自己的电脑上。
它不是"会聊天的框"，是能干活的助手
下面六件事是它最常被用到的能力。每一条都在自检里跑过，不是宣传语。
读写你的文件
读、写、改、搜索、列目录都支持，改完给一张卡片：动了哪些文件、加了几行减了几行。写工作区里面的文件不问，写到工作区外面才问。
执行命令
跑构建、跑脚本、查系统状态，输出实时回流到对话里。窗口是隐藏的，不会在你屏幕上闪黑框；随时点「停止」，正在跑的进程会被真的杀掉。
操作网页
在后台的隐藏浏览器里打开页面、滚动、点击、填表单、截图。只有"点击/输入"这类有副作用的动作才会问你，纯读取不问。
轨迹时间线
「轨迹」页把这一轮画成三条泳道：输入 / 模型 / 工具。红块就是失败或被拒的那一步，点方块直接跳到对应步骤，还能按关键字搜索。
右侧工作台
三个页签：文件（工作区树 + 语法高亮预览 + 一键 @ 引用）、运行（实时状态、本轮统计、最近工具调用）、网页（点链接直接在这里打开）。宽度可以拖动。
顺手的小功能
输入 / 出指令菜单，输入 @ 引用工作区文件，代码块有语法高亮，Markdown 表格能正常渲染，代码一键复制，一轮任务只占一个气泡。
14 个工具，各自要不要问你
这是它全部能做的事，以及每一件会不会弹确认。能造成损失的才问，其余不打扰你——这条写在代码里，也写在自检里。
| 工具 | 干什么 | 会问你吗 |
|---|---|---|
| read_file | 读文件内容（大文件自动截断） | 不问 |
| write_file | 写/改文件，返回逐行差异 | 工作区内不问 / 区外会问 |
| list_dir | 列目录、看文件大小与时间 | 不问 |
| search_files | 按关键字或文件名搜索 | 不问 |
| make_dir | 新建文件夹 | 不问 |
| run_command | 执行命令，输出实时回流 | 普通命令不问 / 危险命令会问 |
| system_info | 系统、磁盘、环境信息 | 不问 |
| browse | 后台浏览器：打开、滚动、点击、输入、取文本 | 只读不问 / 点击输入会问 |
| screenshot | 截屏（含整屏与页面截图） | 不问 |
| download_file | 下载文件到工作区 | 不问 |
| open_url | 用系统浏览器打开网址 | 会问 |
| open_path | 用资源管理器打开文件/文件夹 | 会问 |
| open_app | 启动本机程序 | 会问 |
| web_search | 联网搜索（走你配置的接口） | 不问 |
危险命令的判断包含：del/Remove-Item/-Recurse、format/diskpart、
改注册表与防火墙、taskkill/Stop-Service、关机重启、curl | bash、
git push/reset --hard。确认卡片 5 分钟没人点会自动拒绝并说明原因。
想聊就聊，想干活就干活
模式决定它有没有手。推理档位决定它想多久——同一句话，Low 直接给答案，Max 会先想清楚再动手。
| 模式 | 它做什么 | 适合 |
|---|---|---|
| Chat Mode | 纯对话，完全不碰你的文件与系统 | 问问题、写文案、解释代码 |
| Agent Mode | 能读写文件、执行命令、操作网页，有副作用的操作按风险确认 | 改项目、跑脚本、查资料写文档 |
| Auto Mode | 全部自动执行，一次都不问（确认卡片也不会出现） | 你完全信任这次任务，想让它一口气跑完 |
Low · 快
几乎不思考，适合改个错字、问个概念。响应最快，最省 token。
High · 平衡
默认档。常规任务先想一步再动手，速度和质量够用。
Max · 彻底
复杂重构、疑难 bug 用。会想很久、花更多 token，但漏掉的细节最少。
还有一件事：思考型模型（DeepSeek 这类）的"思考"和"正文"共用同一个输出上限。 如果它想太久把配额吃光、正文一个字都没剩，Spark Harness 会自动把上限放大到 4 倍重问一次，所以你常看到它"想完接着就把活干了"。
只在该拦你的时候拦你
我们最怕的两种产品：什么都替你决定，和什么都问你要许可。Spark Harness 走中间那条线。
不询问（干就完了）
读文件、列目录、搜索、截图、网页只读；工作区内写文件（改代码）；普通命令如 npm run build、node x.js、git status。
会询问（先问再做）
删除与递归删除、改注册表/防火墙/Defender、杀进程与停服务、关机重启、curl | bash、git push、写工作区外的文件、网页里的点击与输入、打开程序与网址。
超时保护
确认卡片 5 分钟没人点会自动拒绝，并把原因写进对话（而不是让任务无限期挂着）。
随时停止
停止按钮真的会杀掉正在跑的命令（含子进程），等待中的确认会被作废，已发出的请求会中断。
换台电脑，历史还在
用 Spark 账户登录（和工作室官网同一套账号），对话历史就能在你的设备之间同步。本地始终保留完整一份，断网、服务挂了都不影响你继续用。
本地优先
本地文件是本体，云端只是镜像。同步失败不阻塞任何操作，也不会覆盖更新的本地内容。
默认只传文本
截图和轨迹默认不上传（截图是几百 KB 到几 MB 的图片，也涉及隐私）。要传得自己打开开关。
按用户隔离
每个人的对话存在独立前缀下，互相看不到；登录令牌在系统级加密后存在本机。
按对话合并
同一条对话比时间戳，新的覆盖旧的；不做逐条消息的双向合并——冲突几乎不会发生，逻辑也简单可靠。
令牌自动续期
登录令牌过期时自动用 refresh token 换新的并重试，你不会遇到"用了一小时突然同步失败"。
随时退出
左下角账户菜单里一键退出登录，本地数据完全不受影响；想彻底断开，删掉账户即可。
用得越久越顺手
键盘
Ctrl+B 开关右侧工作台 Ctrl+. 停止当前任务 Ctrl+, 打开设置 Enter 发送 · Shift+Enter 换行 Esc 关闭菜单 / 取消改名
输入框里
/ 指令菜单：/new /settings /trace /stop /sync /logout /workspace /model
@ 引用工作区文件（菜单第一项可以切换工作目录）
粘贴图片或点回形针，可以把截图发进对话
点击对话里的链接 → 在工作台里打开；Ctrl+点击 → 用系统浏览器
从下载到让它干活
拿到并打开
便携版一个 exe，双击就能用；也可以装安装包。第一次打开会是一个登录页，用 Spark 账户登录（没有就注册，邮箱点一下确认链接）。
填接口和 Key
设置里填你的接口地址与 Key（默认预置了 DeepSeek 等 14 家）。点「测试连接」会分步告诉你网络、鉴权、模型哪一步有问题。
切 Agent 模式干活
把工作目录设成你的项目文件夹（@ 菜单第一项就能换），然后直接说人话："看看这个项目的结构，然后写个 README"。
你可能想问的
支持哪些模型？要自己准备 Key 吗？
支持任何 OpenAI 兼容接口：填接口地址和 Key 就能用，预置了 DeepSeek 在内的 14 家服务商，模型列表可以一键拉取。Key 只有你自己持有，我们不经手、不上传。
它会不会乱删我的东西？
删除、递归删除、改注册表、杀进程、关机这类操作一定会先问你，并且卡片上会显示参数原文让你看清。工作区内改代码和普通命令不会问（否则每一步都点确认根本没法用）。不放心可以在设置里打开「严格模式」，让每个有副作用的操作都问一次。
我的数据存在哪？卸载会删吗？
全部在 %APPDATA%\Spark Harness：设置、对话历史、轨迹、允许列表、截图。删掉这个文件夹就等于恢复出厂设置；开着云同步的话，历史还能从云端拉回来。
为什么它有时候"想半天不动手"？
思考型模型的"思考"和"正文"共用同一个输出上限，思考一长正文就没配额了。Spark Harness 检测到这种情况会自动把上限放大到 4 倍重问一次，所以它想完就会接着动手，而不是停在那里。
能在网页里让它帮我点按钮吗？
能。网页工具会在后台隐藏窗口里完成，不会在你屏幕上弹一堆窗口；只有点击、输入这类有副作用的动作才会问你。
会不会往我电脑里装东西？
它不会自己装软件。下载文件只会存到你指定的位置；真要执行安装类命令，会因为命中危险规则而先问你。
免费吗？
免费。模型费用由你自己的接口账户承担，我们不经手也不加价。
最近做了什么
v0.1.0 · 首个公开版本
Chat / Agent / Auto 三种模式与 Low/High/Max 推理档位；14 个工具；按风险分级的确认策略（含 5 分钟超时自动拒绝）；
轨迹泳道时间线；右侧工作台（文件预览 / 运行状态 / 内嵌网页）；一轮任务合并为一个气泡；
代码语法高亮与 Markdown 表格；/ 指令与 @ 文件引用；
半截工具调用自动自愈；思考占满输出上限时自动放大重问；Spark 账户登录与对话历史云同步。
接下来打算做
多工作区切换、MCP 外部工具接入、对话内容全文检索、导入其他 AI 客户端的记录。
下载与安装
安装包目前通过 QQ 直接发（比网盘稳，也方便我顺手问一句你用在哪、需要什么功能）：
发你之前我会说明版本号和文件大小，你收到后可以核对。
- 版本：v0.1.0
- 系统：Windows 10 / 11（x64）
- 形式：便携版单个 exe，或安装包
- 大小：约 78 MB
- 依赖：无（不需要另装运行库）
- 数据：默认只在本机，可选云同步
- 价格：免费