Kun-Fox/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

使用

1. 新建一个 DSH 会话。
2. 在预设选择器里选 Foxy。
3. 直接说话即可；上下文、工具、模型选择都由 DSH 原生运行时处理。
4. 切回 standard 或其他 preset，就恢复普通 DSH。Foxy 不会常驻。

enableTools: false（默认）时，Foxy 会话会隐藏继承的工具；需要工具时在左侧 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