Team Notes Guide
Long-term discussion and weekly scheduling
Open Long-term discussion under Ideas & discussions. Idea Pool captures early thoughts, long-term discussion keeps ongoing questions, and Weekly discussion schedules focused work for a particular week.
- Select Add a long-term topic. Create a discussion document with a title, overview and question, or link an existing note, PDF or presentation.
- New documents are shared and Unfiled; no long-term folder is created. Existing documents are linked without copies. Titles follow the original document.
- Expand a title and open its source to continue the conversation in comments. Use In progress, Paused or Resolved; the default list shows In progress. The submitter or an administrator maintains topic metadata. Source editing still follows the document author’s permissions.
- Click Add to this week to schedule the original document, overview and question in one step. The long-term topic stays in place with its current status. Already-scheduled sources are not duplicated or overwritten.
- In this week · View opens the current agenda. Schedule the topic again in a later week; each week keeps its own introduction and status.
- Removing a long-term reference preserves the source, comments and weekly entries. Linking a private document does not expand its access.
Example: create “How can we improve experiment reproducibility?”, add the open question, and bring it into this week for a meeting. Record conclusions in the original document and schedule another round next week without copying the document.
Quick scheduling and collapsible topics
Each document in Team documents and its reading toolbar has Add to this week. It opens the current Beijing-time week with the original document and description preselected; confirm to save. The title stays linked to the source document, without copied content or new folders.
Topics show only their titles initially. Click a title row or chevron to expand its description, question, source link and controls; click again to collapse. The + button left of the topic count opens the same scheduling dialog as Schedule a discussion.
Schedule a discussion from team files
Open Weekly discussion → Schedule a discussion → choose Choose from team documents as the source. Search by title or author, filter by folder or format, and select a Markdown, PDF or presentation document. Add an introduction and question, then save. The document becomes an agenda topic with discussion status and a permanent weekly entry.
For local files, use Upload materials first, then select the resulting team document. The original is linked, with no duplicate or weekly folder. Only readable sources are listed and their permissions remain intact. Idea Pool and new-idea options are still available.
Weekly records and discussion materials
Weekly discussion keeps the week name, notes, conclusions and linked materials, using Monday–Sunday in Beijing time. Give a week a name such as “Week 1 · Research directions”. Saved weeks appear in Weekly records; return later to add more materials.
- Open Weekly discussion and choose the week.
- Select Edit weekly information, enter the name and notes, and save. Signed-in members can read these notes; their creator or an administrator maintains them.
- Under Discussion materials, use Link existing documents to search and select notes, PDFs or presentations. Up to 30 per operation and 100 per week.
- Use Upload materials for local Markdown and images, ZIP, PDF or PPT/PPTX. Preview and publish as usual; published documents link to the selected week automatically. Presentations are read as converted PDFs.
- Use an existing document folder or leave materials Unfiled. No weekly folders are created and existing documents are not copied. Original documents remain available through Team documents.
- Return to any historical week to add more. One document can be linked to multiple weeks; all links open the same current original, not a frozen copy.
- Unlink removes only that week’s reference. It preserves the original and other weeks. Only the submitter or an administrator can unlink. Original access permissions still apply; private documents remain author-only.
Example: name 2026-10-12–2026-10-18 “Week 1 · Research directions”, upload meeting.pdf, and link the existing Experiment Plan. Create another record next week and revisit Week 1 from Weekly records whenever needed.
History and restoration
- Document content: open a document, choose History from the page actions menu, inspect or compare an older version, then select Restore and confirm. Current editing permission is required. Restoration creates a new version and preserves existing history.
- Week name and notes: after saving a change, open History in the weekly record, expand a version and choose Restore this version. Only the record creator or an administrator can restore. The latest 30 old versions are kept, including the content replaced by a restoration.
- Material references: link a document again if a reference was removed by mistake. The original remains intact.
- Folders, classification, status, visibility and deleted files: restoring document content does not undo these operations. Move documents back using Organize; recreate a deleted folder if needed. Ask an administrator about server backups for deleted documents or a site-wide recovery.
Simpler navigation and your documents
The homepage keeps its folders and document list. The sidebar contains Team documents, Ideas & discussions, and Guide. Home links on other pages and the Team Notes logo still return here.
Use All documents / Created by me above the list to filter by the original author. Combine it with folders, tags, progress and visibility. Created by me does not mean private; visibility still controls who can read. Clear filters restores all documents. Old My Pages links open this filter; old Project view links open Team documents.
Example: choose Research → Created by me → Draft to see your unfinished research notes.
AI setup, a movable button and co-editing
- No API key configured means the enable switch may already be on, but no key has been saved. Administrators can open AI assistant → Configure API (or the gear icon), enter a DeepSeek key, enable chat and save. Reopen settings to send a connection test.
- Keys can only be entered over HTTPS or an administrator-provided local SSH tunnel. Plain HTTP disables the key field. Keys stay on the server and are never shown to members.
- Drag the floating AI button anywhere inside the screen; its position is remembered on this device. The chat panel always opens on the right. Use “Reset button position” at the bottom of the panel, or Alt + arrow keys / Alt + Home while the button is focused.
- Authors can select Editing: Only me / Co-editing on reading and editing pages, choose an editing mode and save. The team document list’s Organize action opens the same settings.
- Co-editing permits signed-in readers to edit content, title, description and tags. Only the author controls visibility and editing permissions. Private documents cannot be co-edited.
Getting started
Open the team homepage and sign in with your existing Wiki account. Select EN at the top right for the English interface. Use 中文 / English above to switch this guide.
The original Wiki homepage and existing document URLs remain available. Published pages follow the site's existing access permissions. “My Pages” means content you created; it does not mean private content.
What the sections mean
| Section | Purpose |
|---|---|
| Home | Recently updated documents you can read |
| Team documents | Notes, ideas and attachments organized in folders |
| Project view | Filter documents in project folders |
| My Pages | Documents you originally created |
| Idea Pool | Share observations, questions and ideas, then discuss them on their pages |
| + New | Create a note or idea, or import files into the current folder |
These are overlapping views of the same collection. A project note you upload can appear in Knowledge Base, Projects and My Pages. Lists support pagination, with 40 readable documents per page.
Interface language and document language
Interface language changes buttons and menus. Chinese and English resources are installed; no download is needed. This does not translate the document.
Content language refers to an actual Chinese or English version supplied by an author. Select Content: 中文 / English in the reading controls to open that version. If only one version exists, the page says so. Members with the required permissions can select Add English or Add Chinese.
The team list groups both versions into one document card, preferring the version matching your interface language. Chinese and English links on each card open the versions directly. Each version has its own text, history and comments. Editing one does not update the other automatically.
Importing notes
Import one language
- Open Team documents, choose a folder and select + New → Import documents. Choose Chinese only or English only under Document language.
- Select Markdown files. For notes with images, select the complete folder or upload a ZIP.
- Check the preselected folder, progress, visibility and co-editing.
- Select Preview import and check titles, target URLs and missing-file warnings.
- Confirm the preview, select Publish this batch, then open a published note.
Use relative image and note paths:
# Experiment Log
[Next steps](plan.md)
Links to images and notes included in the same batch are converted to site URLs.
Upload Chinese and English together
- Prepare Chinese and English Markdown files.
- Put both in the same directory and use matching base names with language suffixes, such as
experiment.zh.mdandexperiment.en.md. Document titles may differ. - Choose Chinese + English pairs and select both files and their images, or upload the complete folder / ZIP.
- Check the preview, which lists a title and URL for each language, and publish.
- Open the document and use Content: 中文 / English to switch.
Download a ready-to-import bilingual example ZIP.
experiment-notes/
experiment.zh.md
experiment.en.md
images/
curve.png
Example Chinese file:
# 学习率实验
降低学习率后，训练更加稳定。
行内公式：$a=bc$。
$$
E = \frac{1}{n}\sum_{i=1}^{n}(y_i-\hat y_i)^2
$$
Example English file:
# Learning Rate Experiment
Training becomes more stable after reducing the learning rate.
Inline formula: $a=bc$.
$$
E = \frac{1}{n}\sum_{i=1}^{n}(y_i-\hat y_i)^2
$$
Each pair becomes two language versions of one document. Every document in paired mode must include both files.
Add English to an existing Chinese document
- Open the Chinese document.
- Expand the reading controls and select Add English beside the content language.
- Confirm that the import page identifies the correct source.
- Upload exactly one English
.mdfile and its images. Its filename need not match the original. - Preview and publish. The Chinese text is preserved, and both pages gain language links.
If English already exists, open that page and edit it. A new ordinary import creates a new document; it does not update an existing version. You can also add Chinese to an English document using the same steps.
Preparing a translation
No automatic translation service is connected. The site does not automatically translate Chinese content into English. Prepare English Markdown using your preferred translation tool, then upload a pair or add a version.
Keep Markdown structure, code blocks, formulas, image paths and links intact. Translate the relevant prose and check terminology and formulas before publishing. Later changes to the source need to be reflected in the translation manually.
Reading, editing and finding content
| Feature | How to use it |
|---|---|
| Collapse the left sidebar | Select Menu |
| Collapse page details | Select Details to give the document more room |
| Hide the control bar | Select < to leave only >; select > to expand it |
| Return to the list | Select Back to list to restore the previous section and search where possible |
| Find a note | Search titles, summaries, authors, tags and both language titles on Home; use the original Wiki search for full text |
| Edit text | Open the language version you want, select Edit and save the Markdown |
| Add images | Upload and insert images using the editor's asset manager |
| View history | Open History from the page actions to compare or restore versions, subject to permissions |
Sidebar, details and control-bar preferences are saved in the current browser. On phones, the reading controls appear at the bottom.
Markdown and mathematical formulas
Documents and comments support Markdown, including bold, italics, lists, links and code.
Write an inline formula as $a=bc$. It renders as .
Write a display formula like this:
$$
\dfrac{(QK)^T QK}{\sqrt{d_k}}
$$
Rendered result:
Formulas inside backticks or fenced code blocks remain literal code. Escape a dollar sign as \$. Invalid formulas in comments remain visible as source text so you can correct them.
Use $formula$ inside table cells too. Braces in roots, fractions and powers are preserved:
| Source | Rendered result |
|---|---|
$\sqrt{65}$ |
|
$\dfrac{-3+i}{10}$ |
|
$2^{1013}$ |
Keep formulas on one line inside a Markdown table. Prefer \lvert x\rvert and \mid for absolute values or conditional probability; a literal | may be interpreted as a column separator.
Idea Pool and discussions
- Select Idea Pool or Share an Idea.
- Enter a short title, text and optional tags. For example: “Does low-rank initialization affect early learning?”
- Describe the observation, hypothesis and a way to test it. Link to existing notes if useful.
- Publish, open the page and discuss it in the comments.
When an idea matures, create a formal note and link to it from the original idea. Automatic conversion to notes, likes, bookmarks, status boards, @mentions and email notifications are not currently provided.
This Week: prepare topics before the meeting
Open This Week. Idea Pool keeps your long-term ideas; This Week organizes the discussion agenda by week. Weeks run Monday through Sunday in Beijing time.
- Select This Week in the sidebar. It opens the current week; choose Next week to prepare ahead, or select a date to browse another week.
- Select Schedule an idea, then choose an existing idea or create a new one. Idea Pool cards also have a Schedule for this week button.
- Add a brief introduction (required, up to 1200 characters) and an optional discussion question (up to 600 characters), then save. Markdown and formulas are supported.
- Members can read the introduction in advance, then select Open idea / Discuss to read the full page and comment there. The reading menu's return button takes you back to the same week.
- After the discussion, the submitter or an administrator with the required permissions can mark the entry Discussed. Filter by status, edit the weekly introduction, or remove the entry from that week.
Example: title “Does low-rank initialization affect early learning?”; introduction “We observed different convergence speeds in the first three epochs and plan to compare three random seeds”; question “Should we check initialization scale first or increase the sample size?” Schedule it for next week so everyone can prepare.
New ideas are also saved in Idea Pool. Each idea can appear once per week and can be scheduled for multiple weeks. Past agendas remain available through Previous week or the date picker. Removing an agenda entry preserves the original idea and its comments. Weekly introductions are saved independently and do not edit the source page. You can switch the interface between Chinese and English; entered text is not automatically translated.
Import limits and common questions
- Supported formats: UTF-8
.md, PDF, PPT/PPTX, PNG, JPG, JPEG, GIF, WebP and ZIP. A batch accepts up to 30 documents (including at most 3 PDFs/presentations) and 100 supported files in total. - Each Markdown/image file can be up to 5 MiB; PDF/presentation files can be up to 20 MiB. Total upload size and total extracted ZIP size are limited to 20 MiB.
- Images and links are resolved relative to each Markdown file first. Local image paths such as
D:\notes\images\plot.pngandfile:///C:/notes/image.pngare matched against images in the same upload and rewritten as site URLs. Folder or ZIP uploads preserve directories; individually selected images also work when filenames are unique. The website cannot read your computer's paths: include the actual image files. - For duplicate filenames, the importer compares the trailing directories and refuses ambiguous matches. The preview shows how many image addresses were rewritten. Fix missing or ambiguous images and run the preview again. HTML
<img>images still need to be converted to Markdown image syntax. - Formulas, code and tables are preserved. External images keep their original links and are not downloaded.
- Each new batch creates new documents. Adding a translation creates only that language version and never overwrites an existing translation.
- Retry a partially failed batch without duplicating successful pages. This browser remembers the latest ordinary batch and the translation batch for each source.
- Each user can retain up to 50 preview jobs. Ask an administrator to archive completed jobs if you reach the limit.
- Missing upload or edit permissions: ask an administrator to check your group and page/asset permissions for the target language.
- Comments are rate-limited. Wait about 15 seconds before another consecutive submission.
- Forgotten password: contact an administrator. Outgoing email is not configured, and the original password cannot be displayed.
- Site address: http://wiki.wikijs.cn/. Use HTTP for now; HTTPS has not been restored.
Version and maintenance
Collaboration extension v1.8.0, based on Wiki.js 2.5.308. Supports weekly agendas and bilingual documents, local image path conversion, and fixes trailing TeX groups being mistaken for styling attributes in tables and paragraphs.
Download the extension source and build files · Wiki.js source. Licensed under AGPL-v3.
Folders, progress and Only me (new in 1.5)
The homepage uses a folder tree and paged documents, with card, list and compact views. Choose New folder to create a topic such as “Mathematical Methods”; use the ⋯ → Rename menu to rename it. Folders are shared by the team. Renaming or moving a document does not change its URL. Tags remain available for cross-topic filtering.
Drag your own document cards into a folder, or use Organization & permissions or the reading-page toolbar. Chinese and English versions share folder, progress, visibility and co-editing settings. Authors control visibility and co-editing; site administrators may organize the folder and progress of any shared document. Ordinary members organize only their own documents.
- Draft means work is in progress. New imports default to Draft. Drafts are still shared unless you select Only me.
- Completed is a manual progress label; the content remains editable.
- Not marked is the initial state of existing documents.
- Shared retains the site's existing reading permissions, which may include guests.
- Only me restricts the page, search, history, comments and local attachments to the signed-in owner. Other website accounts, including administrators in normal document workflows, cannot read it. Server operators can still access databases and backups. Downloaded copies and external images cannot be recalled.
Example: create “Mathematical Methods” → import a Markdown assignment and its images → choose that folder, Draft and Only me → preview and publish. When ready, use Organize to change it to Completed and Shared.
Local attachments used by a hidden document, including historical versions, are protected too. If another shared page uses the same attachment, other users will lose access to that attachment as well. Sharing the document again restores access unless another hidden document still protects the asset.
Combine folder, progress, visibility, tag and keyword filters. Empty folders remain available. Folders support up to five levels. Organization preserves original Wiki paths and content.
Site organization and author-controlled co-editing (new in 1.7)
The founding account yjj2027mcsp@sjtu.edu.cn is the site administrator. Other personal accounts and new registrations are Team Members. Members can create folders; only the site administrator can rename or delete shared folders.
- The administrator can drag shared documents into folders or change their progress using Organize: folder / progress.
- Authors open Organization & permissions, select Allow team members to co-edit the content, and save.
- Signed-in members who can read the shared document may edit its content, title, description and tags. They cannot move or delete it, or change its personal settings.
- Turning co-editing off immediately removes editing permission, including for already-open editors. The site administrator also needs the author's co-editing permission to edit someone else's content.
Existing and new documents default to co-editing off. Only me overrides co-editing and prevents website administrators from reading or organizing the document. Draft and Completed labels do not enable co-editing.
Instant rendering editor (new in 1.7)
Choose Edit Page on the original reading page, then click the small icon next to Save in the editor toolbar. Switch between instant rendering and the original split view on the same page. Both modes share the title, Save, Page settings and Close controls, and retain unsaved content when switching. Newly created Markdown pages are supported too.
Hover over a formatting button, or focus it with Tab, to see its name and keyboard shortcut below the button. Descriptions stay within the screen edges on small displays.
- Type
## Weekly researchand move the cursor to render a heading. Click it to continue editing its Markdown. - Use
$E=mc^2$or$$\int_0^1 x^2\,dx=\frac13$$for live formulas. Tables support inline formulas too. - Insert tables, links, code blocks or task lists from the toolbar. Click the small toolbar icon again to return to the original split editor.
- Choose the original Save button above or press
Ctrl+S(⌘+Son Mac). Changes update the same Wiki document and retain history, organization settings and original ownership. - Unsaved changes are stored locally per account and document. Restore or discard them on returning. Clear site data after using a shared computer.
- If another person saves first, the site reports a conflict and refuses to overwrite. Switch to the split editor and copy your Markdown draft, reload the latest version, merge your changes and save.
Example: the author enables co-editing for “Weekly research” → a member opens instant rendering → adds findings and formulas → saves → the reading page and history update. This supports successive edits, without simultaneous shared cursors. Instant preview and published pages use different Markdown engines; verify unusual HTML or extension syntax on the reading page after saving.
PDF and presentations
Choose .pdf, .ppt or .pptx in Import Documents, directly or in a ZIP with Markdown and images. PDFs are checked and previewed; presentations are converted to PDF and the original is retained for download. Each file becomes a Wiki document with folders, progress, visibility and comments.
- Select your files and document language.
- Choose a folder, progress and visibility.
- Select Preview import. Wait for conversion, then review the PDF with page navigation, zoom and download controls.
- Confirm and publish. Open the document to read the embedded PDF and use the existing discussion and organization controls.
Example: upload meeting.pptx under Research / Draft / Only me. After reviewing it, use Organize to change it to Shared. For two languages, upload meeting.zh.pptx and meeting.en.pptx together; PDF/presentation translations can also be added to an existing document.
Limits: at most 3 PDFs/presentations per batch, 20 MiB total after ZIP extraction, 5 MiB per Markdown/image, 500 PDF pages, 30 MiB per converted PDF and 60 MiB of output attachments per batch. Encrypted files are rejected. Failed conversion publishes no pages; retry or export PDF from PowerPoint first.
PDF is static: animations and media do not play. Unusual fonts or complex layouts may change, so review before publishing. Originals and PDFs follow document visibility. Site full-text search does not currently index PDF contents, and downloaded copies cannot be recalled.
Idea Pool and weekly agenda work together (1.5.1)
Any active signed-in personal account may schedule an idea they can read, including another member’s idea, without source editing permission. Use Schedule for this week in Idea Pool, or This Week → Schedule an idea → Choose from Idea Pool. Users with page creation permission may also write a new idea from the weekly agenda; it is saved in Idea Pool at the same time.
An agenda entry references its source. It does not move, copy or delete the source, or change its author, folder, progress or visibility. Private ideas do not become public when scheduled. The agenda submitter or an administrator can edit the agenda entry, change its discussion status or remove it from that week. The source idea and comments remain intact.
Knowledge Base, Projects and deleting folders (1.5.1)
Knowledge Base lists regular documents, including project materials. Projects is a focused view of those documents, not a separate copy. Regular documents filed in the Projects category, and documents imported to the Projects destination, appear there. Renaming the Projects category preserves this relationship. Creating an empty topic folder does not automatically add any documents to Projects.
Folders are shared across views, but their counts include only documents you can read within the current view. A Courses folder may contain notes in Knowledge Base and show zero in Projects. Try Clear filters or return to Knowledge Base if something appears missing. Each document has one underlying source.
Members with write permission can use the ⋯ → Delete folder menu and confirm Delete folder, keep documents. Every document in that shared folder, including other members’ documents, moves to Unfiled. Content, comments, author, progress and visibility remain unchanged. All documents and Unfiled are system views and cannot be deleted.
Folder tree, compact lists and batch organization (1.8)
Home, Knowledge Base, Projects and My Pages share the new browser. Existing categories remain top-level folders, with the same content, URLs and permissions.
- Select a folder and choose New subfolder. For example, create
PapersinsideDeep Learning. The folder menu offers new subfolders; administrators can rename, move or delete a subtree. Up to five levels are supported, with 40 characters per name. - Use the tree and breadcrumb to navigate. Include subfolders is enabled by default; turn it off to show direct documents only. Counts include subfolders and only documents readable in the current view.
- Switch between cards, lists and compact rows. Sort by title, author, creation or modification, and combine keyword, tag, format, progress and visibility filters. Each page displays 40 documents. Browser state is remembered per account and view.
- Select documents and choose Move selected, or drag the selection to a folder. Select this page selects only movable documents on this page. Up to 100 documents can move together.
- Administrators organize readable shared documents; members organize their own. Both language versions stay together. Batch moves preserve content, author, progress, visibility and co-editing. Permission or revision conflicts leave the entire batch unchanged. Refresh and retry.
Deleting a folder includes its subfolders and returns their documents to Unfiled without deleting content. Folder structure is shared; private documents remain author-only. Use the original Wiki search for full text.
AI assistant: chat, document references and quick copy (1.9)
Sign in and click AI assistant at the bottom right. It is available on Home, original reading pages and Edit Page. The administrator configures DeepSeek or another Chat Completions compatible API; members do not supply keys.
- Chat: type a question and choose Send or press Enter; Shift + Enter inserts a newline. Answers stream progressively and support Markdown, tables and math. Stop cancels generation. Incomplete answers are excluded from later conversation history.
- Attach a passage: select text in a reading page, the original Markdown editor or the instant editor, then choose Ask AI. Check the reference before sending your question. You can also use Attach selection. Attaching never sends content automatically; inspect, copy or remove it first.
- Attach a document: choose Attach document, then ask a question. The editor attaches its current unsaved text; reading pages attach authorized Markdown source. Limits are 48000 characters per document, 16000 per passage and 6000 per question. Select a smaller passage for long documents. For PDF/PPT, copy selectable text and paste it; entire attachments are not extracted automatically.
- Translate: select a Chinese passage and choose Translate to English. It attaches the passage and fills a translation request for you to review and send. Summaries and explanations work similarly. AI does not overwrite a page or create a language version; copy the answer and save it yourself.
- Copy/paste: copy selected source text from the floating menu. Each answer's Copy button copies its original Markdown. Use Ctrl / Cmd + V in the question box; the Paste button is available on secure pages, with keyboard fallback.
- Conversation: completed turns stay in the current browser tab per account, including across reloads or site navigation. Use + to clear the chat without changing documents. The server stores daily usage counts, not chat text. Switching accounts cannot send the previous account's conversation.
Example: select “training loss decreases but validation accuracy drops” → Ask AI → “Explain possible causes and suggest three follow-up experiments” → Send → copy the reply into your experiment notes.
Administrators use the gear in the sidebar to configure provider, HTTPS base URL, model and API key, then enable chat. DeepSeek defaults to https://api.deepseek.com and the current official model name deepseek-flash. Other providers require a compatible endpoint and their model name. The key stays on the server and is never returned to members or the browser. Set keys over HTTPS or an SSH local tunnel. An unconfigured API is clearly indicated.
Defaults are 100 requests per member/day (Beijing midnight), 10/minute, one active request per member and four globally. Administrators can set daily and reply token limits. Provider billing applies; failed or stopped requests also count once started. AI receives only the question, chat and explicitly attached references. It does not automatically scan the knowledge base, browse the internet or change documents.
Create in folders, paste images and navigate consistently (v1.10)
Knowledge Base is now Team documents, containing notes, ideas and attachments organized in folders. Import Documents has become an import dialog inside a folder. Idea Pool and Weekly discussion are grouped under Ideas & discussions. Project view filters the same team documents without creating copies.
- Open Team documents and choose a folder, for example
Research / Experiment logs. - Click + New above the list or + beside a folder. Choose New note, New idea or Import documents.
- Enter a title and choose progress, visibility, co-editing and content language. Create and edit saves an initial page and opens the original Edit Page editor. Select Only me for privacy; Draft alone does not hide a page.
- Paste a screenshot with Ctrl / Cmd + V or drop image files into either the split Markdown editor or the instant editor. The instant toolbar also has an upload icon. PNG, JPEG, GIF and WebP are supported, up to 5 MiB each, 10 images per upload and 20 MiB total. A permanent image URL is inserted after upload; save the document afterward. Failed uploads show a message so you can retry.
- Import documents opens the current folder’s dialog. Markdown with image folders, ZIP, bilingual pairs, PDF and PPT/PPTX converted to PDF remain supported. Select, preview and publish, then close the dialog to return to your folder.
- A new idea appears in both its folder and Idea Pool as one document. It can then be scheduled for weekly discussion.
- Reading pages show Team documents → folder → document title. Folder links return to the library; existing document URLs stay intact. Old import links open the new dialog.
Example: In Research / Experiment logs, create “How temperature affects the results”, select Draft, Shared and Allow team co-editing. Switch to instant rendering inside Edit Page, paste an experiment screenshot and save. Teammates can find the note in the folder and contribute after the author enables co-editing. Create an idea in the same folder for a hypothesis you want to discuss this week.
The AI launcher is higher to leave space for the page edit button. Administrators configure the provider through AI assistant → ⚙ Model settings. Enter the key through HTTPS or a local encrypted SSH tunnel, enable the assistant and save.
团队笔记使用指南
长期讨论与本周安排
左侧“点子与讨论”下新增 长期讨论。点子池适合先记下想法，长期讨论用于持续推进的问题，本周讨论用于这一周的集中安排。
例如：新建“如何提高实验可复现性”，记录当前疑问。需要开会讨论时点击“加入本周讨论”；会后在原文档补充结论，下周继续从长期讨论安排下一轮，不必复制一份新文档。
快速加入与折叠议题
团队文档的每篇文档旁，以及文档阅读页的控制栏，都有“加入本周讨论”。点击后自动进入当前北京时间所在周，带入原文档和简介；标题沿用原文档，确认保存即可。不会复制正文或新建文件夹。
本周讨论列表默认只显示标题，点击标题行或右侧箭头展开，再次点击收起。展开后可查看简介、问题和原文链接，并进行状态修改。Topics / 议题数量左侧的“＋”与上方“安排讨论”使用同一创建窗口。
从团队文件安排讨论
进入“本周讨论”→“安排讨论”→“讨论来源”选择 从团队文档选择。可以按标题、作者、文件夹和文件类型查找，选择 Markdown、PDF 或 PPT 文档，填写简介与讨论问题后保存。它会成为该周的议题，支持待讨论/已讨论状态及历周回看。
电脑里的文件可先用本页“上传资料”发布，再从团队文档选择。来源仍是同一份文档，不会复制，也不会创建每周文件夹。只显示你有权阅读的文档，安排不会扩大原权限。“从点子池选择”和“写一个新点子”仍然可用。
每周讨论记录与资料
“本周讨论”除了安排点子，还能保存每周名称、说明、讨论结论和相关资料。每周按北京时间周一至周日归档，跨年也不会混淆；可命名为“第1周 · 研究方向交流”。历周记录会自动列出已有内容的周，切换日期或点击记录即可回来补充。
例如：选择 2026-10-12 至 2026-10-18，命名为“第1周 · 研究方向交流”，上传
meeting.pdf，并关联已经存在的“实验计划”。下周添加新记录；以后从“历周记录”点击第1周，即可继续查看或补传资料。查看历史与恢复
精简导航与我的文档
团队首页保留文件夹与文档列表。左侧导航保留“团队文档”“点子与讨论”“使用指南”；其他页面的“团队首页”入口仍可返回这里。左上角“团队笔记”也可返回首页。
在团队文档列表上方，点击 全部文档 / 我创建的 切换范围。“我创建的”按原作者筛选，可以继续叠加文件夹、标签、进度和可见性条件；它不代表私有，文档能否被别人阅读仍取决于可见性设置。点击“清除筛选”恢复全部文档。旧“我的内容”链接会自动进入这个筛选，旧“项目视图”链接会回到团队文档。
例如：选择“研究”文件夹 → 点击“我创建的” → 选择“草稿”，即可查看自己在研究文件夹里尚未完成的笔记。
AI 配置、可拖动按钮与共享编辑
从哪里开始
打开团队首页，使用现有 Wiki 账号登录。英文用户可点击右上角 EN；本指南也可通过上方 中文 / English 切换。
原 Wiki 首页和已有文档地址继续可用。发布页面沿用站点现有的阅读权限；“我的内容”表示由你创建，不表示私密。
各个入口有什么区别
这些入口是同一批内容的不同筛选视图。例如，你上传的项目笔记会同时出现在知识库、项目空间和我的内容。列表支持分页，每页 40 篇可读文档。
界面语言与文档语言
界面语言控制按钮和菜单的中英文，资源已经安装，无需下载，不会翻译正文。
正文语言是作者实际上传的中文或英文版本。在阅读按钮中点击“正文：中文 / English”，即可打开对应版本。只有一个版本时会明确提示；有权限的成员会看到“上传英文版”或“上传中文版”。
团队列表把同一文档的两个版本放在一张卡片里，优先显示与你的界面语言一致的版本。卡片上的中文、English 链接可直接打开对应正文。两种版本分别保存正文、历史和评论，修改一方不会自动更新另一方。
快速导入文档
普通导入
Markdown 中的图片应使用相对路径：
同批上传的图片和笔记链接会自动转换为站内链接。
同时上传中英文版
experiment.zh.md和experiment.en.md。正文标题可以不同。下载可直接导入的中英文示例 ZIP。
中文文件示例：
英文文件示例：
系统将每对文件关联为同一文档的两个语言版本。配对模式中，每篇文档都必须同时提供两个文件。
给已有文档补充英文版
.md及其图片，文件名不必与原文件相同。已有英文版时，直接打开英文页面编辑。再次普通导入同名文件会创建新文档，不会更新旧版本。英文原文也可以按同样流程补充中文版。
如何准备译文
目前未接入自动翻译服务，站点不会自动把中文正文翻成英文。你可以使用自己认可的翻译工具准备英文 Markdown，再使用成对上传或补充版本流程。
翻译时保留 Markdown 结构、代码块、公式、图片地址和链接，只翻译需要翻译的文字；发布前核对术语和公式。原文后续修改时，也需要人工更新对应译文。
阅读、编辑和查找
<，只保留>；点击>重新展开导航栏、信息栏和控制菜单的展开状态保存在当前浏览器。手机上阅读按钮位于底部。
Markdown 和公式
文档及评论都支持 Markdown。粗体、斜体、列表、链接和代码可以直接使用。
行内公式写作
$a=bc$，显示结果：a=bc。独立公式的写法：
显示结果：
反引号或代码块内的公式保留原始代码，不渲染。普通美元符号写成
\$。评论公式语法有误时显示原始写法，方便修改。表格单元格内同样使用
$公式$。根号、分数和指数的大括号可以正常保留，例如：$\sqrt{65}$$\dfrac{-3+i}{10}$$2^{1013}$表格内的公式请写在同一行；绝对值、条件概率等公式建议使用
\lvert x\rvert、\mid，避免直接使用|与表格的分栏符号冲突。Idea Pool 与讨论
想法成熟后，可以创建正式笔记，并在想法正文添加链接。目前没有自动转笔记、点赞、收藏、状态看板、@提醒或邮件通知。
本周点子：提前准备每周讨论
打开本周点子。Idea Pool 保存长期想法；“本周点子”是按周整理的讨论清单。时间按北京时间周一至周日计算。
例子：标题“低秩初始化是否影响早期学习？”，介绍“我们观察到前三轮训练的收敛速度不同，准备对比三个随机种子”，讨论问题“先排查初始化尺度，还是先扩大样本量？”。可以先放到下周，让参会成员提前准备。
新建点子时会同时保存到 Idea Pool。一个点子每周只能安排一次，但可以安排到不同周；已过的周计划会保留，使用“上一周”或日期选择器查看。移出周计划不会删除原点子及评论。周计划介绍独立保存，不会自动改写原文；界面可中英文切换，输入的介绍不会自动翻译。
导入范围与常见问题
.md、PDF、PPT/PPTX、PNG、JPG、JPEG、GIF、WebP 和 ZIP。每批最多 30 篇文档（其中 PDF/PPT 最多 3 个），最多 100 个可导入文件。D:\笔记\images\图.png、file:///C:/notes/image.png等本地图片地址会与本批上传的图片自动匹配，并改写为网站地址。选择“文件夹”或 ZIP 可以保留目录；单独选择文件时，如果图片名称唯一，也可以自动匹配。网页不会读取你电脑上的路径，必须把图片一起上传。<img>图片目前仍需改用 Markdown 图片语法。版本与维护
协作扩展 v1.8.0，基于 Wiki.js 2.5.308。支持本周点子和双语文档，修复本地图片路径，以及表格和段落末尾公式大括号被误处理的问题。
下载扩展源码与构建文件 · Wiki.js 官方源码。沿用 AGPL-v3 许可。
文件夹、进度与仅自己可见（1.5 新增）
首页使用文件夹树与文档列表，支持列表、卡片和紧凑模式。点击文件夹浏览，点击“新建文件夹”创建主题，例如“数理方法”；文件夹旁的“⋯ → 重命名 / 移动”可调整名称与层级。文件夹供团队共用，重命名不会改变文档地址。标签仍可用于交叉检索。
把自己创建的文档卡片拖到目标文件夹，即可移动。也可点击卡片上的“整理与权限”，或者阅读页顶部的“整理”按钮。中英文版本共用文件夹、进度、可见性与共创设置。原作者控制可见性和共同编辑；网站管理员可整理所有共享文档的文件夹与进度。普通成员只能整理自己的文档。
例如：新建“数理方法”文件夹 → 导入作业 Markdown 和图片 → 选择“数理方法 / 草稿 / 仅自己可见” → 预检并发布。确认完成后，点击“整理”，改为“已完成 / 共享”，团队即可按原阅读权限查看。
隐藏文档使用过的站内附件（包括历史版本中的附件）也会被限制；如果另一篇共享文档使用了同一附件，其他人也将无法查看该附件。恢复共享后可恢复访问，除非它仍被另一篇隐藏文档使用。
可使用文件夹、进度、可见性、标签和关键词组合筛选。空文件夹也会保留，便于逐步整理。文件夹支持最多 5 层，每层名称不超过 40 字。整理分类不会移动原文档路径。
管理员整理与作者控制共创（1.7 新增）
建站账号
yjj2027mcsp@sjtu.edu.cn是网站管理员，其他个人账号和新注册账号为团队成员。成员可以建立文件夹；全站共用文件夹的改名、删除由网站管理员负责。已有文档和新文档默认关闭共创。仅自己可见时，共创不生效，管理员也不能在网站内读取或整理它。草稿与完成状态不会自动开启共创。
即时渲染编辑（1.7 新增）
在原版阅读页点击 Edit Page 进入编辑页，再点击顶部保存按钮旁的小图标，即可在同一页面切换即时渲染和原左右分栏。两种模式共用标题、保存、页面设置和关闭按钮，切换时会保留当前未保存内容。新建 Markdown 文档也可使用。
想了解格式按钮的作用时，将鼠标停在按钮上，或用 Tab 将焦点移到按钮上，即可在按钮下方查看名称和快捷键。小屏上的提示会自动避开屏幕边缘。
## 本周研究，移开光标后显示为标题；点击该段可继续修改 Markdown。$E=mc^2$或$$\int_0^1 x^2\,dx=\frac13$$，可即时查看公式；表格中也可以放行内公式。Ctrl+S（Mac 为⌘+S），正文写回同一篇 Wiki 文档，并保留历史版本、分类和原作者。例如：作者给“本周研究”开启共创 → 成员点击即时渲染编辑 → 补充实验结论与公式 → 保存 → 原页面与历史版本同步更新。共创是多人先后编辑，暂不提供多人同时输入的光标协作。即时预览与正式页面采用不同 Markdown 引擎，特殊 HTML 或扩展语法请保存后在阅读页确认。
PDF 与演示文稿
在“导入文档”中直接选择
.pdf、.ppt或.pptx，也可与 Markdown、图片一起放入 ZIP。PDF 直接检查并预览；PPT/PPTX 自动转换为 PDF，原文件保留下载。每个文件生成一篇可分类、可评论的 Wiki 文档。例如：上传
组会汇报.pptx，选择“研究 / 草稿 / 仅自己可见”，预检后发布。准备好后在“整理”中改为“共享”，成员就能在网页中翻页阅读并评论。中英配对可使用meeting.zh.pptx与meeting.en.pptx；已有文档也可以补充一个 PDF 或 PPT 语言版本。每批 PDF/PPT 最多 3 个，全部文件总计最多 20 MiB（ZIP 按解压后计）；Markdown/图片单文件仍为 5 MiB。PDF 最多 500 页，转换输出单个最多 30 MiB、整批附件最多 60 MiB。不支持加密文件。转换失败时不会发布页面，请按提示重试，或在 PowerPoint 中另存为 PDF 再上传。
PDF 阅读呈现静态内容，动画、音视频不会播放。特殊字体、复杂图表和排版可能变化，请在发布前检查。原文件与转换后的 PDF 都沿用文档的可见性保护；正文搜索当前不会检索 PDF 内部文字，已下载的副本不受后续隐藏设置影响。
点子池与本周讨论的双向使用（1.5.1）
登录后的有效个人账号，可以将自己或其他人可见的点子安排到本周讨论，无需拥有原文编辑权。在点子池点击“加入本周讨论”，或在“本周点子”点击“安排点子 → 从点子池选择”，效果相同。拥有新建文档权限时，也可从本周点子写新点子，它会同时出现在点子池。
周计划只是对原点子的引用，不会移动、复制或删除原文，也不会改变原文作者、文件夹、进度和可见性。私有点子不会因加入讨论而自动公开。周计划的提交人或管理员可以编辑安排、标记讨论状态及移出本周；移出后原点子和评论仍保留。
知识库与项目空间、删除文件夹（1.5.1）
知识库集中展示普通文档（包含项目资料）；项目空间是其中项目文档的快捷视图，不是另一份独立副本。归入“项目”分类的普通文档，以及导入时选择“项目空间”的文档，会出现在项目视图里。若重命名“项目”分类，这个归类关系会跟随。新建一个空主题文件夹不会自动把文档变成项目文档。
文件夹在全站共用，但文件夹旁的数量只统计当前页面范围中你能看到的文档。例如，同一个“课程”文件夹在知识库有笔记，在项目空间可能为零。看不到内容时，可先点击“清除筛选”，或回知识库查看。文档只有一份，修改正文会在所有相关视图中体现。
网站管理员可点击文件夹旁的 ⋯ → 删除文件夹，在确认窗口选择“删除文件夹，保留文档”。其中所有文档（包含其他成员的文档）会移至“待分类”，不会删除正文、评论，也不改变作者、草稿/完成状态或可见性。“全部文档”和“待分类”是系统视图，不能删除。文件夹是团队共用分类；删除前请留意确认提示。
文件夹树、紧凑列表与批量整理（1.8 新增）
首页、知识库、项目空间和我的内容共用新的文档浏览界面。左侧文件夹树按层级展开，右侧默认列表展示；可切换卡片或紧凑模式。旧分类保留为一级文件夹，已有正文、地址和权限不变。
Deep Learning中创建论文，再创建实验记录。文件夹旁的⋯可新建子文件夹；管理员还能重命名、移动或删除整个文件夹树。删除文件夹会同时移除其子文件夹，所有关联文档转到“待分类”，保留正文和个人设置。文件夹名称和层级是团队共用的；私有文档仍仅作者可读。全文搜索继续使用原 Wiki 顶部搜索框，文件类型以导入附件或原文编辑类型识别。
AI 助手：聊天、引用文档与快速复制（1.9 新增）
登录后点击右下角“AI 助手”。首页、原阅读页和 Edit Page 编辑页均可打开，原阅读和编辑方式保持。管理员统一配置 DeepSeek 或其他兼容 Chat Completions 的 API，成员无需填写密钥。
例如：选取“训练损失下降，但验证准确率降低”这一段 → 点击“问 AI” → 输入“帮我解释可能的原因，并列出三个后续实验” → 发送 → 复制回答 → 粘贴到实验记录中。
管理员在 AI 侧栏点击“⚙”，填写平台、HTTPS 基础地址、模型名和 API 密钥，启用后保存。DeepSeek 默认地址
https://api.deepseek.com，当前官方模型名deepseek-flash；其他服务需填写兼容接口和模型名。密钥只在服务器保存，不会返回给成员或浏览器。输入密钥需使用 HTTPS 或 SSH 本地隧道；尚未配置时会明确提示。默认每人每天 100 次（北京时间重置）、每分钟最多 10 次，每人同时生成 1 条，全站同时最多 4 条。管理员可修改每日额度和回答 token 上限。平台按其规则计费，失败或停止的已发起请求也计入次数。助手仅收到当前问题、会话记录及明确引用的内容，不会自动扫描知识库，也不具备自动浏览互联网或修改文档的能力。
文件夹内新建、图片粘贴与统一导航（1.10 新增）
知识库现在统一称为“团队文档”，按文件夹展示笔记、点子和附件。独立的“导入文档”页面已合并为文件夹内的导入窗口。点子池与本周讨论放在“点子与讨论”中；项目视图是团队文档的快捷筛选，同一篇正文不会复制。
研究 / 实验记录。例子：进入
研究 / 实验记录，新建“温度对实验结果的影响”，选择草稿、共享、允许共创。在 Edit Page 切换即时渲染，粘贴一张实验截图并保存。团队成员能在该文件夹找到笔记，并在作者开启共创后编辑正文。需要独立讨论的猜想，可在同一文件夹新建点子并安排到本周讨论。AI 按钮已上移，给阅读页的编辑按钮留出空间。管理员配置 API 时打开 AI 助手 → ⚙ 模型设置；通过 HTTPS 或本机 SSH 加密入口填写密钥，启用后保存。密钥不要粘贴到文档或聊天正文中。