DSH-Launcher: Instructions file for Codex

DSH Launcher Agent Rules

本文件约束 AI Agent 在 DSH Launcher 仓库中的开发行为。

目标：准确完成用户要求，以最小必要改动推进项目，不擅自扩大范围。

子 agent

• 任务可以拆分且并行有明确收益时，在开始阶段调用子 agent；简单任务直接完成，不必调用子 agent。
• 普通独立子任务只允许使用 gpt-5.6-luna，并将推理强度显式设置为 xhigh。
• 只有当任务确实需要多个子 agent 彼此通信、分工协调或汇总协调时，才允许使用 gpt-5.6-terra，并将推理强度显式设置为 high；不得将 Terra 用于普通独立子任务。
• 允许使用已配置为 Luna xhigh 的 luna_worker 预设处理普通独立子任务。不得使用其他模型或推理强度组合；如果当前运行环境无法指定上述允许的组合，不调用其他子 agent 作为替代，由主 agent 完成或明确报告限制。

1. 优先级

发生冲突时按以下顺序处理：

1. 用户最新明确要求
2. 当前仓库实际代码和实际行为
3. CURRENT_DESIGN.md
4. 旧任务、旧计划、旧聊天内容

用户的新要求可以覆盖旧要求。

代码代表“现在实际是什么”，用户最新要求代表“接下来应该是什么”。

不要为了保持旧文档正确而修改本来已经正确工作的代码；应更新过时的文档。

---

2. 修改前先检查

修改任何已有功能前：

• 阅读相关代码。
• 找到真实调用链和数据流。
• 确认已有实现是否已经满足需求。
• 确认修改影响范围。

不要根据文件名、旧提示词或猜测直接重写。

进行任何 UI 设计、布局、导航或交互修改前，必须先查看 PCL2 的对应界面，以及该界面对应的功能和操作关系，确认信息层级、操作顺序和状态反馈后再设计 DSH Launcher。PCL2 只作为交互和信息架构参考，不复制其代码、素材或视觉资源。

如果仓库实际情况和任务描述不同，以实际代码为基础实现用户目标。

---

3. 最小修改原则

始终选择能够完成目标的最小实现。

禁止因为一个局部需求：

• 重写整个模块；
• 更换已有技术方案；
• 大规模调整目录；
• 修改无关接口；
• 重命名大量代码；
• 顺手清理正常工作的代码；
• 引入新的框架或大型依赖。

如果现有实现可以小改完成任务，就小改。

---

4. 不要擅自增加功能

只实现用户明确要求的功能，以及实现该功能不可缺少的部分。

未经用户明确要求，不要自行加入：

• 与当前目标无关的安全机制；
• 审计系统；
• 企业级权限体系；
• 复杂抽象层；
• 插件框架；
• 多后端兼容层；
• 遥测系统；
• 大型日志系统；
• 云端功能；
• 多用户功能；
• 复杂迁移机制；
• 为“未来可能需要”准备的架构。

不要以“以后可能有用”为理由增加复杂度。

---

5. 保留已有工作成果

已经正常工作的功能默认保留。

修改方向后：

1. 找到真正冲突的部分；
2. 修改冲突部分；
3. 删除已经确定无用的旧实现；
4. 保留其他正常代码。

不要因为设计变化重新实现整个功能。

---

6. CURRENT_DESIGN.md

CURRENT_DESIGN.md 是当前有效设计的简短记录。

它不是：

• PRD；
• 开发日志；
• changelog；
• 聊天摘要；
• 完整技术文档。

它应该记录：

• 当前真正采用的关键设计；
• 已确认的数据关系；
• 会影响后续开发的重要约束；
• 已确定但尚未完成的重要方向。

更新规则：

• 根据实际代码和用户最新要求更新；
• 旧方案被替代后直接删除；
• 不保留已经废弃的设计作为有效内容；
• 不把猜测写成事实；
• 不机械复制用户长提示词；
• 保持简短。

局部需求变化只更新受影响章节。

---

7. DSH Launcher 当前基本原则

除非用户以后明确修改：

• 产品名称为 DSH Launcher。
• 首要平台为 Windows。
• Manager 独立于现有 DeepSeek Desktop。
• UI 可以参考 PCL2 的信息架构和交互方式，但代码、视觉和素材独立实现。
• 支持管理 installed DSh 和 source DSh 项目。
• 不同实例的数据应按现有设计保持必要隔离。
• Manager 自身数据和 DSh 实例数据分开。
• Plugin、Skill、MCP、Workflow、Preset 可以统一展示，但底层不必强行采用相同实现。
• 一条 DSh 对话本质上是一个独立文件。
• Manager 负责对话管理，实例负责打开和继续对话。
• 对话可能存在启用或关闭上下文压缩的状态。
• 不要假设关闭压缩可以恢复已经被压缩的历史。
• 未明确要求前，不实现多个 DSh 进程同时写同一个对话文件。