Compare commits

...
3 Commits
564 changed files with 21091 additions and 20388 deletions

No files matched your search

+6 -221
View File
@@ -1,229 +1,14 @@
---
name: marqdo-dev
description: >-
Develop Marqdo programs and libraries the readable way: GFM tables as data,
code-as-documentation, table.put over json.set chains, lib/ext authoring.
Use when writing or refactoring .mq.md, creating lib/* or ext/*, reviewing
Marqdo style, fixing unreadable json glue, or when the user asks how to
develop Marqdo / 如何开发 marqdo.
description: Write, refactor and verify Marqdo programs, standard libraries and extensions through the executable development handbook. Use native Marqdo file tools and marqdo call; extend capability gaps through plugins or explicit external tools.
---
# Marqdo development (author + library)
Read [the executable development entry](../../../skills/marqdo-dev/index.mq.md), then [the programming guide](../../../doc/library-development.mq.md). The same guide governs programs, libraries and executable SKILLs. For installed skills, resolve these paths against the Marqdo source checkout.
Read this **before** writing or expanding `.mq.md`. Syntax basics stay in [marqdo](../marqdo/SKILL.md); this skill is the **style and library craft** contract.
Use `**statement**` to execute and `*return*` to return; write `[intent](actual code)` inside executable positions, and `access(coll, key)` to read collections. The guide provides real examples. Native file tasks live in [files.mq.md](../../../skills/marqdo-dev/files.mq.md): read, write, patch, search, inventory, audit and apply. Do not generate Python or shell programs for ordinary file operations.
## Non-negotiable: code is documentation
Prepare the native engineering plugin with the development entry before using its analysis or process tasks. The repository development binary is `target/debug/marqdo`; installed older binaries may need a bootstrap Cargo build through `lib/sys.mq.md exec`. All subsequent task execution uses `marqdo call`. Keep decisions and sequencing in readable mq.md; use a new extension or a documented foreign tool only for a real capability gap.
A `.mq.md` file must stay readable as Markdown. If a human cannot skim the data and intent without decoding nested `json.set` / `json.append` chains, the code is wrong.
The guide is authoritative for narrative over 50%, immediate parameter/return tables, inline statements and returns, GFM data, index.mq.md organization, recursive Markdown web components, failure evidence and verification. Read each task's contract and grant its actual effects. External processes retain their OS authority. Do not rewrite intentional test fixtures or restore removed compose_* APIs.
| Prefer | Avoid |
|--------|--------|
| GFM tables for maps, lists, records, wire, commands | Building the same with `json.set` / `json.append` |
| Named library helpers (`web.*`, `browser.*`, `table.*`) | Copy-paste effect-map glue in every handler |
| `table.put` for **one** dynamic key | Long `json.set` pipelines |
| `json.parse` / `json.stringify` / `json.quote` only | Using `json` as a general dict builder |
`lib/json` is for **parse / stringify / quote**. Collection edits use **GFM tables** and **`lib/table`** (`doc/design/stdlib-table.md`).
## How to shape data
### 1. GFM table geometry (memorize)
| Shape | Result |
|-------|--------|
| 1 column | list |
| ≥2 columns, **one** data row | map (headers = keys) |
| ≥2 columns, **many** rows | map of lists (column-oriented) |
| First header `@` / `行` / `row` | **list of maps** (row records) |
Cells are expressions (`doc/design/table-cell-expressions.md`): bare words = text, `` `var` `` = variable, quote paths/`/` ratios.
### 2. Good patterns (copy these — not `json.set`)
**Wire / steps / commands** — `@` record table:
```markdown
`wire` =
| @ | 选择器 | 事件 | 调用 |
|---|--------|------|------|
| 1 | "#bump" | click | bump |
```
**Multi-key return / boot** — map table with variable cells:
```markdown
`boot` =
| wire | set_text |
|------|----------|
| `wire` | `set_text` |
```
**Agent / LLM result map** — one readable row, not a `json.parse` + `json.set` chain:
```markdown
`out` =
| status | task | result | llm_calls | tokens |
|--------|------|--------|-----------|--------|
| ok | `task` | `reply` | `llm_calls` | `tokens` |
*out*
```
**Soft error pack** (transport / gate failure) — still a table humans can skim:
```markdown
`pack` =
| finish | text | error | usage | tool_calls |
|--------|------|-------|-------|------------|
| error | "" | `msg` | `usage0` | `empty_tc` |
*pack*
```
**Optional / conditional key** — sparse `table.put` after the static table (one dynamic key only):
```markdown
`out` =
| status | task |
|--------|------|
| error | `task` |
1. `err`
**out = > table.put in=`out` at="error" value=`err`**
2. *
**_ = 1**
```
**Empty list / empty map** — prefer stdlib seeds over `json.parse text=[]` / `{}`:
```markdown
**empty_tc = > table.empty_list**
**empty_map = > table.empty_map**
```
**Single dynamic key from scratch** — one `table.put` (or a helper), not a json chain:
```markdown
**`set_text` = table.put in=None at="#log" value=msg**
**table.put in=None at="set_text" value=set_text**
```
Better still — call a named helper:
```markdown
**browser.set_text sel="#log" text=msg**
```
**When `json.*` is OK:** `json.parse` / `json.stringify` / `json.quote` on **wire text**; `json.get` to read an opaque map. Never use `json.set` / `json.append` to *build* author-facing structures.
### 3. Bad pattern (do not write — and do not copy from old `ext/ai`)
```markdown
**`ret` = json.set map=None key="set_text" value=…**
**`ret` = json.set map=ret key="canvas" value=…**
**`cmds` = json.append list=cmds item=c0**
**`out` = json.parse text={"status":"ok"}**
**`out` = json.set map=out key="task" value=task**
```
Matching surrounding **legacy** `json.set` in `ext/ai/*.mq.md` is **not** compliance. Refactor the call site to tables / `table.put` instead of extending the glue.
## Writing application `.mq.md`
1. Frontmatter: title + imports (`table`, domain libs). **Do not import `json` unless parsing strings.**
2. `# main`: state binds, then **tables** for wire/config, return boot map via table or helper.
3. `##` handlers: short prose OK; data as tables; return via `browser.*` / `web.*` / one `table.put`.
4. Blank line between comment paragraphs and code.
5. Run `marqdo run path.mq.md` from repo root.
6. **Calls in narrative:** explain the action in its sentence, for example `` 读取之后得到**结果 = [读取文件](文件.读文本(路径=`路径`))**。 `` Return in the sentence with `` 完成后返回*结果*。 `` Keep real control structures and data tables separate when that improves reading. The label describes intent; the payload contains the actual call. See the executable library development guide.
7. **Do not use `##` inside `# main` for document sectioning** — those become nested functions. Use paragraphs / `---` breaks instead.
8. **Index:** use `access(collection, key)` (or `取`); `[描述](payload)` is executable occlusion, never an index by label.
Browser client programs: prefer nested `import:` with `browser: lib/browser.mq.md` (no native plugin). Server sites: Artifact Metadata (`type: web|endpoint`) + `ext/web` facade + `ext/data` / `ext/security` / `ext/net` — see [ext-web-artifact.md](../../doc/design/ext-web-artifact.md). **Never** restore `compose_*` / `app.configure`.
## Developing libraries (`lib/*`, `ext/*`)
Start with the [executable library development guide](../../../doc/library-development.mq.md): parameter/return tables below headings, prose >50%, inline assignments/returns and occlusion labels. Single-file stdlib needs no index; multi-file extensions organize through index.mq.md.
Design background + waves: [lib-code-as-docs.md](../../doc/design/lib-code-as-docs.md) · [roadmap/lib-ext-code-as-docs.md](../../doc/roadmap/lib-ext-code-as-docs.md).
### Goals
- **Authors** see tables and short calls; **library** may hide `table.put` / host calls.
- One concern per helper; name the effect (`set_text`, `canvas`, …), do not expose bag surgery.
- EN + ZH pair when shipping user-facing libs (`lib/browser.mq.md` ↔ `lib/浏览器.mq.md`, `ext/web` ↔ `ext/web/网页.mq.md`).
- `ext/**` never calls `host_*` — use plugins / public lib only (`doc/design/ext-agent.md`).
- Collection get: **`access(coll, key)`**; bracket labels are inert descriptions. Calls in examples may use `修饰 [fn] …` or classic `>` / bold.
### Library checklist
- [ ] Single-file stdlib is its own handbook; no forced index/module guide directory
- [ ] Parameter/type/default table directly below the function heading, then return contract
- [ ] Prose parameters; remove legacy `+` declarations in standard library sources
- [ ] Explain purpose, real input shape, output, failure and limits; narrative >50% per function
- [ ] Put assignments, occlusion calls and returns in explanatory sentences where natural; reserve separate blocks for real structure
- [ ] Use `[action](actual code)` inside return/statement markers for opaque host calls
- [ ] One actual example + short implementation; never pad prose to satisfy the ratio
- [ ] Public examples use **tables + helpers**, not json glue
- [ ] Read with `access(c, k)`; foreach `- [description](遍历 coll 为 item)`
- [ ] Function heading names the tool; tables and task explanation follow it
- [ ] Defaults on params; omit `None` fields in merged maps
- [ ] No `json.set` chains in new code — use `table.put` / `table.merge` / GFM
- [ ] `marqdo run` on a tiny demo under `examples/` or inline smoke
### Where helpers live
| Need | Place |
|------|--------|
| Browser effect maps (WASM client) | `lib/browser.mq.md` |
| Site HTML / HTTP | `ext/web` Document/Endpoint + View tables |
| DB / cache / storage | `ext/data` |
| Auth / OIDC / RBAC | `ext/security` |
| List/map primitives | `lib/table.mq.md` |
| Parse JSON text | `lib/json.mq.md` only |
## Refactoring existing glue
When editing a file full of `json.set`:
1. Turn static structures into GFM tables.
2. Replace repeated effect shapes with `browser.*` / `web.text_patch` / `web.dom_patch`.
3. Leave at most sparse `table.put` for dynamic keys.
4. Drop unused `json:` (or other) entries under nested `import:`.
## Anti-patterns
| Wrong | Right |
|-------|-------|
| `json.set` × N to build boot | GFM map table or `browser`/`web` helper |
| `json.append` to build command list | `@` record table |
| Dummy column to force a 1-key map | `table.put` or helper |
| Importing `ext/web` only for `text_patch` in WASM | `lib/browser` (no native plugin) |
| Unreadable nested maps as “clever” | Flatten into tables humans can read |
## Related
- Syntax: [marqdo/SKILL.md](../marqdo/SKILL.md) · [examples.md](../marqdo/examples.md)
- Tables: `doc/design/stdlib-table.md` · `doc/design/table-cell-expressions.md`
- Browser effects: `doc/roadmap/browser-wasm-e.md` · `doc/roadmap/browser-wasm-f.md`
- Release: [marqdo-release](../marqdo-release/SKILL.md)
## 渐进式契约 + MLSP(Phase 2/3 落地后的开发戒律)
- **契约实现**:`src/contract.rs`(类型词汇 / 三形状契约表解析 / 合并 / 四边界校验诊断);
`src/parse/mod.rs::extract_function_contract`(位置 + 形状双重判定,**在升参推断之前**执行;
绑定表与普通文档表绝不吃 ⇒ 无契约文件零回归)。契约表从 body 移除——元数据永不执行。
- **静态互查**:`src/check.rs`(`marqdo check [--json]`)——契约行 vs 升参推断形参双向漂移、
未知类型名、错位契约;Error ⇒ 非零退出。
- **AI 工具面**:`src/mlsp.rs`(`marqdo mlsp`,行分隔 JSON)——`locate` / `syntax` / `validate` /
`repair_targets` / `schema`。语法唯一事实来源 = `parse::CORE_CONSTRUCTS`(CI 守卫与
`doc/design/core-surface.md` 同步);MLSP 只加检索别名,**不定义语法**。
- **准入戒律**:新特性先过 `doc/design/layers.md` 三层归属(Language 层改动须 ADR + core-surface);
新契约形状/类型词汇 = 文档层扩展,进 `src/contract.rs`,不进词法/语法。
- **错误出口唯一**:`src/load.rs::label_error` 已示范——装载层/任何新代码都**不许**把
`Diagnostic` 拍平成字符串;错误链里必须能 `Diagnostic::find` 找回结构化诊断(AI/MLSP 面)。
Use the development entry's audit task to discover and review maintained repository sources. Its failed Result retains every finding; write_report=True saves the same evidence under .marqdo/audit. It does not execute inspected source or treat known placeholder warnings as completed logic.
+6 -207
View File
@@ -1,215 +1,14 @@
---
name: marqdo-release
description: >-
Run a Marqdo product release: detect latest version and ask the user for the
next tag (or confirm mode), update CHANGELOG/README/skills/public docs, bump
Cargo and/or ext/VERSION, sync VS Code extension when needed, publish GitHub
Release assets, upload extension packs to Cloudflare R2 (ext.marqdo.com) and
GitHub, ship Ubuntu CLI via PPA (scripts/ppa-ship.sh), and print manual
commands when sudo/GPG/network steps need the user. Use when the user asks to
release, cut a version, publish vX.Y.Z, ext-only pack, PPA, 发版, 发布新版本,
or tag marqdo.
description: Prepare, publish and verify a user-authorized Marqdo full, cli or extension release through its executable mq.md handbook. Use for release versioning, immutable tags, matching CI gates, GitHub/R2 parity and Ubuntu PPA publication.
---
# Marqdo release
Read [the executable release entry](../../../skills/marqdo-release/index.mq.md) and use its task routing. Version and mode come from the user; an already stated choice remains authorized. Inspection of an old release does not authorize republishing it. Never infer a new version, replace a tag, force-push or bypass hooks.
Canonical release playbook for **cflmy/marqdo**. Read this skill **before** tagging or uploading assets. Details: [reference.md](reference.md).
Use `marqdo call` on the actual handbook headings. The repository development binary is `target/debug/marqdo`; prepare its engineering plugin through [the development entry](../../../skills/marqdo-dev/index.mq.md). File reading and authoring use native [file tools](../../../skills/marqdo-dev/files.mq.md). No Python release orchestrator is required. New OS/service capabilities belong at explicit plugin or external-tool boundaries; version decisions, retries and publication order remain readable mq.md.
## Hard rules
The entry preserves full/cli/ext deliverables, separate editor sources, clean-main tagging, bilingual authored notes, exact-commit Release and EK gates, both native platforms, GitHub/R2 identical bytes, VERSION-after-ZIP ordering and Ubuntu source/build/apt evidence. Every applicable obligation must be verified before declaring completion. Default full/cli work includes PPA; gh-pages deployment needs its own instruction.
1. **Never invent the next version.** Detect current versions → **stop and ask the user** for the next SemVer (`X.Y.Z`) and **release mode** if unclear. Do not proceed until they confirm (unless they already stated both in the same message).
2. **Never force-push** `main` / tags. **Never** `--no-verify` unless the user explicitly orders it.
3. **Never commit `vscode-extension/` on `main`** (gitignored). Extension source lives only on branch **`vscode-extension`**. See `doc/design/vscode-extension-commit.md`.
4. **Do not release from a dirty tree** (except intentional release commits you create in this flow).
5. **Tag format:** CLI/full → `vX.Y.Z` matching root `Cargo.toml`. Ext-only → `ext-vX.Y.Z` matching `ext/VERSION` (Cargo may stay unchanged).
6. Prefer **tag push → GitHub Actions** (`.github/workflows/release.yml`) for Windows/Linux install assets. Local packaging is fallback / verification.
7. After network errors: apply [reference.md § Proxy](reference.md). **First try** `https://proxy.cflmy.top/github.com/cflmy/marqdo.git`. Retry; do not silently skip uploads. If needed: **HK jump** (`scripts/push-via-hk-jump.py`).
8. **Do not ship a full GitHub Release without the Linux extension/native zip** when the mode includes ext packs. Missing Linux packages = incomplete for that mode.
9. **Extension packs always publish to both** Cloudflare R2 (`https://ext.marqdo.com` via `scripts/upload-ext-r2.py`) **and** GitHub (Release assets / `ext-v*` tag). Credentials only in `~/.marqdo/r2.env` / CI — **never** commit. See [ext-cdn.md](../../../doc/design/ext-cdn.md).
10. **CLI Ubuntu package = PPA** (`ppa:cflmy/marqdo`) via `./scripts/ppa-ship.sh` / `ppa-build-source.sh`. GitHub zips remain for Windows and non-apt Linux.
11. **When a step needs the user** (sudo password, GPG passphrase, Launchpad UI, interactive `dput`): **stop, state what failed, and give the exact commands** to run in their terminal. Do not pretend the step succeeded.
12. **GitHub auto-build must be green before declaring a release done.** For full/cli: wait for the tag-triggered **Release** workflow (`windows` + `linux`) **and** the push-triggered **`executable-knowledge`** workflow on the release commit / `main` tip. Release asset zips alone are **not** sufficient — a green Release job with a red EK gate is an incomplete release. Do not skip or reframe a red `executable-knowledge` as “assets already uploaded.”
Read-only status and verification are separate from publication. Grant effects stated by each task. Inspect Result.ok before value; use --require-ok when an external automation must stop on a failed Result. Credentials stay in their existing private stores. Interactive sudo/GPG/dput or a failed service request remains incomplete: report the concrete failure and the exact handbook recovery call, preserving local evidence.
## Release modes
Ask (or take from user message) which mode:
| Mode | Bumps | Git tag | GitHub assets | R2 CDN | Ubuntu PPA |
|------|-------|---------|---------------|--------|------------|
| **full** (default) | `Cargo.toml` + `ext/VERSION` (same SemVer) | `vX.Y.Z` | CLI + ext + native + VSIX + … | yes | yes |
| **cli** | `Cargo.toml` only | `vX.Y.Z` | CLI (+ optional attach prior ext) | no (unless user asks) | yes |
| **ext** | `ext/VERSION` only | `ext-vX.Y.Z` (or attach to latest CLI release) | ext.zip + native-*.zip | **required** | no |
Defaults after version+mode confirmed — **do not re-ask**:
| Setting | Default |
|---------|---------|
| Sync / bump `vscode-extension` to same `VER` | **yes** for full/cli; **no** for ext-only |
| Push `main`, create annotated tag, push tag (trigger CI) | **yes** for full/cli |
| Ext packs → R2 **and** GitHub | **yes** whenever ext ships |
| Ubuntu PPA upload after CLI tag | **yes** for full/cli |
| Release notes language | **中英双语** |
| Deploy gh-pages after release | **no** (only if user asks) |
Phase 0 ask example:
> 当前最新 CLI **vA.B.C**,扩展包 **E.F.G**。请指定下一个版本号与模式(`full` / `cli` / `ext`,如 `1.0.3 full`)。
## Phase 0 — Detect versions (mandatory stop)
```bash
python3 .cursor/skills/marqdo-release/scripts/detect_version.py
```
Report briefly, then **ask for SemVer + mode** (unless already given). Normalize `VER` / `TAG`.
## Phase 1 — Preflight
```
Release progress:
- [ ] Phase 0: version + mode confirmed
- [ ] Phase 1: preflight green
- [ ] Phase 2: docs + version bumps committed
- [ ] Phase 3: extension branch (full/cli)
- [ ] Phase 4: main pushed; tag created & pushed
- [ ] Phase 5: CI / GitHub assets / notes
- [ ] Phase 6: R2 upload (if ext ships)
- [ ] Phase 7: Ubuntu PPA (full/cli)
- [ ] Phase 8: post-release checks
```
Checks: clean tree; `main` ff-only; smoke tests; CHANGELOG Unreleased; no secrets.
Also confirm the latest `main` **`executable-knowledge`** Actions run is green (or that this release commit will be covered after push) — do not proceed to tag if EK is already red on tip without a fix in the same release PR.
## Phase 2 — Docs & version bumps (main)
| File | full | cli | ext |
|------|------|-----|-----|
| `Cargo.toml` + `crates/marqdo-wasm/Cargo.toml` | bump | bump | — |
| `ext/VERSION` | bump | — | bump |
| `CHANGELOG.md` | `## vVER`(含**核心表面 Δ**,见 `doc/design/layers.md`) | same | `## Ext pack vVER` |
| `README.md` / `public/**` install + download table | update | update | update ext notes |
| `.cursor/skills/marqdo/SKILL.md` | if surface changed | same | rare |
| `.github/workflows/release.yml` Highlights stub | yes | yes | — |
```bash
./scripts/build-public.sh # when public/ sources changed
```
Commit + push `main` (proxy origin). On push failure → reference § Proxy; if still blocked, **print** for the user:
```bash
git push https://proxy.cflmy.top/github.com/cflmy/marqdo.git HEAD:main
# or: python3 scripts/push-via-hk-jump.py
```
## Phase 3 — VS Code / Cursor extension (full/cli only)
Default: bump `vscode-extension` package.json to `VER`, compile, push branch `vscode-extension`, return to `main`.
## Phase 4 — Tag & trigger CI (full/cli)
```bash
git tag -a "vVER" -m "vVER"
git push origin "vVER"
```
Ext-only:
```bash
git tag -a "ext-vVER" -m "ext-vVER"
git push origin "ext-vVER"
```
(or build zips locally / via workflow and `gh release upload`).
If tag push needs the user:
```bash
git push https://proxy.cflmy.top/github.com/cflmy/marqdo.git vVER
```
## Phase 5 — GitHub Release notes & assets
1. Wait for Actions (full/cli):
- Tag **Release** workflow: both `windows` and `linux` green when ext natives required.
- Push **`executable-knowledge`** workflow on the release commit / `main`: **must be success**. Poll with `gh run list --workflow=executable-knowledge.yml --branch main` / `gh run watch`. If EK is red → **stop**; fix plugin/harness on `main`, re-run; do **not** declare the release complete from assets alone.
2. Rewrite release body 中英双语 — [reference.md § Notes](reference.md).
3. Confirm Linux `marqdo-VER-native-x86_64-unknown-linux-gnu.zip` when mode ships ext.
## Phase 6 — Extension CDN (R2) — required when ext ships
```bash
# credentials: ~/.marqdo/r2.env (never commit)
python3 scripts/upload-ext-r2.py --version VER --from-dir dist/
curl -fsS https://ext.marqdo.com/latest/VERSION
```
Also ensure the **same** zips are on GitHub (`vVER` or `ext-vVER`). If R2 credentials missing, **tell the user**:
```bash
# put keys in ~/.marqdo/r2.env then:
python3 scripts/upload-ext-r2.py --version VER --from-dir dist/
```
## Phase 7 — Ubuntu PPA (full/cli)
Linux CLI for apt users. After `Cargo.toml` is at `VER` and `debian/changelog` has a matching `VER-1ppaN` stanza:
```bash
./scripts/ppa-ship.sh noble
```
Packaging notes / noble Cargo.lock v4: [ubuntu-ppa.md](../../../doc/design/ubuntu-ppa.md).
**If the agent cannot sudo / sign / dput**, print exactly:
```bash
cd ~/work/marqdo
./scripts/ppa-ship.sh noble
# or build then upload:
./scripts/ppa-build-source.sh noble
dput ppa:cflmy/marqdo ../build-area/marqdo_*~noble_source.changes
```
Watch: https://launchpad.net/~cflmy/+archive/ubuntu/marqdo/+builds
On Launchpad failure: read the build log, fix `debian/` or bundle script, bump `1ppaN`, re-upload. Tell the user the new `dput` command.
## Phase 8 — Post-release
1. `gh release view TAG` — assets + notes.
2. Confirm **`executable-knowledge`** and **Release** Actions are both green for this tag/commit; if either is red, say so and do not claim “发版完成”.
3. CDN `https://ext.marqdo.com/vVER/` (if ext shipped).
4. PPA build green (if cli shipped).
5. Tell user URLs: GitHub release, CDN, PPA install one-liner.
6. Optional gh-pages only if asked.
## Extension-only release (mode=ext)
1. User confirms **ext** SemVer (may differ from CLI).
2. Bump `ext/VERSION`; CHANGELOG → `## Ext pack vVER`.
3. Build/package `marqdo-VER-ext.zip` + `marqdo-VER-native-*.zip` (CI or local).
4. Upload to **R2 and GitHub** (required both).
5. Do **not** retag CLI / do **not** PPA unless user also asked for cli.
## Failure matrix (short)
| Failure | Action |
|---------|--------|
| `gh` / git TLS or Clash `7890` refused | Unset bad proxy; see [reference § Proxy](reference.md) |
| GitHub blocked | proxy.cflmy.top, then HK jump; **print commands** if agent cannot push |
| Tag exists | Stop; ask user |
| CI red (Release assets) | Fix on main; retag only if user allows |
| `executable-knowledge` red | Fix agent plugin / test harness (e.g. `ensure_agent_plugin_built`); push `main`; wait for EK green. **Do not** treat uploaded Release zips as a successful release |
| R2 upload fails | Print `upload-ext-r2.py` command; do not skip silently |
| PPA / sudo / GPG | Print `./scripts/ppa-ship.sh noble` (or `dput …`); do not skip silently |
| Launchpad `Cargo.lock` v4 / old cargo | Ensure bundled `third_party/rust` via current `ppa-build-source.sh`; bump `1ppaN` |
| Linux native zip missing (full/ext) | Incomplete — fix linux job or upload |
## Do not
- Ship without user-confirmed version (and mode when ambiguous).
- Ship ext packs to only one of R2 / GitHub.
- Call a full/cli release done without attempting PPA **or** giving the user the PPA commands.
- Commit `target/`, `dist/`, `*.wasm`, `third_party/rust/`, or `public/**/*.html` unless policy changes.
- Merge extension tree into `main`.
Independent extension releases commit reviewed bilingual notes at doc/releases/ext-X.Y.Z.md before tagging. The [pack handbook](../../../skills/marqdo-release/packs.mq.md) and extension-release.yml run native staging, both platform builds, exact-tag release creation and non-clobbering gh asset upload through marqdo call. An existing upload is inspected rather than replaced. Windows execution remains a CI obligation; a local Linux ZIP cannot prove it.
+2 -405
View File
@@ -1,406 +1,3 @@
# Marqdo release — reference
# Release task reference
Companion to [SKILL.md](SKILL.md). Use during a release; keep SKILL short.
## Detect versions (commands)
```bash
# From repo root
python3 .cursor/skills/marqdo-release/scripts/detect_version.py
# or manually:
git fetch --tags origin 2>/dev/null || true
echo "Cargo: $(sed -n 's/^version = \"\(.*\)\"/\1/p' Cargo.toml | head -1)"
echo "wasm: $(sed -n 's/^version = \"\(.*\)\"/\1/p' crates/marqdo-wasm/Cargo.toml | head -1)"
echo "tags: $(git tag -l 'v*' --sort=-v:refname | head -3 | tr '\n' ' ')"
gh release list --limit 3 2>/dev/null || true
```
**SemVer guidance for the ask (do not choose for the user):**
| Kind | When |
|------|------|
| patch `x.y.(z+1)` | Fixes, docs, no public API / MQ surface break |
| minor `x.(y+1).0` | New features (WASM route C, new ext APIs) backward compatible |
| major `(x+1).0.0` | Breaking MQ / CLI / plugin ABI |
## Asset matrix (CI tag `v*`)
Produced by `.github/workflows/release.yml` on **windows-latest** (`windows` job) and **ubuntu-latest** (`linux` job, **required**, `needs: windows`):
| Asset | Role | Job |
|-------|------|-----|
| `marqdo-VER-x86_64-pc-windows-msvc.exe` | CLI (stdlib embedded) | windows |
| `marqdo-VER-x86_64-pc-windows-msvc.zip` | `marqdo.exe` + `lib/` + `ext/` + native DLL | windows |
| `marqdo-VER-stdlib.zip` | `lib/` only | windows |
| `marqdo-VER-ext.zip` | Official `ext/` L1 | windows |
| `marqdo-VER-native-x86_64-pc-windows-msvc.zip` | Prebuilt Windows plugins (`native/*.dll`) | windows |
| `marqdo-VER-native-x86_64-unknown-linux-gnu.zip` | Prebuilt Linux plugins (`native/lib*.so`) — **must ship** | linux |
| `marqdo-VER-x86_64-unknown-linux-gnu.zip` | Linux CLI + `lib/` + `ext/` + native `.so` — **must ship** | linux |
| `marqdo-VER-source.zip` | `git archive` of tagged commit | windows |
| `marqdo-VER.vsix` | VS Code / Cursor (from branch `vscode-extension`) | windows |
| `marqdo-VER-public.zip` | Static user docs (`marqdo view output public`) | windows |
Not CI-uploaded (document in notes): macOS build from source; WASM via `marqdo wasm build` → `dist/wasm/`.
A release **without** the Linux native zip is incomplete (`marqdo ext add` on Linux cannot download prebuilts).
## Doc sync checklist (Phase 2 detail)
### CHANGELOG.md
1. Ensure `## Unreleased` lists everything shipping.
2. Rename to `## vVER — YYYY-MM-DD` (use release day in Asia/Shanghai unless user says otherwise).
3. Add a short **Highlights** subsection (install snippet + 3–6 bullets).
4. Insert empty:
```markdown
## Unreleased
### Added
### Fixed
### Changed
```
### README.md
Update every user-visible version pin, typically:
- Section title `## 现状(vVER)`
- `### 如何使用最新 Marqdo(vVER)`
- `git checkout vVER`
- Release URL `…/releases/tag/vVER`
Keep install / `ext add` / plugin build instructions accurate for this release.
### `.cursor/skills/marqdo/SKILL.md`
- Sync hard rules / feature bullets that this release changes (e.g. WASM, web).
- Do **not** dump full CHANGELOG into the skill.
- If release-only process changed, point to `.cursor/skills/marqdo-release/`.
### `public/` (author Markdown sources)
User tutorials under `public/` (not generated HTML). Update when:
- New CLI (`marqdo wasm …`, `ext add`, `version`)
- New tutorials (browser hello, web client embed)
- Version badges / “requires vVER” lines
Then regenerate HTML for zip/pages:
```bash
./scripts/build-public.sh
# Windows: powershell -File ./scripts/build-public.ps1
```
HTML under `public/**/*.html` is typically gitignored — zip still ships from CI `marqdo view output public`.
### Workflow stub
Edit `.github/workflows/release.yml` `body:` **Highlights** so the first auto body matches this tag (agent still replaces with full notes via `gh release edit`).
### Roadmaps / ADRs
If this release closes a wave: set status Completed in `doc/roadmap/*`; leave ADRs immutable (link from CHANGELOG).
## Extension checklist (Phase 3 detail)
Branch policy: `doc/design/vscode-extension-commit.md`.
```bash
git fetch origin vscode-extension
git checkout vscode-extension
# edit vscode-extension/package.json version → VER
# npm ci && npm run compile
git add vscode-extension/
git commit -m "$(cat <<'EOF'
vscode-extension: bump to VER for release
EOF
)"
git push origin vscode-extension
git checkout main
```
Local VSIX only (fallback):
```bash
git fetch origin vscode-extension
git checkout origin/vscode-extension -- vscode-extension
(cd vscode-extension && npm ci && npm run compile && npx @vscode/vsce package --no-dependencies -o "../dist/marqdo-VER.vsix")
# cleanup ignored tree if desired
gh release upload "vVER" "dist/marqdo-VER.vsix" --clobber
```
## Defaults (mirror of SKILL)
| Setting | Default |
|---------|---------|
| Sync `vscode-extension` to `VER` | yes |
| Push main + annotated tag immediately | yes |
| Release notes | 中英双语 |
| Skip VSIX / docs-only / deploy pages | no |
Phase 0 asks **only** for the next version unless the user wants overrides.
## Notes template (中英双语 — default)
Save as `/tmp/marqdo-vVER-notes.md` then:
```bash
gh release edit "vVER" --notes-file /tmp/marqdo-vVER-notes.md
```
```markdown
## Marqdo vVER
### 亮点 / Highlights
- **中文** … / **EN** …
- …
### 安装 / Install
```bash
git clone https://github.com/cflmy/marqdo.git && cd marqdo
git checkout vVER
cargo build --release
./target/release/marqdo version
cargo build --release -p marqdo_plugin_web -p marqdo_plugin_agent -p marqdo_plugin_quantum -p marqdo_plugin_linalg
marqdo ext add web && marqdo ext add agent && marqdo ext add quantum
# 中文 id:网页 / 智能体 / 量子
```
**浏览器 WASM / Browser WASM**
```bash
marqdo wasm build
# → dist/wasm/marqdo_wasm_bg.wasm + marqdo-bridge.js
# examples: examples/browser-hello/
```
### 破坏性变更 / Breaking changes
- 无 / None
- …
### 下载 / Downloads
| Asset | 内容 / Contents |
|-------|-----------------|
| `marqdo-*-windows-msvc.exe` | CLI(内置 stdlib) |
| `marqdo-*-windows-msvc.zip` | exe + `lib/` + `ext/`(含 native) |
| `marqdo-*-unknown-linux-gnu.zip` | Linux CLI + `lib/` + `ext/` + `.so` |
| `marqdo-*-native-*.zip` | 预编译 `web`/`agent`/`quantum`/`linalg`(Win + **Linux 必出**) |
| `marqdo-*-stdlib.zip` | 仅 `lib/` |
| `marqdo-*-ext.zip` | 官方 `ext/` |
| `marqdo-*-source.zip` | 源码快照 |
| `marqdo-*.vsix` | VS Code / Cursor 扩展 |
| `marqdo-*-public.zip` | 用户文档站 |
扩展源码分支 / Extension branch: **`vscode-extension`** ([policy](https://github.com/cflmy/marqdo/blob/main/doc/design/vscode-extension-commit.md)).
### 链接 / Links
- [CHANGELOG](https://github.com/cflmy/marqdo/blob/main/CHANGELOG.md)
- [README](https://github.com/cflmy/marqdo/blob/main/README.md)
```
## Proxy & auth (network recovery)
Symptoms seen in this project: broken local Clash on `127.0.0.1:7890`, flaky GitHub TLS, `gh` needing token, Cursor agent sandbox with only `lo`.
### `proxy.cflmy.top` (try this first)
This machine’s `origin` is typically:
```
https://proxy.cflmy.top/github.com/cflmy/marqdo.git
```
Push / fetch / tag through that remote (HTTPS reverse proxy to GitHub):
```bash
git remote -v # confirm origin uses proxy.cflmy.top
git push origin main
git push origin vVER
git push origin vscode-extension
# one-shot if origin still points at github.com:
git push https://proxy.cflmy.top/github.com/cflmy/marqdo.git HEAD:main
git push https://proxy.cflmy.top/github.com/cflmy/marqdo.git vVER
```
Short GETs via the proxy often work; **long `git push` may still time out**. If push hangs or drops, skip Clash retries and go to **HK SSH jump** below.
`gh` / Release API can use the same path reverse-proxy:
| Path prefix | Upstream |
|-------------|----------|
| `/github.com/` | `https://github.com/` |
| `/api.github.com/` | `https://api.github.com/` |
| `/uploads.github.com/` | `https://uploads.github.com/` (Release asset POST; OpenResty on HK) |
```bash
# Upload a Release asset through proxy.cflmy.top (Content-Type: application/octet-stream)
curl -X POST \
-H "Authorization: Bearer $GH_TOKEN" \
-H "Accept: application/vnd.github+json" \
-H "Content-Type: application/octet-stream" \
--data-binary @dist/FILE.zip \
"https://proxy.cflmy.top/uploads.github.com/repos/cflmy/marqdo/releases/RELEASE_ID/assets?name=FILE.zip"
```
Do **not** rewrite `Host: uploads.github.com` against `proxy.cflmy.top` without the `/uploads.github.com/` path prefix — that returns 404.
### Diagnose
```bash
env | grep -iE 'proxy|PROXY' || true
curl -sI --max-time 15 https://github.com | head -5
curl -sS --max-time 15 -o /dev/null -w 'proxy=%{http_code}\n' https://proxy.cflmy.top/ || true
gh auth status
ip -br addr | head -5 # agent may lack enp*; use required_permissions: ["all"]
```
### Fix order
1. **Unset bad proxy** if connection refused:
```bash
unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY ALL_PROXY all_proxy
# also clear for one git call: git -c http.proxy= -c https.proxy= …
```
2. **Set a working proxy** only if the user provides one (or known working):
```bash
export HTTPS_PROXY=http://HOST:PORT
export HTTP_PROXY=http://HOST:PORT
```
3. **Agent Shell**: retry `git push` / `gh` with `required_permissions: ["all"]` (and `full_network` if needed).
4. **`gh` auth**: if `gh auth status` fails, ask user to `gh auth login` or set `GH_TOKEN` / `GITHUB_TOKEN` for the session — **never commit tokens**. Fallback used in this repo: load password from `git credential fill` (`protocol=https` / `host=github.com`) into `GH_TOKEN` for the session only, then delete the temp env file.
5. **Git remote**: prefer `https://github.com/cflmy/marqdo.git`; SSH needs keys.
6. **HK SSH jump (preferred when GitHub is blocked but HK is reachable)** — see next subsection.
7. **Partial upload**:
```bash
gh release upload "vVER" dist/FILE --clobber
```
8. **Re-run CI** without retagging (if tag already correct):
```bash
gh workflow run Release --ref "vVER" # only if workflow_dispatch exists; else fix + new patch tag
```
Current Release workflow is **tag-push only**. Red CI after tag → fix on `main`, then either new patch tag or **user-approved** delete+recreate tag (dangerous; prefer patch).
**Also required before declaring release done:** the push-triggered **`executable-knowledge`** workflow on the release commit / `main` tip must be **success**. Poll with:
```bash
gh run list --workflow=executable-knowledge.yml --branch main --limit 5
gh run watch <run-id>
```
A green Release asset job with a red `executable-knowledge` gate is an **incomplete** release — fix the plugin/harness (e.g. `ensure_agent_plugin_built` for agent-dependent EK tests), push `main`, and wait for EK green. Do not skip.
### HK SSH jump (Paramiko CONNECT)
**When to use:** local → GitHub fails (timeout / TLS / Clash flaky / reverse-proxy `proxy.cflmy.top` connect drops), but this host can reach an overseas box that has stable GitHub (default `hk.cflmy.de`). Proven path for v0.3.9 push/tag/`gh`.
**Do not** rely on OpenSSH + `sshpass` here — password auth has hung; use **Paramiko** (`python3-paramiko`).
**Never** commit the HK root password or tokens. Ask the user for the password (or a key), put it in env / a `600` temp file, scrub after.
```bash
# one-shot password file (example — use the secret the user gave this session)
printf '%s' "$HK_PASSWORD_FROM_USER" > /tmp/.hk_ssh_pw && chmod 600 /tmp/.hk_ssh_pw
export HK_SSH_HOST=hk.cflmy.de # or 83.229.126.119
export HK_SSH_USER=root
export HK_SSH_PASSWORD_FILE=/tmp/.hk_ssh_pw
# optional: HK_JUMP_PORT=18081
SCRIPT=.cursor/skills/marqdo-release/scripts/push-via-hk-jump.py
# push / tag / extension (git gets CONNECT proxy + github.com askpass)
python3 "$SCRIPT" -- git push origin main
python3 "$SCRIPT" -- git push origin vscode-extension
python3 "$SCRIPT" -- git push origin vVER
# gh (sets GH_TOKEN from git credential fill if unset)
python3 "$SCRIPT" -- gh release edit vVER --notes-file /tmp/notes.md
python3 "$SCRIPT" -- gh run list --workflow=Release --limit 3
# leave proxy up for manual commands
python3 "$SCRIPT" --serve # then: export https_proxy=http://127.0.0.1:18081
rm -f /tmp/.hk_ssh_pw
```
Script behavior: SSH to HK → local `http://127.0.0.1:$HK_JUMP_PORT` HTTP CONNECT via `direct-tcpip` → run `git`/`gh`/`curl` with that proxy. Git auth uses local `git credential` via `http.extraHeader` (Basic) — **not** `GIT_ASKPASS` (askpass has hung under agent/no TTY). Tokens never go to the jump host disk.
Optional path reverse-proxy (`https://proxy.cflmy.top/github.com/…` `insteadOf`) may work for short GETs; treat long `git push` failures as a signal to use the HK jump instead of retrying Clash forever.
## Local Windows fallback
```powershell
powershell -File ./scripts/release-full.ps1 -Tag vVER -Upload
# -SkipVsix / -SkipPublic / -DeployPages as needed
```
Also: `scripts/release-windows.ps1`, `scripts/publish-release.py` if present.
## Commit message style
```text
release: vVER — <highlight>
```
Extension:
```text
vscode-extension: bump to VER for release
```
## Pre-tag test suggestions
Minimum:
```bash
cargo test --test gold structure_hello
./target/release/marqdo version # after cargo build --release
```
Stronger (time permitting):
```bash
cargo test --test gold
cargo test -p marqdo-wasm -- --nocapture # if wasm tests exist
# optional Node: node tests/wasm/smoke.mjs after marqdo wasm build
```
## Ask-user prompt (copy)
```text
版本探测结果:
- Cargo.toml: A.B.C
- crates/marqdo-wasm: …
- 最新 git tag: v…
- 最新 GitHub Release: v…
- CHANGELOG Unreleased: 有 / 无(摘要:…)
请指定下一个版本号(例如 0.3.2)。
默认(无需确认):同步 vscode-extension 同号、立刻 push tag 发版、发布说明中英双语。
若要改默认请一并说明。
```
Use [the executable release entry](../../../skills/marqdo-release/index.mq.md) and [its maintained task reference](../../../skills/marqdo-release/reference.md). File authoring, mode rules, native service/process boundaries and recovery live with the actual mq.md tasks. Do not reconstruct the former Python or terminal playbook from historical copies.
+51 -270
View File
@@ -1,281 +1,62 @@
---
name: marqdo
description: >-
Author and edit Marqdo programs (.mq.md): Markdown markers are executable
syntax (functions, calls, statements, returns, control flow). Use when writing
or modifying .mq.md files, teaching Marqdo, generating Marqdo from prose,
importing lib/* or ext/web or ext/quantum, running marqdo CLI, building dynamic
sites with ext/web, quantum circuits with ext/quantum, or when the user
mentions Marqdo, mq.md, markup-as-syntax, code-as-documentation, web/网页, or
quantum/量子 extension (ZH under ext/quantum/量子/).
description: Author, run and review readable Marqdo programs, libraries and executable knowledge. Use for .mq.md, marqdo call, Document/Endpoint/Resource web projects and quantum tools; read the executable programming and development handbooks.
---
# Marqdo development
# Marqdo
Marqdo = **Markdown markers as syntax**. A `.mq.md` file is both documentation and a runnable program. Read this skill **before** inventing syntax from Markdown habits or Python.
<!-- CORE_SYNTAX_V2.1: keep this card within the first 1200 body characters -->
<!-- CORE_SYNTAX_V2.1: must stay at the top so skill_brief budgets never truncate it -->
## CORE SYNTAX
## CORE SYNTAX (v2.1 Occlusion — mandatory)
Occlusion is the current default. `**…**` executes a statement; `*…*` returns.
Use `[intent](actual code)` in an executable position: the label is prose and
only its payload executes. Empty parentheses are a pending None stub.
Read collections with `access(coll, key)`. Classic indexing is only for explicit
legacy sources and migration. Reading narrative references never runs effects.
These rules are the **current default**. Do **not** teach Classic `[key](map)` index or “bold is return of print”. Classic migration only: [migration-classic.md](migration-classic.md).
1. **File suffix** `.mq.md`. Print with `> print text=…` / `> 打印 内容=…` — never use `**…**` to print.
2. **`**…**` = statement** (assign / call / expression). `*…*` = return. Closing markers touch the last token (no trailing space).
3. **`[描述](payload)` = occlusion:** `[]` is prose (never executed); `()` is the only executed part. Empty `()` → `None` stub.
4. **Read collections with `access(coll, key)`** (aliases `取` / `取值`). **Never** use `[key](map)` as index under default Occlusion.
5. **Foreach:** `- [描述](遍历 coll 为 item)` (`遍历`/`for`, `为`/`as`/`in`). Prefer explicit traversal when generating new code.
6. **Import / call:** frontmatter `import:` / `导入:`; call `lib.member`. One language (EN or ZH) per file.
7. **Control flow:** `#` object/type, `##`+ function, prose params (legacy `+` remains parseable), `1.`/`2.` branches, `-` loops, `N. *` else. No invented `if`/`for`/`def`/`return` keywords.
8. **Prose vs code:** blank line separates comment paragraphs from executable lines.
9. **GFM tables** for data; prefer `table.put` over `json.set` chains. `ext/**` never calls `host_*`.
10. Body narrative `[描述](target)` is lazy (NarrativeRef) — reading does not execute side effects.
| Marker | Meaning (v2.1) |
|--------|----------------|
| `#` / `##`+ | Object/type · function/method |
| Marker | Meaning |
|---|---|
| `**…**` | Statement (assign / call / expression) |
| `*…*` | Return |
| `[描述](payload)` | Occlusion step (payload executes) |
| `[intent](payload)` | Readable intent with executable payload |
| `access(c, k)` | Collection read |
| `> fn …` | Call |
| GFM table | Collection literal |
Canonical: `doc/design/core-surface.md`, `doc/design/document-native-development-guide.md`. Deeper tables: [reference.md](reference.md). Patterns: [examples.md](examples.md). Authoring craft: [marqdo-dev](../marqdo-dev/SKILL.md). Release: [marqdo-release](../marqdo-release/SKILL.md).
Executable-knowledge gate: [`tests/executable_knowledge/`](../../tests/executable_knowledge/README.md).
## Hard rules (do not violate)
1. Obey **CORE SYNTAX** above — Occlusion is default; do not emit Classic index links.
2. **Identifiers:** declare library parameters in prose as `` input `name` `` (defaults follow `=`); inside `*…*` / `**…**` bare ids are variables. Quote text literals. Standalone `>` calls: backticks where bare would be text.
3. **Structure lines** (`#` `>` `+` `-` `|`) are not wrapped in italics.
4. **Paths:** bare `/` in expressions is division; in call args / table cells unspaced `a/b` is path text. Ratios as text need quotes (`"1/5"`).
5. End side-effect-only helpers with `*None*` / `*空*` / `**` / `****` when the outer function continues. Lone `---` is a thematic break, not function end.
6. **`ext/**` never calls `host_*`.** Prefer tables over `json.set` / `json.append`.
7. **One language per file.** Sandbox trial before promoting Agent-generated trees.
8. Browser: Marqdo on WASM + `lib/browser` tables; do not hand-write business JS.
## Call one function
```markdown
# 计算器
## 加法
计算两个数字`a`和`b`的和。
*[计算结果](a + b)*
```
```
marqdo call calculator.mq.md 计算器.加法 a=2 b=3
```
prints `5`. The same command works on any `.mq.md`; the file does not need a special skill name.
## Minimal program
```markdown
# main
> print text=Hello World!
```
Chinese builtins (same functions, no import):
```markdown
# main
> 打印 内容=你好
```
## Functions, calls, end-body
```markdown
# main
> greet who=Marqdo
## greet
+ `who`
> print text=Hello, `who`!
*None*
```
- Call: `> name key=value` or `> name value`.
- Nested helpers use deeper `#` (`##`, `###`, …).
- After a helper with only side effects, end with `*None*` / whole-line `**` / `****` when later lines must stay in the outer function. Lone `---` is only a thematic break (skipped).
- In bold assigns, prefer bare calls: `**摘要 = 结账摘要 …**` (omit `>`).
## Statements, returns, branches
```markdown
**x = 1**
**y = x + 2**
## add_one
+ `n`
*n + 1*
```
```markdown
*n = 0*
1. `n` > 0
> print text=positive
2. `n` < 0
> print text=negative
3. *
> print text=zero
```
## Frontmatter imports + stdlib
A standard library is normally one `lib/*.mq.md` file: read/import/call that file directly. It is its own manual and skill; no `index.mq.md` or module handbook directory is required. Each function puts parameter/default and return tables directly below its heading, explains purpose, failures and limits, and keeps narrative above 50%. Use prose parameters, not legacy `+` declarations. Describe opaque instructions with `[what it does](actual code)` inside statement/return markers; labels do not execute. Multi-file extensions use an index to organize their files. File tools require explicit `--effects fs.read` or `--effects fs.write` with `--fs-root`; real workflows live in `examples/stdlib-handbook`. Read the [executable authoring guide](../../../doc/library-development.mq.md) for inline prose and complete runnable examples.
Imports use nested YAML `import:` (`导入` equivalent): file (`.mq.md`) or short name (`lib.member`). Members are **not** flattened into the caller. Call with a bare dotted path:
```markdown
---
title: example
import:
text: lib/text.mq.md
clock: lib/time.mq.md
---
# main
**xs = > text.split value="a,b,c" sep=","**
> print text=`xs`
**t = > clock.now_unix**
```
- Import **English** or **Chinese** library file; call that file’s API names via `lib.member` (do not mix languages).
- Instance methods stay `` > `obj`.method `` (backticks on the receiver only).
- `lib/…` resolves via `MARQDO_LIB`, cwd `lib/`, or `lib/` next to the `marqdo` binary.
- Design: [module-namespace.md](../../doc/design/module-namespace.md).
- Official optional extensions (`ext/`, not stdlib): install with `marqdo ext add llm|agent|web|quantum` (see `doc/design/ext-cli.md`). `ext/llm` — chat; **`ext/agent`** — document-driven agents (see **ext/agent** below); **`ext/web`** — dynamic sites (see below); **`ext/quantum`** — circuits + Q7/Q8 (see below).
- Native plugins: `lib/plugin` — `## load` / `unload` / `list`. C ABI: `include/marqdo_abi.h`.
- Prefer `table.put` / `表.改` for list/map element updates; keep `json` for parse/stringify/quote (see `doc/design/stdlib-table.md`).
- Builtins (no import): `print`/`打印`, `input`/`输入`, `len`/`长度`, `str`/`文本`, `int`/`整数`; literals `True`/`真`, `False`/`假`, `None`/`空`; logic `and`/`且`, `or`/`或`, `not`/`非`.
Stdlib map: [reference.md](reference.md).
## Official extension: `ext/agent` (document-driven)
Install: `marqdo ext add agent` (ZH: `智能体`). Native: `cargo build --release -p marqdo_plugin_agent`.
**Constitution (do not dilute):**
1. **Code is documentation** — the runbook `.mq.md` is the model’s ground truth, not a hidden system prompt bag.
2. **Call site is first-class** — `build_step_context` injects path/function/line so the model knows where it is in the program.
3. **Document is the knowledge base (OKF)** — writeback → promote/solidify → reuse / `llm_free`; MCP/corpus are evidence only.
APIs: `# agent` / `# 智能体` → `## step` / `## plan`. Context: standing + task + **call site** + tools + budgeted source/skill + act protocol (`CALL:` / `READ:`).
Examples: [agent-pong](../../examples/agent-pong/) · [agent-okf-flywheel](../../examples/agent-okf-flywheel/) · [agent-sandbox-okf](../../examples/agent-sandbox-okf/). Harness: `scripts/agent-harness.sh`. Design: [ext-agent.md](../../doc/design/ext-agent.md) · optimize O1–O5: [ext-ai-optimize.md](../../doc/roadmap/ext-ai-optimize.md). Dev LLM: copy [.env.example](../../.env.example) → `.env` (gitignored).
**Sandbox (O1):** `import sandbox:ext/ai/sandbox.mq.md` · `agent.trial` / `智能体.试跑` · `run`/`step` take `sandbox=` / `沙盒=` (default `False`). Profile caps are tables via `sandbox.profile`. Gold: `tests/ext/agent-sandbox-optin.mq.md`.
## Official extension: `ext/web` (Document / Endpoint / Resource)
Install: `marqdo ext add web` (ZH id: `网页`). See ADR 0007 · [ext-web-artifact.md](../../doc/design/ext-web-artifact.md).
**Do not degrade:** Document/Endpoint metadata; facade `web.page|route|serve|render|inspect`; View `|type|slot|value|attrs|style|` only; no `compose_*` / `configure` / author `ensure_plugin`. DB → `ext/data`; auth → `ext/security`; net → `ext/net`.
- **Root skill (agents first):** [`ext/web/index.mq.md`](../../ext/web/index.mq.md) · ZH [`ext/web/网页/索引.mq.md`](../../ext/web/网页/索引.mq.md)(作者门面仍为 `网页.mq.md`)
- **Layout law (in-package):** file-partition pages (nav/sidebar/footer/…) until simple; no HTML/CSS injection as default — [`ext/web/layout/index.mq.md`](../../ext/web/layout/index.mq.md) · [ext-web-layout-paradigm.md](../../doc/design/ext-web-layout-paradigm.md)
- **Recursive practice:** home → nav/main/footer → footer brand/links → links docs/community; continue until a leaf is plain Markdown. Parents import children and declare one relationship. Use `component.markdown`, `component.wrap`, `layout.stack`, and `layout.columns`; merge alone gives siblings, not columns.
- **Runnable reference:** [web-layout-handbook](../../../examples/web-layout-handbook/index.mq.md) and [Chinese reference](../../../examples/web-layout-handbook-zh/index.mq.md). A composed Document declares `view: main` and returns node rows at startup; ordinary Documents keep their Markdown/data-source path. Use `inspect root=...` for disk routes, and `run` for a live server.
- EN author facade: `import web:ext/web/web.mq.md`
- Agent: `marqdo call ext/web/layout/index.mq.md rules --json` then facade tools with `--effects plugin`
Design: [ext-web-artifact.md](../../doc/design/ext-web-artifact.md) · example: [examples/marqdo-blog/](../../examples/marqdo-blog/).
## Official extension: `ext/quantum` (circuits + Q7/Q8)
Install: `marqdo ext add quantum` (ZH id: `量子`). Build: `cargo build --release -p marqdo_plugin_quantum`, then **`marqdo ext add quantum` again** so view loads the new `libquantum.so` (stale plugin = old black/white circuits).
- **Root skill (read first):** [`ext/quantum/index.mq.md`](../../ext/quantum/index.mq.md) — explains every module and exact `marqdo call` commands for agents with no other context.
- **Ext paradigm:** [`doc/design/ext-skill-tools-paradigm.md`](../../doc/design/ext-skill-tools-paradigm.md) — code=doc=skill=tools; checklist for new packs.
- **Modules:** `circuit/` · `gate/` · `simulate/` · `state/` · `density/` · `viz/` · `_capability/` (each has `index.mq.md`). ZH package: `ext/quantum/量子/`(根 `索引.mq.md`,模块同名中文目录).
- **Agent:** `marqdo call ext/quantum/<module>/index.mq.md <fn> … --effects plugin` (`--toget` / `$name`). Narration: `marqdo check --narrative-ratio FILE`.
- **Author import example:** `circuit: ext/quantum/circuit/index.mq.md` then `circuit.circuit` / method chain.
**Hard rules:** `ext/**` never calls `host_*`; hot path is ABI plugin; ≤12 qubits for statevector; density-matrix ops ≤6 qubits; one language file per program; quote draw string args (`kind="…"`, `theme="…"`).
**Core:** domain skills above (`# circuit` / `# gate` / `# density` on module files) — table `steps=` or method chain; `simulate` / `probabilities` / `run` / `draw`.
**Q7 linear algebra:** `density`, `partial_trace`, `eig`, `expect` (Pauli string, left=high bit), `purity`, `kron`, `schmidt`, `fidelity`.
**Draw kinds:** `circuit|probs|bloch|hinton|city|density|paulivec|qsphere|multibloch`.
**Q8 themes (circuit / probs / bloch):** `theme="dark"|"light"|"bw"` (ZH `主题=`; **default `dark`** — slate lab look, gate-family colors, label chips so wires never cross `q0` text). View plot chrome follows `data-theme` on the SVG. Advanced kinds (hinton/…) still Q8c pending full re-skin.
```markdown
**_ = > `qc`.draw kind="circuit" theme="dark"**
**_ = > `qc`.draw kind="probs" theme="light"**
```
Design: [ext-quantum.md](../../doc/design/ext-quantum.md) · Q7: [ext-quantum-q7.md](../../doc/design/ext-quantum-q7.md) · Q8 viz: [ext-quantum-viz-style.md](../../doc/design/ext-quantum-viz-style.md) · examples: [quantum-bell](../../examples/quantum-bell/) · [quantum-entanglement](../../examples/quantum-entanglement/).
## Foreign kernels (v1.5.0)
`lib/foreign` is now a full foreign-kernel surface, not only `run`:
- `invoke` returns a record (`ok`, `code`, `stdout`, `stderr`, `ms`, `timed_out`, `truncated`, `result`); pass `input` for JSON stdin and `output="json"` for a parsed result.
- `call` is JSON-in / JSON-out; `call_many` fans out one program over a list with ordered results.
- `session_open` starts a persistent Python/Node kernel; `session_eval` evaluates source; `session_set` / `session_get` bridge values explicitly as JSON. Close it with `session_close`.
- A view document opts into kernel state with `会话 = > foreign.session kernels=... cells=...`; the table names are free. `view` consumes only the `会话` handle and never scans source lines or reserved table names. Without `会话`, cells are stateless one-shot runs; no kernel is created. Clearing outputs calls `/api/session/clear` and keeps persistent kernel state. There is no separate notebook CLI mode or command, and no new Markdown marker exists.
- The same source remains the authority; state crossing kernels is explicit, never implicitly mirrored.
## AI authoring workflow
1. Decide language surface (English builtins + `lib/text.mq.md`, or Chinese + `lib/文本.mq.md`).
2. Write `.mq.md` with `# main`, blank lines around prose, correct markers.
3. Run: `marqdo run path/to/file.mq.md` (cwd = project root so `lib/` resolves).
4. On `path:line:col: message`, fix that span; re-run until exit 0.
5. Optional: `marqdo view .` / `marqdo debug .` for structure and breakpoints.
## Anti-patterns (common model mistakes)
| Wrong | Right |
|-------|-------|
| `**Hello**` to print | `> print text=Hello` |
| `# main` then prose then code with no blank line | Blank line before code |
| `if x > 0:` | `1. `x` > 0` |
| `* > print text=hi *` | `> print text=hi` |
| `` *`a` = 1 * `` (trailing space + backticks) | `**a = 1**` — bare bind, no trailing space before `*` / `**` |
| `*xs = > text.split value=a,b sep=,*` (italic is return, and bare text args) | `**xs = > text.split value="a,b" sep=","**` — statement; quote text literals |
| Forgetting empty return after nested `##` helper when outer continues | Add `*None*` / `**` / `****` (not `---`) |
| Import `lib/text` then call bare `split` | `> text.split …` (qualified) |
| Import `lib/text` then call `拆分` | Match file language (`text.split`, not 文本) |
| `json.set` / `json.append` to build maps or lists | GFM tables; sparse `table.put`; named helpers (`browser.*`, `web.*`) |
| `json.set` / `compose_*` page parts | `type: web` Document + View table / `web.render` / `web.serve` |
| Import `json` for every browser handler | `import browser:lib/browser.mq.md` + tables ([marqdo-dev](../marqdo-dev/SKILL.md)) |
| Mix `web.page` and `网页.页面` in one file | One import language per `.mq.md` |
| Call `host_web_*` from `ext/web` | Use `# app` / `# db` methods; plugin ABI only |
| Call `host_*` from `ext/quantum` | Use `# circuit` / `# density` methods; plugin ABI only |
| Bare `kind=hinton` inside `*…*` | `kind="hinton"` — quote text literals |
| Bare `theme=dark` inside `*…*` | `theme="dark"` — quote; ZH `主题="dark"` |
| Rebuild plugin but skip `ext add` | `cargo build -p marqdo_plugin_quantum` then `marqdo ext add quantum` (or set `MARQDO_QUANTUM_PLUGIN`) |
## Checklist before finishing
- [ ] File ends with `.mq.md`
- [ ] Print via `print` / `打印`, not bold
- [ ] Blank lines separate comment paragraphs from code
- [ ] `# main` exists when the file is an entry program
- [ ] Nested side-effect helpers ended with `*None*` / `**` / `****` when the outer function continues
- [ ] Imports and call names share the same language file
- [ ] Data shaped as **GFM tables** (or short helpers) — no `json.set` / `json.append` glue
- [ ] Web sites: tables + web classes only (no JSON glue); `data/` gitignored
- [ ] Browser client: `lib/browser` + tables when returning effects
- [ ] Quantum draw: quote `kind=` / `theme=`; rebuild plugin → `ext add quantum` before view
- [ ] `marqdo run` succeeds (or errors addressed)
| `- [intent](for items as item)` | Explicit traversal |
| `1.` / `2.` | Branches; numbered * is else |
| GFM table | Data: one column list, one row record, @ row records |
Read [the executable programming guide](../../../doc/library-development.mq.md)
before authoring. Its actual callable examples demonstrate inline computation,
structured results, defaults and recoverable native file reads. Use
[the development entry](../../../skills/marqdo-dev/index.mq.md) and its file tools for source
work, and [the release entry](../../../skills/marqdo-release/index.mq.md) for an authorized
release. These mq.md files are the working instructions and tools; do not rebuild
a parallel command playbook in SKILL.md.
Call the actual file and heading with `marqdo call`. In a source checkout use
the built `target/debug/marqdo`; prepare its engineering plugin through the
development entry. Large structured inputs use --args-json FILE or stdin;
JSON strings stay literal during call-session replay. --require-ok makes failed
Results stop external automation while preserving their returned evidence.
Read each function's parameter/return tables and effect contract before calling.
Author programs as readable explanations: useful narrative exceeds half of
each callable unit; parameter and return tables immediately follow its heading;
inline assignments, actions and returns explain their purpose. Standard libraries
remain single-file handbooks. Multi-file projects and extensions use index.mq.md.
GFM describes data, public helpers describe operations, and components recursively
split web layouts until their content leaves are ordinary Markdown.
Native Marqdo capabilities handle file reading/writing, tables, parsing, hashing
and network reads. Add an extension for a reusable capability gap or call an
explicit existing external tool with argument arrays. Keep decisions, retries
and the execution flow in mq.md. Do not generate Python or shell programs for
already available native operations. OS processes and plugins retain their OS
authority; an fs-root does not sandbox their own access.
Use the current [web entry](../../../ext/web/index.mq.md) for Document, Endpoint and
Resource artifacts, or [quantum entry](../../../ext/quantum/index.mq.md) for circuit
workflows. Do not restore removed compose_* or app.configure APIs. Preserve
intentional fixtures and [classic migration context](migration-classic.md).
Validate the real calls and error paths; a narrative ratio or uploaded asset
alone is never functional evidence.
+2 -327
View File
@@ -1,328 +1,3 @@
# Marqdo examples (AI)
# Marqdo executable examples
## 1. Hello (English)
```markdown
# main
> print text=Hello World!
```
## 2. Hello (Chinese builtins)
```markdown
# main
> 打印 内容=你好,世界!
```
## 3. Function + named call + body end
```markdown
# main
Greeting via a nested function:
> greet who=Marqdo
## greet
+ `who`
> print text=Hello, `who`!
---
```
## 4. Bindings and return
```markdown
# main
*a = 2*
*b = > add_one n=`a`*
> print text=`b`
## add_one
+ `n`
**n + 1**
```
## 5. Branch with else
```markdown
# main
*n = 0*
1. `n` > 0
> print text=positive
2. `n` < 0
> print text=negative
3. *
> print text=zero
```
## 6. Foreach loop
```markdown
# main
`篮子` =
| 果 |
|----|
| 苹果 |
- [果](篮子)
> print text=`果`
```
## 6b. Map table + footnote get
```markdown
# main
`分类` =
| 苹果 | 黄瓜 |
|------|------|
| 水果 | 蔬菜 |
*种 = 分类[^苹果]*
> print text=`种`
*第一 = 篮子[^1]*
```
One column → list; ≥2 columns + one data row → map; ≥2 columns + many rows → map of lists. Data cells are expressions (same as call-arg values): bare words, numbers, `` `var` ``, quoted strings; URLs and `gpt-4o-mini` stay text via path/hyphen folding. Footnotes: lists use 1-based digit indices; maps use key text (including digit keys like `[^00]`). Foreach on a map walks **keys**.
Row-oriented records (SQL-like): first header `@` / `行` / `row` → list of maps (marker column excluded):
```markdown
`订单` =
| 行 | 品名 | 数量 |
|----|------|------|
| 1 | 苹果 | 2 |
*名 = 订单[^1][^品名]*
```
## 6c. Browser effects — tables + lib/browser (not json.set)
```markdown
---
import:
browser: lib/browser.mq.md
---
# main
`wire` =
| @ | 选择器 | 事件 | 调用 |
|---|--------|------|------|
| 1 | "#bump" | click | bump |
**`wire`**
## bump
*`count` = count + 1*
*`label` = > str count*
**> browser.set_text sel="#count" text=label**
```
Do **not** build effect maps with `json.set` chains. See [marqdo-dev](../marqdo-dev/SKILL.md).
## 7. Import text stdlib
```markdown
---
title: split demo
import:
text: lib/text.mq.md
---
# main
*parts = > split value=a,b,c sep=,*
> print text=`parts`
```
## 8. Comment paragraphs (blank-line rule)
```markdown
# main
This whole paragraph is a comment, including lines that look like code:
*not_executed = 1*
> print text=also still comment
After a blank line, code runs:
> print text=this runs
```
## 9. Frontmatter import only
```markdown
---
description: loads math
import:
math: lib/math.mq.md
---
# main
*t = > num value=3.5*
> print text=`t`
```
## 10. Object handle + method
See `tests/structure/object-handle.mq.md` and `ext/llm.mq.md`: `# Type` constructs a map with `_type`; methods use `` > `obj`.method `` and read `self` / `自`.
## 10b. Object inheritance
```markdown
# Greeter
## hello
+ `who`
*msg = "Hello, `who`!"*
**msg**
# Loud = > Greeter
## hello
+ `who`
*msg = "HELLO, `who`!"*
**msg**
```
`_type` stays the most specific name (`Loud`). Methods walk the base chain; same-name `##` on the child overrides. **No implicit super** — if the child needs parent fields, call the parent explicitly:
```markdown
# Child = > Parent
+ `name`
*self = > Parent name=`name`*
*self = > json.set map=`self` key=extra value=1*
**self**
```
## 11. Agent layout (ABI)
```markdown
---
import:
agent: ext/agent.mq.md
---
# main
> load_native
*ws = > agent*
*n = > `ws`.ensure_layout*
> print text=`n`
```
Requires `MARQDO_AGENT_PLUGIN` pointing at the built `agent` shared library (see `doc/design/ext-agent.md`).
## 12. What not to emit
```markdown
# BAD — bold is return, not print
**Hello**
# BAD — Python control keywords
if x > 0:
print(x)
# BAD — wrapping a call in italics
*> print text=hi*
# BAD — old branch syntax (removed)
+ `x` > 0
# GOOD — ordered list arms
1. `x` > 0
> print text=pos
2. *
> print text=other
# GOOD — another independent branch (restart at 1.)
1. `y` > 0
> print text=y-pos
2. *
> print text=y-other
```
## 13. Dynamic site (Web Artifact, minimal)
`index.mq.md`:
```markdown
---
type: web
title: Hello
route: /
method: GET
---
# Hello
Executable document as a page.
```
`serve.mq.md`:
```markdown
---
import:
web: ext/web/web.mq.md
---
# main
> web.serve root="." host="127.0.0.1" port=8080
```
- Import `ext/web/web.mq.md` **or** `ext/web/网页.mq.md` — not both.
- Full Artifact blog: `examples/marqdo-blog/` (`pages/` · `api/` · `db/` · `data_source`).
- Design: `doc/design/ext-web-artifact.md` · ADR 0007. No `compose_*` / `configure`.
## 14. Quantum entanglement lab (ext/quantum Q7/Q8)
```markdown
---
import:
quantum: ext/quantum/circuit/index.mq.md
---
# main
`steps` =
| step | gate | qubits |
|------|------|--------|
| 1 | H | 0 |
| 2 | CX | 0,1 |
*qc = > quantum.circuit qubits=2 steps=`steps`*
*rho = > `qc`.density*
*red = > `rho`.partial_trace keep=0*
*sch = > `qc`.schmidt cut=1*
*_ = > `qc`.draw kind="circuit" theme="dark"*
*_ = > `qc`.draw kind="hinton"*
> print text=`red`
```
- Full lab: `examples/quantum-entanglement/`. Bell-only: `examples/quantum-bell/`.
- `theme="dark"|"light"|"bw"` (default dark) on `circuit` / `probs` / `bloch`. Quote `kind=` / `theme=`.
- After rebuilding the plugin: `marqdo ext add quantum` so view loads the new native lib.
Read [the maintained discovery note](../../../skills/marqdo/examples.md) and its actual mq.md source entries. The [programming guide](../../../doc/library-development.mq.md) is authoritative; source examples and real workflow tests stay together rather than being copied into SKILL reference fences.
@@ -0,0 +1,3 @@
# Classic migration
Read [the maintained migration context](../../../skills/marqdo/migration-classic.md) and [the executable programming guide](../../../doc/library-development.mq.md). Historical fixtures retain explicit classic markup; new code uses readable occlusion and access(collection, key).
+2 -190
View File
@@ -1,191 +1,3 @@
# Marqdo reference (AI)
# Marqdo executable reference
Load this when you need stdlib names, CLI, or edge cases. Core rules stay in [SKILL.md](SKILL.md).
## CLI
```text
marqdo --version
marqdo run FILE.mq.md
marqdo run FILE.mq.md --backend bytecode
marqdo view PATH # docs browser, default port 7429
marqdo debug PATH # debugger UI, default port 7430
marqdo catalog PATH -o .marqdo
marqdo ext list
marqdo ext add llm|agent|web|quantum
marqdo ext remove llm|agent|web|quantum
```
Diagnostics look like `path:line:col: message` (1-based line/col).
**v0.2 surface:** parameters `` + `name` ``; branches `` 1. `cond` `` / `` 2. * `` (same-indent restart at `1.` = **new** branch statement); loops `` - [item](coll) `` or `` - [`item`](`coll`) ``; identifiers in backticks (foreach header may omit ticks). See `doc/design/markdown-mapping.md`.
Stdlib search order for `lib/…` imports: `MARQDO_LIB`, `./lib`, directory of the `marqdo` executable (and a few parents). Prefer the **bundle zip** (`marqdo.exe` + `lib/`) over a bare exe.
官方扩展(`ext/…`,非 stdlib):`marqdo ext add` 装到 `MARQDO_EXT` 或 `~/.marqdo/ext`;导入仍写 `import llm:ext/llm.mq.md`。解析还含 cwd `ext/`、二进制旁 `ext/`。对象:`doc/design/objects.md`。Agent:`doc/design/ext-agent.md` · 安装器:`doc/design/ext-cli.md`。
## Builtins (no import)
| EN | ZH | Role |
|----|----|------|
| `print` | `打印` | stdout; arg `text` / `内容` |
| `input` | `输入` | one line; arg `prompt` / `提示` |
| `len` | `长度` | length; arg `value` / `值` |
| `str` | `文本` | to text; arg `value` / `值` |
| `int` | `整数` | to int; arg `value` / `值` |
Keywords (not variable names): `True`/`真`, `False`/`假`, `None`/`空`, `and`/`且`, `or`/`或`, `not`/`非`.
## Standard library files
Import one file; use **that** file’s function names.
| EN import | ZH import | Typical APIs (EN / ZH) |
|-----------|-----------|-------------------------|
| `lib/text.mq.md` | `lib/文本.mq.md` | text helpers / 去空白·拆分·拼接… |
| `lib/table.mq.md` | `lib/表.mq.md` | `put`/`改` + list/map(见 `doc/design/stdlib-table.md`) |
| `lib/browser.mq.md` | `lib/浏览器.mq.md` | WASM client effect helpers(GFM + `set_text`/`canvas`/…;见 marqdo-dev) |
| `lib/fs.mq.md` | `lib/文件.mq.md` | filesystem |
| `lib/sys.mq.md` | `lib/系统.mq.md` | process / cwd / load_dotenv |
| `lib/plugin.mq.md` | `lib/插件.mq.md` | load native ABI plugins (`doc/design/ext-abi.md`) |
| `lib/time.mq.md` | `lib/时间.mq.md` | time/format |
| `lib/net.mq.md` | `lib/网络.mq.md` | HTTP(S) helpers (+ optional headers) |
| `lib/json.mq.md` | (see design) | **parse / stringify / quote only** — not a dict builder |
| `lib/math.mq.md` | `lib/数学.mq.md` | num, trig, random, formula, plot |
| `lib/foreign.mq.md` | `lib/外联.mq.md` | run foreign fenced blocks |
| `ext/llm.mq.md` | `ext/大模型.mq.md` | `# llm` / `# 大模型` object + chat methods |
| `ext/agent.mq.md` | `ext/智能体.mq.md` | document-driven **step** / **plan** + OKF;示例 `examples/agent-pong` · `agent-okf-flywheel`;Wave B:[agent-framework-2026-09.md](../../doc/research/agent-framework-2026-09.md) |
| `ext/web/index.mq.md` · `web.mq.md` | `ext/web/网页/索引.mq.md` · `网页.mq.md` | dynamic sites — see **ext/web** section below |
| `ext/quantum/index.mq.md` + modules | `ext/quantum/量子/索引.mq.md` + modules | circuits + Q7 density/viz + Q8 themes — see **ext/quantum** below |
Open the imported `.mq.md` under `lib/` or `ext/` to see exact `##` / `#` names and parameters. Gold tests: `tests/lib/`, `tests/structure/`, `tests/ext/`.
## ext/web (Artifact sites · ADR 0007)
Install: `marqdo ext add web` (`网页`). Native: `bash scripts/build-web-plugin.sh`.
Layout practice: split home into nav/main/footer; split footer into brand/links,
then links into docs/community until content leaves are ordinary Markdown.
Use `component.markdown|wrap`, `layout.stack|columns`, and @ record lists.
A parent value holds child rows of the same five-column View schema.
Explicit `view: main` Documents assemble once at startup; `inspect root=...`
scans disk declarations. See the Web root handbook and reference layout site.
| EN import | ZH import | Surface |
|-----------|-----------|---------|
| `ext/web/web.mq.md` | `ext/web/网页.mq.md` | facade: `page` · `route` · `serve` · `render` · `inspect` · `use` |
| Kind | Metadata | Notes |
|------|----------|-------|
| Document | `type: web` / `类型: 网页` | `route` · `data_source` · `data_order` · `data_where` |
| Endpoint | `type: endpoint` / `类型: 端点` | `path` · `method` · `# main` handler · `request`/`response` |
| View | `|type|slot|value|attrs|style|` | `web.render nodes=` |
| Resource | `ext/data` · `ext/security` · `ext/net` | db/cache/storage · auth/rbac/oidc · websocket |
Do **not** use `compose_*` / `app.configure` / author `ensure_plugin`.
Example: `examples/marqdo-blog/`. Design: `doc/design/ext-web-artifact.md`. Historical matrix: `doc/design/web-net-capabilities.md`.
## ext/quantum (circuits + Q7/Q8)
Install: `marqdo ext add quantum` (`量子`). Native: `cargo build --release -p marqdo_plugin_quantum`, then re-run `ext add` so view picks up the new `.so`.
| EN import | ZH import | Core types |
|-----------|-----------|------------|
| `ext/quantum/circuit/index.mq.md` (etc.) | `ext/quantum/量子/电路/索引.mq.md` (etc.) | `# circuit` / `# 电路` · `# gate` / `# 门` · `# density` / `# 密度` + call tools |
| Area | EN APIs | Notes |
|------|---------|-------|
| Circuit | `h`/`cx`/…, `simulate`, `probabilities`, `run`, `draw`, `noise` | `steps=` GFM table; ≤12 qubits |
| Gate | `matrix`, `matches_matrix`, `draw` | named or `matrix=` custom unitary |
| Density (Q7) | `purity`, `partial_trace`, `eig`, `expect`, `draw` | ≤6 qubits for dense ρ |
| Free (Q7) | `kron`, `schmidt`, `fidelity` | top-level on import bind |
| Draw kinds | `circuit\|probs\|bloch\|hinton\|city\|density\|paulivec\|qsphere\|multibloch` | quote `kind="…"` |
| Themes (Q8) | `theme="dark"\|"light"\|"bw"` (ZH `主题=`) | default **dark**; circuit/probs/bloch themed; SVG `data-theme` |
Examples: `examples/quantum-bell/`, `examples/quantum-entanglement/`. Design: `doc/design/ext-quantum.md` · Q7: `doc/design/ext-quantum-q7.md` · Q8: `doc/design/ext-quantum-viz-style.md`.
## Formula + plot (math)
```markdown
---
import:
math: lib/math.mq.md
---
# main
`f` =
$$
x^2 - 2
$$
*_svg = > plot formula=`f` var=x min=-3 max=3*
```
Empty RHS assignment + following `$$…$$` binds a formula value. Narrative-only `$$` without binding is display, not assignment.
## Foreign (Python example)
```markdown
---
import:
foreign: lib/foreign.mq.md
---
# main
`hi` =
```python
print("hello-from-python")
```
```
Lines starting with `` ` `` can be code (binding). Keep a blank line before/after fences per comment rules.
## Function-end details
| Form | Effect |
|------|--------|
| Lone `---` or `***` (≥3 same chars) at function body top level | End function; no return value |
| `****` or empty bold | Return `None` and end body |
| `**expr**` | Return `expr`; does **not** by itself cut off later sibling statements — still use HR or shallower heading |
File-leading paired `---` is frontmatter only; body `---` is not frontmatter.
## Call arguments
- Named: `> greet who=World`
- Positional: `> greet World`
- Spaces in values: allowed in named forms as in docs (`who=marqdo user`)
- Inline call in statement: `` *`n` = > len value=`s`* ``
See `doc/design/call-arguments.md`.
## Identifiers
- Variables: `` `name` ``
- Comparisons: `==` `>` `<` `>=` `<=`
- Do not use keyword tokens as names
## Design docs (repo)
| Doc | Topic |
|-----|--------|
| `doc/design/markdown-mapping.md` | Syntax constitution |
| `doc/design/objects.md` | `#` objects / `##` methods |
| `doc/design/keywords.md` | Builtins / keywords |
| `doc/design/return-hr-and-code-surface.md` | Function end / surfaces |
| `doc/design/stdlib-i18n.md` | EN/ZH lib files |
| `doc/design/stdlib-modules.md` | L1 modules including plugin |
| `doc/design/ext-abi.md` | Native C ABI v1 |
| `doc/design/ext-llm.md` | `ext/llm` |
| `doc/design/ext-agent.md` | `ext/agent` agent **framework** (layout shipped; LLM orchestration roadmap) |
| `doc/design/ext-cli.md` | `marqdo ext list/add/remove` |
| `doc/design/ext-web.md` | `ext/web` dynamic sites (author API) |
| `doc/design/web-net-capabilities.md` | ext/web capability matrix (W0–W7 + P3) |
| `doc/design/ext-quantum.md` | `ext/quantum` circuits |
| `doc/design/ext-quantum-q7.md` | Q7 density linear algebra + advanced SVG |
| `doc/design/ext-quantum-viz-style.md` | Q8 themed SVG (`dark`/`light`/`bw`; circuit/probs/bloch) |
| `doc/design/view-debug.md` | view / debug hosts |
Read [the maintained discovery note](../../../skills/marqdo/reference.md) and its actual mq.md source entries. The [programming guide](../../../doc/library-development.mq.md) is authoritative; source examples and real workflow tests stay together rather than being copied into SKILL reference fences.
+3
View File
@@ -0,0 +1,3 @@
# Multipart protocol examples retain required CRLF bytes in every checkout.
examples/web-net-site/components/content/multipart.txt -text whitespace=cr-at-eol
examples/web-net-site-zh/components/content/multipart.txt -text whitespace=cr-at-eol
+64
View File
@@ -0,0 +1,64 @@
# Independent extension sources and native libraries; no CLI/PPA publication.
name: Extension Release
on:
push:
tags:
- "ext-v*"
permissions:
contents: write
jobs:
windows:
runs-on: windows-latest
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- uses: dtolnay/rust-toolchain@stable
- uses: actions/setup-go@v5
with:
go-version: "1.23.x"
- name: Install cgo toolchain
run: choco install mingw -y
- name: Build the handbook CLI and native capabilities
shell: bash
run: |
set -euo pipefail
export PATH="/c/ProgramData/mingw64/mingw64/bin:/c/ProgramData/chocolatey/lib/mingw/tools/install/mingw64/bin:$PATH"
cargo build --release -p marqdo -p marqdo_plugin_agent -p marqdo_plugin_quantum -p marqdo_plugin_linalg -p marqdo_plugin_llm -p marqdo_plugin_engineering
bash scripts/build-web-plugin.sh
- name: Build and validate the runner's exact pack bytes
shell: pwsh
run: ./target/release/marqdo.exe call skills/marqdo-release/packs.mq.md ci --effects plugin,fs.write,environment.read --fs-root . --require-ok --json
- name: Attach source and Windows native packs without replacement
shell: pwsh
run: ./target/release/marqdo.exe call skills/marqdo-release/packs.mq.md attach_ci --effects plugin,fs.read,environment.read --fs-root . --require-ok --json
linux:
runs-on: ubuntu-latest
needs: windows
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- uses: dtolnay/rust-toolchain@stable
- uses: actions/setup-go@v5
with:
go-version: "1.23.x"
- name: Install ZIP and cgo tools
run: sudo apt-get update && sudo apt-get install -y zip gcc libc6-dev
- name: Build the handbook CLI and native capabilities
run: |
set -euo pipefail
cargo build --release -p marqdo -p marqdo_plugin_agent -p marqdo_plugin_quantum -p marqdo_plugin_linalg -p marqdo_plugin_llm -p marqdo_plugin_engineering
bash scripts/build-web-plugin.sh
- name: Build and validate the runner's exact pack bytes
run: target/release/marqdo call skills/marqdo-release/packs.mq.md ci --effects plugin,fs.write,environment.read --fs-root . --require-ok --json
- name: Attach Linux native pack without replacement
run: target/release/marqdo call skills/marqdo-release/packs.mq.md attach_ci --effects plugin,fs.read,environment.read --fs-root . --require-ok --json
+6 -31
View File
@@ -38,7 +38,7 @@ jobs:
run: |
export PATH="/c/ProgramData/mingw64/mingw64/bin:/c/ProgramData/chocolatey/lib/mingw/tools/install/mingw64/bin:$PATH"
cargo build --release
cargo build --release -p marqdo_plugin_agent -p marqdo_plugin_quantum -p marqdo_plugin_linalg -p marqdo_plugin_llm
cargo build --release -p marqdo_plugin_agent -p marqdo_plugin_quantum -p marqdo_plugin_linalg -p marqdo_plugin_llm -p marqdo_plugin_engineering
bash ./scripts/build-web-plugin.sh
- name: Checkout extension sources (branch vscode-extension only)
@@ -88,6 +88,7 @@ jobs:
Copy-Item target/release/quantum.dll "$stageNative/native/quantum.dll"
Copy-Item target/release/linalg.dll "$stageNative/native/linalg.dll"
Copy-Item target/release/llm.dll "$stageNative/native/llm.dll"
Copy-Item target/release/engineering.dll "$stageNative/native/engineering.dll"
if (Test-Path "dist/$nativeZip") { Remove-Item "dist/$nativeZip" -Force }
Compress-Archive -Path "$stageNative/*" -DestinationPath "dist/$nativeZip" -Force
$stage = "dist/stage-bundle"
@@ -102,6 +103,7 @@ jobs:
Copy-Item target/release/quantum.dll "$stage/ext/native/quantum.dll"
Copy-Item target/release/linalg.dll "$stage/ext/native/linalg.dll"
Copy-Item target/release/llm.dll "$stage/ext/native/llm.dll"
Copy-Item target/release/engineering.dll "$stage/ext/native/engineering.dll"
if (Test-Path "dist/$zip") { Remove-Item "dist/$zip" -Force }
Compress-Archive -Path "$stage/*" -DestinationPath "dist/$zip" -Force
$stageLib = "dist/stage-stdlib"
@@ -122,34 +124,7 @@ jobs:
- name: Upload release assets
uses: softprops/action-gh-release@v2
with:
body: |
## Marqdo ${{ github.ref_name }}
### 亮点 / Highlights
- **2.6.0**:标准库与拓展库成为可执行手册;650 个公开标准库函数,标题下契约、叙述形参与句中调用。
- **2.6.0**: Executable library handbooks, 650 public standard-library functions, inline actions and source contracts.
- 文件/字节/集合/Result/文档/HTTP/任务/TOML/时区工程能力;Quantum 实验与 Web 递归 Markdown 布局。
- File, binary, collection, document and task workflows; executable Quantum experiments and recursive Web layouts.
- View 正文读动作,左右侧注看逻辑;空逻辑明确提示;知识区按输入、返回和依据组织。
- View keeps action text in prose, implementation in margin notes, and readable knowledge facts separate from execution.
- CLI · wasm · ext · VS Code extension: **2.6.0**. Core surface unchanged: **19 constructs**.
- Linux CLI and native plugin zips are required; see CHANGELOG for exact platform/effect boundaries.
### Downloads
| Asset | Contents |
|-------|----------|
| `marqdo-*-windows-msvc.exe` | CLI with **embedded** official stdlib |
| `marqdo-*-windows-msvc.zip` | `marqdo.exe` + `lib/` + `ext/`(含 native DLL) |
| `marqdo-*-native-*.zip` | 预编译 `web`/`agent`/`quantum`/`linalg`/`llm`(Windows DLL + **Linux .so 必出**) |
| `marqdo-*-unknown-linux-gnu.zip` | Linux CLI + `lib/` + `ext/` + native `.so` |
| `marqdo-*-stdlib.zip` | `lib/` only |
| `marqdo-*-ext.zip` | Official `ext/` L1 sources |
| `marqdo-*-source.zip` | Source snapshot (`git archive`) |
| `marqdo-*.vsix` | VS Code / Cursor extension |
| `marqdo-*-public.zip` | Static user docs site |
Extension workflow: [vscode-extension-commit.md](https://github.com/cflmy/marqdo/blob/main/doc/design/vscode-extension-commit.md)
body_path: doc/releases/${{ github.ref_name }}.md
files: |
dist/${{ env.EXE }}
dist/${{ env.ZIP }}
@@ -186,7 +161,7 @@ jobs:
run: |
set -euo pipefail
cargo build --release
cargo build --release -p marqdo_plugin_agent -p marqdo_plugin_quantum -p marqdo_plugin_linalg -p marqdo_plugin_llm
cargo build --release -p marqdo_plugin_agent -p marqdo_plugin_quantum -p marqdo_plugin_linalg -p marqdo_plugin_llm -p marqdo_plugin_engineering
bash ./scripts/build-web-plugin.sh
- name: Package Linux native zip + CLI bundle
@@ -195,7 +170,7 @@ jobs:
VER="${GITHUB_REF_NAME#v}"
TARGET="x86_64-unknown-linux-gnu"
mkdir -p dist/stage-native/native
for lib in libweb.so libagent.so libquantum.so liblinalg.so libllm.so; do
for lib in libweb.so libagent.so libquantum.so liblinalg.so libllm.so libengineering.so; do
src="target/release/${lib}"
if [[ ! -f "$src" && "$lib" == libweb.so ]]; then
src="plugins/web/build/libweb.so"
+19 -5
View File
@@ -42,11 +42,7 @@ spike/.pytest_cache/
*.pyc
# Built browser WASM (rebuild via crates/marqdo-wasm README)
/examples/browser-hello/marqdo_wasm.wasm
/examples/browser-hello/pkg/
/examples/web-client-site/static/marqdo_wasm.wasm
/examples/browser-app/marqdo_wasm.wasm
/examples/browser-media/marqdo_wasm.wasm
# Local sqlite / scratch
/data/
@@ -61,7 +57,6 @@ plugins/*/tmp/
/examples/web-net-site/data/
/examples/web-net-site-zh/data/
/examples/marqdo-blog/data/
/examples/anlian-mq/data/
# Quantum draw/SVG runtime outputs (sources & gold .mq.md stay tracked)
/tests/ext/quantum-*.svg
@@ -109,3 +104,22 @@ tests/ext/_sbx_cow/
tests/ext/_sbx_*/
examples/**/_example_sbx/
.secrets/
# Generated runtime resources for callable browser handbook examples
/examples/web-spa-app/static/marqdo_wasm.wasm
/examples/web-spa-app/static/marqdo-bridge.js
/examples/web-collab-doc/static/marqdo_wasm.wasm
/examples/web-collab-doc/static/marqdo-bridge.js
# Native browser runtime and compiled theme produced by the network-site handbook.
/examples/web-net-site/public/generated/
/examples/web-net-site-zh/public/generated/
# Generated literary-site theme resources (the declarative sources stay tracked).
/examples/web-site/public/generated/
/examples/web-site-zh/public/generated/
# Native browser-effects example generated resources.
/examples/browser-app/static/marqdo_wasm.wasm
/examples/browser-app/static/marqdo-bridge.js
/examples/browser-app/static/theme.css
+25
View File
@@ -2,12 +2,35 @@
## Unreleased
## v2.7.0 — 2026-11-10
### Highlights / 亮点
源码手册进入真实开发与用户站点:原生文件操作、可调用开发/发版流程、递归 View 站点及当前请求资源。CLI、WASM、拓展包与编辑器版本统一为 2.7.0。详见 [完整双语发布说明](doc/releases/v2.7.0.md)。
Executable source handbooks now drive actual development and user sites: native file operations, callable release tasks, recursive View Documents and current request resources. CLI, WASM, extension packs and editor version are 2.7.0.
**核心表面 Δ / Core surface Δ**:无增删,仍为 19 个核心构造;沿用既有 Markdown 标记与插件 ABI。
### Added
- Native development and release handbooks, bounded engineering plugin boundaries, literal CLI JSON file/stdin arguments and --require-ok failure propagation.
- 原生文档表读取与保留正文的修改;纯 head 资源,以及当前请求的数据查询、表单与会话导航资源。
- Both-language recursive user sites, source-aware route inspection, retained theme declarations and actual browser acceptance.
- Structured nested list/control records in the official bridge, documented in EN/ZH browser libraries and the callable browser-app.
### Fixed
- Occlusion receivers, nested and hyphenated-path calls, prose literal defaults and exact CLI argument/session replay semantics.
- 授权站点根下的文件/SQLite 定位;嵌套 Document 与 Endpoint 回调上下文;表单重试 CSRF、成功跳转、管理入口与片段选择。
- Browser duplicate-item deletion, literal content rendering, Back/Forward history and asynchronous outcome reporting.
### Changed
- SKILL discovery delegates to executable handbooks; ordinary file IO and orchestration use Marqdo instead of Python release scripts.
- 中英文用户站点保留原始主题、当前文章与管理能力;移除无关的暗恋工程和过时独立浏览器演示,保留底层测试夹具。
- Native packs include the engineering plugin. Main excludes editor sources; immutable tags, both-platform builds and independent GitHub/CDN/Ubuntu verification remain release obligations.
## v2.6.0 — 2026-11-08
### Highlights / 亮点
@@ -1161,6 +1184,8 @@ marqdo run tests/markup-v03/inc-prose.mq.md
### Highlights
历史说明(2026-11-10):本节的 anlian-mq 是当时发布内容记录,现已移出仓库,旧启动命令不适用于当前工作树。当前完整站点见 examples/web-site 与 examples/web-site-zh。
**Go `libweb` 默认落地(W-G0–W-G14)**:官方网页原生插件改为 Go C ABI;CLI / gold / Release 走 `scripts/build-web-plugin.sh`;Rust 源码归档。另附 **anlian-mq** 验收站与表单插槽 / `MARQDO_EXT` 提示修复。
```bash
Generated
+19 -2
View File
@@ -615,7 +615,7 @@ checksum = "0ceec5bc11778974d1bcb055b18002eba7f4b3518b6a0081b3af5f21666da9ad"
[[package]]
name = "marqdo"
version = "2.6.0"
version = "2.7.0"
dependencies = [
"anyhow",
"assert_cmd",
@@ -656,7 +656,7 @@ dependencies = [
[[package]]
name = "marqdo-wasm"
version = "2.6.0"
version = "2.7.0"
dependencies = [
"marqdo",
"serde_json",
@@ -679,6 +679,23 @@ dependencies = [
"serde_json",
]
[[package]]
name = "marqdo_plugin_engineering"
version = "0.1.0"
dependencies = [
"base64",
"chrono",
"flate2",
"hmac",
"libc",
"marqdo",
"marqdo-plugin-sdk",
"serde_json",
"sha2",
"ureq",
"zip",
]
[[package]]
name = "marqdo_plugin_linalg"
version = "0.1.0"
+2 -1
View File
@@ -1,6 +1,6 @@
[package]
name = "marqdo"
version = "2.6.0"
version = "2.7.0"
edition = "2021"
license = "Apache-2.0"
description = "Marqdo — Markdown markers as an interpreted programming language"
@@ -60,6 +60,7 @@ getrandom = { version = "=0.2.17", default-features = false, features = ["custom
[workspace]
members = [
"plugins/demo",
"plugins/engineering",
"plugins/agent",
"plugins/llm",
"plugins/quantum",
+10 -9
View File
@@ -288,11 +288,12 @@ marqdo catalog public -o .marqdo
---
## 现状(v2.6.0)
## 现状(v2.7.0)
- **实际工程与可执行 SKILL(v2.7.0)**:中英文用户站点使用递归 View、普通 Markdown、当前数据/表单/会话资源并保留原始主题。开发与发版手册通过 `marqdo call` 执行,固有文件能力负责读写,工程插件承接进程、认证与格式边界。旧独立浏览器演示已收敛到实际可运行的工程;详见 [2.7.0 发布说明](doc/releases/v2.7.0.md)。
- **标准库与拓展库手册(v2.6.0)**:61 份公开标准库、650 个函数;源码内参数/返回契约、叙述形参、句中遮蔽调用与真实工程。新增文件/字节/集合/Result/文档/HTTP/任务/TOML/时区工作流;多文件拓展库以 index 组织。
- **View 可读动作与知识(v2.6.0)**:正文读动作,侧注看实现,运行标注看实际结果;空逻辑明确提示待补。知识说明先看输入、返回、依赖和依据,技术身份按需展开。
- **Quantum / Web 工程实践(v2.6.0)**:可执行实验、会话句柄与双语门面;网页先递归拆布局,直到叶子可以直接用 Markdown 表达。CLI · wasm · ext · VS Code 扩展同步 **2.6.0**。
- **Quantum / Web 工程实践(v2.6.0)**:可执行实验、会话句柄与双语门面;网页先递归拆布局,直到叶子可以直接用 Markdown 表达。CLI · wasm · ext · VS Code 扩展同步 **2.7.0**。
- **View 连线与工具栏(v2.5.1)**:真实源码锚点、连续 S 形曲线、错落标注与连线避让;底部工具栏增加文字标签。深浅色配色保持一致。CLI · wasm · ext 同步 **2.5.1**。
@@ -333,7 +334,7 @@ marqdo catalog public -o .marqdo
- **`marqdo version --check`**:与 GitHub 最新 release 对比
- 标准库:**内置于二进制**(v0.1.2+);磁盘 `lib/` 或 `MARQDO_LIB` 可覆盖。模块含文本、表、**浏览器效应**、文件、系统、时间、JSON、网络、数学、外联、插件、**自写回**、**子任务**;**中层 Mid M1–M6** + **Mid2 M7–M10**(datetime/url/toml/html/fs++/stats/log.fields 等,见 [stdlib-mid.md](doc/design/stdlib-mid.md) · [stdlib-mid2.md](doc/design/stdlib-mid2.md))
- **官方扩展库 `ext/`**(**非** stdlib,本版收口):
- **`web`**:**Artifact 模型(ADR [0007](doc/adr/0007-web-document-endpoint.md))** — `type: web|endpoint` Document/Endpoint;facade `page`/`route`/`serve`/`render`/`inspect`/`use`;Resource 在 `ext/data` · `ext/security` · `ext/net`;设计 [ext-web-artifact.md](doc/design/ext-web-artifact.md);原生 **Go `libweb`**([ADR 0004](doc/adr/0004-web-plugin-go.md));示例 [marqdo-blog](examples/marqdo-blog/) · [web-client-site](examples/web-client-site/) · [anlian-mq](examples/anlian-mq/)
- **`web`**:**Artifact 模型(ADR [0007](doc/adr/0007-web-document-endpoint.md))** — `type: web|endpoint` Document/Endpoint;facade `page`/`route`/`serve`/`render`/`inspect`/`use`;Resource 在 `ext/data` · `ext/security` · `ext/net`;设计 [ext-web-artifact.md](doc/design/ext-web-artifact.md);原生 **Go `libweb`**([ADR 0004](doc/adr/0004-web-plugin-go.md));示例 [marqdo-blog](examples/marqdo-blog/) · [web-client-site](examples/web-client-site/) · [完整站点](examples/web-site/) · [中文完整站点](examples/web-site-zh/)
- **`quantum`**:Q0–Q7 + Q8a/b 主题 SVG;示例 [quantum-entanglement](examples/quantum-entanglement/)
- **`linalg`**:L0–L6 + 公式文档面(中缀 / `declare` / 展示化简);示例 [linalg-transpose](examples/linalg-transpose/) · [linalg-svd](examples/linalg-svd/) · [linalg-least-squares](examples/linalg-least-squares/)
- **`agent`**:A1–A4 + **MCP Server/Client**(stdio + **Streamable HTTP**)+ Skill Compilation + Adaptive Routing + resume + **Engineering preflight**(`agent.preflight` / `eng_preflight`);宿主缺口见 [ext-hosting.md](doc/roadmap/ext-hosting.md) · [agent-framework-gaps-after-a4.md](doc/research/agent-framework-gaps-after-a4.md) · [engineering-knowledge.md](doc/design/engineering-knowledge.md)
@@ -342,10 +343,10 @@ marqdo catalog public -o .marqdo
- **原生插件 ABI**:[`include/marqdo_abi.h`](include/marqdo_abi.h) · [ext-abi.md](doc/design/ext-abi.md);`plugins/{demo,agent,web,quantum,linalg,llm}`(`web` 为 Go;其余为 Rust)
- **用户静态站**:`public/` → `view output` → CI 发布 [gh-pages](https://cflmy.github.io/marqdo/)
- **VS Code 扩展**:分支 **`vscode-extension`**(`main` 不跟踪源码;见 [vscode-extension-commit.md](doc/design/vscode-extension-commit.md));Release 附带 `.vsix`
- **浏览器 Marqdo(WASM)**:`marqdo wasm build` + 官方 bridge 自启(作者零业务 JS;桥内可含列表/路由/storage/ws/文件/Canvas/音频/Observer/拖放);`lib/browser` + GFM;`web.client_embed`;示例 [browser-hello](examples/browser-hello/) · [browser-app](examples/browser-app/) · [browser-media](examples/browser-media/) · [web-client-site](examples/web-client-site/)([ADR 0002](doc/adr/0002-browser-marqdo-wasm.md) · [D](doc/roadmap/browser-wasm-d.md) · [E](doc/roadmap/browser-wasm-e.md) · [F](doc/roadmap/browser-wasm-f.md))
- **浏览器 Marqdo(WASM)**:`marqdo wasm build` + 官方 bridge 自启(作者零业务 JS;桥内可含列表/路由/storage/ws/文件/Canvas/音频/Observer/拖放);`lib/browser` + GFM;`web.client_embed`;示例 [browser-app](examples/browser-app/) · [web-spa-app](examples/web-spa-app/) · [web-collab-doc](examples/web-collab-doc/)([ADR 0002](doc/adr/0002-browser-marqdo-wasm.md) · [D](doc/roadmap/browser-wasm-d.md) · [E](doc/roadmap/browser-wasm-e.md) · [F](doc/roadmap/browser-wasm-f.md))
- 选型:[ADR 0001 — Rust](doc/adr/0001-implementation-language.md) · [ADR 0002 — 浏览器 WASM](doc/adr/0002-browser-marqdo-wasm.md)(C0–C5 完结,见 [roadmap/browser-wasm.md](doc/roadmap/browser-wasm.md))· [ADR 0003 — 异步效应](doc/adr/0003-browser-async-effects.md)
### 如何使用最新 Marqdo(v2.6.0)
### 如何使用最新 Marqdo(v2.7.0)
**安装解释器(任选其一)**
@@ -360,7 +361,7 @@ marqdo catalog public -o .marqdo
```bash
# 1) 源码安装(跟 tag 或 main)
git clone https://github.com/cflmy/marqdo.git && cd marqdo
git checkout v2.6.0 # 或留在 main
git checkout v2.7.0 # 或留在 main
cargo build --release
export PATH="$PWD/target/release:$PATH"
marqdo version
@@ -393,15 +394,15 @@ marqdo ext add llm # 或:大模型(.mq.md + 可选 native llm)
# 4) 动态站示例(扩展装好后)
marqdo run examples/web-site-zh/index.mq.md # 表驱动引言 Demo
marqdo run examples/marqdo-blog/serve.mq.md
marqdo run examples/anlian-mq/index.mq.md # W-G14 验收站
marqdo call examples/web-site/index.mq.md serve --effects plugin,fs.write,network.write --fs-root examples/web-site --json
# 浏览器打开终端打印的 listen 地址;/favicon.ico 与 logo 装配见 W8
# 5) 浏览器 WASM(可选)
marqdo wasm build
# → dist/wasm/ … 见 examples/browser-hello/
# → dist/wasm/ … 实际工程见 examples/browser-app/
# 6) Releases:Windows exe/zip/vsix;Linux CLI zip + native `.so` zip
# https://github.com/cflmy/marqdo/releases/tag/v2.6.0
# https://github.com/cflmy/marqdo/releases/tag/v2.7.0
```
开发期也可用 `cargo run -- …` 代替已安装的 `marqdo`:
+1 -1
View File
@@ -1,6 +1,6 @@
[package]
name = "marqdo-wasm"
version = "2.6.0"
version = "2.7.0"
edition = "2021"
license = "Apache-2.0"
description = "Marqdo interpreter as WebAssembly (browser host bridge)"
+3 -1
View File
@@ -11,7 +11,7 @@ Raw `cdylib` exports — no `wasm-bindgen` CLI required.
```bash
# from repo root (C5 size profile)
marqdo wasm build -o examples/browser-hello
marqdo call skills/marqdo-dev/index.mq.md build_browser --effects plugin,process.exec,fs.write --fs-root . --json
# or:
cargo build -p marqdo-wasm --target wasm32-unknown-unknown --profile release-wasm
```
@@ -19,3 +19,5 @@ cargo build -p marqdo-wasm --target wasm32-unknown-unknown --profile release-was
Prints size in KiB; runs `wasm-opt -Oz` when Binaryen is on `PATH`.
See [doc/design/browser-marqdo-wasm.md](../../doc/design/browser-marqdo-wasm.md).
Use the maintained [browser-app](../../examples/browser-app/index.mq.md) for a runnable native Document and browser program. The ABI counter fixture lives in tests/wasm/counter.mq.md, with no independent HTML demo host. The former browser-hello and browser-media directories were retired in 2.7.0; their host capabilities remain documented in lib/browser.mq.md.
+43 -19
View File
@@ -228,28 +228,52 @@ function applyStyle(el, styleVal) {
}
export function renderListItems(spec) {
const tag = String(spec.tag || "li");
const rootTag = String(spec.tag || "li");
const items = Array.isArray(spec.items) ? spec.items : [];
return items
.map((it) => {
if (it == null) return "";
if (typeof it === "string" || typeof it === "number") {
return `<${tag}>${escapeHtml(String(it))}</${tag}>`;
}
if (!isPlainObject(it)) return "";
const text = it.text != null ? String(it.text) : it.html != null ? null : "";
const cls = it.class != null ? ` class="${escapeAttr(String(it.class))}"` : "";
let attrs = "";
if (isPlainObject(it.attrs)) {
for (const [k, v] of Object.entries(it.attrs)) {
if (v === null || v === false) continue;
attrs += ` ${escapeAttr(k)}="${escapeAttr(String(v))}"`;
let count = 0;
const render = (item, fallbackTag, depth) => {
if (depth > 32 || ++count > 10000) throw new Error("render_list: structural limit exceeded");
if (item == null) return "";
if (typeof item !== "string" && typeof item !== "number" && !isPlainObject(item)) return "";
const record = isPlainObject(item) ? item : { text: String(item) };
const tag = String(record.tag || fallbackTag);
if (!/^[a-z][a-z0-9-]*$/i.test(tag) ||
/^(script|style|iframe|object|embed|link|meta|base)$/i.test(tag)) {
throw new Error("render_list: unsupported element name");
}
let attrs = record.class != null ? ` class="${escapeAttr(String(record.class))}"` : "";
if (isPlainObject(record.attrs)) {
for (const [key, value] of Object.entries(record.attrs)) {
if (!/^[a-z_:][a-z0-9_.:-]*$/i.test(key) || /^on/i.test(key)) {
throw new Error("render_list: invalid attribute name");
}
if (value === null || value === false) continue;
if (!["string", "number", "boolean"].includes(typeof value)) throw new Error("render_list: attributes must be scalar");
if (/^(href|src|action|formaction)$/i.test(key) &&
/^[\s\u0000-\u0020]*(javascript|vbscript|data)[\s\u0000-\u0020]*:/i.test(String(value))) {
throw new Error("render_list: unsupported URL");
}
attrs += ` ${key}="${escapeAttr(String(value))}"`;
}
const inner = it.html != null ? String(it.html) : escapeHtml(text ?? "");
return `<${tag}${cls}${attrs}>${inner}</${tag}>`;
})
.join("");
}
let inner;
if (record.children != null) {
if (!Array.isArray(record.children) || record.text != null || record.html != null) {
throw new Error("render_list: children must be an unambiguous record list");
}
inner = record.children.map(child => render(child, "span", depth + 1)).join("");
} else {
// Preserve the existing explicit HTML escape hatch. Ordinary business
// values use text/children and never become source or markup.
inner = record.html != null ? String(record.html) : escapeHtml(String(record.text ?? ""));
}
if (/^(input|img|br|hr|area|col|source|wbr)$/i.test(tag)) {
if (inner) throw new Error("render_list: void elements cannot have content");
return `<${tag}${attrs}>`;
}
return `<${tag}${attrs}>${inner}</${tag}>`;
};
return items.map(item => render(item, rootTag, 0)).join("");
}
function escapeHtml(s) {
+13
View File
@@ -1,3 +1,16 @@
marqdo (2.7.0-1ppa2) noble; urgency=medium
* Repair engineering plugin compatibility for this 2.7.0 release.
* Keep the accepted upstream orig archive; carry the fix as a quilt patch.
-- Marqdo Maintainers <cflmy@users.noreply.github.com> Tue, 10 Nov 2026 17:53:03 +0800
marqdo (2.7.0-1ppa1) noble; urgency=medium
* Release 2.7.0; see the reviewed upstream CHANGELOG.
-- Marqdo Maintainers <cflmy@users.noreply.github.com> Tue, 10 Nov 2026 16:40:29 +0800
marqdo (2.6.0-1ppa1) noble; urgency=medium
* Executable standard/extension handbooks and practical file/data/task tools.
+18
View File
@@ -0,0 +1,18 @@
Description: Use stable Option map_or in the engineering release boundary
Author: Marqdo Maintainers <cflmy@users.noreply.github.com>
Forwarded: not-needed
Last-Update: 2026-11-10
diff --git a/plugins/engineering/src/lib.rs b/plugins/engineering/src/lib.rs
index 6891f01..f0c5ffc 100644
--- a/plugins/engineering/src/lib.rs
+++ b/plugins/engineering/src/lib.rs
@@ -283,7 +283,7 @@ fn r2_settings(root:&Path)->Result<BTreeMap<String,String>,String> {
}
}
for k in ["R2_ENDPOINT","R2_BUCKET","R2_ACCESS_KEY_ID","R2_SECRET_ACCESS_KEY"] {
- if settings.get(k).is_none_or(String::is_empty) {return Err(format!("missing {k}; configure ~/.marqdo/r2.env"));}
+ if settings.get(k).map_or(true, String::is_empty) {return Err(format!("missing {k}; configure ~/.marqdo/r2.env"));}
}
Ok(settings)
}
+1
View File
@@ -0,0 +1 @@
engineering-stable-option.patch
+1 -1
View File
@@ -80,7 +80,7 @@
| [design/ext-cdn.md](design/ext-cdn.md) | **扩展 CDN(R2 / ext.marqdo.com)与分开发版** |
| [design/ubuntu-ppa.md](design/ubuntu-ppa.md) | **Ubuntu PPA 打包与上传** |
| [design/ext-web.md](design/ext-web.md) | **官方扩展 `ext/web`(页面/库表/绑定/后台;ABI + CLI;设计锁定)** |
| [design/ext-web-go-rewrite.md](design/ext-web-go-rewrite.md) | **`plugins/web` Go 全量重写**(多语言 ABI · 网页制备完备 · anlian 验收) |
| [design/ext-web-go-rewrite.md](design/ext-web-go-rewrite.md) | **`plugins/web` Go 全量重写**(多语言 ABI · 网页制备完备 · 独立工作流验收) |
| [adr/0004-web-plugin-go.md](adr/0004-web-plugin-go.md) | **Accepted:web 原生插件实现语言为 Go** |
| [research/ext-web-customization-limits.md](research/ext-web-customization-limits.md) | **`ext/web` 定制限制踩坑盘点**(路由/壳 CSS/鉴权/样式/部署) |
| [design/ext-web-customization/](design/ext-web-customization/) | **对应解决设计**(C0–C4:前缀可让出、shell_css、gate、布局…) |
+2
View File
@@ -1,5 +1,7 @@
# ADR 0004:网络拓展库原生实现改为 Go
历史说明(2026-11-10):下文业务站点仅记录当时决策背景,相关工程已移出本仓库;当前验收使用维护中的完整站点、网络站点及隔离测试,见 [当前工作流](../design/ext-web-go-rewrite.md#8-独立工作流与隔离验收)。
| | |
|---|---|
| Status | **Accepted** |
+7 -4
View File
@@ -1,5 +1,8 @@
# 浏览器 Marqdo(WASM 解释器)设计
> 2.7.0 维护说明:独立的 browser-hello 与 browser-media 演示已删除。下文保留既有能力设计与宿主边界,当前可运行工程使用 browser-app;底层计数器冒烟夹具位于 tests/wasm/counter.mq.md。Canvas、音频等仍是 lib/browser 的宿主能力,不宣称当前 browser-app 演示包含这些交互。
| | |
|---|---|
| 状态 | **Accepted(设计锁定)** · 实现见路线图 C0–C5 |
@@ -124,7 +127,7 @@ source: &str (+ optional import map)
| `marqdo`(根) | 核心;feature-gate |
| `crates/marqdo-wasm` | `cdylib`:`mq_*` ABI + `js/marqdo-bridge.js` |
| `ext/web` 或 `web/browser` | L1:`浏览器.运行` / `交互装配`(C3+) |
| `examples/browser-hello/` | 静态页 + wasm 冒烟 |
| `examples/browser-app/` | 静态页 + wasm 冒烟 |
| `tests/browser/` 或金样脚本 | Node/wasmtime 跑 `run_source` 对齐 |
发行:`marqdo wasm build`(C2 CLI 糖)或 `wasm-pack build crates/marqdo-wasm`。
@@ -210,7 +213,7 @@ L1 `浏览器.交互装配`(ext)可后置;C3 以 bridge + 返回 wire 表
Bridge:`applyEffects(exports, value)` — 先 DOM,再调度异步;**不**在 WASM 内阻塞。
示例见 `examples/browser-hello/fetch.mq.md`。
示例见 `examples/browser-app/static/app.mq.md`。
---
@@ -251,7 +254,7 @@ marqdo wasm build -o static # marqdo_wasm.wasm + marqdo-bridge.js
# app.static dir=static
```
业务页再 `boot` 自己的 `.mq.md`(见 `examples/browser-hello/`)。
业务页再 `boot` 自己的 `.mq.md`(见 `examples/browser-app/`)。
---
@@ -261,7 +264,7 @@ marqdo wasm build -o static # marqdo_wasm.wasm + marqdo-bridge.js
|----|------|
| 单元 | `run_source("…# main\n> print…")` native 与 wasm 同测 |
| 金样子集 | `tests/structure/hello.mq.md` 等无 fs/net/plugin 的样例 |
| 浏览器冒烟 | `examples/browser-hello`:按钮点击 → Marqdo 函数 → 改 DOM 文本 |
| 浏览器冒烟 | `examples/browser-app`:按钮点击 → Marqdo 函数 → 改 DOM 文本 |
| 回归 | CI:`cargo test` native;另 job `wasm-pack build` / `cargo check --target wasm32-unknown-unknown --no-default-features --features wasm-core` |
---
+29 -54
View File
@@ -1,66 +1,41 @@
# Extension CDN (Cloudflare R2 → https://ext.marqdo.com)
# Extension CDN: native publication and byte parity
| | |
This page describes storage. The executable tasks are in [the release entry](../../skills/marqdo-release/index.mq.md), [assets.mq.md](../../skills/marqdo-release/assets.mq.md) and [asset_io.mq.md](../../skills/marqdo-release/asset_io.mq.md). Read the source contracts before calling them. Version, mode and publication authorization come from the user; inspecting an existing release grants no new remote write.
## Versioned packs
Extension versions come from ext/VERSION and can advance independently of the interpreter. An extension release uses its own ext-vX.Y.Z tag and three packs. A full release also includes the CLI, source, WASM and editor deliverables listed in model.mq.md.
| Object | Meaning |
|---|---|
| Status | **Accepted** — download prefer CDN; upload via `scripts/upload-ext-r2.py` |
| Date | 2026-09-17 |
| Related | [ext-cli.md](ext-cli.md) · [marqdo-release](../../.cursor/skills/marqdo-release/SKILL.md) |
| vX.Y.Z/marqdo-X.Y.Z-ext.zip | Readable extension sources |
| vX.Y.Z/marqdo-X.Y.Z-native-x86_64-pc-windows-msvc.zip | Windows plugins |
| vX.Y.Z/marqdo-X.Y.Z-native-x86_64-unknown-linux-gnu.zip | Linux plugins |
| vX.Y.Z/VERSION | Version echo for this pack set |
| latest/marqdo-X.Y.Z-*.zip | Identical current pack bytes |
| latest/VERSION | Recommended current extension version |
## Why
Public reads use https://ext.marqdo.com. [src/ext_cli.rs](../../src/ext_cli.rs) is authoritative for client override variables, version resolution and download fallback order. Ordinary installation does not need storage credentials.
CLI (语法解释器) and official **extension packs** (`ext/` L1 + native plugins) update on different cadences. Users behind unstable GitHub links should get packs from a stable object store first.
## Callable publication
## Public URL layout
After GitHub contains every required asset, download to dist/release-X.Y.Z. Validation checks names, GitHub size/SHA256, archive CRCs, versions and native capabilities. Source-declared plugins require matching libraries on both native platforms. Independently valid ZIPs cannot hide a missing DLL or shared library.
Bucket: `marqdo` · Custom domain: **https://ext.marqdo.com**
Run from the checkout root with the version already chosen by the user; use the actual full or ext mode:
```sh
marqdo call skills/marqdo-release/assets.mq.md download 'version="X.Y.Z"' 'mode="ext"' --require-ok --effects plugin,net,fs.write --fs-root . --json
marqdo call skills/marqdo-release/assets.mq.md publish 'version="X.Y.Z"' 'mode="ext"' --require-ok --effects plugin,net,fs.write --fs-root . --json
marqdo call skills/marqdo-release/index.mq.md finish 'version="X.Y.Z"' 'mode="ext"' --require-ok --effects plugin,net,fs.write --fs-root . --json
```
| Key | Meaning |
|-----|---------|
| `v{VER}/marqdo-{VER}-ext.zip` | L1 sources |
| `v{VER}/marqdo-{VER}-native-{triple}.zip` | Prebuilt plugins |
| `v{VER}/VERSION` | Pack SemVer echo |
| `latest/VERSION` | Recommended pack SemVer (plain text) |
| `latest/marqdo-…zip` | Same assets mirrored for convenience |
Publication rechecks all three packs and their combined capability matrix before the first PUT. All three versioned ZIPs and three latest ZIPs are written before either VERSION pointer. A failed ZIP stops the sequence. Historical versions are retained.
`{VER}` is the **extension pack** version (`ext/VERSION`), which **may differ** from CLI `Cargo.toml` version.
Finish reads both public pointers and compares downloaded versioned/latest bytes with GitHub SHA256 values. HTTP 200 or one sample URL is insufficient. Edge propagation may leave verification incomplete; repeat observation rather than rebuilding unrelated archives or claiming completion from an upload response.
## Client download order (`marqdo ext add`)
## Explicit boundaries
1. `MARQDO_EXT_DOWNLOAD_BASE` (optional override)
2. **CDN** `https://ext.marqdo.com/v{VER}/…` (override host with `MARQDO_EXT_CDN`)
3. GitHub Releases
4. `https://proxy.cflmy.top/github.com/…`
Filesystem operations, hashing, public HTTP downloads, release decisions and upload order are Marqdo code. The engineering extension supplies bounded ZIP inspection and private R2 Signature V4 transport. No Python uploader is part of this path; older standalone scripts remain compatibility utilities.
Pack SemVer resolution (`release_version()`):
The native boundary resolves credentials privately from existing stores or environment. Missing credentials fail explicitly. Never put access keys or secrets in tool parameters, source or reports. A plugin grant has normal OS authority; --fs-root does not sandbox native plugins or child processes.
1. `MARQDO_EXT_VERSION`
2. CDN `GET …/latest/VERSION` (short timeout)
3. Embedded `ext/VERSION` at build time
4. CLI `CARGO_PKG_VERSION`
## Separate ext release (no CLI bump)
1. Bump `ext/VERSION` (e.g. `1.0.3`) — leave root `Cargo.toml` alone if CLI unchanged.
2. Build native zips (CI Linux/Windows jobs or local `scripts/build-web-plugin.sh` + cargo plugins).
3. Package `marqdo-{VER}-ext.zip` and `marqdo-{VER}-native-*.zip`.
4. Upload **both**:
- R2: `python3 scripts/upload-ext-r2.py --version VER --from-dir dist/`
- GitHub: attach to a GitHub Release (tag `ext-vVER` **or** reuse latest CLI release assets)
5. Confirm `https://ext.marqdo.com/latest/VERSION` and a sample zip URL return 200.
## Full product release (CLI + ext)
Keep `ext/VERSION` equal to (or compatible with) CLI SemVer unless documenting a deliberate skew. CI still publishes GitHub assets; **after** CI green, run `upload-ext-r2.py` so CDN is populated (or add a CI step with R2 secrets).
## Credentials
| Where | What |
|-------|------|
| Local | `~/.marqdo/r2.env` (`chmod 600`) — see `.env.r2.example` |
| CI (optional) | GitHub Actions secrets: `R2_ACCESS_KEY_ID`, `R2_SECRET_ACCESS_KEY`, `R2_ENDPOINT`, `R2_BUCKET` |
**Never** commit Account API tokens or S3 secret keys. If a token was pasted into chat, **rotate** it in the Cloudflare dashboard.
## Object ACL
Custom domain public reads require the bucket/objects to be publicly readable (R2 public bucket / r2.dev / custom domain). Uploads use S3 API credentials; downloads by `ext add` are anonymous HTTPS GETs.
Isolated loopback tests use fake credentials to verify ZIP-before-VERSION ordering and failure stops. Read-only verification of the published 2.6.0 release has also exercised the actual GitHub/CDN parity path without republishing its assets.
+3 -1
View File
@@ -98,7 +98,9 @@ Welcome to the executable web.
| title | title | Marqdo | | title |
```
2026-11-08:View 已支持 row/column 容器与 markdown 叶子,容器值保持子表;显式 `view: main` Document 通过普通函数装配。完整工程见[布局实践](ext-web-layout-paradigm.md),实现边界见[优化说明](ext-web-handbook.md)。
2026-11-08:View 已支持 row/column 容器与 markdown 叶子,容器值保持子表;显式 `view: main` Document 通过普通函数装配。
2026-11-10:同一五列 View 可放置具型 Resource 节点;结构仍只在启动时装配,数据查询、已挂载表单与会话导航在请求期间解析。无新增 frontmatter 或核心标记;见 [请求资源](web-view-resources.md)。普通离线渲染缺少请求上下文时明确报错,不伪造动态内容。完整工程见[布局实践](ext-web-layout-paradigm.md),实现边界见[优化说明](ext-web-handbook.md)。
`page.render nodes=` 是**唯一**主装配路径。禁止 `compose_main` / `compose_intro` 等碎片 DSL。
+23 -26
View File
@@ -7,13 +7,15 @@
| 相关 | [ext-web.md](ext-web.md) · [ext-web-net.md](ext-web-net.md) · [web-net-capabilities.md](web-net-capabilities.md) · [ext-web-drivers.md](ext-web-drivers.md) · [web-assets-and-images.md](web-assets-and-images.md) · [ext-hosting-fill.md](ext-hosting-fill.md) · [ext-abi.md](ext-abi.md) · [ext-cli.md](ext-cli.md) · [web-asgi-servers-and-marqdo.md](web-asgi-servers-and-marqdo.md) |
| 实现目录 | `plugins/web/`(**Go module**;产物仍为 `libweb.so` / `web.dll` / `libweb.dylib`) |
| 作者面 | `ext/web/web.mq.md` · `ext/web/网页.mq.md`(**ABI 名与方法面保持兼容**;非另起一套 API) |
| 验收应用 | 工作区 `anlian`(暗恋见君):用 Marqdo 前后端脚本完整重写;**PostgreSQL + Redis 外接** |
| 当前验收 | 仓库内独立示例与临时夹具;完整站点、网络站点、浏览器与数据资源分别验证 |
本文件记录 Go 原生层重写时期的 ABI 与实施背景。2026-11-10 起不再以外部业务工程作为仓库交付项;当前作者规范与可调用入口以 [Web Artifact 设计](ext-web-artifact.md)、[网页手册](../../ext/web/index.mq.md)和[编程规范](../library-development.mq.md)为准。下方旧 compose/类链清单是历史对照,不能当作当前推荐 API。
---
## 0. 一句话
用 **Go** 重写官方网络拓展库原生层(`plugins/web`),在 **C ABI v2 全量兼容** 前提下提供「网页制备」所需的全部服务端能力;`ext/web` 继续用 GFM 表 + `#` 类做作者面;应用(含暗恋见君)的前后端脚本全部用 Marqdo 书写。此举同时验证 **多语言 ABI 插件生态**(首个非 Rust 官方插件)。
用 **Go** 重写官方网络拓展库原生层(`plugins/web`),在 **C ABI v2 全量兼容** 前提下提供「网页制备」所需的全部服务端能力;`ext/web` 继续用 GFM 表 + `#` 类做作者面;应用的前后端脚本全部用 Marqdo 书写。此举同时验证 **多语言 ABI 插件生态**(首个非 Rust 官方插件)。
**不是**最小 hello 插件;**不是**在旧 Rust 代码上打补丁(对齐 [ext-web.md](ext-web.md) **C5**)。
@@ -36,7 +38,7 @@
2. **作者面可用**:现有 `ext/web` 示例与 `tests/ext/web-*`(含 live-server)在换 Go `.so` 后通过;无需作者改业务脚本(除非文档标明的 **G 增强**)。
3. **网页制备完备**:单站点可完成页面装配、样式/头/图、库表、表单、路由、中间件、鉴权/RBAC、上传下载、SEO/RSS/sitemap、WS、缓存、对象存储、反代、invoke——即 W0–W8 + P3 + C0–C4 + H1/H2 能力面。
4. **驱动外接**:`postgres://`、`redis://`、`s3://` 为正式一等能力(与 [ext-web-drivers.md](ext-web-drivers.md) 一致);SQLite / memory / file 仍支持本地与测试。
5. **暗恋见君可写完**:用 Marqdo 后端脚本 + 浏览器 WASM 前端脚本重写 anlian 核心模块(见 §8);运行时仅依赖 `marqdo` + `libweb` + **外接 PostgreSQL + Redis**(可选 S3/RustFS)。
5. **通用工作流可验证**:使用仓库内独立站点和临时夹具覆盖数据、鉴权、表单与实时能力(见 §8);SQLite 提供本地验收,PostgreSQL、Redis 和对象存储按各自可用环境另行验证。
6. **安装路径不变**:`marqdo ext add web`、`plugin.native_path name=web`、`MARQDO_WEB_PLUGIN`、产物文件名 `libweb.so` 等与 [ext-cli.md](ext-cli.md) 兼容。
### 1.3 非目标
@@ -56,7 +58,7 @@
```text
┌──────────────────────────────────────────────────────────────────┐
│ 应用(anlian / 任意站点) │
│ 应用(独立业务站点) │
│ · 后端 .mq.md:路由、业务、装配、invoke 处理函数 │
│ · 前端 .mq.md:WASM + lib/browser(作者零业务 JS) │
└────────────────────────────┬─────────────────────────────────────┘
@@ -284,41 +286,36 @@ Where 语义:等值 map、filter 表、OR / IN / BETWEEN、分页 offset/limit
---
## 7. G 增强(完备网页制备 + anlian;兼容之上增量)
## 7. G 增强(完备网页制备;兼容之上增量)
> 以下为 **新增能力**,不替代 §5。作者面用新方法/新 configure 键;旧脚本不受影响。
| ID | 能力 | 动机 | 作者面草案 |
|----|------|------|------------|
| **G-WS1** | **命名房间** WS:`join`/`leave`/`publish`;组名 ASCII(如 `chat.room.{id}`) | anlian 公聊/私聊 | `app.route_ws` 增 `mode=room` + `room_key`;或 `ws.room_*` ABI |
| **G-WS1** | **命名房间** WS:`join`/`leave`/`publish`;组名 ASCII(如 `chat.room.{id}`) | 独立聊天室 | `app.route_ws` 增 `mode=room` + `room_key`;或 `ws.room_*` ABI |
| **G-WS2** | 房间消息钩子:先 `invoke`/落库再广播 | 「先写 PG 再推送」 | configure 或 route 表 `on_message=lib.member` |
| **G-SESS1** | Session 后端可选 `redis://` | 多进程/多实例 | `web_session_new` url 或 auth 配置 `session=redis://` |
| **G-CACHE1** | Redis pub/sub 可选作 WS 扇出后端 | 多进程 WS | `configure ws_backend=redis` |
| **G-API1** | Bearer API Key 校验原语(hash+pepper+scopes) | anlian `apikeys` | `web_api_key_check` + `# auth` 或独立小类;**业务 scopes 仍在 .mq.md** |
| **G-MAIL0** | (可选后续)SMTP 发送原语 | 邮箱验证码 | 不阻塞首版对等;列入 anlian 二期 |
| **G-API1** | Bearer API Key 校验原语(hash+pepper+scopes) | API 密钥资源 | `web_api_key_check` + `# auth` 或独立小类;**业务 scopes 仍在 .mq.md** |
| **G-MAIL0** | (可选后续)SMTP 发送原语 | 邮箱验证码 | 不阻塞首版对等;另列后续能力 |
**明确仍属应用层(不进插件)**:反垃圾策略、草稿定时发布约定、好友关系、专题 `topic_bundles` 静态交互内容(静态挂载 + 前端 Marqdo/既有 JS 资产)。
---
## 8. 暗恋见君验收矩阵(检测「能不能写完」)
## 8. 独立工作流与隔离验收
外部依赖(允许):**PostgreSQL**、**Redis**;可选对象存储。
仓库交付不依赖某个外部业务工程的源码或个人数据库。各能力保留在原生实现与领域资源中,通过维护中的独立示例验证;移出业务工程不构成删除通用功能的理由。
| 模块 | Marqdo 后端 | Marqdo 前端 | 插件依赖 | 验收 |
|------|-------------|-------------|----------|------|
| 站点壳 / 首页 | `# page` + db | 局部刷新可选 WASM | listen、static、cache | 首页可开 |
| posts 帖子/评论/板块 | route + form + db | 发帖表单 WASM 可选 | CRUD、CSRF、upload | CRUD+列表详情 |
| news | 同上 | 同上 | 同上 | 列表详情 |
| accounts | auth + session +(二期 mail) | 登录表单 | argon2、session、gate | 注册登录 |
| profiles | db + storage | 头像上传 | storage/upload | 资料页 |
| search | db.search 或 PG 查询 + cache | — | db/cache | 关键词搜索 |
| chat | route_ws + G-WS1/2 + db | WS 客户端脚本 | Redis + WS rooms | 公聊+私聊实时 |
| apikeys | G-API1 + db | 管理页 | — | Bearer 调 API |
| webmaster | sitemap/robots | — | 已有 ABI | `/sitemap.xml` |
| topics | `app.static` → bundles | 既有静态交互 | static | 专题可访问 |
| 工作流 | 当前来源 | 实际核对 |
|---|---|---|
| 完整动态站点 | examples/web-site、examples/web-site-zh | 原主题规则、摘要与详情、当前记录、表单重试、会话导航及后台门禁 |
| 网络资源 | examples/web-net-site、examples/web-net-site-zh | Cookie/multipart、WebSocket 回显、真实表单与后台 |
| 客户端状态 | examples/web-spa-app、examples/web-collab-doc | 当前 WASM、历史记录、编辑、多标签实时协作 |
| 数据与租户 | tests/example_databases.rs、tests/web_handbook.rs | 独占临时数据库、已有记录保留、租户条件 |
| 原生插件 | plugins/web 内部测试 | 独立夹具下验证数据库、会话、运输、资源及渲染边界 |
**「写完」定义**:上述模块在 Marqdo 仓库或 `anlian` 旁路目录有可运行 `.mq.md` 站点;gold/手工脚本能走通主路径;不依赖 Django/Channels/Daphne/gunicorn。
开发与验收由 skills/marqdo-dev/index.mq.md 编排,使用 marqdo call。完整示例的浏览器用例和 HTTP 用例不能替代 Postgres、Redis、OIDC 或外部服务的真实环境证据;未运行的边界仍需明确保留为未验证。
---
@@ -400,7 +397,7 @@ scripts/build-web-plugin.sh # go build -buildmode=c-shared -o …/libweb.so
| **W-G11** | 定制 C2–C4 shell/layout/style/nav | ✅ `web-c2`–`c4` |
| **W-G12** | G 增强 WS rooms + Redis session/pubsub + API key 原语 | ✅ 单测 + `web-g12-api-key-smoke` |
| **W-G13** | 默认切换 Go `libweb`;归档 Rust;更新发版与 ext CLI | ✅ 离线+live gold(7 个 `*_live`)对 Go 全绿;`ext add`/`gold`/`release` 走 `scripts/build-web-plugin.sh`;Rust 移出 workspace;gold 强制 `MARQDO_WEB_PLUGIN` 避免 `~/.marqdo` 旧 so |
| **W-G14** | anlian Marqdo 重写主路径(可分仓或 `examples/anlian-mq/`) | ✅ `examples/anlian-mq/`(本地 SQLite + 粉玻璃主题 + 主路由/登录/片段;外接 PG/Redis 仍为增强路径) |
| **W-G14** | 历史业务站点主路径演示 | 历史演示工程已移出仓库;当前独立验收见 §8 |
每波次:**先补 Go 实现 → 跑对应 gold → 再进入下一波**。禁止跨波次留下「注册了但返回 stub 错误」的 ABI(除 W-G0 明确的未实现探测)。
@@ -414,7 +411,7 @@ scripts/build-web-plugin.sh # go build -buildmode=c-shared -o …/libweb.so
| 金样例 | 现有 `tests/ext/web-*.mq.md`;构建脚本产出 `libweb.so` 后跑 |
| Live | 现有 `*-live-server.mq.md` + curl |
| 回归门禁 | CI:安装 Go → `scripts/build-web-plugin.sh` → `cargo test` 相关 web 项 |
| anlian | 独立 smoke:登录、发帖、WS 发言、API key |
| 独立站点 | 登录、表单、WebSocket 与 API 使用可控夹具分别验收 |
---
@@ -450,6 +447,6 @@ scripts/build-web-plugin.sh # go build -buildmode=c-shared -o …/libweb.so
1. **全量重写** `plugins/web` 为 Go,**不是**最小闭环。
2. **既有网络拓展能力(§5)重写后必须仍可用**;作者面默认兼容。
3. **PostgreSQL / Redis 外接** 为一等公民;Marqdo 承担应用前后端脚本。
4. **暗恋见君** 为完备性验收,不是缩小插件范围的借口。
4. 完备性通过独立工作流和原生测试验证,不以外部业务工程缩小插件能力范围。
5. **多语言 ABI 生态** 以本插件为样板(G7)。
6. 开发严格按 **§10 波次** 推进;本文件为唯一施工图。
+1 -1
View File
@@ -66,6 +66,6 @@ node tests/web/layout.browser.cjs /absolute/path/to/preview.html
它测量 1440px 下的外层与内层双栏、390px 下的两层纵向折叠,并检查无横向溢出。无需外部资源或业务 JavaScript。Go 单元测试覆盖递归 Markdown、顺序、带类型列式表、错误形状与 Document 显式执行边界。
既有 Anlian 渲染测试已从硬编码个人数据库改为临时目录建表并注入已知数据,使完整 Go 套件无需个人站点状态。
通用数据文档渲染测试已从硬编码个人数据库改为临时目录建表并注入已知数据,使完整 Go 套件无需个人站点状态。
Web 提交时,全库 Rust 为 436 通过、25 项既有策略/回放失败,基线失败集合相同。后续已单独修复 Rust→Lean 命令缺字段的问题:所有操作发送完整的 op、steps、value,进程错误保留退出码与 stderr。原 25 项失败全部消除,新增诊断回归后库级测试为 462 通过、0 失败。策略判定仍由 Lean 执行。
+35 -71
View File
@@ -1,85 +1,49 @@
# Ubuntu PPA packaging (Marqdo)
# Ubuntu PPA: executable packaging and publication
| | |
The maintained entry is [the release handbook](../../skills/marqdo-release/index.mq.md). [ubuntu.mq.md](../../skills/marqdo-release/ubuntu.mq.md) provides publication and observation tasks; [package.mq.md](../../skills/marqdo-release/package.mq.md) owns native metadata and staged file preparation. Their source contracts replace a separate command playbook.
The PPA is ppa:cflmy/marqdo. Apt installs the interpreter; extensions remain independently installed by marqdo ext add. Upload acceptance alone is incomplete: the exact source must be published, its amd64 build must succeed and apt must expose the same Debian version.
## Exact version and artifact
| Value | Meaning |
|---|---|
| Status | **Active** — `ppa:cflmy/marqdo`; noble builds need bundled Rust (Cargo.lock v4) |
| Maintainer | cflmy \<pingan@cflmy.cn\> |
| GPG | `505943294D04C803` (fingerprint `52A1…C803`) |
| PPA | `ppa:cflmy/marqdo` |
| X.Y.Z | Cargo package.version and the authorized upstream |
| 1ppaN | Reviewed debian/changelog packaging revision |
| ~SERIES | Explicit Ubuntu target, normally noble |
| marqdo_X.Y.Z-1ppaN~SERIES_source.changes | Exact signed source artifact |
| ext/VERSION | Independent extension-pack version |
## Goal
Native upstream and debian_version tasks parse the actual files. The latter retains the reviewed revision, removes its old series suffix and selects the current upstream/target series. A packaging-only reupload needs an explicit changelog revision edit. Upload selects the exact computed filename, never the newest unrelated package from a previous release or another series.
Users install with:
## Callable workflow
```bash
sudo add-apt-repository ppa:cflmy/marqdo
sudo apt update
sudo apt install marqdo
Run from the checkout root after the user has authorized this CLI/full release. Replace X.Y.Z with that version:
```sh
marqdo call skills/marqdo-release/ubuntu.mq.md ship 'version="X.Y.Z"' 'series="noble"' --require-ok --effects plugin,fs.read --fs-root . --json
marqdo call skills/marqdo-release/ubuntu.mq.md status 'version="X.Y.Z"' 'series="noble"' --require-ok --effects plugin,net --fs-root . --json
marqdo call skills/marqdo-release/index.mq.md finish 'version="X.Y.Z"' 'mode="full"' --require-ok --effects plugin,net,fs.write --fs-root . --json
```
CLI and extension packs stay independent: the `.deb` ships the **interpreter**; `marqdo ext add …` still pulls from **https://ext.marqdo.com** (then GitHub / proxy).
Status is observational: inspect complete as well as Result.ok. Finish turns incomplete publication into a failed Result, allowing --require-ok to stop automation while keeping evidence. A green GitHub run does not establish Launchpad completion or apt availability.
## Why bundled Rust?
## Native files and existing tools
Ubuntu **noble** ships cargo/rustc **1.75**, which cannot parse **Cargo.lock version 4** (`lock file version 4 requires -Znext-lockfile-bump`). Launchpad builders also have **no network**, so `ppa-build-source.sh` vendors crates **and** installs a modern toolchain into `third_party/rust` inside the `.orig.tar.xz`. `debian/rules` prefers that toolchain over distro cargo.
Marqdo reads version metadata and writes the staged Cargo configuration, Debian changelog and vendor-checksum repairs. Native filesystem, TOML and JSON functions carry the data. No generated Python reader or writer is used. Vendor repair removes backup entries that Debian cleaning would delete while retaining package digests and ordinary source hashes.
## One-time Launchpad setup
The existing Debian boundary uses Cargo vendor, tar/xz, the configured Rust installation, debuild, GPG and dput. The source archive includes vendored crates and the selected Rust toolchain for an offline build. Its script chooses a fixed default toolchain and exposes the existing override; it does not assume the build host compiler is sufficient.
1. Create PPA: https://launchpad.net/~cflmy/+activate-ppa → name e.g. `marqdo`
2. OpenPGP key already on Launchpad (done)
3. Sign Ubuntu Code of Conduct if Launchpad asks
4. Enable the Ubuntu **series** you upload for (e.g. noble) under PPA → Change details
5. On the build machine:
A new upstream may create an orig archive. Once Launchpad accepts that upstream, reuse the identical bytes and upload only the Debian revision. Never rebuild an accepted orig archive to work around a checksum rejection. A failed stage remains available for inspection.
```bash
sudo apt install build-essential debhelper devscripts dput lintian \
dpkg-dev quilt cargo rustc pkg-config curl xz-utils
```
## Recovery evidence
## Package layout
| Failure | Required action |
|---|---|
| sudo/GPG interaction unavailable | Complete the same concrete Debian boundary in the user's terminal, keeping version and series |
| Complete package version already used | Review and increment the Debian revision before another authorized upload |
| orig bytes differ | Retrieve and reuse the previously accepted archive |
| Offline vendor checksum failure | Inspect sanitize_vendor evidence and the retained staged tree |
| Source accepted, build pending/failed | Inspect the actual Launchpad build |
| Build green, apt metadata stale | Repeat apt observation for the exact version |
| File | Role |
|------|------|
| `debian/control` | Metadata (amd64; no distro cargo BD) |
| `debian/changelog` | Upload revisions (`1ppaN`) |
| `debian/rules` | `dh` + bundled/system cargo build |
| `scripts/ppa-build-source.sh` | Vendor + bundle Rust + `debuild -S` |
| `scripts/ppa-ship.sh` | apt deps + build + `dput` |
## Versioning
- Upstream SemVer: `Cargo.toml` / git tag `vX.Y.Z`
- Debian revision: `X.Y.Z-1ppaN~SERIES` (SERIES = `noble`, …) — bump `1ppaN` on packaging-only reuploads
- **Ext pack** SemVer (`ext/VERSION`) is **not** the deb version
## One-shot (recommended)
```bash
cd ~/work/marqdo
./scripts/ppa-ship.sh noble # tools → debuild -S → dput
./scripts/ppa-ship.sh noble -n # build only
```
If automation cannot enter sudo/GPG, tell the user these commands (do not invent alternatives):
```bash
./scripts/ppa-build-source.sh noble
dput ppa:cflmy/marqdo ../build-area/marqdo_*~noble_source.changes
```
Watch: https://launchpad.net/~cflmy/+archive/ubuntu/marqdo/+builds
## Failure notes
| Symptom | Fix |
|---------|-----|
| `lock file version 4 requires -Znext-lockfile-bump` | Rebuild with current `ppa-build-source.sh` (bundles Rust); bump `1ppaN` |
| `failed to calculate checksum of: …/vendor/…/Cargo.toml.orig` | `dh_clean` purged `*.orig`; fixed via `dh_clean -Xvendor/` (+ strip `.orig` only when **creating a new** orig); bump `1ppaN` with **`-sd`** |
| `orig.tar.xz already exists … different contents` | Never rewrite an uploaded upstream `.orig`; reuse PPA file (`ppa-build-source.sh` downloads it) and `debuild -S -sd` |
| Same version rejected by Launchpad | Bump `debian/changelog` (`1ppa2`, …) |
| Wrong series | Enable series on PPA; rebuild with that series name |
## Out of scope (v1 deb)
- Shipping `ext/native/*.so` inside the deb (use CDN `ext add`)
- WASM / VSIX / non-amd64
Public apt observation reads Packages.gz with native HTTP bytes and the bounded gzip boundary, then inspects actual package records. Isolated fixtures cover metadata selection, configuration writing and vendor-checksum preservation without uploading to a PPA.
+25
View File
@@ -0,0 +1,25 @@
# View 中的请求资源
状态:请求资源已实现,后续旧站点迁移继续进行。遵循 ADR 0007;沿用五列 View、普通表值与 Resource,不增加 Markdown 标记或 frontmatter 方言。
view: main 仍只在启动时执行一次。它返回的结构保留为 View 节点,服务器在每次请求准备会话、路由参数和 CSRF 后渲染。普通 Markdown、控件和布局没有额外业务执行;只有 type=resource 的节点把 value 中的已声明 Resource 交给对应原生处理器。
Resource 的职责明确分开:data_query 查询当前应用数据库;form_ref 引用显式挂载的表单;view_navigation 根据当前会话筛选导航。document_head 是纯文档资源,只贡献 SEO 与原生资源链接,不需要请求上下文。它们不接受任意页面属性,不恢复 compose_*、页面变异链或 app.configure。结构和文字继续递归拆成组件及 Markdown 叶子。
启动阶段检查节点和资源契约,不查询数据库、不提交表单。请求渲染失败保留真实诊断。离线纯渲染遇到查询、表单与会话导航时明确要求上下文,不伪造空列表、登录状态或表单提交成功。纯页头资源与普通内容可以直接预览。
数据查询使用原有数据库资源与条件格式,路由参数来自实际请求。表单通过原有系统路由处理,字段、规则和提交资源保持一致,并传递真实 CSRF 与返回地址。导航的可见性不能替代服务端鉴权。资源绑定和监听仍是独立步骤。
验收覆盖启动无数据查询、请求间新增数据可见、完整正文与摘要区分、动态路由条件、登录前后导航、表单校验与提交、CSRF、未知资源失败,以及原有静态布局和浏览器用例。
已完成的实际证据:web-net-site 与 web-net-site-zh 使用这些资源完整迁移;web_handbook 在两个启动后端中验证请求期间的数据更新、表单错误重试、工具页与后台鉴权。原生 Go 测试验证结构装配不查询缺失数据库、未知资源失败、路径条件不污染保留定义、CSRF 拒绝与错误重试。browser_handbook.mjs 使用当前 WASM 验证连续回显、Enter 与空输入、实际提交与管理后台、窄屏布局。
入口与边界:component.resource(中文组件为“请求资源”,保留原“资源”作为脚本/样式引用)、data/view.query、form.reference 与 form.mount、component.navigation。表单挂载可显式保护实际系统提交路径,不能只保护展示页面。服务器回调继承授予的文件根,所选站点根只能收窄该范围;嵌套页面按统一站点根读取共享叶子,Endpoint 同样保留该上下文。
片段沿用 /_part/{slot}:递归选择唯一具名区域,在当前请求上下文中解析其资源;不会把源码当作片段返回。未声明 main 槽时保留整组节点作为 main 的兼容回退,其他未知槽返回 404,重复槽保留歧义诊断。容器遍历与完整渲染共享同一类型表,不进入资源私有数据。
检视的 registered 范围复用真实监听的注册过程,捕获处理器路径但不执行处理器;不会初始化数据库、重置会话或调用页面。metadata 范围仅扫描文件声明与运行时模板。两者明确区分,不能把目录扫描当成资源绑定已经完成的证据。监听前使用同一注册校验,冲突以诊断返回。系统和声明清单均去重并稳定排序。
页头资源保留现有五列 View:组件只安放 `_type=document_head` 的具型值,原生渲染在离线和真实页面中收集到 head,不在正文或片段中渲染占位。它只有 meta 与 links 两个领域字段,不接受任意页面属性、HTML 壳或应用配置。元数据沿用 key/value 表与原生 SEO 行为,链接复用普通 Document 的资源表及双语字段。相同链接按完整定义去重,同名元数据冲突在启动前报错。元数据按键稳定输出,保证同一结构的预览与服务一致。URL 只允许站内绝对路径与 http(s),不读取或下载地址。charset、viewport、csrf-token 属于运行时,作者不能重声明。对应手册为 ext/web/head.mq.md 与 ext/web/页头.mq.md。
+22 -4
View File
@@ -1,6 +1,6 @@
---
markup: occlusion
title: 库开发指南:源码即手册,手册即 SKILL,函数即工具
title: Marqdo 编程规范:源码即手册,手册即 SKILL,函数即工具
description: 标准库与拓展库的叙述式开发规范,包含可以直接调用的真实示例。
import:
文件: lib/文件.mq.md
@@ -8,7 +8,7 @@ import:
库开发指南:让说明、调用和实现长在同一份源码里。
本文件供人和 AI 开发标准库、拓展库时直接阅读。目标是把库文件交给一个没有读过
本文件供人和 AI 编写 Marqdo 程序、标准库、拓展库以及可执行 SKILL 时直接阅读。目标是把库文件交给一个没有读过
完整语法手册的模型,它仍能判断何时使用、提供哪些输入、如何调用、如何消费结果,
以及遇到失败时怎么办。完成这些任务所需的信息必须在库文件中,不依赖聊天历史、
隐藏提示词、另一份签名清单或模型猜测。修改实现所需的最少标记也在本文就地示范。
@@ -65,6 +65,10 @@ ext/sample/
二、标题下面立即交代参数与返回。
普通网页正文、内容叶子与静态文档可以继续使用内容标题;它们没有调用契约,不能为了
满足函数格式而插入虚假的参数或返回值表。需要执行任务的 SKILL 应把操作写入 mq.md,
SKILL.md 只保留发现入口、适用范围和必要约束,避免两份独立维护的长命令清单。
每个真正可调用的函数使用函数标题。紧接标题先写参数表,再写返回表;没有参数时直接
放返回表。表格必须位于第一条执行语句之前。正文中的普通小节使用说明段和分隔线,
不要把“安装说明”“注意事项”等叙述标题误做成空函数。
@@ -142,6 +146,13 @@ ext/sample/
调用产生的值先计算并命名,再在单元格中引用,不能假定表格里任意一段函数文本会执行。
普通值用列表和记录传递;读取集合使用 access,不能把描述标签误当作集合键。
命令参数也作为数据写入表格:`"-p"`、`"--offline"` 等文本必须带引号;
裸写 `-p` 会被当成表达式而不是命令选项。已计算的路径使用反引号引用变量,
不要再拼接整段 shell 源码。需要同时被 call 与 View 使用的过程用普通函数标题,
例如 `## main`;`# main` 是对象入口,不能假定两者具有相同的调用语义。
整数除法会保留整数语义;计算平均值优先使用统计库的 mean,或明确采用浮点输入,
并在非整除样例中验证结果,避免演示数据恰好整除掩盖精度问题。
不可变更新要保存返回的新值。少量动态键用表库的具名助手;解析与序列化才使用 JSON。
不要用长串 json.set/json.append 来拼原本一张表就能读懂的数据,也不要为每个数字或
单个字段创建层层转发的空壳函数。只有当一段逻辑需要解释、复用或独立验证时才提取职责。
@@ -159,6 +170,13 @@ ext/sample/
六、把运行边界和工程验收写在开发者找得到的位置。
实际开发也使用这些能力:读取、搜索、撰写和原子修订通过固有文件库完成;JSON、表格、
散列和网络读取优先组合标准库。不要为已有能力再生成 Python 或 shell 程序。缺少能力时,
把可复用的边界补成拓展插件,或者通过明确参数数组外联已有工具;决策、条件和重试仍在
mq.md 中表达。开发与发版入口分别位于 skills/marqdo-dev 和 skills/marqdo-release,操作用
marqdo call 执行。大段源码通过 --args-json 文件或标准输入传输,保留换行、引号和字面数据。
外部自动化可以加 --require-ok,让失败 Result 产生非零退出码,避免继续执行依赖步骤。
有副作用的能力写明授权、根目录、平台、超时、资源上限以及重试与清理责任。
返回可恢复结果时先检查其中的 ok,再读取 value 或 error;CLI 外层的 ok 只说明调用
是否完成,不替代函数结果、HTTP 状态或子进程退出码的判断。未知副作用不能声称为纯函数。
@@ -177,8 +195,8 @@ ext/sample/
默认参数、结构化返回以及可恢复读取;修改库时还应运行该库本身相关的回归。
```sh
marqdo check doc/library-development.mq.md --narrative-ratio
cargo test --test stdlib_tasks library_development_guide_examples_match_their_contracts
marqdo call skills/marqdo-dev/index.mq.md check 'path="doc/library-development.mq.md"' --require-ok --effects plugin --fs-root . --json
marqdo call skills/marqdo-dev/index.mq.md test 'targets=["stdlib_tasks"]' 'filter="library_development_guide_examples_match_their_contracts"' --require-ok --effects plugin --fs-root . --json
```
现有能力可直接参考 [文件库](../lib/文件.mq.md)、[表库](../lib/表.mq.md)、
+48
View File
@@ -0,0 +1,48 @@
# Marqdo 2.7.0
本次 full 发布把源码手册落到实际开发与用户站点:文件操作、开发检查、构建与发版阶段可通过 marqdo call 执行;站点以递归组件、普通 Markdown 和明确的原生资源表达页面与行为。
This full release makes executable source handbooks practical for development and user sites. Native file tools and callable development/release tasks replace generated orchestration programs. Recursive View components preserve ordinary Markdown content and explicit runtime resources.
## 亮点 / Highlights
- 开发与发版 SKILL 路由到可执行 .mq.md 手册;文件读取、审阅、摘要校验和写入使用固有标准库。工程插件承担有界进程、私密认证、压缩格式和实际编译器检查边界,流程不依赖 Python 编排。
- Literal JSON file/stdin CLI arguments preserve quotes, newlines and dollar-prefixed text. --require-ok makes a failed Result stop external automation; saved call sessions retain literal argument semantics.
- 中英文网络站点与完整用户站点改为递归 View 布局、Markdown 内容、当前数据查询、表单、真实会话导航与鉴权资源。原有配色、字体、布局、文章详情和管理功能保留。
- Pure document_head resources carry SEO and resource links into the actual head. Request-time query/form/navigation resources preserve the existing five-column View schema, source context and explicit effect boundaries. Prepared-app inspection follows the real registrar without executing handlers.
- 原生 SQLite 初始化按实际站点授权根定位,保留已有业务记录;嵌套 Document 与 Endpoint 使用一致的站点根。修复表单校验重试中的 CSRF、成功跳转以及嵌套片段选择与路由检查。
- The browser bridge supports typed nested list/control records. The maintained browser-app demonstrates duplicate-safe identities, literal text, truthful storage/network feedback, real history and local WebSocket echo with no authored business JavaScript.
- 移除与语言仓库无关的暗恋工程及过时的独立浏览器演示;底层 WASM 冒烟夹具与公共回归保留。维护入口收敛到实际可运行的工程。
## 核心表面与兼容边界 / Core surface and boundaries
核心构造仍为 19 个,没有新增 Markdown 标记。改动集中在已有标记解析、CLI 参数传送、Runtime / Document 资源及工程工具;原生插件仍具有调用用户的操作系统权限,--fs-root 不把外部进程变成沙箱。显式 raw HTML 兼容出口不等同于不可信内容清理。编译检查与叙述比例检查不能单独证明运行或视觉正确。
The core surface remains 19 constructs. Native-only filesystem, process and authenticated service capabilities do not become browser WASM capabilities. Atomic file replacement is not a multi-file transaction, and digest preflight is not a kernel compare-and-swap. Deployment credentials remain in private stores.
## 下载 / Downloads
| 产物 / Asset | 内容 / Contents |
|---|---|
| marqdo-2.7.0-x86_64-pc-windows-msvc.exe | Windows CLI,内嵌标准库 / CLI with embedded standard library |
| marqdo-2.7.0-x86_64-pc-windows-msvc.zip | Windows CLI、标准库、拓展源码与原生插件 / complete Windows bundle |
| marqdo-2.7.0-x86_64-unknown-linux-gnu.zip | Linux CLI、标准库、拓展源码与原生插件 / complete Linux bundle |
| marqdo-2.7.0-stdlib.zip | 可读标准库源码 / readable standard-library sources |
| marqdo-2.7.0-ext.zip | 官方拓展库源码 / official extension sources |
| marqdo-2.7.0-native-x86_64-pc-windows-msvc.zip | Windows web、agent、quantum、linalg、llm、engineering 插件 |
| marqdo-2.7.0-native-x86_64-unknown-linux-gnu.zip | Linux web、agent、quantum、linalg、llm、engineering 插件 |
| marqdo-2.7.0-source.zip | 本标签的源码快照 / tagged source snapshot |
| marqdo-2.7.0.vsix | VS Code / Cursor 扩展,源码独立分支 / separate editor-source branch |
| marqdo-2.7.0-public.zip | 由实际 .mq.md 导出的静态用户站点 / exported public documentation |
## 安装与使用 / Installation and use
下载对应平台的完整 ZIP,解压后使用其中的 CLI 与 lib/ext。已有 CLI 可通过 marqdo ext add 安装官方拓展;具体调用从标准库单文件或拓展库 index.mq.md 的参数与返回表开始。Linux 用户也可使用项目现有 Ubuntu noble PPA 安装路径;实际 apt 可用性以发布验证结果为准。
Download and unpack the matching platform bundle. Start from each standard-library source or extension index.mq.md. Development tools live in skills/marqdo-dev/index.mq.md; release tasks live in skills/marqdo-release/index.mq.md. A callable task preserves actual failures and grants only its declared effects. See README for the maintained install routes.
## 验证 / Validation
本地全量 Rust 验收为 1031 通过、0 失败、2 个原有模型实验忽略项;Go 网络插件完整测试通过。清理后重跑的 21 项 CLI/发版/WASM 测试以及 7 项真实浏览器用例通过,实际用户文档成功导出 102 页。源码审查单独检查标题下契约与超过一半的叙述;普通测试、人工夹具和历史兼容样例保留既有用途。
Windows and Linux release builds run in CI for this exact source tag. Final release verification separately checks those jobs, all artifact contents and hashes, GitHub/R2 byte parity and VERSION ordering, and Ubuntu source/build/apt publication. A local Linux test is not evidence of Windows execution or completed package publication. Public documentation export is packaged here; gh-pages deployment is separate.
+4 -1
View File
@@ -1,5 +1,8 @@
# 路线图:浏览器 Marqdo 路线 F(进阶宿主能力)
> 2.7.0 维护说明:独立的 browser-hello 与 browser-media 演示已删除。下文保留既有能力设计与宿主边界,当前可运行工程使用 browser-app;底层计数器冒烟夹具位于 tests/wasm/counter.mq.md。Canvas、音频等仍是 lib/browser 的宿主能力,不宣称当前 browser-app 演示包含这些交互。
| | |
|---|---|
| 状态 | **Completed**(F1–F5;F6 Service Worker 可选未做) |
@@ -23,4 +26,4 @@
| **F5** | drag/drop wire + `data-drag` / `drop_text` | **done** |
| **F6** | Service Worker / 离线缓存 | optional / skipped |
示例:[examples/browser-media/](../../examples/browser-media/) · 助手:`lib/browser.mq.md`。
示例:[examples/browser-app/](../../examples/browser-app/) · 助手:`lib/browser.mq.md`。
+4 -1
View File
@@ -1,5 +1,8 @@
# 路线图:浏览器 Marqdo(WASM)
> 2.7.0 维护说明:独立的 browser-hello 与 browser-media 演示已删除。下文保留既有能力设计与宿主边界,当前可运行工程使用 browser-app;底层计数器冒烟夹具位于 tests/wasm/counter.mq.md。Canvas、音频等仍是 lib/browser 的宿主能力,不宣称当前 browser-app 演示包含这些交互。
| | |
|---|---|
| 状态 | **Completed**(路线 C 首版功能完备;续作见 [browser-wasm-d.md](browser-wasm-d.md)) |
@@ -23,7 +26,7 @@
| ABI crate | `crates/marqdo-wasm` |
| 官方 bridge | `crates/marqdo-wasm/js/marqdo-bridge.js` |
| CLI | `marqdo wasm build -o DIR` |
| 示例 | `examples/browser-hello/` |
| 示例 | `examples/browser-app/` |
| 冒烟 | `tests/wasm/smoke.mjs` · `tests/wasm_smoke.rs` |
| L1 | `web.client_embed` / `网页.客户端挂载` |
+37 -29
View File
@@ -13,50 +13,58 @@ import:
# main
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | None; execute this page's documented steps in order and observe their output or stated effects |
This is an offline knowledge-reuse workflow, not a request to an external model. It loads the agent plugin, promotes the visible workbook for one exact goal and asks the same agent goal again. The expected hit comes from the promoted knowledge base. The dummy key only satisfies model setup; it is not a credential or evidence that a model call succeeded.
The example uses its own named files under .marqdo and replaces that example knowledge base on rerun. Grant the actual plugin and filesystem effects in a disposable example root. Promotion and execution are separate outcomes: inspect promoted first, then cache, match and the returned result. A hit marker alone does not prove that an unrelated new goal is safe to reuse.
OKF flywheel offline: promote → plan same goal → `cache=hit` (no live LLM required for the hit path).
**p = > plugin.native_path name="agent"**
We first **p = [Compute p](plugin.native_path(name="agent"))** for the next step.
1. `p`
> plugin.load path=`p`
We now **[Call plugin.load](> plugin.load path=`p`)**.
2. *
> print text=no-agent-plugin
> sys.exit code=1
We now **[Display this step's result](> print text="no-agent-plugin")**.
We now **[Call sys.exit](> sys.exit code=1)**.
> sys.env_set name="OPENAI_API_KEY" value="offline-okf-dummy"
**model = > llm.llm**
**tools = > json.parse text=[]**
**助手 = > agent.agent model=`model` tools=`tools` standing="offline okf flywheel"**
We now **[Call sys.env set](> sys.env_set name="OPENAI_API_KEY" value="offline-okf-dummy")**.
We first **model = [Compute model](llm.llm())** for the next step.
We first **tools = [Compute tools](json.parse(text="[]"))** for the next step.
We first **助手 = [Compute 助手](agent.agent(model=`model`, tools=`tools`, standing="offline okf flywheel"))** for the next step.
**kb = ".marqdo/agent-kb-example-flywheel"**
**wb = ".marqdo/agent-runs/example-pong-solid.mq.md"**
**goal = "Reply with exactly the word pong and nothing else."**
**body = "---\ntitle: okf pong\n---\n\n# main\n\n*msg = \"pong\"*\n\n**msg**\n"**
We first **kb = ".marqdo/agent-kb-example-flywheel"** for the next step.
We first **wb = ".marqdo/agent-runs/example-pong-solid.mq.md"** for the next step.
We first **goal = "Reply with exactly the word pong and nothing else."** for the next step.
We first **body = "---\ntitle: okf pong\n---\n\n# main\n\n*msg = \"pong\"*\n\n**msg**\n"** for the next step.
1. > fs.exists path=`kb`
> fs.remove path=`kb`
We now **[Call fs.remove](> fs.remove path=`kb`)**.
2. *
---
> fs.write_text path=`wb` text=`body`
We now **[Call fs.write text](> fs.write_text path=`wb` text=`body`)**.
**prom = > agent_kb_promote kb_dir=`kb` goal=`goal` workbook=`wb`**
**okp = > json.get value=`prom` key="promoted"**
We first **prom = [Compute prom](agent_kb_promote(kb_dir=`kb`, goal=`goal`, workbook=`wb`))** for the next step.
We first **okp = [Compute okp](json.get(value=`prom`, key="promoted"))** for the next step.
1. `okp`
> print text=promoted
We now **[Display this step's result](> print text="promoted")**.
2. *
> print text=promote-fail
> sys.exit code=1
We now **[Display this step's result](> print text="promote-fail")**.
We now **[Call sys.exit](> sys.exit code=1)**.
**out = > `助手`.plan goal=`goal` max_rounds=2 writeback=False kb_dir=`kb` explore_n=0 promote=False**
**cache = > json.get value=`out` key="cache"**
> print text=`cache`
**match = > json.get value=`out` key="match"**
> print text=`match`
**val = > json.get value=`out` key="result"**
> print text=`val`
We first **out = [Compute out](> `助手`.plan goal=`goal` max_rounds=2 writeback=False kb_dir=`kb` explore_n=0 promote=False)** for the next step.
We first **cache = [Compute cache](json.get(value=`out`, key="cache"))** for the next step.
We now **[Display this step's result](> print text=`cache`)**.
We first **match = [Compute match](json.get(value=`out`, key="match"))** for the next step.
We now **[Display this step's result](> print text=`match`)**.
We first **val = [Compute val](json.get(value=`out`, key="result"))** for the next step.
We now **[Display this step's result](> print text=`val`)**.
1. `cache` == "hit"
> print text=flywheel-ok
We now **[Display this step's result](> print text="flywheel-ok")**.
2. *
> print text=flywheel-miss
> sys.exit code=1
We now **[Display this step's result](> print text="flywheel-miss")**.
We now **[Call sys.exit](> sys.exit code=1)**.
+53 -41
View File
@@ -15,21 +15,33 @@ import:
## 获取时间
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | The value explicitly returned below; conditional returns follow the selected branch |
Return today's date string (tool visible in source to the model).
**u = > time.now_unix**
*> time.format unix=`u` pattern="%Y-%m-%d"*
We first **u = [Compute u](time.now_unix())** for the next step.
After these steps, return *time.format(unix=`u`, pattern="%Y-%m-%d")*.
# main
**p = > plugin.native_path name="agent"**
1. `p`
> plugin.load path=`p`
2. *
> print text=no-agent-plugin
> sys.exit code=1
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | None; execute this page's documented steps in order and observe their output or stated effects |
> llm.load_env path="../../.env"
This entry first verifies what the agent can read about its own call site. It assembles a step context and checks for the call-site section, source section and the actual time-tool name before considering an optional live step. The tool table points to the real local function; it is not an independently maintained tool description detached from the source.
Normal demonstration stops at context evidence and does not require a paid model response. AGENT_LIVE and an available key together opt into the separate live branch. Context markers establish prompt content, not the correctness of a future model answer. Keep the tool result and returned status visible when exercising that branch; never replace a missing credential with a fixed successful response.
We first **p = [Compute p](plugin.native_path(name="agent"))** for the next step.
1. `p`
We now **[Call plugin.load](> plugin.load path=`p`)**.
2. *
We now **[Display this step's result](> print text="no-agent-plugin")**.
We now **[Call sys.exit](> sys.exit code=1)**.
We now **[Call llm.load env](> llm.load_env path="../../.env")**.
`工具表` =
@@ -37,55 +49,55 @@ Return today's date string (tool visible in source to the model).
|------|
| 获取时间 |
**model = > llm.llm**
**助手 = > agent.agent model=`model` tools=`工具表` standing="You are a Marqdo agent. Prefer CALL:获取时间 when the task needs today's date."**
We first **model = [Compute model](llm.llm())** for the next step.
We first **助手 = [Compute 助手](agent.agent(model=`model`, tools=`工具表`, standing="You are a Marqdo agent. Prefer CALL:获取时间 when the task needs today's date."))** for the next step.
Assert constitution markers in the assembled prompt (call site before how-to-act):
**ctx = > agent.build_step_context agent=`助手` task="What is today's date? Use the tool in this runbook."**
We first **ctx = [Compute ctx](agent.build_step_context(agent=`助手`, task="What is today's date? Use the tool in this runbook."))** for the next step.
**parts = > split value=`ctx` sep="--- call site ---"**
**n = > len value=`parts`**
We first **parts = [Compute parts](split(value=`ctx`, sep="--- call site ---"))** for the next step.
We first **n = [Compute n](len(value=`parts`))** for the next step.
1. `n` > 1
> print text=call-site-ok
We now **[Display this step's result](> print text="call-site-ok")**.
2. *
> print text=call-site-missing
> sys.exit code=1
We now **[Display this step's result](> print text="call-site-missing")**.
We now **[Call sys.exit](> sys.exit code=1)**.
**parts2 = > split value=`ctx` sep="--- source (.mq.md) ---"**
**n2 = > len value=`parts2`**
We first **parts2 = [Compute parts2](split(value=`ctx`, sep="--- source (.mq.md) ---"))** for the next step.
We first **n2 = [Compute n2](len(value=`parts2`))** for the next step.
1. `n2` > 1
> print text=source-ok
We now **[Display this step's result](> print text="source-ok")**.
2. *
> print text=source-missing
> sys.exit code=1
We now **[Display this step's result](> print text="source-missing")**.
We now **[Call sys.exit](> sys.exit code=1)**.
**parts3 = > split value=`ctx` sep="获取时间"**
**n3 = > len value=`parts3`**
We first **parts3 = [Compute parts3](split(value=`ctx`, sep="获取时间"))** for the next step.
We first **n3 = [Compute n3](len(value=`parts3`))** for the next step.
1. `n3` > 1
> print text=tool-in-source-ok
We now **[Display this step's result](> print text="tool-in-source-ok")**.
2. *
> print text=tool-in-source-missing
> sys.exit code=1
We now **[Display this step's result](> print text="tool-in-source-missing")**.
We now **[Call sys.exit](> sys.exit code=1)**.
**site = > agent_call_site**
**fn = > json.get value=`site` key="function"**
> print text=`fn`
We first **site = [Compute site](agent_call_site())** for the next step.
We first **fn = [Compute fn](json.get(value=`site`, key="function"))** for the next step.
We now **[Display this step's result](> print text=`fn`)**.
Optional live step — set env AGENT_LIVE=1 and put keys in repo-root `.env`:
**live = > sys.env_get name="AGENT_LIVE"**
**key = > sys.env_get name="OPENAI_API_KEY"**
We first **live = [Compute live](sys.env_get(name="AGENT_LIVE"))** for the next step.
We first **key = [Compute key](sys.env_get(name="OPENAI_API_KEY"))** for the next step.
1. `live` == "1"
1. `key`
**out = > `助手`.step task="请调用获取时间工具,然后只回复日期字符串。" writeback=False**
**status = > json.get value=`out` key="status"**
> print text=`status`
**tool = > json.get value=`out` key="tool"**
> print text=`tool`
**result = > json.get value=`out` key="result"**
> print text=`result`
We first **out = [Compute out](> `助手`.step task="请调用获取时间工具,然后只回复日期字符串。" writeback=False)** for the next step.
We first **status = [Compute status](json.get(value=`out`, key="status"))** for the next step.
We now **[Display this step's result](> print text=`status`)**.
We first **tool = [Compute tool](json.get(value=`out`, key="tool"))** for the next step.
We now **[Display this step's result](> print text=`tool`)**.
We first **result = [Compute result](json.get(value=`out`, key="result"))** for the next step.
We now **[Display this step's result](> print text=`result`)**.
2. *
> print text=live-skipped-no-key
We now **[Display this step's result](> print text="live-skipped-no-key")**.
2. *
> print text=live-skipped
We now **[Display this step's result](> print text="live-skipped")**.
+33 -25
View File
@@ -10,52 +10,60 @@ import:
# main
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | None; execute this page's documented steps in order and observe their output or stated effects |
The two trials intentionally differ only in commit. First inspect a successful dry trial and verify that note.txt has not appeared in the host directory. Then run the committed trial, read the host file and compare its actual content. This separates an observed proposal from an observed filesystem change; neither ok alone nor a proposed path establishes that a commit happened.
Use a disposable filesystem root: the example replaces its named _example_sbx directory and leaves the committed evidence there for inspection. It does not promise to roll back a committed external effect. Read the returned profile as part of the trial evidence, and keep failures visible rather than manufacturing a success marker when the expected file is absent.
Short demo: write via `agent.trial`, prove the host is clean until commit.
**had = fs.exists path="_example_sbx"**
We first **had = [Compute had](fs.exists(path="_example_sbx"))** for the next step.
1. `had`
> fs.remove path="_example_sbx"
We now **[Call fs.remove](> fs.remove path="_example_sbx")**.
2. *
**_ = 0**
We first **_ = 0** for the next step.
> fs.make_dir path="_example_sbx"
We now **[Call fs.make dir](> fs.make_dir path="_example_sbx")**.
**dry = agent.trial root="_example_sbx" write_path="note.txt" text=sandbox-okf commit=False**
**dry_ok = [ok](access(dry, "ok"))**
**dry_committed = [committed](access(dry, "committed"))**
We first **dry = [Compute dry](agent.trial(root="_example_sbx", write_path="note.txt", text="sandbox-okf", commit=False))** for the next step.
We first **dry_ok = [ok](access(`dry`, "ok"))** for the next step.
We first **dry_committed = [committed](access(`dry`, "committed"))** for the next step.
1. `dry_ok`
1. not `dry_committed`
> print text=dry-ok
We now **[Display this step's result](> print text="dry-ok")**.
2. *
> print text=dry-bad-commit
We now **[Display this step's result](> print text="dry-bad-commit")**.
2. *
> print text=dry-fail
We now **[Display this step's result](> print text="dry-fail")**.
**leaked = fs.exists path="_example_sbx/note.txt"**
We first **leaked = [Compute leaked](fs.exists(path="_example_sbx/note.txt"))** for the next step.
1. `leaked`
> print text=host-leaked
We now **[Display this step's result](> print text="host-leaked")**.
2. *
> print text=host-clean
We now **[Display this step's result](> print text="host-clean")**.
**wet = agent.trial root="_example_sbx" write_path="note.txt" text=sandbox-okf commit=True**
**wet_ok = [ok](access(wet, "ok"))**
**wet_committed = [committed](access(wet, "committed"))**
We first **wet = [Compute wet](agent.trial(root="_example_sbx", write_path="note.txt", text="sandbox-okf", commit=True))** for the next step.
We first **wet_ok = [ok](access(`wet`, "ok"))** for the next step.
We first **wet_committed = [committed](access(`wet`, "committed"))** for the next step.
1. `wet_ok`
1. `wet_committed`
> print text=wet-ok
We now **[Display this step's result](> print text="wet-ok")**.
2. *
> print text=wet-no-commit
We now **[Display this step's result](> print text="wet-no-commit")**.
2. *
> print text=wet-fail
We now **[Display this step's result](> print text="wet-fail")**.
**body = fs.read_text path="_example_sbx/note.txt"**
We first **body = [Compute body](fs.read_text(path="_example_sbx/note.txt"))** for the next step.
1. `body` == "sandbox-okf"
> print text=proof-visible
We now **[Display this step's result](> print text="proof-visible")**.
2. *
> print text=proof-missing
We now **[Display this step's result](> print text="proof-missing")**.
**pname = [name](access([profile](access(wet, "profile")), "name"))**
We first **pname = [name](access([profile](access(`wet`, "profile")), "name"))** for the next step.
1. `pname` == "default"
> print text=profile-default
We now **[Display this step's result](> print text="profile-default")**.
2. *
> print text=profile-other
We now **[Display this step's result](> print text="profile-other")**.
-45
View File
@@ -1,45 +0,0 @@
# 暗恋见君 · Marqdo 重写
用 **Marqdo + `ext/web`(Go `libweb`)** 对齐 Django [anlian](../../../anlian/) 的主浏览路径与视觉:原站 CSS/JS、首页四段、列表/详情、发帖门禁、聊天室、专题、搜索入口、API 指南。
默认 **SQLite**(`data/anlian-mq.db`);生产可换 `postgres://` + Redis。
## 设计约定
| 做 | 不做 |
|----|------|
| GFM 表装配库表/种子/表单/门禁/头资源 | `json.set` 链拼页面 |
| 原站 `public/css|js|img` + DOM class 对齐 | 另起一套模板糊弄验收 |
| `页面.壳HTML` 挂 Django 级导航/页脚 | 业务写进 Go 插件 |
| 缺能力时改 `ext/web` / `libweb` | 在应用层堆不可读胶水 |
## 路径(对齐原站)
| 路径 | 能力 |
|------|------|
| `/` | Hero + 公告 + 新闻时间线 + 论坛板块栏/卡片 |
| `/post`、`/post/{slug}` | 帖子列表 / 详情 |
| `/news`、`/news/{slug}` | 新闻列表 / 详情 |
| `/post/public` | 发帖(需登录) |
| `/post/ten`、`/news/five` | 首页 AJAX 片段 |
| `/chat`、`/chat/lobby`、`/chat/casual` | 房间列表 + 公聊 WS |
| `/topics` | 专题书架 |
| `/search` | 搜索入口 |
| `/guide/automation-api` | API 指南 |
| `/accounts/login` | 粉玻璃登录 |
| `/sitemap.xml`、`/robots.txt` | 站长 |
## 运行
```bash
export PATH="$HOME/.local/go/bin:$PATH"
./scripts/build-web-plugin.sh
export MARQDO_WEB_PLUGIN=$PWD/plugins/web/build/libweb.so
rm -f examples/anlian-mq/data/anlian-mq.db* # 首次或改 schema 后
./target/debug/marqdo run examples/anlian-mq/index.mq.md
# → http://127.0.0.1:18180/
bash examples/anlian-mq/smoke.sh
```
默认账号:`admin` / `anlian`。
@@ -1,51 +0,0 @@
---
markup: occlusion
title: components/chrome
description: 暗恋见君壳层 — head 资源表、导航 HTML、页脚 HTML(对齐 Django base / site_footer)。
---
## 头资源
首页与浏览页共用的 CSS / JS 链接表(挂到 `页面.头装配`)。路径对齐 `public/` 静态树。
`头` =
| 关系 | 地址 | 推迟 |
|------|------|------|
| stylesheet | "/static/vendor/bootstrap-anlian.min.css" | |
| stylesheet | "/static/css/base.css" | |
| stylesheet | "/static/css/navbar_search.css" | |
| stylesheet | "/static/css/footer.css" | |
| stylesheet | "/static/css/icons.css" | |
| stylesheet | "/static/css/feed_common.css" | |
| stylesheet | "/static/css/feed_list.css" | |
| stylesheet | "/static/css/index.css" | |
| stylesheet | "/static/css/index/hero.css" | |
| stylesheet | "/static/css/index/notice.css" | |
| stylesheet | "/static/css/index/home_news_timeline.css" | |
| stylesheet | "/static/css/index/home_posts.css" | |
| stylesheet | "/static/css/anlian_forms.css" | |
| stylesheet | "/static/css/login.css" | |
| stylesheet | "/static/css/rich_content.css" | |
| stylesheet | "/static/css/detail_reading.css" | |
| stylesheet | "/static/css/search.css" | |
| stylesheet | "/static/css/chat.css" | |
| stylesheet | "/static/css/topic_index.css" | |
| script | "/static/vendor/bootstrap.bundle.min.js" | 真 |
| script | "/static/js/anlian_partial.js" | 真 |
| script | "/static/js/feed_board.js" | 真 |
| script | "/static/js/index.js" | 真 |
*`头`*
## 导航HTML
对齐 Django `front/base.html` 顶栏:品牌「暗恋见君论坛」、主导航、搜索、登录/退出(`nav-when-guest` / `nav-when-auth` 由 CSS/JS 切换)。
**"<nav class=\"navbar navbar-expand-lg navbar-dark bg-dark\"><div class=\"container-fluid navbar-shell\"><div class=\"navbar-start\"><div class=\"navbar-logo\"><img src=\"/static/img/logo.svg\" alt=\"logo\" width=\"30\" height=\"30\" decoding=\"async\"></div><a class=\"navbar-brand\" href=\"/\">暗恋见君论坛</a></div><button class=\"navbar-toggler\" type=\"button\" data-bs-toggle=\"collapse\" data-bs-target=\"#navbarNav\" aria-controls=\"navbarNav\" aria-expanded=\"false\" aria-label=\"Toggle navigation\"><span class=\"navbar-toggler-icon\"></span></button><div class=\"collapse navbar-collapse\" id=\"navbarNav\"><ul class=\"navbar-nav navbar-nav-main\"><li class=\"nav-item\"><a class=\"nav-link\" href=\"/\">首页</a></li><li class=\"nav-item\"><a class=\"nav-link\" href=\"/post\">帖子</a></li><li class=\"nav-item\"><a class=\"nav-link\" href=\"/news\">新闻</a></li><li class=\"nav-item\"><a class=\"nav-link\" href=\"/topics\">专题</a></li><li class=\"nav-item\"><a class=\"nav-link\" href=\"/chat\">聊天</a></li><li class=\"nav-item\"><a class=\"nav-link\" href=\"/post/public\">发帖</a></li></ul><div class=\"navbar-end\"><form class=\"navbar-search d-flex\" action=\"/search\" method=\"get\" role=\"search\"><input class=\"form-control\" type=\"search\" name=\"q\" placeholder=\"搜索帖子、新闻、用户\" aria-label=\"搜索\" maxlength=\"100\" autocomplete=\"off\"><button class=\"btn btn-search-submit\" type=\"submit\">搜索</button></form><ul class=\"navbar-nav navbar-auth\"><li class=\"nav-item nav-when-guest\"><a class=\"nav-link nav-link-auth\" href=\"/accounts/login\">登录</a></li><li class=\"nav-item nav-when-auth\"><a class=\"nav-link nav-link-btn\" href=\"/admin/logout\">退出</a></li></ul></div></div></div></nav>"**
## 页脚HTML
对齐 `site_footer`:站点列 + 作者列;标语、版权、API 指南、作者 cflmy。
**"<footer class=\"site-footer\"><div class=\"site-footer-inner\"><div class=\"footer-col footer-col-site\"><img src=\"/static/img/logo.svg\" alt=\"\" class=\"footer-site-logo\" width=\"40\" height=\"40\" loading=\"lazy\"><p class=\"footer-site-name\">暗恋见君论坛</p><p class=\"footer-site-tagline\">期待人们能够继续相信爱情</p><p class=\"footer-copy\">&copy; 2026 暗恋见君论坛</p><p class=\"footer-meta-sm footer-api-guide\"><a href=\"/guide/automation-api\" class=\"footer-guide-btn\" title=\"面向开发者的 API Key 与自动化对接说明\"><span class=\"anlian-icon anlian-icon--book\" aria-hidden=\"true\"><svg viewBox=\"0 0 24 24\" xmlns=\"http://www.w3.org/2000/svg\" focusable=\"false\" aria-hidden=\"true\"><path d=\"M6 2a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V4a2 2 0 0 0-2-2H6Zm0 2h5v7.5L8.5 10 6 11.5V4Zm7 0h5v16h-5V4Z\"/></svg></span> API 自动化指南</a></p></div><div class=\"footer-col footer-col-author\"><img src=\"/static/img/author_avatar-144.webp\" alt=\"\" class=\"footer-author-avatar\" width=\"72\" height=\"72\" loading=\"lazy\"><div class=\"footer-author-info\"><p class=\"footer-author-name\">cflmy</p><p class=\"footer-author-title\">站长</p></div></div></div></footer>"**
-99
View File
@@ -1,99 +0,0 @@
---
markup: occlusion
title: components/feed
description: 帖子列表 / 新闻时间线 / 板块栏 HTML 片段(对齐 Django feed 与 home 局部模板)。
import:
table: lib/table.mq.md
text: lib/text.mq.md
---
## 帖子列表HTML
+ `行`
给定帖子行记录列表,输出 `ul.home-posts-list` 标记(首页与列表页共用)。
**段 = None**
- [帖](遍历 行 为 帖)
**板 = [board](access(帖, "board"))**
**题 = [title](access(帖, "title"))**
**链 = [slug](access(帖, "slug"))**
**作 = [author](access(帖, "author"))**
**评 = [comments_count](access(帖, "comments_count"))**
**时 = [created_at](access(帖, "created_at"))**
1. not 作
**作 = "匿名"**
2. *
1. not 评
**评 = 0**
2. *
1. not 时
**时 = ""**
2. *
**一项 = "<li><article class=\"home-post-card feed-post-card\"><a href=\"/post/" + 链 + "\" class=\"home-post-card-link feed-post-card-link\"><span class=\"home-post-board feed-post-board\">" + 板 + "</span><div class=\"home-post-body feed-post-body\"><h3 class=\"home-post-title feed-post-title\">" + 题 + "</h3><div class=\"home-post-meta feed-post-meta\"><span class=\"home-post-meta-item feed-post-meta-item\"><span class=\"anlian-icon anlian-icon--user\" aria-hidden=\"true\"></span> " + 作 + "</span><span class=\"home-post-meta-item feed-post-meta-item\"><span class=\"anlian-icon anlian-icon--comment\" aria-hidden=\"true\"></span> " + 评 + "</span><time>" + 时 + "</time></div></div><span class=\"home-post-arrow feed-post-arrow\" aria-hidden=\"true\"><span class=\"anlian-icon anlian-icon--chevron-right\"></span></span></a></article></li>"**
**段 = > table.append list=段 item=一项**
1. 段
**内 = > text.str_join xs=段 sep=""**
*"<ul class=\"home-posts-list feed-posts-list\">" + 内 + "</ul>"*
2. *
*"<ul class=\"home-posts-list feed-posts-list\"><li class=\"home-posts-empty feed-empty\">暂无帖子,<a href=\"/post/public\">去发帖</a></li></ul>"*
## 新闻时间线HTML
+ `行`
给定新闻行记录列表,输出 `.news-timeline` 标记。
**段 = None**
- [讯](遍历 行 为 讯)
**题 = [title](access(讯, "title"))**
**链 = [slug](access(讯, "slug"))**
**板 = [board](access(讯, "board"))**
**时 = [created_at](access(讯, "created_at"))**
1. not 板
**板 = ""**
2. *
1. not 时
**时 = ""**
2. *
**一项 = "<li class=\"news-timeline-item\"><span class=\"news-timeline-node\" aria-hidden=\"true\"></span><article class=\"news-timeline-card\"><div class=\"news-timeline-meta\"><time class=\"news-timeline-date\">" + 时 + "</time><span class=\"news-timeline-board\">" + 板 + "</span></div><h3 class=\"news-timeline-title\"><a href=\"/news/" + 链 + "\" class=\"news-timeline-link\">" + 题 + "</a></h3></article></li>"**
**段 = > table.append list=段 item=一项**
1. 段
**内 = > text.str_join xs=段 sep=""**
*"<div class=\"news-timeline\"><div class=\"news-timeline-rail\" aria-hidden=\"true\"><span class=\"news-timeline-line\"></span><span class=\"news-timeline-arrow\" aria-hidden=\"true\"><span class=\"anlian-icon anlian-icon--chevron-right news-timeline-arrow-icon--right\"></span><span class=\"anlian-icon anlian-icon--chevron-down news-timeline-arrow-icon--down\"></span></span></div><ol class=\"news-timeline-items\">" + 内 + "</ol></div>"*
2. *
*"<div class=\"news-timeline\"><div class=\"news-timeline-rail\" aria-hidden=\"true\"><span class=\"news-timeline-line\"></span><span class=\"news-timeline-arrow\" aria-hidden=\"true\"></span></div><ol class=\"news-timeline-items\"><li class=\"news-timeline-item news-timeline-item-empty\"><article class=\"news-timeline-card\"><p class=\"news-timeline-empty\">暂无新闻</p></article></li></ol></div>"*
## 板块栏HTML
+ `板块`
+ `前缀`
+ `查询键`
+ `全部类`
板块 Tab 栏。`前缀` 如 `/post/ten/`;`查询键` 为 `board_id` 或 `news_board_id`;`全部类` 为 Tab 共用 class(含 js hook)。
**数据属 = "data-board"**
**全标签 = "全部"**
1. 查询键 == "news_board_id"
**数据属 = "data-news-board"**
**全标签 = "所有板块"**
2. *
**段 = None**
**全链 = 前缀 + "?" + 查询键 + "=0"**
**全项 = "<a href=\"" + 全链 + "\" class=\"" + 全部类 + " active\" " + 数据属 + "=\"0\">" + 全标签 + "</a>"**
**段 = > table.append list=段 item=全项**
- [板](遍历 板块 为 板)
**名 = [name](access(板, "name"))**
**号 = [id](access(板, "id"))**
**链 = 前缀 + "?" + 查询键 + "=" + 号**
**项 = "<a href=\"" + 链 + "\" class=\"" + 全部类 + "\" " + 数据属 + "=\"" + 号 + "\">" + 名 + "</a>"**
**段 = > table.append list=段 item=项**
1. 查询键 == "news_board_id"
**更多 = "<a href=\"/news\" class=\"home-posts-tab home-posts-tab-more\">全部新闻</a>"**
**段 = > table.append list=段 item=更多**
2. *
**内 = > text.str_join xs=段 sep=""**
**栏类 = "home-posts-board-bar"**
1. 查询键 == "news_board_id"
**栏类 = "home-posts-board-bar home-news-board-bar"**
2. *
*"<div class=\"" + 栏类 + "\" data-feed-board><button type=\"button\" class=\"home-posts-scroll home-posts-scroll-left\" aria-label=\"向左滚动\"><span class=\"anlian-icon anlian-icon--chevron-left\"></span></button><div class=\"home-posts-segment-outer\"><div class=\"home-posts-segment\"><div class=\"home-posts-spotlight\" aria-hidden=\"true\"></div><div class=\"home-posts-tabs-scroll\"><div class=\"home-posts-tabs\" role=\"tablist\">" + 内 + "</div></div></div></div><button type=\"button\" class=\"home-posts-scroll home-posts-scroll-right\" aria-label=\"向右滚动\"><span class=\"anlian-icon anlian-icon--chevron-right\"></span></button></div>"*
-19
View File
@@ -1,19 +0,0 @@
---
markup: occlusion
---
## 页脚
站点信息与站长链接(毛玻璃底由壳样式绘制)。
`页脚` =
| 属性 | 值 |
|------|-----|
| 暗恋见君 · 期待人们能够继续相信爱情 | / |
| 帖子 | /posts |
| 新闻 | /news |
| 公聊 | /chat |
| sitemap | /sitemap.xml |
*`页脚`*
@@ -1,23 +0,0 @@
---
markup: occlusion
title: components/fragments
description: AJAX 片段 — /post/ten、/news/five。
导入:
网页: ext/web/网页.mq.md
db: ../db/index.mq.md
feed: feed.mq.md
---
## 帖子十
+ `board_id`="0"
**store = > db.打开**
**行 = > store.查询 表="posts" 上限=10 排序="-created_at"**
*> feed.帖子列表HTML 行=`行`*
## 新闻五
+ `news_board_id`="0"
**store = > db.打开**
**行 = > store.查询 表="news" 上限=5 排序="-created_at"**
*> feed.新闻时间线HTML 行=`行`*
-9
View File
@@ -1,9 +0,0 @@
---
markup: occlusion
---
## 首页引言
英雄区 HTML(品牌标语 + CTA + 漂浮主图)。样式在 `styles/shell` 的 Hero / 动效表。
**"<section class=\"hero\" aria-label=\"暗恋见君\"><div class=\"hero-content\"><div class=\"hero-left\"><p class=\"hero-brand\"><img class=\"hero-logo\" src=\"/static/logo.svg\" alt=\"\" width=\"30\" height=\"30\"><span>暗恋<span class=\"hero-pink\">见君</span></span></p><h1 class=\"main-text\">期待人们能够继续相信<span class=\"hero-pink\">爱情</span></h1><p class=\"sub-text\">粉玻璃、呼吸 Logo、漂浮主图——用 Marqdo 表格装配的社区站点,验收「代码即文档」能否撑起真实前端。</p><p class=\"hero-cta\"><a class=\"hero-btn\" href=\"/posts\">浏览帖子</a><a class=\"hero-btn ghost\" href=\"/news\">新闻</a><a class=\"hero-btn ghost\" href=\"/chat\">公聊</a></p></div><div class=\"hero-right\"><img class=\"hero-art\" src=\"/static/bg-hero-640.webp\" alt=\"暗恋见君\"></div></div></section><div class=\"home-feed-head\"><h2>最新帖子</h2><p>来自粉玻璃卡片流</p></div>"**
@@ -1,49 +0,0 @@
---
markup: occlusion
title: components/home_body
description: 首页主体 HTML — hero + 公告 + 新闻时间线 + 论坛帖子(对齐 Django home.html,无外层导航)。
导入:
网页: ext/web/网页.mq.md
table: lib/table.mq.md
text: lib/text.mq.md
feed: feed.mq.md
---
## 装配
+ `库`
查询 notices / boards / news_boards / news(5) / posts(10),拼装首页四段 HTML(不含导航与页脚)。调用方传入已打开的 store。
**公告行 = > 库.查询 表="notices" 上限=20 排序="-created_at"**
**板块行 = > 库.查询 表="boards" 上限=50**
**新闻板块行 = > 库.查询 表="news_boards" 上限=50**
**新闻行 = > 库.查询 表="news" 上限=5 排序="-created_at"**
**帖子行 = > 库.查询 表="posts" 上限=10 排序="-created_at"**
**公告段 = None**
- [告](遍历 公告行 为 告)
**文 = [content](access(告, "content"))**
**时 = [created_at](access(告, "created_at"))**
**一项 = "<div class=\"notice-item\"><article class=\"notice-content\">" + 文 + "</article><p class=\"notice-create-time\">" + 时 + "</p></div>"**
**公告段 = > table.append list=公告段 item=一项**
1. 公告段
**公告内 = > text.str_join xs=公告段 sep=""**
2. *
**公告内 = "<p class=\"text-muted\">暂无公告</p>"**
**新闻栏 = > feed.板块栏HTML 板块=新闻板块行 前缀="/news/five" 查询键="news_board_id" 全部类="home-posts-tab js-home-news-tab"**
**新闻板 = > feed.新闻时间线HTML 行=新闻行**
**帖子栏 = > feed.板块栏HTML 板块=板块行 前缀="/post/ten" 查询键="board_id" 全部类="home-posts-tab js-home-post-tab"**
**帖子表 = > feed.帖子列表HTML 行=帖子行**
**段 = None**
**英雄 = "<section class=\"hero\"><div class=\"section-wrap\"><header><img src=\"/static/img/logo.svg\" alt=\"logo\" width=\"30\" height=\"30\" decoding=\"async\"><a class=\"head-logo\" href=\"/\"><span>暗恋</span>见君</a></header><div class=\"hero-content\"><div class=\"left\"><h1 class=\"main-text\">期待人们能够继续相信<span style=\"color:#ffd0d0\">爱情</span></h1><h2 class=\"sub-text\">粉玻璃社区 · 匿名与实名同在</h2></div><div class=\"right\"><img src=\"/static/img/bg-hero-640.webp\" alt=\"首页展示图\" width=\"640\" height=\"482\" fetchpriority=\"high\" decoding=\"async\"></div></div><div class=\"social\"></div></div></section>"**
**段 = > table.append list=段 item=英雄**
**公告区 = "<section class=\"notice\"><div class=\"section-wrap\"><h2 class=\"notice-title\">公告信息</h2><div class=\"notice-content-container\"><div class=\"notice-list\">" + 公告内 + "</div></div></div></section>"**
**段 = > table.append list=段 item=公告区**
**新闻区 = "<section class=\"news home-news\" id=\"news\"><div class=\"section-wrap home-news-stage\"><h2 class=\"news-title\">新闻动态</h2>" + 新闻栏 + "<div class=\"news-timeline-wrap\"><div id=\"homeNewsPanel\" class=\"news-timeline-panel home-panel-swap\">" + 新闻板 + "</div></div></div></section>"**
**段 = > table.append list=段 item=新闻区**
**更多 = "<a href=\"/post\" class=\"home-posts-more-link\">查看更多帖子</a>"**
**帖子区 = "<section class=\"home-posts\" id=\"post\"><div class=\"section-wrap home-posts-stage\"><h2 class=\"home-posts-title\">论坛交流</h2>" + 帖子栏 + "<div id=\"tenPostContainer\" class=\"home-posts-panel home-panel-swap\">" + 帖子表 + 更多 + "</div></div></section>"**
**段 = > table.append list=段 item=帖子区**
*> text.str_join xs=段 sep=""*
-22
View File
@@ -1,22 +0,0 @@
---
markup: occlusion
---
## 导航
顶栏:首页、帖子、新闻、搜索、聊天、发帖(登录后)、后台。
`导航` =
| 属性 | 值 | 样式 | 媒体 | 当 |
|------|-----|------|------|-----|
| 暗恋见君 | / | | | |
| 帖子 | /posts | | | |
| 新闻 | /news | | | |
| 搜索 | /search | | | |
| 聊天 | /chat | | | |
| 发帖 | /write | | | auth |
| 登录 | /admin/login | | | guest |
| 后台 | /admin | | | auth |
*`导航`*
-20
View File
@@ -1,20 +0,0 @@
---
markup: occlusion
title: components/page
description: 用原站 chrome 包一层完整 HTML 引言(bare 布局)。
import:
text: lib/text.mq.md
chrome: chrome.mq.md
---
## 包装
+ `正文`
+ `体类`=""
导航 + 正文 + 页脚;体类如 `page-home`。
**顶 = > chrome.导航HTML**
**底 = > chrome.页脚HTML**
**鉴权脚本 = "<script>(function(){var c=document.cookie.indexOf('marqdo_sid=')>=0;document.querySelectorAll('.nav-when-guest').forEach(function(el){el.style.display=c?'none':'';});document.querySelectorAll('.nav-when-auth').forEach(function(el){el.style.display=c?'':'none';});})();</script>"**
**鉴权样式 = "<style>.nav-when-auth{display:none}</style>"**
*鉴权样式 + 顶 + "<main class=\"anlian-main " + 体类 + "\">" + 正文 + "</main>" + 底 + 鉴权脚本*
-65
View File
@@ -1,65 +0,0 @@
---
markup: occlusion
title: db/index
description: 打开库、建全表、幂等种子、帖子全文索引。
导入:
网页: ext/web/网页.mq.md
schema: schema.mq.md
seed: seed.mq.md
---
## 打开
打开 sqlite:data/anlian-mq.db,初始化全部表;帖子建 FTS;若 posts 为空则写入种子。返回 store。
**store = > 网页.数据库 地址="sqlite:data/anlian-mq.db"**
**帖子字段 = > schema.posts**
**新闻字段 = > schema.news**
**板块字段 = > schema.boards**
**新闻板块字段 = > schema.news_boards**
**公告字段 = > schema.notices**
**评论字段 = > schema.comments**
**房间字段 = > schema.chat_rooms**
**专题字段 = > schema.topics**
**密钥字段 = > schema.api_keys**
> `store`.初始化 名=posts 字段=`帖子字段`
> `store`.初始化 名=news 字段=`新闻字段`
> `store`.初始化 名=boards 字段=`板块字段`
> `store`.初始化 名=news_boards 字段=`新闻板块字段`
> `store`.初始化 名=notices 字段=`公告字段`
> `store`.初始化 名=comments 字段=`评论字段`
> `store`.初始化 名=chat_rooms 字段=`房间字段`
> `store`.初始化 名=topics 字段=`专题字段`
> `store`.初始化 名=api_keys 字段=`密钥字段`
`全文列` =
| 列 |
|----|
| title |
| summary |
| body |
> `store`.全文 表=posts 列=`全文列` 名=posts_fts
**已有 = > store.查询 表="posts" 上限=1**
1. `已有`
*store*
2. *
**板块 = > seed.boards**
**新闻板块 = > seed.news_boards**
**帖子 = > seed.posts**
**新闻 = > seed.news**
**公告 = > seed.notices**
**评论 = > seed.comments**
**房间 = > seed.chat_rooms**
**专题 = > seed.topics**
> `store`.插入 表=boards 行=`板块`
> `store`.插入 表=news_boards 行=`新闻板块`
> `store`.插入 表=posts 行=`帖子`
> `store`.插入 表=news 行=`新闻`
> `store`.插入 表=notices 行=`公告`
> `store`.插入 表=comments 行=`评论`
> `store`.插入 表=chat_rooms 行=`房间`
> `store`.插入 表=topics 行=`专题`
*store*
-150
View File
@@ -1,150 +0,0 @@
---
markup: occlusion
---
## posts
帖子主表。`slug` 用于详情路径;`board` 为板块显示名,`board_id` 关联 `boards`。
`posts` =
| 字段 | 类型 | 可空 | 索引 |
|------|------|------|------|
| id | integer | false | |
| title | text | false | |
| slug | text | false | 是 |
| summary | text | true | |
| body | text | true | |
| board | text | true | |
| board_id | integer | true | |
| author | text | true | |
| comments_count | integer | true | |
| views | integer | true | |
| created_at | timestamp | true | |
| updated_at | timestamp | true | |
*`posts`*
## news
新闻主表。`board_id` 关联 `news_boards`;`board` 为板块显示名。
`news` =
| 字段 | 类型 | 可空 | 索引 |
|------|------|------|------|
| id | integer | false | |
| title | text | false | |
| slug | text | false | 是 |
| summary | text | true | |
| body | text | true | |
| board | text | true | |
| board_id | integer | true | |
| created_at | timestamp | true | |
| updated_at | timestamp | true | |
*`news`*
## boards
帖子板块。
`boards` =
| 字段 | 类型 | 可空 | 索引 |
|------|------|------|------|
| id | integer | false | |
| name | text | false | |
| slug | text | false | 是 |
*`boards`*
## news_boards
新闻板块。
`news_boards` =
| 字段 | 类型 | 可空 | 索引 |
|------|------|------|------|
| id | integer | false | |
| name | text | false | |
| slug | text | false | 是 |
*`news_boards`*
## notices
首页公告。
`notices` =
| 字段 | 类型 | 可空 |
|------|------|------|
| id | integer | false |
| content | text | false |
| created_at | timestamp | true |
*`notices`*
## comments
评论(按目标类型 + slug 挂接)。
`comments` =
| 字段 | 类型 | 可空 |
|------|------|------|
| id | integer | false |
| target_type | text | false |
| target_slug | text | false |
| body | text | false |
| author | text | true |
| created_at | timestamp | true |
*`comments`*
## chat_rooms
公聊房间。
`chat_rooms` =
| 字段 | 类型 | 可空 | 索引 |
|------|------|------|------|
| id | integer | false | |
| slug | text | false | 是 |
| name | text | false | |
| summary | text | true | |
*`chat_rooms`*
## topics
专题占位。
`topics` =
| 字段 | 类型 | 可空 | 索引 |
|------|------|------|------|
| id | integer | false | |
| slug | text | false | 是 |
| title | text | false | |
| summary | text | true | |
*`topics`*
## api_keys
API Key 校验用哈希表(应用层 scopes)。
`api_keys` =
| 字段 | 类型 | 可空 |
|------|------|------|
| id | integer | false |
| name | text | false |
| hash | text | false |
| scopes | text | true |
*`api_keys`*
-110
View File
@@ -1,110 +0,0 @@
---
markup: occlusion
---
## boards
帖子板块:日常 / 开发 / 聊天。
`boards` =
| @ | name | slug |
|---|------|------|
| 1 | 日常 | daily |
| 2 | 开发 | develop |
| 3 | 聊天 | chat |
*`boards`*
## news_boards
新闻板块:站务 / 技术。
`news_boards` =
| @ | name | slug |
|---|------|------|
| 1 | 站务 | site |
| 2 | 技术 | tech |
*`news_boards`*
## posts
种子帖子(标题/短链与原 anlian-mq 一致)。
`posts` =
| @ | title | slug | summary | body | board | board_id | author | comments_count | views |
|---|-------|------|---------|------|-------|----------|--------|----------------|-------|
| 1 | 欢迎来到暗恋见君 | welcome | 期待人们能够继续相信爱情。 | 这是用 Marqdo 重写的验收站点。页面、库表与门禁都用 GFM 表格装配——代码即文档。 | 日常 | 1 | 站务 | 2 | 42 |
| 2 | 如何用表格写论坛 | tables-for-forums | 导航、表单、种子数据都是可读表格。 | 若某功能逼你写一长串 json.set,请先审视 ext/web 是否缺命名方法。 | 开发 | 2 | 站务 | 0 | 18 |
| 3 | 公聊室已开放 | chat-open | WebSocket 广播房间。 | 打开 /chat,连上 /chat/ws,消息会扇出给同房间所有人。 | 聊天 | 3 | 站务 | 0 | 9 |
*`posts`*
## news
种子新闻。
`news` =
| @ | title | slug | summary | body | board | board_id |
|---|-------|------|---------|------|-------|----------|
| 1 | 站点迁往 Marqdo | migrate-to-marqdo | 原生层换 Go libweb,作者面保持表格。 | 暗恋见君的验收目标:登录、发帖、列表详情、聊天与站长工具都能用 .mq.md 写完。 | 站务 | 1 |
| 2 | 外接 PostgreSQL / Redis | pg-redis | 生产可用外接驱动。 | 本示例默认 sqlite:;把数据库地址换成 postgres:// 即可。 | 技术 | 2 |
*`news`*
## notices
首页公告(2–3 条)。
`notices` =
| @ | content | created_at |
|---|---------|------------|
| 1 | 欢迎来到暗恋见君论坛。本站支持匿名与实名交流,请友善发言。 | 2026-09-01 10:00:00 |
| 2 | 站点正用 Marqdo 表格重写验收:导航、首页四段、列表与公聊对齐原站 DOM。 | 2026-09-08 14:30:00 |
| 3 | 发帖与评论请遵守社区规范;站务公告将在此置顶。 | 2026-09-10 09:00:00 |
*`notices`*
## comments
欢迎帖下的评论。
`comments` =
| @ | target_type | target_slug | body | author | created_at |
|---|-------------|-------------|------|--------|------------|
| 1 | post | welcome | 终于等到用表格写论坛的一天。 | 路人甲 | 2026-09-10 11:00:00 |
| 2 | post | welcome | 期待人们能够继续相信爱情。 | 见君 | 2026-09-10 12:15:00 |
*`comments`*
## chat_rooms
公聊:大厅 + 闲聊。
`chat_rooms` =
| @ | slug | name | summary |
|---|------|------|---------|
| 1 | lobby | 大厅 | 全站公共聊天室。 |
| 2 | casual | 闲聊 | 轻松闲聊,勿刷屏。 |
*`chat_rooms`*
## topics
专题占位条目。
`topics` =
| @ | slug | title | summary |
|---|------|-------|---------|
| 1 | glass-ui | 粉玻璃界面 | 首页与列表的毛玻璃视觉专题(占位)。 |
| 2 | tables-as-code | 表格即代码 | Marqdo GFM 表装配专题(占位)。 |
*`topics`*
-212
View File
@@ -1,212 +0,0 @@
---
markup: occlusion
title: 暗恋见君 · Marqdo
description: 对齐 Django 暗恋见君:原站 CSS/DOM、首页四段、列表详情、发帖门禁、聊天室、专题、搜索、API 指南。
导入:
网页: ext/web/网页.mq.md
table: lib/table.mq.md
text: lib/text.mq.md
chrome: components/chrome.mq.md
page: components/page.mq.md
home: components/home_body.mq.md
feed: components/feed.mq.md
fragments: components/fragments.mq.md
db: db/index.mq.md
---
# main
路径对齐原站:`/post`、`/news`、`/post/public`、`/chat`、`/topics`、`/search`、`/accounts/login`。
`用户表` =
| 行 | 用户名 | 密码 | 角色 |
|----|--------|------|------|
| 1 | admin | anlian | admin |
`发帖字段` =
| 字段 | 标签 | 类型 | 必填 |
|------|------|------|------|
| title | 标题 | text | true |
| slug | 短链 | text | true |
| summary | 摘要 | text | false |
| body | 正文 | textarea | true |
| board | 板块 | text | false |
| board_id | 板块ID | number | false |
| author | 署名 | text | false |
`发帖规则` =
| 字段 | 规则 | 消息 |
|------|------|------|
| title | required | 标题不能为空 |
| slug | required | 需要短链 |
| body | required | 正文不能为空 |
`帖子详情` =
| 属性 | 值 | 样式 |
|------|-----|------|
| title | posts.title | |
| meta | posts.author | |
| body | posts.body | |
`新闻详情` =
| 属性 | 值 | 样式 |
|------|-----|------|
| title | news.title | |
| body | news.body | |
`帖子条件` =
| 字段 | 操作 | 值 |
|------|------|-----|
| slug | = | {slug} |
`新闻条件` =
| 字段 | 操作 | 值 |
|------|------|-----|
| slug | = | {slug} |
`地图项` =
| loc | 更新 |
|-----|------|
| / | 2026-09-10 |
| /post | 2026-09-10 |
| /news | 2026-09-10 |
| /chat | 2026-09-10 |
| /topics | 2026-09-10 |
| /search | 2026-09-10 |
| /guide/automation-api | 2026-09-10 |
`图标` =
| 路径 | 关系 | 类型 | 尺寸 | 地址 |
|------|------|------|------|------|
| "public/img/favicon-32.png" | icon | "image/png" | 32x32 | "/favicon.ico" |
**store = > db.打开**
**头 = > chrome.头资源**
**顶 = > chrome.导航HTML**
**底 = > chrome.页脚HTML**
**鉴权补丁 = "<style>.nav-when-auth{display:none}</style><script>(function(){var c=document.cookie.indexOf('marqdo_sid=')>=0;document.querySelectorAll('.nav-when-guest').forEach(function(el){el.style.display=c?'none':'';});document.querySelectorAll('.nav-when-auth').forEach(function(el){el.style.display=c?'':'none';});})();</script>"**
**主页体 = > home.装配 库=`store`**
**主页文 = > page.包装 正文=`主页体` 体类="page-home"**
**首页 = > 网页.页面 标题="暗恋见君论坛" 引言=`主页文` 壳样式="off" 布局="bare"**
**首页 = > 首页.头装配 表=`头`**
**板块行 = > store.查询 表="boards" 上限=50**
**帖子行 = > store.查询 表="posts" 上限=50 排序="-created_at"**
**帖子栏 = > feed.板块栏HTML 板块=板块行 前缀="/post" 查询键="board_id" 全部类="feed-tab"**
**帖子表 = > feed.帖子列表HTML 行=帖子行**
**帖子列表体 = "<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1 class=\"feed-list-title\">论坛交流</h1>" + 帖子栏 + 帖子表 + "<p style=\"margin-top:1rem\"><a href=\"/post/public\">发布帖子</a></p></div></section>"**
**帖子列表文 = > page.包装 正文=`帖子列表体` 体类="page-post-list"**
**帖子列表 = > 网页.页面 标题="帖子 · 暗恋见君" 引言=`帖子列表文` 壳样式="off" 布局="bare"**
**帖子列表 = > 帖子列表.头装配 表=`头`**
**新闻板块行 = > store.查询 表="news_boards" 上限=50**
**新闻行 = > store.查询 表="news" 上限=50 排序="-created_at"**
**新闻栏 = > feed.板块栏HTML 板块=新闻板块行 前缀="/news" 查询键="news_board_id" 全部类="feed-tab"**
**新闻表 = > feed.新闻时间线HTML 行=新闻行**
**新闻列表体 = "<section class=\"feed-list-page home-news\"><div class=\"section-wrap\"><h1 class=\"feed-list-title\">新闻动态</h1>" + 新闻栏 + 新闻表 + "</div></section>"**
**新闻列表文 = > page.包装 正文=`新闻列表体` 体类="page-news-list"**
**新闻列表 = > 网页.页面 标题="新闻 · 暗恋见君" 引言=`新闻列表文` 壳样式="off" 布局="bare"**
**新闻列表 = > 新闻列表.头装配 表=`头`**
**帖子页 = > 网页.页面 标题="帖子详情" 引言=`鉴权补丁` 壳样式="off" 布局="stacked"**
**帖子页 = > 帖子页.头装配 表=`头`**
**帖子页 = > 帖子页.壳HTML 导航=`顶` 页脚=`底` 体类="page-post-detail"**
**帖子页 = > 帖子页.主体装配 主体=`帖子详情`**
**帖子页 = > 帖子页.查询条件 条件=`帖子条件`**
**帖子页 = > 帖子页.详情 详情=True**
**新闻页 = > 网页.页面 标题="新闻详情" 引言=`鉴权补丁` 壳样式="off" 布局="stacked"**
**新闻页 = > 新闻页.头装配 表=`头`**
**新闻页 = > 新闻页.壳HTML 导航=`顶` 页脚=`底` 体类="page-news-detail"**
**新闻页 = > 新闻页.主体装配 主体=`新闻详情`**
**新闻页 = > 新闻页.查询条件 条件=`新闻条件`**
**新闻页 = > 新闻页.详情 详情=True**
**发帖表 = > 网页.表单 表="posts" 动作="插入"**
**发帖表 = > 发帖表.字段 字段=`发帖字段`**
**发帖表 = > 发帖表.规则 规则=`发帖规则`**
**发帖引言 = > page.包装 正文="<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1>发布帖子</h1><p>需登录(admin / anlian)</p></div></section>" 体类="page-post-public"**
**发帖页 = > 网页.页面 标题="发帖 · 暗恋见君" 引言=`发帖引言` 壳样式="off" 布局="bare"**
**发帖页 = > 发帖页.头装配 表=`头`**
**发帖页 = > 发帖页.表单装配 id="post" 表单=`发帖表`**
**房间行 = > store.查询 表="chat_rooms" 上限=50**
**房间段 = None**
- [房](遍历 房间行 为 房)
**名 = [name](access(房, "name"))**
**链 = [slug](access(房, "slug"))**
**摘 = [summary](access(房, "summary"))**
**项 = "<article class=\"chat-room-card\"><h3><a href=\"/chat/" + 链 + "\">" + 名 + "</a></h3><p>" + 摘 + "</p></article>"**
**房间段 = > table.append list=房间段 item=项**
**房间内 = > text.str_join xs=房间段 sep=""**
**聊天列表体 = "<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1>聊天室</h1><div class=\"chat-room-grid\">" + 房间内 + "</div></div></section>"**
**聊天列表文 = > page.包装 正文=`聊天列表体` 体类="page-chat"**
**聊天列表 = > 网页.页面 标题="聊天 · 暗恋见君" 引言=`聊天列表文` 壳样式="off" 布局="bare"**
**聊天列表 = > 聊天列表.头装配 表=`头`**
**大厅体 = "<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1>大厅</h1><div class=\"chat-box\"><div id=\"chat-log\" class=\"chat-log\"></div><p class=\"search-bar\"><input id=\"chat-msg\" placeholder=\"说点什么…\" aria-label=\"消息\"><button id=\"chat-send\" type=\"button\">发送</button></p></div><script src=\"/static/chat.js\"></script></div></section>"**
**大厅文 = > page.包装 正文=`大厅体` 体类="page-chat-room"**
**大厅页 = > 网页.页面 标题="大厅 · 暗恋见君" 引言=`大厅文` 壳样式="off" 布局="bare"**
**大厅页 = > 大厅页.头装配 表=`头`**
**闲聊体 = "<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1>闲聊</h1><div class=\"chat-box\"><div id=\"chat-log\" class=\"chat-log\"></div><p class=\"search-bar\"><input id=\"chat-msg\" placeholder=\"说点什么…\" aria-label=\"消息\"><button id=\"chat-send\" type=\"button\">发送</button></p></div><script src=\"/static/chat.js\"></script></div></section>"**
**闲聊文 = > page.包装 正文=`闲聊体` 体类="page-chat-room"**
**闲聊页 = > 网页.页面 标题="闲聊 · 暗恋见君" 引言=`闲聊文` 壳样式="off" 布局="bare"**
**闲聊页 = > 闲聊页.头装配 表=`头`**
**专题行 = > store.查询 表="topics" 上限=50**
**专题段 = None**
- [题](遍历 专题行 为 题)
**题名 = [title](access(题, "title"))**
**链 = [slug](access(题, "slug"))**
**摘 = [summary](access(题, "summary"))**
**项 = "<article class=\"topic-card\"><h3>" + 题名 + "</h3><p>" + 摘 + "</p><p class=\"text-muted\">slug: " + 链 + "</p></article>"**
**专题段 = > table.append list=专题段 item=项**
**专题内 = > text.str_join xs=专题段 sep=""**
**专题体 = "<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1>专题书架</h1><div class=\"topic-shelf\">" + 专题内 + "</div></div></section>"**
**专题文 = > page.包装 正文=`专题体` 体类="page-topics"**
**专题页 = > 网页.页面 标题="专题 · 暗恋见君" 引言=`专题文` 壳样式="off" 布局="bare"**
**专题页 = > 专题页.头装配 表=`头`**
**搜索体 = "<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1>搜索</h1><form class=\"search-bar\" method=\"get\" action=\"/search\"><input name=\"q\" placeholder=\"关键词\" aria-label=\"关键词\"><button type=\"submit\">搜</button></form><p class=\"text-muted\">全文检索走 SQLite FTS(posts_fts);结果面板后续可按 q 扩展。</p></div></section>"**
**搜索文 = > page.包装 正文=`搜索体` 体类="page-search"**
**搜索页 = > 网页.页面 标题="搜索 · 暗恋见君" 引言=`搜索文` 壳样式="off" 布局="bare"**
**搜索页 = > 搜索页.头装配 表=`头`**
**指南体 = "<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1>API 自动化指南</h1><p>使用 Bearer / X-Api-Key 调用自动化接口。本验收切片提供 <code>api_keys</code> 表与 <code>web_api_key_check</code> 原语;业务 scopes 写在 .mq.md。</p><pre>Authorization: Bearer &lt;token&gt;</pre></div></section>"**
**指南文 = > page.包装 正文=`指南体` 体类="page-guide"**
**指南页 = > 网页.页面 标题="API 指南 · 暗恋见君" 引言=`指南文` 壳样式="off" 布局="bare"**
**指南页 = > 指南页.头装配 表=`头`**
**应用 = > 网页.应用 页面=`首页` 数据库=`store` 后台=True 主机="127.0.0.1" 端口=18180**
**应用 = > 应用.路由 路径="/post" 页面=`帖子列表`**
**应用 = > 应用.路由 路径="/post/public" 页面=`发帖页`**
**应用 = > 应用.路由 路径="/post/{slug}" 页面=`帖子页`**
**应用 = > 应用.路由 路径="/news" 页面=`新闻列表`**
**应用 = > 应用.路由 路径="/news/{slug}" 页面=`新闻页`**
**应用 = > 应用.路由 路径="/chat" 页面=`聊天列表`**
**应用 = > 应用.路由 路径="/chat/lobby" 页面=`大厅页`**
**应用 = > 应用.路由 路径="/chat/casual" 页面=`闲聊页`**
**应用 = > 应用.路由 路径="/topics" 页面=`专题页`**
**应用 = > 应用.路由 路径="/search" 页面=`搜索页`**
**应用 = > 应用.路由 路径="/guide/automation-api" 页面=`指南页`**
**应用 = > 应用.静态 目录="public" 挂载="/static"**
**应用 = > 应用.图标 表=`图标`**
**应用 = > 应用.鉴权 用户表=`用户表` 会话时长=7200 登录路径="/accounts/login" 登录回跳="/post/public" 登出回跳="/"**
**应用 = > 应用.门禁 路径="/post/public" 角色="admin" 匹配="prefix" 拒绝="redirect" 排除="/accounts/login"**
**应用 = > 应用.路由实时 路径="/chat/ws" 模式="broadcast"**
**应用 = > 应用.调用 路径="/post/ten" 方法="GET" 函数="fragments.帖子十" 正文="query" 返回="html"**
**应用 = > 应用.调用 路径="/news/five" 方法="GET" 函数="fragments.新闻五" 正文="query" 返回="html"**
**应用 = > 应用.站点地图 路径="/sitemap.xml" 基址="http://127.0.0.1:18180" 条目=`地图项`**
**应用 = > 应用.爬虫协议 站点地图="http://127.0.0.1:18180/sitemap.xml"**
> `应用`.监听
-74
View File
@@ -1,74 +0,0 @@
---
markup: occlusion
title: anlian-mq offline smoke
description: 不 listen:装配库表/页面/门禁/WS 路由袋,验证可读路径可构造。
导入:
网页: ext/web/网页.mq.md
shell: styles/shell.mq.md
nav: components/nav.mq.md
foot: components/foot.mq.md
db: db/index.mq.md
sys: lib/sys.mq.md
---
# main
`壳` =
| 组件 | 样式 |
|------|------|
| nav.`导航` | |
| foot.`页脚` | |
`帖子卡片` =
| 属性 | 值 |
|------|-----|
| title | posts.title |
| body | posts.summary |
| href | posts.slug |
`用户表` =
| 行 | 用户名 | 密码 | 角色 |
|----|--------|------|------|
| 1 | admin | anlian | admin |
**store = > db.打开**
**壳CSS = > shell.全局**
**首页 = > 网页.页面 标题="暗恋见君" 引言="<h1>ok</h1>"**
**首页 = > 首页.组件装配 组件=`壳`**
**首页 = > 首页.主体装配 主体=`帖子卡片`**
**首页 = > 首页.样式 样式=`壳CSS`**
**应用 = > 网页.应用 页面=`首页` 数据库=`store` 后台=True 主机="127.0.0.1" 端口=18180**
**应用 = > 应用.鉴权 用户表=`用户表`**
**应用 = > 应用.门禁 路径="/write" 角色="admin" 匹配="prefix" 拒绝="redirect"**
**应用 = > 应用.路由实时 路径="/chat/ws" 模式="broadcast"**
**gates = [gates](access(应用, "gates"))**
**n = > len value=`gates`**
1. `n` >= 2
> print text=gates-ok
2. *
> print text=gates-fail
> sys.exit code=1
**ws = [ws_routes](access(应用, "ws_routes"))**
**room = [/chat/ws](access(ws, "/chat/ws"))**
**mode = [mode](access(room, "mode"))**
1. `mode` == "broadcast"
> print text=ws-ok
2. *
> print text=ws-fail
> sys.exit code=1
**list = > store.查询 表="posts" 上限=10**
**nr = > len value=`list`**
1. `nr` >= 1
> print text=seed-ok
2. *
> print text=seed-fail
> sys.exit code=1
> print text=anlian-offline-ok
Binary file not shown.

Before

Width:  |  Height:  |  Size: 76 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 45 KiB

-37
View File
@@ -1,37 +0,0 @@
/* 公聊客户端:保持极薄;业务配置仍在 .mq.md 表格里。 */
(function () {
var log = document.getElementById("chat-log");
var input = document.getElementById("chat-msg");
var send = document.getElementById("chat-send");
if (!log || !input || !send) return;
var proto = location.protocol === "https:" ? "wss:" : "ws:";
var ws = new WebSocket(proto + "//" + location.host + "/chat/ws");
function line(text) {
log.textContent += text + "\n";
log.scrollTop = log.scrollHeight;
}
ws.onopen = function () {
line("[已连接公聊室]");
};
ws.onclose = function () {
line("[连接关闭]");
};
ws.onmessage = function (ev) {
line(String(ev.data));
};
function publish() {
var t = (input.value || "").trim();
if (!t || ws.readyState !== 1) return;
ws.send(t);
input.value = "";
}
send.addEventListener("click", publish);
input.addEventListener("keydown", function (e) {
if (e.key === "Enter") publish();
});
})();
@@ -1,454 +0,0 @@
/**
* 暗恋见君 — 登录/注册/发帖/评论 共用表单样式(粉色毛玻璃主题)
*/
:root {
--anlian-accent: #fdbbdb;
--anlian-accent-deep: #f0a8c4;
--anlian-accent-text: #a85878;
--anlian-accent-muted: #c97a96;
--anlian-glass-bg: rgba(255, 255, 255, 0.38);
--anlian-glass-border: rgba(255, 255, 255, 0.52);
--anlian-text: #222;
--anlian-text-muted: #666;
--anlian-radius: 14px;
--anlian-radius-pill: 999px;
--anlian-transition: 0.2s ease;
}
/* ---------- 页面布局 ---------- */
.anlian-page {
display: flex;
flex-direction: column;
align-items: center;
width: 100%;
max-width: 520px;
margin: 0 auto;
padding: 1.5rem 1rem 2.5rem;
box-sizing: border-box;
}
.anlian-page-wide {
max-width: 800px;
}
.anlian-page-title {
margin: 0 0 1.25rem;
font-size: 1.75rem;
font-weight: 700;
color: var(--anlian-text);
text-align: center;
}
.anlian-page-lead {
margin: -0.5rem 0 1.25rem;
font-size: 0.9rem;
color: var(--anlian-text-muted);
text-align: center;
line-height: 1.5;
}
/* ---------- 表单卡片 ---------- */
.anlian-form-card {
width: 100%;
padding: 2rem 1.75rem;
border-radius: 24px;
background: var(--anlian-glass-bg);
backdrop-filter: blur(18px);
-webkit-backdrop-filter: blur(18px);
border: 1px solid var(--anlian-glass-border);
box-shadow: 0 12px 40px rgba(253, 189, 219, 0.15);
box-sizing: border-box;
}
.anlian-form-card .form-group,
.anlian-form-card .anlian-field {
margin-bottom: 1.25rem;
}
.anlian-form-card .anlian-field:last-child,
.anlian-form-card .form-group:last-of-type {
margin-bottom: 0;
}
/* ---------- 标签与输入框 ---------- */
.anlian-field-label,
.anlian-form-card label:not(.anlian-pill-label):not(.anlian-switch) {
display: block;
margin-bottom: 0.45rem;
font-size: 0.875rem;
font-weight: 600;
color: var(--anlian-accent-text);
}
.anlian-form-card input[type="text"],
.anlian-form-card input[type="email"],
.anlian-form-card input[type="password"],
.anlian-form-card input[type="search"],
.anlian-form-card input[type="number"],
.anlian-form-card input.anlian-input,
.anlian-form-card .form-control,
.anlian-form-card textarea,
.anlian-form-card select {
display: block;
width: 100%;
box-sizing: border-box;
padding: 0.7rem 0.95rem;
font-size: 1rem;
line-height: 1.4;
color: var(--anlian-text);
background: rgba(255, 255, 255, 0.55);
border: 1px solid rgba(253, 189, 219, 0.35);
border-radius: 12px;
transition: border-color var(--anlian-transition), box-shadow var(--anlian-transition),
background var(--anlian-transition);
}
.anlian-form-card input::placeholder,
.anlian-form-card textarea::placeholder {
color: #999;
}
.anlian-form-card input:focus,
.anlian-form-card textarea:focus,
.anlian-form-card select:focus {
outline: none;
border-color: var(--anlian-accent-deep);
background: rgba(255, 255, 255, 0.72);
box-shadow: 0 0 0 3px rgba(253, 189, 219, 0.28);
}
.anlian-form-card select {
cursor: pointer;
appearance: none;
background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='8' viewBox='0 0 12 8'%3E%3Cpath fill='%23a85878' d='M6 8 0 0h12z'/%3E%3C/svg%3E");
background-repeat: no-repeat;
background-position: right 0.95rem center;
padding-right: 2.25rem;
}
.anlian-form-card textarea {
min-height: 100px;
resize: vertical;
}
/* ---------- 记住我(自定义勾选,替代原生 checkbox) ---------- */
.anlian-field-remember {
margin-bottom: 1.25rem;
}
.anlian-switch {
display: inline-flex;
align-items: center;
gap: 0.65rem;
cursor: pointer;
user-select: none;
}
.anlian-switch-input {
position: absolute;
width: 1px;
height: 1px;
padding: 0;
margin: -1px;
overflow: hidden;
clip: rect(0, 0, 0, 0);
white-space: nowrap;
border: 0;
}
.anlian-switch-box {
position: relative;
flex-shrink: 0;
width: 1.35rem;
height: 1.35rem;
border-radius: 8px;
background: rgba(255, 255, 255, 0.5);
border: 1px solid rgba(253, 189, 219, 0.5);
box-shadow: inset 0 1px 2px rgba(255, 255, 255, 0.4);
transition: background var(--anlian-transition), border-color var(--anlian-transition),
box-shadow var(--anlian-transition);
}
.anlian-switch-box::after {
content: '';
position: absolute;
left: 50%;
top: 45%;
width: 0.3rem;
height: 0.55rem;
margin-left: -0.2rem;
margin-top: -0.38rem;
border: solid #fff;
border-width: 0 2px 2px 0;
transform: rotate(45deg) scale(0);
opacity: 0;
transition: transform 0.15s ease, opacity 0.15s ease;
}
.anlian-switch-input:checked + .anlian-switch-box {
background: linear-gradient(135deg, rgba(253, 189, 219, 0.85), rgba(240, 168, 196, 0.9));
border-color: rgba(240, 168, 196, 0.85);
box-shadow: 0 2px 8px rgba(253, 189, 219, 0.35);
}
.anlian-switch-input:checked + .anlian-switch-box::after {
transform: rotate(45deg) scale(1);
opacity: 1;
}
.anlian-switch-input:focus-visible + .anlian-switch-box {
outline: none;
box-shadow: 0 0 0 3px rgba(253, 189, 219, 0.35);
}
.anlian-switch-text {
font-size: 0.875rem;
font-weight: 500;
color: var(--anlian-accent-text);
line-height: 1.3;
}
.anlian-switch:hover .anlian-switch-box {
border-color: var(--anlian-accent-deep);
background: rgba(255, 255, 255, 0.62);
}
.anlian-switch:hover .anlian-switch-input:checked + .anlian-switch-box {
background: linear-gradient(135deg, rgba(253, 189, 219, 0.95), rgba(240, 168, 196, 0.95));
}
/* ---------- 匿名:分段切换 ---------- */
.anlian-field-anon {
margin-top: 0.25rem;
}
.anlian-pill-toggle {
position: relative;
}
.anlian-pill-input {
position: absolute;
width: 1px;
height: 1px;
padding: 0;
margin: -1px;
overflow: hidden;
clip: rect(0, 0, 0, 0);
white-space: nowrap;
border: 0;
}
.anlian-pill-label {
position: relative;
display: grid;
grid-template-columns: 1fr 1fr;
align-items: center;
min-height: 2.5rem;
padding: 4px;
border-radius: var(--anlian-radius-pill);
background: rgba(255, 255, 255, 0.32);
border: 1px solid rgba(253, 189, 219, 0.45);
cursor: pointer;
user-select: none;
overflow: hidden;
}
.anlian-pill-thumb {
position: absolute;
top: 4px;
left: 4px;
width: calc(50% - 4px);
height: calc(100% - 8px);
border-radius: var(--anlian-radius-pill);
background: linear-gradient(135deg, rgba(253, 189, 219, 0.65), rgba(240, 168, 196, 0.75));
box-shadow: 0 2px 10px rgba(253, 189, 219, 0.25);
transition: transform 0.28s cubic-bezier(0.34, 1.2, 0.64, 1);
pointer-events: none;
}
.anlian-pill-input:checked + .anlian-pill-label .anlian-pill-thumb {
transform: translateX(100%);
}
.anlian-pill-option {
position: relative;
z-index: 1;
text-align: center;
font-size: 0.8125rem;
font-weight: 600;
color: var(--anlian-text-muted);
padding: 0.35rem 0.5rem;
transition: color var(--anlian-transition);
}
.anlian-pill-input:not(:checked) + .anlian-pill-label .anlian-pill-option:first-child,
.anlian-pill-input:checked + .anlian-pill-label .anlian-pill-option:last-child {
color: var(--anlian-accent-text);
}
.anlian-field-hint {
margin: 0.4rem 0 0;
font-size: 0.75rem;
color: var(--anlian-text-muted);
line-height: 1.4;
}
/* ---------- 验证码行 ---------- */
.anlian-code-row {
display: flex;
gap: 0.5rem;
align-items: stretch;
}
.anlian-code-row input {
flex: 1;
min-width: 0;
}
.anlian-btn-send-code {
flex-shrink: 0;
align-self: stretch;
padding: 0 1rem;
border: 1px solid rgba(253, 189, 219, 0.5);
border-radius: 12px;
background: rgba(253, 189, 219, 0.32);
color: var(--anlian-accent-text);
font-size: 0.8125rem;
font-weight: 600;
cursor: pointer;
white-space: nowrap;
transition: background var(--anlian-transition), transform var(--anlian-transition);
}
.anlian-btn-send-code:hover:not(:disabled) {
background: rgba(253, 189, 219, 0.48);
}
.anlian-btn-send-code:disabled {
opacity: 0.55;
cursor: not-allowed;
}
/* ---------- 主按钮 ---------- */
.anlian-btn-primary,
.anlian-form-card .anlian-btn-submit,
.anlian-form-card #login-btn,
.anlian-form-card #submit-btn,
.anlian-form-card #submit-comment-btn {
display: block;
width: 100%;
margin-top: 1.25rem;
padding: 0.75rem 1.25rem;
font-size: 1rem;
font-weight: 600;
color: var(--anlian-accent-text);
background: linear-gradient(135deg, rgba(253, 189, 219, 0.55), rgba(240, 168, 196, 0.65));
border: 1px solid rgba(240, 168, 196, 0.75);
border-radius: var(--anlian-radius-pill);
cursor: pointer;
transition: transform var(--anlian-transition), box-shadow var(--anlian-transition),
background var(--anlian-transition);
box-shadow: 0 4px 16px rgba(253, 189, 219, 0.22);
}
.anlian-btn-primary:hover,
.anlian-form-card .anlian-btn-submit:hover,
.anlian-form-card #login-btn:hover,
.anlian-form-card #submit-btn:hover,
.anlian-form-card #submit-comment-btn:hover {
background: linear-gradient(135deg, rgba(253, 189, 219, 0.68), rgba(240, 168, 196, 0.78));
box-shadow: 0 6px 22px rgba(253, 189, 219, 0.32);
transform: translateY(-1px);
}
/* ---------- 提示与链接 ---------- */
.anlian-alert {
padding: 0.85rem 1rem;
margin-bottom: 1rem;
border-radius: 12px;
font-size: 0.875rem;
line-height: 1.45;
}
.anlian-alert-danger {
background: rgba(220, 80, 100, 0.12);
border: 1px solid rgba(220, 80, 100, 0.28);
color: #9e3a4a;
}
.anlian-alert p {
margin: 0;
}
.anlian-field-error {
display: block;
margin-top: 0.35rem;
font-size: 0.8125rem;
color: #b33a4d;
}
.anlian-form-links {
display: flex;
justify-content: center;
gap: 1rem;
margin-top: 1.25rem;
flex-wrap: wrap;
}
.anlian-form-links a {
font-size: 0.875rem;
font-weight: 500;
color: var(--anlian-accent-text);
text-decoration: none;
}
.anlian-form-links a:hover {
text-decoration: underline;
}
/* ---------- 富文本编辑器 ---------- */
.anlian-editor-wrap {
border-radius: 12px;
overflow: hidden;
border: 1px solid rgba(253, 189, 219, 0.35);
background: rgba(255, 255, 255, 0.45);
}
.anlian-editor-wrap #editor {
min-height: 360px;
}
.anlian-editor-wrap .w-e-toolbar {
background: rgba(255, 255, 255, 0.65) !important;
border-bottom: 1px solid rgba(253, 189, 219, 0.3) !important;
}
.anlian-editor-wrap .w-e-text-container {
background: rgba(255, 255, 255, 0.35) !important;
}
/* ---------- 评论表单区块 ---------- */
.anlian-comment-form.anlian-form-card {
margin-bottom: 2rem;
}
@media (max-width: 576px) {
.anlian-form-card {
padding: 1.35rem 1.15rem;
border-radius: 18px;
}
.anlian-page-title {
font-size: 1.5rem;
}
.anlian-code-row {
flex-direction: column;
}
.anlian-btn-send-code {
width: 100%;
padding: 0.65rem;
}
}
-199
View File
@@ -1,199 +0,0 @@
/* API 自动化指南页 */
.api-guide-page {
max-width: 52rem;
align-items: stretch;
text-align: left;
padding-bottom: 3rem;
}
.api-guide-hero {
margin-bottom: 1.25rem;
}
.api-guide-hero .api-guide-title {
margin-top: 0;
text-align: left;
}
.api-guide-hero .anlian-page-lead {
margin-bottom: 0;
text-align: left;
max-width: none;
}
.api-guide-toc {
margin-bottom: 1.25rem;
}
.api-guide-toc-title {
margin: 0 0 0.65rem;
font-size: 0.875rem;
font-weight: 700;
color: var(--anlian-text-muted);
text-transform: uppercase;
letter-spacing: 0.04em;
}
.api-guide-toc ol {
margin: 0;
padding-left: 1.25rem;
line-height: 1.85;
}
.api-guide-toc a {
color: var(--anlian-accent-text);
text-decoration: none;
font-weight: 500;
}
.api-guide-toc a:hover {
text-decoration: underline;
}
.api-guide-section {
margin-bottom: 1.25rem;
}
.api-guide-section h2 {
margin: 0 0 0.85rem;
font-size: 1.25rem;
font-weight: 700;
color: var(--anlian-text);
border-bottom: 1px solid rgba(253, 189, 219, 0.45);
padding-bottom: 0.4rem;
}
.api-guide-section h3 {
margin: 1.1rem 0 0.5rem;
font-size: 1rem;
font-weight: 600;
color: var(--anlian-text);
}
.api-guide-section p,
.api-guide-section li {
font-size: 0.9375rem;
line-height: 1.65;
color: var(--anlian-text);
}
.api-guide-steps {
margin: 0 0 1rem;
padding-left: 1.35rem;
}
.api-guide-steps li {
margin-bottom: 0.35rem;
}
.api-guide-list {
margin: 0;
padding-left: 1.25rem;
}
.api-guide-list li {
margin-bottom: 0.4rem;
}
.api-guide-note {
margin: 0.75rem 0 0;
padding: 0.65rem 0.85rem;
font-size: 0.8125rem;
color: var(--anlian-text-muted);
background: rgba(255, 255, 255, 0.35);
border-radius: 10px;
border-left: 3px solid var(--anlian-accent);
}
.api-guide-warn {
margin: 0.75rem 0 0;
font-size: 0.875rem;
color: #a85858;
font-weight: 500;
}
.api-guide-code {
margin: 0.5rem 0 1rem;
padding: 0.85rem 1rem;
overflow-x: auto;
font-size: 0.8125rem;
line-height: 1.55;
background: rgba(30, 30, 40, 0.06);
border: 1px solid rgba(0, 0, 0, 0.06);
border-radius: 10px;
}
.api-guide-code code {
font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
color: #333;
white-space: pre;
}
.api-guide-table {
width: 100%;
margin: 0.75rem 0 1rem;
border-collapse: collapse;
font-size: 0.8125rem;
}
.api-guide-table th,
.api-guide-table td {
padding: 0.5rem 0.65rem;
border: 1px solid rgba(0, 0, 0, 0.08);
text-align: left;
vertical-align: top;
}
.api-guide-table th {
background: rgba(253, 189, 219, 0.2);
font-weight: 600;
}
.api-guide-table code {
font-size: 0.75rem;
word-break: break-all;
}
.api-guide-section a:not(.api-guide-btn) {
color: var(--anlian-accent-text);
font-weight: 500;
}
.api-guide-btn {
display: inline-block;
margin-top: 0.75rem;
padding: 0.45rem 1rem;
font-size: 0.875rem;
font-weight: 600;
color: #fff !important;
text-decoration: none !important;
background: var(--anlian-accent-text);
border-radius: var(--anlian-radius-pill);
}
.api-guide-btn:hover {
opacity: 0.9;
}
.api-guide-back {
margin: 0.5rem 0 0;
text-align: center;
font-size: 0.875rem;
}
.api-guide-back a {
color: var(--anlian-text-muted);
text-decoration: none;
}
.api-guide-back a:hover {
color: var(--anlian-accent-text);
text-decoration: underline;
}
@media (max-width: 575.98px) {
.api-guide-table {
display: block;
overflow-x: auto;
}
}
-393
View File
@@ -1,393 +0,0 @@
/*
* @File: base.css
* @Description: 网站全局基础样式文件,本次更新重点优化了导航栏的布局和美观度。
* @Author: Your Name
* @Date: 2023-10-27
* @Update: 2023-10-28 - 优化导航栏颜色方案,并为Logo添加动画效果;新增左右留白容器的响应式样式;修复导航栏与主内容容器重叠问题。
*/
/* --- 1. 全局盒模型与颜色变量设置 --- */
* {
box-sizing: border-box;
padding: 0;
margin: 0;
}
:root {
--custom-primary: #ffffff; /* 主色调:柔和的蓝色 */
--custom-primary-rgb: 93, 127, 229; /* 主色调的RGB值,用于透明度 */
--custom-bg: rgba(255, 255, 255, 0.2); /* 导航栏背景色:半透明白色 */
--custom-text: #333333; /* 主要文字颜色:深灰色,保证可读性 */
--custom-link-hover: #fdbbdb; /* 链接悬停颜色:柔和的紫色 */
--custom-btn-hover-bg: #fdbbdb; /* 按钮悬停背景色:柔和的蓝色 */
/* 新增:宽屏时左右留白的宽度(可根据需求调整) */
--side-gap-width: 120px;
}
/* --- 2. 页面主体样式 --- */
body {
/* ========== 背景图:960w 优化版,避免全尺寸 1232px 浪费带宽 ========== */
background-image: url("/static/img/bg-body-960.webp");
background-repeat: no-repeat;
background-size: cover;
background-position: center center;
background-attachment: fixed;
background-color: #f8f9fa;
/* ========== 核心修改:重构布局流 ========== */
/* 从row改为column,让导航栏+内容区垂直排列 */
display: flex;
flex-direction: column; /* 关键修改1:垂直布局 */
overflow-x: hidden;
overflow-y: auto;
min-height: 100vh;
margin: 0;
position: relative;
z-index: 1;
width: 100vw;
}
/* ========== 毛玻璃效果遮罩层(保留) ========== */
/* body::before {
content: "";
position: absolute;
top: 0;
left: 0;
width: 100%;
height: 100%;
/* backdrop-filter: blur(1px); */
/*background-color: rgba(255, 255, 255, 0.2);
z-index: -1;
background-attachment: fixed;
} */
/* --- 3. 导航栏 (Navbar) 核心美化 --- */
.navbar {
background-color: var(--custom-bg) !important;
backdrop-filter: blur(24px);
border: 1px solid rgba(255, 255, 255, 0.2);
box-shadow: inset 0 0 5px rgba(255, 255, 255, 0.1);
padding-top: 0.75rem;
padding-bottom: 0.75rem;
position: relative;
z-index: 1000;
width: 100%;
}
.navbar-shell {
display: flex;
flex-wrap: wrap;
align-items: center;
width: 100%;
padding-left: 0.5rem;
padding-right: 0.75rem;
}
.navbar-start {
display: flex;
align-items: center;
flex-shrink: 0;
}
.navbar .navbar-collapse {
flex-grow: 1;
}
@media (min-width: 992px) {
.navbar .navbar-collapse {
display: flex !important;
flex-wrap: nowrap;
align-items: center;
justify-content: space-between;
gap: 1rem;
}
}
.navbar-nav-main {
flex-wrap: wrap;
}
.navbar-end {
display: flex;
flex-direction: column;
align-items: stretch;
gap: 0.75rem;
width: 100%;
}
@media (min-width: 992px) {
.navbar-end {
flex-direction: row;
align-items: center;
flex-shrink: 0;
width: auto;
margin-left: auto;
gap: 0.75rem;
}
}
.navbar-search {
gap: 0.5rem;
align-items: center;
}
.navbar-search .form-control {
min-width: 120px;
max-width: 180px;
}
.navbar-auth {
flex-direction: row;
align-items: center;
gap: 0.25rem;
flex-wrap: nowrap;
}
.navbar-auth .nav-link-auth,
.navbar-auth .nav-link-btn {
padding: 0.35rem 0.85rem !important;
border-radius: 999px;
border: 1px solid rgba(var(--custom-primary-rgb), 0.45);
background: rgba(var(--custom-primary-rgb), 0.12);
font-weight: 600;
}
.navbar-auth .nav-link-auth:hover,
.navbar-auth .nav-link-btn:hover {
background: rgba(var(--custom-primary-rgb), 0.22);
transform: none;
}
.navbar-brand {
color: var(--custom-primary) !important;
font-weight: 700;
margin-right: 2rem;
}
@keyframes pulse {
0% { transform: scale(1); }
50% { transform: scale(1.05); }
100% { transform: scale(1); }
}
.navbar-logo {
padding-top: 0.3125rem;
padding-bottom: 0.3125rem;
padding-left: 0.75rem;
padding-right: 0.25rem;
animation: pulse 3s ease-in-out infinite;
}
.navbar-dark .nav-link {
color: var(--custom-text) !important;
margin-left: 0.5rem;
margin-right: 0.5rem;
transition: color 0.2s ease-in-out, transform 0.2s ease-in-out;
}
.navbar-dark .nav-link:hover {
color: var(--custom-link-hover) !important;
transform: translateY(-2px);
}
.navbar-search .form-control {
padding-top: 0.5rem;
padding-bottom: 0.5rem;
border-radius: 0.375rem;
outline: none;
transition: box-shadow 0.2s ease-in-out, border-color 0.2s ease-in-out;
}
.navbar-search .form-control:focus {
border-color: rgba(var(--custom-primary-rgb), 0.5);
box-shadow: 0 0 0 0.2rem rgba(var(--custom-primary-rgb), 0.25);
}
.navbar-search .btn-outline-success {
color: var(--custom-primary);
border-color: var(--custom-primary);
padding-top: 0.5rem;
padding-bottom: 0.5rem;
white-space: nowrap;
transition: all 0.2s ease-in-out;
}
.navbar-search .btn-outline-success:hover {
background-color: var(--custom-btn-hover-bg);
border-color: var(--custom-btn-hover-bg);
color: #fff;
}
@media (max-width: 991.98px) {
.navbar-search {
width: 100%;
}
.navbar-search .form-control {
flex: 1;
max-width: none;
}
.navbar-auth {
justify-content: flex-start;
padding-top: 0.25rem;
}
}
/* --- 6. 主要内容区域样式 --- */
/* .main-container {
/* 调整:主内容容器在横向flex中占剩余空间 */
/*flex: 1;
/* 关键修改3:移除多余的padding-top,因为导航栏已回归文档流,无需遮挡补偿 */
/*padding-bottom: 4rem;
/* 限制主内容最大宽度,保证阅读体验 */
/*max-width: 1200px;*/
/* 让主内容在content-wrapper中居中(配合左右留白) */
/*margin: 0 auto;
/* 左右内边距,适配窄屏 */
/* padding-left: 1rem;
padding-right: 1rem;
/* 毛玻璃效果(保留) */
/* background-color: rgba(255, 255, 255, 0.1);
backdrop-filter: blur(0px);
border: 1px solid rgba(255, 255, 255, 0.2);
box-shadow: inset 0 0 5px rgba(255, 255, 255, 0.1);
border-radius: 4px;
padding: 50px 100px; */
/* 新增:给主内容容器添加顶部外边距,增加与导航栏的间距 */
/*margin-top: 2rem; */
/*} */
/* --- 7. 左右留白容器样式 (核心需求,适配新布局) ---
.left-container, .right-container {
/* 窄屏时宽度为0,不显示留白 */
/*width: 0;
/* 不占用空间 */
/*flex-shrink: 0;
/* 背景色和页面主体一致,视觉上是留白 */
/*background-color: transparent;
} */
/* 宽屏断点(和Bootstrap lg断点一致:992px) */
/* @media (min-width: 992px) {
/* 宽屏时显示左右留白 */
/* .left-container, .right-container {
/* 使用自定义变量设置留白宽度,可灵活调整 */
/*width: var(--side-gap-width);
background-color: transparent;
/* 可选:添加轻微阴影,增强层次感 */
/*box-shadow: inset 0 0 8px rgba(0, 0, 0, 0.02);*/
/*} */
/* 可选:超宽屏(比如1600px以上)时,限制留白最大宽度 */
/*@media (min-width: 1600px) {
.left-container, .right-container {
width: calc((100vw - 1200px) / 2);
max-width: 200px;
background-color: transparent;
}
}
} */
/* 2. 主体容器样式:确保和footer分隔 */
.main-container {
/* 主体容器宽度自适应,可根据需求调整最大宽度 */
width: 100%;
/* 居中显示(可选) */
margin: 0 auto;
/* 关键:给主体底部加间距,和footer分开 */
margin-bottom: 1rem;
/* 主体内边距,防止内容贴边 */
padding: 1rem;
}
/* --- 页脚 (Footer) 样式 - 毛玻璃效果 + 适配新增内容 --- */
.footer {
/* 核心毛玻璃效果 */
background-color: rgba(255, 255, 255, 0.3);
backdrop-filter: blur(12px);
-webkit-backdrop-filter: blur(12px); /* 兼容webkit内核浏览器 */
border: 1px solid rgba(255, 255, 255, 0.1); /* 浅白色边框增强质感 */
box-shadow: inset 0 0 10px rgba(255, 255, 255, 0.05); /* 内阴影提升层次 */
/* 布局样式 - 回归文档流,不脱离 */
position: static;
width: 100%;
padding: 1.5rem 1rem; /* 上下内边距充足,容纳多行内容 */
margin-top: 2rem; /* 与上方内容分隔 */
height: auto; /* 高度自适应内容,不挤压 */
/* 内容排版 - 垂直分布,居中对齐 */
display: flex;
flex-direction: column;
align-items: center;
gap: 0.75rem; /* 各子元素之间的间距 */
/* 文字基础样式 */
color: #ffffff !important;
font-size: 14px;
}
/* footer logo样式 */
.footer-logo {
margin-bottom: 0.25rem; /* 与版权信息轻微分隔 */
}
.footer-logo img {
border-radius: 50%; /* logo圆形化(可选) */
transition: transform 0.2s ease-in-out;
}
.footer-logo img:hover {
transform: scale(1.1); /* logo悬浮轻微放大 */
}
/* 版权信息容器 */
.footer-container {
text-align: center;
color: rgba(255, 255, 255, 0.9); /* 文字半透,更柔和 */
}
/* 联系我们链接 */
.footer-contact a {
color: rgba(255, 255, 255, 0.9) !important;
text-decoration: none;
padding: 0.25rem 0.75rem;
border-radius: 4px;
transition: all 0.2s ease-in-out;
}
.footer-contact a:hover {
color: #ffffff !important;
background-color: rgba(255, 255, 255, 0.15);
text-decoration: underline;
}
/* 作者信息样式 */
.footer-author {
color: rgba(255, 255, 255, 0.7); /* 作者信息稍淡,突出层级 */
font-size: 13px;
}
.footer-author a {
color: rgba(255, 255, 255, 0.85) !important;
text-decoration: none;
transition: color 0.2s ease-in-out;
}
.footer-author a:hover {
color: #ffffff !important;
text-decoration: underline;
}
/* 响应式适配 - 小屏幕优化 */
@media (max-width: 575.98px) {
.footer {
padding: 1rem 0.5rem;
gap: 0.5rem;
}
.footer-author {
font-size: 12px;
}
}
-670
View File
@@ -1,670 +0,0 @@
/**
* 聊天模块 — 与论坛 feed 粉色毛玻璃主题统一
*/
.chat-page {
--chat-accent: #fdbbdb;
--chat-accent-text: #a85878;
--chat-accent-muted: #c97a96;
--chat-text: #333;
--chat-text-muted: #666;
--chat-glass: rgba(255, 255, 255, 0.32);
--chat-glass-border: rgba(255, 255, 255, 0.45);
--chat-shadow: 0 4px 16px rgba(253, 189, 219, 0.08);
}
.chat-page .section-wrap.chat-stage {
padding: 2rem 2.5rem 2.5rem;
}
.chat-page .section-wrap.chat-stage-narrow {
max-width: 640px;
margin-left: auto;
margin-right: auto;
}
.feed-list-title.chat-room-title {
margin-bottom: 0;
text-align: left;
border-bottom: none;
padding-bottom: 0;
flex: 1;
min-width: 0;
}
.chat-page-lead {
margin: 0.75rem 0 1rem;
font-size: 0.9375rem;
line-height: 1.65;
color: var(--chat-text-muted);
text-align: center;
}
.chat-room-desc {
text-align: left;
margin-bottom: 0.75rem;
}
.chat-breadcrumb {
display: flex;
flex-wrap: wrap;
align-items: center;
gap: 0.35rem;
margin-bottom: 1rem;
font-size: 0.8125rem;
color: var(--chat-text-muted);
}
.chat-breadcrumb a {
color: var(--chat-accent-muted);
text-decoration: none;
}
.chat-breadcrumb a:hover {
color: var(--chat-accent-text);
}
.chat-breadcrumb-sep {
opacity: 0.45;
}
.chat-breadcrumb-current {
color: var(--chat-text);
font-weight: 500;
}
.chat-room-header {
display: flex;
flex-wrap: wrap;
align-items: center;
justify-content: space-between;
gap: 0.75rem;
margin-bottom: 0.5rem;
padding-bottom: 0.75rem;
border-bottom: 1px solid rgba(255, 255, 255, 0.45);
}
.chat-room-meta {
margin: 0 0 1.25rem;
font-size: 0.8125rem;
color: var(--chat-text-muted);
}
.chat-room-meta a {
color: var(--chat-accent-text);
text-decoration: none;
font-weight: 600;
}
.chat-room-meta a:hover {
text-decoration: underline;
}
.chat-actions {
display: flex;
flex-wrap: wrap;
gap: 0.75rem;
justify-content: center;
margin-bottom: 1.25rem;
}
.chat-room-search {
display: flex;
flex-wrap: wrap;
gap: 0.65rem;
margin-bottom: 1.25rem;
}
.chat-room-search-input {
flex: 1;
min-width: 0;
min-height: 42px;
padding: 0.55rem 0.9rem;
border: 1px solid rgba(253, 189, 219, 0.45);
border-radius: 999px;
background: rgba(255, 255, 255, 0.72);
color: var(--chat-text);
font-size: 0.9375rem;
}
.chat-room-search-input:focus {
outline: none;
border-color: rgba(253, 189, 219, 0.75);
box-shadow: 0 0 0 3px rgba(253, 189, 219, 0.22);
}
.chat-room-search-input::placeholder {
color: #aaa;
}
.chat-room-search-btn {
flex-shrink: 0;
padding: 0.55rem 1.1rem;
border: 1px solid rgba(253, 189, 219, 0.55);
border-radius: 999px;
background: rgba(253, 189, 219, 0.35);
color: var(--chat-accent-text);
font-size: 0.875rem;
font-weight: 600;
cursor: pointer;
transition: background 0.2s ease;
}
.chat-room-search-btn:hover {
background: rgba(253, 189, 219, 0.5);
}
.chat-list-footer {
display: flex;
justify-content: center;
margin-top: 1.5rem;
padding-top: 1.25rem;
border-top: 1px solid rgba(255, 255, 255, 0.45);
}
.chat-create-room-btn {
display: inline-flex;
align-items: center;
justify-content: center;
gap: 0.65rem;
width: min(100%, 320px);
padding: 0.85rem 1.35rem;
border-radius: 999px;
text-decoration: none;
color: #fff;
font-size: 0.9375rem;
font-weight: 600;
border: 1px solid rgba(255, 255, 255, 0.35);
background: linear-gradient(135deg, #f0a8c4 0%, #a85878 100%);
box-shadow:
0 6px 20px rgba(168, 88, 120, 0.28),
inset 0 1px 0 rgba(255, 255, 255, 0.25);
transition: transform 0.15s ease, box-shadow 0.15s ease, filter 0.15s ease;
}
.chat-create-room-btn:hover {
color: #fff;
text-decoration: none;
transform: translateY(-1px);
box-shadow:
0 8px 24px rgba(168, 88, 120, 0.34),
inset 0 1px 0 rgba(255, 255, 255, 0.3);
filter: brightness(1.03);
}
.chat-create-room-btn:active {
transform: translateY(0);
}
.chat-create-room-btn__icon {
display: inline-flex;
align-items: center;
justify-content: center;
width: 1.75rem;
height: 1.75rem;
border-radius: 50%;
font-size: 0.8125rem;
background: rgba(255, 255, 255, 0.22);
}
.chat-search-empty {
margin-top: 0.5rem;
}
.chat-action-link {
display: inline-flex;
align-items: center;
}
.chat-ws-status {
flex-shrink: 0;
font-size: 0.75rem;
font-weight: 500;
padding: 0.2rem 0.65rem;
border-radius: 999px;
color: var(--chat-accent-muted);
background: rgba(255, 255, 255, 0.35);
border: 1px solid rgba(253, 189, 219, 0.35);
}
.chat-ws-status-ok {
color: #3d7a52;
background: rgba(144, 238, 144, 0.2);
border-color: rgba(144, 238, 144, 0.45);
}
.chat-ws-status-error {
color: #a85858;
background: rgba(255, 182, 193, 0.25);
border-color: rgba(255, 160, 160, 0.45);
}
.chat-ws-errors {
margin: 0.5rem 0 0;
color: #a85858;
font-size: 0.875rem;
}
/* ---------- 消息区 ---------- */
.chat-messages {
display: flex;
flex-direction: column;
gap: 0.85rem;
margin-bottom: 1.25rem;
padding: 1rem;
border-radius: 14px;
background: var(--chat-glass);
backdrop-filter: blur(12px);
-webkit-backdrop-filter: blur(12px);
border: 1px solid var(--chat-glass-border);
box-shadow: var(--chat-shadow);
min-height: 240px;
max-height: min(60vh, 520px);
overflow-y: auto;
}
.chat-message {
display: flex;
gap: 0.75rem;
align-items: flex-start;
}
.chat-message-mine {
flex-direction: row-reverse;
}
.chat-message-mine .chat-message-body {
text-align: right;
}
.chat-avatar {
width: 40px;
height: 40px;
border-radius: 50%;
object-fit: cover;
flex-shrink: 0;
border: 2px solid rgba(255, 255, 255, 0.65);
box-shadow: 0 2px 8px rgba(253, 189, 219, 0.15);
}
.chat-message-body {
flex: 1;
min-width: 0;
padding: 0.6rem 0.75rem;
border: 1px solid rgba(253, 189, 219, 0.4);
border-radius: 10px;
background: rgba(255, 255, 255, 0.35);
}
.chat-message-mine .chat-message-body {
border-color: rgba(240, 168, 196, 0.55);
background: rgba(253, 189, 219, 0.22);
}
.chat-message-meta {
display: flex;
flex-wrap: wrap;
align-items: center;
gap: 0.5rem;
font-size: 0.75rem;
color: var(--chat-text-muted);
margin-bottom: 0.35rem;
}
.chat-message-mine .chat-message-meta {
justify-content: flex-end;
}
.chat-author {
color: var(--chat-text);
font-weight: 600;
}
.chat-profile-link {
color: var(--chat-accent-text);
text-decoration: none;
font-weight: 500;
}
.chat-profile-link:hover {
text-decoration: underline;
}
.chat-content {
margin: 0;
white-space: pre-wrap;
word-break: break-word;
font-size: 0.9375rem;
line-height: 1.55;
color: var(--chat-text);
}
.chat-compose {
margin-top: 0.5rem;
}
/* ---------- 列表 / 分页 ---------- */
.chat-room-grid {
display: grid;
grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
gap: 1rem;
}
.chat-room-card {
display: block;
padding: 1.15rem;
border-radius: 14px;
background: var(--chat-glass);
backdrop-filter: blur(10px);
-webkit-backdrop-filter: blur(10px);
border: 1px solid rgba(253, 189, 219, 0.35);
color: inherit;
text-decoration: none;
transition: transform 0.15s ease, box-shadow 0.15s ease;
}
.chat-room-card:hover {
transform: translateY(-2px);
box-shadow: 0 4px 14px rgba(253, 189, 219, 0.2);
color: inherit;
}
.chat-room-card h2 {
margin: 0 0 0.5rem;
font-size: 1.05rem;
color: var(--chat-text);
}
.chat-room-card p {
margin: 0;
color: var(--chat-text-muted);
font-size: 0.875rem;
}
.chat-pagination {
display: flex;
justify-content: center;
align-items: center;
flex-wrap: wrap;
gap: 0.75rem;
margin-bottom: 1rem;
font-size: 0.875rem;
}
.chat-pagination-link {
padding: 0.35rem 0.85rem;
border-radius: 999px;
text-decoration: none;
color: var(--chat-accent-text);
background: rgba(253, 189, 219, 0.25);
border: 1px solid rgba(253, 189, 219, 0.4);
}
.chat-pagination-link:hover {
background: rgba(253, 189, 219, 0.4);
color: var(--chat-accent-text);
}
.chat-pagination-info {
color: var(--chat-text-muted);
}
/* ---------- 私聊收件箱 ---------- */
.feed-list-title.chat-inbox-title {
margin-bottom: 0;
text-align: left;
border-bottom: none;
padding-bottom: 0;
}
.chat-inbox-header {
display: flex;
flex-wrap: wrap;
align-items: center;
justify-content: space-between;
gap: 0.75rem;
margin-bottom: 1.25rem;
padding-bottom: 0.75rem;
border-bottom: 1px solid rgba(255, 255, 255, 0.45);
}
.chat-inbox-new-btn {
display: inline-flex;
align-items: center;
gap: 0.45rem;
padding: 0.5rem 1rem;
border-radius: 999px;
font-size: 0.8125rem;
font-weight: 600;
text-decoration: none;
color: var(--chat-accent-text);
background: rgba(253, 189, 219, 0.28);
border: 1px solid rgba(253, 189, 219, 0.45);
transition: background 0.2s ease, box-shadow 0.2s ease;
}
.chat-inbox-new-btn:hover {
color: var(--chat-accent-text);
background: rgba(253, 189, 219, 0.42);
box-shadow: 0 4px 12px rgba(253, 189, 219, 0.2);
}
.chat-inbox-panel {
padding: 0.85rem;
border-radius: 14px;
background: var(--chat-glass);
backdrop-filter: blur(12px);
-webkit-backdrop-filter: blur(12px);
border: 1px solid var(--chat-glass-border);
box-shadow: var(--chat-shadow);
}
.chat-inbox-panel--compact {
padding: 0.65rem;
}
.chat-inbox-list {
list-style: none;
margin: 0;
padding: 0;
}
.chat-inbox-list li + li {
margin-top: 0.5rem;
}
.chat-inbox-item {
display: flex;
align-items: center;
gap: 0.75rem;
padding: 0.75rem 0.85rem;
border-radius: 12px;
text-decoration: none;
color: var(--chat-text);
background: rgba(255, 255, 255, 0.28);
border: 1px solid rgba(253, 189, 219, 0.22);
transition: background 0.15s ease, border-color 0.15s ease;
}
.chat-inbox-item:hover {
background: rgba(253, 189, 219, 0.18);
border-color: rgba(253, 189, 219, 0.38);
color: var(--chat-text);
}
.chat-inbox-avatar {
flex-shrink: 0;
width: 44px;
height: 44px;
border-radius: 50%;
object-fit: cover;
border: 2px solid rgba(255, 255, 255, 0.7);
box-shadow: 0 2px 8px rgba(253, 189, 219, 0.15);
}
.chat-inbox-body {
flex: 1;
min-width: 0;
display: flex;
flex-direction: column;
gap: 0.2rem;
}
.chat-inbox-top {
display: flex;
align-items: baseline;
justify-content: space-between;
gap: 0.5rem;
}
.chat-inbox-name {
font-size: 0.9375rem;
font-weight: 600;
color: var(--chat-accent-text);
}
.chat-inbox-time {
flex-shrink: 0;
font-size: 0.75rem;
color: var(--chat-text-muted);
}
.chat-inbox-preview {
display: block;
font-size: 0.8125rem;
line-height: 1.45;
color: var(--chat-text-muted);
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
}
.chat-inbox-arrow {
flex-shrink: 0;
font-size: 0.75rem;
color: var(--chat-accent-muted);
opacity: 0.75;
}
.chat-inbox-empty {
display: flex;
flex-direction: column;
align-items: center;
justify-content: center;
gap: 0.65rem;
padding: 2.5rem 1.25rem;
text-align: center;
}
.chat-inbox-empty-icon {
display: inline-flex;
align-items: center;
justify-content: center;
width: 3.25rem;
height: 3.25rem;
border-radius: 50%;
font-size: 1.25rem;
color: var(--chat-accent-muted);
background: rgba(253, 189, 219, 0.22);
border: 1px solid rgba(253, 189, 219, 0.35);
}
.chat-inbox-empty-title {
margin: 0;
font-size: 1rem;
font-weight: 600;
color: var(--chat-text);
}
.chat-inbox-empty-lead {
margin: 0;
max-width: 18rem;
font-size: 0.875rem;
line-height: 1.55;
color: var(--chat-text-muted);
}
.chat-inbox-empty-btn {
display: inline-flex;
align-items: center;
gap: 0.45rem;
margin-top: 0.35rem;
padding: 0.65rem 1.25rem;
border-radius: 999px;
font-size: 0.875rem;
font-weight: 600;
text-decoration: none;
color: #fff;
background: linear-gradient(135deg, #f0a8c4 0%, #a85878 100%);
border: 1px solid rgba(255, 255, 255, 0.3);
box-shadow: 0 4px 14px rgba(168, 88, 120, 0.25);
transition: transform 0.15s ease, box-shadow 0.15s ease;
}
.chat-inbox-empty-btn:hover {
color: #fff;
transform: translateY(-1px);
box-shadow: 0 6px 18px rgba(168, 88, 120, 0.32);
}
.chat-thread-list {
list-style: none;
padding: 0;
margin: 0;
}
.chat-thread-list li + li {
margin-top: 0.5rem;
}
.chat-thread-list a {
display: flex;
justify-content: space-between;
align-items: center;
padding: 0.85rem 1rem;
border-radius: 12px;
background: var(--chat-glass);
border: 1px solid rgba(253, 189, 219, 0.3);
color: var(--chat-text);
text-decoration: none;
}
.chat-thread-list a:hover {
background: rgba(253, 189, 219, 0.2);
}
.chat-thread-time {
font-size: 0.8125rem;
color: var(--chat-text-muted);
}
.chat-empty,
.chat-login-hint {
color: var(--chat-text-muted);
text-align: center;
}
.chat-empty a,
.chat-login-hint a {
color: var(--chat-accent-text);
font-weight: 600;
}
@media (max-width: 768px) {
.chat-page .section-wrap.chat-stage {
padding: 1.5rem 1.25rem 2rem;
}
.feed-list-title.chat-room-title {
font-size: 1.25rem;
}
}
@media (max-width: 640px) {
.chat-messages {
max-height: none;
}
}
@@ -1,212 +0,0 @@
/* 详情页:箭头上一篇/下一篇 + 推荐阅读轮播 */
.detail-reading-extras {
margin-bottom: 2rem;
display: flex;
flex-direction: column;
gap: 1.25rem;
}
.detail-adjacent-nav,
.detail-recommend {
padding: 1rem 1.25rem !important;
margin: 0 !important;
}
/* --- 上一篇 / 下一篇:左右箭头 --- */
.detail-adjacent-bar {
display: flex;
align-items: stretch;
justify-content: space-between;
gap: 0.75rem;
}
.detail-adjacent-side {
display: flex;
align-items: center;
gap: 0.5rem;
min-width: 0;
flex: 1;
}
.detail-adjacent-side-prev {
justify-content: flex-start;
}
.detail-adjacent-side-next {
justify-content: flex-end;
text-align: right;
}
.detail-arrow-btn {
flex-shrink: 0;
display: inline-flex;
align-items: center;
justify-content: center;
width: 2.25rem;
height: 2.25rem;
border-radius: 50%;
background: linear-gradient(145deg, #fdbbdb, #f0a8c4);
color: #fff;
text-decoration: none;
box-shadow: 0 2px 8px rgba(168, 88, 120, 0.25);
transition: transform 0.2s ease, box-shadow 0.2s ease;
}
.detail-arrow-btn:hover {
transform: scale(1.06);
box-shadow: 0 4px 12px rgba(168, 88, 120, 0.35);
color: #fff;
}
.detail-arrow-btn.is-disabled {
background: rgba(0, 0, 0, 0.08);
color: #bbb;
box-shadow: none;
cursor: default;
pointer-events: none;
}
.detail-adjacent-title {
color: #333;
text-decoration: none;
font-weight: 600;
font-size: 0.9rem;
line-height: 1.4;
overflow: hidden;
text-overflow: ellipsis;
display: -webkit-box;
-webkit-line-clamp: 2;
-webkit-box-orient: vertical;
}
.detail-adjacent-title:hover {
color: #a85878;
}
/* --- 推荐阅读轮播 --- */
.detail-recommend-heading {
margin: 0 0 0.85rem;
font-size: 0.95rem;
font-weight: 700;
color: #a85878;
letter-spacing: 0.02em;
}
.detail-recommend-viewport {
overflow: hidden;
border-radius: 12px;
}
.detail-recommend-track {
display: flex;
align-items: stretch;
transition: transform 0.45s cubic-bezier(0.4, 0, 0.2, 1);
will-change: transform;
}
.detail-recommend-slide {
flex: 0 0 100%;
box-sizing: border-box;
padding: 0 0.15rem;
display: flex;
align-items: stretch;
}
.detail-recommend-card {
display: flex;
flex-direction: column;
flex: 1;
width: 100%;
gap: 0.35rem;
padding: 1rem 1.1rem;
border-radius: 12px;
background: rgba(255, 255, 255, 0.55);
border: 1px solid rgba(255, 255, 255, 0.65);
text-decoration: none;
transition: background 0.2s ease, border-color 0.2s ease;
}
.detail-recommend-card:hover {
background: rgba(255, 255, 255, 0.82);
border-color: rgba(253, 187, 219, 0.8);
}
.detail-recommend-card-title {
flex: 1 1 auto;
color: #222;
font-weight: 600;
font-size: 0.95rem;
line-height: 1.45;
/* 固定两行高度,短标题与长标题卡片等高 */
min-height: calc(0.95rem * 1.45 * 2);
overflow: hidden;
text-overflow: ellipsis;
display: -webkit-box;
-webkit-line-clamp: 2;
-webkit-box-orient: vertical;
}
.detail-recommend-card-meta {
flex-shrink: 0;
margin-top: auto;
font-size: 0.78rem;
color: #888;
}
.detail-recommend-dots {
display: flex;
justify-content: center;
align-items: center;
gap: 0.45rem;
margin-top: 0.85rem;
padding-bottom: 0.15rem;
}
.detail-recommend-dot {
width: 0.45rem;
height: 0.45rem;
padding: 0;
border: none;
border-radius: 50%;
background: rgba(168, 88, 120, 0.25);
cursor: pointer;
transition: transform 0.2s ease, background 0.2s ease;
}
.detail-recommend-dot:hover {
background: rgba(168, 88, 120, 0.45);
}
.detail-recommend-dot.is-active {
background: #a85878;
transform: scale(1.25);
}
@media (min-width: 768px) {
.detail-recommend-slide {
flex: 0 0 50%;
}
.detail-adjacent-title {
font-size: 0.92rem;
-webkit-line-clamp: 1;
}
}
@media (max-width: 767.98px) {
.detail-adjacent-bar {
flex-direction: column;
gap: 0.65rem;
}
.detail-adjacent-side-next {
text-align: left;
justify-content: flex-start;
flex-direction: row-reverse;
}
.detail-adjacent-side-prev {
flex-direction: row;
}
}
@@ -1,459 +0,0 @@
/**
* 帖子/新闻列表共用:粉色毛玻璃分段板块 + 横向卡片
* 用于首页 .home-posts 与独立列表页 .feed-list-page
*/
.home-posts,
.feed-list-page {
--post-accent: #fdbbdb;
--post-accent-deep: #f0a8c4;
--post-accent-text: #a85878;
--post-accent-muted: #c97a96;
--post-accent-bg: rgba(253, 189, 219, 0.48);
}
/* ---------- 板块栏(强制单行:左箭头 | 可滚动 Tab | 右箭头) ---------- */
.home-posts-board-bar,
.feed-list-page .feed-board-bar {
display: flex;
flex-direction: row;
flex-wrap: nowrap;
align-items: center;
justify-content: flex-start;
gap: 0.5rem;
margin-bottom: 1.25rem;
width: 100%;
max-width: 100%;
min-width: 0;
box-sizing: border-box;
}
.home-posts-segment-outer,
.feed-list-page .feed-segment-outer {
flex: 1 1 0%;
min-width: 0;
width: 0;
display: block;
overflow: hidden;
}
.home-posts-segment,
.feed-list-page .feed-segment {
position: relative;
display: flex;
width: 100%;
max-width: 100%;
min-width: 0;
box-sizing: border-box;
padding: 4px;
border-radius: 999px;
background: rgba(255, 255, 255, 0.28);
backdrop-filter: blur(18px);
-webkit-backdrop-filter: blur(18px);
border: 1px solid rgba(255, 255, 255, 0.5);
box-shadow:
0 4px 20px rgba(253, 189, 219, 0.12),
inset 0 1px 0 rgba(255, 255, 255, 0.35);
}
.home-posts-spotlight,
.feed-list-page .feed-spotlight {
position: absolute;
top: 4px;
bottom: 4px;
left: 0;
width: var(--spot-w, 4rem);
border-radius: 999px;
background: var(--post-accent-bg);
border: 1px solid rgba(240, 168, 196, 0.55);
box-shadow: 0 2px 14px rgba(253, 189, 219, 0.35);
transform: translateX(var(--spot-l, 0));
transition:
transform 0.28s cubic-bezier(0.34, 1.2, 0.64, 1),
width 0.28s cubic-bezier(0.34, 1.2, 0.64, 1);
pointer-events: none;
z-index: 0;
}
.home-posts-tabs-scroll,
.feed-list-page .feed-tabs-scroll {
position: relative;
z-index: 1;
width: 100%;
min-width: 0;
overflow-x: auto;
overflow-y: hidden;
max-width: 100%;
scroll-behavior: smooth;
-ms-overflow-style: none;
scrollbar-width: none;
mask-image: linear-gradient(
to right,
transparent,
#000 12px,
#000 calc(100% - 12px),
transparent
);
}
.home-posts-tabs-scroll::-webkit-scrollbar,
.feed-list-page .feed-tabs-scroll::-webkit-scrollbar {
display: none;
}
.home-posts-tabs,
.feed-list-page .feed-tabs {
display: flex;
flex-wrap: nowrap;
gap: 2px;
padding: 0 2px;
}
.home-posts-tab,
.feed-list-page .feed-tab {
flex-shrink: 0;
padding: 0.4rem 1rem;
border-radius: 999px;
font-size: 0.8125rem;
font-weight: 500;
text-decoration: none;
color: #555;
background: transparent;
border: 1px solid transparent;
transition: color 0.2s ease;
white-space: nowrap;
}
.home-posts-tab:hover,
.feed-list-page .feed-tab:hover {
color: var(--post-accent-text);
}
.home-posts-tab.active,
.feed-list-page .feed-tab.active {
color: var(--post-accent-text);
font-weight: 600;
}
.home-posts-tab-more {
background: rgba(253, 189, 219, 0.32);
border-color: rgba(253, 189, 219, 0.45);
color: var(--post-accent-text);
}
.home-posts-tab-more:hover {
background: rgba(253, 189, 219, 0.48);
color: var(--post-accent-text);
}
.home-posts-scroll,
.feed-list-page .feed-scroll {
flex: 0 0 32px;
width: 32px;
min-width: 32px;
max-width: 32px;
height: 32px;
padding: 0;
margin: 0;
display: inline-flex;
align-items: center;
justify-content: center;
border: 1px solid rgba(255, 255, 255, 0.5);
border-radius: 50%;
background: rgba(255, 255, 255, 0.35);
backdrop-filter: blur(10px);
color: var(--post-accent-text);
cursor: pointer;
transition: background 0.2s, transform 0.2s, opacity 0.2s;
box-sizing: border-box;
-webkit-appearance: none;
appearance: none;
}
.home-posts-scroll:hover,
.feed-list-page .feed-scroll:hover {
background: rgba(253, 189, 219, 0.35);
transform: scale(1.05);
}
.home-posts-scroll:disabled,
.home-posts-scroll.is-hidden,
.feed-list-page .feed-scroll.is-hidden {
opacity: 0.3;
pointer-events: none;
transform: none;
/* 仍占位,避免板块栏折行 */
visibility: visible;
flex: 0 0 32px;
width: 32px;
min-width: 32px;
}
/* ---------- 帖子卡片列表 ---------- */
.home-posts-list,
.feed-list-page .feed-posts-list {
list-style: none;
margin: 0;
padding: 0;
display: flex;
flex-direction: column;
gap: 0.65rem;
}
.home-post-card,
.feed-list-page .feed-post-card {
border-radius: 14px;
background: rgba(255, 255, 255, 0.32);
backdrop-filter: blur(12px);
-webkit-backdrop-filter: blur(12px);
border: 1px solid rgba(255, 255, 255, 0.42);
box-shadow: 0 4px 16px rgba(253, 189, 219, 0.08);
transition: transform 0.2s ease, box-shadow 0.2s ease, background 0.2s ease;
}
.home-post-card:hover,
.feed-list-page .feed-post-card:hover {
transform: translateY(-2px);
background: rgba(255, 255, 255, 0.42);
box-shadow: 0 8px 24px rgba(253, 189, 219, 0.18);
}
.home-post-card-link,
.feed-list-page .feed-post-card-link {
display: grid;
grid-template-columns: auto 1fr auto;
align-items: center;
gap: 0.75rem 1rem;
padding: 0.75rem 1rem;
text-decoration: none;
color: inherit;
}
.home-post-board,
.feed-list-page .feed-post-board {
flex-shrink: 0;
padding: 0.2rem 0.55rem;
border-radius: 6px;
font-size: 0.6875rem;
font-weight: 600;
color: var(--post-accent-text);
background: rgba(253, 189, 219, 0.28);
white-space: nowrap;
max-width: 5rem;
overflow: hidden;
text-overflow: ellipsis;
}
.home-post-body,
.feed-list-page .feed-post-body {
min-width: 0;
}
.home-post-title,
.feed-list-page .feed-post-title {
margin: 0 0 0.3rem;
font-size: 0.9375rem;
font-weight: 600;
color: #222;
line-height: 1.35;
display: -webkit-box;
-webkit-box-orient: vertical;
-webkit-line-clamp: 1;
overflow: hidden;
}
.home-post-meta,
.feed-list-page .feed-post-meta {
display: flex;
flex-wrap: wrap;
align-items: center;
gap: 0.5rem 0.85rem;
font-size: 0.75rem;
color: #666;
}
.home-post-meta-item,
.feed-list-page .feed-post-meta-item {
display: inline-flex;
align-items: center;
gap: 0.25rem;
}
.home-post-meta i,
.feed-list-page .feed-post-meta i {
font-size: 0.7rem;
opacity: 0.75;
}
.home-post-meta time,
.feed-list-page .feed-post-meta time {
color: var(--post-accent-muted);
}
.home-post-arrow,
.feed-list-page .feed-post-arrow {
color: rgba(253, 189, 219, 0.9);
font-size: 0.75rem;
opacity: 0.7;
transition: opacity 0.2s, transform 0.2s;
}
.home-post-card:hover .home-post-arrow,
.feed-list-page .feed-post-card:hover .feed-post-arrow {
opacity: 1;
transform: translateX(2px);
}
.home-posts-empty,
.feed-list-page .feed-empty {
text-align: center;
padding: 2rem;
color: #666;
}
.home-posts-more-link {
display: block;
width: fit-content;
margin: 1rem auto 0;
padding: 0.45rem 1.25rem;
border-radius: 999px;
font-size: 0.8125rem;
font-weight: 600;
text-decoration: none;
color: var(--post-accent-text);
background: rgba(253, 189, 219, 0.35);
border: 1px solid rgba(253, 189, 219, 0.55);
transition: background 0.2s, box-shadow 0.2s;
}
.home-posts-more-link:hover {
background: rgba(253, 189, 219, 0.5);
box-shadow: 0 4px 14px rgba(253, 189, 219, 0.25);
}
/* ---------- 新闻列表卡片(横向胶囊风格,静态列表) ---------- */
.feed-list-page .feed-news-list {
list-style: none;
margin: 0;
padding: 0;
display: flex;
flex-direction: column;
gap: 0.65rem;
}
.feed-list-page .feed-news-card {
border-radius: 14px;
background: rgba(255, 255, 255, 0.32);
backdrop-filter: blur(12px);
-webkit-backdrop-filter: blur(12px);
border: 1px solid rgba(255, 255, 255, 0.42);
box-shadow: 0 4px 16px rgba(253, 189, 219, 0.08);
transition: transform 0.2s ease, box-shadow 0.2s ease, background 0.2s ease;
}
.feed-list-page .feed-news-card:hover {
transform: translateY(-2px);
background: rgba(255, 255, 255, 0.42);
box-shadow: 0 8px 24px rgba(253, 189, 219, 0.18);
}
.feed-list-page .feed-news-card-link {
display: grid;
grid-template-columns: auto 1fr auto;
align-items: center;
gap: 0.75rem 1rem;
padding: 0.75rem 1rem;
text-decoration: none;
color: inherit;
}
.feed-list-page .feed-news-side {
flex-shrink: 0;
display: flex;
flex-direction: column;
align-items: flex-start;
gap: 0.15rem;
padding-right: 0.65rem;
border-right: 1px solid rgba(253, 189, 219, 0.35);
min-width: 4.5rem;
}
.feed-list-page .feed-news-date {
font-size: 0.6875rem;
font-weight: 700;
color: var(--post-accent-muted);
white-space: nowrap;
}
.feed-list-page .feed-news-board {
font-size: 0.625rem;
font-weight: 600;
color: var(--post-accent-text);
background: rgba(253, 189, 219, 0.22);
padding: 0.12rem 0.35rem;
border-radius: 3px;
max-width: 5.5rem;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
@media (max-width: 576px) {
.home-posts-board-bar,
.feed-list-page .feed-board-bar {
gap: 0.35rem;
}
.home-posts-scroll,
.feed-list-page .feed-scroll {
flex: 0 0 28px;
width: 28px;
min-width: 28px;
max-width: 28px;
height: 28px;
font-size: 0.7rem;
}
.home-posts-scroll.is-hidden,
.feed-list-page .feed-scroll.is-hidden {
flex: 0 0 28px;
width: 28px;
min-width: 28px;
}
.home-posts-tab,
.feed-list-page .feed-tab {
padding: 0.35rem 0.7rem;
font-size: 0.75rem;
}
.home-post-card-link,
.feed-list-page .feed-post-card-link,
.feed-list-page .feed-news-card-link {
grid-template-columns: 1fr auto;
grid-template-rows: auto auto;
}
.home-post-board,
.feed-list-page .feed-post-board,
.feed-list-page .feed-news-side {
grid-column: 1;
justify-self: start;
border-right: none;
padding-right: 0;
flex-direction: row;
gap: 0.35rem;
}
.home-post-body,
.feed-list-page .feed-post-body {
grid-column: 1;
}
.home-post-arrow,
.feed-list-page .feed-post-arrow {
grid-column: 2;
grid-row: 1 / span 2;
align-self: center;
}
}
-116
View File
@@ -1,116 +0,0 @@
/**
* 帖子/新闻独立列表页布局(与首页 section-wrap 宽度一致)
* 不依赖 index.css(首页 hero/notice 专用)
*/
section.feed-list-page {
height: auto;
min-height: 0;
box-sizing: border-box;
}
.feed-list-page {
padding: 2rem 0 3rem;
}
.feed-list-page .section-wrap.feed-list-stage {
display: block;
width: 90%;
max-width: none;
margin-left: auto;
margin-right: auto;
box-sizing: border-box;
background-color: rgba(255, 255, 255, 0.14);
border: 1px solid rgba(255, 255, 255, 0.2);
box-shadow: inset 0 0 5px rgba(255, 255, 255, 0.1);
border-radius: 30px;
backdrop-filter: blur(12px);
padding: 2rem 2.5rem 2.5rem;
height: auto;
min-height: 0;
max-height: none;
overflow: visible;
}
.feed-list-body {
width: 100%;
overflow: visible;
}
.feed-list-title {
margin: 0 0 1.25rem;
font-size: 1.5rem;
font-weight: 600;
color: #111;
text-align: center;
border-bottom: 1px solid rgba(255, 255, 255, 0.45);
padding-bottom: 0.65rem;
}
.feed-list-actions {
display: flex;
justify-content: center;
margin-bottom: 1rem;
}
.feed-list-actions .feed-action-link {
padding: 0.4rem 1rem;
border-radius: 999px;
font-size: 0.8125rem;
font-weight: 600;
text-decoration: none;
color: var(--post-accent-text);
background: rgba(253, 189, 219, 0.35);
border: 1px solid rgba(253, 189, 219, 0.55);
transition: background 0.2s, box-shadow 0.2s;
}
.feed-list-actions .feed-action-link:hover {
background: rgba(253, 189, 219, 0.5);
box-shadow: 0 4px 14px rgba(253, 189, 219, 0.25);
}
.feed-list-page .feed-pagination {
margin-top: 1.5rem;
}
.feed-list-page .feed-pagination .page-link {
color: var(--post-accent-text);
background: rgba(255, 255, 255, 0.32);
backdrop-filter: blur(10px);
border: 1px solid rgba(253, 189, 219, 0.4);
border-radius: 8px;
margin: 0 0.2rem;
transition: background 0.2s;
}
.feed-list-page .feed-pagination .page-link:hover {
background: rgba(253, 189, 219, 0.35);
}
.feed-list-page .feed-pagination .page-item.active .page-link {
background: rgba(253, 189, 219, 0.55);
border-color: rgba(240, 168, 196, 0.75);
color: var(--post-accent-text);
font-weight: 600;
}
@media (max-width: 768px) {
section.feed-list-page,
.feed-list-page {
padding: 16px 0;
}
.feed-list-page .section-wrap.feed-list-stage {
width: 95%;
border-radius: 20px;
padding: 1.25rem 1.5rem 1.75rem;
}
}
@media (max-width: 576px) {
.feed-list-page .section-wrap.feed-list-stage {
width: 98%;
padding: 1rem 1.15rem 1.5rem;
}
}
-251
View File
@@ -1,251 +0,0 @@
/* 全站页脚:白色毛玻璃,与导航/首页区块风格一致 */
.site-footer {
margin-top: 2rem;
padding: 2.25rem 1.5rem 2.75rem;
background: rgba(255, 255, 255, 0.28);
backdrop-filter: blur(14px);
-webkit-backdrop-filter: blur(14px);
border-top: 1px solid rgba(255, 255, 255, 0.45);
box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.35);
color: #333;
}
.site-footer-inner {
max-width: 1000px;
margin: 0 auto;
display: grid;
grid-template-columns: 1fr 1fr;
gap: 2rem 3rem;
align-items: start;
}
.footer-col {
display: flex;
flex-direction: column;
align-items: center;
text-align: center;
}
/* ---------- 左栏:站点信息(居中 + 字号层级) ---------- */
.footer-site-logo {
border-radius: 50%;
object-fit: cover;
margin-bottom: 0.5rem;
}
.footer-site-name {
margin: 0 0 0.35rem;
font-size: 1.25rem;
font-weight: 700;
color: #111;
letter-spacing: 0.02em;
}
.footer-site-tagline {
margin: 0 0 0.75rem;
font-size: 0.8125rem;
font-weight: 400;
color: #555;
line-height: 1.5;
max-width: 22rem;
}
.footer-copy {
margin: 0 0 0.5rem;
font-size: 0.9375rem;
font-weight: 500;
color: #444;
}
.footer-meta-sm {
margin: 0.2rem 0;
font-size: 0.8125rem;
color: #666;
line-height: 1.45;
}
.footer-meta-label {
display: inline;
margin-right: 0.35rem;
font-size: 0.75rem;
color: #888;
}
.footer-meta-label::after {
content: ":";
}
.footer-col-site a {
color: #2a5db0;
text-decoration: none;
}
.footer-col-site a:hover {
color: #0d47a1;
text-decoration: underline;
}
.footer-api-guide {
margin-top: 0.45rem;
}
.footer-guide-btn {
display: inline-flex;
align-items: center;
gap: 0.35rem;
padding: 0.28rem 0.65rem;
font-size: 0.75rem;
font-weight: 600;
color: #555 !important;
text-decoration: none !important;
background: rgba(255, 255, 255, 0.45);
border: 1px solid rgba(0, 0, 0, 0.08);
border-radius: 999px;
transition: background 0.2s ease, color 0.2s ease, border-color 0.2s ease;
}
.footer-guide-btn:hover {
color: #2a5db0 !important;
background: rgba(255, 255, 255, 0.75);
border-color: rgba(42, 93, 176, 0.25);
}
.footer-guide-btn .anlian-icon {
font-size: 0.7rem;
opacity: 0.85;
}
.footer-beian {
display: flex;
flex-wrap: wrap;
justify-content: center;
gap: 0.35rem 0.85rem;
margin-top: 0.65rem;
}
.footer-beian-link {
display: inline-flex;
align-items: center;
gap: 0.3rem;
font-size: 0.75rem;
color: #777 !important;
text-decoration: none;
}
.footer-beian-link:hover {
color: #333 !important;
text-decoration: underline;
}
.beian-icon {
vertical-align: middle;
}
/* ---------- 右栏:作者(头像在上,信息居中,无卡片) ---------- */
.footer-col-author {
gap: 0.65rem;
}
.footer-author-avatar {
width: 72px;
height: 72px;
border-radius: 50%;
object-fit: cover;
border: 2px solid rgba(255, 255, 255, 0.85);
box-shadow: 0 2px 12px rgba(0, 0, 0, 0.08);
}
.footer-author-info {
display: flex;
flex-direction: column;
align-items: center;
gap: 0.2rem;
width: 100%;
max-width: 16rem;
}
.footer-author-name {
margin: 0;
font-size: 1.125rem;
font-weight: 700;
color: #111;
}
.footer-author-name a {
color: #111;
text-decoration: none;
}
.footer-author-name a:hover {
color: #111;
text-decoration: underline;
}
.footer-author-title {
margin: 0;
font-size: 0.875rem;
color: #666;
}
.footer-author-meta {
margin: 0.1rem 0;
font-size: 0.8125rem;
color: #555;
}
.footer-author-meta a {
color: #555;
text-decoration: none;
word-break: break-all;
}
.footer-author-meta a:hover {
color: #333;
text-decoration: underline;
}
/* 个人主页:白色加粗,悬浮白色下划线(与全站毛玻璃主题一致) */
.footer-author-home a {
color: #fff;
font-weight: 700;
text-decoration: none;
text-shadow: 0 1px 3px rgba(0, 0, 0, 0.35);
}
.footer-author-home a:hover,
.footer-author-home a:focus-visible {
color: #fff;
text-decoration: underline;
text-decoration-color: #fff;
text-underline-offset: 0.2em;
}
/* ---------- 首页与其它页面共用 ---------- */
.page-home .main-container {
max-width: none;
width: 100%;
padding: 0;
margin: 0;
}
.hero .social a {
color: inherit;
text-decoration: none;
}
.hero .social a:hover {
opacity: 0.85;
}
@media (max-width: 767.98px) {
.site-footer-inner {
grid-template-columns: 1fr;
gap: 2rem;
}
.footer-col-author {
padding-top: 0.5rem;
border-top: 1px solid rgba(0, 0, 0, 0.06);
}
}
-17
View File
@@ -1,17 +0,0 @@
.anlian-icon {
display: inline-flex;
align-items: center;
justify-content: center;
width: 1em;
height: 1em;
vertical-align: -0.125em;
fill: currentColor;
flex-shrink: 0;
line-height: 1;
}
.anlian-icon svg {
display: block;
width: 100%;
height: 100%;
}
-180
View File
@@ -1,180 +0,0 @@
/* ========== 原有基础样式保留(略作优化) ========== */
/* 针对section的css样式 */
section,
.right,
.left,
.social,
.social .anlian-icon {
display: flex;
justify-content: center;
align-items: center;
}
section {
height: 100vh;
/* 新增:确保小屏幕也能完整显示内容,避免溢出 */
min-height: 600px;
padding: 20px 0;
box-sizing: border-box;
}
.section-wrap {
background-color: rgba(255, 255, 255, 0.2);
height: 80vh;
min-height: 500px; /* 新增:最小高度,避免小屏幕塌陷 */
width: 90%;
border: 1px solid rgba(255, 255, 255, 0.2);
box-shadow: inset 0 0 5px rgba(255, 255, 255, 0.1);
border-radius: 30px;
backdrop-filter: blur(12px);
padding: 50px 100px;
overflow: hidden;
box-sizing: border-box; /* 新增:内边距计入宽度 */
}
@media (max-width: 992px) {
.section-wrap {
padding: 30px 50px; /* 减小内边距 */
height: 85vh; /* 增加高度占比,容纳内容 */
}
}
@media (max-width: 768px) {
section {
height: auto; /* 取消固定高度,自适应内容 */
min-height: 100vh; /* 确保至少占满视窗 */
padding: 40px 0;
}
.section-wrap {
height: auto; /* 取消固定高度 */
/* min-height: auto; */
padding: 20px 30px;
width: 95%; /* 增加宽度占比 */
border-radius: 20px; /* 减小圆角,适配小屏 */
}
}
@media (max-width: 576px) {
.section-wrap {
padding: 15px 20px;
width: 98%;
}
}
/* 内容型区块:取消 100vh + flex 居中,避免列表被压扁裁切(桌面端亦生效) */
section.feed-list-page,
.page-home section.home-posts,
.page-home section.home-news {
height: auto;
min-height: 0;
align-items: stretch;
justify-content: flex-start;
}
/* 公告 / 新闻 / 帖子 / 列表页:统一宽度 */
.page-home section.notice > .section-wrap,
.page-home section.home-news > .section-wrap,
.page-home section.home-posts > .section-wrap,
section.feed-list-page > .section-wrap.feed-list-stage {
width: 90%;
max-width: none;
margin-left: auto;
margin-right: auto;
box-sizing: border-box;
}
/* 公告:保留轮播区高度(勿用 min-height:0,否则绝对定位容器坍塌) */
.page-home section.notice > .section-wrap {
position: relative;
min-height: clamp(380px, 52vh, 560px);
overflow: hidden;
}
/* 新闻 / 帖子 / 列表:高度随内容,覆盖全局 80vh + overflow:hidden */
.page-home section.home-news > .section-wrap,
.page-home section.home-posts > .section-wrap,
section.feed-list-page > .section-wrap.feed-list-stage {
height: auto;
min-height: 0;
max-height: none;
overflow: visible;
}
/* 首页 Hero:全屏感 + 与其它区块统一宽度 */
.page-home section.hero {
height: auto;
min-height: 100vh;
align-items: stretch;
padding: 20px 0;
}
.page-home section.hero > .section-wrap {
width: 90%;
max-width: none;
margin-left: auto;
margin-right: auto;
height: auto;
min-height: clamp(520px, 82vh, 760px);
overflow: visible;
box-sizing: border-box;
}
@media (max-width: 1024px) {
.page-home section.hero {
min-height: auto;
padding: 16px 0;
}
.page-home section.hero > .section-wrap {
min-height: clamp(460px, 75vh, 680px);
padding: 28px 40px;
}
}
@media (max-width: 768px) {
.page-home section.hero,
.page-home section.home-posts,
.page-home section.home-news,
.page-home section.notice,
section.feed-list-page {
min-height: auto;
padding: 16px 0;
}
.page-home section.notice > .section-wrap,
.page-home section.home-news > .section-wrap,
.page-home section.home-posts > .section-wrap,
section.feed-list-page > .section-wrap.feed-list-stage,
.page-home section.hero > .section-wrap {
width: 95%;
}
.page-home section.hero > .section-wrap {
min-height: auto;
padding: 20px 24px;
}
.page-home section.notice > .section-wrap {
min-height: clamp(340px, 58vh, 480px);
}
}
@media (max-width: 576px) {
.page-home section.notice > .section-wrap,
.page-home section.home-news > .section-wrap,
.page-home section.home-posts > .section-wrap,
section.feed-list-page > .section-wrap.feed-list-stage,
.page-home section.hero > .section-wrap {
width: 98%;
}
.page-home section.hero > .section-wrap {
padding: 16px 18px;
border-radius: 20px;
}
.page-home section.notice > .section-wrap {
min-height: clamp(300px, 62vh, 420px);
}
}
@@ -1,276 +0,0 @@
/**
* 首页 Hero(暗恋见君)
* 断点:台式 ≥1025px | 平板 768–1024px | 手机 ≤767px
*/
@keyframes heroImageFloat {
0%,
100% {
transform: scale(1);
}
50% {
transform: scale(1.04);
}
}
/* ---------- 区块与容器 ---------- */
section.hero {
align-items: stretch;
justify-content: center;
}
.hero .section-wrap {
display: flex;
flex-direction: column;
justify-content: space-between;
gap: 1.25rem;
width: 100%;
box-sizing: border-box;
}
/* ---------- 顶栏 Logo ---------- */
.hero header {
display: flex;
flex-direction: row;
flex-wrap: nowrap;
align-items: center;
justify-content: flex-start;
gap: 0.65rem;
width: 100%;
padding-bottom: 0.75rem;
flex-shrink: 0;
}
.hero header img {
width: 30px;
height: 30px;
flex-shrink: 0;
object-fit: contain;
}
.head-logo {
font-size: 2rem;
font-weight: bold;
text-transform: uppercase;
letter-spacing: 2px;
cursor: pointer;
text-decoration: none;
color: #000;
white-space: nowrap;
}
.head-logo span {
color: #ffd0d0;
}
/* ---------- 主内容区 ---------- */
.hero-content {
display: grid;
grid-template-columns: minmax(0, 1fr) minmax(0, 1fr);
align-items: center;
gap: 2rem;
flex: 1 1 auto;
min-height: 0;
width: 100%;
}
.hero .left {
display: flex;
flex-direction: column;
align-items: flex-start;
justify-content: center;
min-width: 0;
width: 100%;
}
.hero .right {
display: flex;
align-items: center;
justify-content: center;
min-width: 0;
width: 100%;
}
.main-text {
margin: 0 0 1.875rem;
font-size: 6rem;
font-weight: 800;
line-height: 1.2;
text-transform: uppercase;
color: #111;
word-break: break-word;
overflow-wrap: anywhere;
width: 100%;
}
.main-text span {
color: #ffd0d0;
}
.sub-text {
margin: 0 0 3.125rem;
font-size: 1.2rem;
letter-spacing: 1px;
font-weight: 400;
color: rgba(60, 60, 60, 0.85);
line-height: 1.5;
max-width: none;
}
.hero .right img {
display: block;
width: 85%;
max-width: 100%;
height: auto;
filter: drop-shadow(0 0 20px rgba(255, 208, 208, 0.45));
animation: heroImageFloat 30s linear infinite;
pointer-events: none;
}
/* ---------- 社交链接 ---------- */
.hero .social {
display: flex;
flex-wrap: wrap;
align-items: center;
justify-content: flex-start;
gap: 0.5rem;
width: 100%;
flex-shrink: 0;
padding-top: 0.25rem;
}
.hero .social a {
display: inline-flex;
text-decoration: none;
}
.hero .social .anlian-icon {
display: inline-flex;
align-items: center;
justify-content: center;
width: 40px;
height: 40px;
font-size: 1.1rem;
border: 1px solid rgba(241, 248, 233, 0.9);
border-radius: 50%;
margin: 0;
cursor: pointer;
transition: border-color 0.25s, box-shadow 0.25s, transform 0.25s, color 0.25s;
}
.hero .social .anlian-icon:hover {
border-color: #ffd0d0;
box-shadow: 0 0 20px rgba(255, 208, 208, 0.45);
color: #ffd0d0;
transform: rotate(360deg);
}
/* ========== 平板(768px–1024px) ========== */
@media (max-width: 1024px) {
.head-logo {
font-size: 1.8rem;
letter-spacing: 0.08em;
}
.hero-content {
grid-template-columns: minmax(0, 1.05fr) minmax(0, 0.95fr);
gap: 1.25rem;
}
.main-text {
font-size: clamp(2.5rem, 4.5vw, 4rem);
margin-bottom: 1.25rem;
line-height: 1.15;
}
.sub-text {
font-size: 1rem;
margin-bottom: 2rem;
}
.hero .right img {
width: min(90%, 340px);
}
}
/* ========== 手机(≤767px) ========== */
@media (max-width: 767px) {
.hero .section-wrap {
gap: 1rem;
}
.hero header {
justify-content: center;
}
.hero-content {
grid-template-columns: 1fr;
grid-template-rows: auto auto;
gap: 1.5rem;
}
.hero .left {
align-items: center;
text-align: center;
order: 1;
}
.hero .right {
order: 2;
}
.main-text {
font-size: clamp(1.85rem, 8vw, 2.75rem);
text-align: center;
}
.sub-text {
text-align: center;
padding: 0 0.5rem;
}
.hero .right img {
width: min(72%, 280px);
margin: 0 auto;
}
.hero .social {
justify-content: center;
padding-top: 0.5rem;
}
.hero .social .anlian-icon {
width: 36px;
height: 36px;
font-size: 1rem;
}
}
@media (max-width: 576px) {
.hero header img {
width: 26px;
height: 26px;
}
.main-text {
font-size: clamp(1.65rem, 9vw, 2.2rem);
}
.sub-text {
font-size: 0.875rem;
}
.hero .right img {
width: min(78%, 240px);
}
}
@media (prefers-reduced-motion: reduce) {
.hero .right img {
animation: none;
}
.hero .social .anlian-icon:hover {
transform: none;
}
}
@@ -1,461 +0,0 @@
/**
* 首页新闻时间轴
* - 台式(≥1025px):横向轨道,五条均分,卡片上下交错
* - 平板(768–1024px):横向轨道,卡片横向滑动
* - 手机(≤767px):竖向轨道,卡片左右交错
*/
.home-news {
--news-accent: #fdbbdb;
--news-accent-deep: #f0a8c4;
--news-accent-text: #a85878;
--news-accent-muted: #c97a96;
--timeline-axis-offset: 50%;
--bp-tablet: 1024px;
--bp-mobile: 767px;
height: auto;
min-height: 0;
padding: 20px 0;
}
section.home-news {
align-items: stretch;
}
.home-news .section-wrap.home-news-stage {
display: block;
position: relative;
height: auto;
min-height: 0;
max-height: none;
overflow: visible;
}
.home-news .news-timeline-panel,
.home-news .news-timeline-wrap,
.home-news .news-timeline {
overflow: visible;
}
.home-news .news-title {
font-size: 1.5rem;
font-weight: 600;
margin-bottom: 1rem;
color: #111;
border-bottom: 1px solid rgba(255, 255, 255, 0.5);
padding-bottom: 0.5rem;
text-align: center;
}
.home-news .home-news-board-bar {
margin-bottom: 1rem;
}
/* ---------- 时间轴容器 ---------- */
.home-news .news-timeline-wrap {
position: relative;
width: 100%;
max-width: none;
margin: 2rem 0 0;
padding: 0.5rem 0 1.5rem;
box-sizing: border-box;
}
.home-news .news-timeline-panel {
contain: layout style;
}
.home-news .news-timeline {
position: relative;
min-height: 13.5rem;
height: auto;
padding: 0.5rem 0 0;
}
/* ---------- 横向轨道(台式 + 平板) ---------- */
.home-news .news-timeline-rail {
position: absolute;
left: 1.25rem;
right: 1.25rem;
top: var(--timeline-axis-offset);
transform: translateY(-50%);
height: 3px;
width: auto;
pointer-events: none;
z-index: 0;
}
.home-news .news-timeline-line {
display: block;
width: 100%;
height: 100%;
border-radius: 999px;
background: linear-gradient(
90deg,
rgba(253, 189, 219, 0.35) 0%,
rgba(253, 189, 219, 0.75) 55%,
rgba(240, 168, 196, 0.9) 100%
);
box-shadow: 0 0 10px rgba(253, 189, 219, 0.25);
}
.home-news .news-timeline-arrow {
position: absolute;
right: -0.35rem;
top: 50%;
transform: translateY(-50%);
width: 1.5rem;
height: 1.5rem;
display: flex;
align-items: center;
justify-content: center;
color: var(--news-accent-deep);
font-size: 0.85rem;
filter: drop-shadow(0 1px 3px rgba(253, 189, 219, 0.45));
}
.home-news .news-timeline-arrow .news-timeline-arrow-icon--down {
display: none;
}
.home-news .news-timeline-items {
list-style: none;
margin: 0;
padding: 0 0.5rem;
display: flex;
align-items: stretch;
justify-content: space-between;
gap: 0.65rem;
position: relative;
z-index: 1;
min-height: 13.5rem;
}
.home-news .news-timeline-item {
flex: 1 1 0;
min-width: 0;
max-width: 11.5rem;
display: grid;
grid-template-rows: 1fr auto 1fr;
grid-template-columns: none;
align-items: center;
justify-items: center;
}
.home-news .news-timeline-node {
grid-row: 2;
grid-column: auto;
width: 12px;
height: 12px;
border-radius: 50%;
background: rgba(255, 255, 255, 0.85);
border: 2px solid var(--news-accent-deep);
box-shadow:
0 0 0 3px rgba(253, 189, 219, 0.25),
0 2px 8px rgba(253, 189, 219, 0.35);
flex-shrink: 0;
z-index: 2;
transition: transform 0.2s ease, box-shadow 0.2s ease;
}
.home-news .news-timeline-item:nth-child(odd) .news-timeline-card {
grid-row: 1;
grid-column: auto;
align-self: end;
margin: 0 0 0.45rem;
}
.home-news .news-timeline-item:nth-child(even) .news-timeline-card {
grid-row: 3;
grid-column: auto;
align-self: start;
margin: 0.45rem 0 0;
}
.home-news .news-timeline-item:hover .news-timeline-node {
transform: scale(1.15);
box-shadow:
0 0 0 4px rgba(253, 189, 219, 0.35),
0 4px 12px rgba(253, 189, 219, 0.4);
}
.home-news .news-timeline-card {
width: 100%;
padding: 0.65rem 0.75rem;
border-radius: 14px;
background: rgba(255, 255, 255, 0.38);
backdrop-filter: blur(16px);
-webkit-backdrop-filter: blur(16px);
border: 1px solid rgba(255, 255, 255, 0.42);
box-shadow: 0 6px 20px rgba(253, 189, 219, 0.12);
transition: transform 0.2s ease, box-shadow 0.2s ease, background 0.2s ease;
}
.home-news .news-timeline-item:nth-child(odd):hover .news-timeline-card {
transform: translateY(-4px);
background: rgba(255, 255, 255, 0.52);
box-shadow: 0 10px 28px rgba(253, 189, 219, 0.22);
}
.home-news .news-timeline-item:nth-child(even):hover .news-timeline-card {
transform: translateY(4px);
background: rgba(255, 255, 255, 0.52);
box-shadow: 0 10px 28px rgba(253, 189, 219, 0.22);
}
.home-news .news-timeline-meta {
display: flex;
flex-wrap: wrap;
align-items: center;
gap: 0.35rem 0.5rem;
margin-bottom: 0.35rem;
}
.home-news .news-timeline-date {
font-size: 0.6875rem;
font-weight: 700;
color: var(--news-accent-muted);
white-space: nowrap;
}
.home-news .news-timeline-board {
font-size: 0.625rem;
font-weight: 600;
color: var(--news-accent-text);
background: rgba(253, 189, 219, 0.22);
padding: 0.1rem 0.35rem;
border-radius: 3px;
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
max-width: 100%;
}
.home-news .news-timeline-title {
margin: 0;
min-width: 0;
}
.home-news .news-timeline-link {
display: -webkit-box;
-webkit-box-orient: vertical;
-webkit-line-clamp: 2;
overflow: hidden;
font-size: 0.8125rem;
font-weight: 600;
line-height: 1.35;
color: #222;
text-decoration: none;
}
.home-news .news-timeline-link:hover {
color: var(--news-accent-text);
}
.home-news .news-timeline-empty {
margin: 0;
text-align: center;
color: #666;
font-size: 0.9rem;
}
.home-news .news-timeline-item-empty {
flex: 1 1 100%;
max-width: none;
grid-template-rows: auto;
grid-template-columns: 1fr;
}
.home-news .news-timeline-item-empty .news-timeline-card {
grid-row: 1;
grid-column: 1;
margin: 0;
}
.home-news .news-timeline-wrap::before {
content: "";
position: absolute;
left: 5%;
right: 5%;
top: var(--timeline-axis-offset);
transform: translateY(-50%);
height: 70%;
background: radial-gradient(
ellipse 85% 100% at 50% 50%,
rgba(253, 189, 219, 0.18) 0%,
transparent 72%
);
pointer-events: none;
z-index: 0;
}
/* ========== 平板(768px–1024px):横向轨道 + 卡片横滑 ========== */
@media (max-width: 1024px) {
.home-news .news-timeline-wrap {
margin-top: 1.75rem;
}
.home-news .news-timeline {
min-height: 12rem;
}
.home-news .news-timeline-items {
justify-content: flex-start;
flex-wrap: nowrap;
gap: 0.75rem;
min-height: 12rem;
overflow-x: auto;
overflow-y: visible;
scroll-snap-type: x proximity;
-webkit-overflow-scrolling: touch;
padding: 0 0.5rem 0.5rem;
scrollbar-width: thin;
scrollbar-color: rgba(253, 189, 219, 0.5) transparent;
}
.home-news .news-timeline-items::-webkit-scrollbar {
height: 5px;
}
.home-news .news-timeline-items::-webkit-scrollbar-thumb {
background: rgba(253, 189, 219, 0.45);
border-radius: 999px;
}
.home-news .news-timeline-item {
flex: 0 0 auto;
width: min(10.5rem, 38vw);
max-width: 11rem;
scroll-snap-align: center;
}
.home-news .news-timeline-rail {
left: 0.75rem;
right: 0.75rem;
}
}
/* ========== 手机(≤767px):竖向时间轴 ========== */
@media (max-width: 767px) {
.home-news .news-timeline-wrap {
margin-top: 1.5rem;
}
.home-news .news-timeline-wrap::before {
left: 50%;
right: auto;
top: 4%;
bottom: 4%;
width: min(18rem, 72%);
height: auto;
transform: translateX(-50%);
background: radial-gradient(
ellipse 70% 90% at 50% 50%,
rgba(253, 189, 219, 0.2) 0%,
transparent 72%
);
}
.home-news .news-timeline {
min-height: 0;
padding: 0.25rem 0 0.5rem;
}
.home-news .news-timeline-rail {
left: 50%;
right: auto;
top: 0.35rem;
bottom: 0.65rem;
width: 3px;
height: auto;
transform: translateX(-50%);
}
.home-news .news-timeline-line {
width: 100%;
height: 100%;
background: linear-gradient(
180deg,
rgba(253, 189, 219, 0.35) 0%,
rgba(253, 189, 219, 0.75) 55%,
rgba(240, 168, 196, 0.9) 100%
);
}
.home-news .news-timeline-arrow {
left: 50%;
right: auto;
top: auto;
bottom: -0.6rem;
transform: translateX(-50%);
}
.home-news .news-timeline-arrow .news-timeline-arrow-icon--right {
display: none;
}
.home-news .news-timeline-arrow .news-timeline-arrow-icon--down {
display: block;
}
.home-news .news-timeline-items {
flex-direction: column;
align-items: stretch;
gap: 1.25rem;
min-height: 0;
padding: 0.35rem 0.5rem 1.25rem;
overflow: visible;
scroll-snap-type: none;
}
.home-news .news-timeline-item {
flex: none;
width: 100%;
max-width: none;
display: grid;
grid-template-columns: minmax(0, 1fr) 12px minmax(0, 1fr);
grid-template-rows: auto;
column-gap: 0.55rem;
}
.home-news .news-timeline-node {
grid-row: 1;
grid-column: 2;
justify-self: center;
}
.home-news .news-timeline-item:nth-child(odd) .news-timeline-card {
grid-row: 1;
grid-column: 3;
align-self: center;
margin: 0;
}
.home-news .news-timeline-item:nth-child(even) .news-timeline-card {
grid-row: 1;
grid-column: 1;
align-self: center;
margin: 0;
}
.home-news .news-timeline-item:nth-child(odd):hover .news-timeline-card {
transform: translateX(4px);
}
.home-news .news-timeline-item:nth-child(even):hover .news-timeline-card {
transform: translateX(-4px);
}
.home-news .news-timeline-item-empty {
grid-template-columns: 1fr;
}
.home-news .news-timeline-card {
padding: 0.6rem 0.65rem;
}
.home-news .news-timeline-link {
font-size: 0.78rem;
}
}
@@ -1,46 +0,0 @@
/**
* 首页「论坛交流」区块(共用样式见 feed_common.css,由模板单独引入)
*/
/* 覆盖 index.css 的 100vh / 80vh,使 10 条帖子完整展示 */
section.home-posts {
height: auto;
min-height: 0;
align-items: stretch;
}
.home-posts {
padding: 20px 0 28px;
}
.home-posts .section-wrap.home-posts-stage {
display: block;
background-color: rgba(255, 255, 255, 0.14);
height: auto;
min-height: 0;
max-height: none;
overflow: visible;
}
.home-posts-panel,
#tenPostContainer {
overflow: visible;
}
.home-posts-title {
margin: 0 0 1.25rem;
font-size: 1.5rem;
font-weight: 600;
color: #111;
text-align: center;
border-bottom: 1px solid rgba(255, 255, 255, 0.45);
padding-bottom: 0.65rem;
}
.home-posts-board-bar {
margin-bottom: 1.25rem;
}
.home-posts-panel {
contain: layout style;
}
@@ -1,349 +0,0 @@
/* ========== 原有基础样式保留(略作优化) ========== */
/* 公告标题样式 */
.notice-title {
font-size: 1.5rem;
font-weight: 600;
margin-bottom: 1.5rem;
color: #212529;
border-bottom: 1px solid rgba(255, 255, 255, 0.3);
padding-bottom: 0.5rem;
text-align: center;
/* 新增:确保标题在小屏不溢出 */
width: 100%;
box-sizing: border-box;
}
/* 公告内容article样式 - 居中显示 */
.notice-item>article {
text-align: center;
padding: 1.5rem;
background-color: rgba(255, 255, 255, 0.1);
border-radius: 0.5rem;
word-wrap: break-word;
min-height: 100px;
display: block;
position: relative;
width: 100%;
margin-bottom: 0;
box-sizing: border-box; /* 新增:内边距计入宽度 */
}
/* 确保article内部HTML内容正常显示 */
.notice-item>article * {
text-align: center;
margin: 0.5rem 0;
max-width: 100%;
word-wrap: break-word;
}
/* 为article内部元素添加基础样式 */
.notice-item>article p {
line-height: 1.6;
margin-bottom: 1rem;
}
.notice-item>article h1,
.notice-item>article h2,
.notice-item>article h3 {
font-weight: 600;
margin-top: 1rem;
margin-bottom: 0.5rem;
}
.notice-item>article ul,
.notice-item>article ol {
padding-left: 1.5rem;
margin-bottom: 1rem;
}
.notice-item>article li {
margin-bottom: 0.5rem;
}
/* 公告时间样式 - 放在右下角 */
.notice-item>.notice-create-time {
font-size: 0.85rem;
color: #6c757d;
margin-bottom: 0;
position: absolute;
bottom: 1rem;
right: 1rem;
white-space: nowrap;
/* 新增:小屏时调整位置,避免溢出 */
z-index: 2;
}
/* 定义外层容器样式 */
.notice-content-container {
position: absolute;
top: 50%;
left: 50%;
transform: translate(-50%, -50%);
/* 初始尺寸(大屏) */
width: 60vw;
height: 50vw;
margin: 0;
color: rgb(0, 0, 0);
perspective: 1000px;
transform-origin: center;
/* 新增:确保容器不会溢出父元素 */
max-width: 600px;
max-height: 500px;
box-sizing: border-box;
}
/* 定义内容容器样式 */
.notice-list {
display: flex;
justify-content: center;
align-items: center;
position: absolute;
width: 100%;
height: 100%;
transform-origin: center;
transform-style: preserve-3d;
transform: translateZ(-30vw) rotateY(0);
animation: carousel 9s infinite cubic-bezier(0.77, 0, 0.175, 1) forwards;
}
/* 定义项目样式 */
.notice-item {
position: absolute;
/* 初始尺寸(大屏) */
width: 60vw;
height: 40vw;
max-width: 380px;
max-height: 250px;
box-shadow: 0 5px 20px rgba(0, 0, 0, 0.3);
border-radius: 6px;
background-size: cover;
-webkit-box-reflect: below 25px -webkit-linear-gradient(transparent 50%, rgba(255, 255, 255, 0.3));
/* 新增:小屏时调整倒影,避免遮挡 */
box-sizing: border-box;
}
/* 第一个项目样式 */
.notice-item:nth-child(1) {
transform: rotateY(0) translateZ(35vw);
}
/* 第二个项目样式 */
.notice-item:nth-child(2) {
transform: rotateY(120deg) translateZ(35vw);
}
/* 第三个项目样式 */
.notice-item:nth-child(3) {
transform: rotateY(240deg) translateZ(35vw);
}
/* 定义动画 */
@keyframes carousel {
0%,
17.5% {
transform: translateZ(-35vw) rotateY(0);
}
27.5%,
45% {
transform: translateZ(-35vw) rotateY(-120deg);
}
55%,
72.5% {
transform: translateZ(-35vw) rotateY(-240deg);
}
82.5%,
100% {
transform: translateZ(-35vw) rotateY(-360deg);
}
}
/* ========== 新增响应式设计(核心) ========== */
/* 1. 平板横向/大屏手机 (≤ 992px) */
@media (max-width: 992px) {
/* 调整公告容器尺寸 */
.notice-content-container {
width: 70vw;
height: 60vw;
max-width: 500px;
max-height: 400px;
}
/* 调整轮播项尺寸 */
.notice-item {
width: 70vw;
height: 45vw;
max-width: 350px;
max-height: 220px;
}
/* 调整3D平移距离,适配尺寸 */
.notice-list {
transform: translateZ(-35vw) rotateY(0);
}
.notice-item:nth-child(1),
.notice-item:nth-child(2),
.notice-item:nth-child(3) {
transform: rotateY(var(--rotate-deg)) translateZ(40vw);
}
@keyframes carousel {
0%, 17.5% { transform: translateZ(-40vw) rotateY(0); }
27.5%, 45% { transform: translateZ(-40vw) rotateY(-120deg); }
55%, 72.5% { transform: translateZ(-40vw) rotateY(-240deg); }
82.5%, 100% { transform: translateZ(-40vw) rotateY(-360deg); }
}
/* 调整标题和内容字体 */
.notice-title {
font-size: 1.3rem;
margin-bottom: 1rem;
}
.notice-item>article {
padding: 1.2rem;
min-height: 80px;
}
.notice-item>article p {
font-size: 0.95rem;
line-height: 1.5;
}
.notice-create-time {
font-size: 0.8rem;
bottom: 0.8rem;
right: 0.8rem;
}
}
/* 2. 平板竖向/中屏手机 (≤ 768px) */
@media (max-width: 768px) {
/* 进一步调整容器尺寸 */
.notice-content-container {
width: 80vw;
height: 70vw;
max-width: 400px;
max-height: 350px;
/* 小屏时微调定位,避免偏上 */
top: 55%;
}
/* 调整轮播项尺寸 */
.notice-item {
width: 80vw;
height: 50vw;
max-width: 320px;
max-height: 200px;
/* 减小阴影,适配小屏 */
box-shadow: 0 3px 15px rgba(0, 0, 0, 0.2);
/* 减小倒影高度,避免遮挡 */
-webkit-box-reflect: below 15px -webkit-linear-gradient(transparent 60%, rgba(255, 255, 255, 0.2));
}
/* 调整3D平移距离 */
.notice-list {
transform: translateZ(-40vw) rotateY(0);
}
.notice-item:nth-child(1),
.notice-item:nth-child(2),
.notice-item:nth-child(3) {
transform: rotateY(var(--rotate-deg)) translateZ(45vw);
}
@keyframes carousel {
0%, 17.5% { transform: translateZ(-45vw) rotateY(0); }
27.5%, 45% { transform: translateZ(-45vw) rotateY(-120deg); }
55%, 72.5% { transform: translateZ(-45vw) rotateY(-240deg); }
82.5%, 100% { transform: translateZ(-45vw) rotateY(-360deg); }
}
/* 调整文字样式 */
.notice-title {
font-size: 1.2rem;
padding-bottom: 0.4rem;
}
.notice-item>article {
padding: 1rem;
min-height: 70px;
}
.notice-item>article h1,
.notice-item>article h2,
.notice-item>article h3 {
font-size: 1.1rem;
margin-top: 0.8rem;
}
}
/* 3. 小屏手机 (≤ 576px) */
@media (max-width: 576px) {
/* 极致适配小屏 */
.notice-content-container {
width: 90vw;
height: 80vw;
max-width: 350px;
max-height: 300px;
top: 55%;
/* 减小透视距离,避免轮播项超出屏幕 */
perspective: 800px;
}
/* 轮播项适配 */
.notice-item {
width: 90vw;
height: 55vw;
max-width: 300px;
max-height: 180px;
box-shadow: 0 2px 10px rgba(0, 0, 0, 0.15);
-webkit-box-reflect: below 10px -webkit-linear-gradient(transparent 70%, rgba(255, 255, 255, 0.1));
}
/* 调整3D平移距离(关键:避免轮播项出屏) */
.notice-list {
transform: translateZ(-45vw) rotateY(0);
}
.notice-item:nth-child(1) {
transform: rotateY(0) translateZ(50vw);
}
.notice-item:nth-child(2) {
transform: rotateY(120deg) translateZ(50vw);
}
.notice-item:nth-child(3) {
transform: rotateY(240deg) translateZ(50vw);
}
@keyframes carousel {
0%, 17.5% { transform: translateZ(-50vw) rotateY(0); }
27.5%, 45% { transform: translateZ(-50vw) rotateY(-120deg); }
55%, 72.5% { transform: translateZ(-50vw) rotateY(-240deg); }
82.5%, 100% { transform: translateZ(-50vw) rotateY(-360deg); }
}
/* 文字极致适配 */
.notice-title {
font-size: 1.1rem;
margin-bottom: 0.8rem;
}
.notice-item>article {
padding: 0.8rem;
min-height: 60px;
border-radius: 0.3rem;
}
.notice-item>article p {
font-size: 0.85rem;
line-height: 1.4;
margin-bottom: 0.8rem;
}
.notice-create-time {
font-size: 0.75rem;
bottom: 0.5rem;
right: 0.5rem;
/* 小屏时背景半透,避免文字看不清 */
background-color: rgba(255, 255, 255, 0.2);
padding: 0.2rem 0.4rem;
border-radius: 0.2rem;
}
/* 隐藏过长的列表项符号,避免溢出 */
.notice-item>article ul,
.notice-item>article ol {
padding-left: 1rem;
}
}
/* 补充:修复CSS变量(可选,增强兼容性) */
.notice-item:nth-child(1) { --rotate-deg: 0deg; }
.notice-item:nth-child(2) { --rotate-deg: 120deg; }
.notice-item:nth-child(3) { --rotate-deg: 240deg; }
-128
View File
@@ -1,128 +0,0 @@
/* 登录 / 注册页:在 anlian_forms.css 之上的薄封装 */
.page-title {
margin: 0 0 1.25rem;
font-size: 1.75rem;
font-weight: 700;
color: var(--anlian-text, #222);
text-align: center;
}
.login-container {
width: 100%;
max-width: 440px;
}
.text-center.text-muted,
.anlian-page-lead {
margin: -0.25rem 0 1.25rem;
font-size: 0.9rem;
color: var(--anlian-text-muted, #666);
text-align: center;
line-height: 1.5;
}
.mb-3 {
margin-bottom: 1rem;
}
/* 注册页旧类名兼容 */
.auth-code-row,
.anlian-code-row {
display: flex;
gap: 0.5rem;
align-items: stretch;
}
.auth-code-row .form-control,
.anlian-code-row input {
flex: 1;
min-width: 0;
}
.btn-send-code,
.anlian-btn-send-code {
flex-shrink: 0;
align-self: stretch;
padding: 0 1rem;
border: 1px solid rgba(253, 189, 219, 0.5);
border-radius: 12px;
background: rgba(253, 189, 219, 0.32);
color: var(--anlian-accent-text, #a85878);
font-size: 0.8125rem;
font-weight: 600;
cursor: pointer;
white-space: nowrap;
transition: background 0.2s ease;
}
.btn-send-code:hover:not(:disabled),
.anlian-btn-send-code:hover:not(:disabled) {
background: rgba(253, 189, 219, 0.48);
}
.btn-send-code:disabled,
.anlian-btn-send-code:disabled {
opacity: 0.55;
cursor: not-allowed;
}
.field-hint,
.anlian-field-hint {
display: block;
margin-top: 0.35rem;
font-size: 0.75rem;
color: var(--anlian-text-muted, #666);
}
.field-error,
.anlian-field-error {
display: block;
margin-top: 0.35rem;
font-size: 0.8125rem;
color: #b33a4d;
}
.alert-danger,
.anlian-alert-danger {
padding: 0.85rem 1rem;
margin-bottom: 1rem;
border-radius: 12px;
font-size: 0.875rem;
background: rgba(220, 80, 100, 0.12);
border: 1px solid rgba(220, 80, 100, 0.28);
color: #9e3a4a;
}
.form-links,
.anlian-form-links {
display: flex;
justify-content: center;
gap: 1rem;
margin-top: 1.25rem;
flex-wrap: wrap;
}
.form-links a,
.anlian-form-links a {
font-size: 0.875rem;
font-weight: 500;
color: var(--anlian-accent-text, #a85878);
text-decoration: none;
}
.form-links a:hover,
.anlian-form-links a:hover {
text-decoration: underline;
}
@media (max-width: 576px) {
.auth-code-row {
flex-direction: column;
}
.btn-send-code {
width: 100%;
padding: 0.65rem;
}
}
@@ -1,80 +0,0 @@
/**
* 导航栏搜索框 — 粉色主题
*/
.navbar-search {
gap: 0.45rem;
align-items: stretch;
flex-shrink: 1;
min-width: 0;
}
.navbar-search .form-control {
min-width: 8.5rem;
max-width: 11.5rem;
padding: 0.45rem 0.85rem;
font-size: 0.875rem;
line-height: 1.35;
color: #f5f5f5;
background: rgba(255, 255, 255, 0.14);
border: 1px solid rgba(253, 189, 219, 0.45);
border-radius: 999px;
transition: background 0.2s ease, border-color 0.2s ease, box-shadow 0.2s ease;
}
.navbar-search .form-control::placeholder {
color: rgba(255, 255, 255, 0.55);
}
.navbar-search .form-control:focus {
color: #fff;
background: rgba(255, 255, 255, 0.22);
border-color: rgba(253, 189, 219, 0.75);
box-shadow: 0 0 0 2px rgba(253, 189, 219, 0.28);
outline: none;
}
.navbar-search .btn-search-submit {
flex-shrink: 0;
padding: 0.45rem 0.95rem;
font-size: 0.8125rem;
font-weight: 600;
line-height: 1.35;
color: #a85878;
white-space: nowrap;
background: linear-gradient(135deg, rgba(253, 189, 219, 0.92), rgba(240, 168, 196, 0.95));
border: 1px solid rgba(255, 255, 255, 0.35);
border-radius: 999px;
transition: box-shadow 0.2s ease, transform 0.2s ease, filter 0.2s ease;
}
.navbar-search .btn-search-submit:hover {
color: #8a4560;
background: linear-gradient(135deg, rgba(253, 189, 219, 1), rgba(240, 168, 196, 1));
border-color: rgba(255, 255, 255, 0.5);
box-shadow: 0 3px 14px rgba(253, 189, 219, 0.35);
transform: translateY(-1px);
}
@media (max-width: 991.98px) {
.navbar-search {
width: 100%;
margin: 0.5rem 0;
}
.navbar-search .form-control {
flex: 1;
max-width: none;
min-width: 0;
}
.navbar-search .btn-search-submit {
padding: 0.45rem 1.1rem;
}
}
@media (max-width: 576px) {
.navbar-search .btn-search-submit {
flex: 1;
}
}
@@ -1,289 +0,0 @@
/*
* @File: post_detail.css
* @Description: 帖子详情页专用样式文件,实现了内容的清晰排版、评论区美化及响应式适配。
* @Author: Your Name
* @Date: 2023-10-27
*/
:root {
--bs-heading-color: #1a1a1a;
--post-detail-sidebar-break: 1200px;
}
/* 宽屏:左作者卡片 + 居中正文(右侧留空平衡) */
body.page-post-detail .main-container {
max-width: none;
width: 100%;
padding-left: 1rem;
padding-right: 1rem;
margin-left: auto;
margin-right: auto;
}
.post-detail-shell {
display: grid;
grid-template-columns: 1fr min(900px, 100%) 1fr;
align-items: start;
width: 100%;
}
.post-detail-aside {
grid-column: 1;
justify-self: end;
width: min(268px, 100%);
margin-top: 2rem;
padding-right: 1.5rem;
position: sticky;
top: 1.25rem;
}
/* 作者卡片:玻璃质感 + 纵向对齐,hover 仅上浮不做倾斜 */
.post-author-card {
position: relative;
display: flex;
flex-direction: column;
align-items: stretch;
gap: 0.7rem;
width: 100%;
padding: 1.35rem 1.15rem 1.2rem;
border-radius: 20px;
background: rgba(255, 255, 255, 0.12);
backdrop-filter: blur(12px);
border: 1px solid rgba(255, 255, 255, 0.5);
border-top: 1px solid rgba(255, 255, 255, 0.75);
border-left: 1px solid rgba(255, 255, 255, 0.75);
box-shadow: 0 22px 42px rgba(0, 0, 0, 0.07);
font-family: 'Poppins', sans-serif;
transition: transform 0.45s cubic-bezier(0.22, 1, 0.36, 1),
box-shadow 0.45s ease,
background 0.35s ease;
overflow: hidden;
}
.post-author-card__quote {
position: absolute;
top: 10px;
left: 10px;
width: 52px;
height: 52px;
border-radius: 10px;
background: rgba(255, 255, 255, 0.1) url(https://s3.cflmy.cn/cflmy/left-quote.png) center / 40px no-repeat;
border: 1px solid rgba(255, 255, 255, 0.45);
opacity: 0;
transition: opacity 0.4s ease;
pointer-events: none;
}
.post-author-card__avatar {
align-self: center;
position: relative;
z-index: 1;
padding: 9px;
border-radius: 14px;
background: rgba(255, 255, 255, 0.14);
backdrop-filter: blur(6px);
border: 1px solid rgba(255, 255, 255, 0.55);
border-top: 1px solid rgba(255, 255, 255, 0.75);
box-shadow: 0 14px 28px rgba(0, 0, 0, 0.08);
transition: transform 0.45s cubic-bezier(0.22, 1, 0.36, 1),
box-shadow 0.45s ease;
}
.post-author-card__avatar--link {
text-decoration: none;
color: inherit;
cursor: pointer;
}
.post-author-card__avatar--link:focus-visible {
outline: 2px solid rgba(168, 88, 120, 0.75);
outline-offset: 3px;
}
.post-author-card__avatar img {
display: block;
width: 88px;
height: 88px;
border-radius: 10px;
object-fit: cover;
border: 1px solid rgba(255, 255, 255, 0.45);
}
.post-author-card__name {
margin: 0;
padding: 0.15rem 0.25rem 0;
text-align: center;
font-size: 1.05rem;
font-weight: 600;
color: #644651;
word-break: break-word;
transition: color 0.3s ease;
}
.post-author-card__body {
display: flex;
flex-direction: column;
align-items: center;
padding: 0 0.25rem 0.15rem;
text-align: center;
transition: transform 0.45s cubic-bezier(0.22, 1, 0.36, 1);
}
.post-author-card__signature {
margin: 0;
color: #644651;
font-size: 0.82rem;
line-height: 1.55;
}
.post-author-card__signature--empty {
color: #9a8490;
font-style: italic;
}
.post-author-card:hover {
transform: translateY(-7px);
background: rgba(255, 255, 255, 0.16);
box-shadow: 0 30px 52px rgba(0, 0, 0, 0.11);
}
.post-author-card:hover .post-author-card__quote {
opacity: 0.85;
}
.post-author-card:hover .post-author-card__avatar {
transform: translateY(-5px) scale(1.03);
box-shadow: 0 18px 34px rgba(0, 0, 0, 0.11);
}
.post-author-card:hover .post-author-card__name {
color: #4a3340;
}
.post-author-card:hover .post-author-card__body {
transform: translateY(-2px);
}
.post-author-card:hover .post-author-card__signature {
color: #4a3340;
}
/* --- 1. 页面布局与容器样式 --- */
.main-container {
width: 100%;
max-width: 900px;
margin: 2rem auto;
padding: 0 1rem;
}
body.page-post-detail .main-container {
margin-top: 2rem;
margin-bottom: 2rem;
}
.post-detail {
grid-column: 2;
background-color: rgba(255, 255, 255, 0.2);
backdrop-filter: blur(24px);
border: 1px solid rgba(255, 255, 255, 0.2);
box-shadow: inset 0 0 5px rgba(255, 255, 255, 0.1);
border-radius: 30px;
padding: 50px 100px;
transition: all 0.3s ease;
}
/* --- 2. 帖子头部元信息(非主体)样式 --- */
.post-detail h2 {
font-size: 2rem;
font-weight: 700;
color: #212529; /* 标题偏深但非纯黑,低于主体优先级 */
margin-bottom: 1.5rem;
line-height: 1.4;
}
/* 详情页顶栏元信息(仅直接子级 p,勿用 :first-of-type,否则会误伤 article) */
.post-detail > p.post-content {
display: flex;
flex-wrap: wrap;
gap: 0.5rem 1.5rem;
font-size: 0.9rem;
margin-bottom: 2rem;
padding-bottom: 1rem;
border-bottom: 1px solid #e9ecef;
}
.post-author-profile a {
color: #a85878;
text-decoration: none;
font-weight: 500;
}
.post-author-profile a:hover {
text-decoration: underline;
}
/* --- 3. 帖子/新闻正文卡片 --- */
article.anlian-rich-content,
article.post-content.anlian-rich-content,
article.news-content.anlian-rich-content {
display: block;
margin-bottom: 3rem;
background-color: rgba(255, 255, 255, 0.45);
padding: 2.2rem;
border-radius: 1rem;
box-shadow: 0 3px 10px rgba(0, 0, 0, 0.06);
}
/* 主体内图片样式见 rich_content.css */
/* 评论表单由 anlian_forms.css 统一;此处仅保留错误列表 */
.post-detail .error-messages {
list-style: none;
padding: 0;
margin: 0 0 1rem;
color: #b33a4d;
font-size: 0.875rem;
}
.post-detail .text-muted a {
color: #a85878;
font-weight: 500;
}
.post-detail .anlian-comment-form {
margin-bottom: 1.75rem;
}
/* --- 5. 响应式适配:主体字号同步调整,保持区分度 --- */
@media (max-width: 1199.98px) {
.post-detail-aside {
display: none;
}
.post-detail-shell {
display: block;
}
body.page-post-detail .main-container {
max-width: 900px;
}
}
@media (max-width: 767.98px) {
.main-container {
margin: 1rem auto;
}
.post-detail {
padding: 1.5rem;
}
.post-detail h2 {
font-size: 1.75rem;
}
/* 移动端正文卡片 */
article.anlian-rich-content,
article.post-content.anlian-rich-content {
padding: 1.5rem;
}
}
@@ -1,27 +0,0 @@
/* 发帖 / 发新闻编辑页 */
.anlian-publish-page {
max-width: 800px;
margin: 0 auto;
padding: 1.5rem 1rem 2.5rem;
box-sizing: border-box;
}
.anlian-publish-page .anlian-page-title {
margin-bottom: 1.25rem;
}
.anlian-publish-page .anlian-form-card {
padding: 2rem 1.75rem;
}
.anlian-publish-page .anlian-editor-wrap {
margin-top: 0.25rem;
min-height: 360px;
}
@media (max-width: 576px) {
.anlian-publish-page .anlian-form-card {
padding: 1.35rem 1.15rem;
}
}
@@ -1,131 +0,0 @@
/**
* 富文本正文 — 编辑器与详情页共用,保证 Enter 换行所见即所得
*/
:root {
--anlian-rich-font-size: 1.2rem;
--anlian-rich-line-height: 1.85;
--anlian-rich-color: #000;
--anlian-rich-weight: 450;
/* Enter 新段落:约半行间距,接近自然换行 */
--anlian-rich-p-gap: 0.28em;
/* 空行(<p><br></p>):略大于段内换行 */
--anlian-rich-blank-gap: 0.55em;
}
/* 详情页正文 + wangEditor 编辑区 */
.anlian-rich-content,
.anlian-editor-wrap .w-e-text-container .w-e-text {
display: block;
font-size: var(--anlian-rich-font-size) !important;
line-height: var(--anlian-rich-line-height) !important;
color: var(--anlian-rich-color) !important;
font-weight: var(--anlian-rich-weight);
word-wrap: break-word;
overflow-wrap: break-word;
}
.anlian-rich-content p,
.anlian-editor-wrap .w-e-text-container .w-e-text p {
display: block;
margin: 0 0 var(--anlian-rich-p-gap);
padding: 0;
}
.anlian-rich-content p:last-child,
.anlian-editor-wrap .w-e-text-container .w-e-text p:last-child {
margin-bottom: 0;
}
/* 连按 Enter 产生的空行 */
.anlian-rich-content p:empty,
.anlian-rich-content p:has(> br:only-child),
.anlian-editor-wrap .w-e-text-container .w-e-text p:empty,
.anlian-editor-wrap .w-e-text-container .w-e-text p:has(> br:only-child) {
margin: 0 0 var(--anlian-rich-blank-gap);
min-height: var(--anlian-rich-blank-gap);
line-height: var(--anlian-rich-blank-gap);
}
.anlian-rich-content h1,
.anlian-rich-content h2,
.anlian-rich-content h3,
.anlian-rich-content h4,
.anlian-editor-wrap .w-e-text-container .w-e-text h1,
.anlian-editor-wrap .w-e-text-container .w-e-text h2,
.anlian-editor-wrap .w-e-text-container .w-e-text h3,
.anlian-editor-wrap .w-e-text-container .w-e-text h4 {
display: block;
margin: 0.75em 0 0.35em;
font-weight: 700;
line-height: 1.4;
color: var(--anlian-rich-color);
}
.anlian-rich-content h1:first-child,
.anlian-rich-content h2:first-child,
.anlian-editor-wrap .w-e-text-container .w-e-text h1:first-child,
.anlian-editor-wrap .w-e-text-container .w-e-text h2:first-child {
margin-top: 0;
}
.anlian-rich-content a,
.anlian-editor-wrap .w-e-text-container .w-e-text a {
color: #a85878;
text-decoration: underline;
}
.anlian-rich-content blockquote,
.anlian-editor-wrap .w-e-text-container .w-e-text blockquote {
margin: 0.5em 0;
padding: 0.35em 0 0.35em 1em;
border-left: 3px solid rgba(253, 189, 219, 0.85);
color: #333;
}
.anlian-rich-content ul,
.anlian-rich-content ol,
.anlian-editor-wrap .w-e-text-container .w-e-text ul,
.anlian-editor-wrap .w-e-text-container .w-e-text ol {
margin: 0.35em 0;
padding-left: 1.5em;
}
.anlian-rich-content li,
.anlian-editor-wrap .w-e-text-container .w-e-text li {
margin: 0.15em 0;
}
.anlian-rich-content img,
.anlian-editor-wrap .w-e-text-container .w-e-text img {
max-width: 80%;
max-height: 600px;
height: auto;
display: block;
margin: 1em auto;
border-radius: 0.8rem;
box-shadow: 0 2px 10px rgba(0, 0, 0, 0.1);
}
/* 编辑区内边距,接近详情页正文卡片 */
.anlian-editor-wrap .w-e-text-container .w-e-text {
padding: 1.25rem 1.5rem !important;
min-height: 280px;
box-sizing: border-box;
}
@media (max-width: 767.98px) {
:root {
--anlian-rich-font-size: 1.15rem;
}
.anlian-rich-content img,
.anlian-editor-wrap .w-e-text-container .w-e-text img {
max-width: 95%;
}
.anlian-editor-wrap .w-e-text-container .w-e-text {
padding: 1rem 1.1rem !important;
min-height: 240px;
}
}
-363
View File
@@ -1,363 +0,0 @@
/**
* 全站搜索页 — 粉色毛玻璃主题(与 anlian_forms / feed 一致)
*/
.search-page {
--search-accent: #fdbbdb;
--search-accent-deep: #f0a8c4;
--search-accent-text: #a85878;
--search-muted: #888;
--search-radius: 18px;
--search-glass: rgba(255, 255, 255, 0.42);
--search-ring: rgba(253, 189, 219, 0.48);
width: min(100% - 2rem, 920px);
margin: 0 auto;
padding: 1.25rem 0 2.5rem;
box-sizing: border-box;
}
/* —— 顶部搜索框(页内) —— */
.search-header {
position: relative;
overflow: hidden;
padding: 1.35rem 1.5rem;
margin-bottom: 1rem;
border-radius: var(--search-radius);
background: transparent;
border: none;
box-shadow: 0 8px 28px rgba(253, 189, 219, 0.12);
}
.search-header::before {
content: '';
position: absolute;
inset: 0;
z-index: 0;
border-radius: inherit;
background: var(--search-glass);
backdrop-filter: blur(16px);
-webkit-backdrop-filter: blur(16px);
}
.search-header::after {
content: '';
position: absolute;
inset: 0;
z-index: 0;
border-radius: inherit;
box-shadow: inset 0 0 0 1px var(--search-ring);
pointer-events: none;
}
.search-header > * {
position: relative;
z-index: 1;
}
.search-title {
margin: 0 0 1rem;
font-size: 1.5rem;
font-weight: 700;
color: var(--search-accent-text);
text-align: center;
}
.search-form {
display: flex;
gap: 0.55rem;
align-items: stretch;
}
.search-input {
flex: 1;
min-width: 0;
padding: 0.72rem 1rem;
font-size: 1rem;
border: 1px solid rgba(253, 189, 219, 0.45);
border-radius: 12px;
background: rgba(255, 255, 255, 0.58);
color: #222;
transition: border-color 0.2s ease, box-shadow 0.2s ease;
}
.search-input::placeholder {
color: #999;
}
.search-input:focus {
outline: none;
border-color: var(--search-accent-deep);
box-shadow: 0 0 0 3px rgba(253, 189, 219, 0.28);
background: rgba(255, 255, 255, 0.72);
}
.search-submit {
flex-shrink: 0;
padding: 0 1.4rem;
font-size: 0.9375rem;
font-weight: 600;
color: var(--search-accent-text);
background: linear-gradient(135deg, rgba(253, 189, 219, 0.58), rgba(240, 168, 196, 0.68));
border: 1px solid rgba(240, 168, 196, 0.75);
border-radius: 999px;
cursor: pointer;
transition: box-shadow 0.2s ease, transform 0.2s ease;
}
.search-submit:hover {
box-shadow: 0 5px 18px rgba(253, 189, 219, 0.32);
transform: translateY(-1px);
}
/* —— 结果总栏(含「共找到」) —— */
.search-panel {
position: relative;
overflow: hidden;
padding: 1.25rem 1.35rem 1.35rem;
border-radius: var(--search-radius);
background: transparent;
box-shadow: 0 6px 26px rgba(253, 189, 219, 0.1);
}
.search-panel::before {
content: '';
position: absolute;
inset: 0;
z-index: 0;
border-radius: inherit;
background: var(--search-glass);
backdrop-filter: blur(14px);
-webkit-backdrop-filter: blur(14px);
}
.search-panel::after {
content: '';
position: absolute;
inset: 0;
z-index: 0;
border-radius: inherit;
box-shadow: inset 0 0 0 1px var(--search-ring);
pointer-events: none;
}
.search-panel > * {
position: relative;
z-index: 1;
}
.search-panel--message {
padding: 1.5rem;
}
.search-panel__head {
margin-bottom: 1.15rem;
padding-bottom: 1rem;
border-bottom: 1px solid rgba(253, 189, 219, 0.35);
text-align: center;
}
.search-panel__title {
margin: 0 0 0.5rem;
font-size: 1.2rem;
font-weight: 700;
color: var(--search-accent-text);
}
.search-summary {
margin: 0;
font-size: 0.9375rem;
color: #444;
line-height: 1.5;
}
.search-summary strong {
color: var(--search-accent-text);
font-weight: 700;
}
.search-sort-hint {
margin: 0.45rem 0 0;
font-size: 0.75rem;
color: var(--search-muted);
}
.search-hint,
.search-empty {
margin: 0;
font-size: 0.9375rem;
color: var(--search-muted);
text-align: center;
}
/* —— 分类区块 —— */
.search-block {
margin-top: 1.15rem;
padding-top: 1rem;
border-top: 1px dashed rgba(253, 189, 219, 0.35);
}
.search-block:first-of-type {
margin-top: 0;
padding-top: 0;
border-top: none;
}
.search-block__head {
display: flex;
align-items: center;
justify-content: space-between;
gap: 0.75rem;
margin-bottom: 0.85rem;
}
.search-block__title {
margin: 0;
font-size: 1.05rem;
font-weight: 700;
color: var(--search-accent-text);
}
.search-block__badge {
flex-shrink: 0;
padding: 0.2rem 0.65rem;
font-size: 0.75rem;
font-weight: 600;
color: var(--search-accent-text);
background: rgba(253, 189, 219, 0.32);
border: 1px solid rgba(253, 189, 219, 0.45);
border-radius: 999px;
}
.search-result-list {
list-style: none;
margin: 0;
padding: 0;
display: flex;
flex-direction: column;
gap: 0.65rem;
}
/* —— 单条结果卡片(边框区分) —— */
.search-card {
padding: 0.9rem 1rem;
border-radius: 14px;
background: rgba(255, 255, 255, 0.48);
border: 1px solid rgba(253, 189, 219, 0.42);
box-shadow: 0 2px 12px rgba(253, 189, 219, 0.08);
transition: border-color 0.2s ease, box-shadow 0.2s ease;
}
.search-card:hover {
border-color: rgba(240, 168, 196, 0.65);
box-shadow: 0 6px 20px rgba(253, 189, 219, 0.16);
}
.search-card--user {
padding: 0.75rem 1rem;
}
.search-card__title {
display: block;
font-size: 1rem;
font-weight: 600;
color: #222;
text-decoration: none;
line-height: 1.35;
}
.search-card__title:hover {
color: var(--search-accent-text);
}
.search-card__meta {
margin: 0.35rem 0 0;
font-size: 0.78rem;
color: var(--search-muted);
}
.search-card__snippet {
margin: 0.45rem 0 0;
font-size: 0.875rem;
line-height: 1.55;
color: #444;
}
.search-block__footer {
display: flex;
justify-content: center;
margin-top: 1rem;
}
.search-action-btn {
display: inline-flex;
align-items: center;
justify-content: center;
min-height: 2.5rem;
padding: 0.5rem 1.35rem;
font-size: 0.875rem;
font-weight: 600;
color: var(--search-accent-text);
text-decoration: none;
border-radius: 999px;
border: 1px solid rgba(240, 168, 196, 0.65);
background: linear-gradient(135deg, rgba(253, 189, 219, 0.45), rgba(240, 168, 196, 0.52));
box-shadow: 0 3px 12px rgba(253, 189, 219, 0.18);
transition: box-shadow 0.2s ease, transform 0.2s ease;
}
.search-action-btn:hover {
text-decoration: none;
color: var(--search-accent-text);
box-shadow: 0 5px 18px rgba(253, 189, 219, 0.28);
transform: translateY(-1px);
}
/* —— 分页 —— */
.search-pagination {
margin-top: 1rem;
}
.search-pagination .page-link {
color: var(--search-accent-text);
background: rgba(255, 255, 255, 0.45);
border: 1px solid rgba(253, 189, 219, 0.4);
border-radius: 8px;
margin: 0.15rem;
}
.search-pagination .page-link:hover {
background: rgba(253, 189, 219, 0.35);
color: var(--search-accent-text);
}
.search-pagination .page-item.active .page-link {
background: rgba(253, 189, 219, 0.55);
border-color: rgba(240, 168, 196, 0.6);
color: var(--search-accent-text);
}
.search-pagination .page-item.disabled .page-link {
background: rgba(255, 255, 255, 0.25);
color: #aaa;
}
@media (max-width: 576px) {
.search-page {
width: min(100% - 1rem, 920px);
}
.search-form {
flex-direction: column;
}
.search-submit {
width: 100%;
padding: 0.68rem;
}
.search-block__head {
flex-direction: column;
align-items: flex-start;
}
}
@@ -1,215 +0,0 @@
/**
* 专题书架 — 书本式卡片
*/
.topic-shelf-page .topic-shelf-header {
margin-bottom: 2rem;
}
.topic-shelf-lead {
margin: 0;
text-align: center;
font-size: 0.95rem;
color: rgba(17, 17, 17, 0.75);
line-height: 1.6;
}
.topic-book-grid {
list-style: none;
margin: 0;
padding: 0;
display: grid;
grid-template-columns: repeat(auto-fill, minmax(15rem, 1fr));
gap: 2.25rem 1.75rem;
align-items: stretch;
}
.topic-book-item {
margin: 0;
display: flex;
}
.topic-book {
display: flex;
flex-direction: column;
align-items: center;
text-decoration: none;
color: inherit;
width: 100%;
min-height: 100%;
transition: transform 0.35s ease;
}
.topic-book:hover,
.topic-book:focus-visible {
transform: translateY(-6px);
text-decoration: none;
color: inherit;
}
.topic-book__volume {
position: relative;
display: flex;
align-items: stretch;
width: 12.5rem;
height: 17.5rem;
margin-bottom: 1.1rem;
perspective: 900px;
filter: drop-shadow(0 14px 28px rgba(61, 32, 64, 0.35));
}
.topic-book__spine {
width: 1.65rem;
flex-shrink: 0;
background: linear-gradient(180deg, #5c2d4a 0%, #3d2040 55%, #2a1528 100%);
border-radius: 4px 0 0 4px;
box-shadow: inset -2px 0 6px rgba(0, 0, 0, 0.25);
display: flex;
align-items: center;
justify-content: center;
padding: 0.65rem 0.15rem;
}
/* 书脊竖排:汉字正向自上而下(勿 rotate 180°) */
.topic-book__spine-title {
writing-mode: vertical-rl;
text-orientation: upright;
font-size: 0.7rem;
font-weight: 600;
letter-spacing: 0.12em;
color: rgba(255, 232, 245, 0.92);
line-height: 1.45;
max-height: 14rem;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.topic-book__cover {
position: relative;
flex: 1;
overflow: hidden;
border-radius: 0 6px 6px 0;
background: #2a1528;
transform-origin: left center;
transition: transform 0.4s ease;
}
.topic-book:hover .topic-book__cover {
transform: rotateY(-8deg);
}
.topic-book__cover img {
width: 100%;
height: 100%;
object-fit: cover;
display: block;
}
.topic-book__shine {
pointer-events: none;
position: absolute;
inset: 0;
background: linear-gradient(
125deg,
rgba(255, 255, 255, 0.28) 0%,
transparent 42%,
transparent 58%,
rgba(253, 189, 219, 0.12) 100%
);
}
.topic-book__info {
display: flex;
flex-direction: column;
align-items: center;
text-align: center;
width: 14rem;
min-height: 10.5rem;
flex: 1;
}
.topic-book__title {
margin: 0 0 0.5rem;
min-height: 2.85rem;
display: flex;
align-items: center;
justify-content: center;
font-size: 1.05rem;
font-weight: 600;
color: #1a1020;
line-height: 1.35;
}
.topic-book__summary {
flex: 1;
width: 100%;
min-height: 3.9rem;
margin: 0 0 0.75rem;
font-size: 0.8125rem;
line-height: 1.55;
color: rgba(26, 16, 32, 0.72);
display: -webkit-box;
-webkit-line-clamp: 3;
-webkit-box-orient: vertical;
overflow: hidden;
}
.topic-book__summary:empty::before {
content: '\00a0';
visibility: hidden;
}
.topic-book__cta {
display: inline-block;
margin-top: auto;
flex-shrink: 0;
font-size: 0.75rem;
font-weight: 600;
letter-spacing: 0.04em;
color: #6b3458;
padding: 0.28rem 0.85rem;
border-radius: 999px;
background: rgba(253, 189, 219, 0.35);
border: 1px solid rgba(253, 189, 219, 0.55);
transition: background 0.2s, box-shadow 0.2s;
}
.topic-book:hover .topic-book__cta {
background: rgba(253, 189, 219, 0.55);
box-shadow: 0 4px 12px rgba(253, 189, 219, 0.3);
}
.topic-shelf-empty {
text-align: center;
padding: 3rem 1rem;
color: rgba(17, 17, 17, 0.65);
}
@media (max-width: 576px) {
.topic-book-grid {
grid-template-columns: 1fr;
justify-items: center;
}
.topic-book__volume {
width: 11rem;
height: 15.5rem;
}
}
@media (prefers-reduced-motion: reduce) {
.topic-book,
.topic-book__cover {
transition: none;
}
.topic-book:hover,
.topic-book:focus-visible {
transform: none;
}
.topic-book:hover .topic-book__cover {
transform: none;
}
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 436 B

Binary file not shown.

Before

Width:  |  Height:  |  Size: 631 B

Binary file not shown.

Before

Width:  |  Height:  |  Size: 4.8 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 76 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 111 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 436 B

-101
View File
@@ -1,101 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<svg version="1.1" width="64" height="64" viewBox="0 0 64 64" xmlns="http://www.w3.org/2000/svg" shape-rendering="crispEdges">
<rect x="16" y="16" width="32" height="1" fill="#000000"/>
<rect x="16" y="17" width="32" height="1" fill="#000000"/>
<rect x="16" y="18" width="32" height="1" fill="#000000"/>
<rect x="16" y="19" width="3" height="1" fill="#000000"/>
<rect x="16" y="20" width="3" height="1" fill="#000000"/>
<rect x="20" y="20" width="11" height="1" fill="#000000"/>
<rect x="33" y="20" width="2" height="1" fill="#000000"/>
<rect x="16" y="21" width="3" height="1" fill="#000000"/>
<rect x="20" y="21" width="11" height="1" fill="#000000"/>
<rect x="33" y="21" width="2" height="1" fill="#000000"/>
<rect x="16" y="22" width="3" height="1" fill="#000000"/>
<rect x="20" y="22" width="2" height="1" fill="#000000"/>
<rect x="33" y="22" width="2" height="1" fill="#000000"/>
<rect x="16" y="23" width="3" height="1" fill="#000000"/>
<rect x="20" y="23" width="2" height="1" fill="#000000"/>
<rect x="33" y="23" width="2" height="1" fill="#000000"/>
<rect x="16" y="24" width="3" height="1" fill="#000000"/>
<rect x="20" y="24" width="2" height="1" fill="#000000"/>
<rect x="33" y="24" width="2" height="1" fill="#000000"/>
<rect x="16" y="25" width="3" height="1" fill="#000000"/>
<rect x="20" y="25" width="9" height="1" fill="#000000"/>
<rect x="33" y="25" width="2" height="1" fill="#000000"/>
<rect x="16" y="26" width="3" height="1" fill="#000000"/>
<rect x="20" y="26" width="9" height="1" fill="#000000"/>
<rect x="33" y="26" width="2" height="1" fill="#000000"/>
<rect x="16" y="27" width="3" height="1" fill="#000000"/>
<rect x="20" y="27" width="2" height="1" fill="#000000"/>
<rect x="33" y="27" width="2" height="1" fill="#000000"/>
<rect x="16" y="28" width="3" height="1" fill="#000000"/>
<rect x="20" y="28" width="2" height="1" fill="#000000"/>
<rect x="33" y="28" width="2" height="1" fill="#000000"/>
<rect x="16" y="29" width="3" height="1" fill="#000000"/>
<rect x="20" y="29" width="2" height="1" fill="#000000"/>
<rect x="33" y="29" width="12" height="1" fill="#000000"/>
<rect x="16" y="30" width="3" height="1" fill="#000000"/>
<rect x="20" y="30" width="2" height="1" fill="#000000"/>
<rect x="33" y="30" width="12" height="1" fill="#000000"/>
<rect x="16" y="31" width="3" height="1" fill="#000000"/>
<rect x="16" y="32" width="3" height="1" fill="#000000"/>
<rect x="16" y="33" width="3" height="1" fill="#000000"/>
<rect x="20" y="33" width="11" height="1" fill="#000000"/>
<rect x="33" y="33" width="2" height="1" fill="#000000"/>
<rect x="43" y="33" width="2" height="1" fill="#000000"/>
<rect x="16" y="34" width="3" height="1" fill="#000000"/>
<rect x="20" y="34" width="11" height="1" fill="#000000"/>
<rect x="33" y="34" width="2" height="1" fill="#000000"/>
<rect x="43" y="34" width="2" height="1" fill="#000000"/>
<rect x="16" y="35" width="3" height="1" fill="#000000"/>
<rect x="20" y="35" width="2" height="1" fill="#000000"/>
<rect x="24" y="35" width="3" height="1" fill="#000000"/>
<rect x="29" y="35" width="2" height="1" fill="#000000"/>
<rect x="33" y="35" width="2" height="1" fill="#000000"/>
<rect x="43" y="35" width="2" height="1" fill="#000000"/>
<rect x="16" y="36" width="3" height="1" fill="#000000"/>
<rect x="20" y="36" width="2" height="1" fill="#000000"/>
<rect x="24" y="36" width="3" height="1" fill="#000000"/>
<rect x="29" y="36" width="2" height="1" fill="#000000"/>
<rect x="33" y="36" width="2" height="1" fill="#000000"/>
<rect x="43" y="36" width="2" height="1" fill="#000000"/>
<rect x="16" y="37" width="3" height="1" fill="#000000"/>
<rect x="20" y="37" width="2" height="1" fill="#000000"/>
<rect x="24" y="37" width="3" height="1" fill="#000000"/>
<rect x="29" y="37" width="2" height="1" fill="#000000"/>
<rect x="33" y="37" width="12" height="1" fill="#000000"/>
<rect x="16" y="38" width="3" height="1" fill="#000000"/>
<rect x="20" y="38" width="2" height="1" fill="#000000"/>
<rect x="24" y="38" width="3" height="1" fill="#000000"/>
<rect x="29" y="38" width="2" height="1" fill="#000000"/>
<rect x="33" y="38" width="12" height="1" fill="#000000"/>
<rect x="16" y="39" width="3" height="1" fill="#000000"/>
<rect x="20" y="39" width="2" height="1" fill="#000000"/>
<rect x="24" y="39" width="3" height="1" fill="#000000"/>
<rect x="29" y="39" width="2" height="1" fill="#000000"/>
<rect x="43" y="39" width="2" height="1" fill="#000000"/>
<rect x="16" y="40" width="3" height="1" fill="#000000"/>
<rect x="20" y="40" width="2" height="1" fill="#000000"/>
<rect x="24" y="40" width="3" height="1" fill="#000000"/>
<rect x="29" y="40" width="2" height="1" fill="#000000"/>
<rect x="43" y="40" width="2" height="1" fill="#000000"/>
<rect x="16" y="41" width="3" height="1" fill="#000000"/>
<rect x="20" y="41" width="2" height="1" fill="#000000"/>
<rect x="24" y="41" width="3" height="1" fill="#000000"/>
<rect x="29" y="41" width="2" height="1" fill="#000000"/>
<rect x="43" y="41" width="2" height="1" fill="#000000"/>
<rect x="16" y="42" width="3" height="1" fill="#000000"/>
<rect x="20" y="42" width="2" height="1" fill="#000000"/>
<rect x="24" y="42" width="3" height="1" fill="#000000"/>
<rect x="29" y="42" width="2" height="1" fill="#000000"/>
<rect x="33" y="42" width="12" height="1" fill="#000000"/>
<rect x="16" y="43" width="3" height="1" fill="#000000"/>
<rect x="20" y="43" width="2" height="1" fill="#000000"/>
<rect x="24" y="43" width="3" height="1" fill="#000000"/>
<rect x="29" y="43" width="2" height="1" fill="#000000"/>
<rect x="33" y="43" width="12" height="1" fill="#000000"/>
<rect x="16" y="44" width="3" height="1" fill="#000000"/>
<rect x="16" y="45" width="32" height="1" fill="#000000"/>
<rect x="16" y="46" width="32" height="1" fill="#000000"/>
<rect x="16" y="47" width="32" height="1" fill="#000000"/>
</svg>

Before

Width:  |  Height:  |  Size: 5.7 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 19 KiB

@@ -1,117 +0,0 @@
/**
* 列表页局部刷新:板块切换与分页,无全页重载、无加载动画。
*/
(function () {
const AJAX_HEADERS = { 'X-Requested-With': 'XMLHttpRequest' };
document.addEventListener('DOMContentLoaded', function () {
initFeedListPartial();
initCommentListPartial();
});
function initFeedListPartial() {
const page = document.querySelector('.feed-list-page[data-partial-feed]');
if (!page) return;
page.addEventListener('click', function (event) {
const tab = event.target.closest('.feed-tab');
const pageLink = event.target.closest('.feed-pagination .page-link[href]');
const link = tab || pageLink;
if (!link || link.classList.contains('disabled')) return;
event.preventDefault();
loadFeedPartial(page, link.href);
});
}
async function loadFeedPartial(page, url) {
const body = page.querySelector('.feed-list-body');
if (!body) return;
try {
const response = await fetch(url, { headers: AJAX_HEADERS });
if (!response.ok) throw new Error(String(response.status));
const html = await response.text();
const doc = new DOMParser().parseFromString(html, 'text/html');
const newBody = doc.querySelector('.feed-list-body');
const newPagination = doc.querySelector('.feed-pagination');
if (newBody) body.innerHTML = newBody.innerHTML;
let pagination = page.querySelector('.feed-pagination');
if (newPagination) {
if (pagination) {
pagination.replaceWith(newPagination);
} else {
body.insertAdjacentElement('afterend', newPagination);
}
pagination = newPagination;
} else if (pagination) {
pagination.remove();
}
syncFeedTabsFromUrl(page, url);
history.pushState(null, '', url);
page.scrollIntoView({ block: 'nearest', behavior: 'instant' in window ? 'instant' : 'auto' });
} catch (err) {
console.error('列表局部刷新失败', err);
}
}
function syncFeedTabsFromUrl(page, url) {
const parsed = new URL(url, window.location.origin);
const boardId = parsed.searchParams.get('board_id')
|| parsed.searchParams.get('news_board_id')
|| '';
const param = parsed.searchParams.has('news_board_id') ? 'news_board_id' : 'board_id';
page.querySelectorAll('.feed-tab').forEach((tab) => {
const tabUrl = new URL(tab.href, window.location.origin);
const tabBoard = tabUrl.searchParams.get(param) || '';
const isActive = tabBoard === boardId;
tab.classList.toggle('active', isActive);
});
const activeTab = page.querySelector('.feed-tab.active');
const bar = page.querySelector('[data-feed-board]');
if (activeTab && bar && typeof initFeedBoardUI === 'function') {
initFeedBoardUI(bar);
}
}
function initCommentListPartial() {
const root = document.querySelector('[data-partial-comments]');
if (!root) return;
root.addEventListener('click', function (event) {
const link = event.target.closest('.comment-pagination .page-link[href]');
if (!link) return;
event.preventDefault();
loadCommentPartial(root, link.href);
});
}
async function loadCommentPartial(root, url) {
const list = root.querySelector('.comment-list-container');
const pagination = root.querySelector('.comment-pagination');
if (!list) return;
try {
const response = await fetch(url, { headers: AJAX_HEADERS });
if (!response.ok) throw new Error(String(response.status));
const html = await response.text();
const doc = new DOMParser().parseFromString(html, 'text/html');
const newList = doc.querySelector('.comment-list-container');
const newPagination = doc.querySelector('.comment-pagination');
if (newList) list.innerHTML = newList.innerHTML;
if (newPagination && pagination) {
pagination.replaceWith(newPagination);
} else if (newPagination) {
list.insertAdjacentElement('afterend', newPagination);
} else if (pagination) {
pagination.remove();
}
history.replaceState(null, '', url);
} catch (err) {
console.error('评论分页刷新失败', err);
}
}
})();
@@ -1,35 +0,0 @@
(function () {
'use strict';
document.addEventListener('DOMContentLoaded', function () {
var input = document.getElementById('chat-room-search-input');
var grid = document.getElementById('chat-room-grid');
var emptyHint = document.getElementById('chat-search-empty');
if (!input || !grid) {
return;
}
var cards = grid.querySelectorAll('.chat-room-card');
function filterRooms() {
var query = input.value.trim().toLowerCase();
var visibleCount = 0;
cards.forEach(function (card) {
var haystack = (card.dataset.search || '').toLowerCase();
var match = !query || haystack.indexOf(query) !== -1;
card.hidden = !match;
if (match) {
visibleCount += 1;
}
});
if (emptyHint) {
emptyHint.hidden = visibleCount > 0 || !query;
}
}
input.addEventListener('input', filterRooms);
filterRooms();
});
})();
-286
View File
@@ -1,286 +0,0 @@
(function () {
'use strict';
function wsBaseUrl() {
var scheme = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
return scheme + '//' + window.location.host;
}
function escapeHtml(text) {
var div = document.createElement('div');
div.textContent = text;
return div.innerHTML;
}
function formatContent(text) {
return escapeHtml(text).replace(/\n/g, '<br>');
}
function scrollToBottom(container) {
if (!container) {
return;
}
container.scrollTop = container.scrollHeight;
}
function removeEmptyHint(container) {
var empty = container.querySelector('.chat-empty');
if (empty) {
empty.remove();
}
}
function buildRoomMessageNode(data, profileBase) {
var article = document.createElement('article');
article.className = 'chat-message' + (data.is_mine ? ' chat-message-mine' : '');
article.dataset.messageId = String(data.id);
var profileLink = '';
if (!data.is_anonymous && data.author_username) {
profileLink =
'<a class="chat-profile-link" href="' +
profileBase +
encodeURIComponent(data.author_username) +
'/">主页</a>';
}
article.innerHTML =
'<img class="chat-avatar" src="' +
escapeHtml(data.author_avatar_url) +
'" alt="" width="40" height="40" loading="lazy" decoding="async">' +
'<div class="chat-message-body">' +
'<header class="chat-message-meta">' +
'<strong class="chat-author">' +
escapeHtml(data.author_display) +
'</strong>' +
profileLink +
'<time datetime="' +
escapeHtml(data.create_time_iso || '') +
'">' +
escapeHtml(data.create_time || '') +
'</time>' +
'</header>' +
'<p class="chat-content">' +
formatContent(data.content) +
'</p>' +
'</div>';
return article;
}
function buildDirectMessageNode(data) {
var article = document.createElement('article');
article.className = 'chat-message' + (data.is_mine ? ' chat-message-mine' : '');
article.dataset.messageId = String(data.id);
article.innerHTML =
'<img class="chat-avatar" src="' +
escapeHtml(data.author_avatar_url) +
'" alt="" width="40" height="40" loading="lazy" decoding="async">' +
'<div class="chat-message-body">' +
'<header class="chat-message-meta">' +
'<strong class="chat-author">' +
escapeHtml(data.author_display) +
'</strong>' +
'<time datetime="' +
escapeHtml(data.create_time_iso || '') +
'">' +
escapeHtml(data.create_time || '') +
'</time>' +
'</header>' +
'<p class="chat-content">' +
formatContent(data.content) +
'</p>' +
'</div>';
return article;
}
function appendMessage(container, node) {
removeEmptyHint(container);
if (container.querySelector('[data-message-id="' + node.dataset.messageId + '"]')) {
return;
}
container.appendChild(node);
scrollToBottom(container);
}
function setStatus(root, text, isError) {
var status = root.querySelector('.chat-ws-status');
if (!status) {
return;
}
status.textContent = text;
status.classList.toggle('chat-ws-status-error', !!isError);
status.classList.toggle('chat-ws-status-ok', !isError);
}
function initChatApp(root) {
var wsPath = root.dataset.wsPath;
var kind = root.dataset.chatKind || 'room';
var canSend = root.dataset.canSend === '1';
var profileBase = root.dataset.profileBase || '/user/';
var messagesEl = root.querySelector('#chat-messages');
var form = root.querySelector('.chat-compose');
var textarea = form ? form.querySelector('textarea[name="content"]') : null;
var anonInput = form ? form.querySelector('input[name="is_anonymous"]') : null;
var errorBox = root.querySelector('.chat-ws-errors');
var socket = null;
var reconnectTimer = null;
var reconnectDelay = 1000;
var reconnectAttempts = 0;
var maxReconnectAttempts = 12;
if (!wsPath || !messagesEl) {
return;
}
function showError(detail) {
if (!errorBox) {
return;
}
errorBox.textContent = detail;
errorBox.hidden = false;
}
function clearError() {
if (errorBox) {
errorBox.hidden = true;
errorBox.textContent = '';
}
}
function connect() {
if (socket && (socket.readyState === WebSocket.OPEN || socket.readyState === WebSocket.CONNECTING)) {
return;
}
setStatus(root, '连接中…', false);
socket = new WebSocket(wsBaseUrl() + wsPath);
socket.addEventListener('open', function () {
reconnectDelay = 1000;
reconnectAttempts = 0;
setStatus(root, '已连接', false);
clearError();
});
socket.addEventListener('message', function (event) {
var payload;
try {
payload = JSON.parse(event.data);
} catch (err) {
return;
}
if (payload.event === 'connected') {
setStatus(root, '已连接', false);
return;
}
if (payload.event === 'error') {
showError(payload.detail || '发送失败');
return;
}
if (payload.event === 'message' && payload.message) {
clearError();
var node =
kind === 'direct'
? buildDirectMessageNode(payload.message)
: buildRoomMessageNode(payload.message, profileBase);
appendMessage(messagesEl, node);
}
});
socket.addEventListener('close', function () {
socket = null;
reconnectAttempts += 1;
if (reconnectAttempts >= maxReconnectAttempts) {
setStatus(root, '连接失败', true);
showError('无法连接聊天服务器,请刷新页面后重试');
return;
}
setStatus(root, '连接已断开,正在重连…', true);
reconnectTimer = window.setTimeout(function () {
reconnectDelay = Math.min(reconnectDelay * 2, 15000);
connect();
}, reconnectDelay);
});
socket.addEventListener('error', function () {
setStatus(root, '连接异常', true);
});
}
if (form && canSend) {
form.addEventListener('submit', function (event) {
event.preventDefault();
clearError();
if (!socket || socket.readyState !== WebSocket.OPEN) {
showError('尚未连接到服务器,请稍候再试');
connect();
return;
}
var content = (textarea && textarea.value ? textarea.value : '').trim();
if (!content) {
showError('消息不能为空');
return;
}
socket.send(
JSON.stringify({
action: 'send',
content: content,
is_anonymous: !!(anonInput && anonInput.checked),
})
);
if (textarea) {
textarea.value = '';
}
});
}
scrollToBottom(messagesEl);
function scheduleConnect() {
var started = false;
function run() {
if (started) {
return;
}
started = true;
connect();
}
if (form) {
form.addEventListener('focusin', run, { once: true });
}
if ('requestIdleCallback' in window) {
requestIdleCallback(run, { timeout: 2500 });
} else {
setTimeout(run, 100);
}
}
setStatus(root, '待连接', false);
scheduleConnect();
window.addEventListener('beforeunload', function () {
if (reconnectTimer) {
window.clearTimeout(reconnectTimer);
}
if (socket) {
socket.close();
}
});
}
document.addEventListener('DOMContentLoaded', function () {
var root = document.getElementById('chat-app');
if (root) {
initChatApp(root);
}
});
})();
@@ -1,98 +0,0 @@
(function () {
'use strict';
function perView() {
return window.matchMedia('(min-width: 768px)').matches ? 2 : 1;
}
function pageCount(total, pv) {
if (total <= 0) return 0;
return Math.max(1, total - pv + 1);
}
function initCarousel(root) {
var track = root.querySelector('.detail-recommend-track');
var dotsWrap = root.querySelector('.detail-recommend-dots');
if (!track || !dotsWrap) return;
var slides = track.querySelectorAll('.detail-recommend-slide');
var total = slides.length;
if (total === 0) return;
var index = 0;
var timer = null;
var pv = perView();
var pages = pageCount(total, pv);
function renderDots() {
dotsWrap.innerHTML = '';
for (var i = 0; i < pages; i++) {
var btn = document.createElement('button');
btn.type = 'button';
btn.className = 'detail-recommend-dot' + (i === index ? ' is-active' : '');
btn.setAttribute('aria-label', '第 ' + (i + 1) + ' 组推荐');
btn.setAttribute('aria-selected', i === index ? 'true' : 'false');
btn.dataset.page = String(i);
btn.addEventListener('click', function () {
goTo(parseInt(this.dataset.page, 10));
restartAuto();
});
dotsWrap.appendChild(btn);
}
}
function applyTransform() {
var slidePct = 100 / pv;
track.style.transform = 'translateX(-' + index * slidePct + '%)';
var dotEls = dotsWrap.querySelectorAll('.detail-recommend-dot');
dotEls.forEach(function (el, i) {
el.classList.toggle('is-active', i === index);
el.setAttribute('aria-selected', i === index ? 'true' : 'false');
});
}
function goTo(i) {
index = Math.max(0, Math.min(i, pages - 1));
applyTransform();
}
function restartAuto() {
if (timer) clearInterval(timer);
if (pages <= 1) return;
timer = setInterval(function () {
goTo((index + 1) % pages);
}, 5000);
}
function onResize() {
var newPv = perView();
if (newPv !== pv) {
pv = newPv;
pages = pageCount(total, pv);
if (index >= pages) index = pages - 1;
renderDots();
}
applyTransform();
}
renderDots();
applyTransform();
restartAuto();
window.addEventListener('resize', onResize);
root.addEventListener('mouseenter', function () {
if (timer) clearInterval(timer);
});
root.addEventListener('mouseleave', restartAuto);
}
function boot() {
document.querySelectorAll('[data-recommend-carousel]').forEach(initCarousel);
}
if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', boot);
} else {
boot();
}
})();
@@ -1,62 +0,0 @@
/**
* 分段板块栏:横向滚动 + 滑动光晕(首页与列表页共用)
*/
function initFeedBoardUI(root) {
if (!root) return;
const scrollWrap = root.querySelector('.home-posts-tabs-scroll, .feed-tabs-scroll');
const scrollLeft = root.querySelector('.home-posts-scroll-left, .feed-scroll-left');
const scrollRight = root.querySelector('.home-posts-scroll-right, .feed-scroll-right');
const spotlight = root.querySelector('.home-posts-spotlight, .feed-spotlight');
const segment = root.querySelector('.home-posts-segment, .feed-segment');
if (scrollWrap && scrollLeft && scrollRight) {
const scrollAmount = 140;
scrollLeft.addEventListener('click', function () {
scrollWrap.scrollBy({ left: -scrollAmount, behavior: 'smooth' });
});
scrollRight.addEventListener('click', function () {
scrollWrap.scrollBy({ left: scrollAmount, behavior: 'smooth' });
});
function updateScrollButtons() {
const max = scrollWrap.scrollWidth - scrollWrap.clientWidth;
const atStart = scrollWrap.scrollLeft <= 4;
const atEnd = scrollWrap.scrollLeft >= max - 4;
scrollLeft.classList.toggle('is-hidden', atStart);
scrollRight.classList.toggle('is-hidden', atEnd);
}
updateScrollButtons();
scrollWrap.addEventListener('scroll', updateScrollButtons);
window.addEventListener('resize', updateScrollButtons);
}
if (spotlight && segment) {
const tabSelector = '.home-posts-tab, .feed-tab';
const moveSpotlight = (tab) => {
if (!tab) return;
const pad = segment.getBoundingClientRect();
const rect = tab.getBoundingClientRect();
const left = rect.left - pad.left;
spotlight.style.setProperty('--spot-l', `${left}px`);
spotlight.style.setProperty('--spot-w', `${rect.width}px`);
};
moveSpotlight(root.querySelector(`${tabSelector}.active`));
root.querySelectorAll(tabSelector).forEach((tab) => {
tab.addEventListener('click', () => {
requestAnimationFrame(() => moveSpotlight(tab));
});
});
window.addEventListener('resize', () => {
moveSpotlight(root.querySelector(`${tabSelector}.active`));
});
}
}
document.addEventListener('DOMContentLoaded', function () {
document.querySelectorAll('[data-feed-board]').forEach(initFeedBoardUI);
});
-99
View File
@@ -1,99 +0,0 @@
/**
* 首页:新闻/帖子板块 AJAX(板块栏交互见 feed_board.js)
*/
document.addEventListener('DOMContentLoaded', function () {
if (document.body.classList.contains('page-home')) {
initHomePanelSwap();
}
});
function initHomePanelSwap() {
const newsPanel = document.getElementById('homeNewsPanel');
const postPanel = document.getElementById('tenPostContainer');
bindPanelTabs({
tabSelector: '.js-home-news-tab',
panel: newsPanel,
queryKey: 'news_board_id',
getBoardId: (el) => el.dataset.newsBoard || '0',
onAfterActive: (tab) => syncFeedBoardSpotlight('.home-news-board-bar', tab),
});
bindPanelTabs({
tabSelector: '.js-home-post-tab',
panel: postPanel,
queryKey: 'board_id',
getBoardId: (el) => el.dataset.board || '0',
onAfterActive: (tab) => syncFeedBoardSpotlight('.home-posts-board-bar', tab),
});
}
function bindPanelTabs({ tabSelector, panel, queryKey, getBoardId, onSwapped, onAfterActive }) {
if (!panel) return;
document.addEventListener('click', function (e) {
const tab = e.target.closest(tabSelector);
if (!tab) return;
e.preventDefault();
if (tab.classList.contains('active')) return;
const boardId = getBoardId(tab);
const requestUrl = tab.getAttribute('href');
setActiveTab(tabSelector, tab);
if (typeof onAfterActive === 'function') {
onAfterActive(tab);
}
swapPanelHtml(panel, requestUrl, onSwapped);
updateHomeUrlParam(queryKey, boardId);
});
}
function setActiveTab(tabSelector, activeTab) {
const root = activeTab.closest('.home-posts-tabs');
if (!root) return;
root.querySelectorAll(tabSelector).forEach((el) => el.classList.remove('active'));
activeTab.classList.add('active');
}
function syncFeedBoardSpotlight(barSelector, tab) {
const root = document.querySelector(barSelector);
if (!root || !tab) return;
const spotlight = root.querySelector('.home-posts-spotlight');
const segment = root.querySelector('.home-posts-segment');
if (!spotlight || !segment) return;
const pad = segment.getBoundingClientRect();
const rect = tab.getBoundingClientRect();
spotlight.style.setProperty('--spot-l', `${rect.left - pad.left}px`);
spotlight.style.setProperty('--spot-w', `${rect.width}px`);
}
async function swapPanelHtml(panel, url, onSwapped) {
try {
const response = await fetch(url, {
headers: { 'X-Requested-With': 'XMLHttpRequest' },
});
if (!response.ok) throw new Error(response.status);
const html = await response.text();
panel.innerHTML = html;
if (typeof onSwapped === 'function') {
onSwapped(panel);
}
} catch (err) {
console.error('板块内容加载失败', err);
panel.innerHTML =
'<p class="home-panel-error text-muted text-center py-3">加载失败,请稍后重试</p>';
}
}
function updateHomeUrlParam(key, value) {
const url = new URL(window.location.href);
if (value === '0') {
url.searchParams.delete(key);
} else {
url.searchParams.set(key, value);
}
history.replaceState(null, '', url.pathname + url.search);
}
-101
View File
@@ -1,101 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<svg version="1.1" width="64" height="64" viewBox="0 0 64 64" xmlns="http://www.w3.org/2000/svg" shape-rendering="crispEdges">
<rect x="16" y="16" width="32" height="1" fill="#000000"/>
<rect x="16" y="17" width="32" height="1" fill="#000000"/>
<rect x="16" y="18" width="32" height="1" fill="#000000"/>
<rect x="16" y="19" width="3" height="1" fill="#000000"/>
<rect x="16" y="20" width="3" height="1" fill="#000000"/>
<rect x="20" y="20" width="11" height="1" fill="#000000"/>
<rect x="33" y="20" width="2" height="1" fill="#000000"/>
<rect x="16" y="21" width="3" height="1" fill="#000000"/>
<rect x="20" y="21" width="11" height="1" fill="#000000"/>
<rect x="33" y="21" width="2" height="1" fill="#000000"/>
<rect x="16" y="22" width="3" height="1" fill="#000000"/>
<rect x="20" y="22" width="2" height="1" fill="#000000"/>
<rect x="33" y="22" width="2" height="1" fill="#000000"/>
<rect x="16" y="23" width="3" height="1" fill="#000000"/>
<rect x="20" y="23" width="2" height="1" fill="#000000"/>
<rect x="33" y="23" width="2" height="1" fill="#000000"/>
<rect x="16" y="24" width="3" height="1" fill="#000000"/>
<rect x="20" y="24" width="2" height="1" fill="#000000"/>
<rect x="33" y="24" width="2" height="1" fill="#000000"/>
<rect x="16" y="25" width="3" height="1" fill="#000000"/>
<rect x="20" y="25" width="9" height="1" fill="#000000"/>
<rect x="33" y="25" width="2" height="1" fill="#000000"/>
<rect x="16" y="26" width="3" height="1" fill="#000000"/>
<rect x="20" y="26" width="9" height="1" fill="#000000"/>
<rect x="33" y="26" width="2" height="1" fill="#000000"/>
<rect x="16" y="27" width="3" height="1" fill="#000000"/>
<rect x="20" y="27" width="2" height="1" fill="#000000"/>
<rect x="33" y="27" width="2" height="1" fill="#000000"/>
<rect x="16" y="28" width="3" height="1" fill="#000000"/>
<rect x="20" y="28" width="2" height="1" fill="#000000"/>
<rect x="33" y="28" width="2" height="1" fill="#000000"/>
<rect x="16" y="29" width="3" height="1" fill="#000000"/>
<rect x="20" y="29" width="2" height="1" fill="#000000"/>
<rect x="33" y="29" width="12" height="1" fill="#000000"/>
<rect x="16" y="30" width="3" height="1" fill="#000000"/>
<rect x="20" y="30" width="2" height="1" fill="#000000"/>
<rect x="33" y="30" width="12" height="1" fill="#000000"/>
<rect x="16" y="31" width="3" height="1" fill="#000000"/>
<rect x="16" y="32" width="3" height="1" fill="#000000"/>
<rect x="16" y="33" width="3" height="1" fill="#000000"/>
<rect x="20" y="33" width="11" height="1" fill="#000000"/>
<rect x="33" y="33" width="2" height="1" fill="#000000"/>
<rect x="43" y="33" width="2" height="1" fill="#000000"/>
<rect x="16" y="34" width="3" height="1" fill="#000000"/>
<rect x="20" y="34" width="11" height="1" fill="#000000"/>
<rect x="33" y="34" width="2" height="1" fill="#000000"/>
<rect x="43" y="34" width="2" height="1" fill="#000000"/>
<rect x="16" y="35" width="3" height="1" fill="#000000"/>
<rect x="20" y="35" width="2" height="1" fill="#000000"/>
<rect x="24" y="35" width="3" height="1" fill="#000000"/>
<rect x="29" y="35" width="2" height="1" fill="#000000"/>
<rect x="33" y="35" width="2" height="1" fill="#000000"/>
<rect x="43" y="35" width="2" height="1" fill="#000000"/>
<rect x="16" y="36" width="3" height="1" fill="#000000"/>
<rect x="20" y="36" width="2" height="1" fill="#000000"/>
<rect x="24" y="36" width="3" height="1" fill="#000000"/>
<rect x="29" y="36" width="2" height="1" fill="#000000"/>
<rect x="33" y="36" width="2" height="1" fill="#000000"/>
<rect x="43" y="36" width="2" height="1" fill="#000000"/>
<rect x="16" y="37" width="3" height="1" fill="#000000"/>
<rect x="20" y="37" width="2" height="1" fill="#000000"/>
<rect x="24" y="37" width="3" height="1" fill="#000000"/>
<rect x="29" y="37" width="2" height="1" fill="#000000"/>
<rect x="33" y="37" width="12" height="1" fill="#000000"/>
<rect x="16" y="38" width="3" height="1" fill="#000000"/>
<rect x="20" y="38" width="2" height="1" fill="#000000"/>
<rect x="24" y="38" width="3" height="1" fill="#000000"/>
<rect x="29" y="38" width="2" height="1" fill="#000000"/>
<rect x="33" y="38" width="12" height="1" fill="#000000"/>
<rect x="16" y="39" width="3" height="1" fill="#000000"/>
<rect x="20" y="39" width="2" height="1" fill="#000000"/>
<rect x="24" y="39" width="3" height="1" fill="#000000"/>
<rect x="29" y="39" width="2" height="1" fill="#000000"/>
<rect x="43" y="39" width="2" height="1" fill="#000000"/>
<rect x="16" y="40" width="3" height="1" fill="#000000"/>
<rect x="20" y="40" width="2" height="1" fill="#000000"/>
<rect x="24" y="40" width="3" height="1" fill="#000000"/>
<rect x="29" y="40" width="2" height="1" fill="#000000"/>
<rect x="43" y="40" width="2" height="1" fill="#000000"/>
<rect x="16" y="41" width="3" height="1" fill="#000000"/>
<rect x="20" y="41" width="2" height="1" fill="#000000"/>
<rect x="24" y="41" width="3" height="1" fill="#000000"/>
<rect x="29" y="41" width="2" height="1" fill="#000000"/>
<rect x="43" y="41" width="2" height="1" fill="#000000"/>
<rect x="16" y="42" width="3" height="1" fill="#000000"/>
<rect x="20" y="42" width="2" height="1" fill="#000000"/>
<rect x="24" y="42" width="3" height="1" fill="#000000"/>
<rect x="29" y="42" width="2" height="1" fill="#000000"/>
<rect x="33" y="42" width="12" height="1" fill="#000000"/>
<rect x="16" y="43" width="3" height="1" fill="#000000"/>
<rect x="20" y="43" width="2" height="1" fill="#000000"/>
<rect x="24" y="43" width="3" height="1" fill="#000000"/>
<rect x="29" y="43" width="2" height="1" fill="#000000"/>
<rect x="33" y="43" width="12" height="1" fill="#000000"/>
<rect x="16" y="44" width="3" height="1" fill="#000000"/>
<rect x="16" y="45" width="32" height="1" fill="#000000"/>
<rect x="16" y="46" width="32" height="1" fill="#000000"/>
<rect x="16" y="47" width="32" height="1" fill="#000000"/>
</svg>

Before

Width:  |  Height:  |  Size: 5.7 KiB

@@ -1 +0,0 @@
:root,[data-bs-theme=light]{--bs-blue: #0d6efd;--bs-indigo: #6610f2;--bs-purple: #6f42c1;--bs-pink: #d63384;--bs-red: #dc3545;--bs-orange: #fd7e14;--bs-yellow: #ffc107;--bs-green: #198754;--bs-teal: #20c997;--bs-cyan: #0dcaf0;--bs-black: #000;--bs-white: #fff;--bs-gray: #6c757d;--bs-gray-dark: #343a40;--bs-gray-100: #f8f9fa;--bs-gray-200: #e9ecef;--bs-gray-300: #dee2e6;--bs-gray-400: #ced4da;--bs-gray-500: #adb5bd;--bs-gray-600: #6c757d;--bs-gray-700: #495057;--bs-gray-800: #343a40;--bs-gray-900: #212529;--bs-primary: #0d6efd;--bs-secondary: #6c757d;--bs-success: #198754;--bs-info: #0dcaf0;--bs-warning: #ffc107;--bs-danger: #dc3545;--bs-light: #f8f9fa;--bs-dark: #212529;--bs-primary-rgb: 13, 110, 253;--bs-secondary-rgb: 108, 117, 125;--bs-success-rgb: 25, 135, 84;--bs-info-rgb: 13, 202, 240;--bs-warning-rgb: 255, 193, 7;--bs-danger-rgb: 220, 53, 69;--bs-light-rgb: 248, 249, 250;--bs-dark-rgb: 33, 37, 41;--bs-primary-text-emphasis: #052c65;--bs-secondary-text-emphasis: #2b2f32;--bs-success-text-emphasis: #0a3622;--bs-info-text-emphasis: #055160;--bs-warning-text-emphasis: #664d03;--bs-danger-text-emphasis: #58151c;--bs-light-text-emphasis: #495057;--bs-dark-text-emphasis: #495057;--bs-primary-bg-subtle: #cfe2ff;--bs-secondary-bg-subtle: #e2e3e5;--bs-success-bg-subtle: #d1e7dd;--bs-info-bg-subtle: #cff4fc;--bs-warning-bg-subtle: #fff3cd;--bs-danger-bg-subtle: #f8d7da;--bs-light-bg-subtle: #fcfcfd;--bs-dark-bg-subtle: #ced4da;--bs-primary-border-subtle: #9ec5fe;--bs-secondary-border-subtle: #c4c8cb;--bs-success-border-subtle: #a3cfbb;--bs-info-border-subtle: #9eeaf9;--bs-warning-border-subtle: #ffe69c;--bs-danger-border-subtle: #f1aeb5;--bs-light-border-subtle: #e9ecef;--bs-dark-border-subtle: #adb5bd;--bs-white-rgb: 255, 255, 255;--bs-black-rgb: 0, 0, 0;--bs-font-sans-serif: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", "Liberation Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";--bs-font-monospace: SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;--bs-gradient: linear-gradient(180deg, rgba(255, 255, 255, 0.15), rgba(255, 255, 255, 0));--bs-body-font-family: var(--bs-font-sans-serif);--bs-body-font-size:1rem;--bs-body-font-weight: 400;--bs-body-line-height: 1.5;--bs-body-color: #212529;--bs-body-color-rgb: 33, 37, 41;--bs-body-bg: #fff;--bs-body-bg-rgb: 255, 255, 255;--bs-emphasis-color: #000;--bs-emphasis-color-rgb: 0, 0, 0;--bs-secondary-color: rgba(33, 37, 41, 0.75);--bs-secondary-color-rgb: 33, 37, 41;--bs-secondary-bg: #e9ecef;--bs-secondary-bg-rgb: 233, 236, 239;--bs-tertiary-color: rgba(33, 37, 41, 0.5);--bs-tertiary-color-rgb: 33, 37, 41;--bs-tertiary-bg: #f8f9fa;--bs-tertiary-bg-rgb: 248, 249, 250;--bs-heading-color: inherit;--bs-link-color: #0d6efd;--bs-link-color-rgb: 13, 110, 253;--bs-link-decoration: underline;--bs-link-hover-color: #0a58ca;--bs-link-hover-color-rgb: 10, 88, 202;--bs-code-color: #d63384;--bs-highlight-color: #212529;--bs-highlight-bg: #fff3cd;--bs-border-width: 1px;--bs-border-style: solid;--bs-border-color: #dee2e6;--bs-border-color-translucent: rgba(0, 0, 0, 0.175);--bs-border-radius: 0.375rem;--bs-border-radius-sm: 0.25rem;--bs-border-radius-lg: 0.5rem;--bs-border-radius-xl: 1rem;--bs-border-radius-xxl: 2rem;--bs-border-radius-2xl: var(--bs-border-radius-xxl);--bs-border-radius-pill: 50rem;--bs-box-shadow: 0 0.5rem 1rem rgba(0, 0, 0, 0.15);--bs-box-shadow-sm: 0 0.125rem 0.25rem rgba(0, 0, 0, 0.075);--bs-box-shadow-lg: 0 1rem 3rem rgba(0, 0, 0, 0.175);--bs-box-shadow-inset: inset 0 1px 2px rgba(0, 0, 0, 0.075);--bs-focus-ring-width: 0.25rem;--bs-focus-ring-opacity: 0.25;--bs-focus-ring-color: rgba(13, 110, 253, 0.25);--bs-form-valid-color: #198754;--bs-form-valid-border-color: #198754;--bs-form-invalid-color: #dc3545;--bs-form-invalid-border-color: #dc3545}[data-bs-theme=dark]{color-scheme:dark;--bs-body-color: #dee2e6;--bs-body-color-rgb: 222, 226, 230;--bs-body-bg: #212529;--bs-body-bg-rgb: 33, 37, 41;--bs-emphasis-color: #fff;--bs-emphasis-color-rgb: 255, 255, 255;--bs-secondary-color: rgba(222, 226, 230, 0.75);--bs-secondary-color-rgb: 222, 226, 230;--bs-secondary-bg: #343a40;--bs-secondary-bg-rgb: 52, 58, 64;--bs-tertiary-color: rgba(222, 226, 230, 0.5);--bs-tertiary-color-rgb: 222, 226, 230;--bs-tertiary-bg: #2b3035;--bs-tertiary-bg-rgb: 43, 48, 53;--bs-primary-text-emphasis: #6ea8fe;--bs-secondary-text-emphasis: #a7acb1;--bs-success-text-emphasis: #75b798;--bs-info-text-emphasis: #6edff6;--bs-warning-text-emphasis: #ffda6a;--bs-danger-text-emphasis: #ea868f;--bs-light-text-emphasis: #f8f9fa;--bs-dark-text-emphasis: #dee2e6;--bs-primary-bg-subtle: #031633;--bs-secondary-bg-subtle: #161719;--bs-success-bg-subtle: #051b11;--bs-info-bg-subtle: #032830;--bs-warning-bg-subtle: #332701;--bs-danger-bg-subtle: #2c0b0e;--bs-light-bg-subtle: #343a40;--bs-dark-bg-subtle: #1a1d20;--bs-primary-border-subtle: #084298;--bs-secondary-border-subtle: #41464b;--bs-suLine truncated
@@ -1,7 +0,0 @@
/*!
* Bootstrap v5.3.2 (https://getbootstrap.com/)
* Copyright 2011-2023 The Bootstrap Authors (https://github.com/twbs/bootstrap/graphs/contributors)
* Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)
*/
!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?module.exports=e():"function"==typeof define&&define.amd?define(e):(t="undefined"!=typeof globalThis?globalThis:t||self).bootstrap=e()}(this,(function(){"use strict";const t=new Map,e={set(e,i,n){t.has(e)||t.set(e,new Map);const s=t.get(e);s.has(i)||0===s.size?s.set(i,n):console.error(`Bootstrap doesn't allow more than one instance per element. Bound instance: ${Array.from(s.keys())[0]}.`)},get:(e,i)=>t.has(e)&&t.get(e).get(i)||null,remove(e,i){if(!t.has(e))return;const n=t.get(e);n.delete(i),0===n.size&&t.delete(e)}},i="transitionend",n=t=>(t&&window.CSS&&window.CSS.escape&&(t=t.replace(/#([^\s"#']+)/g,((t,e)=>`#${CSS.escape(e)}`))),t),s=t=>{t.dispatchEvent(new Event(i))},o=t=>!(!t||"object"!=typeof t)&&(void 0!==t.jquery&&(t=t[0]),void 0!==t.nodeType),r=t=>o(t)?t.jquery?t[0]:t:"string"==typeof t&&t.length>0?document.querySelector(n(t)):null,a=t=>{if(!o(t)||0===t.getClientRects().length)return!1;const e="visible"===getComputedStyle(t).getPropertyValue("visibility"),i=t.closest("details:not([open])");if(!i)return e;if(i!==t){const e=t.closest("summary");if(e&&e.parentNode!==i)return!1;if(null===e)return!1}return e},l=t=>!t||t.nodeType!==Node.ELEMENT_NODE||!!t.classList.contains("disabled")||(void 0!==t.disabled?t.disabled:t.hasAttribute("disabled")&&"false"!==t.getAttribute("disabled")),c=t=>{if(!document.documentElement.attachShadow)return null;if("function"==typeof t.getRootNode){const e=t.getRootNode();return e instanceof ShadowRoot?e:null}return t instanceof ShadowRoot?t:t.parentNode?c(t.parentNode):null},h=()=>{},d=t=>{t.offsetHeight},u=()=>window.jQuery&&!document.body.hasAttribute("data-bs-no-jquery")?window.jQuery:null,f=[],p=()=>"rtl"===document.documentElement.dir,m=t=>{var e;e=()=>{const e=u();if(e){const i=t.NAME,n=e.fn[i];e.fn[i]=t.jQueryInterface,e.fn[i].Constructor=t,e.fn[i].noConflict=()=>(e.fn[i]=n,t.jQueryInterface)}},"loading"===document.readyState?(f.length||document.addEventListener("DOMContentLoaded",(()=>{for(const t of f)t()})),f.push(e)):e()},g=(t,e=[],i=t)=>"function"==typeof t?t(...e):i,_=(t,e,n=!0)=>{if(!n)return void g(t);const o=(t=>{if(!t)return 0;let{transitionDuration:e,transitionDelay:i}=window.getComputedStyle(t);const n=Number.parseFloat(e),s=Number.parseFloat(i);return n||s?(e=e.split(",")[0],i=i.split(",")[0],1e3*(Number.parseFloat(e)+Number.parseFloat(i))):0})(e)+5;let r=!1;const a=({target:n})=>{n===e&&(r=!0,e.removeEventListener(i,a),g(t))};e.addEventListener(i,a),setTimeout((()=>{r||s(e)}),o)},b=(t,e,i,n)=>{const s=t.length;let o=t.indexOf(e);return-1===o?!i&&n?t[s-1]:t[0]:(o+=i?1:-1,n&&(o=(o+s)%s),t[Math.max(0,Math.min(o,s-1))])},v=/[^.]*(?=\..*)\.|.*/,y=/\..*/,w=/::\d+$/,A={};let E=1;const T={mouseenter:"mouseover",mouseleave:"mouseout"},C=new Set(["click","dblclick","mouseup","mousedown","contextmenu","mousewheel","DOMMouseScroll","mouseover","mouseout","mousemove","selectstart","selectend","keydown","keypress","keyup","orientationchange","touchstart","touchmove","touchend","touchcancel","pointerdown","pointermove","pointerup","pointerleave","pointercancel","gesturestart","gesturechange","gestureend","focus","blur","change","reset","select","submit","focusin","focusout","load","unload","beforeunload","resize","move","DOMContentLoaded","readystatechange","error","abort","scroll"]);function O(t,e){return e&&`${e}::${E++}`||t.uidEvent||E++}function x(t){const e=O(t);return t.uidEvent=e,A[e]=A[e]||{},A[e]}function k(t,e,i=null){return Object.values(t).find((t=>t.callable===e&&t.delegationSelector===i))}function L(t,e,i){const n="string"==typeof e,s=n?i:e||i;let o=I(t);return C.has(o)||(o=t),[n,s,o]}function S(t,e,i,n,s){if("string"!=typeof e||!t)return;let[o,r,a]=L(e,i,n);if(e in T){const t=t=>function(e){if(!e.relatedTarget||e.relatedTarget!==e.delegateTarget&&!e.delegateTarget.contains(e.relatedTarget))return t.call(this,e)};r=t(r)}const l=x(t),c=l[a]||(l[a]={}),h=k(c,r,o?i:null);if(h)return void(h.oneOff=h.oneOff&&s);const d=O(r,e.replace(v,"")),u=o?function(t,e,i){return function n(s){const o=t.querySelectorAll(e);for(let{target:r}=s;r&&r!==this;r=r.parentNode)for(const a of o)if(a===r)return P(s,{delegateTarget:r}),n.oneOff&&N.off(t,s.type,e,i),i.apply(r,[s])}}(t,i,r):function(t,e){return function i(n){return P(n,{delegateTarget:t}),i.oneOff&&N.off(t,n.type,e),e.apply(t,[n])}}(t,r);u.delegationSelector=o?i:null,u.callable=r,u.oneOff=s,u.uidEvent=d,c[d]=u,t.addEventListener(a,u,o)}function D(t,e,i,n,s){const o=k(e[i],n,s);o&&(t.removeEventListener(i,o,Boolean(s)),delete e[i][o.uidEvent])}function $(t,e,i,n){const s=e[i]||{};for(const[o,r]of Object.entries(s))o.includes(n)&&D(t,e,i,r.callable,r.delegationSelector)}function I(t){return t=t.replace(y,""),T[t]||t}const N={on(t,e,i,n){S(t,e,i,n,!1)},one(t,e,i,n){S(t,e,i,n,!0)},off(t,e,i,n){if("string"!=typeof e||!t)return;const[s,o,r]=L(e,i,n),a=r!==e,l=x(t),c=l[r]||{},h=e.startsWith(".");if(void 0===o){if(h)for(const i of Object.keys(l))$(t,l,i,e.slLine truncated
//# sourceMappingURL=bootstrap.bundle.min.js.map
-64
View File
@@ -1,64 +0,0 @@
#!/usr/bin/env bash
# 暗恋见君 Marqdo 切片冒烟(需先启动 index.mq.md)。
set -uo pipefail
BASE="http://127.0.0.1:18180"
PASS=0; FAIL=0
ok() { echo " ok: $1"; PASS=$((PASS+1)); }
bad() { echo " FAIL: $1"; FAIL=$((FAIL+1)); }
echo "== 首页 =="
code=$(curl -s -o /dev/null -w "%{http_code}" "$BASE/")
[ "$code" = "200" ] && ok "GET /" || bad "GET / -> $code"
curl -s "$BASE/" | grep -q '暗恋见君' && ok "品牌" || bad "品牌"
curl -s "$BASE/" | grep -q 'class="hero"' && ok "Hero" || bad "Hero"
curl -s "$BASE/" | grep -q 'notice-title\|公告信息' && ok "公告" || bad "公告"
curl -s "$BASE/" | grep -q 'news-timeline\|新闻动态' && ok "新闻时间线" || bad "新闻时间线"
curl -s "$BASE/" | grep -q 'home-posts\|论坛交流' && ok "帖子区" || bad "帖子区"
curl -s "$BASE/" | grep -q 'bg-body-960\|/static/css/base.css' && ok "原站 CSS/背景" || bad "原站 CSS/背景"
curl -s -o /dev/null -w "%{http_code}" "$BASE/static/css/base.css" | grep -q 200 && ok "base.css" || bad "base.css"
echo "== 列表 / 详情 =="
curl -s "$BASE/post" | grep -q 'welcome\|欢迎\|论坛交流' && ok "帖子列表" || bad "帖子列表"
code=$(curl -s -o /dev/null -w "%{http_code}" "$BASE/post/welcome")
[ "$code" = "200" ] && ok "帖子详情" || bad "帖子详情 -> $code"
curl -s "$BASE/news" | grep -q 'migrate\|迁往\|新闻' && ok "新闻列表" || bad "新闻列表"
echo "== 片段 API =="
curl -s "$BASE/post/ten" | grep -q 'home-post-card\|欢迎' && ok "/post/ten" || bad "/post/ten"
curl -s "$BASE/news/five" | grep -q 'news-timeline\|迁往\|站点' && ok "/news/five" || bad "/news/five"
echo "== 其它页 =="
code=$(curl -s -o /dev/null -w "%{http_code}" "$BASE/topics")
[ "$code" = "200" ] && ok "专题" || bad "专题 -> $code"
code=$(curl -s -o /dev/null -w "%{http_code}" "$BASE/chat")
[ "$code" = "200" ] && ok "聊天列表" || bad "聊天列表 -> $code"
code=$(curl -s -o /dev/null -w "%{http_code}" "$BASE/guide/automation-api")
[ "$code" = "200" ] && ok "API 指南" || bad "API 指南 -> $code"
code=$(curl -s -o /dev/null -w "%{http_code}" "$BASE/sitemap.xml")
[ "$code" = "200" ] && ok "sitemap" || bad "sitemap -> $code"
echo "== 门禁 / 登录 =="
code=$(curl -s -o /dev/null -w "%{http_code}" "$BASE/post/public")
[ "$code" = "303" ] || [ "$code" = "302" ] && ok "未登录发帖重定向" || bad "发帖 -> $code"
rm -f /tmp/anlian_mq_hdr.txt
curl -s -D /tmp/anlian_mq_hdr.txt -o /dev/null -d "username=admin&password=anlian" "$BASE/accounts/login"
sid=$(grep -i "set-cookie" /tmp/anlian_mq_hdr.txt | sed 's/.*marqdo_sid=\([^;]*\).*/\1/' | head -1)
[ -n "$sid" ] && ok "会话 cookie" || bad "无 cookie"
code=$(curl -s -b "marqdo_sid=$sid" -o /dev/null -w "%{http_code}" "$BASE/post/public")
[ "$code" = "200" ] && ok "登录后发帖" || bad "登录后发帖 -> $code"
echo "== WS =="
wsok=$(python3 -c "
import socket, base64, os
s = socket.create_connection(('127.0.0.1', 18180), timeout=3)
key = base64.b64encode(os.urandom(16)).decode()
s.sendall((f'GET /chat/ws HTTP/1.1\r\nHost: x\r\nUpgrade: websocket\r\nConnection: Upgrade\r\nSec-WebSocket-Key: {key}\r\nSec-WebSocket-Version: 13\r\n\r\n').encode())
r = s.recv(1024).decode(errors='replace')
print('OK' if '101' in r.split('\r\n')[0] else 'NO')
s.close()
" 2>/dev/null)
[ "$wsok" = "OK" ] && ok "WebSocket" || bad "WebSocket $wsok"
echo
echo "通过 $PASS / $((PASS+FAIL))"
[ "$FAIL" = "0" ] || exit 1
-431
View File
@@ -1,431 +0,0 @@
---
markup: occlusion
title: styles/shell
description: 暗恋见君壳样式——对照 Django 原站粉玻璃 + 动效,用表格声明。
导入:
网页: ext/web/网页.mq.md
text: lib/text.mq.md
---
对照原站 `config/static/front/css/{base,feed_common,footer,index/hero}.css`:
固定背景图、毛玻璃顶栏、Logo 呼吸、Hero 漂浮、粉玻璃卡片与页脚。
## 基础
品牌色与全站底:固定摄影背景 + 粉玻璃变量。
`基础` =
| 选择器 | 属性 | 值 |
|--------|------|-----|
| :root | --ink | #333333 |
| :root | --ink-strong | #111111 |
| :root | --muted | #666666 |
| :root | --paper | #f8f9fa |
| :root | --glass | rgba(255,255,255,0.28) |
| :root | --glass-strong | rgba(255,255,255,0.42) |
| :root | --glass-border | rgba(255,255,255,0.5) |
| :root | --accent | #fdbbdb |
| :root | --accent-deep | #f0a8c4 |
| :root | --accent-text | #a85878 |
| :root | --accent-muted | #c97a96 |
| :root | --accent-bg | rgba(253,189,219,0.48) |
| :root | --hero-pink | #ffd0d0 |
| :root | --radius | 14px |
| :root | --sans | "Noto Sans SC", "IBM Plex Sans", system-ui, sans-serif |
| * | box-sizing | border-box |
| html | scroll-behavior | smooth |
| body | margin | "0" |
| body | min-height | 100vh |
| body | font-family | var(--sans) |
| body | color | var(--ink) |
| body | line-height | "1.6" |
| body | background-color | var(--paper) |
| body | background-image | url("/static/bg-body-960.webp") |
| body | background-repeat | no-repeat |
| body | background-size | cover |
| body | background-position | center center |
| body | background-attachment | fixed |
| body | overflow-x | hidden |
| a | color | var(--accent-text) |
| a | text-decoration | none |
| a:hover | color | var(--accent-deep) |
| ::selection | background | rgba(253,189,219,0.45) |
| main.main | padding | 0 0 3rem |
| .main-intro | max-width | 72rem |
| .main-intro | margin | 0 auto |
| .main-intro | padding | 1.25rem 1.5rem 0 |
*`基础`*
## 动效
原站 `pulse`(Logo)与 `heroImageFloat`(主图);尊重减动偏好。
`动效` =
| 选择器 | 属性 | 值 |
|--------|------|-----|
| @keyframes pulse 0% | transform | scale(1) |
| @keyframes pulse 50% | transform | scale(1.05) |
| @keyframes pulse 100% | transform | scale(1) |
| @keyframes heroImageFloat 0% | transform | scale(1) |
| @keyframes heroImageFloat 50% | transform | scale(1.04) |
| @keyframes heroImageFloat 100% | transform | scale(1) |
| @keyframes cardRise 0% | opacity | "0" |
| @keyframes cardRise 0% | transform | translateY(10px) |
| @keyframes cardRise 100% | opacity | "1" |
| @keyframes cardRise 100% | transform | translateY(0) |
*`动效`*
## 顶栏
毛玻璃导航;首项品牌带 Logo 呼吸动画。
`顶栏` =
| 选择器 | 属性 | 值 |
|--------|------|-----|
| header.topnav | grid-area | top |
| header.topnav | position | sticky |
| header.topnav | top | "0" |
| header.topnav | z-index | "1000" |
| header.topnav | width | 100% |
| header.topnav | padding | 0.75rem 1.25rem |
| header.topnav | background | rgba(255,255,255,0.2) |
| header.topnav | backdrop-filter | blur(24px) |
| header.topnav | -webkit-backdrop-filter | blur(24px) |
| header.topnav | border-bottom | 1px solid rgba(255,255,255,0.2) |
| header.topnav | box-shadow | inset 0 0 5px rgba(255,255,255,0.1) |
| ul.nav | list-style | none |
| ul.nav | margin | "0" |
| ul.nav | padding | "0" |
| ul.nav | display | flex |
| ul.nav | flex-wrap | wrap |
| ul.nav | align-items | center |
| ul.nav | gap | 0.35rem 0.5rem |
| ul.nav a | display | inline-flex |
| ul.nav a | align-items | center |
| ul.nav a | gap | 0.45rem |
| ul.nav a | padding | 0.4rem 0.85rem |
| ul.nav a | border-radius | 999px |
| ul.nav a | color | var(--ink) |
| ul.nav a | font-weight | "600" |
| ul.nav a | transition | color 0.2s ease, transform 0.2s ease, background 0.2s ease |
| ul.nav a:hover | color | var(--accent-text) |
| ul.nav a:hover | transform | translateY(-2px) |
| ul.nav a:hover | background | rgba(253,189,219,0.22) |
| ul.nav li:first-child a | font-size | 1.05rem |
| ul.nav li:first-child a | font-weight | "700" |
| ul.nav li:first-child a | letter-spacing | 0.04em |
| ul.nav li:first-child a | padding-left | 0.35rem |
| ul.nav li:first-child a::before | content | "" |
| ul.nav li:first-child a::before | width | 28px |
| ul.nav li:first-child a::before | height | 28px |
| ul.nav li:first-child a::before | background | url("/static/logo.svg") center / contain no-repeat |
| ul.nav li:first-child a::before | animation | pulse 3s ease-in-out infinite |
| ul.nav li:first-child a:hover | transform | none |
| ul.nav li:first-child a:hover | background | transparent |
*`顶栏`*
## Hero
首页双栏英雄区:大标题粉强调 + 主图漂浮。
`Hero` =
| 选择器 | 属性 | 值 |
|--------|------|-----|
| .hero | max-width | 72rem |
| .hero | margin | 0 auto 1.5rem |
| .hero | padding | 1.5rem 0.5rem 0.5rem |
| .hero-content | display | grid |
| .hero-content | grid-template-columns | minmax(0,1fr) minmax(0,1fr) |
| .hero-content | align-items | center |
| .hero-content | gap | 2rem |
| .hero-left | display | flex |
| .hero-left | flex-direction | column |
| .hero-left | align-items | flex-start |
| .hero-brand | display | inline-flex |
| .hero-brand | align-items | center |
| .hero-brand | gap | 0.55rem |
| .hero-brand | margin | 0 0 1rem |
| .hero-brand | font-size | 1.35rem |
| .hero-brand | font-weight | "700" |
| .hero-brand | letter-spacing | 0.08em |
| .hero-brand | text-transform | uppercase |
| .hero-brand | color | var(--ink-strong) |
| .hero-logo | width | 30px |
| .hero-logo | height | 30px |
| .hero-logo | animation | pulse 3s ease-in-out infinite |
| .hero-pink | color | var(--hero-pink) |
| .main-text | margin | 0 0 1.25rem |
| .main-text | font-size | clamp(2.4rem, 5.5vw, 5.2rem) |
| .main-text | font-weight | "800" |
| .main-text | line-height | "1.15" |
| .main-text | color | var(--ink-strong) |
| .sub-text | margin | 0 0 1.75rem |
| .sub-text | max-width | 34rem |
| .sub-text | font-size | 1.05rem |
| .sub-text | letter-spacing | 0.02em |
| .sub-text | color | rgba(60,60,60,0.85) |
| .hero-cta | display | flex |
| .hero-cta | flex-wrap | wrap |
| .hero-cta | gap | 0.65rem |
| .hero-btn | display | inline-flex |
| .hero-btn | align-items | center |
| .hero-btn | padding | 0.55rem 1.2rem |
| .hero-btn | border-radius | 999px |
| .hero-btn | font-weight | "600" |
| .hero-btn | color | #fff |
| .hero-btn | background | linear-gradient(120deg, var(--accent-deep), var(--accent)) |
| .hero-btn | box-shadow | 0 6px 18px rgba(253,189,219,0.45) |
| .hero-btn | transition | transform 0.2s ease, box-shadow 0.2s ease |
| .hero-btn:hover | transform | translateY(-2px) |
| .hero-btn:hover | color | #fff |
| .hero-btn:hover | box-shadow | 0 10px 24px rgba(253,189,219,0.55) |
| .hero-btn.ghost | background | rgba(255,255,255,0.35) |
| .hero-btn.ghost | color | var(--accent-text) |
| .hero-btn.ghost | border | 1px solid var(--glass-border) |
| .hero-btn.ghost | box-shadow | none |
| .hero-btn.ghost:hover | background | rgba(255,255,255,0.55) |
| .hero-btn.ghost:hover | color | var(--accent-text) |
| .hero-right | display | flex |
| .hero-right | align-items | center |
| .hero-right | justify-content | center |
| .hero-art | display | block |
| .hero-art | width | 85% |
| .hero-art | max-width | 420px |
| .hero-art | height | auto |
| .hero-art | filter | drop-shadow(0 0 20px rgba(255,208,208,0.45)) |
| .hero-art | animation | heroImageFloat 30s linear infinite |
| .hero-art | pointer-events | none |
| .home-feed-head | max-width | 52rem |
| .home-feed-head | margin | 0.5rem auto 0 |
| .home-feed-head | padding | 0 1.25rem |
| .home-feed-head h2 | margin | 0 0 0.35rem |
| .home-feed-head h2 | font-size | 1.35rem |
| .home-feed-head h2 | color | var(--accent-text) |
| .home-feed-head p | margin | "0" |
| .home-feed-head p | color | var(--muted) |
| .home-feed-head p | font-size | 0.92rem |
| .page-stage | max-width | 52rem |
| .page-stage | margin | 1.25rem auto 0 |
| .page-stage | padding | 1.25rem 1.35rem |
| .page-stage | border-radius | var(--radius) |
| .page-stage | background | var(--glass) |
| .page-stage | backdrop-filter | blur(14px) |
| .page-stage | -webkit-backdrop-filter | blur(14px) |
| .page-stage | border | 1px solid var(--glass-border) |
| .page-stage h1 | margin | 0 0 0.35rem |
| .page-stage h1 | font-size | 1.6rem |
| .page-stage h1 | color | var(--ink-strong) |
| .page-stage p | margin | "0" |
| .page-stage p | color | var(--muted) |
*`Hero`*
## 卡片
粉玻璃帖子/新闻卡:悬停上浮(对齐 `.home-post-card`)。
`卡片` =
| 选择器 | 属性 | 值 |
|--------|------|-----|
| .content.cards | max-width | 52rem |
| .content.cards | margin | 1rem auto 0 |
| .content.cards | padding | 0 1.25rem |
| .content.cards | display | flex |
| .content.cards | flex-direction | column |
| .content.cards | gap | 0.65rem |
| article.card | border-radius | var(--radius) |
| article.card | background | rgba(255,255,255,0.32) |
| article.card | backdrop-filter | blur(12px) |
| article.card | -webkit-backdrop-filter | blur(12px) |
| article.card | border | 1px solid rgba(255,255,255,0.42) |
| article.card | box-shadow | 0 4px 16px rgba(253,189,219,0.08) |
| article.card | transition | transform 0.2s ease, box-shadow 0.2s ease, background 0.2s ease |
| article.card | animation | cardRise 0.45s ease both |
| article.card:nth-child(2) | animation-delay | 0.05s |
| article.card:nth-child(3) | animation-delay | 0.1s |
| article.card:nth-child(4) | animation-delay | 0.15s |
| article.card:hover | transform | translateY(-2px) |
| article.card:hover | background | rgba(255,255,255,0.42) |
| article.card:hover | box-shadow | 0 8px 24px rgba(253,189,219,0.18) |
| a.card-link | display | grid |
| a.card-link | grid-template-columns | auto 1fr |
| a.card-link | grid-template-areas | "meta title" "meta body" |
| a.card-link | gap | 0.35rem 1rem |
| a.card-link | align-items | start |
| a.card-link | padding | 0.85rem 1rem |
| a.card-link | color | inherit |
| a.card-link | text-decoration | none |
| .card-meta | grid-area | meta |
| .card-meta | align-self | center |
| .card-meta | padding | 0.2rem 0.55rem |
| .card-meta | border-radius | 6px |
| .card-meta | font-size | 0.6875rem |
| .card-meta | font-weight | "600" |
| .card-meta | color | var(--accent-text) |
| .card-meta | background | rgba(253,189,219,0.28) |
| .card-meta | white-space | nowrap |
| .card-meta | max-width | 5rem |
| .card-meta | overflow | hidden |
| .card-meta | text-overflow | ellipsis |
| article.card h2 | grid-area | title |
| article.card h2 | margin | "0" |
| article.card h2 | font-size | 0.95rem |
| article.card h2 | font-weight | "600" |
| article.card h2 | color | #222 |
| article.card h2 | line-height | "1.35" |
| article.card p | grid-area | body |
| article.card p | margin | "0" |
| article.card p | font-size | 0.82rem |
| article.card p | color | #666 |
| article.card p | line-height | "1.45" |
| article.article | max-width | 42rem |
| article.article | margin | 1.5rem auto |
| article.article | padding | 1.5rem 1.6rem |
| article.article | border-radius | var(--radius) |
| article.article | background | rgba(255,255,255,0.55) |
| article.article | backdrop-filter | blur(16px) |
| article.article | -webkit-backdrop-filter | blur(16px) |
| article.article | border | 1px solid var(--glass-border) |
| article.article | box-shadow | 0 8px 28px rgba(253,189,219,0.12) |
| .article-meta | color | var(--accent-text) |
| .article-meta | font-size | 0.85rem |
| .article-meta | font-weight | "600" |
| .article-meta | margin-bottom | 0.5rem |
| .article-title | margin | 0 0 1rem |
| .article-title | font-size | 1.75rem |
| .article-title | color | var(--ink-strong) |
| .article-body | color | var(--ink) |
| .article-body | line-height | "1.75" |
| .site-form | max-width | 34rem |
| .site-form | margin | 1.5rem auto |
| .site-form | padding | 1.5rem |
| .site-form | border-radius | var(--radius) |
| .site-form | background | rgba(255,255,255,0.45) |
| .site-form | backdrop-filter | blur(14px) |
| .site-form | border | 1px solid var(--glass-border) |
| .chat-box | max-width | 42rem |
| .chat-box | margin | 1rem auto |
| .chat-box | padding | 1rem 1.15rem |
| .chat-box | border-radius | var(--radius) |
| .chat-box | background | rgba(255,255,255,0.4) |
| .chat-box | backdrop-filter | blur(12px) |
| .chat-box | border | 1px solid var(--glass-border) |
| .chat-log | min-height | 12rem |
| .chat-log | font-family | ui-monospace, monospace |
| .chat-log | font-size | 0.9rem |
| .chat-log | white-space | pre-wrap |
| .search-bar | display | flex |
| .search-bar | gap | 0.5rem |
| .search-bar | margin-top | 0.85rem |
| .search-bar input | flex | "1" |
| .search-bar input | padding | 0.55rem 0.8rem |
| .search-bar input | border-radius | 999px |
| .search-bar input | border | 1px solid rgba(253,189,219,0.55) |
| .search-bar input | background | rgba(255,255,255,0.65) |
| .search-bar button | padding | 0.55rem 1.1rem |
| .search-bar button | border | "0" |
| .search-bar button | border-radius | 999px |
| .search-bar button | background | var(--accent) |
| .search-bar button | color | var(--accent-text) |
| .search-bar button | font-weight | "600" |
| .search-bar button | cursor | pointer |
*`卡片`*
## 页脚
双栏粉玻璃页脚。
`页脚` =
| 选择器 | 属性 | 值 |
|--------|------|-----|
| footer.foot | grid-area | foot |
| footer.foot | margin-top | 2rem |
| footer.foot | padding | 2rem 1.5rem 2.5rem |
| footer.foot | background | rgba(255,255,255,0.28) |
| footer.foot | backdrop-filter | blur(14px) |
| footer.foot | -webkit-backdrop-filter | blur(14px) |
| footer.foot | border-top | 1px solid rgba(255,255,255,0.45) |
| footer.foot | box-shadow | inset 0 1px 0 rgba(255,255,255,0.35) |
| ul.foot-nav | list-style | none |
| ul.foot-nav | margin | 0 auto |
| ul.foot-nav | padding | "0" |
| ul.foot-nav | max-width | 52rem |
| ul.foot-nav | display | flex |
| ul.foot-nav | flex-wrap | wrap |
| ul.foot-nav | justify-content | center |
| ul.foot-nav | gap | 0.75rem 1.5rem |
| ul.foot-nav a | color | #444 |
| ul.foot-nav a | font-weight | "500" |
| ul.foot-nav a:hover | color | var(--accent-text) |
*`页脚`*
## 响应式
平板收窄标题;手机 Hero 单栏。
`响应式` =
| 媒体 | 选择器 | 属性 | 值 |
|------|--------|------|-----|
| (max-width: 1024px) | .hero-content | gap | 1.25rem |
| (max-width: 1024px) | .main-text | font-size | clamp(2.2rem, 4.5vw, 3.6rem) |
| (max-width: 1024px) | .hero-art | width | min(90%, 340px) |
| (max-width: 767px) | .hero-content | grid-template-columns | 1fr |
| (max-width: 767px) | .hero-left | align-items | center |
| (max-width: 767px) | .hero-left | text-align | center |
| (max-width: 767px) | .sub-text | text-align | center |
| (max-width: 767px) | .hero-cta | justify-content | center |
| (max-width: 767px) | .hero-right | order | "2" |
| (max-width: 767px) | .hero-left | order | "1" |
| (max-width: 767px) | header.topnav | padding | 0.65rem 0.85rem |
| (max-width: 767px) | ul.nav | gap | 0.25rem |
| (prefers-reduced-motion: reduce) | .hero-art | animation | none |
| (prefers-reduced-motion: reduce) | .hero-logo | animation | none |
| (prefers-reduced-motion: reduce) | ul.nav li:first-child a::before | animation | none |
| (prefers-reduced-motion: reduce) | article.card | animation | none |
*`响应式`*
## 全局
**基础表 = > 基础**
**动效表 = > 动效**
**顶栏表 = > 顶栏**
**Hero表 = > Hero**
**卡片表 = > 卡片**
**页脚表 = > 页脚**
**响应式表 = > 响应式**
**css基础 = > 网页.样式装配 名="基础" 表=`基础表`**
**css动效 = > 网页.样式装配 名="动效" 表=`动效表`**
**css顶栏 = > 网页.样式装配 名="顶栏" 表=`顶栏表`**
**cssHero = > 网页.样式装配 名="Hero" 表=`Hero表`**
**css卡片 = > 网页.样式装配 名="卡片" 表=`卡片表`**
**css页脚 = > 网页.样式装配 名="页脚" 表=`页脚表`**
**css响应式 = > 网页.样式装配 名="响应式" 表=`响应式表`**
`css段` =
| css |
|-----|
| `css基础` |
| `css动效` |
| `css顶栏` |
| `cssHero` |
| `css卡片` |
| `css页脚` |
| `css响应式` |
**css = > text.str_join xs=`css段` sep=""**
*css*
+28 -16
View File
@@ -1,21 +1,33 @@
# browser-app(路线 E)
# browser-app:可读源码中的浏览器工程
作者**零业务 JS**;逻辑用 **GFM 表格 + `lib/browser`**(无 `json.set` 链)。
从 [index.mq.md](index.mq.md) 开始阅读和执行,再沿 [组件入口](components/index.mq.md) 查看布局。首页拆成列表与计时,网络页再拆成输出、批量请求和 WebSocket 控件;内容在 content 中保留普通 Markdown,控件叶子使用原生 View 节点。
| 能力 | 演示 |
|------|------|
| 列表 CRUD | 添加 / 委托删除(`bag` + `set_html`) |
| storage | 草稿 localStorage |
| navigate | `/` `/about` `/net` + `popstate` |
| interval | 计时起停 |
| fetch_all | 并行两个 uuid |
| ws | `wss://echo.websocket.events`(依赖外网) |
| clipboard / download | 复制/下载列表文本 |
浏览器程序是 [static/app.mq.md](static/app.mq.md)。事件表、参数与返回契约就在回调旁边;操作用可读标签表达,列表文本始终保留为数据。样式入口为 [styles/index.mq.md](styles/index.mq.md),旁边的字面表保留旧页面全部 59 条声明,并给出 View 包装层的几何适配。
```bash
cargo build -p marqdo --release
./target/release/marqdo wasm build -o examples/browser-app
cd examples/browser-app && python3 -m http.server 8766
| 能力 | 实际行为与边界 |
|---|---|
| 列表 | 原生记录保留独立 ID;重复内容可单独删除,特殊字符使用 text,删除按钮使用 children |
| 草稿 | localStorage 保存输入框文本;完成回调确认保存,缺失值与空草稿分别处理;条目不跨刷新保存 |
| 历史 | 三个面板使用真实 pathname;popstate 只反映现有位置,不重复 push;直接打开 /about 或 /net 返回首页 |
| 计时 | 同名计时器替换,停止保留已累计次数 |
| 批量请求 | 两个公开 UUID 请求可能失败;输出每项真实状态、响应体或错误 |
| WebSocket | 本地 /live 原生回声资源;展示实际打开、消息、错误与关闭回调 |
| 剪贴板与下载 | 导出当前列表文本;即时提示仅确认已发起,浏览器策略仍可能阻止完成 |
在仓库根目录构建当前官方运行时,再启动原生服务器。需要已经可用的 Rust/WASM 工具链和本仓库工程、网络插件;缺少 WASM 标准库时先阅读 [工作区工具链手册](../../skills/marqdo-dev/toolchain.mq.md),并将返回的 compiler 传给 build_browser。生成资源与编译样式不作为业务源码提交。
```sh
marqdo call skills/marqdo-dev/index.mq.md build_browser 'out="examples/browser-app/static"' --effects plugin,process.exec,fs.write --fs-root . --require-ok --json
marqdo call examples/browser-app/index.mq.md serve --effects plugin,fs.write,network.write --fs-root examples/browser-app --require-ok --json
```
写法:[marqdo-dev](../../.cursor/skills/marqdo-dev/SKILL.md) · 路线图:[browser-wasm-e.md](../../doc/roadmap/browser-wasm-e.md)。
打开 http://127.0.0.1:18095。控件等待实际启动成功后启用;缺失资源返回明确失败,不能把加载说明当作已运行。服务只监听本机,示例不引入数据库、认证或持久条目存储。
开发验证同样通过可执行手册完成。下列浏览器任务原生复制当前运行时,并运行真实页面交互;它覆盖重复项、字面文本、草稿、历史、计时、导出内容、受控批量请求失败与本地 WebSocket 收发。Node/Playwright 是自动化测试的外联边界,文件读写与任务编排仍由 Marqdo 执行。
```sh
marqdo call skills/marqdo-dev/index.mq.md check 'path="examples/browser-app/index.mq.md"' --effects plugin --require-ok --json
marqdo call skills/marqdo-dev/index.mq.md test_browser --effects plugin,process.exec,fs.write --fs-root . --require-ok --json
```
后续修改先阅读 [编程规范](../../doc/library-development.mq.md),再修改一个职责的组件或回调。需要新的浏览器宿主能力时扩充正式 bridge 与标准库契约,保留真实浏览器验收;不在父组件中重新拼接 HTML 或业务 JavaScript。
-285
View File
@@ -1,285 +0,0 @@
---
markup: occlusion
title: browser-app (route E+)
description: list CRUD, storage, navigate, interval, fetch_all, ws — GFM + lib/browser
import:
browser: lib/browser.mq.md
table: lib/table.mq.md
text: lib/text.mq.md
---
# main
**`ticks` = 0**
**`bag` = ""**
**`path` = "/"**
**`ws_id` = "echo"**
`wire` =
| @ | 选择器 | 事件 | 调用 | 委托 | 值选择器 |
|---|--------|------|------|------|----------|
| 1 | "#add" | click | add | | "#draft" |
| 2 | "#save" | click | save_draft | | "#draft" |
| 3 | "#load" | click | load_draft | | |
| 4 | "#start-tick" | click | start_tick | | |
| 5 | "#stop-tick" | click | stop_tick | | |
| 6 | "#nav-home" | click | go_home | | |
| 7 | "#nav-about" | click | go_about | | |
| 8 | "#nav-net" | click | go_net | | |
| 9 | "window" | popstate | on_pop | | |
| 10 | "#items" | click | on_item | "button[data-id]" | |
| 11 | "#fetch-all" | click | do_fetch_all | | |
| 12 | "#ws-open" | click | ws_open | | |
| 13 | "#ws-send" | click | ws_send | | "#ws-msg" |
| 14 | "#ws-close" | click | ws_close | | |
| 15 | "#copy-log" | click | copy_log | | |
| 16 | "#dl-list" | click | dl_list | | |
`nav` =
| url | replace |
|-----|---------|
| / | False |
`st` =
| op | key | then |
|----|-----|------|
| get | mq-draft | on_draft |
`boot` =
| wire | navigate | storage |
|------|----------|---------|
| `wire` | `nav` | `st` |
*boot*
## add
+ `value`=""
1. `value` != ""
1. `bag` == ""
**`bag` = value**
2. *
**`bag` = bag + "\n" + value**
**`parts` = > text.str_split s=bag sep="\n"**
**`html` = ""**
- [item](遍历 parts 为 item)
1. `item` != ""
**`html` = html + "<li><span>" + item + "</span> <button type=\"button\" data-id=\"" + item + "\">删</button></li>"**
**`ret` = > browser.set_html sel="#items" html=html**
**`clr` = > browser.set_value sel="#draft" value=""**
**`ret` = > browser.merge a=ret b=clr**
**`f` = > browser.focus sel="#draft"**
*> browser.merge a=ret b=f*
2. *
****
## on_item
+ `data_id`=""
1. `data_id` != ""
**`parts` = > text.str_split s=bag sep="\n"**
**`next` = ""**
- [item](遍历 parts 为 item)
1. `item` != ""
1. `item` != `data_id`
1. `next` == ""
**`next` = item**
2. *
**`next` = next + "\n" + item**
**`bag` = next**
**`parts2` = > text.str_split s=bag sep="\n"**
**`html` = ""**
- [item](遍历 parts2 为 item)
1. `item` != ""
**`html` = html + "<li><span>" + item + "</span> <button type=\"button\" data-id=\"" + item + "\">删</button></li>"**
**`ret` = > browser.set_html sel="#items" html=html**
**`msg` = "removed " + data_id**
**`t` = > browser.set_text sel="#log" text=msg**
*> browser.merge a=ret b=t*
2. *
****
## save_draft
+ `value`=""
`st` =
| op | key | value |
|----|-----|-------|
| set | mq-draft | `value` |
**`msg` = > browser.set_text sel="#log" text="draft saved"**
**`s` = > browser.storage spec=st**
*> browser.merge a=msg b=s*
## load_draft
`st` =
| op | key | then |
|----|-----|------|
| get | mq-draft | on_draft |
*> browser.storage spec=st*
## on_draft
+ `ok`=True
+ `value`=""
+ `found`=False
1. `found`
**`ret` = > browser.set_value sel="#draft" value=value**
**`msg` = > browser.set_text sel="#log" text="draft loaded"**
*> browser.merge a=ret b=msg*
2. *
*> browser.set_text sel="#log" text="no draft"*
## start_tick
*> browser.interval ms=1000 then="on_tick" id="tick"*
## stop_tick
*> browser.clear_interval id="tick"*
## on_tick
+ `ok`=True
+ `id`=""
**`ticks` = ticks + 1**
**`label` = > str ticks**
*> browser.set_text sel="#tick" text=label*
## go_home
**`path` = "/"**
*> show_path*
## go_about
**`path` = "/about"**
*> show_path*
## go_net
**`path` = "/net"**
*> show_path*
## on_pop
+ `path`=""
**`path` = path**
*> show_path*
## show_path
**`hide` = > table.put in=None at="hidden" value=""**
**`show` = > table.put in=None at="hidden" value=False**
1. `path` == "/about"
`attrs` =
| #panel-about | #panel-home | #panel-net |
|--------------|-------------|------------|
| `show` | `hide` | `hide` |
2. *
1. `path` == "/net"
`attrs` =
| #panel-net | #panel-home | #panel-about |
|------------|-------------|--------------|
| `show` | `hide` | `hide` |
2. *
`attrs` =
| #panel-home | #panel-about | #panel-net |
|-------------|--------------|------------|
| `show` | `hide` | `hide` |
**`label` = "path: " + path**
**`ret` = > browser.set_text sel="#path" text=label**
**`a` = > browser.wrap key="set_attr" value=attrs**
**`ret` = > browser.merge a=ret b=a**
**`nav` = > browser.navigate url=path**
*> browser.merge a=ret b=nav*
## do_fetch_all
`reqs` =
| @ | url |
|---|-----|
| 1 | "https://httpbin.org/uuid" |
| 2 | "https://httpbin.org/uuid" |
**`msg` = > browser.set_text sel="#net-out" text="fetch_all…"**
**`fa` = > browser.fetch_all requests=reqs then="on_fetch_all"**
*> browser.merge a=msg b=fa*
## on_fetch_all
+ `ok`=True
+ `results`=None
*> browser.set_text sel="#net-out" text="fetch_all done (see console / results in session)"*
## ws_open
`w` =
| op | id | url | then_open | then_message | then_error | then_close |
|----|----|-----|-----------|--------------|------------|------------|
| open | `ws_id` | "wss://echo.websocket.events" | on_ws_open | on_ws_msg | on_ws_err | on_ws_close |
*> browser.ws spec=w*
## on_ws_open
+ `ok`=True
+ `id`=""
*> browser.set_text sel="#net-out" text="ws open"*
## on_ws_msg
+ `ok`=True
+ `data`=""
**`msg` = "ws ← " + data**
*> browser.set_text sel="#net-out" text=msg*
## on_ws_err
+ `ok`=False
+ `error`=""
**`msg` = "ws error: " + error**
*> browser.set_text sel="#net-out" text=msg*
## on_ws_close
+ `ok`=True
*> browser.set_text sel="#net-out" text="ws closed"*
## ws_send
+ `value`=""
`w` =
| op | id | data |
|----|----|------|
| send | `ws_id` | `value` |
*> browser.ws spec=w*
## ws_close
`w` =
| op | id |
|----|----|
| close | `ws_id` |
*> browser.ws spec=w*
## copy_log
**`msg` = > browser.set_text sel="#log" text="copied bag to clipboard"**
**`c` = > browser.clipboard text=bag**
*> browser.merge a=msg b=c*
## dl_list
**`msg` = > browser.set_text sel="#log" text="download started"**
**`d` = > browser.download body=bag filename="items.txt"**
*> browser.merge a=msg b=d*
@@ -0,0 +1,25 @@
---
markup: occlusion
title: About panel Markdown leaf
import:
component: ext/web/component/index.mq.md
fs: lib/fs.mq.md
---
## nodes
| 返回 | 类型 | 说明 |
|---|---|---|
| result | list | Structured View rows for this component |
About is a terminal Markdown leaf, so further layout splitting would add no useful responsibility. Read its content through the native filesystem under the granted site root. The wrapper supplies only its client visibility id and initial hidden state. The page describes official host capabilities without embedding implementation JavaScript or an HTML shell.
We **source = [Read the literal About content](fs.read_text(path="content/about.md"))** and **children = [Keep it as ordinary Markdown](component.markdown(text=`source`, slot="about-content"))**.
`attrs` =
| id | hidden |
|---|---|
| panel-about | True |
Return *[Describe the initially hidden About panel](component.wrap(children=`children`, kind="section", attrs=`attrs`, slot="about"))*.
@@ -0,0 +1,70 @@
---
markup: occlusion
title: Native browser control leaves
import:
component: ext/web/component/index.mq.md
table: lib/table.mq.md
---
## button
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| id | text | required | Event target shared with the client wire table |
| label | text | required | Literal visible action |
| secondary | bool | False | Use the retained secondary palette |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | list | One disabled native button awaiting successful runtime boot |
Use `id`, `label` and `secondary`=False for one leaf. The button starts disabled, carries type button and is enabled only after the official runtime boots successfully. Its label remains plain text. The caller chooses placement; this helper neither binds a click handler nor hides a sibling layout. Keep its id aligned with static/app.mq.md.
`attrs` =
| id | type | disabled |
|---|---|---|
| `id` | button | True |
We **style = ""**.
1. `secondary`
We **style = "secondary"**.
Return *[Describe one literal native action](component.element(kind="button", value=`label`, attrs=`attrs`, style=`style`, slot=`id`))*.
## input
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| id | text | required | Client value target |
| hint | text | required | Plain placeholder text |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | list | One disabled text input |
Use `id` and `hint` for the draft or socket message. A native text input preserves its ordinary editing semantics and starts disabled until WASM is ready. The hint is placeholder text rather than a markup template. The component owns one control; the client selects its value through the wire table when the adjacent action is clicked.
`attrs` =
| id | type | placeholder | disabled |
|---|---|---|---|
| `id` | text | `hint` | True |
Return *[Describe this native value input](component.element(kind="input", attrs=`attrs`, slot=`id`))*.
## text
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| id | text | required | Stable output target |
| value | text | required | Literal initial text |
| kind | text | "text" | Native text or pre output |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | list | One escaped text leaf |
Use `id`, `value` and `kind`="text" for an output target. Select pre for the runtime log and ordinary text for the path, tick count or network outcome. Initial and later content stays literal: the renderer escapes this value and callbacks use set_text. This leaf declares no timer or network operation; those belong to the browser program.
We **attrs = [Retain the exact output target](table.put(in=None, at="id", value=`id`))**.
Return *[Describe the literal output leaf](component.element(kind=`kind`, value=`value`, attrs=`attrs`, slot=`id`))*.
@@ -0,0 +1,33 @@
---
markup: occlusion
title: Draft and list editor
import:
controls: ../controls.mq.md
component: ext/web/component/index.mq.md
table: lib/table.mq.md
---
## nodes
| 返回 | 类型 | 说明 |
|---|---|---|
| result | list | Structured View rows for this component |
The editor contains one draft input, three draft actions, the export actions and an initially empty native list. The client owns records, stable identities and delegated deletion; no authored list HTML is stored here. Save persists only the draft under this origin. Copy and Download export current item text while list state remains in browser session memory.
We **heading = [Read the plain editor heading](component.markdown(text="## 待办"))** and **input = [Describe the exact draft target](controls.input(id="draft", hint="新项…"))** and **children = [Place input after its heading](table.concat(a=`heading`, b=`input`))**.
`actions` =
| @ | id | label | secondary |
|---|---|---|---|
| 1 | add | 添加 | False |
| 2 | save | 存草稿 | True |
| 3 | load | 读草稿 | True |
| 4 | copy-log | 复制列表 | True |
| 5 | dl-list | 下载列表 | True |
- [Describe each native action leaf](for actions as action)
We **button = [Keep this action separate from state](controls.button(id=access(action, "id"), label=access(action, "label"), secondary=access(action, "secondary")))** and **children = [Preserve the authored action order](table.concat(a=`children`, b=`button`))**.
We **empty = [Start the empty native list](table.empty_list())** and **attrs = [Retain the delegated list target](table.put(in=None, at="id", value="items"))** and **list = [Describe the list container](component.wrap(children=`empty`, kind="list", attrs=`attrs`, slot="items"))**.
Return *[Keep the list after its editing controls](table.concat(a=`children`, b=`list`))*.
Loaded 100 of 564 files, more files were not shown because too many files have changed in this diff. Show more