Skip to content

附录 L:全部端点清单 ​

由控制器注解生成,与文档检查器双向核对(去重后 468 个 verb,path 组合)。

459 个端点全列(含同一方法的多路径别名),按模块 → 控制器分组。 方法与路径直接来自注解扫描;架构规则 23 会校验本节的每个路径真实存在。

博客(module_blog)—— 95 个端点 ​

AlbumAdminController

方法路径
GET/api/admin/blog/album/list
POST/api/admin/blog/album/photo
DELETE/api/admin/blog/album/photo/{id}
PUT/api/admin/blog/album/photo/{id}/description
POST/api/admin/blog/album/save
DELETE/api/admin/blog/album/{id}
GET/api/admin/blog/album/{id}
GET/api/admin/blog/album/{id}/photos

ArticleAdminController

方法路径
POST/api/admin/blog/article
PUT/api/admin/blog/article
POST/api/admin/blog/article/batch-delete
POST/api/admin/blog/article/batch-update
GET/api/admin/blog/article/deleted/page
GET/api/admin/blog/article/history/{historyId}/content
GET/api/admin/blog/article/page
GET/api/admin/blog/article/schedule
DELETE/api/admin/blog/article/{id}
GET/api/admin/blog/article/{id}
GET/api/admin/blog/article/{id}/history
GET/api/admin/blog/article/{id}/history/{historyId}/diff
POST/api/admin/blog/article/{id}/history/{historyId}/rollback
POST/api/admin/blog/article/{id}/restore
PUT/api/admin/blog/article/{id}/status

CategoryAdminController

方法路径
POST/api/admin/blog/category
PUT/api/admin/blog/category
GET/api/admin/blog/category/list
POST/api/admin/blog/category/merge
DELETE/api/admin/blog/category/{id}

CommentAdminController

方法路径
POST/api/admin/blog/comment/batch-status
GET/api/admin/blog/comment/export
GET/api/admin/blog/comment/page
DELETE/api/admin/blog/comment/{id}
POST/api/admin/blog/comment/{id}/reply
PUT/api/admin/blog/comment/{id}/status
PUT/api/admin/blog/comment/{id}/top

LinkAdminController

方法路径
POST/api/admin/blog/link
PUT/api/admin/blog/link
GET/api/admin/blog/link/page
DELETE/api/admin/blog/link/{id}
PUT/api/admin/blog/link/{id}/status

MessageAdminController

方法路径
POST/api/admin/blog/message/batch-status
GET/api/admin/blog/message/export
GET/api/admin/blog/message/page
DELETE/api/admin/blog/message/{id}
POST/api/admin/blog/message/{id}/reply
PUT/api/admin/blog/message/{id}/status

PageAdminController

方法路径
GET/api/admin/blog/page/list
POST/api/admin/blog/page/save
DELETE/api/admin/blog/page/{id}
GET/api/admin/blog/page/{id}

SeriesAdminController

方法路径
GET/api/admin/blog/series/list
POST/api/admin/blog/series/save
DELETE/api/admin/blog/series/{id}
GET/api/admin/blog/series/{id}/articles
POST/api/admin/blog/series/{id}/sort

SnippetAdminController

方法路径
GET/api/admin/blog/snippet/list
POST/api/admin/blog/snippet/save
DELETE/api/admin/blog/snippet/{id}
POST/api/admin/blog/snippet/{id}/use

TagAdminController

方法路径
POST/api/admin/blog/tag
PUT/api/admin/blog/tag
GET/api/admin/blog/tag/list
POST/api/admin/blog/tag/merge
DELETE/api/admin/blog/tag/{id}

TalkAdminController

方法路径
POST/api/admin/blog/talk
PUT/api/admin/blog/talk
GET/api/admin/blog/talk/page
DELETE/api/admin/blog/talk/{id}

AlbumPortalController

方法路径
GET/api/portal/blog/album/list
GET/api/portal/blog/album/{id}

ArticlePortalController

方法路径
GET/api/portal/blog/article/archive
GET/api/portal/blog/article/page
GET/api/portal/blog/article/{id}
POST/api/portal/blog/article/{id}/like
GET/api/portal/blog/article/{id}/related

CommentPortalController

