Prune stale docs and update .hermes content

Delete a large set of outdated documentation (many files under docs/ and .hermes/plans/, including audits, design, prd, technical, planning, assets, and todos). Update and consolidate .hermes content: refresh shared-memory pages (decision-log, development-workflow, document-map, pitfalls, project-overview, team-conventions) and several skills/references under .hermes/skills. Also modify AGENTS.md, README.md, UI_CODING_STANDARD.md, docs/README.md and .encoding-check-ignore. Purpose: clean up stale planning/audit material and keep current hermes documentation and related top-level docs in sync.
This commit is contained in:
2026-05-15 06:24:07 +08:00
parent 2eded08bc7
commit 3cb3efb4d0
708 changed files with 4033 additions and 142328 deletions

View File

@@ -1,39 +0,0 @@
# Rust Workspace 默认构建范围修复2026-04-25
## 背景
`server-rs` 同时包含原生运行的 `api-server` 与只应由 SpacetimeDB CLI 按 wasm 模块方式构建的 `spacetime-module`
直接在 `server-rs` 下执行无参数 `cargo build`Cargo 会尝试构建 workspace 的全部成员,其中 `spacetime-module``cdylib`,并依赖 `spacetimedb` 模块运行时导入函数。该 crate 不能作为 Windows 原生 DLL 链接,链接阶段会报 `LNK2019 unresolved external symbol`,例如 `datastore_insert_bsatn``console_log``table_id_from_name`
## 决策
1. `cargo build` 默认只构建原生服务入口 `api-server`
2. `spacetime-module` 保留为 workspace member便于 `cargo check --workspace --all-targets` 做类型检查。
3. `spacetime-module` 的可发布产物必须继续通过 SpacetimeDB CLI 或仓库发布脚本生成,不走无参数 `cargo build` 的原生链接路径。
## 落地
`server-rs/Cargo.toml` 增加:
```toml
[workspace]
default-members = [
"crates/api-server",
]
```
## 验证命令
```powershell
cd D:\Genarrative\server-rs
cargo build
cargo check --workspace --all-targets
spacetime publish <database> --module-path crates/spacetime-module --build-options="--debug" --yes
```
## 后续约束
- 日常本地编译原生后端用 `cargo build``cargo build -p api-server`
- 验证全部 Rust 目标用 `cargo check --workspace --all-targets`
- 构建 / 发布 SpacetimeDB 模块用 `spacetime publish <database> --module-path server-rs/crates/spacetime-module --build-options="--debug" --yes` 或发布脚本,不要用无目标参数的原生 `cargo build -p spacetime-module`