ph/agentic
1
0
Fork 0
Code Issues 7 Pull requests Projects Releases Packages Wiki Activity Actions

docs: add comprehensive project documentation #92

Merged
ph merged 1 commit from docs/project-documentation into master 2026-06-16 04:01:33 +00:00
Conversation 0 Commits 1 Files changed 13 +2186
ph commented 2026-06-16 03:26:43 +00:00
Owner
Copy link

概述

通过自动化探索 agent 生成的全套项目文档，覆盖 Go 后端 17 个 internal/ 包、Web 前端、配置系统、事件协议、工具系统、Subagent、会话持久化、Skills、Trace、API 端点等。

文档清单

文件 说明 行数
docs/features.md 按 11 个类别列出所有功能及关键文件 146
docs/architecture.md 包依赖图、数据流、组件关系、ASCII 架构图 179
docs/backend-overview.md 每个 internal/ 包详细说明 333
docs/event-protocol.md 22 种 EventType、字段映射、构造器 162
docs/tool-system.md Registry 架构、12 个内置工具 145
docs/subagent-system.md 3 层发现、5 个预设、3 种执行模式 142
docs/session-and-persistence.md 会话生命周期、JSONL+SQLite 双持久化 179
docs/skills-system.md SKILL.md 结构、发现、XML 注入 141
docs/trace-system.md TraceRecord + TraceEvent 双层结构 181
docs/config-reference.md 完整 TOML 配置选项、默认值、环境变量 164
docs/api-endpoints.md REST + WebSocket 25+ actions 184
docs/frontend-architecture.md 前端技术栈、组件层次、SSE 管线、Zustand stores 203
docs/INDEX.md 文档索引 + 快速导航 27

质量保障：经历了探索 → 写作 → 评审 → 修正 三轮迭代，发现并修正了 3 个准确性问题。

新增文件

13 个文档文件，共 2,186 行新增。不修改任何现有代码。

## 概述 通过自动化探索 agent 生成的全套项目文档，覆盖 Go 后端 17 个 internal/ 包、Web 前端、配置系统、事件协议、工具系统、Subagent、会话持久化、Skills、Trace、API 端点等。 ## 文档清单 | 文件 | 说明 | 行数 | |------|------|------| | docs/features.md | 按 11 个类别列出所有功能及关键文件 | 146 | | docs/architecture.md | 包依赖图、数据流、组件关系、ASCII 架构图 | 179 | | docs/backend-overview.md | 每个 internal/ 包详细说明 | 333 | | docs/event-protocol.md | 22 种 EventType、字段映射、构造器 | 162 | | docs/tool-system.md | Registry 架构、12 个内置工具 | 145 | | docs/subagent-system.md | 3 层发现、5 个预设、3 种执行模式 | 142 | | docs/session-and-persistence.md | 会话生命周期、JSONL+SQLite 双持久化 | 179 | | docs/skills-system.md | SKILL.md 结构、发现、XML 注入 | 141 | | docs/trace-system.md | TraceRecord + TraceEvent 双层结构 | 181 | | docs/config-reference.md | 完整 TOML 配置选项、默认值、环境变量 | 164 | | docs/api-endpoints.md | REST + WebSocket 25+ actions | 184 | | docs/frontend-architecture.md | 前端技术栈、组件层次、SSE 管线、Zustand stores | 203 | | docs/INDEX.md | 文档索引 + 快速导航 | 27 | > **质量保障**：经历了探索 → 写作 → 评审 → 修正 三轮迭代，发现并修正了 3 个准确性问题。 ## 新增文件 13 个文档文件，共 2,186 行新增。不修改任何现有代码。
Generated by automated exploration agents — covers all 17 internal/
packages, the web frontend, configuration, events, tools, subagents,
sessions, skills, traces, and API endpoints.

Documents produced:
- docs/features.md — feature catalog with file locations
- docs/architecture.md — package dependency graph + data flow
- docs/backend-overview.md — per-package deep dive
- docs/event-protocol.md — 22 event types wire format
- docs/tool-system.md — registry + 12 built-in tools
- docs/subagent-system.md — 3-layer discovery + 5 presets
- docs/session-and-persistence.md — JSONL + SQLite dual storage
- docs/skills-system.md — SKILL.md structure + XML injection
- docs/trace-system.md — TraceRecord + TraceEvent
- docs/config-reference.md — full TOML schema
- docs/api-endpoints.md — REST + 25+ WebSocket actions
- docs/frontend-architecture.md — React 19 + Zustand + SSE
- docs/INDEX.md, REVIEW.md, VERIFICATION.md — index + quality logs
ph force-pushed docs/project-documentation from b4b0660600 to 1302cba7a8 2026-06-16 04:00:36 +00:00 Compare
ph merged commit 0483e16b3a into master 2026-06-16 04:01:33 +00:00
ph deleted branch docs/project-documentation 2026-06-16 04:01:33 +00:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
ph/agentic!92
No description provided.