前言¶

在 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