Commit graph

101 commits

Author SHA1 Message Date
XiaoSeS
1139bb2103 docs(faq): limit account cross-reference to its actual coverage
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-11-03 15:04:13 +08:00
XiaoSeS
f944b718d7 docs(site): center diagrams and separate avatar governance from deployment
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-11-03 15:01:12 +08:00
XiaoSeS
052d7b8d1a docs(site): bound diagram sizes for desktop reading
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-11-03 14:41:13 +08:00
XiaoSeS
9402e9cb15 docs(site): deepen six bilingual task guides with diagrams
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-11-03 14:36:19 +08:00
XiaoSeS
fe2049c19f docs(site): repair P0 states permissions and troubleshooting
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-11-03 14:13:40 +08:00
XiaoSeS
aedbcb6b54 docs(site): scope P0 repairs and clarify deployment choices
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-11-03 13:46:20 +08:00
XiaoSeS
6431314efb
Merge pull request #1048 from iflytek/docs/october-suite-faq
docs(faq): clarify Suite publishing and entry use
2026-11-03 13:40:43 +08:00
XiaoSeS
1506f0f513 docs(analytics): remove obsolete manual demo links
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-11-03 11:36:16 +08:00
XiaoSeS
84b0411fab docs(analytics): prioritize current configuration-only setup
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-11-03 11:26:01 +08:00
千乘妍 (Xiaoyaner)
335b692a05 Document one-click existing-platform and Helm analytics paths
Signed-off-by: 千乘妍 (Xiaoyaner) <258399167+xiaoyaner0201@users.noreply.github.com>
2026-11-03 00:59:18 +08:00
千乘妍 (Xiaoyaner)
ae62cb0d76 Merge upstream/main into feat/configurable-frontend-analytics-989
Signed-off-by: 千乘妍 (Xiaoyaner) <258399167+xiaoyaner0201@users.noreply.github.com>
2026-11-03 00:24:42 +08:00
FenjuFu
959ca0294b docs(faq): clarify Suite publishing and entry use
Signed-off-by: FenjuFu <92919259+FenjuFu@users.noreply.github.com>
2026-11-02 19:52:59 +08:00
XiaoSeS
d61f70f8e6
Merge pull request #1046 from iflytek/docs/issue1042-remaining
docs: complete deployment and navigation gaps for issue 1042
2026-11-02 16:25:00 +08:00
XiaoSeS
d8d20c4033 docs(analytics): explicitly state one-click production deployment is pending
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-11-02 16:13:31 +08:00
XiaoSeS
525f741914 docs(analytics): document actionable first-time local setup
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-11-02 16:07:35 +08:00
XiaoSeS
00a7b8679c docs(analytics): provide concise in-site integration reading
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-11-02 15:58:35 +08:00
XiaoSeS
36824d33b7 docs: complete remaining deployment and navigation gaps in issue 1042
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-11-02 15:38:30 +08:00
XiaoSeS
9501e03e19 docs(deploy): distinguish runtime and source configuration updates
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-11-02 15:28:27 +08:00
FenjuFu
a77ff18d07 docs(deploy): clarify device login and configuration refresh
Signed-off-by: FenjuFu <92919259+FenjuFu@users.noreply.github.com>
2026-10-30 17:15:59 +00:00
XiaoSeS
9ebb99226d
docs: refresh bilingual guides and skill suite usage (#1028)
* docs: refresh bilingual user and operator guides

Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>

* docs: align lifecycle and suite illustrations

Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>

* docs: refresh bilingual technology stack diagrams

Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>

* docs: expand verified workflows and reorganize documentation

Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>

* docs: expand sidebar groups by default

Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>

* docs: address independent review wording findings

Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>

---------

Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-10-28 17:40:59 +08:00
XiaoSeS
baaba6a1aa feat(suite): show viewer-safe membership hints on skill cards
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-10-26 15:47:44 +08:00
FenjuFu
2f7b0c73e3 fix(deps): patch Vite vulnerabilities in web and docs
Signed-off-by: FenjuFu <92919259+FenjuFu@users.noreply.github.com>
2026-10-22 07:24:13 +00:00
XiaoSeS
8a150e34d3 feat(storage): add S3-compatible deployment options
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-10-21 14:31:29 +08:00
XiaoSeS
4de9ab79f7 Merge latest main for GitHub sync delivery validation 2026-10-20 17:23:33 +08:00
XiaoSeS
2df4c913cb feat(github-sync): add continuous public repository discovery and skill sync
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-10-20 14:40:46 +08:00
XiaoSeS
0c5cdcdb6a docs(namespace): clarify invitation recovery and delivery status
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-10-20 10:51:45 +08:00
XiaoSeS
5639605029 fix(auth): enforce read-only ownership after team removal
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-10-19 16:13:46 +08:00
XiaoSeS
617cda4870
Merge pull request #907 from FenjuFu/docs/faq-community-qa-2026-09
docs(faq): add Kubernetes version, skill credentials and port conflict entries
2026-10-16 15:16:40 +08:00
XiaoSeS
dab10a4a21
Merge pull request #917 from twodogegg/feat/zcode-agent-profile
feat(cli): add zcode agent profile
2026-10-16 15:16:13 +08:00
XiaoSeS
ad6c70af39 docs(faq): clarify credential checks and runtime locations
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-10-16 14:01:35 +08:00
XiaoSeS
1c164c8702 feat(publish): support versioned web display names
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-10-15 15:59:56 +08:00
XiaoSeS
3b61d2365f Merge PR 950 for metadata consistency validation
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-10-15 13:40:33 +08:00
XiaoSeS
972bf3bd5d
Merge pull request #949 from FenjuFu/docs/promoted-skill-deletion-946
Some checks are pending
Deploy Docs / build (push) Waiting to run
Deploy Docs / Deploy (push) Blocked by required conditions
Security / Dependency Review (push) Waiting to run
Security / CodeQL (javascript-typescript) (push) Waiting to run
Security / CodeQL (python) (push) Waiting to run
Security / CodeQL (java-kotlin) (push) Waiting to run
docs(review): explain promoted skill deletion
2026-10-15 11:48:06 +08:00
XiaoSeS
5b0812ed4b Merge commit 'refs/review/20261015-fix-953-945-949/953' into fix/pr953-dependency-followup-20261015
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-10-15 10:42:21 +08:00
Raymond
2bdb83bdb6 feat(publish): support metadata display names independent of skill slugs
Use optional metadata.display-name for skill titles while preserving stable
slugs and URLs. Keep published titles unchanged until review approval, and
cover localized title display and search with generic example fixtures.

Restore the fallback version title and summary when yanking the latest
published version, with regression coverage for the lifecycle boundaries.

Document the metadata field and retain existing behavior when it is absent.

Signed-off-by: Raymond <21071287+raymondtc@users.noreply.github.com>
2026-10-15 09:49:27 +08:00
FenjuFu
0b3bbeab3b fix(deps): resolve open Dependabot alerts in web and docs
Raise pnpm overrides in web/ to the first patched releases:

- undici ^7.29.1 (Dependabot alerts 63, 65, 66, 69, 70, 71)
- dompurify ^3.4.16 (alerts 72, 85)
- katex ^0.18.2 (alert 84), pulled in by mermaid 11 which still
  requests ^0.16
- source-map-js ^1.2.2 (alert 83)
- postcss-selector-parser ^7.1.6 (alert 82), pulled in by tailwindcss 3
- brace-expansion ^1.1.21 / ^2.1.7 (alerts 74, 80)

Add vue ^3.5.42 and source-map-js ^1.2.2 to the docs/skillhub overrides
to resolve @vue/server-renderer (alert 76) and source-map-js (alert 77).

The generated Tailwind stylesheet is byte-identical before and after
the postcss-selector-parser bump.

Signed-off-by: FenjuFu <92919259+FenjuFu@users.noreply.github.com>
2026-10-14 22:14:00 +08:00
XiaoSeS
84116292d5 docs(avatar): add user-facing cloud moderation setup guide
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-10-14 16:48:22 +08:00
XiaoSeS
6f38e40880 docs(avatar): clarify machine review outcomes and provider validation
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-10-14 16:35:10 +08:00
XiaoSeS
b67b9553e6 fix(web): compact invitation history and display names
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-10-14 14:03:21 +08:00
XiaoSeS
ccd171eac9 feat(namespace): retain invitation history and join records
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-10-14 11:52:19 +08:00
XiaoSeS
1a7ffbe6e2 feat(avatar): stage images before skill publication
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-10-13 11:15:35 +08:00
FenjuFu
23e36e4356 docs(review): explain promoted skill deletion
Signed-off-by: FenjuFu <fufenjupku@gmail.com>
2026-10-13 11:04:59 +08:00
XiaoSeS
9c997f7eca feat(namespace): add one-time invitation links
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-10-12 11:55:47 +08:00
twodogegg
7e86caf2ad feat(cli): add zcode agent profile
Add a first-class zcode profile so skills can be installed into ZCode's
skills directories with --agent zcode:

- project-level: <project>/.zcode/skills/
- user-level: ~/.zcode/skills/

The profile follows the existing makeProfile pattern with automatic
detection of both scopes, and is covered by unit tests. Docs tables and
the CLI changelog are updated accordingly.

Signed-off-by: twodogegg <971270272@qq.com>
2026-10-03 05:47:24 +08:00
dongmucat
7969ff8a3b docs(readme): refresh architecture diagram 2026-09-29 15:31:24 +08:00
FenjuFu
7cec0c7807 docs(faq): add Kubernetes version, skill credentials and port conflict entries
Signed-off-by: FenjuFu <fufenjupku@gmail.com>
2026-09-29 12:16:00 +08:00
dongmucat
0fd222d1e7
Merge pull request #879 from iflytek/feature/scanner-2-1-upgrade
fix(scanner): harden Scanner 2.1 integration
2026-09-24 15:47:20 +08:00
XiaoSeS
75c7f9a880 feat(deploy): wire DingTalk credentials into the release surfaces
Adds the DingTalk credentials to every path that actually delivers
configuration: compose.release.yml (which has no env_file, so variables must
be listed explicitly), the Helm secret template and values, the k8s
deployment and its secret example. validate-release-config.sh gains DingTalk
in its provider loop, so a half-configured pair is rejected the same way.

Documents the three-stage strategy contract in the authentication design: a
table mapping each deviation -- authorize parameters, token exchange,
userinfo loading -- to its interface and current implementations, plus the
rule that a provider must never make account decisions itself.

Deployment notes and both FAQs now cover DingTalk, including the shared trap
with Feishu: their emails are admin-recorded and never confirmed, so
emailVerified is always false and an EMAIL_DOMAIN access policy would reject
every login through either provider.

Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
2026-09-21 15:15:41 +08:00
XiaoSeS
934cfa6ded
feat(auth): add Feishu as a public login provider (R1-A2) (#877)
Some checks are pending
Deploy Docs / build (push) Waiting to run
Deploy Docs / Deploy (push) Blocked by required conditions
Security / Dependency Review (push) Waiting to run
Security / CodeQL (java-kotlin) (push) Waiting to run
Security / CodeQL (javascript-typescript) (push) Waiting to run
Security / CodeQL (python) (push) Waiting to run
* feat(auth): let providers override OAuth userinfo loading

Some providers do not return a flat, standard userinfo payload, so
DefaultOAuth2UserService cannot read them. Add ProviderOAuth2UserService
so a provider can claim its own registration id and supply the loading
step, while everything after it stays shared.

The override runs inside the RemoteIdentityIoExecutor boundary added in
R1-A, so a provider's HTTP call does not hold the surrounding
transaction open. Registrations without an override keep using the
default user service unchanged.

Part of R1-A2 (public Provider adapters) per
openspec/changes/enterprise-identity-platform/rollout-plan.md.

Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>

* feat(auth): add Feishu as a public login provider

Adds Feishu (Lark) as a public sign-in option: it authenticates a
SkillHub platform account and nothing more. No Organization membership,
no directory sync, no Namespace grants.

Feishu deviates from standard OAuth in two ways this handles:
its userinfo response is wrapped in a {code, msg, data} envelope, and it
reports errors with HTTP 200. FeishuOAuth2UserService unwraps that
envelope into flat attributes; FeishuClaimsExtractor maps them to the
shared OAuthClaims, so account decisions still run through the unified
identity core added in R1-A.

Subject and email semantics, which decide whether a login can reach an
existing account:

- open_id is the only subject. union_id stays in extra rather than
  acting as a fallback: a subject that can change between logins would
  split one person across two platform accounts. Promoting union_id
  later needs an explicit alias migration.
- A blank or missing open_id fails the login instead of binding the
  literal string "null".
- emailVerified is always false. Feishu emails are imported by an
  organization admin and never confirmed with the user, so they carry no
  verification signal and cannot be used to join an existing account.

Operational bounds: the userinfo call has connect and read timeouts so an
unresponsive Feishu endpoint cannot hold a login thread, and the
OAuth2Error description carries only the provider error code, because an
upstream message can quote the request URI and with it the access token.
Like the GitHub and GitLab extractors, the claims extractor logs nothing.

The login button follows the existing config-driven catalog: with no
client id configured, /api/v1/auth/methods does not list Feishu and no
button renders. No frontend code change is needed; the icon resolves by
provider name.

Adapted from the implementation in #696 by @yhd4711499, re-extracted onto
current main with the subject, logging and timeout changes above.

Part of R1-A2 (public Provider adapters) per
openspec/changes/enterprise-identity-platform/rollout-plan.md.

Co-authored-by: yhd4711499 <yhd4711499@users.noreply.github.com>
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>

* fix(auth): bound Feishu userinfo response and stop subject leaking into displayName

Three defects found reviewing this batch against the R1-A2 spec.

Response size limit. The spec's scope line asks for "远程 I/O 超时与响应大小
限制"; only the timeouts were implemented, so a misconfigured or hostile
OAUTH2_FEISHU_BASE_URI could stream an unbounded body into the parser.
Reads at most 64 KB before parsing, mirroring the 10 MB cap the shared
WebClientConfig already applies. Uses InputStream.readNBytes rather than
adding commons-io or guava, neither of which skillhub-auth declares.

Synthesized displayName. Falling back to "feishu-<open_id>" wrote the
external subject into UserAccount.displayName and into
UserActivatedEvent, carrying it somewhere event consumers may log it --
against the R1-A gate that logs must not contain the subject. Now stops
at name -> en_name like the GitHub and GitLab extractors.

Unused mobile attribute. A phone number was extracted into the principal
attributes and read by nothing. It is PII the spec did not ask for and it
widened the redaction surface for free.

Also drops a constructor overload that only passed List.of() through, and
a test that duplicated the blank-subject path.

Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>

* docs(auth): document the provider adapter contract and Feishu operator setup

AGENTS.md and CONTRIBUTING.md both require docs updates when auth flows or
deployment config change; this batch changed both and touched no docs.

03-authentication-design.md described adding a provider as "branch on
registrationId inside CustomOAuth2UserService", which the
ProviderOAuth2UserService strategy supersedes. Rewrites that recipe:
register an OAuthClaimsExtractor bean per provider, add a
ProviderOAuth2UserService only when the userinfo response is non-standard,
and note that the login page needs no code change. Also records the
provider-side obligations that are easy to get wrong -- stable subject with
no fallback, emailVerified only on proven ownership, bounded remote calls,
no subject in logs -- and un-comments the config example, which still
listed GitLab as a future possibility.

faq.md told operators to delete "the github and gitlab blocks" to hide SSO
buttons. That advice was already incomplete and gets worse per provider, so
it now explains the config-driven mechanism: an empty client id keeps the
entry off the login page, no file edit needed.

09-deployment.md listed only the GitHub credentials. Adds GitLab and Feishu,
and flags a deployment trap: Feishu emails are admin-imported so
emailVerified is always false, and skillhub.access-policy.mode=EMAIL_DOMAIN
denies every unverified email, which would reject all Feishu logins.

Squares the Feishu logo viewBox. It was 407.87x324.19 while login-button
renders it in a square w-5 h-5 box, so the mark was distorted.

Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>

* feat(deploy): wire Feishu credentials into the release surfaces

.env.release.example advertised OAUTH2_FEISHU_* knobs that no deployment
path could actually deliver. compose.release.yml has no env_file, so every
variable must be listed explicitly, and the Helm chart and k8s base only
mapped the GitHub secret keys. Setting the documented variables therefore
did nothing.

Adds Feishu to compose.release.yml, the Helm secret template and values,
the k8s deployment and its secret example. GitLab had the identical gap, so
it is wired at the same time rather than leaving the example file half true.

validate-release-config.sh only checked that GitHub's id and secret appear
together. A half-configured provider renders a login button whose exchange
then fails, so the check now loops over all three providers. Its test gained
both-directions cases per provider plus a fully configured pass; reverting
the loop to GitHub-only makes them fail.

Also adds the provider's only failure log. Nothing downstream records a
Feishu userinfo failure -- OAuth2LoginFailureHandler does not log either --
so the previous code was silent on error. Logs the exception class and
Feishu's own error code, never the upstream msg, which can quote the access
token; a test asserts the code is present and the token is not.

Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>

* fix(auth): use JSON token exchange for Feishu OAuth

Made-with: Proma
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>

* fix(auth): preserve Feishu OAuth browser redirect

Add safe phase-level OAuth diagnostics and redact callback credentials from request logs.

Made-with: Proma
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>

* docs(deploy): clarify Feishu OAuth configuration and validation

Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>

* fix(deploy): pass Feishu redirect URI through releases

Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>

* fix(deploy): pass S3 chunked encoding setting

Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>

* fix(deploy): preserve default Feishu callback derivation

Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>

---------

Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
Co-authored-by: yhd4711499 <yhd4711499@users.noreply.github.com>
2026-09-21 14:39:22 +08:00
dongmucat
6a89832bb7
feat(cli): add DeepSeek Harness agent profile (#891)
* feat(cli): add DeepSeek Harness agent profile

Signed-off-by: dongmucat <1127093059@qq.com>

* docs(dsh): fix custom install troubleshooting command

Signed-off-by: dongmucat <1127093059@qq.com>

---------

Signed-off-by: dongmucat <1127093059@qq.com>
2026-09-21 13:58:12 +08:00