Repository navigation
Releases
xharness v0.0.9
新功能
- GUI 持久化迁移至 SQLite（
node:sqlite单库xharness.db，WAL 模式） - 数据目录：
~/Library/Application Support/xharness/xharness.db
说明
- 早期零迁移：JSONL 旧数据不自动迁移，当作全新安装处理
- 库文件权限 600；API Key 仍明文存库（ad-hoc 签名下不使用钥匙串）
安装
下载 xharness-mac-arm64.zip 解压后拖入 /Applications；首次打开若被 Gatekeeper 拦截，右键 → 打开。
xharness v0.0.8
修正
- 修复打包 About 版本号显示为 Electron 版本（CFBundleShortVersionString / CFBundleVersion 写入应用版本）
- 侧栏每个项目默认只预览 5 条会话，可展开显示更多
安装
下载 xharness-mac-arm64.zip 解压后拖入 /Applications；首次打开若被 Gatekeeper 拦截，右键 → 打开。
xharness v0.0.7
新特性
图表渲染
- 聊天中支持 Mermaid、d2/d2lang、SVG、dot/Graphviz 代码块直接渲染为图形
- 语法错误时保留代码块；深浅主题跟随重渲
OpenAI Response API
- 新增 OpenAI Response 线格式支持；Grok（xAI）默认走 Response API
- 思考档位适配 Response 格式（none/low/high）
GUI 体验
- 新对话默认模型记住最近一次选择
- 侧栏项目列表最新添加的排在前面；对话列表按最近活动时间降序
- 项目文件夹点击改为折叠/展开会话列表
- 运行中的会话在侧栏显示圆形 loading 指示
- 对话右键菜单新增「拷贝 session id」；移除置顶与删除
- 移除 GUI 首启 YOLO 风险确认弹窗
修正
- 修复切换会话后原对话消息「停滞」
- 修复流式渲染时未识别语言代码块内容空白
- 修复 Grep 大输出导致上下文溢出
- 修复 xAI 流式工具参数丢失
- 热修打包脚本：gui 顶层主进程模块整体复制，避免漏文件导致启动失败
安装
下载 xharness-mac-arm64.zip 解压后拖入 /Applications；首次打开若被 Gatekeeper 拦截，右键 → 打开。
xharness v0.0.6
新特性
Grok（xAI）账号登录
- 新增内置 Grok 供应商：OAuth 设备码登录（SuperGrok / X Premium 订阅账号直接授权，无需 API Key），token 过期自动刷新
- api.x.ai 原生 Anthropic Messages 格式直连；OAuth token 走 Bearer 鉴权
- 设置页专属登录区（登录 / 重新登录 / 退出）+ Grok 官方样式图标
模型目录零手工维护
- 内置供应商（DeepSeek / Grok）的模型列表、上下文窗口、定价全自动来自 models.dev：启动后台同步（24h 缓存），设置页可"立即同步"；离线回退缓存/内置数据，永不影响可用性
- 支持分层定价计费（如 grok-4.3 输入超 200K 后费率翻倍），会话费用统计按实际命中档位计价
- 模型行显示
$输入/$输出定价徽标
自定义供应商一键获取模型
- 详情页新增"从接口获取"：请求端点
GET /v1/models自动拉取模型列表（路径与鉴权方式自动回退适配），端点返回的窗口大小直接识别，缺失参数按 models.dev 补齐；勾选确认后合入
修正
- Grok 内置模型参数以 models.dev 校准（grok-4.3 实为 1M 窗口；退役的 grok-4.1-fast 替换为编码模型 grok-build-0.1）
安装
下载 xharness-mac-arm64.zip 解压后拖入 /Applications；首次打开若被 Gatekeeper 拦截，右键 → 打开。
xharness v0.0.5
变更
- 设置新增「技能」管理页：集中管理个人（~/.agents/skills）与项目级技能——搜索、按范围筛选、行内启停开关（存于 GUI 设置，不改技能文件，对新会话生效）、新建技能模板、个人技能两步确认删除
- 技能详情弹窗：查看描述全文、范围、状态与 SKILL.md 路径，一键用默认编辑器打开
- 技能加载诊断：frontmatter 损坏、缺 description 等问题汇总为警告横幅，点击展开明细，不再静默跳过
- README 风险章节改写为「完全访问，但带护栏」：以内置 AgentGuard 防删除护栏为卖点，保留使用边界说明
macOS 安装（Apple Silicon）
下载 xharness-mac-arm64.zip 解压后直接双击——应用会引导你完成移动安装。
首次打开若被系统拦截：右键 → 打开，或到「系统设置 → 隐私与安全性」点「仍要打开」。
xharness v0.0.4
变更
- 首启引导：自动移动到「应用程序」——解压后直接双击运行时，会提示一键移动到 /Applications（已有旧版自动覆盖，移动后自动重启），无需再手动拖拽
- 修复 v0.0.3 安装版启动崩溃：打包脚本此前遗漏了 markdown 渲染相关依赖（marked-highlight / highlight.js / morphdom），依赖清单改为整体继承不再手写枚举
- README 重写为使用者视角：三分钟上手、Gatekeeper 放行图文指引、供应商接入表
macOS 安装（Apple Silicon）
下载 xharness-mac-arm64.zip 解压后直接双击——应用会引导你完成移动安装。
首次打开若被系统拦截：右键 → 打开，或到「系统设置 → 隐私与安全性」点「仍要打开」。
xharness v0.0.3
变更
引擎
- 工具并行执行：同一响应内的多个工具调用并发运行，结果按序回填；中断/上限语义与 history 配对完整性保持不变
GUI
- 聊天 markdown 全面美化：highlight.js 代码高亮（GitHub 主题）、标题层级、表格边框斑马纹、引用块、嵌套/任务列表、链接与分隔线完整排版
- 流式渲染防闪：morphdom 增量 DOM 补丁（前文不动）+ 未闭合代码围栏修补 + 流式期间跳过语言自动检测——边流边渲染且不闪烁
- markdown 外链改由系统浏览器打开
- API Key 存储改造：数据目录迁至
~/Library/Application Support/xharness/（macOS 惯例位置）；key 改为设置内手动填写、明文存储（权限 600）——彻底消除每次启动的钥匙串授权弹框 - 默认模型改为
deepseek-v4-flash（高性价比）+ 推理强度 high；供应商未配置 key 时状态醒目提示 - 侧栏 ⌘N 快捷键提示、项目 + 号常显等细节打磨
升级提示
- 数据目录已变更且不做旧数据迁移（项目早期约定）：旧版会话不会出现在新版中，API Key 需在设置中重新填写
macOS 安装（Apple Silicon）
下载 xharness-mac-arm64.zip 解压，拖入 /Applications 覆盖旧版；ad-hoc 签名，首次打开右键 → 打开。已内置 ripgrep。
xharness v0.0.2
变更
- 技能目录改用跨 harness 通用的
.agents/：全局~/.agents/skills/<name>/SKILL.md、项目级<项目根>/.agents/skills/<name>/SKILL.md（项目覆盖全局同名）。与 AGENTS.md 同生态，可直接复用你已有的 .agents 技能库。- 迁移：原
.xharness/skills/下的技能移动到对应.agents/skills/即可
- 迁移：原
- README 展示与文档更新
macOS 安装（Apple Silicon）
下载 xharness-mac-arm64.zip 解压，拖入 /Applications 覆盖旧版；ad-hoc 签名，首次打开右键 → 打开。已内置 ripgrep。
xharness v0.0.1
首个公开版本。
xharness —— TypeScript 实现的 coding agent harness（类 Claude Code 的 MVP），CLI + macOS GUI 双形态：模型自主地读代码 → 改代码 → 跑命令验证。Anthropic Messages API 格式，默认对接 DeepSeek，可添加 Kimi 等任意兼容供应商。
亮点
- 9 个内置工具（Bash/Read/Write/Edit/Grep/Glob/AskUserQuestion/TodoWrite/Skill）
- 流式输出 + thinking 四档（none/low/high/Max）
- 上下文自动/手动压缩、AGENTS.md 项目指令、SKILL.md 技能系统
- GUI：多项目多会话（JSONL 持久化）、图片附件（截图直接粘贴）、模型供应商设置（API Key 经 safeStorage 加密，磁盘零明文）
- 125 单测 + 7 E2E
macOS 安装（Apple Silicon）
下载 xharness-mac-arm64.zip 解压，拖入 /Applications；ad-hoc 签名，首次打开请右键 → 打开。已内置 ripgrep，无需额外依赖。