AI Context

本页从 仓库源码 生成，请在源码提交修改。

AI 开发上下文入口

此文件只提供导航；行为与完成状态以链接的源码、当前需求和验收为准。用户本次指令优先。

先读：AGENTS.md → docs/README.md → docs/00-product/PRD.md → docs/01-architecture/architecture.md → docs/04-ai/development.md。

Profile	组合根	身份	存储
web-platform	cmd/server	平台会话/RBAC	SQLite/PostgreSQL/MySQL
web-standalone	cmd/server	不装配平台身份	SQLite/PostgreSQL/MySQL
desktop	cmd/desktop	不装配平台身份	SQLite
cli	cmd/cli	不装配平台身份	none

唯一来源	位置
contract	packages/contracts/openapi.json
theme	assets/theme/tokens.json
brand	assets/brand/identity.json
instanceBrand	internal/branding/service.go
settings	internal/settings/service.go
edition	scripts/build-features.mjs
routes	packages/web-ui/src/routes.ts
session	packages/web-ui/src/session.tsx
migrations	migrations
decisions	docs/adr
status	docs/04-ai/foundation-audit.md
version	VERSION
release	docs/03-runbooks/release.md
platformPermissions	internal/platform/roles.go
authorization	docs/00-product/feature-roles.md
installation	docs/00-product/feature-installation.md
files	internal/files/service.go
blob	internal/blob/store.go
fileStorage	docs/03-runbooks/storage.md
businessExample	docs/03-runbooks/business-example.md
backup	docs/03-runbooks/backup.md
frameworkUpgrade	docs/03-runbooks/framework-upgrade.md
contributing	CONTRIBUTING.md
community	docs/03-runbooks/open-source.md
currentAcceptance	docs/04-ai/acceptance-multipart.md
wiki	docs/wiki/README.md
updates	internal/updates/service.go
updateTrust	assets/updates/config.json
updateHistory	assets/updates/history.gen.json
systemUpdates	docs/03-runbooks/updates.md
clientPreferences	packages/web-ui/src/preferences.ts
i18n	packages/web-ui/src/i18n.ts
clientAppearance	docs/03-runbooks/client-preferences.md
workspaceLayout	packages/web-ui/src/workspace-layout.tsx
frontendFoundations	docs/03-runbooks/frontend-foundations.md
i18nGate	scripts/check-i18n.mjs
adminTools	docs/03-runbooks/admin-tools.md
auditMetadata	internal/audit/context.go
mailContent	internal/mailcontent/template.go
richTextEditor	packages/web-ui/src/rich-text-editor.tsx
backendStandards	docs/02-standards/backend.md
baseEntity	internal/domain/entity.go
announcements	docs/03-runbooks/announcements.md
multipart	internal/blob/multipart.go
uploadDialog	packages/web-ui/src/file-upload-dialog.tsx

OpenAPI 当前包含 133 个 operation、140 个 schema。Go/TS 模型、调用描述与离线文档从同一源生成。不要手改生成文件。

任务 Skill	用途
add-api-operation	增加或修改 Unicore OpenAPI operation、共享 DTO、SDK 与 HTTP 接口，并验证契约及服务端权限。
add-cli-command	为 Unicore Cobra CLI 增加直接调用共享 Core 的命令、stdin/文件输入和结构化输出。
add-file-storage	扩展 Unicore 文件业务、存储提供商、直传或签名下载，保持 file_id 元数据与生命周期边界。
add-go-module	新增 Unicore Go 领域模块、用例、ports 与按 profile 装配的 adapter。
add-platform-permission	实现 Unicore web-platform 固定管理员/普通用户的菜单、页面与 API 权限，并验证越权边界。
add-react-page	新增 Unicore Web/Wails 共用响应式页面、导航或仪表盘 widget。
add-setting	向 Unicore SettingDefinition 增加分组设置、profile 范围、校验与敏感值处理。
app-lifecycle	修改 Unicore 配置加载、组件生命周期、日志或监控入口，并验证各 profile 的启动与退出。
db-migration	创建 Unicore 分方言数据库迁移、兼容评估与数据恢复说明。
maintain-framework-docs	维护 Unicore 面向 AI 开发的文档入口、框架 manifest、任务 Skills 与上下文生成检查。
release-cross-platform	构建 Unicore profile/OS/Arch 发行包、checksum/manifest 和原生桌面产物。
security-review	有范围地审查 Unicore 安装、身份、设置、传输、上传或升级的实际安全边界。

常用命令：

• generate：pnpm generate
• context：pnpm ai:context
• verify：make test
• pages：make test-e2e
• native：make build-desktop
• docs：make docs
• package：make package
• image：make docker-build
• deploy：make test-deploy
• create：pnpm create:project
• doctor：make doctor
• maintenance：make build-ops
• devDependencies：make dev-deps-up
• wiki：make wiki
• wikiPublish：make wiki-publish
• packageDesktop：make package-desktop
• signDesktop：make sign-desktop
• i18n：pnpm check:i18n

不保存凭据到上下文或验收记录。任务记录使用 任务模板，交付记录须区分实测、未测与未来目标。