From 194bd0fb4a6df9a83e27d9b4f0183ec802d87865 Mon Sep 17 00:00:00 2001 From: lys1313013 Date: Sun, 11 Oct 2026 21:32:30 +0800 Subject: [PATCH] docs(links): replace machine-specific paths and fix broken links Signed-off-by: lys1313013 --- docs/11-auth-extensibility-and-private-sso.md | 2 +- docs/12-private-sso-integration-playbook.md | 16 +++++++-------- docs/13-parallel-workflow.md | 3 ++- docs/2026-04-08-issue-automation-design.md | 20 +++++++++---------- .../skill-file-browser-sidebar-v1.0-prd.md | 8 +++++--- .../verification.md | 2 +- 6 files changed, 27 insertions(+), 24 deletions(-) diff --git a/docs/11-auth-extensibility-and-private-sso.md b/docs/11-auth-extensibility-and-private-sso.md index dcf66029..60912531 100644 --- a/docs/11-auth-extensibility-and-private-sso.md +++ b/docs/11-auth-extensibility-and-private-sso.md @@ -145,4 +145,4 @@ public interface DirectAuthProvider { 更详细的私有 SSO 接入步骤、最佳实践、测试矩阵和给后续 coding agent 的执行约束，见： -- [12-private-sso-integration-playbook.md](/Users/xudongsun/github/skillhub/docs/12-private-sso-integration-playbook.md) +- [12-private-sso-integration-playbook.md](./12-private-sso-integration-playbook.md) diff --git a/docs/12-private-sso-integration-playbook.md b/docs/12-private-sso-integration-playbook.md index 786317fb..e984b234 100644 --- a/docs/12-private-sso-integration-playbook.md +++ b/docs/12-private-sso-integration-playbook.md @@ -11,10 +11,10 @@ 相关文档： -- [03-authentication-design.md](/Users/xudongsun/github/skillhub/docs/03-authentication-design.md) -- [06-api-design.md](/Users/xudongsun/github/skillhub/docs/06-api-design.md) -- [08-frontend-architecture.md](/Users/xudongsun/github/skillhub/docs/08-frontend-architecture.md) -- [11-auth-extensibility-and-private-sso.md](/Users/xudongsun/github/skillhub/docs/11-auth-extensibility-and-private-sso.md) +- [03-authentication-design.md](./03-authentication-design.md) +- [06-api-design.md](./06-api-design.md) +- [08-frontend-architecture.md](./08-frontend-architecture.md) +- [11-auth-extensibility-and-private-sso.md](./11-auth-extensibility-and-private-sso.md) ## 2. 当前上下文与已确认约束 @@ -54,9 +54,9 @@ 关键代码位置： -- [DirectAuthProvider.java](/Users/xudongsun/github/skillhub/server/skillhub-auth/src/main/java/com/iflytek/skillhub/auth/direct/DirectAuthProvider.java) -- [PassiveSessionAuthenticator.java](/Users/xudongsun/github/skillhub/server/skillhub-auth/src/main/java/com/iflytek/skillhub/auth/bootstrap/PassiveSessionAuthenticator.java) -- [PlatformSessionService.java](/Users/xudongsun/github/skillhub/server/skillhub-auth/src/main/java/com/iflytek/skillhub/auth/session/PlatformSessionService.java) +- [DirectAuthProvider.java](../server/skillhub-auth/src/main/java/com/iflytek/skillhub/auth/direct/DirectAuthProvider.java) +- [PassiveSessionAuthenticator.java](../server/skillhub-auth/src/main/java/com/iflytek/skillhub/auth/bootstrap/PassiveSessionAuthenticator.java) +- [PlatformSessionService.java](../server/skillhub-auth/src/main/java/com/iflytek/skillhub/auth/session/PlatformSessionService.java) ### 3.2 后端公共协议 @@ -415,7 +415,7 @@ skillhub: 如果后续由 AI 继续在私有仓库上完成接入，建议严格遵守以下执行规则： -- 先读 [11-auth-extensibility-and-private-sso.md](/Users/xudongsun/github/skillhub/docs/11-auth-extensibility-and-private-sso.md) 和本文档 +- 先读 [11-auth-extensibility-and-private-sso.md](./11-auth-extensibility-and-private-sso.md) 和本文档 - 不要重构现有公共认证主链路，除非发现明确 bug - 私有 SSO 的具体实现优先写成 provider、authenticator、client、identity service - 不要复制 `PlatformSessionService` 逻辑 diff --git a/docs/13-parallel-workflow.md b/docs/13-parallel-workflow.md index 4653f272..867e9510 100644 --- a/docs/13-parallel-workflow.md +++ b/docs/13-parallel-workflow.md @@ -47,7 +47,8 @@ And matching local branches: You can override the base branch or destination root: ```bash -make parallel-init TASK=legal-pages PARALLEL_BASE_REF=origin/main PARALLEL_WORKTREE_ROOT=/Users/wowo/workspace +mkdir -p ../skillhub-worktrees +make parallel-init TASK=legal-pages PARALLEL_BASE_REF=origin/main PARALLEL_WORKTREE_ROOT=../skillhub-worktrees ``` If you are iterating on this workflow itself before it lands on `origin/main`, create the worktrees from your current branch instead: diff --git a/docs/2026-04-08-issue-automation-design.md b/docs/2026-04-08-issue-automation-design.md index 420e78ab..8dd90dd8 100644 --- a/docs/2026-04-08-issue-automation-design.md +++ b/docs/2026-04-08-issue-automation-design.md @@ -214,25 +214,25 @@ LLM 辅助不会放宽这一规则。 ## 脚本 新的 GitHub 自动化脚本位于 -[`.github/scripts`](/Users/wowo/workspace/skillhub/.github/scripts)： +[`.github/scripts`](../.github/scripts)： -- [github.ts](/Users/wowo/workspace/skillhub/.github/scripts/github.ts)：精简版 +- [github.ts](../.github/scripts/github.ts)：精简版 GitHub REST 客户端 -- [issue-triage-config.ts](/Users/wowo/workspace/skillhub/.github/scripts/issue-triage-config.ts)： +- [issue-triage-config.ts](../.github/scripts/issue-triage-config.ts)： 标签、阈值和关键词规则 -- [issue-llm-config.ts](/Users/wowo/workspace/skillhub/.github/scripts/issue-llm-config.ts)： +- [issue-llm-config.ts](../.github/scripts/issue-llm-config.ts)： LLM 模式、环境变量和调用启发式 -- [issue-llm-provider.ts](/Users/wowo/workspace/skillhub/.github/scripts/issue-llm-provider.ts)： +- [issue-llm-provider.ts](../.github/scripts/issue-llm-provider.ts)： 兼容 OpenAI 的 chat completions 客户端 -- [issue-llm-evaluator.ts](/Users/wowo/workspace/skillhub/.github/scripts/issue-llm-evaluator.ts)： +- [issue-llm-evaluator.ts](../.github/scripts/issue-llm-evaluator.ts)： prompt 构造、JSON 校验和缓存 key 生成 -- [issue-triage-lib.ts](/Users/wowo/workspace/skillhub/.github/scripts/issue-triage-lib.ts)： +- [issue-triage-lib.ts](../.github/scripts/issue-triage-lib.ts)： 解析、评分、路由和评论渲染 -- [issue-triage-merge.ts](/Users/wowo/workspace/skillhub/.github/scripts/issue-triage-merge.ts)： +- [issue-triage-merge.ts](../.github/scripts/issue-triage-merge.ts)： 有界合并和硬性门槛重应用 -- [issue-triage.ts](/Users/wowo/workspace/skillhub/.github/scripts/issue-triage.ts)： +- [issue-triage.ts](../.github/scripts/issue-triage.ts)： 单 issue 入口 -- [issue-backlog-rescore.ts](/Users/wowo/workspace/skillhub/.github/scripts/issue-backlog-rescore.ts)： +- [issue-backlog-rescore.ts](../.github/scripts/issue-backlog-rescore.ts)： deferred 队列重新评分入口 ## 配置 diff --git a/docs/prds/skill-file-browser-sidebar-v1.0-prd.md b/docs/prds/skill-file-browser-sidebar-v1.0-prd.md index 6ab86a86..5ebd741d 100644 --- a/docs/prds/skill-file-browser-sidebar-v1.0-prd.md +++ b/docs/prds/skill-file-browser-sidebar-v1.0-prd.md @@ -230,12 +230,14 @@ ## 关联文档 +以下配套文档当前未收录于仓库，补齐后再添加链接： + ### 需求文档 -- [API 接口契约](../requirements/2026-03-20-skill-file-browser-sidebar/05-api-contract.md) - 定义前后端接口规范 -- [验收用例](../requirements/2026-03-20-skill-file-browser-sidebar/04-acceptance-cases.md) - 功能验收测试用例 +- API 接口契约（`docs/requirements/2026-03-20-skill-file-browser-sidebar/05-api-contract.md`）- 定义前后端接口规范 +- 验收用例（`docs/requirements/2026-03-20-skill-file-browser-sidebar/04-acceptance-cases.md`）- 功能验收测试用例 ### 执行计划 -- [实施计划](../superpowers/plans/2026-03-22-skill-file-browser-sidebar.md) - 详细的开发任务分解与执行步骤 +- 实施计划（`docs/superpowers/plans/2026-03-22-skill-file-browser-sidebar.md`）- 详细的开发任务分解与执行步骤 ### 技术参考 - 现有组件： diff --git a/openspec/changes/enterprise-identity-platform/verification.md b/openspec/changes/enterprise-identity-platform/verification.md index d9190c51..b01a8bcb 100644 --- a/openspec/changes/enterprise-identity-platform/verification.md +++ b/openspec/changes/enterprise-identity-platform/verification.md @@ -13,7 +13,7 @@ - `cd web && pnpm exec vitest run --maxWorkers=1`: 207 files / 818 tests passed, 119.63s. The jsdom navigation warning does not represent a real OAuth callback test. - `cd server && MAVEN_OPTS='-Xmx768m -XX:ActiveProcessorCount=2' ./mvnw -pl skillhub-app -am test -Dtest=LocalAuthServiceTest,LocalAuthControllerTest,DeviceAuthServiceTest,DeviceAuthControllerTest,DeviceAuthWebControllerTest,ApiTokenServiceTest,ApiTokenAuthenticationFilterTest,ApiTokenScopeServiceTest,OAuth2LoginHandlersTest,OAuth2AuthorizationRequestResolverTest,OAuthLoginRedirectSupportTest,OAuthLoginFlowServiceTest,AuthMethodCatalogTest,EnterpriseLoginAppServiceTest,EnterpriseBrowserSessionServiceTest,EnterpriseSessionAccessServiceTest,ExpiredPublicSessionFilterTest -Dsurefire.failIfNoSpecifiedTests=false`: 17 classes / 119 tests passed, zero failures/errors/skips, 48.333s. Counts checked from the selected Surefire XML files, not all historical reports. This is a targeted compatibility suite, not a new full backend run. -- `PLAYWRIGHT_BASE_URL=http://127.0.0.1:13000 PLAYWRIGHT_WORKERS=1 PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH=/home/ylhu16/.cache/ms-playwright/chromium-1208/chrome-linux64/chrome pnpm exec playwright test e2e/enterprise-identity-flow.spec.ts --project=chromium --workers=1 --reporter=line`: 3 passed, 12.5s. Initial default launch failed because the headless-shell cache was absent; reused the matching full Chromium executable without download or new services. First executable-enabled run exposed a stale fixture lacking LOGIN_SECRET_ADMIN; two creation cases timed out and the remaining run was cancelled. Added that role to the mock admin only, then reran all three successfully. Existing UI unit test still asserts IDENTITY_ADMIN alone cannot create a confidential connection. No product authorization bypass was added. +- `PLAYWRIGHT_BASE_URL=http://127.0.0.1:13000 PLAYWRIGHT_WORKERS=1 PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH="$HOME/.cache/ms-playwright/chromium-1208/chrome-linux64/chrome" pnpm exec playwright test e2e/enterprise-identity-flow.spec.ts --project=chromium --workers=1 --reporter=line`: 3 passed, 12.5s. Initial default launch failed because the headless-shell cache was absent; reused the matching full Chromium executable without download or new services. First executable-enabled run exposed a stale fixture lacking LOGIN_SECRET_ADMIN; two creation cases timed out and the remaining run was cancelled. Added that role to the mock admin only, then reran all three successfully. Existing UI unit test still asserts IDENTITY_ADMIN alone cannot create a confidential connection. No product authorization bypass was added. - `cd server && MAVEN_OPTS='-Xmx768m -XX:ActiveProcessorCount=2' ./mvnw -pl skillhub-app -am -DskipTests package`: passed, including `skillhub-auth` and `skillhub-app` compilation/package. - `cd web && pnpm exec vitest run src/pages/login.test.tsx src/pages/register.test.tsx src/features/auth/enterprise-login-discovery.test.tsx src/features/auth/login-button.test.tsx src/shared/lib/auth-route.test.ts src/pages/dashboard/organization-admin-pages.test.tsx --maxWorkers=1`: 6 files / 45 tests passed. - `cd web && pnpm run typecheck && pnpm run lint`: passed.