前言¶

在 DeepSeek Harness（DSH）里跑智能体，身份、语气、工具说明和用户偏好往往散落在各处，改一处还要重启或手动同步。宿主自带的 Agent 与权限体系又不能被随意替换。若希望把「这套工作区该怎么表现」写成版本可控的 Markdown，并在下一轮模型步进时自动生效，同时为新会话单独设模型与权限默认值，就需要在插件层做 opt-in 的指令注入与 Profile 管理。下面介绍社区插件 Instruction Files & Agent Profiles（仓库 Kerberos255/dsh-instruction-files，维护者 Kerberos255），它在不取代宿主原生 Agent、权限与会话历史的前提下，按工作区管理上述内容。

这是什么¶

该插件面向 DSH 桌面/Web 客户端用户：在工作区根目录放置若干可选的 Markdown 段落文件，在设置里逐段启用；并可创建自定义 Agent Profile，仅对新建会话生效默认工作区、模型与权限。分类上在 SkillHub 目录中归为「模型推理」相关能力；当前 GitHub 星标为 0，许可证为 MIT（见仓库 README）。

核心功能¶

工作区 Markdown 段落（opt-in）¶

插件支持以下命名文件，每段可在设置中单独开关，未启用的段落回退为 DSH 原生行为：

• IDENTITY.md：身份；可选替换宿主原生 identity 段（其余命名段为插件定义，非 DSH 原生段名）。
• SOUL.md：行为与风格偏好。
• AGENTS.md、TOOLS.md、USER.md：智能体、工具与用户侧说明。
• MEMORY.md：记忆类内容；README 标明为敏感段，在私有通道中需通过属主校验及插件记忆边界，并与 Dream & Memory、Channel Core 协作，避免不可信私有记忆被注入。

修改文件后，变更在下一次模型步进时重载注入，并避免重复注入；不会 retroactively 改写当前正在执行的模型请求。插件不会自动创建上述文件，也不评估模板表达式。

自定义 Agent Profile¶

可在 Settings → Plugins → Instruction Files & Profiles 中创建自定义 Agent Profile，为新会话指定工作区、模型与权限等默认值。已有对话不受默认项变更影响。

其它说明¶

• 可选向 dsh-plugin-diagnostics 上报隐私受限的操作与失败元数据（事件类型、状态、固定错误码、耗时；不含对话内容与凭据）；诊断插件为可选依赖。
• 独立校验可运行仓库内 npm test（prompt / memory-filter）；配置模板见 config.example.json。package.json 当前版本为 0.2.19，安装前需确认 DSH 主机与 peer 依赖版本兼容。

安装与启用¶

安装需使用与 README 一致的命令（将 desktop 换成你实际使用的 profile），安装或代码更新后需重启 DSH：

dsh plugin --profile desktop add github:Kerberos255/dsh-instruction-files

依赖与运行时要求见仓库 package.json。

启用步骤（来自 Quick start）：

1. 打开 Settings → Plugins → Instruction Files & Profiles。
2. 选择工作区，开启总开关「workspace-prompt」（默认关闭）。
3. 只添加你打算使用的 Markdown 文件，并逐段启用对应 section。
4. 可选：创建自定义 Agent Profile，配置新会话的模型/权限等默认项。

典型用法¶

在工作区根目录按需放置文件，例如：

workspace/
  IDENTITY.md
  SOUL.md
  AGENTS.md
  TOOLS.md
  USER.md
  MEMORY.md

IDENTITY.md 管身份，SOUL.md 管语气与行为；是否启用 MEMORY.md 应结合通道信任与上述记忆类插件策略判断。改文件后等下一轮模型步进即可看到注入更新，无需指望当前进行中的请求立刻改写。

适用场景与注意¶

适合：多工作区、希望指令与 Profile 可 Git 管理；需要按文件粒度开关提示段；为新会话预设模型/权限而不动历史会话。

注意：

• 插件在当前 DSH 进程权限下运行，安装前应阅读源码与 MIT 许可证，并核对 SECURITY.md。
• 禁用某段即回退原生 DSH；默认项只影响新会话。
• SkillHub 目录（https://www.skillhub.cn/plugins/Kerberos255/dsh-instruction-files）为社区索引，与 DeepSeek / 幻方无官方从属关系；DSH 本身遵循「一切皆插件」的扩展方式。

链接¶

• 目录页：https://www.skillhub.cn/plugins/Kerberos255/dsh-instruction-files
• 源码与 README：https://github.com/Kerberos255/dsh-instruction-files