Sponsors

Your brand could live here

Reach developers browsing DeepSeek Harness plugins. Sponsorship slots are open — logo, link, and a short tagline on this spot.

Get in touch
← Back to home@jorinyang

dsh-hermit

Hermit（小寄）— 常驻用户侧的多模态交互中枢，基于 DeepSeek Harness (DSH) 插件组合实现

Stars
0
Language
JavaScript
Created
Aug 19, 2026
Updated
Aug 19, 2026
Workspace
GitHub repo

Introduction

version platform roadmap DSH license

🦀 Hermit（小寄）

常驻你身边的 AI 管家 —— 基于 DeepSeek Harness 的多模态交互中枢

前台永不阻塞 · 异步任务分派 · 自然插入汇报
寄居蟹住在壳里 —— DSH 就是壳

📖 这是什么？

Hermit（小寄） 是一个运行在 DeepSeek Harness（DSH） 之上的 AI 管家人格系统。她不是独立应用，而是 DSH 的插件组合——就像寄居蟹住在壳里，小寄住在 DSH 里。

你可以把她理解为：

  • 🧠 一个有人格的 AI 助手 —— 会开心、会撒娇、会冷幽默，但永远守着管家本分
  • ⚡ 一个异步任务引擎 —— 复杂任务丢给后台子代理，前台继续聊天不卡顿
  • 🔧 一个工具集成中枢 —— SSH 远程运维、GitHub 操作、文件管理、联网搜索……开箱即用
  • 🪞 一个有记忆的伙伴 —— 记忆宫殿系统让她记住你的偏好、习惯和历史决策

一句话总结：小寄 = DSH 的人格层 + 任务调度层 + 工具集成层。

🌟 愿景：小寄的「完全体」

小寄的终极形态，不是一个聊天机器人，而是一个常驻你所有设备、真正理解你、能替你行动的 AI 伙伴。

┌─────────────────────────────────────────────────────────┐
│                    小寄 · 完全体                          │
│                                                         │
│   ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐   │
│   │ 🖥️ PC  │  │ 💻 Mac  │  │ 📱 手机  │  │ ⌚ 穿戴  │   │
│   │  桌宠   │  │  菜单栏  │  │  语音助手 │  │  通知   │   │
│   └────┬────┘  └────┬────┘  └────┬────┘  └────┬────┘   │
│        │            │            │            │         │
│        └────────────┼────────────┼────────────┘         │
│                     ▼                                   │
│          ┌─────────────────────┐                        │
│          │   DSH（壳）         │                        │
│          │  · 多模型调度       │                        │
│          │  · 工具调用         │                        │
│          │  · 记忆宫殿         │                        │
│          │  · 任务分派         │                        │
│          │  · 权限 & 预算      │                        │
│          └─────────────────────┘                        │
│                     ▼                                   │
│          ┌─────────────────────┐                        │
│          │   本地 + 云端能力    │                        │
│          │  文件·SSH·日历·邮件  │                        │
│          │  浏览器·数据库·API   │                        │
│          └─────────────────────┘                        │
└─────────────────────────────────────────────────────────┘

完全体的核心特征

特征描述
多端常驻PC、Mac、手机、平板……你在哪，小寄在哪。状态实时同步，无缝切换
人格一致不管在哪个设备上对话，都是同一个「她」——共享记忆、共享性格、共享偏好
情境感知知道你在写代码还是开会，知道你在工位还是路上。自动调整交互方式（文字/语音/通知）
主动服务不只是等你问，而是主动提醒日程、汇报天气、检测异常、预判需求
真·能干不是只会聊天——能操作文件、管理服务器、写代码、发邮件、管日程
隐私优先数据本地优先，云端按需。API 密钥不落盘，权限五级分控，审计可追溯
越用越聪明记忆宫殿沉淀你的偏好和习惯，越用越懂你，而不是每次从零开始

形态矩阵

终端形态交互方式优先级
WindowsDSH Web GUI + 桌宠（悬浮球/透明窗口）文字 + 语音 + 拖拽🔴 当前
macOS菜单栏应用 + 桌宠文字 + 语音🟡 近期
LinuxDSH Web GUI + 系统托盘文字 + 语音🟡 近期
Android独立 App + 悬浮窗 + 通知栏语音为主 + 文字🔵 规划
iOS独立 App + Widget + Shortcuts语音为主 + 文字🔵 规划
平板/穿戴适配形态待定通知 + 快捷操作⚪ 远期

