前言¶
DSH 的插件化路线把扩展能力拆成可安装、可注册的独立单元。对日常使用 DSH Web 端的人来说，常见需求并不是单条回答能力，而是同一台机器上的多个会话如何共享同一组设置：自定义说明、本机长期记忆、回复语气，是否都要在每次会话里重新说明。
dsh-personalize 面向这个问题。它把全局自定义指令、本地长期记忆和回复语气预设集中到本机设置中，并应用于本机所有对话。
插件定位¶
dsh-personalize 是一个 DSH Web 插件，由 Zephyr-vibe 维护，采用 MIT 许可证。它用于在当前 DSH 环境中统一维护本机个性化设置，减少在每个会话中重复输入相同偏好。
该插件运行需要 Node >= 20。它只使用官方公开服务 webServer、tools、systemPrompt，无需修改 DSH 核心。DSH 强调插件化扩展，社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
核心能力¶
自定义指令¶
自定义指令是一段用户手写的说明，会注入每个会话的系统提示。适合放置长期稳定的偏好说明。
本地长期记忆¶
本地长期记忆支持两种添加方式：
- 手动添加
- 让智能体自动收集
智能体自动收集时可使用工具：
memory_create
memory_list
memory_delete
记忆条目会注入每个会话的系统提示，并持久化保存在 {DSH_HOME}/personalize/。删除前需要确认，不会静默移除。
记忆上限可配置，默认 50，范围 1–1000。
回复语气预设¶
回复语气预设提供以下选项：
- 温和贴心
- 高效直接
- 严谨专业
- 风趣幽默
- 自定义
这些预设用于调整回复风格，并应用于会话。
界面与入口¶
插件提供中英双语界面，随 DSH 语言设置切换。
插件注册到标准 settings.section 插槽。安装并重启 Web 端后，会自动出现在设置中。
安装与启用¶
直接安装¶
先执行以下命令，从 tarball 安装到 Web profile：
dsh plugin --profile web add https://codeload.github.com/Zephyr-vibe/dsh-personalize/tar.gz/refs/heads/main
如果 pnpm 拦截构建脚本，在命令末尾加 --ignore-scripts：
dsh plugin --profile web add https://codeload.github.com/Zephyr-vibe/dsh-personalize/tar.gz/refs/heads/main --ignore-scripts
安装后重启 Web 端，即可在「设置」中看到「个性化」入口。
让 agent 安装¶
也可以让 DSH agent 执行安装。在会话中发送：
帮我把这个项目安装为插件：https://github.com/Zephyr-vibe/dsh-personalize
安装完成后，仍需重启 Web 端，再进入「设置」查看入口。
文件位置¶
插件零配置，自动解析 DSH_HOME。首次使用时会自动创建以下文件：
{DSH_HOME}/personalize/config.json
{DSH_HOME}/personalize/memory.json
config.json 保存个性化设置，memory.json 保存本地长期记忆。
使用方式¶
设置入口¶
重启 Web 端后，进入「设置」，找到「个性化」入口。在该入口中维护自定义指令、记忆条目和回复语气预设。
Host API¶
插件提供 Host API：
/personalize/api/*
它用于 config 与 memory 操作。该 API 位于浏览器信任围栏内，仅限 loopback + same-origin 访问。
智能体记忆工具¶
当需要智能体自动收集记忆时，可调用：
memory_create
memory_list
memory_delete
这些工具分别用于创建、查看和删除记忆条目。删除前需要确认。
运行与数据注意事项¶
运行期间，插件维护 memory.json 的内存镜像。外部直接编辑 memory.json 在应用重启前不会被读取，并且插件下一次写入会覆盖外部编辑。手动编辑后，应重启 Web 端。
写操作在客户端 15 秒后超时。超时请求仍可能在服务端执行，不要立即重试，应先检查结果。memory.clear 幂等。
如果 memory.json 损坏，插件会将其备份为：
memory.json.corrupt-<ts>.bak
在文件修复前，所有写入会被锁定。
适用场景¶
适合希望在本机 DSH Web 端统一维护自定义指令、长期记忆和回复语气的用户。也适合让智能体在后续会话中保留少量稳定信息，而不是每次手动重复说明。
由于插件会写入本机文件，并以当前 dsh 进程权限运行，安装前应检查源码与许可证。当前资料明确许可证为 MIT。
结尾¶
dsh-personalize 的价值在于把本机个性化做成一个可安装的 DSH Web 插件：自定义指令、本地记忆和回复语气预设都能落到会话中，同时把数据保存在本机 {DSH_HOME}/personalize/ 下。
已核实资料未提供目录页 URL。GitHub 仓库地址为：
https://github.com/Zephyr-vibe/dsh-personalize