方法路径
POST/api/portal/blog/comment
GET/api/portal/blog/comment/list
POST/api/portal/blog/comment/{id}/like

LinkPortalController

方法路径
POST/api/portal/blog/link/apply
GET/api/portal/blog/link/list

MessagePortalController

方法路径
POST/api/portal/blog/message
GET/api/portal/blog/message/list

MetaPortalController

方法路径
GET/api/portal/blog/category/list
GET/api/portal/blog/search
GET/api/portal/blog/search/hot
GET/api/portal/blog/tag/list

PagePortalController

方法路径
GET/api/portal/blog/page/nav
GET/api/portal/blog/page/{slug}

SeoController

方法路径
GET/robots.txt
GET/rss.xml
GET/sitemap.xml

SeriesPortalController

方法路径
GET/api/portal/blog/series/list
GET/api/portal/blog/series/{slug}

TalkPortalController

方法路径
GET/api/portal/blog/talk/list
POST/api/portal/blog/talk/{id}/like

系统(module_system)—— 71 个端点 ​

AdminSecurityController

方法路径
GET/api/admin/system/security/api-key/list
POST/api/admin/system/security/api-key/save
DELETE/api/admin/system/security/api-key/{id}
PUT/api/admin/system/security/api-key/{id}/toggle
GET/api/admin/system/security/status

AdminSettingController

方法路径
GET/api/admin/system/config/list
POST/api/admin/system/config/save
GET/api/admin/system/mail/status
POST/api/admin/system/mail/test
GET/api/admin/system/nav
POST/api/admin/system/nav
GET/api/admin/system/nav/mobile-tabs
POST/api/admin/system/nav/mobile-tabs
POST/api/admin/system/nav/reset
GET/api/admin/system/storage/status
POST/api/admin/system/storage/test

AdminStatsController

方法路径
GET/api/admin/system/stats/content-health
GET/api/admin/system/stats/devices
GET/api/admin/system/stats/funnel
GET/api/admin/system/stats/growth
GET/api/admin/system/stats/hours
GET/api/admin/system/stats/report
GET/api/admin/system/stats/report/export
GET/api/admin/system/stats/search-words
GET/api/admin/system/stats/sources
GET/api/admin/system/stats/subscribers
GET/api/admin/system/stats/top

AuthController

方法路径
GET/api/admin/auth/info
POST/api/admin/auth/login
GET/api/admin/auth/login-logs
POST/api/admin/auth/logout
POST/api/admin/auth/logout-all
POST/api/admin/auth/password
PUT/api/admin/auth/profile
GET/api/admin/auth/security-status
GET/api/admin/auth/sessions
POST/api/admin/auth/totp/disable
POST/api/admin/auth/totp/enable
POST/api/admin/auth/totp/setup

FileAdminController

方法路径
POST/api/admin/system/file/batch-delete
GET/api/admin/system/file/folder/list
POST/api/admin/system/file/folder/save
DELETE/api/admin/system/file/folder/{id}
GET/api/admin/system/file/page
GET/api/admin/system/file/stats
POST/api/admin/system/file/upload
DELETE/api/admin/system/file/{id}
PUT/api/admin/system/file/{id}/alt
PUT/api/admin/system/file/{id}/move
GET/api/admin/system/file/{id}/references

HealthController

方法路径
GET/api/health
GET/api/health/ready

SubscriberAdminController

方法路径
GET/api/admin/system/subscriber/count
GET/api/admin/system/subscriber/page
DELETE/api/admin/system/subscriber/{id}

WidgetAdminController

方法路径
GET/api/admin/system/widget/list
GET/api/admin/system/widget/preview
POST/api/admin/system/widget/save
POST/api/admin/system/widget/sort
DELETE/api/admin/system/widget/{id}

CaptchaController

方法路径
GET/api/portal/captcha

LayoutPortalController

方法路径
GET/api/portal/layout

SiteController

方法路径
GET/api/portal/site/info
POST/api/portal/site/visit

SubscriberController

方法路径
GET/api/portal/subscriber/status
POST/api/portal/subscriber/subscribe
POST/api/portal/subscriber/unsubscribe

记忆(module_memory)—— 71 个端点 ​

CareCheckInAdminController