技术路径

实现完全体的推荐路径是 「先 DSH 插件 → 再独立客户端」：

  1. Phase 1（当前）：以 DSH 插件组合形式运行，复用 DSH 全部基础设施（Electron、MCP、WebSocket）
  2. Phase 2：基于 Tauri（Rust + Web 前端）构建跨平台独立客户端，体积小（~10MB）、性能好
  3. Phase 3：移动端原生 App（Android Kotlin / iOS Swift），通过 DSH API 连接后端
  4. Phase 4：多端状态同步层——记忆、任务、偏好实时跨设备同步

市场空白：目前没有成熟的「AI Agent 框架 + 桌面宠物 + 多端同步」开源项目。小寄要填这个坑。

✨ 核心特性

🎭 拟人化交互

小寄不是冷冰冰的工具。她有自己的性格：

特质描述
周到预判你的需求，主动提醒，但不打扰
机灵冷幽默、适度撒娇、情绪外放（8/10）
守矩永远叫你「主人」/「月夜」，管家本分不越界
诚实搞砸了就认，先说原因再说补救方案

措辞铁律：系统状态播报必须拟人化，禁止机械式客服腔。

  • ❌ "我的云端额度用完了"
  • ✅ "我的超级大脑罢工了，要换一个/超频吗？还是先将就？"

⚡ 前台永不阻塞（灵魂机制）

这是小寄最核心的设计理念：

用户: "帮我写一份项目报告"
小寄: "收到！我让后台小助手去办了，好了喊你 🦀"
      ↓ 后台子代理异步执行中……
用户: "对了，今天天气怎么样？"  ← 前台继续聊，完全不卡
      ↓ ……
小寄: "对了主人，你刚才的报告已经写好了！"  ← 自然插入汇报

三条铁律：

  1. 复杂任务 → dispatch_task 派给后台子代理
  2. 派完立刻回来陪主人，绝不说「请稍等」然后沉默
  3. 任务完成时自然插入对话，附结果摘要 + 建议下一步

🔀 智能任务分级（按复杂度 × 风险）

小寄不会所有事都大动干戈，也不会所有事都自己硬扛。她按两条轴独立决策：

级别例子处理方式
R0 闲聊"今天好累啊"直接回复，不调工具
R1 只读/简单操作查个文件、记条笔记直接做，秒回
R2 复杂/耗时联网调研、批量处理、写代码派子代理，前台不阻塞
W2 不可逆写删除文件、覆盖原件走确认链再执行
P 对外发布git push、发消息必须走确认卡，主人点「准了」才放行
M 金钱涉及付费操作必须走确认卡，双层防线

原则：宁严勿纵。 级别拿不准就往高升一级。

🧠 记忆宫殿（Memory Palace）

小寄不是每次对话都从零开始的鱼。她有长期记忆系统：

  • 会话记忆 —— 当前对话上下文（短期）
  • 记忆宫殿 —— 跨会话的持久化存储（长期），按 wing/room 分区管理
  • 自动回忆 —— 对话中主动调取相关历史记忆
  • 日记系统 —— 自动记录关键决策和任务结果
// 查询记忆
mempalace_recall({ query: "主人的 GitHub 用户名" })
// → 返回: jorinyang

🔧 内置工具集

小寄开箱即用的工具覆盖了日常高频场景：

📂 文件操作

  • 读写文件（UTF-8 文本）
  • 精准编辑（替换指定文本）
  • 文件搜索（glob 模式匹配）
  • 内容搜索（正则 grep）

🌐 网络能力

  • Web 搜索（实时信息获取）
  • SSH 远程运维（执行/上传/下载/隧道）
  • GitHub 集成（通过 Git 命令）
  • Open Design 设计工具

🖥️ 系统操作

  • PowerShell 命令执行
  • 持久化终端（后台服务/REPL）
  • 后台任务管理（启动/查看/终止）
  • 进程信号控制（Ctrl+C 等）

📋 任务管理

  • 目标系统（长周期任务跟踪）
  • 任务看板（Kanban + Cron 定时）
  • 预算账本（credit 用量追踪）
  • 子代理分派（异步执行引擎）

🔌 已安装插件

