netizen-cli 0.13.0__tar.gz → 0.13.2__tar.gz

{netizen_cli-0.13.0/netizen_cli.egg-info → netizen_cli-0.13.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: netizen-cli
-Version: 0.13.0
+Version: 0.13.2
 Summary: Use native Codex threads through a Feishu Channel.
 Requires-Python: <3.15,>=3.11
 Requires-Dist: h11==0.16.0

{netizen_cli-0.13.0 → netizen_cli-0.13.2}/netizen_cli/__init__.py

@@ -1,3 +1,3 @@
 """Netizen: a thin Feishu Channel for native Codex Threads."""
 
-__version__ = "0.13.0"
+__version__ = "0.13.2"

{netizen_cli-0.13.0 → netizen_cli-0.13.2}/netizen_cli/admin/static/admin.css

@@ -200,11 +200,32 @@ button:disabled { cursor: default; opacity: .48; }
 .service-restart p { line-height: 1.6; }
 #updates a { color: var(--blue); }
 button:focus-visible, input:focus-visible, select:focus-visible { outline: 3px solid #8cb4ff; outline-offset: 2px; }
-.login-body { min-height: 100vh; display: grid; place-items: center; padding: 20px; }
-.login-card { width: min(420px, 100%); background: white; border: 1px solid var(--line); border-radius: 14px; padding: 28px; }
-.login-card label { display: grid; gap: 7px; }
-.login-card input { margin-bottom: 14px; }
-.login-card button { width: 100%; border: 0; border-radius: 8px; padding: 10px; background: var(--blue); color: white; }
+.login-body { min-height: 100vh; min-height: 100svh; display: grid; place-items: center; padding: clamp(12px, 3vw, 24px); }
+.login-card { width: min(420px, 100%); min-width: 0; margin: 0; padding: clamp(20px, 5vw, 28px); border: 1px solid var(--line); border-radius: 14px; background: var(--paper); box-shadow: 0 8px 28px rgb(23 39 68 / 6%); font-size: 14px; line-height: 1.6; }
+.login-heading h1 { font-size: 28px; line-height: 1.2; }
+.login-heading p { margin: 8px 0 0; color: var(--muted); font-size: 13px; }
+.login-instance { margin: 20px 0; padding: 10px 12px; border-radius: 8px; background: var(--wash); }
+.login-instance > span { color: var(--muted); font-size: 12px; }
+.login-instance .instance-root { margin: 3px 0 0; line-height: 1.5; }
+.login-card .login-button { display: inline-flex; align-items: center; justify-content: center; gap: 8px; min-height: 44px; border: 1px solid var(--line); border-radius: 8px; padding: 10px 14px; background: var(--paper); color: var(--ink); font-size: 14px; line-height: 22px; font-weight: 500; text-align: center; text-decoration: none; }
+.login-card .login-primary { width: 100%; border-color: var(--blue); background: var(--blue); color: white; }
+.login-card .login-cancel { border-color: transparent; background: transparent; color: var(--muted); }
+.login-card .login-secondary:hover:not(:disabled), .login-card .login-cancel:hover:not(:disabled) { background: var(--wash); }
+.login-card .login-button:focus-visible { outline: 3px solid #8cb4ff; outline-offset: 2px; }
+.login-scan { margin-top: 20px; }
+.login-scan:has(.login-qr[hidden]) { display: none; }
+.login-divider { display: flex; align-items: center; gap: 12px; margin: 0; color: var(--muted); font-size: 12px; }
+.login-divider::before, .login-divider::after { content: ""; flex: 1; border-top: 1px solid var(--line); }
+.login-qr { display: block; width: min(208px, 100%); height: auto; margin: 12px auto 0; }
+.login-user-code { display: flex; align-items: center; justify-content: center; flex-wrap: wrap; gap: 8px; margin: 12px 0 0; color: var(--muted); font-size: 12px; }
+#login-code { min-width: 0; border-radius: 6px; padding: 4px 8px; background: var(--wash); color: var(--ink); font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 16px; letter-spacing: .04em; overflow-wrap: anywhere; }
+.login-deadline { margin: 6px 0 0; color: var(--muted); font-size: 12px; text-align: center; }
+.login-deadline:empty { display: none; }
+.login-card .status { margin: 16px 0 0; font-size: 13px; text-align: center; overflow-wrap: anywhere; }
+.login-actions { display: flex; justify-content: center; flex-wrap: wrap; gap: 8px; margin-top: 16px; }
+.login-actions:not(:has(> :not([hidden]))) { display: none; }
+#login-retry { margin-top: 16px; }
+.login-safety { margin: 20px 0 0; border-top: 1px solid var(--line); padding-top: 14px; color: var(--muted); font-size: 12px; }
 @media (max-width: 650px) {
   .topbar { padding: 12px 18px; }
   .tabs { overflow-x: auto; padding: 10px 14px; }
@@ -220,7 +241,7 @@ button:focus-visible, input:focus-visible, select:focus-visible { outline: 3px s
   .time-range-fields { grid-template-columns: 1fr; }
 }
 .schedule-help { margin-top: 18px; color: var(--muted); }
-body.schedule-drawer-open, body.defaults-drawer-open, body.session-settings-drawer-open { overflow: hidden; }
+body.schedule-drawer-open, body.defaults-drawer-open, body.session-settings-drawer-open, body.workspace-drawer-open { overflow: hidden; }
 .editor-drawer { position: fixed; inset: 0 0 0 auto; margin: 0; padding: 0; width: min(720px, 100vw); max-width: 100vw; height: 100dvh; max-height: 100dvh; border: 0; color: var(--ink); background: var(--paper); box-shadow: -12px 0 40px rgb(23 39 68 / 16%); }
 .editor-drawer::backdrop { background: rgb(16 33 63 / 35%); }
 #schedule-editor { height: 100%; display: flex; flex-direction: column; border: 0; border-radius: 0; padding: 0; margin: 0; }
@@ -329,6 +350,19 @@ body.schedule-detail-open { overflow: hidden; }
 .drawer-footer { display: flex; justify-content: flex-end; gap: 10px; padding: 16px 24px; border-top: 1px solid var(--line); }
 .drawer-form .drawer-cancel { color: var(--ink); background: white; border: 1px solid var(--line); }
 .drawer-form input { margin: 0; }
+.workspace-form[hidden], .workspace-form [hidden] { display: none; }
+.workspace-fields { display: grid; gap: 18px; }
+.workspace-fields .hint { margin: -10px 0 0; }
+.workspace-field-label { margin: 0 0 8px; color: var(--muted); font-size: 13px; }
+.workspace-modes { display: flex; flex-wrap: wrap; gap: 4px; padding: 4px; border-radius: 9px; background: var(--wash); }
+.workspace-form .workspace-modes button { flex: 1; background: transparent; color: var(--muted); }
+.workspace-form .workspace-modes button[aria-pressed="true"] { background: var(--paper); color: var(--blue); box-shadow: 0 1px 4px rgb(23 39 68 / 12%); font-weight: 600; }
+.workspace-form .workspace-modes button:focus-visible { outline: 3px solid #8cb4ff; outline-offset: 2px; }
+.workspace-form .drawer-body > .hint { margin-top: 12px; }
+.workspace-form .status { margin-top: 24px; white-space: pre-line; overflow-wrap: anywhere; }
+.workspace-form .cascade-choice input { width: 16px; height: 16px; margin: 0; flex: 0 0 auto; }
+.workspace-form .target-summary, #worktree-effective-root { overflow-wrap: anywhere; }
+#projects .section-head, #worktrees .section-head { flex-wrap: wrap; }
 #defaults [hidden], #defaults-editor[hidden], #defaults-editor [hidden] { display: none; }
 .defaults-help, .defaults-order-help, .defaults-field-help { color: var(--muted); font-size: 13px; line-height: 1.6; }
 .defaults-help { margin: 12px 0 24px; }
@@ -382,25 +416,42 @@ body.schedule-detail-open { overflow: hidden; }
 .person-avatar[hidden], .person-placeholder[hidden] { display: none; }
 .auth-expired { display: flex; align-items: center; justify-content: center; gap: 18px; padding: 18px; background: #fff2df; color: #7b4400; }
 .auth-expired[hidden], .person[hidden], .identity-panel[hidden], .identity-panel [hidden], .login-card [hidden] { display: none; }
-.system-tabs { width: fit-content; margin: 22px 0; }
+.system-tabs { overflow-x: auto; }
+.system-tabs .session-tab { flex: 0 0 auto; min-height: 44px; }
+.system-tab-panel { padding-top: 20px; }
+.tab-unsaved { display: inline-block; margin-left: 6px; padding: 2px 6px; border-radius: 4px; background: #fff3d6; color: #875800; font-size: 12px; font-weight: 400; }
+.tab-unsaved[hidden] { display: none; }
 .admin-users { padding: 0; margin: 0; list-style: none; }
 .admin-users > li { display: flex; justify-content: space-between; align-items: center; gap: 16px; border-top: 1px solid var(--line); padding: 16px 0; }
-.session-access { margin-top: 32px; padding-top: 18px; border-top: 1px solid var(--line); }
-.session-access-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(min(300px, 100%), 1fr)); gap: 24px; }
-.session-access-grid h4 { margin: 0 0 8px; }
-.session-access-grid p { min-height: 48px; color: var(--muted); line-height: 1.6; }
-.session-access-grid textarea { width: 100%; resize: vertical; font-family: monospace; }
-.session-access-grid [hidden] { display: none; }
+.session-access-form { border: 0; padding: 0; }
+#session-access-fields { min-width: 0; margin: 0; border: 0; padding: 0; }
+.session-access-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(min(300px, 100%), 1fr)); align-items: start; gap: 16px; }
+.session-access-rule { min-width: 0; border: 1px solid var(--line); border-radius: 10px; padding: 20px; }
+.session-access-rule h4 { margin: 0; font-size: 16px; }
+.session-access-description { margin: 6px 0 20px; color: var(--muted); font-size: 13px; line-height: 1.6; }
+.session-access-targets { display: grid; gap: 16px; margin-top: 16px; }
+.session-access-rule-note { margin: 16px 0 0; color: var(--muted); font-size: 12px; line-height: 1.6; }
+.session-access-rule textarea { width: 100%; resize: vertical; font-family: ui-monospace, SFMono-Regular, Menlo, monospace; line-height: 1.6; }
+.session-access-rule .chat-picker-popup { width: 100%; max-width: 100%; }
+.session-access-rule [hidden] { display: none; }
+.session-access-help { margin-top: 16px; padding: 14px 16px; border-radius: 8px; background: var(--wash); color: var(--muted); font-size: 13px; line-height: 1.6; }
+.session-access-help h4 { margin: 0 0 6px; color: var(--ink); font-size: inherit; font-weight: 600; }
+.session-access-help p { margin: 4px 0 0; }
+.session-access-footer { display: flex; align-items: center; justify-content: space-between; flex-wrap: wrap; gap: 16px; margin-top: 20px; padding-top: 16px; border-top: 1px solid var(--line); }
+.session-access-footer .defaults-field-help { flex: 1 1 240px; margin: 0; }
+.session-access-footer .actions { flex: 0 0 auto; gap: 8px; margin-left: auto; }
+.session-access-footer button { min-width: 96px; min-height: 40px; border: 1px solid var(--blue); padding: 9px 14px; font-size: var(--control-font-size); line-height: var(--control-line-height); font-weight: 500; }
+.session-access-footer .refresh { border-color: var(--line); background: var(--paper); color: var(--ink); }
+@media (max-width: 650px) {
+  .session-access-rule { padding: 16px; }
+  .session-access-footer button { min-height: 44px; }
+}
 .identity-panel { max-width: 480px; border: 1px solid var(--line); border-radius: 14px; margin-bottom: 24px; padding: 20px; color: var(--ink); }
 .identity-panel h3 { margin: 0; }
 .identity-panel > p { margin: 20px 0; }
-.identity-panel-actions, .login-actions { display: flex; justify-content: flex-end; flex-wrap: wrap; gap: 10px; }
+.identity-panel-actions { display: flex; justify-content: flex-end; flex-wrap: wrap; gap: 10px; }
 #admin-selector { min-height: 48px; margin: 18px 0; }
 #admin-user-selection { margin-top: 20px; }
-.login-qr { display: block; width: min(240px, 100%); height: auto; margin: 18px auto; }
-.login-link { display: inline-block; margin-bottom: 14px; }
-.login-actions { justify-content: flex-start; margin: 18px 0; }
-#login-code { overflow-wrap: anywhere; }
 @media (max-width: 600px) {
   .topbar { align-items: flex-start; gap: 12px; flex-wrap: wrap; }
   .topbar-brand { flex-basis: 100%; }

{netizen_cli-0.13.0 → netizen_cli-0.13.2}/netizen_cli/admin/static/admin.js

@@ -3,6 +3,7 @@
 const state = {
   tab: "projects",
   sessionTab: "ordinary",
+  systemTab: "admins",
   projects: null,
   sessions: null,
   sides: null,
@@ -56,6 +57,12 @@ function expireAdminSession() {
   state.authExpired = true;
   stopUpdatePolling();
   window.NetizenSelect?.close();
+  // Release these modal drawers so the page's login link remains reachable.
+  // Inputs stay in memory, but expired actions can never be submitted again.
+  for (const dialog of document.querySelectorAll("#project-drawer, #worktree-create-drawer, #worktree-settings-drawer")) {
+    if (dialog.open) dialog.close();
+  }
+  document.body.classList.toggle("workspace-drawer-open", false);
   for (const element of document.querySelectorAll?.(".panel, dialog, .tabs") || []) element.inert = true;
   for (const button of document.querySelectorAll?.("button") || []) button.disabled = true;
   const notice = document.querySelector("#auth-expired");
@@ -403,6 +410,163 @@ function actionsCell(row) {
   return wrap;
 }
 
+let projectEditor = null;
+const projectInput = (name) => document.querySelector(`#project-${name}`);
+
+function projectEditorValues() {
+  if (!projectEditor) return null;
+  return { mode: projectEditor.mode, alias: projectInput("alias").value,
+    paths: { ...projectEditor.paths, [projectEditor.mode]: projectInput("path").value } };
+}
+
+function projectEditorHasChanges() {
+  return Boolean(projectEditor && JSON.stringify(projectEditorValues()) !== projectEditor.discardBase);
+}
+
+function renderProjectEditorControls() {
+  const busy = state.authExpired || projectEditor?.saving;
+  projectInput("editor").setAttribute("aria-busy", String(Boolean(projectEditor?.saving || projectEditor?.checking)));
+  projectInput("new").disabled = Boolean(busy
+    || !(state.projects?.actions?.register || state.projects?.actions?.createDirectory));
+  for (const button of document.querySelectorAll("[data-project-add]")) button.disabled = projectInput("new").disabled;
+  for (const field of projectInput("editor").querySelectorAll("input, button")) field.disabled = Boolean(busy);
+  if (!projectEditor) {
+    projectInput("submit").disabled = true;
+    return;
+  }
+  const registering = projectEditor.mode === "register";
+  projectInput("path").required = registering;
+  projectInput("path-label").textContent = registering ? "绝对路径" : "绝对路径（可留空）";
+  projectInput("path-help").textContent = registering
+    ? "登记一个已存在的目录作为 Project。"
+    : "留空时在实例项目根目录下按 Alias 创建空目录；自定义路径也须位于该根目录内。";
+  for (const button of document.querySelectorAll("[data-project-mode]")) {
+    button.setAttribute("aria-pressed", String(button.dataset.projectMode === projectEditor.mode));
+    button.disabled = Boolean(busy || projectEditor.attempted);
+  }
+  projectInput("submit").textContent = projectEditor.saving
+    ? registering ? "正在登记…" : "正在创建…" : registering ? "登记 Project" : "创建并登记";
+  projectInput("submit").disabled = Boolean(busy || projectEditor.attempted || !projectEditor.actions[projectEditor.mode]);
+  projectInput("check").disabled = Boolean(busy || projectEditor.checking);
+}
+
+function openProjectEditor() {
+  if (state.authExpired || projectEditor?.saving
+      || !(state.projects?.actions?.register || state.projects?.actions?.createDirectory)) return;
+  if (projectEditor && !closeProjectEditor()) return;
+  projectEditor = { mode: "register", paths: { register: "", createDirectory: "" },
+    actions: { ...state.projects.actions }, returnFocus: document.activeElement, saving: false, attempted: false };
+  projectInput("alias").value = "";
+  projectInput("path").value = "";
+  projectInput("note").textContent = "";
+  projectInput("note").classList.toggle("error", false);
+  projectInput("check").hidden = true;
+  projectInput("check").textContent = "刷新列表核对";
+  projectEditor.discardBase = JSON.stringify(projectEditorValues());
+  projectInput("editor").hidden = false;
+  renderProjectEditorControls();
+  projectInput("drawer").showModal();
+  document.body.classList.toggle("workspace-drawer-open", true);
+  projectInput("drawer").querySelector(".drawer-body").scrollTop = 0;
+  projectInput("alias").focus();
+}
+
+function closeProjectEditor({ saved = false, confirmed = false } = {}) {
+  if (!projectEditor) return true;
+  if (projectEditor.saving) return false;
+  if (!saved && !confirmed && !confirmDiscardChanges(projectEditorHasChanges())) return false;
+  const returnFocus = projectEditor.returnFocus;
+  projectEditor = null;
+  projectInput("editor").hidden = true;
+  projectInput("drawer").close();
+  document.body.classList.toggle("workspace-drawer-open", false);
+  renderProjectEditorControls();
+  (returnFocus?.isConnected === false ? projectInput("new") : returnFocus)?.focus();
+  return true;
+}
+
+function selectProjectMode(mode) {
+  if (!projectEditor || projectEditor.saving || projectEditor.attempted || state.authExpired) return;
+  projectEditor.paths[projectEditor.mode] = projectInput("path").value;
+  projectEditor.mode = mode;
+  projectInput("path").value = projectEditor.paths[mode];
+  renderProjectEditorControls();
+}
+
+async function checkProjectResult() {
+  const editor = projectEditor;
+  if (!editor || editor.saving || editor.checking || state.authExpired) return;
+  editor.checking = true;
+  renderProjectEditorControls();
+  try {
+    const refreshed = await loadProjects();
+    if (projectEditor !== editor || state.authExpired) return;
+    if (refreshed !== false && editor.attempted && !editor.uncertain) {
+      editor.actions = { ...state.projects.actions };
+      editor.attempted = false;
+      projectInput("check").hidden = true;
+      projectInput("note").classList.toggle("error", false);
+      projectInput("note").textContent = "已刷新，当前输入已保留。可修改后重新提交。";
+    } else {
+      projectInput("note").textContent = refreshed === false
+        ? "列表未更新，请再次刷新核对。"
+        : "已刷新 Projects 列表；请关闭表单核对 Alias 与路径。未重复提交操作。";
+    }
+  } catch (error) {
+    if (projectEditor === editor && !state.authExpired) projectInput("note").textContent = `列表读取失败：${error.message}`;
+  } finally {
+    editor.checking = false;
+    if (projectEditor === editor) renderProjectEditorControls();
+  }
+}
+
+async function saveProject(event) {
+  event.preventDefault();
+  const editor = projectEditor;
+  if (!editor || editor.saving || editor.attempted || state.authExpired || !editor.actions[editor.mode]) return;
+  if (!projectInput("editor").reportValidity()) return;
+  const envelope = editor.actions[editor.mode];
+  editor.actions[editor.mode] = null;
+  if (state.projects?.actions) state.projects.actions[editor.mode] = null;
+  editor.saving = true;
+  editor.attempted = true;
+  projectInput("note").textContent = editor.mode === "register" ? "正在登记 Project…" : "正在创建 Project…";
+  renderProjectEditorControls();
+  let result;
+  try {
+    result = await api(editor.mode === "register" ? "/api/v1/projects/register" : "/api/v1/projects/create-directory", {
+      method: "POST", headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(actionPayload(envelope, { alias: projectInput("alias").value,
+        path: projectInput("path").value || null })),
+    });
+  } catch (error) {
+    if (state.authExpired) return;
+    editor.uncertain = !error.status || error.status >= 500;
+    projectInput("note").textContent = !editor.uncertain
+      ? `${error.message} 输入已保留，请刷新后修改并重新提交。`
+      : "操作结果未确认，请刷新 Projects 列表核对；不要重复提交。";
+    projectInput("note").classList.toggle("error", true);
+    projectInput("check").hidden = false;
+    projectInput("check").textContent = editor.uncertain ? "刷新列表核对" : "刷新后继续填写";
+    setStatus(projectInput("note").textContent, true);
+    return;
+  } finally {
+    editor.saving = false;
+    renderProjectEditorControls();
+  }
+  const alias = projectInput("alias").value;
+  closeProjectEditor({ saved: true });
+  const message = `Project「${result?.alias || alias}」已${editor.mode === "register" ? "登记" : "创建并登记"}。`
+    + (result?.cwd ? `目录：${result.cwd}` : "");
+  try {
+    const refreshed = await loadProjects();
+    if (!state.authExpired && state.tab === "projects") setStatus(
+      refreshed === false ? `${message} 列表未更新，请手动刷新。` : message);
+  } catch {
+    if (!state.authExpired && state.tab === "projects") setStatus(`${message} 列表刷新失败，请手动刷新查看。`, true);
+  }
+}
+
 function confirmMaterializedDelete(session) {
   const name = session.nativeTitle || "未命名 Session";
   return window.confirm(
@@ -574,6 +738,19 @@ async function loadProjects(cursor = undefined) {
     }
     body.append(row);
   }
+  if (!data.items.length) {
+    const row = document.createElement("tr");
+    const empty = document.createElement("td");
+    empty.colSpan = 6;
+    const message = document.createElement("p");
+    message.textContent = "本页没有 Project。可登记已有目录，或创建空目录。";
+    const add = actionButton("添加 Project", openProjectEditor);
+    add.setAttribute("data-project-add", "");
+    empty.append(message, add);
+    row.append(empty);
+    body.append(row);
+  }
+  renderProjectEditorControls();
   renderCursorPagination("projects", state.projectPage, data.items.length);
   return true;
 }
@@ -2388,12 +2565,13 @@ function renderDefaultSettings() {
   const model = renderSessionSettingsFields(defaultsInput, settings, editor.models, editor.contextAvailable);
   defaultsInput("context-field").hidden = editor.kind === "chat"
     && chatTarget("defaults").kind() === "p2p" && settings.message_context_mode === "current-only";
+  renderDefaultWorkspace();
   const notes = [editor.loading ? "正在读取配置…" : "", editor.sourceNote, editor.error, editor.catalogError];
   if (turn && !model) notes.push("已保存的模型当前不可用，选择保持不变；可显式选择其他模型。");
   if (editor.contextAvailable === false) notes.push("单聊不支持补齐未读上下文，请使用当前消息。");
   defaultsInput("note").textContent = notes.filter(Boolean).join(" ");
   defaultsInput("note").classList.toggle("error", Boolean(editor.error));
-  defaultsInput("save").disabled = defaultsBusy || editor.loading || !editor.action;
+  defaultsInput("save").disabled = defaultsBusy || editor.loading || !editor.action || !defaultWorkspaceAvailable();
   defaultsInput("save").textContent = defaultsBusy ? "保存中…" : "保存";
   defaultsInput("editor").setAttribute("aria-busy", String(defaultsBusy || editor.loading));
 }
@@ -2418,6 +2596,77 @@ function renderDefaultProject(project) {
   ])], project);
 }
 
+function defaultWorkspaceAvailable() {
+  const editor = defaultsEditor;
+  if (!editor || editor.workspace.mode === "project") return true;
+  const options = editor.workspaceOptions;
+  if (!options?.isGit || options.projectAlias !== defaultsInput("project").value) return false;
+  return editor.workspace.mode === "new"
+    || options.items.some((item) => item.id === editor.workspace.worktree_id);
+}
+
+function renderDefaultWorkspace() {
+  const editor = defaultsEditor;
+  const workspace = editor.workspace;
+  const options = editor.workspaceOptions;
+  const available = options?.isGit && options.projectAlias === defaultsInput("project").value;
+  defaultsInput("workspace").value = workspace.mode;
+  for (const option of defaultsInput("workspace").querySelectorAll("option")) {
+    option.disabled = option.value !== "project" && (!available || option.value === "existing" && !options.items.length);
+  }
+  defaultsInput("worktree-field").hidden = workspace.mode !== "existing";
+  defaultsInput("workspace-ref-field").hidden = workspace.mode !== "new";
+  scheduleSelectOptions(defaultsInput("worktree"), [["", "选择受管 Worktree"],
+    ...(available ? options.items : []).map((item) => [item.id, `${item.cwd} · ${item.branch || "detached"} · ${item.id}`])],
+  workspace.worktree_id || "");
+  defaultsInput("worktree").required = workspace.mode === "existing";
+  defaultsInput("workspace-ref").value = workspace.ref || "";
+  defaultsInput("workspace-refs").replaceChildren();
+  for (const branch of options?.branches || []) {
+    const option = document.createElement("option");
+    option.value = branch.ref;
+    option.textContent = branch.name;
+    defaultsInput("workspace-refs").append(option);
+  }
+  const notes = [];
+  if (editor.workspaceError) notes.push(editor.workspaceError);
+  else if (options?.isGit === false) notes.push("该 Project 不是 Git 仓库，只支持项目目录。");
+  else if (!defaultsInput("project").value) notes.push("先选择 Project，再选择工作区策略。");
+  if (workspace.mode === "existing") {
+    notes.push("新会话共享所选 Worktree 的文件和分支；删除或失效后保留此配置，自动创建会话时明确报错。");
+    if (!editor.loading && !defaultWorkspaceAvailable()) notes.push("所选 Worktree 当前不可用，请重新选择；不会切回项目目录。");
+  } else if (workspace.mode === "new") {
+    notes.push("每次自动创建新会话时创建一次 detached Worktree；后续消息复用。留空使用创建时 Project 的 HEAD，保存配置不创建目录。");
+    if (!editor.loading && !available) notes.push("当前无法使用新建 Worktree 策略，请检查 Project。");
+  } else notes.push("新会话使用 Project 的项目目录。");
+  defaultsInput("workspace-help").textContent = notes.join(" ");
+  defaultsInput("workspace-help").classList.toggle("error", !editor.loading && !defaultWorkspaceAvailable());
+}
+
+async function changeDefaultProject() {
+  const editor = defaultsEditor;
+  if (!editor || defaultsBusy) return;
+  editor.workspace = { mode: "project" };
+  editor.workspaceOptions = null;
+  editor.workspaceError = "";
+  await loadDefaultOptions();
+}
+
+function changeDefaultWorkspace(field) {
+  const editor = defaultsEditor;
+  if (!editor || editor.loading || defaultsBusy) return;
+  if (field === "workspace") {
+    const mode = defaultsInput("workspace").value;
+    editor.workspace = mode === "existing" ? { mode, worktree_id: "" } : { mode };
+  } else if (field === "worktree") {
+    editor.workspace = { mode: "existing", worktree_id: defaultsInput(field).value };
+  } else {
+    const ref = defaultsInput(field).value.trim();
+    editor.workspace = { mode: "new", ...(ref ? { ref } : {}) };
+  }
+  renderDefaultSettings();
+}
+
 async function loadDefaultOptions(resolveChat = false) {
   const editor = defaultsEditor;
   if (!editor) return;
@@ -2426,6 +2675,8 @@ async function loadDefaultOptions(resolveChat = false) {
   const chatId = editor.kind === "chat" ? defaultsInput("chat").value.trim() : "";
   editor.loading = true;
   editor.error = "";
+  editor.workspaceOptions = null;
+  editor.workspaceError = "";
   renderDefaultSettings();
   try {
     let view = null;
@@ -2437,10 +2688,12 @@ async function loadDefaultOptions(resolveChat = false) {
       const effective = view.exact || view.effective;
       if (effective) {
         editor.settings = structuredClone(effective.session_settings);
+        editor.workspace = structuredClone(effective.workspace);
         renderDefaultProject(effective.project);
         editor.touched = true;
       } else {
         editor.settings = defaultScheduleSessionSettings();
+        editor.workspace = { mode: "project" };
         renderDefaultProject("");
         editor.touched = false;
       }
@@ -2450,10 +2703,14 @@ async function loadDefaultOptions(resolveChat = false) {
     }
     const query = new URLSearchParams({ mode: "options" });
     if (chatId) query.set("chat_id", chatId);
+    const project = defaultsInput("project").value;
+    if (project) query.set("project", project);
     const data = await api(`/api/v1/defaults?${query}`);
     if (defaultsEditor !== editor || serial !== editor.serial) return;
     editor.models = data.models;
     editor.contextAvailable = data.context_mode_available;
+    editor.workspaceOptions = data.workspace_options || null;
+    editor.workspaceError = data.workspace_options_error || "";
     if (editor.kind === "chat") chatTarget("defaults").resolveKind(editor.contextAvailable);
     editor.catalogError = typeof data.model_catalog_error === "string"
       ? data.model_catalog_error : data.model_catalog_error?.message || "";
@@ -2480,6 +2737,7 @@ function openDefaultEditor(kind, record = null) {
     returnFocus: document.activeElement,
     settings: structuredClone(record?.session_settings || defaultScheduleSessionSettings()),
     models: [], serial: 0, loading: true, touched: false, contextAvailable: null,
+    workspace: structuredClone(record ? record.workspace : { mode: "project" }), workspaceOptions: null, workspaceError: "",
     sourceNote: record ? "修改已保存的配置，只影响之后创建的会话。" : "保存后，在没有当前会话的位置收到消息时生效。",
     error: "", catalogError: "", lockedTarget: Boolean(record) };
   defaultsInput("editor").hidden = false;
@@ -2524,7 +2782,7 @@ function defaultEditorValues() {
   if (!editor) return null;
   return { kind: editor.kind, project: defaultsInput("project").value,
     target: defaultsInput(editor.kind === "chat" ? "chat" : "keyword").value,
-    settings: sessionSettingsFingerprint(editor.settings) };
+    settings: sessionSettingsFingerprint(editor.settings), workspace: structuredClone(editor.workspace) };
 }
 
 function defaultEditorHasChanges() {
@@ -2575,7 +2833,7 @@ async function defaultMutation(mode, action, extra = {}) {
 async function saveDefault(event) {
   event.preventDefault();
   const editor = defaultsEditor;
-  if (!editor || editor.loading || !editor.action || defaultsBusy) return;
+  if (!editor || editor.loading || !editor.action || defaultsBusy || !defaultWorkspaceAvailable()) return;
   if (editor.kind === "chat") {
     editor.loading = true;
     renderDefaultSettings();
@@ -2588,7 +2846,10 @@ async function saveDefault(event) {
     if (defaultsEditor !== editor) return;
   }
   const definition = { kind: editor.kind, project: defaultsInput("project").value,
-    session_settings: structuredClone(editor.settings) };
+    session_settings: structuredClone(editor.settings), workspace: structuredClone(editor.workspace) };
+  if (editor.workspaceOptions?.projectAlias === definition.project) {
+    definition.expected_project_revision = editor.workspaceOptions.projectRevision;
+  }
   if (editor.kind === "chat") definition.chat_id = defaultsInput("chat").value.trim();
   else definition.keyword = defaultsInput("keyword").value.trim();
   const action = editor.action;
@@ -2651,7 +2912,7 @@ function defaultChatCell(row, rule) {
   row.append(td);
 }
 
-function defaultSettingsCell(row, settings) {
+function defaultSettingsCell(row, settings, workspace) {
   const td = document.createElement("td");
   const model = settings.turn_settings;
   const title = document.createElement("div");
@@ -2659,7 +2920,11 @@ function defaultSettingsCell(row, settings) {
   const detail = document.createElement("div");
   detail.className = "default-settings-detail";
   detail.textContent = scheduleSessionSummary(settings).split(" · ").slice(1).join(" · ");
-  td.append(title, detail);
+  const location = document.createElement("div");
+  location.className = "default-settings-detail";
+  location.textContent = workspace.mode === "existing" ? `指定 Worktree：${workspace.worktree_id}`
+    : workspace.mode === "new" ? `每个新会话创建 Worktree · ${workspace.ref || "创建时 Project HEAD"}` : "项目目录";
+  td.append(title, detail, location);
   row.append(td);
 }
 
@@ -2686,7 +2951,7 @@ async function loadDefaults(offset = defaultsOffset, returnFocus = null) {
         cell(row, rule.keyword);
       } else defaultChatCell(row, rule);
       cell(row, rule.project);
-      defaultSettingsCell(row, rule.session_settings);
+      defaultSettingsCell(row, rule.session_settings, rule.workspace);
       const actions = document.createElement("td");
       const buttons = document.createElement("div");
       buttons.className = "actions";
@@ -2740,7 +3005,7 @@ function confirmDiscardChanges(changed) {
 }
 
 function hasUnsavedEditors() {
-  return sessionSettingsHasChanges() || defaultEditorHasChanges() || scheduleEditorHasChanges()
+  return projectEditorHasChanges() || sessionSettingsHasChanges() || defaultEditorHasChanges() || scheduleEditorHasChanges()
     || Boolean(pendingScheduleDraft?.dirty) || Boolean(window.NetizenSessionAccess?.dirty())
     || Boolean(window.NetizenWorktrees?.dirty());
 }
@@ -2748,9 +3013,10 @@ function hasUnsavedEditors() {
 // Navigation asks once before closing any editor. Busy submissions retain the
 // existing fail-closed boundary; this helper never cancels or repeats a POST.
 function confirmDiscardEditors() {
-  if (sessionSettingsEditor?.saving || defaultsBusy || (scheduleEditor && scheduleInput("fields").disabled)
+  if (projectEditor?.saving || sessionSettingsEditor?.saving || defaultsBusy || (scheduleEditor && scheduleInput("fields").disabled)
       || window.NetizenSessionAccess?.busy() || window.NetizenWorktrees?.busy()) return false;
   if (!confirmDiscardChanges(hasUnsavedEditors())) return false;
+  closeProjectEditor({ confirmed: true });
   closeSessionSettingsEditor({ confirmed: true });
   closeDefaultEditor({ confirmed: true });
   if (scheduleEditor) closeScheduleEditor({ confirmed: true });
@@ -4089,6 +4355,20 @@ function selectSessionTab(name) {
   return refresh("sessions");
 }
 
+function selectSystemTab(name) {
+  if (state.authExpired || state.systemTab === name) return;
+  window.NetizenSelect?.close();
+  if (state.systemTab === "admins") window.NetizenIdentity?.suspendSelector();
+  else window.NetizenSessionAccess?.closePickers();
+  state.systemTab = name;
+  for (const button of document.querySelectorAll("[data-system-tab]")) {
+    const selected = button.dataset.systemTab === name;
+    button.setAttribute("aria-selected", String(selected));
+    button.setAttribute("tabindex", selected ? "0" : "-1");
+    document.querySelector(`#system-${button.dataset.systemTab}`).hidden = !selected;
+  }
+}
+
 function selectTab(name, sessionTab = state.sessionTab || "ordinary", { preserveEditors = false, replace = false } = {}) {
   if (state.authExpired) return;
   if (!preserveEditors && !confirmDiscardEditors()) return;
@@ -4141,6 +4421,18 @@ for (const tab of document.querySelectorAll("[data-session-tab]")) {
   });
 }
 
+for (const tab of document.querySelectorAll("[data-system-tab]")) {
+  tab.addEventListener("click", () => selectSystemTab(tab.dataset.systemTab));
+  tab.addEventListener("keydown", (event) => {
+    if (!["ArrowLeft", "ArrowRight", "Home", "End"].includes(event.key)) return;
+    event.preventDefault();
+    const name = event.key === "Home" ? "admins" : event.key === "End" ? "access"
+      : tab.dataset.systemTab === "admins" ? "access" : "admins";
+    selectSystemTab(name);
+    document.querySelector(`#system-tab-${name}`).focus();
+  });
+}
+
 for (const button of document.querySelectorAll("[data-refresh]")) {
   button.addEventListener("click", () => refresh(button.dataset.refresh));
 }
@@ -4149,21 +4441,18 @@ for (const button of document.querySelectorAll("[data-session-sort]")) {
   button.addEventListener("click", () => sortSessionPage(button.dataset.sessionSort, button.dataset.sortBy));
 }
 
-document.querySelector("#register-project").addEventListener("submit", async (event) => {
+projectInput("new").addEventListener("click", openProjectEditor);
+projectInput("cancel").addEventListener("click", closeProjectEditor);
+projectInput("close").addEventListener("click", closeProjectEditor);
+projectInput("drawer").addEventListener("cancel", (event) => {
   event.preventDefault();
-  const formElement = event.currentTarget;
-  const form = new FormData(formElement);
-  await mutate("/api/v1/projects/register", state.projects.actions.register, { alias: form.get("alias"), path: form.get("path") });
-  formElement.reset();
-});
-
-document.querySelector("#create-project").addEventListener("submit", async (event) => {
-  event.preventDefault();
-  const formElement = event.currentTarget;
-  const form = new FormData(formElement);
-  await mutate("/api/v1/projects/create-directory", state.projects.actions.createDirectory, { alias: form.get("alias"), path: form.get("path") || null });
-  formElement.reset();
+  closeProjectEditor();
 });
+projectInput("editor").addEventListener("submit", saveProject);
+projectInput("check").addEventListener("click", checkProjectResult);
+for (const button of document.querySelectorAll("[data-project-mode]")) {
+  button.addEventListener("click", () => selectProjectMode(button.dataset.projectMode));
+}
 
 document.querySelector("#session-inventory-state").addEventListener("change", updateSessionDateFilters);
 document.querySelector("#session-filter").addEventListener("submit", (event) => {
@@ -4217,6 +4506,11 @@ defaultsInput("drawer").addEventListener("cancel", (event) => {
 });
 defaultsInput("editor").addEventListener("submit", saveDefault);
 defaultsInput("chat").addEventListener("change", () => changeDefaultChat());
+defaultsInput("project").addEventListener("change", changeDefaultProject);
+for (const field of ["workspace", "worktree"]) {
+  defaultsInput(field).addEventListener("change", () => changeDefaultWorkspace(field));
+}
+defaultsInput("workspace-ref").addEventListener("input", () => changeDefaultWorkspace("workspace-ref"));
 for (const field of ["model", "effort", "tier", "context", "reactions", "progress", "completion-mention"]) {
   defaultsInput(field).addEventListener("change", () => changeDefaultSettings(field));
 }