方法路径
GET/api/admin/ai/care
GET/api/admin/ai/care/{id}
POST/api/admin/ai/care/{id}/reply

HindsightConsoleController

方法路径
GET/api/admin/hindsight/audit-logs
GET/api/admin/hindsight/audit-logs/stats
GET/api/admin/hindsight/config
POST/api/admin/hindsight/consolidate
GET/api/admin/hindsight/directives
POST/api/admin/hindsight/directives
DELETE/api/admin/hindsight/directives/{id}
PATCH/api/admin/hindsight/directives/{id}
GET/api/admin/hindsight/documents
DELETE/api/admin/hindsight/documents/{documentId}
PATCH/api/admin/hindsight/documents/{documentId}
POST/api/admin/hindsight/documents/{documentId}/reprocess
GET/api/admin/hindsight/documents/{id}/history
GET/api/admin/hindsight/entities
GET/api/admin/hindsight/entities/graph
GET/api/admin/hindsight/entities/{id}
POST/api/admin/hindsight/entities/{id}/regenerate
POST/api/admin/hindsight/ingest/cursors/{sessionId}/reset
GET/api/admin/hindsight/knowledge-base/export
POST/api/admin/hindsight/knowledge-nodes
DELETE/api/admin/hindsight/knowledge-nodes/{id}
PATCH/api/admin/hindsight/knowledge-nodes/{id}
GET/api/admin/hindsight/knowledge-tree
GET/api/admin/hindsight/llm-requests/stats
GET/api/admin/hindsight/memories
POST/api/admin/hindsight/memories/batch-state
GET/api/admin/hindsight/memories/{id}
PATCH/api/admin/hindsight/memories/{id}
GET/api/admin/hindsight/memories/{id}/history
DELETE/api/admin/hindsight/memories/{id}/observations
GET/api/admin/hindsight/mental-models
POST/api/admin/hindsight/mental-models
DELETE/api/admin/hindsight/mental-models/{id}
GET/api/admin/hindsight/mental-models/{id}
PATCH/api/admin/hindsight/mental-models/{id}
GET/api/admin/hindsight/mental-models/{id}/history
POST/api/admin/hindsight/mental-models/{id}/refresh
GET/api/admin/hindsight/observation-scopes
GET/api/admin/hindsight/observations
GET/api/admin/hindsight/operations
DELETE/api/admin/hindsight/operations/{id}
GET/api/admin/hindsight/operations/{id}
DELETE/api/admin/hindsight/operations/{id}/delete
POST/api/admin/hindsight/operations/{id}/retry
GET/api/admin/hindsight/overview
GET/api/admin/hindsight/stats/memories-timeseries
GET/api/admin/hindsight/tags

HindsightUpgradeController

方法路径
POST/api/admin/hindsight/upgrade
GET/api/admin/hindsight/upgrade/status
GET/api/admin/hindsight/upgrade/versions

LifeDataAdminController

方法路径
POST/api/admin/life/events
DELETE/api/admin/life/events/{id}
PUT/api/admin/life/events/{id}
GET/api/admin/life/patterns
GET/api/admin/life/stats
GET/api/admin/life/timeline
GET/api/admin/life/trend

OpenLoopAdminController

方法路径
GET/api/admin/memory/open-loops
POST/api/admin/memory/open-loops
POST/api/admin/memory/open-loops/batch-settle
GET/api/admin/memory/open-loops/preview
POST/api/admin/memory/open-loops/{id}/reopen
POST/api/admin/memory/open-loops/{id}/settle
POST/api/admin/memory/open-loops/{id}/snooze
POST/api/admin/memory/open-loops/{id}/stale
POST/api/admin/memory/open-loops/{id}/to-todo

RelationProfileAdminController

方法路径
GET/api/admin/ai/profile/relation
PUT/api/admin/ai/profile/relation

AI(module_ai)—— 59 个端点 ​

AiChatAdminController

方法路径
POST/api/admin/ai/chat/conversation
GET/api/admin/ai/chat/conversation/list
GET/api/admin/ai/chat/conversation/page
DELETE/api/admin/ai/chat/conversation/{id}
POST/api/admin/ai/chat/conversation/{id}/title
GET/api/admin/ai/chat/message/list
POST/api/admin/ai/chat/send
GET/api/admin/ai/chat/status
GET/api/admin/ai/chat/stream
GET/api/admin/ai/chat/turn/active
GET/api/admin/ai/chat/turn/{requestId}
GET/api/admin/ai/chat/usage/today
GET/api/admin/ai/chat/usage/trend