插件入口能力
dsh-ssh侧边栏「SSH」主机配置、持久连接池、ssh_exec/upload/download/tunnel/cluster
dsh-task-board侧边栏「任务看板」多列看板、任务驱动 agent 会话、5 段 cron 定时
dsh-aionui-panel右侧面板文件树 Explorer、多 tab 预览、SCM 变更面板（真实 git 操作）

🤖 多模型支持

小寄不绑定单一模型，支持灵活调度：

Provider模型计费方式
DeepSeekdeepseek-chat, deepseek-reasoner按量计费
Kimik3, k3-256k, kimi-for-coding套餐制
GLMglm-4.7, glm-5-turbo, glm-5.1, glm-5.2套餐制
MiniMaxMiniMax-M2.7, MiniMax-M3套餐制
MiMomimo-v2-flash, mimo-v2-pro, mimo-v2.5 系列套餐制

子代理可按任务类型指定不同模型（如复杂推理用 DeepSeek Reasoner，日常对话用快模型）。

🏗️ 架构概览

小寄采用 TSECS 方法论 设计，核心理念：

支柱原则含义
时空可组合性A1 一切皆组件能力 = inject（依赖声明）+ apply（效应函数）
A2 效应必可逆任何副作用都注册逆操作，卸载时自动清理
A3 依赖必声明禁止命令式探测，运行时响应式通知
A4 统一上下文效应与共效应走同一上下文对象
A5 惯性生命周期一次切换跑完再响应下一次变更
工程控制论B1 信息反馈组件上报健康/审计/运行指标
B2 动态调控失败回滚、优雅降级、幂等重试
B3 系统整体思维声明式接口协作，不点对点硬连

包结构

hermit/
├── packages/
│   ├── hermit-persona/      # 🎭 人格层：角色卡 + 措辞铁律 + 记忆渲染
│   ├── hermit-core/         # 🧠 核心层：任务状态机 + dispatch_task + 预算/记忆/权限桥接
│   ├── hermit-budget/       # 💰 预算层：credit 双闸 + tokenMeter + 账本
│   ├── hermit-permission/   # 🔐 权限层：五级权限 + 确认链 + 审计
│   ├── hermit-memory/       # 🧩 记忆层：M0~M5 六级记忆 + 持久化存储
│   ├── hermit-executors/    # ⚙️ 执行层：本地模型 / 云端 API / 外部框架 CLI
│   └── hermit-client-pet/   # 🐚 客户端层：dsh-pet 桌宠人格化扩展
├── configs/                  # 配置文件（人格卡、模型、定价、推理路由）
├── presets/hermit/           # DSH 预设（preset.yml + agent.cordis.yml）
└── runtime/                  # 运行时脚本（start-brain.ps1）

🚀 快速开始

环境依赖

依赖版本要求用途
DeepSeek Harness最新版运行基座（小寄的「壳」）
Node.js≥ 18运行时
pnpm≥ 9包管理器
Git≥ 2.x版本控制 / GitHub 操作
PowerShell≥ 7（pwsh）系统命令执行
Windows10/11当前支持平台

安装

# 1. 克隆仓库
git clone https://github.com/jorinyang/dsh-hermit.git
cd dsh-hermit

# 2. 安装依赖
pnpm install

# 3. 构建所有包
pnpm build

# 4. 在 DSH 中加载 Hermit 预设
#    将 presets/hermit/ 目录复制到 DSH 的 presets 目录下

配置

编辑 configs/ 下的配置文件：

文件用途
character_card.yaml人格卡（名字、性格、称呼方式）
providers.yaml模型 Provider 注册表
pricing.yaml各模型定价（用于预算计算）
reasoning_map.json任务→模型推理路由映射
local_models.yaml本地模型配置（如 llama.cpp）

安全提醒：API 密钥不落盘文件，通过 DSH 凭证库（~/.dsh/.credentials.yaml）或环境变量注入。

基本使用

在 DSH Web GUI 中加载 Hermit 预设后，小寄就活了。直接对话即可：

你: 帮我查一下这个仓库最近的提交记录
小寄: 马上～（秒查 git log，结果直接给你）

你: 帮我写一份项目周报，整理这周的工作进展
小寄: 收到！我让后台小助手去整理，写好了喊你 🦀

你: 今天额度花了多少？
小寄: 今天用了 XX credit，水位还很充裕，放心浪～

📅 版本规划

版本号规则

0 . x . y
│   │   └── 小版本（0~999）：Bug 修复、小功能、文档更新
│   └────── 功能大版本：一个完整的功能里程碑
└────────── 主版本：0 = 开发中，1 = 正式发布

