dsh-harness-jarvis
DSH Desktop 的浮动桌面助手——一个用于快速批准权限和进行快速浮动对话的粒子球。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-harness-jarvis@0.7.1
Harness Jarvis 以 dsh-harness-jarvis 发布，当前版本为 0.7.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
贾维斯是常驻桌面的悬浮窗助手，也是一只有状态的桌面宠物：DSH 弹出权限审批时，悬浮窗立刻出现卡片，一键允许 / 拒绝 / 总是允许（此工作区），与主窗口竞答、先到者生效；任何时候按 ⌃⌥J 就能唤出输入条和他对话，对话记录内嵌面板；启动时他还会出声打招呼。他的本体是一颗随状态呼吸的粒子光球——思考、说话、等你拍板各有动效，拖到屏幕边缘就融进墙里收起，要用时一碰涨回球形。
当前 0.7.1 是"助手版"：上面这些能力开箱即用；完整的贾维斯愿景在路线图中继续推进。
⌃⌥J（默认，可在面板设置中修改）随时唤出快速输入条，和贾维斯直接聊；对话记录内嵌面板，随点随看。一个快捷键，历史随手可及。下面这段动图是一次完整交互：⌃⌥J 展开输入条、打字发送、贾维斯思考并口播、审批卡片一键允许。
完整交互演示：展开输入条、打字、发送、思考与播报、审批一键允许
贾维斯的本体是一颗 Metal 粒子光球：六边形核心，向外两次扩散成环，粒子在环间呼吸。空闲时安静悬浮，思考、说话、等待决策、出错各有一套动效；把它拖到屏幕边缘，光球会"融"进墙里，变成一条贴边的扁条，要用时一碰又涨回球形。
空闲悬浮 · 等待你拍板时的"咚-咚"心跳提醒
贴边融变动图：融进墙角成 L 形扁条，再涨回球形 审批卡片与工作区预设
贴边融变收纳 · 审批卡片与工作区预设
当前提供源码安装。面板需要 macOS 14+ 与 Swift 6 工具链（Xcode 或 Command Line Tools）；宿主建议 Node.js 22.18+。
从仓库根目录构建：
npm ci
npm run build
(cd macos && ./build.sh)
在你使用的 DSH profile 的 package.json 中合并以下条目（把路径换成此仓库的绝对路径，保留原有条目）：
{
"dependencies": {
"dsh-harness-jarvis": "link:/absolute/path/to/dsh-harness-jarvis"
},
"dsh": {
"profile": { "bundles": ["dsh-harness-jarvis"] }
}
}
在 profile 目录执行 pnpm install 解析 link: 依赖（不要在仓库里安装此链接）。插件的 dsh.bundle.patch 指向 cordis.patch.yml；插件会自己创建贾维斯会话，不要在 profile 里重复插入同 ID 条目。
在 profile 覆盖配置或 DSH 的贾维斯设置页里指定 provider / model，也可以留空——留空时插件会自动选取第一个可用提供方与该提供方的第一个模型（重启 DSH 后生效，可用 npm run smoke 验证）。
硬依赖服务为 tools、userQuestions、jobs；agentLoop、llm、systemPrompt、webServer、settings 等按可用性接入，缺少时插件降级运行（无 webServer 则没有面板通信入口）。
⌃⌥J 唤出输入条即可开始对话。下表列出助手版面向使用者的公开配置，由 src/index.ts 的 schema 生成；其余内部字段不对外承诺。路径与身份经 profile 配置；设置页中的 provider/model 改动需重启 DSH，其余开关下次请求即生效。
| 字段 / Field | 类型 / Type | 默认值 / Default | DSH 设置页 / Settings |
|---|---|---|---|
locale | "zh" / "en" | "zh" | 否 / No |
audioDir | string | "~/.dsh/jarvis" | 否 / No |
ttsBackend | "edge" | "edge" | 否 / No |
edgeVoice | string | "zh-CN-YunjianNeural" | 是 / Yes |
provider | string | "" | 是 / Yes |
model | string | "" | 是 / Yes |
greetings | string[] | [] | 是 / Yes |
locale 控制启动问候语言，不是完整的面板双语开关；面板外观与快捷键设置保存在 ~/.dsh/jarvis/panel.json，连接凭据只写入本机该目录，请勿分享。
voice-mini 可选。可用时贾维斯优先用它的播报与播放控制；不可用时退回内置 edge-tts。静音会抑制播报。
审批记录、日志与语音缓存默认保存在本机 ~/.dsh/jarvis，没有云端存储。本机存储不等于离线处理：所配置的模型服务会收到对话上下文，内置 edge-tts 会把播报文本发给 Microsoft 语音服务。
插件不申请 danger-full-access；快捷键走 Carbon RegisterEventHotKey，不需要辅助功能按键监听；当前没有麦克风录音。审批记录与日志可能包含敏感操作上下文，请自行管理分享范围。
0.7.x 之后将逐步补齐贾维斯的完整愿景（细节随版本落地再公布）：
npm ci
npm run build
npm test
(cd macos && swift test && ./build.sh)
npm run docs:config # 重新生成上方配置表
npm run docs:config -- --check
npm pack --dry-run
构建后重启 DSH 再执行 npm run smoke。面板改动后重建并重启；截图用演示数据从仓库根目录生成：
JARVIS_SNAPSHOT=/tmp/jarvis-snapshots ./macos/jarvis-panel
MIT © 2026 zane — 见 LICENSE。