dsh-foxy
Manifest validAdds the Foxy agent preset, sidebar entry, settings page, editable prompt suffix, and a small capability registry to DeepSeek Harness.
dsh-foxy
Foxy 是 DeepSeek Harness 的一个 agent preset:它把预设投影成该会话的系统提示词,并把记忆、平台、能力留给独立子插件。
它不是另一个聊天应用,也没有自己的聊天面板/API。聊天使用 DSH 原生会话;左侧栏只保留一个 Foxy 入口,打开后用一个控制台标签页统一管理主设置和各子插件配置。
DSH 会话(选择 Foxy preset)
│
dsh-foxy(host registry + agent preset)
│
dsh-foxy-memory(可选,本地记忆 / HTTP provider)
│
koishi-plugin-chatluna-foxy-memory(可选,QQ 侧与跨平台记忆中枢)
依赖关系
- 必需:
dsh-foxy本身。 - 可选记忆:
dsh-foxy-memory;它可独立使用本地 JSONL,也可通过bridgeUrl连接koishi-plugin-chatluna-foxy-memory。 - 平台子插件:
dsh-foxy-bili、dsh-foxy-weibo,均依赖dsh-foxy与可选的dsh-foxy-memory。 koishi-plugin-foxy-memory-bridge是旧方案,已由koishi-plugin-chatluna-foxy-memory的/foxy-memory/*兼容层取代;保留仅为迁移。
安装
在 DSH 的 profile 里安装两个包(记忆子插件可选,但推荐):
dsh plugin --profile desktop add "file:D:\path\to\dsh-foxy"
dsh plugin --profile desktop add "file:D:\path\to\dsh-foxy-memory"
安装后完全重启 DSH。新的 Foxy preset 会出现在会话预设选择器里。
开发时如果 profile 里是复制安装而不是链接,修改源码后需要重新 dsh plugin add,或把 lib/ 复制到:
C:\Users\<you>\.dsh\profiles\desktop\node_modules\dsh-foxy
使用
- 新建一个 DSH 会话。
- 在预设选择器里选 Foxy。
- 直接说话即可;上下文、工具、模型选择都由 DSH 原生运行时处理。
- 切回
standard或其他 preset,就恢复普通 DSH。Foxy 不会常驻。
enableTools: false(默认)时,Foxy 会话会隐藏继承的工具;需要工具时在左侧 Foxy 设置页打开,保存后对新会话生效。
统一 Foxy 控制台
左侧栏只显示一个 Foxy。打开后顶部标签页分别是:
- Foxy:主设置(预设、工具、记忆保存);
- B站、微博、记忆、OOPZ、游戏:安装了对应子插件才显示。
标签页复用各子插件原有的 React 面板,不是 iframe,也不会重复实现表单。切换标签会保留已经打开的页面状态(例如填了一半的设置),当前标签会记在浏览器 localStorage 里,下次打开 Foxy 仍停在原标签。各子插件仍保留 DSH 设置页中的 settings.section,作为控制台不可用时的后备入口。
子插件通过全局注册表登记页面:
window.__FOXY_CONSOLE__.pages.push({
id: 'dsh-foxy-game',
label: '游戏',
order: 18,
Component: GamePage,
})
dsh-foxy 只负责标签壳和页面容器;子插件被禁用时对应标签消失,不会留下空白入口。
左侧栏设置
Foxy 控制台的主设置保存到:
%USERPROFILE%\.dsh\foxy\settings.json
- 预设文件:下拉选择
presetsDir里的文件,也可以手填绝对路径; - 注入记忆条数、是否允许 DSH 工具、是否附加运行时上下文;
- 记忆保存方式:
LivingMemory(Koishi 桥)或本地 JSONL; - 桥地址、Token、LivingMemory 预设、批量大小、定时冲刷、提取模型。
保存后,记忆子插件会尝试热重载;预设相关的改动对新会话生效。
预设
默认读取:
%USERPROFILE%\.dsh\foxy\presets\preset.yml
也可以用 presetPath 指向任意 Foxy/Character 预设文件,例如 ChatLuna 的:
...\data\chathub\character\presets\preset.yml
读取规则:
- 有
persona:块:直接使用; - 只有 Character 的
system:块:自动投影,只保留角色设定标题(基本设定、详细设定、真实身世、语言风格、发言风格、情境应对、群友共同特点、边界),丢弃好感度、affinity、toolbox、character_reply、status/think、群友 ID 目录、名词解释等运行时内容; - 不需要维护两份文件:DSH 和 ChatLuna 可以读同一个
preset.yml。
投影用 complete: true 和 interpolate: false 注册,所以:
- 它是该 agent 唯一的系统提示词段,不会被 DSH 的 coding-agent 人设污染;
- 预设里的
{{...}}原样保留,不会被 DSH 模板插值。
记忆
dsh-foxy-memory 是一个独立子插件,默认把 Foxy 会话写成 JSONL:
%USERPROFILE%\.dsh\foxy\memory\entries.jsonl
每条记录带 presetId、sessionId、platform=dsh、sourceLabel=DSH、说话人和时间。桥提炼出的长期记忆会保留真实平台与来源,不再使用固定的“我记得在 DSH 私聊里”前缀:
我在 DSH 私聊里看到 用户 提到今天在调 Foxy 的记忆桥。
下一轮 Foxy 会话会把最近 N 条注入 [长期记忆]。默认值是 20 条,可用 memoryContextEntries 调整。
记忆不是逐条写:dsh-foxy-memory 会按 batchSize(默认 8)和 flushIntervalMs(默认 30 秒)调用桥的 /ingest,由模型提炼成中文、Foxy 第一人称的长期记忆。提示词要求保留平台、事件类型与时间,避免“用户 说/回复”这种流水账。左侧面板的「记忆保存」可以改桥地址、token、预设、批次、提取模型,不必改 profile 文件。
它不依赖 ChatLuna。如果要接跨平台记忆,安装 koishi-plugin-chatluna-foxy-memory,在设置页填 bridgeUrl、bridgeToken、bridgePresetId。新插件通过 /foxy-memory/* 直接写入 preset(Character) 池;不要直接写 SQLite,否则会绕过 speaker key、profile 和 PGlite 向量索引。旧 koishi-plugin-foxy-memory-bridge 仅保留迁移兼容。
配置
Host(dsh-foxy)的常用配置都在左侧 Foxy 设置页;对应 $DSH_HOME/foxy/settings.json。
Agent preset 子插件(dsh-foxy/preset):
| 字段 | 默认 | 说明 |
|---|---|---|
presetId | 预设 | 读取哪个预设文件 |
presetPath | 空 | 直接指定预设路径;优先于 presetId |
promptSuffix | 空 | 追加到预设 persona 后的自定义要求;留空不追加 |
enableTools | false | 是否让 Foxy 会话继承 DSH 工具 |
includeRuntimeContext | false | 是否附加 DSH 运行时上下文 |
memoryContextEntries | 20 | 注入多少条长期记忆 |
keepHeadings | 内置 | Character system 投影时保留的标题 |
dropHeadings | 内置 | 投影时丢弃的标题 |
扩展契约
Host 通过 ctx.foxy 暴露:
ctx.foxy.registerPreset(preset)
ctx.foxy.registerMemoryProvider(name, factory)
ctx.foxy.registerCapability(name, factory)
ctx.foxy.registerTransport(name, factory)
ctx.foxy.status()
子插件可以按需接入:
- 记忆:
dsh-foxy-memory、未来的 livingmemory 桥; - 平台:微博、OOPZ、B站、QQ;
- 能力:TTS/STT、VISION、VTube Studio。
主插件只负责人设和注册表,不拥有对话循环。
限制
- LivingMemory 桥是独立 Koishi 插件;未安装/未配置时退回本地 JSONL。
- Foxy 会话默认无工具,这是刻意的安全默认值。
- 会话中途切换 preset 取决于 DSH 版本;最稳妥是新建 Foxy 会话。
- 侧栏面板是状态页,不是聊天页;聊天请用 DSH 原生对话。
开发
node --check lib/index.js
node --check lib/client.js
node --check lib/preset.js
node ..\research\test-foxy-preset.mjs
node ..\research\test-foxy-memory.mjs
node ..\research\test-foxy.mjs
node ..\research\test-foxy-status.mjs
License
MIT
Comments
Loading…
Similar plugins
by Yume-Hatsuyuki
DeepSeek Harness 的 Agent 预设扩展(可视化手动配置预设)
★ 0
MIT
JavaScript
Nov 3, 2026
dsh plugin --profile web add @local/dsh-preset-studioAgent enhancements for DeepSeek Harness Desktop: prompt history (↑/↓ and Alt+R search), one-click prompt optimize with undo, next-prompt prediction (Tab to accept), and conversation plus tracked-file
★ 1
MIT
TypeScript
dsh plugin --profile web add dsh-agent-enhancerby BrambleXu
Reusable Markdown prompt profiles for DeepSeek Harness with per-turn model selection, argument substitution, and state restoration.
★ 1
MIT
TypeScript
Oct 10, 2026
dsh plugin --profile web add dsh-prompt-profileby DreamsTOF
DeepSeek Harness 的三合一能力台:提示词定制(按名称屏蔽 / 替换 / 注入 / 排序,按会话阶段与 agent 预设分层)+ 技能集合管理(导入 / 分组 / 开关)+ MCP Server 接入(分层遮蔽与工具级启停)。纯插件注入,不动官方源码。
★ 4
↓ 360/wk
MIT
JavaScript
Nov 14, 2026
dsh plugin --profile web add dsh-prompt-customizerby YukimuraSol
DeepSeek Harness plugin: renders AGENTS.md as an independent system-prompt section, re-read on every prompt assembly instead of injected as user messages.
★ 0
MIT
JavaScript
Oct 28, 2026
dsh plugin --profile web add dsh-agents-sectionby KouzakiUmi
DeepSeek Harness 插件:按 Agent preset 限制每个 Agent 可见的工具,保留全局 provider 挂载;基于 agent/created 与 ctx.tools.restrict()。
★ 0
MIT
JavaScript
Oct 19, 2026
dsh plugin --profile web add dsh-preset-tool-guard