openxiangda 2.1.0 → 2.2.0

package/README.md

@@ -10,6 +10,8 @@ pnpm openxiangda skill install --workspace . --force
 pnpm openxiangda dev
 ```
 
+创建和技能安装默认检查内部支持协作所需的 DWS。`support status --json` 查看状态，`support bootstrap` 安装/复用官方完整技能，`support login` 引导 OAuth，`support join` 打开配置中的原邀请链接，由用户在钉钉完成加入。等待接入不阻塞应用工作；离线/CI 可加 `--skip-support`。咨询和持续跟进使用随统一入口安装的 `openxiangda-support` 技能，V1/V2 保持各自项目引擎。
+
 应用导入统一子路径：
 
 | 子路径 | 用途 |

package/bin/distribution/commands.js

@@ -3,17 +3,19 @@ import { flagValue, fail } from './workspace.js';
 import { update } from './update.js';
 import { assessMigration } from './migrate.js';
 import { installDistributionSkills } from './skills.js';
+import { supportOperation } from './support.js';
 
 export async function distributionCommand(context, args) {
   const command = args[0];
   const skillInstall = command === 'skill' && args[1] === 'install';
-  if (!['version', 'update', 'changelog', 'migrate'].includes(command) && !skillInstall) return false;
+  if (!['version', 'update', 'changelog', 'migrate', 'support'].includes(command) && !skillInstall) return false;
   validateArguments(command, args.slice(1));
   if (args.includes('--help') || args.includes('-h')) {
-    process.stdout.write('openxiangda version [--json]\nopenxiangda update check|install [--target workspace|launcher] [--dry-run] [--json]\nopenxiangda changelog [version] [--json]\nopenxiangda migrate assess --to v2 [--json]\nopenxiangda skill install [--workspace <directory> | --destination <directory>] [--agent codex|claude|qoder|dual] [--force] [--dry-run]\n以上命令支持 --cwd <directory>。新应用默认 V2，项目升级保持原代际。\n');
+    process.stdout.write('openxiangda version [--json]\nopenxiangda update check|install [--target workspace|launcher] [--dry-run] [--json]\nopenxiangda changelog [version] [--json]\nopenxiangda migrate assess --to v2 [--json]\nopenxiangda skill install [--workspace <directory> | --destination <directory>] [--agent codex|claude|qoder|dual] [--force] [--dry-run] [--skip-support]\nopenxiangda support status|bootstrap|login|join [--profile <corpId:userId>] [--agent <DWS agent>] [--device] [--force] [--dry-run] [--json]\n以上命令支持 --cwd <directory>。新应用默认 V2，项目升级保持原代际。支持接入等待用户操作时不阻塞应用创建。\n');
     return true;
   }
   let data;
+  if (command === 'support') data = await supportOperation(context.packageRoot, args);
   if (skillInstall) data = await installDistributionSkills(context, args);
   if (command === 'version') data = {
     productVersion: context.manifest.version,
@@ -38,8 +40,8 @@ export async function distributionCommand(context, args) {
 }
 
 function validateArguments(command, args) {
-  const booleans = new Set(['--json', '--help', '-h', ...(command === 'skill' ? ['--force', '--dry-run'] : command === 'update' ? ['--dry-run'] : [])]);
-  const values = new Set(['--cwd', ...({ update: ['--target', '--registry'], changelog: ['--registry'], migrate: ['--to'], skill: ['--workspace', '--destination', '--dest', '--agent'] }[command] || [])]);
+  const booleans = new Set(['--json', '--help', '-h', ...(command === 'skill' ? ['--force', '--dry-run', '--skip-support'] : command === 'support' ? ['--force', '--dry-run', '--device'] : command === 'update' ? ['--dry-run'] : [])]);
+  const values = new Set(['--cwd', ...({ update: ['--target', '--registry'], changelog: ['--registry'], migrate: ['--to'], skill: ['--workspace', '--destination', '--dest', '--agent'], support: ['--profile', '--agent'] }[command] || [])]);
   const seen = new Set(); let positionals = 0;
   for (let i = 0; i < args.length; i++) {
     const argument = args[i], key = argument.split('=')[0];

package/bin/distribution/launcher.js

@@ -3,9 +3,14 @@ import { join } from 'node:path';
 import { spawn } from 'node:child_process';
 import { discoverWorkspace, flagValue, readJson, resolveEngine } from './workspace.js';
 import { distributionCommand } from './commands.js';
+import { bootstrapSupport } from './support.js';
 
 export async function launch(packageRoot, args = process.argv.slice(2)) {
   const manifest = readJson(join(packageRoot, 'package.json'));
+  if (args[0] === 'support') {
+    await distributionCommand({ manifest, packageRoot }, args);
+    return;
+  }
   const workspace = discoverWorkspace(flagValue(args, '--cwd') || (args[0] === 'skill' ? flagValue(args, '--workspace') : null) || process.cwd());
   // Launcher-only updates must also work when a project's dependencies are not yet installed.
   const launcherUpdate = args[0] === 'update' && flagValue(args, '--target') === 'launcher';
@@ -13,7 +18,7 @@ export async function launch(packageRoot, args = process.argv.slice(2)) {
   const context = { manifest, packageRoot, workspace, engine };
   if (await distributionCommand(context, args)) return;
   if (!args.length || args[0] === '--help' || args[0] === '-h') {
-    process.stdout.write('统一分发命令：version、update check|install、changelog、migrate assess。\nSkill 安装支持 --workspace、--destination 和 --agent；正文跟随项目版本。\n\n');
+    process.stdout.write('统一分发命令：version、update check|install、changelog、migrate assess、support status|bootstrap|login|join。\nSkill 安装支持 --workspace、--destination 和 --agent；正文跟随项目版本。创建和技能刷新默认接入支持协作，离线/CI 可加 --skip-support。\n\n');
   }
   const env = { ...process.env };
   for (const key of ['OPENXIANGDA_DISTRIBUTION_NAME', 'OPENXIANGDA_DISTRIBUTION_VERSION', 'OPENXIANGDA_DOCUMENTATION_ROOT', 'OPENXIANGDA_SKILLS_ROOT']) delete env[key];
@@ -23,7 +28,9 @@ export async function launch(packageRoot, args = process.argv.slice(2)) {
     env.OPENXIANGDA_DOCUMENTATION_ROOT = join(engine.packageRoot, 'documentation');
     if (existsSync(join(engine.packageRoot, 'skills'))) env.OPENXIANGDA_SKILLS_ROOT = join(engine.packageRoot, 'skills');
   }
-  const forwarded = engine.generation === 'v1' ? removeCwd(args) : args;
+  const initializes = args[0] === 'create' || args[0] === 'workspace' && args[1] === 'init' || args[0] === 'skill' && args[1] === 'bootstrap';
+  const engineArgs = initializes ? args.filter(argument => argument !== '--skip-support') : args;
+  const forwarded = engine.generation === 'v1' ? removeCwd(engineArgs) : engineArgs;
   const child = spawn(process.execPath, [engine.entry, ...forwarded], {
     cwd: engine.generation === 'v1' ? workspace?.root || process.cwd() : process.cwd(), env, stdio: 'inherit',
   });
@@ -36,6 +43,10 @@ export async function launch(packageRoot, args = process.argv.slice(2)) {
       child.once('exit', (code, signal) => resolve({ code, signal }));
     });
     process.exitCode = code ?? (signal === 'SIGINT' ? 130 : 143);
+    if (code === 0 && initializes) {
+      const support = await bootstrapSupport(packageRoot, args);
+      if (support.state !== 'skipped') process.stderr.write(`${JSON.stringify({ operation: 'support bootstrap', data: support })}\n`);
+    }
   } finally { signals.forEach((signal, i) => process.removeListener(signal, handlers[i])); }
 }
 

package/bin/distribution/skills.js

@@ -4,6 +4,7 @@ import { dirname, join, resolve } from 'node:path';
 import { createRequire } from 'node:module';
 import { pathToFileURL } from 'node:url';
 import { fail, flagValue, readJson } from './workspace.js';
+import { bootstrapSupport } from './support.js';
 
 export async function installDistributionSkills(context, args) {
   const workspace = flagValue(args, '--workspace');
@@ -33,6 +34,7 @@ export async function installDistributionSkills(context, args) {
     }
     const router = join(source, 'openxiangda');
     cpSync(join(context.packageRoot, 'launcher-skill/openxiangda'), router, { recursive: true });
+    cpSync(join(context.packageRoot, 'launcher-skill/openxiangda-support'), join(source, 'openxiangda-support'), { recursive: true });
     const file = join(router, 'SKILL.md');
     writeFileSync(file, readFileSync(file, 'utf8').replaceAll('__OPENXIANGDA_VERSION__', context.manifest.version));
     const names = readdirSync(source, { withFileTypes: true }).filter(entry => entry.isDirectory()).map(entry => entry.name).sort();
@@ -45,7 +47,8 @@ export async function installDistributionSkills(context, args) {
       const { refreshWorkspaceGuidance } = await importEngineModule(context.engine.packageRoot, 'openxiangda-skill-kit');
       guidance = refreshWorkspaceGuidance(resolve(workspace), guidanceTemplate);
     }
-    return { destinations, installed: names, engineVersion: context.engine.version, generation: context.engine.generation, dryRun: args.includes('--dry-run'), ...(guidance ? { guidance } : {}) };
+    const support = await bootstrapSupport(context.packageRoot, args);
+    return { destinations, installed: names, engineVersion: context.engine.version, generation: context.engine.generation, dryRun: args.includes('--dry-run'), support, ...(guidance ? { guidance } : {}) };
   } finally { rmSync(staging, { recursive: true, force: true }); }
 }
 

package/bin/distribution/support-commands.json

@@ -0,0 +1,4 @@
+{
+  "schemaVersion": "openxiangda.distribution-commands/v1",
+  "commands": ["support:status", "support:bootstrap", "support:login", "support:join"]
+}

package/bin/distribution/support.js

@@ -0,0 +1,190 @@
+import { cpSync, existsSync, mkdirSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { spawn } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+import { fail, flagValue, readJson } from './workspace.js';
+import supportCommands from './support-commands.json' with { type: 'json' };
+
+export const SUPPORT_CHANNEL_URL = 'https://evaluate-oss.oss-cn-hangzhou.aliyuncs.com/static/lowcode/support/channel.json';
+export const DWS_STABLE_VERSION = '1.0.61';
+const coreReferences = ['dingtalk-shared/SKILL.md', 'dingtalk-misc/references/profile.md', 'dingtalk-chat/SKILL.md', 'dingtalk-event/SKILL.md'];
+
+export async function loadSupportChannel(fetcher = fetch) {
+  const response = await fetcher(SUPPORT_CHANNEL_URL, { signal: AbortSignal.timeout(10_000), redirect: 'error' });
+  if (!response.ok) fail('SUPPORT_CHANNEL_UNAVAILABLE', `HTTP ${response.status}`);
+  const chunks = []; let size = 0;
+  for await (const chunk of response.body) {
+    size += chunk.length;
+    if (size > 16 * 1024) fail('SUPPORT_CHANNEL_TOO_LARGE', '通道配置超过 16 KiB');
+    chunks.push(chunk);
+  }
+  const channel = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+  const identifier = value => typeof value === 'string' && value.length > 0 && value.length <= 512 && !/[\s,:]/.test(value);
+  if (channel.schemaVersion !== 'openxiangda.support-channel/v1' || !identifier(channel.id) || !identifier(channel.corpId)
+    || typeof channel.conversationId !== 'string' || !channel.conversationId || channel.conversationId.length > 1024
+    || typeof channel.name !== 'string' || channel.name.length > 256 || !Number.isSafeInteger(channel.revision) || channel.revision < 1) {
+    fail('SUPPORT_CHANNEL_INVALID', '通道配置不符合当前契约');
+  }
+  let invitation;
+  try { invitation = new URL(channel.inviteUrl); } catch { fail('SUPPORT_INVITE_URL_INVALID', '邀请地址格式无效'); }
+  if (typeof channel.inviteUrl !== 'string' || channel.inviteUrl.length > 8192 || /[\r\n\0]/.test(channel.inviteUrl)
+    || !['https:', 'dingtalk:'].includes(invitation.protocol) || invitation.username || invitation.password) {
+    fail('SUPPORT_INVITE_URL_INVALID', '邀请地址协议无效');
+  }
+  return channel;
+}
+
+export function selectSupportProfile(profiles, corpId, requested) {
+  if (requested) {
+    if (!/^[^:\s,]+:[^:\s,]+$/.test(requested)) fail('SUPPORT_PROFILE_INVALID', '使用 profile list 返回的 corpId:userId');
+    if (requested.split(':')[0] !== corpId) fail('SUPPORT_PROFILE_ORGANIZATION_MISMATCH', '所选账号不属于支持通道组织');
+    return profiles.find(item => item.profile === requested && item.corpId === corpId && `${item.corpId}:${item.userId}` === requested) || null;
+  }
+  const candidates = profiles.filter(item => item.corpId === corpId && item.isOrgCurrent === true && item.profile === `${item.corpId}:${item.userId}`);
+  return candidates.length === 1 ? candidates[0] : null;
+}
+
+export function supportVersion(output) {
+  const match = /\bdws version v?(\d+)\.(\d+)\.(\d+)(?![\d.-])/.exec(output);
+  if (!match) return null;
+  const current = match.slice(1).map(Number), minimum = DWS_STABLE_VERSION.split('.').map(Number);
+  for (let i = 0; i < 3; i++) {
+    if (current[i] > minimum[i]) return current.join('.');
+    if (current[i] < minimum[i]) return null;
+  }
+  return current.join('.');
+}
+
+export async function supportOperation(packageRoot, args, overrides = {}) {
+  const action = args[1] || 'status';
+  if (!supportCommands.commands.includes(`support:${action}`)) fail('SUPPORT_ACTION_INVALID', action);
+  const taskHome = overrides.home || homedir();
+  const stateFile = overrides.stateFile || join(process.env.XDG_CONFIG_HOME || join(taskHome, '.config'), 'openxiangda', 'support.json');
+  const skillsHome = overrides.skillsHome || join(taskHome, '.agents', 'skills');
+  const run = overrides.run || runSupportProcess;
+  const channelLoader = overrides.loadChannel || loadSupportChannel;
+  const requested = flagValue(args, '--profile');
+  const target = flagValue(args, '--agent') || 'all';
+  if (!/^[a-z][a-z0-9-]{0,63}$/.test(target)) fail('SUPPORT_AGENT_INVALID', target);
+  if (args.includes('--dry-run')) return { state: 'planned', action, channelUrl: SUPPORT_CHANNEL_URL, dwsPackage: `dingtalk-workspace-cli@${DWS_STABLE_VERSION}`, skills: 'official-full-multi', target, userActionRequired: ['OAuth', 'DingTalk group join'] };
+  const result = { state: 'setup_required', action, channelUrl: SUPPORT_CHANNEL_URL, dws: { available: false }, skills: { ready: false }, nextActions: [] };
+  let releaseLock = () => {};
+  try {
+    if (action !== 'status') {
+      mkdirSync(dirname(stateFile), { recursive: true, mode: 0o700 });
+      const lock = `${stateFile}.lock`;
+      try { mkdirSync(lock, { mode: 0o700 }); } catch (error) { if (error.code === 'EEXIST') fail('SUPPORT_BUSY', `另一个接入操作正在执行；检查 ${lock}`); throw error; }
+      releaseLock = () => rmSync(lock, { recursive: true, force: true });
+    }
+    const saved = existsSync(stateFile) ? readJson(stateFile) : {};
+    const persist = patch => {
+      const temporary = `${stateFile}.${randomUUID()}.tmp`;
+      writeFileSync(temporary, `${JSON.stringify({ ...saved, ...patch, schemaVersion: 'openxiangda.support-state/v1' }, null, 2)}\n`, { mode: 0o600 });
+      try { renameSync(temporary, stateFile); } finally { rmSync(temporary, { force: true }); }
+      Object.assign(saved, patch);
+    };
+    let versionResult = await run('dws', ['--version']);
+    let version = versionResult.status === 0 ? supportVersion(versionResult.stdout) : null;
+    if (!version && action === 'bootstrap') {
+      const installed = await run(process.platform === 'win32' ? 'npm.cmd' : 'npm', ['install', '--global', `dingtalk-workspace-cli@${DWS_STABLE_VERSION}`, '--registry', 'https://registry.npmjs.org', '--no-fund', '--no-audit'], { timeout: 120_000 });
+      if (installed.status !== 0) return pending(result, 'dws_unavailable', 'SUPPORT_DWS_INSTALL_FAILED', 'openxiangda support bootstrap');
+      versionResult = await run('dws', ['--version']);
+      version = versionResult.status === 0 ? supportVersion(versionResult.stdout) : null;
+    }
+    if (!version) return pending(result, 'dws_unavailable', 'SUPPORT_DWS_STABLE_REQUIRED', 'openxiangda support bootstrap');
+    result.dws = { available: true, version };
+    const referencesPresent = () => coreReferences.every(file => existsSync(join(skillsHome, file)));
+    if (action === 'bootstrap') {
+      installSupportGuidance(packageRoot, skillsHome);
+      if (args.includes('--force') || saved.skillsVersion !== version || saved.skillsTarget !== target || !referencesPresent()) {
+        const setup = await run('dws', ['skill', 'setup', '--mode', 'multi', '--target', target, '--yes'], { timeout: 60_000, officialSkills: true });
+        if (setup.status !== 0 || !referencesPresent()) return pending(result, 'setup_required', 'SUPPORT_DWS_SKILLS_INCOMPLETE', 'openxiangda support bootstrap --force');
+        persist({ skillsVersion: version, skillsTarget: target });
+      }
+    }
+    result.skills = { ready: referencesPresent(), bundle: saved.skillsVersion === version ? 'official-full-multi' : 'not_verified' };
+    let channel;
+    try { channel = await channelLoader(); } catch (error) { return pending(result, 'channel_unavailable', error.code || 'SUPPORT_CHANNEL_UNAVAILABLE', 'openxiangda support status'); }
+    result.channel = { id: channel.id, name: channel.name, revision: channel.revision, corpId: channel.corpId, conversationId: channel.conversationId };
+    const json = async command => {
+      const output = await run('dws', [...command, '--format', 'json']);
+      if (output.status !== 0) return null;
+      try { const parsed = JSON.parse(output.stdout); return parsed?.error || parsed?.success === false ? null : parsed; } catch { return null; }
+    };
+    const listProfiles = async () => {
+      const data = await json(['profile', 'list']);
+      return Array.isArray(data?.profiles) ? data.profiles : [];
+    };
+    let profile = selectSupportProfile(await listProfiles(), channel.corpId, requested || saved.profile);
+    if (action === 'login') {
+      const loginProfile = profile?.profile || requested || channel.corpId;
+      const login = await run('dws', ['auth', 'login', '--profile', loginProfile, ...(args.includes('--device') ? ['--device'] : []), '--format', 'json'], { timeout: 180_000, interactive: true });
+      if (login.status !== 0) return pending(result, 'authorization_required', 'SUPPORT_AUTH_PENDING', 'openxiangda support login');
+      profile = selectSupportProfile(await listProfiles(), channel.corpId, requested || saved.profile);
+    }
+    if (!profile) return pending(result, 'profile_required', 'SUPPORT_PROFILE_REQUIRED', 'openxiangda support login');
+    result.profile = profile.profile;
+    const auth = await json(['auth', 'status', '--profile', profile.profile]);
+    if (!auth || auth.authenticated !== true || auth.token_valid !== true) return pending(result, 'authorization_required', 'SUPPORT_AUTH_REQUIRED', 'openxiangda support login');
+    if (auth.corp_id !== channel.corpId || auth.user_id !== profile.userId) return pending(result, 'profile_required', 'SUPPORT_AUTH_IDENTITY_MISMATCH', 'openxiangda support status --profile <corpId:userId>');
+    if (action !== 'status') persist({ profile: profile.profile });
+    result.authorization = { verified: true };
+    const group = await json(['chat', '+chat-members-list', '--conversation-id', channel.conversationId, '--member-types', 'user', '--page-limit', '1', '--profile', profile.profile]);
+    if (group?.conversationId === channel.conversationId && Array.isArray(group.users) && group.users.length > 0 && !(group.failures?.length) && !(group.buckets?.users?.failures?.length)) {
+      result.group = { access: 'verified', membership: 'not_independently_verified', organizationRestriction: 'not_independently_verified', complete: group.complete === true };
+      result.state = result.skills.ready ? 'ready' : 'setup_required';
+      if (!result.skills.ready) result.nextActions = [{ command: 'openxiangda support bootstrap' }];
+      return result;
+    }
+    result.group = { access: 'unverified', membership: 'unverified', organizationRestriction: 'not_independently_verified' };
+    if (action === 'join') {
+      const opened = overrides.openUrl ? await overrides.openUrl(channel.inviteUrl) : await openSupportUrl(channel.inviteUrl, run);
+      result.inviteUrl = channel.inviteUrl;
+      result.browserOpened = opened === true;
+      return pending(result, 'pending_user_action', 'SUPPORT_JOIN_PENDING', 'openxiangda support status');
+    }
+    return pending(result, 'group_unavailable', 'SUPPORT_GROUP_ACCESS_UNVERIFIED', 'openxiangda support join');
+  } catch (error) {
+    return pending(result, 'unavailable', error.code || 'SUPPORT_UNAVAILABLE', 'openxiangda support bootstrap');
+  } finally { releaseLock(); }
+}
+
+function pending(result, state, code, command) {
+  return { ...result, state, code, nextActions: [{ command }] };
+}
+
+export function installSupportGuidance(packageRoot, skillsHome) {
+  const source = join(packageRoot, 'launcher-skill', 'openxiangda-support');
+  mkdirSync(skillsHome, { recursive: true });
+  cpSync(source, join(skillsHome, 'openxiangda-support'), { recursive: true });
+}
+
+export async function bootstrapSupport(packageRoot, args = [], overrides = {}) {
+  if (args.includes('--skip-support') || args.includes('--dry-run') || args.includes('--help') || args.includes('-h')) return { state: 'skipped' };
+  return supportOperation(packageRoot, ['support', 'bootstrap', ...(args.includes('--force') ? ['--force'] : [])], overrides);
+}
+
+async function openSupportUrl(url, run) {
+  const command = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'explorer.exe' : 'xdg-open';
+  return (await run(command, [url], { timeout: 10_000 })).status === 0;
+}
+
+export function runSupportProcess(command, args, options = {}) {
+  return new Promise(resolve => {
+    let stdout = '', stderr = '', settled = false, outputSize = 0;
+    const env = { ...process.env };
+    if (options.officialSkills) delete env.DWS_SKILL_SOURCE;
+    const child = spawn(command, args, { env, stdio: options.interactive ? ['inherit', 'pipe', 'pipe'] : ['ignore', 'pipe', 'pipe'], windowsHide: true });
+    const timer = setTimeout(() => child.kill('SIGKILL'), options.timeout || 40_000);
+    const finish = status => { if (!settled) { settled = true; clearTimeout(timer); resolve({ status, stdout, stderr }); } };
+    const collect = stream => chunk => {
+      outputSize += chunk.length;
+      if (outputSize > 1024 * 1024) { child.kill('SIGKILL'); return; }
+      if (stream === 'stdout') stdout += chunk; else stderr += chunk;
+      if (options.interactive) process.stderr.write(chunk);
+    };
+    child.stdout.on('data', collect('stdout')); child.stderr.on('data', collect('stderr'));
+    child.once('error', () => finish(-1)); child.once('close', code => finish(code ?? -1));
+  });
+}

package/documentation/AGENTS.md

@@ -15,6 +15,7 @@
 - 默认读取 AppSpec 当前规格、设计索引、活动变更和阶段缺口。新应用先用自然语言对话主动发现模块，完成本期 PRD、旅程、逐页交互、视觉/原型、权限与架构设计及实际确认，形成内容摘要绑定的评审基线后再制定实施计划和实现业务；参见 docs product-design 和 docs interaction-patterns。既有应用仅修订受影响设计，不把 AI 建议写成用户确认。总纲保存长期规则，本轮变更关联需求、任务、源码与 AC 验收；测试发布前完成设计与计划，生产晋级前保存绑定原测试运行及包摘要的实际验收报告。更新当前规则、验证与发布结果和交接后归档；不得编造确认或通过结果。
 - 根据变化风险记录业务意图。无行为变化引用已有记录；已有授权和已确认意图不重复向用户请求机械确认。真实角色和浏览器验收与本地测试分别记录。
 - 失败保留错误码、指针和原候选；查询平台状态后使用允许的恢复操作，不自动重放未知结果。
+- 平台契约、诊断和产品/架构咨询按 openxiangda-support 技能持续跟进已授权案例。使用 support status 查看 DWS 接入状态；待 OAuth、钉钉入群或网络恢复不阻塞独立开发，后台续跑以实际宿主监听/定时配置为准。
 
 MCP 使用同一项目 CLI：`pnpm exec openxiangda --mcp-stdio --cwd <workspace>`。先读取 workspace_context，再按任务读取 docs_read 和当前契约。登录、创建及长期 dev 使用 CLI/终端。
 

package/documentation/delivery.md

@@ -4,6 +4,10 @@
 
 ## 测试部署
 
+托管源码应用通过 `pnpm openxiangda source push -m "本轮变更说明"` 完成提交与推送。
+发布系统在平台绑定仓库中核验精确源码提交，并沿用 AppVersion 的源码和制品摘要关联。
+本地构建仍是当前交付方式；源码提交存在不等于平台已独立验证制品由该提交构建。
+
 发布前，先将本轮源码、生成契约及必要记录合入并推送仓库的远端默认主分支，然后从干净且同步的主分支工作区发布。工具从 origin 的远端 HEAD 识别主分支，不把任务分支的 upstream 当作主线。未提交、未推送、未合并或落后主线的问题会在构建和上传前返回；工具不会自动合并分支或覆盖其他会话的改动。
 
 开发开始时先同步主线并读取项目现状，开发完成包括提交、推送与主线整合。每个工作区保持一个写者；需要并行时使用独立目录并明确各任务范围。日常 dev/check 仍可验证未提交源码。没有 Git 远端的项目应先建立并绑定仓库再发布。

package/documentation/getting-started.md

@@ -11,10 +11,10 @@ OpenXiangda 2.0 默认生成 React 应用和共享契约。普通 CRUD、标准
 以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
 
 ```bash
