diff --git a/.gitignore b/.gitignore index 61f264f..ff7f5f3 100644 --- a/.gitignore +++ b/.gitignore @@ -1,17 +1,20 @@ # --------------------------------------------------------------------------- # 构建产物 # --------------------------------------------------------------------------- -/source/rust/target/ +/rust/target/ **/*.dylib **/*.so **/*.o **/*.a +# 本机 nginx 源码树(含编译好的二进制 + nginx/pcre 源码包,体积大、含本机路径, +# 不入库;仅作本地持久化,避免每次重下重编) +/build/ # --------------------------------------------------------------------------- # 运行时数据(含真实口令散列与 API Key,禁止入库) -# 种子模板在 source/data-seed/,用 scripts/seed-data.sh 物化 +# 种子模板在 data-seed/,用 scripts/seed-data.sh 物化 # --------------------------------------------------------------------------- -/source/data/ +/data/ # --------------------------------------------------------------------------- # 参考资料:来源项目与第三方实现,仅本地阅读,不入库 diff --git a/.workbuddy/skills/ipass-core-add-plugin/SKILL.md b/.workbuddy/skills/ipass-core-add-plugin/SKILL.md index ab442a2..106e5c6 100644 --- a/.workbuddy/skills/ipass-core-add-plugin/SKILL.md +++ b/.workbuddy/skills/ipass-core-add-plugin/SKILL.md @@ -11,7 +11,7 @@ agent_created: true 用户要在这种工作区里新增/移植一个插件。典型形态(本文以 `ssw/sso` 为参照): ```text -source/rust/ +rust/ ├── crates/ipass-core/ 内核:state(共享内存) / store(JSON 原子写) / users(账号唯一写入口) │ / models(共性字段 + extra 透传) / config(共性常量) / plugin(契约) / loc(开关) ├── crates/plugin-sso/ 身份插件 @@ -44,7 +44,7 @@ workspace 编不过(成员在 `members` 里但目录缺 `Cargo.toml`/`lib.rs` 不要凭 refs 的旧代码猜,逐条 grep 确认: ```bash -cd source/rust +cd rust # 内核到底导出了什么 sed -n '1,200p' crates/ipass-core/src/lib.rs # 逐个核实你要用的符号 @@ -65,7 +65,7 @@ grep -n "pub fn " crates/ipass-core/src/http.rs ### 2. 建 crate 骨架 ```bash -mkdir -p source/rust/crates/plugin-/src +mkdir -p rust/crates/plugin-/src ``` `Cargo.toml`(照 `plugin-domain` 抄): @@ -160,9 +160,9 @@ static mut NGX_HTTP_SSO_COMMANDS: [ngx_command_t; N+1] = [...]; ### 5. 编译 ```bash -cd source/rust -NGINX_SOURCE_DIR=/tmp/sso-build/src/nginx-1.30.4 \ -NGINX_BUILD_DIR=/tmp/sso-build/src/nginx-1.30.4/objs \ +cd rust +NGINX_SOURCE_DIR=./build/src/nginx-1.30.4 \ +NGINX_BUILD_DIR=./build/src/nginx-1.30.4/objs \ CARGO_NET_OFFLINE=true cargo build --release # 先单 crate 快速迭代(几十秒 vs 全量 ~1.5 分钟): # ... cargo build -p plugin- @@ -177,10 +177,10 @@ CARGO_NET_OFFLINE=true cargo build --release ### 6. nginx 配置(测试 + 生产) -- `source/conf/nginx.test.conf`:给新能力加 listen 端口 + `sso_ on;`。 +- `conf/nginx.test.conf`:给新能力加 listen 端口 + `sso_ on;`。 本机没有 PCRE,**`server_name ~regex` 会被渲染脚本降级成 `server_name _`**, 所以判 Host 的逻辑要放在插件里(按后缀 `strip_suffix`),不要依赖 `server_name` 捕获。 -- `source/conf/nginx.conf`:生产模板可用正则 `server_name ~^(?.+dm)\.zone$;`。 +- `conf/nginx.conf`:生产模板可用正则 `server_name ~^(?.+dm)\.zone$;`。 - `proxy_pass http://$module_var;` 在变量为空时会报 500 `no host in upstream`。 **不要用 `if ($var = "")` 兜底** —— `if` 在 rewrite 阶段求值,而变量是 access 阶段才写的, 合法请求会被一起误判。用 `error_page 500 502 503 = @fallback;` + `location @fallback { return 404 "MARKER"; }`。 @@ -312,7 +312,7 @@ _ => { **后端端点不是交付终点**。本仓 2026-09-14 的 P1/P2 首轮就只做了 API + e2e,管理台一行没动, 用户找不到入口。新增能力时**必须同步问一句「UI 在哪」**。 -### 管理台(`source/www/admin.html`) +### 管理台(`www/admin.html`) 单文件、纯静态 + `fetch`,无构建步骤。页签机制是「按钮 `data-tab` + `