dsh-xia-plugins

August 31, 2026 · View on GitHub

English | 中文

一套 DeepSeek Harness（DSH）原创插件，围绕「游戏开发助手小夏」场景：樱花皮肤与陪伴式提醒、树状知识库、每日角色轮值、持久记忆、全局代理修复。

为什么要用它：每天一位二次元女主角，陪你做游戏

一个人做游戏，最难受的不是 bug，是孤单。这套插件的核心就是这个——把你的工作会话变成有人陪的冒险：

  • 🎀 每天一位二次元女主角：傲娇、元气、三无、软萌……每天随机一位动漫风角色，带着完整人设（性格、口癖、说话风格、开发专长）进入你的工作会话，陪你写代码、拆需求、聊世界观。想换人？一句话的事。
  • 📝 她记得你：你的项目、任务、喜好、坑，她都记在持久记忆里——不会出现「今天你谁啊」的尴尬。
  • 📚 你的设定有地方放：树状知识库把世界观、数值、剧情、角色设定整理成目录，聊到哪拖到哪，Agent 随取随用。
  • 🌸 有氛围的工作台：樱花主题、消息朗读、审批/任务/回答提醒——像有个伙伴坐在工位旁边，该催你时催你。
  • 🌐 网络问题也被治好：global-proxy 让订阅模型、海外服务的连通性不再折磨你。

角色卡是开放的：仓库内置五张虚构原创示例卡——助手「小夏」+「超高校级」工作室系列（美术·星见澪、剧本·花菱紬、程序·九条零、数值·冰室雪）；任何人可以按角色卡 schema 写自己的卡（性格、口头禅、声线建议都支持），组自己的队伍——谁来陪你做游戏，你说了算。

适合谁：独自开发的独立游戏开发者、想要轻松陪伴感的长文本工作流用户、二次元爱好者。装好后打开 DSH，选「小夏」预设，今天就有人陪你开工啦。

包含的插件

包层次一句话
@w4xxx/dsh-client-game-assistantWeb client樱花主题、审批/任务/回答提醒、消息朗读、语音设置
@w4xxx/dsh-client-gameassist-knowledgeWeb client知识库 📚 面板与拖拽引用
@w4xxx/dsh-gameassist-knowledgeHost树状 Markdown 知识库（数据面 + 工具 + HTTP）
@w4xxx/dsh-gameassist-memoryHost（preset）单文件持久记忆（interests/tasks/works…）
@w4xxx/dsh-gameassist-rosterHost（preset）每日角色轮值与 voice-map
dsh-global-proxyHost（进程级）undici 全局代理（修复 Node 不走系统代理）

每个包都有独立的中文 README.md 与英文 README.en.md，含配置表、工具/路由/slot 清单、数据与安全、构建测试与已知限制。

架构：DSH checkout overlay

DSH 的生态依赖（@deepseek-ai/cordis、@deepseek-ai/schemastery、@deepseek-ai/dsh-client-ui-renderer 等）尚未发布到 npm，本仓库也无法独立 pnpm install 它们。因此本仓库以 overlay 方式与 DSH 源码树协作：

  • 本仓库只包含 6 个插件的源码、文档、测试与构建配置；
  • 构建与测试在 DSH checkout 环境内进行（把本仓库的包覆盖/链接进 checkout，跑 DSH 的 pnpm install + build:lib:host/client + vitest）；
  • 这样每次 CI 都顺带验证了与官方 DSH 的真实兼容性。

集成方式

方式一：overlay 进 DSH checkout（推荐，用于构建/测试）

# 把本仓库 packages/* 同步进你的 DSH checkout（Windows）
node scripts/integrate.mjs --checkout D:/mycode/deepseek-harness-master
# 然后按 DSH 常规流程：pnpm install && pnpm run build:lib:host && pnpm run build:lib:client

scripts/integrate.mjs 会按映射表把 6 个包复制到 checkout 的 packages/companion|client 对应目录（默认跳过 node_modules）。

方式二：profile patch 装配

在 ~/.dsh/profiles/web/ 的 cordis.patch.yml 中插入需要启用的插件（host 层与 web 层各有对应写法，见各包 README）。

方式三：运行时注入（开发用）

装了 dsh-super-injector 时，可用 dev_inject_plugin 把任意包目录（含 package.json 与 lib/）运行时注入。

目录结构

dsh-xia-plugins/
├─ packages/
│  ├─ gameassist-knowledge/        # Host：知识库数据面
│  ├─ gameassist-memory/           # Host：持久记忆
│  ├─ gameassist-roster/           # Host：每日角色轮值（含虚构示例卡）
│  ├─ client-game-assistant/       # Web：小夏皮肤与提醒
│  ├─ client-gameassist-knowledge/ # Web：知识库面板
│  └─ global-proxy/                # Host：undici 全局代理
├─ scripts/integrate.mjs           # overlay 同步脚本
├─ LICENSE / NOTICE.md
└─ third-party-licenses/           # DeepSeek Harness / Cordis / Schemastery / undici 的 MIT 全文

发布状态

  • 本仓库当前为源码分发，6 个包尚未发布到 npm；
  • 包名沿用 @w4xxx 自有 scope（DSH 官方 @deepseek-ai 无发布权）；
  • 每个包已声明 dsh.bundle manifest 与 cordis.patch.yml，可通过 dsh plugin add 安装（monorepo 子包按 owner/repo#packages/<dir> 引用）；
  • 角色卡仅含虚构原创示例（助手「小夏」+ 「超高校级」工作室：美术·星见澪、剧本·花菱紬、程序·九条零、数值·冰室雪，共 5 张，位于 packages/gameassist-roster/cards/），不包含任何真实作品角色；
  • 视觉元素（花瓣、铃声）为纯 CSS / Web Audio 合成，不含字体、图片或录音资产；
  • 社区目录收录：6 个条目已按 awesome-dsh-plugin 规范 准备，待仓库满 1 天（≥10 commits 已达成）后提交 PR。

许可证

MIT + NOTICE。详见 LICENSE 与 NOTICE.md；第三方依赖的许可证全文见 third-party-licenses/。