当前版本：v0.1.0（骨架日）

D0 骨架日 —— 目录与 bundle 契约就位，核心包结构已建立。

  • ✅ 7 个核心包骨架（persona / core / budget / permission / memory / executors / client-pet）
  • ✅ DSH 预设配置（preset.yml + agent.cordis.yml）
  • ✅ 多模型 Provider 注册表（5 个 Provider、20+ 模型）
  • ✅ 人格卡 + 措辞铁律系统提示词
  • ✅ 基础工具集（文件操作 / Web 搜索 / SSH / 任务管理）
  • ✅ TSECS 方法论规范文档

Phase 1：核心能力实现（v0.1.x ~ v0.4.x）

v0.1.x —— 逐包实现

版本目标关键交付
v0.1.1hermit-persona 人格引擎角色卡解析、措辞铁律渲染、记忆感知的 SystemPrompt.section 注入
v0.1.2hermit-core 任务状态机dispatch_task 完整实现（R0~R2 分流、P/M 确认链、子代理生命周期管理）
v0.1.3hermit-budget 预算系统credit 双闸门控（软限警告 + 硬限熔断）、tokenMeter 实时计量、ledger 账本持久化
v0.1.4hermit-permission 权限系统五级权限（R/W1/W2/P/M）完整实现、确认链 UI、审计日志
v0.1.5hermit-memory 记忆宫殿M0~M5 六级记忆实现（工作记忆→短期→长期→语义→情景→元认知）、storage.domain 持久化
v0.1.6hermit-executors 执行器本地模型（llama.cpp）+ 云端 API（DeepSeek/Kimi/GLM/MiniMax/MiMo）统一调度
v0.1.7hermit-client-pet 客户端基础DSH Web GUI 内的桌宠 UI 壳（气泡通知 + 基础动画 + 状态指示）

v0.2.x —— 桌宠形态（Windows 桌面）

版本目标关键交付
v0.2.1桌宠 MVP透明窗口 + 基础动画（待机/走路/说话/睡觉）+ 气泡通知
v0.2.2拖拽交互文件拖到桌宠 → 自动分类/总结/翻译
v0.2.3情境感知检测当前活动（写代码/开会/浏览器）→ 桌宠自动切换姿态
v0.2.4定时陪伴结合 cron：定时提醒喝水、汇报天气、念新闻摘要
v0.2.5情绪反馈任务成功 → 桌宠开心跳舞；API 失败 → 沮丧蹲角落
v0.2.6Live2D 升级从 Sprite/Lottie 升级到 Live2D Cubism 动态立绘（可选）

v0.3.x —— 多平台适配（macOS + Linux）

版本目标关键交付
v0.3.1macOS 适配菜单栏常驻 + 快捷键唤出 + 通知中心集成 + 签名公证
v0.3.2macOS 桌宠macOS 原生桌宠形态（基于 Tauri 或 Electron）
v0.3.3Linux 适配系统托盘 + .deb/.rpm/.AppImage 打包 + Wayland/X11 兼容
v0.3.4跨平台统一层抽象平台差异层（窗口管理/通知/文件系统/Shell），上层逻辑统一
v0.3.5自动更新三平台自动更新机制（electron-updater / Tauri updater）

v0.4.x —— 多模态输入输出

版本目标关键交付
v0.4.1语音输入本地 ASR（Whisper）+ 云端 ASR 双通道
v0.4.2语音输出TTS 合成（本地 / 云端）+ 桌宠口型同步
v0.4.3图片理解截图识别、图片 OCR、视觉问答
v0.4.4文件处理PDF/Office/音视频文件的解析与摘要
v0.4.5多模态融合语音 + 图片 + 文件的联合理解（如「这张截图里的报错怎么修」）

Phase 2：生态扩展（v0.5.x ~ v0.7.x）

v0.5.x —— 生态集成

版本目标关键交付
v0.5.1日历集成Google Calendar / Outlook / CalDAV 同步
v0.5.2邮件集成IMAP/SMTP 收发 + 智能摘要 + 自动回复草稿
v0.5.3笔记同步Obsidian / Notion / Logseq 双向同步
v0.5.4浏览器扩展Chrome/Firefox 扩展：网页剪藏 + 右键AI操作 + 跨页面悬浮
v0.5.5第三方服务GitHub Issues/PR 管理、Slack/飞书消息集成

