# 开发文档

使用与安装见[项目 README](../README.md)。

| 文档 | 内容 |
| --- | --- |
| [架构原则](architecture-guidelines.md) | 模块划分、依赖和开发方法 |
| [技术设计](technical-design.md) | 系统组成、生命周期与资源加载 |
| [模型指令编写原则](model-instruction-guidelines.md) | 提示、角色、技能与工具说明的取舍、表达、加载和验证要求 |
| [模型上下文](model-context.md) | 主会话、专家与摘要入口的内容、加载时机和验证边界 |
| [界面设计](interaction-design.md) | Pi TUI 与 dsh GUI |
| [dsh 使用（中文）](dsh.md) / [English](dsh.en.md) | 安装、更新、原生 profile、完整命令与 Web 管理 |
| [工具与执行](capability-design.md) | CLI/MCP 接入、授权和结果核验 |
| [专家协作](agent-collaboration.md) | 子会话工具、通信、通知和生命周期 |
| [历史对话](history.md) | 自动收录、连续摘要树、全文查询与原文展开 |
| [文件存储](file-storage.md) | 数据位置、写入规则和历史保留 |
| [验证](validation.md) | 本地测试、真实模型冒烟结果与剩余验收 |
| [npm 发布](release.md) | 发布配置、授权、操作与验收 |
| [安装与升级](installation-design.md) | npx setup、工作区选择、插件安装、初始化与失败恢复 |

双宿主范围见[dsh 接入方案](dsh-support-proposal.md)，执行与验收进度见[实施记录](dsh-implementation-plan.md)。既有子会话范围取舍见 [Subagent 升级方案](subagent-upgrade-proposal.md)。团队策略在 0.1.3 实现，0.2.0 将子会话对话交给 Pi 原生存储，不迁移旧历史。当前用法见专家协作；0.1.3 的真实模型冒烟、0.2.0 本地验证与剩余验收见验证。

Python 环境与库许可见 [python/README.md](../python/README.md)。模型使用的方法维护在 resources/skills，运行时职责维护在 resources/agents。

每个主题维护当前说明，总览通过链接引用；提供中英文版本时同步维护命令、参数和限制。版本以 package.json 为准；历史设计查 Git 记录，临时排查过程不进入设计文档。