-pnpm dlx openxiangda@2.1.0 skill install --force
-pnpm dlx openxiangda@2.1.0 auth status --base-url <平台地址> --json
-pnpm dlx openxiangda@2.1.0 login --base-url https://platform.example.com
-pnpm dlx openxiangda@2.1.0 create my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.2.0 skill install --force
+pnpm dlx openxiangda@2.2.0 auth status --base-url <平台地址> --json
+pnpm dlx openxiangda@2.2.0 login --base-url https://platform.example.com
+pnpm dlx openxiangda@2.2.0 create my-app --base-url https://platform.example.com
 cd my-app
 pnpm openxiangda context --json
 pnpm openxiangda dev
@@ -26,6 +26,23 @@ pnpm openxiangda dev
 
 进入项目后使用 `pnpm openxiangda`，由项目依赖和锁文件决定版本。查看使用资料运行 `pnpm openxiangda docs`；查看单一主题运行 `pnpm openxiangda docs frontend`。安装到其他 AI 工具时使用 `skill install --destination <Skill根目录>`。
 
+### 内部支持协作
+
+统一入口在成功创建应用、V1 workspace init/skill bootstrap 和 skill install 后检查 DWS。缺失时安装审核过的官方稳定版和完整 multi 技能（包括 shared、misc/profile 等跨技能引用），复用可用版本；不会自动登录、加入群或发送消息。支持接入结果独立于应用创建，JSON 创建结果保持原结构，接入进度写 stderr。
+
+```bash
+pnpm openxiangda support status --json
+pnpm openxiangda support bootstrap
+pnpm openxiangda support login
+pnpm openxiangda support join
+```
+
+首次 OAuth 由用户完成，SSH 使用 `support login --device`。支持侧保存 DWS 精确 profile 指针，多账号可传 `--profile <corpId:userId>`；不修改 DWS 或平台默认账号。通道来自外置配置，`join` 原样打开邀请链接，由用户在钉钉完成加入，再执行 `status` 回读。群可访问、成员身份与组织限制分别报告；钉钉负责真实权限判断，不凭链接推定。
+
+等待授权、入群、网络或安装权限时可以继续独立开发。离线/CI 创建和技能安装可加 `--skip-support`，之后运行 `support bootstrap` 恢复。完整官方技能由 DWS 自身安装/备份；自动接入使用 DWS 的 all 目标检测宿主，应用技能安装的 --agent 只决定应用技能位置。`support bootstrap --force --agent <DWS目标宿主>` 可显式指定 DWS 宿主并刷新。`support --help` 查看命令，支持命令无需应用依赖已安装；独立 V1 引擎没有这些分发命令，应使用新版统一入口，保留原 V1 项目版本。
+
+本地接入指针位于 `${XDG_CONFIG_HOME:-~/.config}/openxiangda/support.json`，只保存 profile 和技能安装回执，不保存 Token。普通支持咨询与持续讨论遵循安装的 `openxiangda-support` 技能及用户授权；后台唤醒须有真实宿主监听或定时任务。
+
 ## 项目结构 {#workspace}
 
 ```text
@@ -47,6 +64,83 @@ AppSpec 随开发持续维护：测试发布前补齐总纲、关联变更与验
 
 纯 CRUD 修改优先使用标准模型、字段和页面；跨模型事务或外部副作用再选择后端。角色、行和字段权限在平台执行。详见[开发流程](./development.md)、[模型与标准 CRUD](./application-foundation.md)和[按需后端](./backend.md)。
 
+## 应用源码
+
+平台启用源码托管后，`create` 自动建立应用私有仓库、配置长期 Git 凭据并推送首次提交。
+应用管理员自动拥有对应仓库管理员权限；无需注册另一套账号。凭据存入系统凭据管理器，
+macOS 使用 Keychain，Windows 使用 Git Credential Manager，Linux 使用已安装的
+Git Credential Manager 或 libsecret。新电脑首次使用需重新执行源码配置。
+
+```bash
+pnpm openxiangda source status
+pnpm openxiangda source setup
+pnpm openxiangda source push -m "完成本轮应用开发"
+```
+
+创建或推送中断后，在原目录重试。已有外部仓库使用 `source setup --import`，原 `origin`
+保留为 `external-source`；当前分支的历史随推送保留，不执行强推，也不自动合并冲突。
+其他分支、标签和 Git LFS 对象需按实际迁移范围另外推送。`source push` 省略 `-m` 时只推送
+已有提交；带 `-m` 时提交当前所有未忽略更改。源码入口位于平台应用运营的“应用源码”。
+
+| 当前场景 | 执行方式 |
+| --- | --- |
+| 新应用 | 正常执行 `create`，平台启用后自动建仓、配置凭据和首次推送 |
+| 已有项目首次交接给另一个 AI | 先读 `context --json` 和 `source status`，沿用项目绑定与版本 |
+| 换电脑或初始化中断 | 在应用目录执行 `pnpm openxiangda source setup`；已有提交及未提交修改会保留 |
+| 从个人远端迁入 | 明确迁入后运行 `source setup --import`，原远端保留为 `external-source` |
+| 本轮修改完成 | 检查差异后运行 `source push -m "AppSpec: <本轮变更ID> 变更说明"`；多个任务共享目录时先精确提交本轮文件，再不带 `-m` 推送 |
+| 准备部署 | 先把本轮提交合入并推送远端默认分支，再从干净且同步的主分支执行 `deploy` |
+
+新仓库默认使用 `main`；导入时，尚无默认分支的空仓库会采用当前分支（例如 `master`）。
+已有远端默认分支不会因在任务分支运行 setup 而改变。源码操作使用 CLI/终端；
+MCP 的 `docs_read` 可以读取本说明，当前没有独立的源码操作 MCP 工具。
+
+| 错误或状态 | 处理 |
+| --- | --- |
+| `enabled: false` | 平台尚未启用托管，沿用当前工作区；由平台管理员配置后再接入 |
+| `APPLICATION_SOURCE_ORIGIN_CONFLICT` | 核实平台绑定和现有 origin；仅在明确迁入时使用 `--import` |
+| `APPLICATION_SOURCE_CREDENTIAL_HELPER_REQUIRED` / `APPLICATION_SOURCE_CREDENTIAL_NOT_STORED` | 安装或解锁系统凭据管理器，再重试 setup；不把密码写入 URL、项目或明文凭据文件 |
+| 403 / 应用管理权限不足 | 核对当前平台账号及应用管理员资格；由已有应用管理员添加权限 |
+| `APPLICATION_SOURCE_PROVIDER_UNAVAILABLE` / `APPLICATION_SOURCE_PROVIDER_FAILED` | 保留原应用和目录，待 Git 服务恢复后重试同一操作 |
+| 推送被拒绝或主线已前进 | 先 fetch 并查看差异，按项目规则合并解决冲突后重试，不强推覆盖 |
+| `APPLICATION_SOURCE_COMMIT_NOT_PUSHED` | 在绑定仓库推送原提交，核对 source status 和远端 SHA 后重试部署 |
+
+应用创建人和新增应用管理员拥有对应仓库管理权限，不需要另行维护 Git 角色。
+本期不自动同步权限撤销或删除。不要向应用开发者索要 Forgejo 平台管理员 Token；
+个人凭据由已登录的平台账号获取，配置成功后可长期复用。
+
+### 从平台和仓库 URL 获取源码
+
+无需本地工作区，使用本 Skill 随包精确版本或已安装的对应 CLI：
+
+```bash
+pnpm dlx openxiangda@2.2.0 auth status --base-url <平台> --json
+pnpm dlx openxiangda@2.2.0 source resolve <仓库URL> --base-url <平台> --json
+pnpm dlx openxiangda@2.2.0 source clone <仓库URL> <新目录> --base-url <平台> --json
+```
+
+登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回
+`appCode/name/repository`，不猜应用代码；clone 使用当前账号配置长期凭据后检出源码，
+返回 `root/baseUrl/appCode/repository/branch/commit`。`--branch <分支>` 可指定分支，
+省略时使用 Forgejo 实际默认分支。目标目录必须不存在；失败时保留目录供检查。
+克隆不会加载应用配置、安装依赖、执行应用脚本或递归拉取子模块，并禁用 checkout hooks
+和全局过滤器；需要 LFS 内容时在审查后单独处理。
+
+既有 `PLATFORM_ADMIN` 平台管理员映射为共享 Forgejo 管理员，可完整管理已有及以后创建的
+全部仓库，不受应用创建人或应用成员登记限制。平台应用管理员保持对应仓库管理权限。
+该规则没有新增平台角色，也不扩展普通应用成员的权限。
+
+正式 API 均位于平台 `/service/openxiangda-api/v2` 下，使用现有登录态：
+
+| API | 请求及响应 data |
+| --- | --- |
+| `GET /application-source/resolve?repository=<编码后的仓库URL>` | 接受平台登记的 cloneUrl 或 webUrl，返回 `{ appCode, name, repository }`；不返回凭据 |
+| `POST /application-source/credential` | JSON `{ "repository": "仓库URL" }`，返回 `{ appCode, repository, username, password, name, email }`，响应 `Cache-Control: no-store` |
+| `POST /application-source/administrators/reconcile` | 仅平台管理员；同步已有 PLATFORM_ADMIN 到 Git，返回 `{ synchronized }`，不返回凭据 |
+
+使用 CLI 时无需自行调用凭据 API；支持工具不得记录其响应或另建身份体系。
+未登记的外部仓库先在原工作区执行 `source setup --import`，再使用平台返回的仓库 URL。
+
 ## 检查与交付 {#delivery}
 
 只检查时运行 `pnpm openxiangda check`。需要部署测试环境时直接运行 `pnpm openxiangda deploy`，它已包含检查、测试和构建；无需再连续重复运行全部脚本。

package/documentation/manifest.json

@@ -1,12 +1,12 @@
 {
   "schemaVersion": "openxiangda.documentation/v1",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "topics": [
     {
       "id": "getting-started",
       "title": "安装与开始开发",
       "file": "getting-started.md",
-      "sha256": "fe1ea2bb3653ab4c2b166e71d7138a9a6c4d2d6d84f3576b790cd04b32db22af"
+      "sha256": "7c4703a4135e868ef4c18c04ec62f25bc1067d9e72fb17414babc9f1a567b862"
     },
     {
       "id": "product-design",
@@ -96,7 +96,7 @@
       "id": "delivery",
       "title": "部署、生产晋级与恢复",
       "file": "delivery.md",
-      "sha256": "e2a225019925ffa4855156e7dbde1a70c50a38804e7c0b206e1fbf81008ec078"
+      "sha256": "30152536bf782d62ba182272086033fa45596e1f9f42eefe59169c9fa25af68f"
     },
     {
       "id": "upgrading",
@@ -108,7 +108,7 @@
       "id": "cli",
       "title": "CLI 命令参考",
       "file": "reference/cli.md",
-      "sha256": "05005a0fb268af776510128132b984bc88ca20c5232190aa1ee26070bce796d4"
+      "sha256": "f17c3f2bb78bb61382f51ba7ab36a89f228f116e1f020b30ad833a0f4a89d57d"
     },
     {
       "id": "mcp",

package/documentation/reference/cli.md

@@ -9,6 +9,7 @@
 | `pnpm openxiangda docs` | 只读 | 按主题和章节读取当前版本中文资料 |
 | `pnpm openxiangda admin` | 只读 | 只读查看应用管理能力和流程节点运行配置 |
 | `pnpm openxiangda create` | 远端变更 | 创建、绑定并初始化应用 |
+| `pnpm openxiangda source` | 远端变更 | 配置应用源码仓库、查看状态或提交推送 |
 | `pnpm openxiangda dev` | 本地写入 | 连接平台测试数据启动本地 Web，按需启动 Nest |
 | `pnpm openxiangda check` | 本地写入 | 生成契约并在目标平台预检后执行检查、测试和构建 |
 | `pnpm openxiangda accept` | 远端变更 | 按计划准备可选的真实预发验收身份 |

package/launcher-skill/openxiangda/SKILL.md

@@ -15,6 +15,8 @@ description: Identify OpenXiangda V1 or V2 workspaces and select the matching pr
 
 ## 升级与说明
 
+- 平台支持协作读取同次安装的 `$openxiangda-support`。创建和技能刷新默认检查 DWS；`openxiangda support status --json` 查看接入状态，`support bootstrap` 补齐官方全套技能，`support login` 完成 OAuth，`support join` 打开配置链接由用户加入。等待用户或网络恢复不阻塞应用开发。支持命令归统一入口，V1/V2 业务和平台登录绑定保持原有所有者。
+
 - `openxiangda update check` 按项目代际检查稳定更新；离线时可继续使用本地能力。
 - `openxiangda update install --target workspace` 更新本项目同代工具链。升级后检查源码与锁文件差异，并执行项目验证。
 - `openxiangda update install --target launcher` 更新全局统一入口，需要 Node.js 24。此操作不转换已有项目。

package/launcher-skill/openxiangda-support/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: openxiangda-support
+description: 在 OpenXiangda 应用开发中接入内部平台支持协作，咨询平台契约、诊断异常、评审产品与架构，并持续跟进已授权的支持案例。普通应用实现继续使用项目对应代际技能。
+---
+
+# OpenXiangda 支持协作
+
+## 接入与恢复
+
+统一入口的 `support status --json` 返回实际接入状态、精确 DWS profile 和当前通道。新应用创建及技能刷新会执行 bootstrap；离线或待授权不会阻塞应用。缺失时执行 `support bootstrap`，由它安装/复用官方稳定 DWS 和全套 multi 技能。旧 V1 项目通过统一入口使用支持命令，业务仍走项目 V1 引擎；不升级项目代际来取得支持。
+
+`support login` 引导用户完成 OAuth；SSH 使用 `--device`。多账号时使用用户指定的 `--profile <corpId:userId>` 或目标组织明确的默认账号，后续复用保存的 profile。不得切换全局默认组织或根据姓名选账号。`support join` 原样打开外置配置的邀请链接，用户在钉钉完成加入；不能打开时展示返回的同一地址。随后运行 `support status` 检查群访问。链接已打开、命令退出成功或群可读不等于独立验证了成员身份或组织限制，以返回的各项状态为准。
+
+DWS 命令、参数和实际访问由官方 `dingtalk-chat`、`dingtalk-event` 及其 references 负责；账号问题读取 `dingtalk-misc/references/profile.md`。始终带同一 `--profile` 和 `--format json`，按叶子 Schema/Help 补齐未知参数。授权、加入或服务暂不可用时记录待办，继续独立的应用工作。
+
+## 何时讨论
+
+遇到平台契约不明确、文档与实测冲突、需要平台源码/部署/日志证据、复杂权限与数据处理、通用能力取舍或新需求评审时，先读项目当前资料及证据，再在用户已经授权的协作范围内发问。此技能不会单独授予发送消息、操作服务器、修改数据或发布权限。
+
+提问包含目标、现象、已尝试方法、关键证据、需平台判断的问题；从项目 context 补平台、应用、环境及实际版本。未创建应用的能力咨询标记为平台咨询，不伪造 appCode。内部协作可以讨论相关业务逻辑、源码、日志和完整方案；凭据自动遮蔽，不把维护者 localhost 地址作为其他成员的审阅入口。
+
+需要读取应用源码时，提供平台地址及平台内置仓库 URL。支持侧使用正式 `source resolve <仓库URL> --base-url <平台> --json`，再 `source clone <仓库URL> <新目录> --base-url <平台> --json`；记录实际分支与 commit，首次检出不安装或运行项目脚本。使用平台现有身份和 `PLATFORM_ADMIN` 权限事实，不按某个账号名字开例外。旧项目使用 `source setup --import` 保留原仓库，正常解决 Git 冲突；详细契约以当前版本 getting-started 资料为准。
+
+## 评审与持续协作
+
+产品/架构咨询明确真实问题、已有能力、应用或平台归属、跨项目价值、成本与兼容性、失败恢复和验收方法。可以得出现有能力可满足、应用层实现、证据不足、重复需求、平台候选、已安排实施或拒绝/延期；每项结论附证据及下一步责任方。只有关联真实工程任务及容量才称为已安排实施，不口头承诺发布日期，不把客户业务实体当作平台定义。
+
+首问使用官方群消息入口；后续按真实消息 ID 引用回复，沿同一案例追加证据与验证，不重复创建问题。读取回复后补实现/复现结果，明确解决、暂行规避、候选需求或尚有争议；已回答不等于已解决。复杂或高影响操作先给具体对象、差异、影响、恢复方式，在已有授权范围内推进，超出部分才请求决定。
+
+活跃任务可通过官方事件技能等待增量，恢复任务时读取未完成案例。消息 ID、游标、未决项和下一步责任方保留在项目现有交接记录中，不含凭据。技能不会唤醒结束的 AI 会话；后台继续需要宿主真实监听或定时任务，不宣称所有宿主均已接入。
+
+两个 AI 使用不同真实身份。发送请求成功不是消息投递成功；检查真实投递结果，结果不明先回读，不盲目重发。确认、感谢和重复消息不启动新轮；初始上限 6 轮有效往返，连续 2 轮无新证据时暂停并列未决项。结论引用来源和适用版本交给既有案例/知识流程，不另建一套权威路线图。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "OpenXiangda 2.0 的统一命令、应用 SDK、MCP 与中文 AI 技能资料。",
   "type": "module",
   "main": "./dist/index.js",
@@ -58,13 +58,13 @@
     "antd-mobile": "5.42.3",
     "dayjs": "1.11.18",
     "docx-preview": "0.3.7",
-    "openxiangda-cli": "2.1.0",
-    "openxiangda-contracts": "2.1.0",
-    "openxiangda-devkit-core": "2.1.0",
+    "openxiangda-cli": "2.2.1",
+    "openxiangda-contracts": "2.2.0",
+    "openxiangda-devkit-core": "2.2.0",
     "openxiangda-legacy": "npm:openxiangda@1.0.268",
-    "openxiangda-mcp": "2.0.1",
-    "openxiangda-nest": "2.0.1",
-    "openxiangda-skill-kit": "2.0.1",
+    "openxiangda-mcp": "2.0.2",
+    "openxiangda-nest": "2.0.2",
+    "openxiangda-skill-kit": "2.0.3",
     "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz"
   },
   "peerDependencies": {
@@ -130,21 +130,24 @@
   },
   "openxiangdaRelease": {
     "schemaVersion": "openxiangda.release-notes/v1",
-    "version": "2.1.0",
-    "title": "OpenXiangda 平台托管应用镜像上传",
+    "version": "2.2.0",
+    "title": "OpenXiangda 内部支持协作接入",
     "status": "reviewed",
-    "summary": "应用 Nest 后端在本机构建为 OCI 镜像后，通过平台登录态分片上传。平台负责应用归属校验、镜像存储和运行时拉取，开发者无需取得平台维护者个人镜像仓库的推送权限。",
+    "summary": "统一入口为 V1/V2 应用开发提供内部支持协作接入，检查官方 DWS 与技能，复用精确账号，并提供授权、打开群邀请和持续案例跟进入口。",
     "newFeatures": [
-      "发现并优先使用平台 backendImageUpload 能力，导出 linux/amd64 OCI 镜像并上传有界分片。",
-      "上传前校验本地镜像大小和摘要，复用已完成的镜像回执，并恢复分片传输中断。"
+      "新增 support status、bootstrap、login、join，应用创建和技能刷新后检查支持通道接入状态。",
+      "缺少 DWS 时安装官方稳定版 1.0.61，并安装官方完整 multi 技能；已有可用稳定版本可以复用。",
+      "增加跨 V1/V2 支持技能，涵盖平台契约咨询、源码诊断上下文、产品架构评审和已授权案例的引用跟进。",
+      "使用外置支持通道配置，按原始邀请链接打开钉钉，由用户完成加入。"
     ],
     "fixes": [
-      "启用平台上传后，应用部署不再依赖开发者对平台维护者镜像仓库的推送权限。",
-      "Docker classic image store 不支持 OCI 导出时，返回明确的 builder 配置指引。"
+      "支持接入失败或等待用户操作时保留独立状态，不改变应用创建成功结果；进度写入 stderr，保持引擎 JSON 输出。",
+      "使用保存的精确 DWS profile，不按显示姓名或列表顺序猜测账号，不切换平台或 DWS 全局登录身份。",
+      "命令发现由统一分发层维护，技能校验显式接收分发命令，保持 V2 核心与两代引擎边界。"
     ],
     "affectedUsers": [
-      "声明可选 Nest 后端并通过 CLI 或 MCP 部署的 OpenXiangda 2.0 应用开发者。",
-      "维护共享应用运行时及平台镜像存储的平台管理员。"
+      "通过统一入口创建应用、初始化工作区或刷新技能的 V1/V2 开发者。",
+      "在内部支持通道中继续已授权平台咨询和故障排查的开发 AI。"
     ],
     "compatibility": {
       "node": ">=24",
@@ -152,25 +155,26 @@
         "v1",
         "v2"
       ],
-      "v1Policy": "V1 应用保持原代际、版本锁定与登录绑定。",
-      "platformPolicy": "平台托管上传需要匹配的后端、Registry 和网关发布，并启用 backendImageUpload；旧平台继续使用既有构建合同。",
-      "backendBuild": "可选 Nest 后端仍在开发者电脑上使用 Docker Buildx 构建，需要支持 OCI exporter 的 builder。",
+      "v1Policy": "V1 项目保持原代际、版本锁定与登录绑定；支持接入由统一分发入口提供。",
+      "platformPolicy": "本次工具发布不要求更新平台镜像；源码诊断仍需目标平台已启用正式源码托管并授予当前账号访问权限。",
+      "dws": "最低稳定版 1.0.61；OAuth 与加入群需要用户在官方流程中完成。",
       "releaseChannels": "latest / stable-v2：V2 正式版；legacy-v1：V1 维护版；alpha：预发布。"
     },
     "upgradeSteps": [
-      "平台管理员先按部署运行手册准备镜像存储与凭据，再部署匹配的后端和网关。",
-      "在 Node.js 24 环境安装统一入口：npm install -g openxiangda@2.1.0。",
-      "更新 V2 项目锁定的工具链并刷新项目资料，核对平台上传能力后运行项目的 openxiangda deploy。"
+      "在 Node.js 24 环境安装统一入口：npm install -g openxiangda@2.2.0。",
+      "运行 openxiangda support bootstrap 检查安装与完整技能；离线或 CI 初始化可使用 --skip-support，之后再恢复。",
+      "运行 openxiangda support status --json 查看实际状态；需要时执行 support login，SSH 可使用 --device。",
+      "尚不能访问支持群时运行 support join，在钉钉完成加入后重新检查状态；已有授权案例继续引用原消息跟进。"
     ],
     "knownLimitations": [
-      "当前仅支持 linux/amd64 单平台 OCI 镜像；默认单镜像上限为 1Gi，由平台配置控制。",
-      "已声明但未启用的平台上传能力会阻止部署，避免回退到个人镜像仓库推送。",
-      "镜像保留与垃圾回收由平台运维单独管理；现有版本仍可能需要历史镜像进行部署或回滚。",
-      "托管镜像开始使用后，后端回滚必须保留 Registry、持久卷、凭据和网关读取路由。"
+      "可读取群仅证明当前账号的访问能力，不能单独证明群成员身份或组织限制；命令返回独立验证状态。",
+      "技能不会唤醒已经结束的开发任务，后台继续需要宿主实际监听或定时任务。",
+      "安装、授权和群访问依赖网络及组织配置；新的真实用户入群与双方协作须单独现场验收，替身测试不构成真人验收。",
+      "本包提供接入与协作指导，常驻支持服务及知识库由各自私有服务独立部署。"
     ],
     "issues": [],
-    "sha256": "d7f6a21ddc37b3d2439350bf17f5f4575192168944dc33efb15460f7d1854aff",
-    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.1.0"
+    "sha256": "638817e7e1d8c9cb99de6b9d41716828d241e31905c9bd0565cb94e43b9ee991",
+    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.2.0"
   },
   "scripts": {
     "build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",

package/releases/2.1.1.json

@@ -0,0 +1,48 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.1.1",
+  "title": "OpenXiangda 应用源码托管",
+  "status": "reviewed",
+  "summary": "私有化平台通过共享 Forgejo 管理应用源码。创建应用时自动初始化私有仓库并推送代码，应用管理员自动获得仓库管理权限，开发者使用长期 Git 凭据。",
+  "newFeatures": [
+    "既有 PLATFORM_ADMIN 自动获得共享 Git 服务全部已有和新建仓库的管理权限。",
+    "source resolve/clone 支持仅凭平台与仓库 URL、使用当前登录态读取源码，不安装或执行应用脚本。",
+    "新增 source status、source setup 和 source push 命令，支持初始化恢复和已有工作区接入。",
+    "创建应用后自动提交并推送初始源码，通过系统凭据管理器保存个人 Git 凭据。",
+    "配套平台支持首次部署前浏览源码及最近提交，并核验部署关联的提交已经推送。"
+  ],
+  "fixes": [
+    "应用源码可直接保留在平台托管仓库中，减少对开发者个人 Git 服务的依赖。",
+    "显式导入保留原 origin 为 external-source，初始化重试保留已有未提交修改，冲突推送不覆盖远端提交。"
+  ],
+  "affectedUsers": [
+    "使用 OpenXiangda 2.0 创建应用或接入平台源码仓库的开发者。",
+    "维护内部私有化平台和应用管理员权限的平台管理员。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": [
+      "v1",
+      "v2"
+    ],
+    "v1Policy": "V1 应用保持原代际、版本锁定与登录绑定。",
+    "platformPolicy": "自动源码托管需要匹配的平台后端、管理前端和网关，并配置 OPENXIANGDA_SOURCE_*；未启用的站点保持原创建行为。",
+    "gitCredential": "支持 macOS Keychain、Windows Git Credential Manager，以及 Linux 已安装的 Git Credential Manager 或 libsecret。",
+    "releaseChannels": "latest / stable-v2：V2 正式版；legacy-v1：V1 维护版；alpha：预发布。"
+  },
+  "upgradeSteps": [
+    "平台管理员配置共享 Forgejo、源码入口和专用凭据派生密钥，部署匹配的平台版本；长期保留密钥及 Git 数据。",
+    "在 Node.js 24 环境安装统一入口：npm install -g openxiangda@2.1.1。",
+    "更新 V2 工作区工具链；新应用自动接入，已有应用运行 openxiangda source setup --import 接入。",
+    "完成修改后运行 openxiangda source push -m 描述，再按现有检查和部署流程交付。"
+  ],
+  "knownLimitations": [
+    "当前仅同步应用管理员新增授权，不同步撤销或删除。",
+    "导入推送当前分支，不自动迁移全部历史分支、标签及 LFS 对象。",
+    "制品仍在本地构建；提交存在性核验不构成服务端构建证明。",
+    "新源码功能不依赖 Studio；Studio 旧代码移除属于独立后续工作。"
+  ],
+  "issues": [],
+  "sha256": "f7341eb21e1489c684ee03eed31568063dfad01bfe345f914552bd51b7357f84",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.1.1"
+}

package/releases/2.2.0.json

@@ -0,0 +1,48 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.2.0",
+  "title": "OpenXiangda 内部支持协作接入",
+  "status": "reviewed",
+  "summary": "统一入口为 V1/V2 应用开发提供内部支持协作接入，检查官方 DWS 与技能，复用精确账号，并提供授权、打开群邀请和持续案例跟进入口。",
+  "newFeatures": [
+    "新增 support status、bootstrap、login、join，应用创建和技能刷新后检查支持通道接入状态。",
+    "缺少 DWS 时安装官方稳定版 1.0.61，并安装官方完整 multi 技能；已有可用稳定版本可以复用。",
+    "增加跨 V1/V2 支持技能，涵盖平台契约咨询、源码诊断上下文、产品架构评审和已授权案例的引用跟进。",
+    "使用外置支持通道配置，按原始邀请链接打开钉钉，由用户完成加入。"
+  ],
+  "fixes": [
+    "支持接入失败或等待用户操作时保留独立状态，不改变应用创建成功结果；进度写入 stderr，保持引擎 JSON 输出。",
+    "使用保存的精确 DWS profile，不按显示姓名或列表顺序猜测账号，不切换平台或 DWS 全局登录身份。",
+    "命令发现由统一分发层维护，技能校验显式接收分发命令，保持 V2 核心与两代引擎边界。"
+  ],
+  "affectedUsers": [
+    "通过统一入口创建应用、初始化工作区或刷新技能的 V1/V2 开发者。",
+    "在内部支持通道中继续已授权平台咨询和故障排查的开发 AI。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": [
+      "v1",
+      "v2"
+    ],
+    "v1Policy": "V1 项目保持原代际、版本锁定与登录绑定；支持接入由统一分发入口提供。",
+    "platformPolicy": "本次工具发布不要求更新平台镜像；源码诊断仍需目标平台已启用正式源码托管并授予当前账号访问权限。",
+    "dws": "最低稳定版 1.0.61；OAuth 与加入群需要用户在官方流程中完成。",
+    "releaseChannels": "latest / stable-v2：V2 正式版；legacy-v1：V1 维护版；alpha：预发布。"
+  },
+  "upgradeSteps": [
+    "在 Node.js 24 环境安装统一入口：npm install -g openxiangda@2.2.0。",
+    "运行 openxiangda support bootstrap 检查安装与完整技能；离线或 CI 初始化可使用 --skip-support，之后再恢复。",
+    "运行 openxiangda support status --json 查看实际状态；需要时执行 support login，SSH 可使用 --device。",
+    "尚不能访问支持群时运行 support join，在钉钉完成加入后重新检查状态；已有授权案例继续引用原消息跟进。"
+  ],
+  "knownLimitations": [
+    "可读取群仅证明当前账号的访问能力，不能单独证明群成员身份或组织限制；命令返回独立验证状态。",
+    "技能不会唤醒已经结束的开发任务，后台继续需要宿主实际监听或定时任务。",
+    "安装、授权和群访问依赖网络及组织配置；新的真实用户入群与双方协作须单独现场验收，替身测试不构成真人验收。",
+    "本包提供接入与协作指导，常驻支持服务及知识库由各自私有服务独立部署。"
+  ],
+  "issues": [],
+  "sha256": "638817e7e1d8c9cb99de6b9d41716828d241e31905c9bd0565cb94e43b9ee991",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.2.0"
+}

package/skills/manifest.json

@@ -4,7 +4,7 @@
     {
       "name": "openxiangda-v2",
       "description": "使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发，通过对话发现模块、完成详细产品设计，再开发、检查和交付应用。维护 1.x 应用时使用对应的 1.x 技能。",
-      "sha256": "3f1a2044254680d480e72ad0fb524967ed471a8c44bb9b0c2b9f226d7e834f43"
+      "sha256": "618f4dbe2de1ae08879b04bd192f1feadad24c09b5147f7f222e483e03c8f142"
     }
   ]
 }

package/skills/openxiangda-v2/SKILL.md

@@ -18,10 +18,10 @@ description: 使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具
 未创建工作区时使用本 Skill 随根包发布的精确版本：
 
 ```bash