AiImageAdminController

方法路径
POST/api/admin/ai/image/generate

AiPromptAdminController

方法路径
GET/api/admin/ai/prompt/list
POST/api/admin/ai/prompt/save
DELETE/api/admin/ai/prompt/{id}

AiWritingAdminController

方法路径
GET/api/admin/ai/writing/assist/stream
POST/api/admin/ai/writing/reply-suggestion
POST/api/admin/ai/writing/summary
POST/api/admin/ai/writing/tags
POST/api/admin/ai/writing/titles

AvatarAdminController

方法路径
POST/api/admin/ai/avatar/conversation
DELETE/api/admin/ai/avatar/conversation/{id}
GET/api/admin/ai/avatar/conversations
GET/api/admin/ai/avatar/messages
GET/api/admin/ai/avatar/portal-conversations
GET/api/admin/ai/avatar/portal-messages
GET/api/admin/ai/avatar/stats
GET/api/admin/ai/avatar/stream

KbAdminController

方法路径
DELETE/api/admin/ai/kb/document/{docId}
GET/api/admin/ai/kb/document/{docId}/chunks
POST/api/admin/ai/kb/document/{docId}/retry
POST/api/admin/ai/kb/ingest
POST/api/admin/ai/kb/ingest-source
GET/api/admin/ai/kb/list
GET/api/admin/ai/kb/memory-stats
POST/api/admin/ai/kb/memory-status
POST/api/admin/ai/kb/rebuild
POST/api/admin/ai/kb/save
POST/api/admin/ai/kb/search
DELETE/api/admin/ai/kb/{id}
GET/api/admin/ai/kb/{id}/documents

PortalAvatarController

方法路径
GET/api/portal/ai/avatar/config
POST/api/portal/ai/avatar/conversation
POST/api/portal/ai/avatar/message/{id}/feedback
GET/api/portal/ai/avatar/messages
GET/api/portal/ai/avatar/stream

DailyDigestAdminController

方法路径
GET/api/admin/ai/digest
POST/api/admin/ai/digest/backfill
POST/api/admin/ai/digest/batch-delete
GET/api/admin/ai/digest/list
GET/api/admin/ai/digest/pending-count
DELETE/api/admin/ai/digest/{date}
GET/api/admin/ai/digest/{date}
PUT/api/admin/ai/digest/{date}/diary
POST/api/admin/ai/digest/{date}/publish-draft
POST/api/admin/ai/digest/{date}/regenerate
GET/api/admin/ai/digest/{date}/revisions

扩展平台(platform)—— 45 个端点 ​

AgentCapabilityController

方法路径
POST/api/internal/agent-capability/{runId}

WebProxyMcpController

方法路径
POST/api/internal/agent-capability/mcp

AdminExtensionController