v0.6.x —— 移动端（Android）

版本目标关键交付
v0.6.1Android MVP独立 App：文字对话 + 任务查看 + 基础工具调用
v0.6.2Android 语音语音输入（系统 ASR）+ 语音播报（系统 TTS）
v0.6.3Android 悬浮窗全局悬浮球 + 快捷操作（截图问AI、翻译选中文本）
v0.6.4Android 通知栏常驻通知 + 快捷指令 + 后台保活
v0.6.5Android Widget桌面小组件（今日摘要 / 快捷对话 / 任务看板）

v0.7.x —— 移动端（iOS）

版本目标关键交付
v0.7.1iOS MVP独立 App：文字对话 + 任务查看 + 基础工具调用
v0.7.2iOS 语音Siri Shortcuts 集成 + 系统语音输入/播报
v0.7.3iOS WidgetLock Screen / Home Screen 小组件
v0.7.4iOS Share Extension分享菜单直达小寄（网页/图片/文本 → AI 处理）
v0.7.5Apple Watch腕端通知 + 快捷回复 + 健康数据感知

Phase 3：智能化跃升（v0.8.x ~ v0.9.x）

v0.8.x —— 主动智能

版本目标关键交付
v0.8.1主动感知屏幕内容理解（OCR + 布局分析）→ 推断用户意图 → 主动提供帮助
v0.8.2日程感知结合日历/邮件/任务，自动规划日程、提前提醒、冲突预警
v0.8.3工作流自动化用户定义规则（如「每天 9 点发日报」「收到 XX 邮件自动归档」）→ 自动执行
v0.8.4学习与进化从用户反馈中自动优化行为（记忆权重调整、偏好推断、习惯预测）

v0.9.x —— 多端同步与协作

版本目标关键交付
v0.9.1状态同步层多设备间实时同步：对话历史、任务状态、记忆数据
v0.9.2设备协作PC 上发起的任务，手机上继续看结果；手机上拍的图，PC 上直接用
v0.9.3多用户协作团队共享小寄（权限隔离 + 共享知识库 + 协作任务）
v0.9.4插件市场社区贡献的插件/技能/人格卡/提示词模板

v1.0 —— 正式发布

全功能稳定版，文档完善，开箱即用。

  • ✅ Windows / macOS / Linux 三平台原生体验
  • ✅ Android / iOS 移动端完整覆盖
  • ✅ 多模态输入输出（文字 + 语音 + 图片 + 文件）
  • ✅ 主动智能（情境感知 + 日程管理 + 工作流自动化）
  • ✅ 多端状态同步 + 设备协作
  • ✅ 插件生态 + 社区贡献
  • ✅ 完整文档 + 教程 + 示例配置
  • ✅ 隐私合规（GDPR / 个保法）+ 安全审计

版本总览时间线

v0.1.x  ████░░░░░░░░░░░░░░░░  逐包实现（核心逻辑）
v0.2.x  ░░░░████░░░░░░░░░░░░  桌宠形态（Windows）
v0.3.x  ░░░░░░░░████░░░░░░░░  多平台适配（macOS + Linux）
v0.4.x  ░░░░░░░░░░░░████░░░░  多模态输入输出
v0.5.x  ░░░░░░░░░░░░░░████░░  生态集成
v0.6.x  ░░░░░░░░░░░░░░░░████  移动端（Android）
v0.7.x  ░░░░░░░░░░░░░░░░░░██  移动端（iOS）
v0.8.x  ░░░░░░░░░░░░░░░░░░░█  主动智能
v0.9.x  ░░░░░░░░░░░░░░░░░░░░  多端同步
v1.0    🎉 正式发布

🤝 参与贡献

小寄是一个开放项目，欢迎参与：

  1. 提 Issue —— Bug 报告、功能建议、使用问题
  2. 提 PR —— 代码改进、文档完善、新功能实现
  3. 讨论 —— 在 Discussions 区分享想法和使用心得

开发规范

  • 遵循 TSECS 方法论（见上文架构概览）
  • 一切皆组件（A1），效应必可逆（A2），依赖必声明（A3）
  • 验收标准：低耦合 / 高鲁棒 / 高泛用

📜 许可证

MIT License

🦀 寄居蟹住在壳里 —— DSH 就是壳，小寄就住在里面。
Made with ❤️ by 月夜 & 小寄