-pnpm dlx openxiangda@2.1.0 auth status --base-url <平台地址> --json
-pnpm dlx openxiangda@2.1.0 login --base-url <平台地址>
-pnpm dlx openxiangda@2.1.0 create <应用目录> --base-url <同一平台地址>
-pnpm dlx openxiangda@2.1.0 skill install --force
+pnpm dlx openxiangda@2.2.0 auth status --base-url <平台地址> --json
+pnpm dlx openxiangda@2.2.0 login --base-url <平台地址>
+pnpm dlx openxiangda@2.2.0 create <应用目录> --base-url <同一平台地址>
+pnpm dlx openxiangda@2.2.0 skill install --force
 ```
 
 创建前把产品要求的目标平台明确带入命令，不从旧登录态推断站点。已有工作区从原绑定恢复，平台不一致时先解决登录与目标，不改 link 文件跨站创建。
@@ -30,11 +30,14 @@ pnpm dlx openxiangda@2.1.0 skill install --force
 
 ## 按任务选择资料
 
+平台契约疑问、诊断和产品/架构咨询使用同次分发的 `openxiangda-support` 技能。统一入口创建和技能刷新会检查 DWS；用 `support status --json` 查看待授权、待用户入群或可访问状态，独立应用工作继续推进。实际发送与后续操作遵循用户已有授权。
+
 只读当前任务相关专题。以下参考由中文使用文档生成，与 CLI/MCP 正文同源：
 
 | 任务 | 参考 |
 | --- | --- |
 | 安装、登录、创建、连接开发 | [开始开发](references/getting-started.md) |
+| 源码仓库、换电脑、旧项目导入、提交推送与重试 | [应用源码](references/getting-started.md#应用源码)；先用 `source status` 读取实际绑定 |
 | 模糊想法、模块发现、PRD、权限与架构设计 | [产品设计](references/product-design.md)、[交互模式](references/interaction-patterns.md) |
 | 理解需求与选择能力 | [开发流程](references/development.md)、[架构](references/concepts.md) |
 | 模型、CRUD、字段与移动表单 | [业务模块](references/application-foundation.md)、[字段](references/field-components.md) |
@@ -77,6 +80,12 @@ pnpm exec openxiangda --mcp-stdio --cwd <workspace>
 
 开发开始先同步绑定仓库的远端默认主分支。开发完成包括源码、生成契约与必要记录的提交、推送和主线整合；发布从干净且同步的主分支冻结候选。任务分支已推送不代表进入主线。同一工作区保持一个写者，不覆盖其他会话未提交内容。日常 dev/check 可验证未提交源码。
 
+平台启用源码托管时，create 自动建仓并首次推送。后续每轮开发完成使用 `pnpm openxiangda source push -m "变更说明"` 提交并推送；已有提交可省略 `-m`。新电脑或初始化中断使用 `source setup`，迁入外部仓库使用 `source setup --import` 并保留原远端。凭据只存入系统凭据管理器，不手写进 URL 或项目文件；冲突按正常 Git 合并处理，不强推覆盖。
+
+已有项目先执行 `source status`；仓库绑定和地址以平台返回为准，不猜测地址或另建个人仓库。提交前检查 Git 差异；`source push -m` 会提交所有未忽略更改，存在其他任务改动时应只提交本轮文件，再不带 `-m` 推送。源码操作使用 CLI，当前没有独立的 source MCP 工具。凭据配置成功后无需每轮重新配置；托管未启用或权限不足时保留原工作区并报告具体原因。
+
+支持排查只有平台地址和仓库 URL 时，先运行 `source resolve <仓库URL> --base-url <平台> --json`，再用 `source clone <仓库URL> <新目录> --base-url <平台> --json` 获取源码，可选 `--branch`。无需预先创建工作区，不猜 appCode，不安装或运行应用脚本；使用当前平台登录账号与系统 Git 凭据。平台既有 `PLATFORM_ADMIN` 可管理共享服务全部仓库，应用管理员只管理对应应用仓库。完整契约见[应用源码](references/getting-started.md#应用源码)。
+
 只验证时运行 check/check_app；授权部署时直接 deploy/deploy_app，它已经包含检查并默认跟踪平台完成，长步骤持续反馈阶段和耗时。生产显式复用成功测试运行。观察中断用 status <运行ID> --watch 或 deployment_status.watch 继续查询原运行。登录、创建及长期 dev 使用 CLI/终端，分别记录本地验证、部署激活和真实业务验收。
 
 失败保留错误码、指针与原候选。结果不确定先查平台，不生成新的随机幂等键掩盖原运行；仅执行平台允许的恢复。升级项目后刷新资料并重启旧 MCP 连接。

package/skills/openxiangda-v2/references/cli.md

@@ -9,6 +9,7 @@
 | `pnpm openxiangda docs` | 只读 | 按主题和章节读取当前版本中文资料 |
 | `pnpm openxiangda admin` | 只读 | 只读查看应用管理能力和流程节点运行配置 |
 | `pnpm openxiangda create` | 远端变更 | 创建、绑定并初始化应用 |
+| `pnpm openxiangda source` | 远端变更 | 配置应用源码仓库、查看状态或提交推送 |
 | `pnpm openxiangda dev` | 本地写入 | 连接平台测试数据启动本地 Web，按需启动 Nest |
 | `pnpm openxiangda check` | 本地写入 | 生成契约并在目标平台预检后执行检查、测试和构建 |
 | `pnpm openxiangda accept` | 远端变更 | 按计划准备可选的真实预发验收身份 |

package/skills/openxiangda-v2/references/delivery.md

@@ -4,6 +4,10 @@
 
 ## 测试部署
 
+托管源码应用通过 `pnpm openxiangda source push -m "本轮变更说明"` 完成提交与推送。
+发布系统在平台绑定仓库中核验精确源码提交，并沿用 AppVersion 的源码和制品摘要关联。
+本地构建仍是当前交付方式；源码提交存在不等于平台已独立验证制品由该提交构建。
+
 发布前，先将本轮源码、生成契约及必要记录合入并推送仓库的远端默认主分支，然后从干净且同步的主分支工作区发布。工具从 origin 的远端 HEAD 识别主分支，不把任务分支的 upstream 当作主线。未提交、未推送、未合并或落后主线的问题会在构建和上传前返回；工具不会自动合并分支或覆盖其他会话的改动。
 
 开发开始时先同步主线并读取项目现状，开发完成包括提交、推送与主线整合。每个工作区保持一个写者；需要并行时使用独立目录并明确各任务范围。日常 dev/check 仍可验证未提交源码。没有 Git 远端的项目应先建立并绑定仓库再发布。

package/skills/openxiangda-v2/references/getting-started.md

@@ -11,10 +11,10 @@ OpenXiangda 2.0 默认生成 React 应用和共享契约。普通 CRUD、标准
 以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
 
 ```bash
