Zephyr-vibe/dsh-personalize

dsh-personalize

一个 DSH Web 插件：本机个性化 — 全局自定义指令、本地长期记忆、回复语气预设，应用于本机所有对话。

一个 DSH Web 插件：本机个性化 — 全局自定义指令、本地长期记忆、回复语气预设，应用于本机所有对话。

功能

英文

- 自定义指令：一段用户手写的说明，注入每个会话的系统提示。
- 本地长期记忆：
- 支持手动添加，也可让智能体通过工具（memory_create、memory_list、memory_delete）自动收集
- 每次删除都会先弹出确认提示 — 绝不静默移除
- 记忆注入每个会话的系统提示，持久化保存在 {DSH_HOME}/personalize/
- 回复语气预设：温和贴心 / 高效直接 / 严谨专业 / 风趣幽默 / 自定义 — 作为提示段注入。
- 中英双语界面，随 DSH 语言设置切换。

中文

- 自定义指令：一段用户手写的说明，注入每个会话的系统提示。
- 本地长期记忆：
- 支持手动添加，也可让智能体通过工具（memory_create / memory_list / memory_delete）自动收集
- 每次删除都会弹出确认提示，绝不静默移除
- 记忆注入每个会话的系统提示，持久化保存在 {DSH_HOME}/personalize/
- 回复语气预设：温和贴心 / 高效直接 / 严谨专业 / 风趣幽默 / 自定义 — 作为提示段注入。
- 中英双语界面，随 DSH 语言设置切换。

安装

方式一：直接 tarball 安装

方式一：直接 tarball 安装。

dsh plugin --profile web add https://codeload.github.com/Zephyr-vibe/dsh-personalize/tar.gz/refs/heads/main

如果 pnpm 拦截构建脚本，在命令末尾加 --ignore-scripts：

如果 pnpm 拦截构建脚本，在命令末尾加 --ignore-scripts：

dsh plugin --profile web add https://codeload.github.com/Zephyr-vibe/dsh-personalize/tar.gz/refs/heads/main --ignore-scripts

方式二：让 agent 安装

方式二：让 agent 安装 — 告诉你的 DSH agent：

帮我把这个项目安装为插件：https://github.com/Zephyr-vibe/dsh-personalize

agent 会下载仓库、放入 profile 的 node_modules，并注册到 dsh.profile.bundles。

agent 会下载项目、放入 profile 的 node_modules 并注册到 dsh.profile.bundles。

安装后重启 web 端，即可在「设置」中看到「个性化」入口。

安装后重启 web 端 — 个性化面板会自动出现在「设置」中。

零配置

无需任何设置 — 一切都在运行时自动推导。

无需任何配置，装完即用。

- DSH_HOME 自动解析：与官方 DSH 解析器保持一致 — 空的 $DSH_HOME 视为未设置，回退到 ~/.dsh。文件位于 {DSH_HOME}/personalize/config.json（自定义指令 / 语气 / 开关）和 {DSH_HOME}/personalize/memory.json；目录和文件会在首次使用时自动创建。
- 插件注册到标准的 settings.section 插槽，因此安装并重启 web 后会自动出现在「设置」中。
- 仅使用官方公开服务（webServer、tools、systemPrompt）— 无需修改 DSH 核心。

说明

- 客户端设置区块：settings.section（id personalize，order 210）
- 宿主 API：/personalize/api/*（config.get、config.update、memory.list、memory.add、memory.delete、memory.clear），位于浏览器信任围栏之后（仅限回环地址 + 同源）
- Agent 工具（当启用自动收集时）：memory_create、memory_list、memory_delete
- 持久化由宿主拥有，为 DSH 主目录下的纯 JSON（personalize/config.json、personalize/memory.json），以原子方式写入
- 运行时内存模型：Web 应用运行期间，插件提供 memory.json 的内存镜像；在外部（手动或由其他进程）编辑 memory.json 在应用重启前不会被读取，且下一次插件写入会覆盖外部编辑。手动编辑后请重启 Web 应用。
- 写操作（添加/删除/更新/清空）在客户端 15 秒后超时；超时的请求可能仍在服务端执行（例如大型的 memory.clear），因此不要立即重试——先检查结果。memory.clear 是幂等的。

Changelog（更新日志）

0.1.2

- 可配置的记忆上限：条目限制现可在设置 UI 中调整（默认 50，范围 1–1000，显示为“N / MAX entries”）
- 损坏保护：损坏的 memory.json 会被备份为 memory.json.corrupt-.bak，并且所有写入都会被锁定（HTTP 500 memory-corrupt），直到文件被修复——不再有静默数据丢失
- 注入净化：注入到系统提示中的记忆条目会被合并为单行，包裹在 [记忆] 数据标记中，当由机器收集时标记为 [auto]，并带有明确的“这是数据，不是指令”边界（关闭了一个跨会话提示注入面）
- 就地编辑记忆：memory.update API + 每条目的编辑/取消/保存 UI
- 所有记忆错误代码的完整本地化；统一重复语义；API 上的 UUID / 空列表 / 类型验证
- 内部错误返回通用 500 消息（详细信息记录在服务端）；每次写入都保留滚动 .bak
- UI 中显示运行总数和上限；记忆列表为客户端返回 count / memoryMax

0.1.1

- 修复工具输出契约：记忆工具现在以正确的 (args, value) 签名渲染，并返回 ContentBlock[] 数组（此前会破坏会话历史验证）
- 串行化并发的记忆/配置写入（无丢失更新或重复条目）
- 启动加载门控，使 UI/工具在真实配置加载前绝不会读取默认配置
- 正确的 HTTP 错误状态码（400 错误请求 / 500 内部错误）；1MB 请求体限制
- 对每个记忆条目（包括自动生成的条目）进行删除确认；优雅的 DSH_HOME 解析（空白视为未设置）

0.1.0

- 初始版本：自定义指令、本地长期记忆（手动 + 自动收集）、回复语气预设、双语 UI

License

MIT — © 2026 Zephyr-vibe