方法路径
GET/api/admin/extensions
GET/api/admin/extensions/approvals
POST/api/admin/extensions/approvals/{id}/approve
POST/api/admin/extensions/approvals/{id}/reject
GET/api/admin/extensions/capabilities
GET/api/admin/extensions/drafts
POST/api/admin/extensions/drafts
GET/api/admin/extensions/drafts/{id}
PATCH/api/admin/extensions/drafts/{id}
POST/api/admin/extensions/drafts/{id}/publish
POST/api/admin/extensions/drafts/{id}/test
POST/api/admin/extensions/drafts/{id}/validate
POST/api/admin/extensions/effects/{effectId}/retry
GET/api/admin/extensions/runs
GET/api/admin/extensions/runs/{id}
GET/api/admin/extensions/runs/{id}/capability-calls
GET/api/admin/extensions/runs/{id}/effects
GET/api/admin/extensions/runs/{id}/logs
GET/api/admin/extensions/runs/{id}/policy-decisions
POST/api/admin/extensions/system/activate
GET/api/admin/extensions/system/kill-switch
POST/api/admin/extensions/system/kill-switch
POST/api/admin/extensions/system/pause
POST/api/admin/extensions/system/provision
GET/api/admin/extensions/system/status
DELETE/api/admin/extensions/triggers/{id}
PUT/api/admin/extensions/triggers/{id}
POST/api/admin/extensions/triggers/{id}/pause
POST/api/admin/extensions/triggers/{id}/resume
GET/api/admin/extensions/{key}
POST/api/admin/extensions/{key}/activate
GET/api/admin/extensions/{key}/grants
POST/api/admin/extensions/{key}/install
POST/api/admin/extensions/{key}/pause
POST/api/admin/extensions/{key}/rollback
GET/api/admin/extensions/capability-declarations
POST/api/admin/extensions/capability-declarations
POST/api/admin/extensions/capability-declarations/{id}/implemented
POST/api/admin/extensions/capability-declarations/{id}/approve
POST/api/admin/extensions/capability-declarations/{id}/disable
GET/api/admin/extensions/{key}/asset
POST/api/admin/extensions/{key}/state
GET/api/admin/extensions/{key}/versions
GET/api/admin/extensions/{key}/export
POST/api/admin/extensions/registry/import
POST/api/admin/extensions/{key}/selfcheck
POST/api/admin/extensions/{key}/triggers/from-manifest
GET/api/admin/extensions/runs/failures
POST/api/admin/extensions/{key}/run
GET/api/admin/extensions/{key}/runs
GET/api/admin/extensions/{key}/secrets
POST/api/admin/extensions/{key}/secrets
DELETE/api/admin/extensions/{key}/secrets/{name}
POST/api/admin/extensions/{key}/triggers
POST/api/admin/extensions/{key}/uninstall

ExtensionWebhookController

方法路径
POST/api/extensions/{key}/webhook/{triggerId}

日程(module_daily)—— 35 个端点 ​

DailyCourseAdminController

方法路径
GET/api/admin/daily/course/session
POST/api/admin/daily/course/session
PUT/api/admin/daily/course/session
DELETE/api/admin/daily/course/session/{id}
PATCH/api/admin/daily/course/session/{id}

DailyOverviewAdminController

方法路径
GET/api/admin/daily/calendar
GET/api/admin/daily/holiday/judge
GET/api/admin/daily/holiday/status
GET/api/admin/daily/overview

DailyReminderAdminController

方法路径
GET/api/admin/daily/reminder
POST/api/admin/daily/reminder/test
POST/api/admin/daily/reminder/{id}/retry

DailyTodoAdminController

方法路径
GET/api/admin/daily/todo
POST/api/admin/daily/todo
PUT/api/admin/daily/todo
GET/api/admin/daily/todo/next-steps
POST/api/admin/daily/todo/steps
PUT/api/admin/daily/todo/steps
DELETE/api/admin/daily/todo/steps/{stepId}
DELETE/api/admin/daily/todo/{id}
PATCH/api/admin/daily/todo/{id}
POST/api/admin/daily/todo/{id}/done
POST/api/admin/daily/todo/{id}/drop
GET/api/admin/daily/todo/{id}/progress
POST/api/admin/daily/todo/{id}/restore
POST/api/admin/daily/todo/{id}/skip
GET/api/admin/daily/todo/{id}/steps
PUT/api/admin/daily/todo/{id}/steps/order
POST/api/admin/daily/todo/{id}/undo

DailyTodoSeriesAdminController

方法路径
POST/api/admin/daily/todo/series
GET/api/admin/daily/todo/series/{id}
PUT/api/admin/daily/todo/series/{id}
POST/api/admin/daily/todo/series/{id}/resume
POST/api/admin/daily/todo/series/{id}/stop

DailyPortalController

方法路径
GET/api/portal/daily/today

运维(module_ops)—— 27 个端点 ​

AdminAiExportController

方法路径
GET/api/admin/ops/export/ai-data
GET/api/admin/ops/export/ai-data/preview

AdminAiOpsController

方法路径
GET/api/admin/ops/capability-health
GET/api/admin/ops/usage-report

AdminDashboardController

方法路径
GET/api/admin/system/dashboard
GET/api/admin/system/visit/trend

AdminOpsController

