Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions llmdoc/architecture.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ relations:
- cli-runtime/state-and-validation.mdx
- workflows/init-and-update.mdx
- plugin-packaging/claude-and-codex.mdx
- website/product-and-deployment.mdx
code:
paths:
- cli/src/cli.ts
Expand Down
17 changes: 10 additions & 7 deletions llmdoc/meta.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,25 +6,28 @@
},
"documents": {
"architecture.mdx": {
"validatedRevision": "5474197ed1cee62eaee541f93e1830b97474c0db"
"validatedRevision": "33b263754aa85d53e3a19a1daa67e24420e0a45e"
},
"cli-runtime/state-and-validation.mdx": {
"validatedRevision": "88e578b04885de7a8e104887834c57c1b1cff5ba"
"validatedRevision": "33b263754aa85d53e3a19a1daa67e24420e0a45e"
},
"cli-runtime/retrieval-and-mutation.mdx": {
"validatedRevision": "88e578b04885de7a8e104887834c57c1b1cff5ba"
"validatedRevision": "33b263754aa85d53e3a19a1daa67e24420e0a45e"
},
"plugin-packaging/claude-and-codex.mdx": {
"validatedRevision": "5474197ed1cee62eaee541f93e1830b97474c0db"
"validatedRevision": "33b263754aa85d53e3a19a1daa67e24420e0a45e"
},
"plugin-packaging/development-and-release.mdx": {
"validatedRevision": "5474197ed1cee62eaee541f93e1830b97474c0db"
"validatedRevision": "33b263754aa85d53e3a19a1daa67e24420e0a45e"
},
"workflows/init-and-update.mdx": {
"validatedRevision": "88e578b04885de7a8e104887834c57c1b1cff5ba"
"validatedRevision": "33b263754aa85d53e3a19a1daa67e24420e0a45e"
},
"workflows/prune-and-upgrade.mdx": {
"validatedRevision": "61ef5822ec305f61ebf41bb826e143a889c31e5e"
"validatedRevision": "33b263754aa85d53e3a19a1daa67e24420e0a45e"
},
"website/product-and-deployment.mdx": {
"validatedRevision": "c13545ef43718fa7114c57b382019027b2169451"
}
},
"convergence": {
Expand Down
32 changes: 32 additions & 0 deletions llmdoc/website/product-and-deployment.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
---
description: 官网的产品职责、公开知识投影与 Cloudflare 静态部署边界。
kind: architecture
relations:
requires:
- architecture.mdx
- cli-runtime/retrieval-and-mutation.mdx
- cli-runtime/state-and-validation.mdx
- plugin-packaging/claude-and-codex.mdx
- plugin-packaging/development-and-release.mdx
- workflows/init-and-update.mdx
- workflows/prune-and-upgrade.mdx
code:
paths:
- website/**
---

# 官网产品与部署边界

## 公开投影,不是第二套工具面

官网负责解释 llmdoc 的产品模型,并以中英文 Docs 和机器可读入口公开核心概念、工作流及 CLI 使用边界。CLI 与 tracked `llmdoc/` 仍分别是能力和仓库知识的 canonical surface;网站内容是便于人和 Agent 阅读的手工投影,不能反向定义新的 CLI 语义。

为官网或其他新入口新增工具能力前,先核对 canonical CLI 是否已经提供对应能力。已有能力默认在新入口中解释、演示或链接;只有存在独立用户场景、清晰数据边界和足够维护收益时才创建新实现,避免复制语义和形成第二真相源。

官网因此不接收或读取用户仓库,也不提供远程 Viewer。Viewer 属于 CLI 的本地只读投影,经 `serve` 绑定 loopback;官网只说明这一能力,不复制其仓库扫描、状态或文档渲染数据面。

## 静态部署边界

`website/` 是与 CLI 开发工作区分离构建的静态站点,通过 Cloudflare Static Assets 发布。部署面没有应用后端、持久状态或仓库数据 binding;改变这一点属于产品和安全边界变更,必须重新评估数据所有权、访问控制与第二真相源风险,而不是作为普通页面功能加入。

中英文页面与 `llms.txt` 共同组成公开知识投影。CLI、宿主安装、知识门或维护工作流的语义变化时,应复核这些表面的语义一致性;当前一致性依赖人工维护,不能假设已有机械 parity 保证。
4 changes: 4 additions & 0 deletions website/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
node_modules/
dist/
.astro/
.wrangler/
9 changes: 9 additions & 0 deletions website/astro.config.mjs
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
import { defineConfig } from "astro/config";
import sitemap from "@astrojs/sitemap";

export default defineConfig({
site: "https://llmdoc.tokenroll.ai",
output: "static",
trailingSlash: "always",
integrations: [sitemap()],
});
Loading
Loading