-pnpm dlx openxiangda@2.1.0 skill install --force
-pnpm dlx openxiangda@2.1.0 auth status --base-url <平台地址> --json
-pnpm dlx openxiangda@2.1.0 login --base-url https://platform.example.com
-pnpm dlx openxiangda@2.1.0 create my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.2.0 skill install --force
+pnpm dlx openxiangda@2.2.0 auth status --base-url <平台地址> --json
+pnpm dlx openxiangda@2.2.0 login --base-url https://platform.example.com
+pnpm dlx openxiangda@2.2.0 create my-app --base-url https://platform.example.com
 cd my-app
 pnpm openxiangda context --json
 pnpm openxiangda dev
@@ -26,6 +26,23 @@ pnpm openxiangda dev
 
 进入项目后使用 `pnpm openxiangda`，由项目依赖和锁文件决定版本。查看使用资料运行 `pnpm openxiangda docs`；查看单一主题运行 `pnpm openxiangda docs frontend`。安装到其他 AI 工具时使用 `skill install --destination <Skill根目录>`。
 
+### 内部支持协作
+
+统一入口在成功创建应用、V1 workspace init/skill bootstrap 和 skill install 后检查 DWS。缺失时安装审核过的官方稳定版和完整 multi 技能（包括 shared、misc/profile 等跨技能引用），复用可用版本；不会自动登录、加入群或发送消息。支持接入结果独立于应用创建，JSON 创建结果保持原结构，接入进度写 stderr。
+
+```bash
+pnpm openxiangda support status --json
+pnpm openxiangda support bootstrap
+pnpm openxiangda support login
+pnpm openxiangda support join
+```
+
+首次 OAuth 由用户完成，SSH 使用 `support login --device`。支持侧保存 DWS 精确 profile 指针，多账号可传 `--profile <corpId:userId>`；不修改 DWS 或平台默认账号。通道来自外置配置，`join` 原样打开邀请链接，由用户在钉钉完成加入，再执行 `status` 回读。群可访问、成员身份与组织限制分别报告；钉钉负责真实权限判断，不凭链接推定。
+
+等待授权、入群、网络或安装权限时可以继续独立开发。离线/CI 创建和技能安装可加 `--skip-support`，之后运行 `support bootstrap` 恢复。完整官方技能由 DWS 自身安装/备份；自动接入使用 DWS 的 all 目标检测宿主，应用技能安装的 --agent 只决定应用技能位置。`support bootstrap --force --agent <DWS目标宿主>` 可显式指定 DWS 宿主并刷新。`support --help` 查看命令，支持命令无需应用依赖已安装；独立 V1 引擎没有这些分发命令，应使用新版统一入口，保留原 V1 项目版本。
+
+本地接入指针位于 `${XDG_CONFIG_HOME:-~/.config}/openxiangda/support.json`，只保存 profile 和技能安装回执，不保存 Token。普通支持咨询与持续讨论遵循安装的 `openxiangda-support` 技能及用户授权；后台唤醒须有真实宿主监听或定时任务。
+
 ## 项目结构 {#workspace}
 
 ```text
@@ -47,6 +64,83 @@ AppSpec 随开发持续维护：测试发布前补齐总纲、关联变更与验
 
 纯 CRUD 修改优先使用标准模型、字段和页面；跨模型事务或外部副作用再选择后端。角色、行和字段权限在平台执行。详见[开发流程](development.md)、[模型与标准 CRUD](application-foundation.md)和[按需后端](backend.md)。
 
+## 应用源码
+
+平台启用源码托管后，`create` 自动建立应用私有仓库、配置长期 Git 凭据并推送首次提交。
+应用管理员自动拥有对应仓库管理员权限；无需注册另一套账号。凭据存入系统凭据管理器，
+macOS 使用 Keychain，Windows 使用 Git Credential Manager，Linux 使用已安装的
+Git Credential Manager 或 libsecret。新电脑首次使用需重新执行源码配置。
+
+```bash
+pnpm openxiangda source status
+pnpm openxiangda source setup
+pnpm openxiangda source push -m "完成本轮应用开发"
+```
+
+创建或推送中断后，在原目录重试。已有外部仓库使用 `source setup --import`，原 `origin`
+保留为 `external-source`；当前分支的历史随推送保留，不执行强推，也不自动合并冲突。
+其他分支、标签和 Git LFS 对象需按实际迁移范围另外推送。`source push` 省略 `-m` 时只推送
+已有提交；带 `-m` 时提交当前所有未忽略更改。源码入口位于平台应用运营的“应用源码”。
+
+| 当前场景 | 执行方式 |
+| --- | --- |
+| 新应用 | 正常执行 `create`，平台启用后自动建仓、配置凭据和首次推送 |
+| 已有项目首次交接给另一个 AI | 先读 `context --json` 和 `source status`，沿用项目绑定与版本 |
+| 换电脑或初始化中断 | 在应用目录执行 `pnpm openxiangda source setup`；已有提交及未提交修改会保留 |
+| 从个人远端迁入 | 明确迁入后运行 `source setup --import`，原远端保留为 `external-source` |
+| 本轮修改完成 | 检查差异后运行 `source push -m "AppSpec: <本轮变更ID> 变更说明"`；多个任务共享目录时先精确提交本轮文件，再不带 `-m` 推送 |
+| 准备部署 | 先把本轮提交合入并推送远端默认分支，再从干净且同步的主分支执行 `deploy` |
+
+新仓库默认使用 `main`；导入时，尚无默认分支的空仓库会采用当前分支（例如 `master`）。
+已有远端默认分支不会因在任务分支运行 setup 而改变。源码操作使用 CLI/终端；
+MCP 的 `docs_read` 可以读取本说明，当前没有独立的源码操作 MCP 工具。
+
+| 错误或状态 | 处理 |
+| --- | --- |
+| `enabled: false` | 平台尚未启用托管，沿用当前工作区；由平台管理员配置后再接入 |
+| `APPLICATION_SOURCE_ORIGIN_CONFLICT` | 核实平台绑定和现有 origin；仅在明确迁入时使用 `--import` |
+| `APPLICATION_SOURCE_CREDENTIAL_HELPER_REQUIRED` / `APPLICATION_SOURCE_CREDENTIAL_NOT_STORED` | 安装或解锁系统凭据管理器，再重试 setup；不把密码写入 URL、项目或明文凭据文件 |
+| 403 / 应用管理权限不足 | 核对当前平台账号及应用管理员资格；由已有应用管理员添加权限 |
+| `APPLICATION_SOURCE_PROVIDER_UNAVAILABLE` / `APPLICATION_SOURCE_PROVIDER_FAILED` | 保留原应用和目录，待 Git 服务恢复后重试同一操作 |
+| 推送被拒绝或主线已前进 | 先 fetch 并查看差异，按项目规则合并解决冲突后重试，不强推覆盖 |
+| `APPLICATION_SOURCE_COMMIT_NOT_PUSHED` | 在绑定仓库推送原提交，核对 source status 和远端 SHA 后重试部署 |
+
+应用创建人和新增应用管理员拥有对应仓库管理权限，不需要另行维护 Git 角色。
+本期不自动同步权限撤销或删除。不要向应用开发者索要 Forgejo 平台管理员 Token；
+个人凭据由已登录的平台账号获取，配置成功后可长期复用。
+
+### 从平台和仓库 URL 获取源码
+
+无需本地工作区，使用本 Skill 随包精确版本或已安装的对应 CLI：
+
+```bash
+pnpm dlx openxiangda@2.2.0 auth status --base-url <平台> --json
+pnpm dlx openxiangda@2.2.0 source resolve <仓库URL> --base-url <平台> --json
+pnpm dlx openxiangda@2.2.0 source clone <仓库URL> <新目录> --base-url <平台> --json
+```
+
+登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回
+`appCode/name/repository`，不猜应用代码；clone 使用当前账号配置长期凭据后检出源码，
+返回 `root/baseUrl/appCode/repository/branch/commit`。`--branch <分支>` 可指定分支，
+省略时使用 Forgejo 实际默认分支。目标目录必须不存在；失败时保留目录供检查。
+克隆不会加载应用配置、安装依赖、执行应用脚本或递归拉取子模块，并禁用 checkout hooks
+和全局过滤器；需要 LFS 内容时在审查后单独处理。
+
+既有 `PLATFORM_ADMIN` 平台管理员映射为共享 Forgejo 管理员，可完整管理已有及以后创建的
+全部仓库，不受应用创建人或应用成员登记限制。平台应用管理员保持对应仓库管理权限。
+该规则没有新增平台角色，也不扩展普通应用成员的权限。
+
+正式 API 均位于平台 `/service/openxiangda-api/v2` 下，使用现有登录态：
+
+| API | 请求及响应 data |
+| --- | --- |
+| `GET /application-source/resolve?repository=<编码后的仓库URL>` | 接受平台登记的 cloneUrl 或 webUrl，返回 `{ appCode, name, repository }`；不返回凭据 |
+| `POST /application-source/credential` | JSON `{ "repository": "仓库URL" }`，返回 `{ appCode, repository, username, password, name, email }`，响应 `Cache-Control: no-store` |
+| `POST /application-source/administrators/reconcile` | 仅平台管理员；同步已有 PLATFORM_ADMIN 到 Git，返回 `{ synchronized }`，不返回凭据 |
+
+使用 CLI 时无需自行调用凭据 API；支持工具不得记录其响应或另建身份体系。
+未登记的外部仓库先在原工作区执行 `source setup --import`，再使用平台返回的仓库 URL。
+
 ## 检查与交付 {#delivery}
 
 只检查时运行 `pnpm openxiangda check`。需要部署测试环境时直接运行 `pnpm openxiangda deploy`，它已包含检查、测试和构建；无需再连续重复运行全部脚本。