方法路径
GET/api/admin/system/ops/audit
POST/api/admin/system/ops/cleanup
GET/api/admin/system/ops/config/export
POST/api/admin/system/ops/config/import
GET/api/admin/system/ops/db-info
GET/api/admin/system/ops/health-report
GET/api/admin/system/ops/jobs
POST/api/admin/system/ops/jobs/lifeInterviewInvite/dry-run
POST/api/admin/system/ops/jobs/{jobName}/run
POST/api/admin/system/ops/link-check
GET/api/admin/system/ops/logs
GET/api/admin/system/ops/mail/logs
POST/api/admin/system/ops/mail/logs/{id}/retry
GET/api/admin/system/ops/rollback/status
GET/api/admin/system/ops/version

DshUpgradeController

方法路径
POST/api/admin/system/ops/dsh/rollback
GET/api/admin/system/ops/dsh/status
POST/api/admin/system/ops/dsh/upgrade

ExportAdminController

方法路径
GET/api/admin/system/export/markdown

ImportAdminController

方法路径
POST/api/admin/system/import/markdown
POST/api/admin/system/import/wordpress

笔记(module_note)—— 20 个端点 ​

NoteAdminController

方法路径
POST/api/admin/note
PUT/api/admin/note
GET/api/admin/note/history/{historyId}/content
GET/api/admin/note/page
POST/api/admin/note/tag
PUT/api/admin/note/tag
GET/api/admin/note/tag/list
DELETE/api/admin/note/tag/{id}
GET/api/admin/note/trash/page
DELETE/api/admin/note/{id}
GET/api/admin/note/{id}
GET/api/admin/note/{id}/history
POST/api/admin/note/{id}/history/{historyId}/rollback
POST/api/admin/note/{id}/publish
POST/api/admin/note/{id}/restore

NotebookAdminController

方法路径
POST/api/admin/note/notebook
PUT/api/admin/note/notebook
PUT/api/admin/note/notebook/sort
GET/api/admin/note/notebook/tree
DELETE/api/admin/note/notebook/{id}

助手(module_agent)—— 20 个端点 ​

AdminAgentTokenController

方法路径
GET/api/admin/agent/token/list
POST/api/admin/agent/token/save
DELETE/api/admin/agent/token/{id}
PUT/api/admin/agent/token/{id}/toggle

AgentInstructionsController

方法路径
GET/api/agent/instructions.md

AgentPromptAdminController

方法路径
GET/api/admin/ai/agent-prompt
PUT/api/admin/ai/agent-prompt
GET/api/admin/ai/agent-prompt/history
POST/api/admin/ai/agent-prompt/history/{id}/restore
DELETE/api/admin/ai/agent-prompt/{key}

AssistantMetricsAdminController

方法路径
GET/api/admin/ai/assistant-metrics

AssistantProfileAdminController

方法路径
GET/api/admin/ai/profile
PUT/api/admin/ai/profile
GET/api/admin/ai/profile/model
PUT/api/admin/ai/profile/model
POST/api/admin/ai/profile/model/cancel
GET/api/admin/ai/profile/permission
PUT/api/admin/ai/profile/permission

ExtensionMcpController

方法路径
POST/

McpController

方法路径
GET/

会话采集(module_conversation)—— 11 个端点 ​

AdminChatAttachmentController

方法路径
POST/api/admin/chat/attachments
GET/api/admin/chat/attachments/{id}/content

AgentChatAttachmentController

方法路径
POST/api/agent/chat/attachments
GET/api/agent/chat/attachments/{id}/content

AgentHeartbeatController

方法路径
POST/api/agent/heartbeat

AgentIngestController

方法路径
POST/api/agent/ingest/session
GET/api/agent/ingest/status

AgentSessionAdminController

方法路径
GET/api/admin/agent/sessions
GET/api/admin/agent/sessions/slugs
GET/api/admin/agent/sessions/{sessionId}
GET/api/admin/agent/sessions/{sessionId}/turns

模型(module_llm)—— 5 个端点 ​

AiProviderAdminController

方法路径
GET/api/admin/ai/provider/list
POST/api/admin/ai/provider/save
DELETE/api/admin/ai/provider/{id}
PUT/api/admin/ai/provider/{id}/activate
POST/api/admin/ai/provider/{id}/test

本页由 docs/vite-cosmos-项目说明.md 自动生成;请改源文件,不要改生成物。