Pylon 文档

这里放随当前代码维护的说明书和参考资料。根目录 README 面向首次使用者；本文档按读者和稳定性分组，避免把内部施工记录当成产品承诺。

用户

• CLI 命令表：CLI 语法、内置命令和常用示例。
• Agent 检测器：Agent runtime 检测工具的用途和输出。
• 插件系统说明书（用户版）：安装、启停、更新和故障处理。

开发者

• 插件系统说明书（开发者版）：Manifest、Scope、生命周期、贡献 API 和验证方式。
• 插件设置选项贡献：如何贡献设置字段和呈现选项。
• 项目架构参考：当前分层、启动顺序、会话数据流和测试入口。
• 模块维护地图：源码归属、状态所有者、入口与跨模块验证。
• 开发规范：命名、分块改造、代码规则与证据要求；协作流程见仓库根 AGENTS.md。
• 问题台账（外部）：下一阶段问题的状态、证据、施工书入口和后续动作。
• 插件化前后端拓扑全图：当前实现拓扑；图中的 PLANNED 节点不是已支持功能。
• 发行包清单：便携版目录、Hermes 自带 Git 运行时和打包/验收步骤。

外部施工资料

施工书、评审记录、问题清单和历史过程资料不属于产品说明书，统一归档在仓库旁的：

G:\Project\prism-team-workdir\Docs

• 问题台账（外部根目录）
• 下一阶段问题清单（外部根目录）
• 施工书目录
• 评审记录目录
• issue.md（外部根目录）

历史归档仍保留在该目录已有的 Archive/ 下。过程资料中的结论如需成为产品承诺，应回写到 说明书/，不把旧方案复制回仓库。

维护规则

1. 文档中的命令、路径和能力必须能在当前仓库或发布脚本中找到依据。
2. 目标架构、施工计划和实验记录必须明确标注，并优先放在外部 Docs。
3. 同一事实只保留一个权威段落；其他文档使用链接，不复制整段说明。
4. 修改插件契约、存储格式、CLI 或用户可见行为时，同步更新对应章节并运行相关测试。